Implemented Usage documentation for dnn-tab

david-poindexter · david-poindexter · commit df4e1cd076d1 · 2024-05-05T17:52:05.000-04:00
diff --git a/packages/stencil-library/custom-elements.json b/packages/stencil-library/custom-elements.json
@@ -61,7 +61,7 @@
               "type": {
                 "text": "\"button\" | \"reset\" | \"submit\""
               },
-              "description": "Optional button type,\ncan be either submit, reset or button and defaults to button if not specified.\nWarning: DNN wraps the whole page in a form, only use this if you are handling\nform submission manually.",
+              "description": "Optional button type,\r\ncan be either submit, reset or button and defaults to button if not specified.\r\nWarning: DNN wraps the whole page in a form, only use this if you are handling\r\nform submission manually.",
               "default": "'button'",
               "required": false
             },
@@ -88,7 +88,7 @@
               "type": {
                 "text": "\"danger\" | \"primary\" | \"secondary\" | \"tertiary\""
               },
-              "description": "Optional button style,\ncan be either primary, secondary or tertiary or danger and defaults to primary if not specified",
+              "description": "Optional button style,\r\ncan be either primary, secondary or tertiary or danger and defaults to primary if not specified",
               "default": "'primary'",
               "required": false
             }
@@ -447,7 +447,7 @@
                 "text": "{ contrast: string; preview: string; cancel: string; confirm: string; normal: string; light: string; dark: string; }"
               },
               "description": "Can be used to customize the text language.",
-              "default": "{\n    contrast: \"Contrast\",\n    preview: \"Preview\",\n    cancel: \"Cancel\",\n    confirm: \"Confirm\",\n    normal: \"Normal\",\n    light: \"Light\",\n    dark: \"Dark\",\n  }",
+              "default": "{\r\n    contrast: \"Contrast\",\r\n    preview: \"Preview\",\r\n    cancel: \"Cancel\",\r\n    confirm: \"Confirm\",\r\n    normal: \"Normal\",\r\n    light: \"Light\",\r\n    dark: \"Dark\",\r\n  }",
               "required": false
             }
           ],
@@ -563,7 +563,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "If true, will allow the user to take a snapshot\nusing the device camera. (only works over https).",
+              "description": "If true, will allow the user to take a snapshot\r\nusing the device camera. (only works over https).",
               "default": "false",
               "required": false
             },
@@ -572,7 +572,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "Specifies the jpeg quality for when the device\ncamera is used to generate a picture.\nNeeds to be a number between 0 and 1 and defaults to 0.8",
+              "description": "Specifies the jpeg quality for when the device\r\ncamera is used to generate a picture.\r\nNeeds to be a number between 0 and 1 and defaults to 0.8",
               "default": "0.8",
               "required": false
             },
@@ -600,7 +600,7 @@
               "type": {
                 "text": "string[]"
               },
-              "description": "A list of allowed file extensions.\nIf not specified, any file is allowed.\nEx: [\"jpg\", \"jpeg\", \"gif\", \"png\"]",
+              "description": "A list of allowed file extensions.\r\nIf not specified, any file is allowed.\r\nEx: [\"jpg\", \"jpeg\", \"gif\", \"png\"]",
               "required": false
             },
             {
@@ -816,7 +816,7 @@
           "kind": "class",
           "name": "dnn-image-cropper.tsx",
           "tagName": "dnn-image-cropper",
-          "description": "Allows cropping an image in-browser with the option to enforce a specific final size.\nAll computation happens in the browser and the final image is emmited\nin an event that has a data-url of the image.",
+          "description": "Allows cropping an image in-browser with the option to enforce a specific final size.\r\nAll computation happens in the browser and the final image is emmited\r\nin an event that has a data-url of the image.",
           "attributes": [
             {
               "name": "height",
@@ -868,7 +868,7 @@
               "type": {
                 "text": "ImageCropperResx"
               },
-              "description": "Can be used to customize controls text.\nSome values support tokens, see default values for examples.",
+              "description": "Can be used to customize controls text.\r\nSome values support tokens, see default values for examples.",
               "required": false
             },
             {
@@ -891,7 +891,7 @@
               "type": {
                 "text": "File"
               },
-              "description": "Emits both when a file is initially select and when the crop has changed.\nCompared to imageCropChanged, this event emits the file itself, which can be useful for uploading the file to a server including its name."
+              "description": "Emits both when a file is initially select and when the crop has changed.\r\nCompared to imageCropChanged, this event emits the file itself, which can be useful for uploading the file to a server including its name."
             }
           ],
           "slots": [],
@@ -1151,7 +1151,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Optionally pass the aria-label text for the close button.\nDefaults to \"Close modal\" if not provided.",
+              "description": "Optionally pass the aria-label text for the close button.\r\nDefaults to \"Close modal\" if not provided.",
               "default": "\"Close modal\"",
               "required": false
             },
@@ -1169,7 +1169,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Optionally you can pass false to not show the close button.\nIf you decide to do so, you should either not also prevent dismissal by clicking the backdrop\nor provide your own dismissal logic in the modal content.",
+              "description": "Optionally you can pass false to not show the close button.\r\nIf you decide to do so, you should either not also prevent dismissal by clicking the backdrop\r\nor provide your own dismissal logic in the modal content.",
               "default": "true",
               "required": false
             },
@@ -1542,7 +1542,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Fires up each time the search query changes.\nThe data passed is the new query."
+              "description": "Fires up each time the search query changes.\r\nThe data passed is the new query."
             }
           ],
           "slots": [],
@@ -2131,7 +2131,7 @@
           "kind": "class",
           "name": "dnn-vertical-splitview.tsx",
           "tagName": "dnn-vertical-splitview",
-          "description": "This allows splitting a UI into vertical adjustable panels, the splitter itself is not part of this component.\n- The content for the left part should be injected in the `left` slot.\n- The content for the right part should be injected in the `right` slot.\n- The content for the actual splitter should go in the default slot and other UI elements can be injected as long as you handle their behaviour, by default only the drag behavior is implemented in the component.",
+          "description": "This allows splitting a UI into vertical adjustable panels, the splitter itself is not part of this component.\r\n- The content for the left part should be injected in the `left` slot.\r\n- The content for the right part should be injected in the `right` slot.\r\n- The content for the actual splitter should go in the default slot and other UI elements can be injected as long as you handle their behaviour, by default only the drag behavior is implemented in the component.",
           "attributes": [
             {
               "name": "split-width-percentage",
diff --git a/packages/stencil-library/licenses.json b/packages/stencil-library/licenses.json
@@ -1,15 +1,94 @@
 {
+    "@babel/code-frame@7.12.11": {
+        "licenses": "MIT",
+        "repository": "https://github.com/babel/babel",
+        "publisher": "Sebastian McKenzie",
+        "email": "sebmck@gmail.com",
+        "path": "node_modules\\@babel\\code-frame",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\@babel\\code-frame\\LICENSE"
+    },
     "@dnncommunity/dnn-elements@0.23.3-alpha.7": {
         "licenses": "MIT",
         "repository": "https://github.com/dnncommunity/dnn-elements",
         "path": "",
-        "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\README.md"
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\README.md"
+    },
+    "@eslint/eslintrc@0.4.3": {
+        "licenses": "MIT",
+        "repository": "https://github.com/eslint/eslintrc",
+        "publisher": "Nicholas C. Zakas",
+        "path": "node_modules\\@eslint\\eslintrc",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\@eslint\\eslintrc\\LICENSE"
+    },
+    "@humanwhocodes/config-array@0.5.0": {
+        "licenses": "Apache-2.0",
+        "repository": "https://github.com/humanwhocodes/config-array",
+        "publisher": "Nicholas C. Zakas",
+        "path": "node_modules\\@humanwhocodes\\config-array",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\@humanwhocodes\\config-array\\LICENSE"
+    },
+    "@stencil/eslint-plugin@0.4.0": {
+        "licenses": "MIT",
+        "repository": "https://github.com/ionic-team/stencil-eslint",
+        "path": "node_modules\\@stencil\\eslint-plugin",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\@stencil\\eslint-plugin\\LICENSE.md"
+    },
+    "eslint-utils@2.1.0": {
+        "licenses": "MIT",
+        "repository": "https://github.com/mysticatea/eslint-utils",
+        "publisher": "Toru Nagashima",
+        "path": "node_modules\\eslint\\node_modules\\eslint-utils",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\eslint\\node_modules\\eslint-utils\\LICENSE"
+    },
+    "eslint-visitor-keys@1.3.0": {
+        "licenses": "Apache-2.0",
+        "repository": "https://github.com/eslint/eslint-visitor-keys",
+        "publisher": "Toru Nagashima",
+        "path": "node_modules\\espree\\node_modules\\eslint-visitor-keys",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\espree\\node_modules\\eslint-visitor-keys\\LICENSE"
+    },
+    "eslint@7.32.0": {
+        "licenses": "MIT",
+        "repository": "https://github.com/eslint/eslint",
+        "publisher": "Nicholas C. Zakas",
+        "email": "nicholas+npm@nczconsulting.com",
+        "path": "node_modules\\eslint",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\eslint\\LICENSE"
+    },
+    "espree@7.3.1": {
+        "licenses": "BSD-2-Clause",
+        "repository": "https://github.com/eslint/espree",
+        "publisher": "Nicholas C. Zakas",
+        "email": "nicholas+npm@nczconsulting.com",
+        "path": "node_modules\\espree",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\espree\\LICENSE"
+    },
+    "ignore@4.0.6": {
+        "licenses": "MIT",
+        "repository": "https://github.com/kaelzhang/node-ignore",
+        "publisher": "kael",
+        "path": "node_modules\\ignore",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\ignore\\LICENSE-MIT"
+    },
+    "tslib@1.14.1": {
+        "licenses": "0BSD",
+        "repository": "https://github.com/Microsoft/tslib",
+        "publisher": "Microsoft Corp.",
+        "path": "node_modules\\tslib",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\tslib\\LICENSE.txt"
+    },
+    "tsutils@3.0.0": {
+        "licenses": "MIT",
+        "repository": "https://github.com/ajafff/tsutils",
+        "publisher": "Klaus Meinhardt",
+        "path": "node_modules\\tsutils",
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\tsutils\\LICENSE"
     },
-    "typescript@5.2.2": {
+    "typescript@4.9.5": {
         "licenses": "Apache-2.0",
         "repository": "https://github.com/Microsoft/TypeScript",
         "publisher": "Microsoft Corp.",
         "path": "node_modules\\typescript",
-        "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\typescript\\LICENSE.txt"
+        "licenseFile": "C:\\dev\\dnn-elements\\packages\\stencil-library\\node_modules\\typescript\\LICENSE.txt"
     }
 }
diff --git a/packages/stencil-library/src/components/dnn-tab/readme.md b/packages/stencil-library/src/components/dnn-tab/readme.md
@@ -2,24 +2,43 @@
 
 `dnn-tab` should only be used as part of `dnn-tabs` in order to define the title and content of each of the tabs.
 
-## Example usage
+<!-- Auto Generated Below -->
+
+
+## Overview
+
+Represents a single tab and must be used inside a dnn-tabs element.
+
+## Usage
+
+### HTML
+
 ```html
 <dnn-tabs>
     <dnn-tab tab-title="First Tab">
         <p>Content of the first tab.</p>
     </dnn-tab>
     <dnn-tab tab-title="Second Tab">
-        <p>This is the second tab<p>
+        <p>This is the second tab</p>
     </dnn-tab>
 </dnn-tabs>
 ```
 
-<!-- Auto Generated Below -->
 
+### JSX-TSX
+
+```tsx
+<dnn-tabs>
+    <dnn-tab tabTitle="First Tab">
+        <p>Content of the first tab.</p>
+    </dnn-tab>
+    <dnn-tab tabTitle="Second Tab">
+        <p>This is the second tab</p>
+    </dnn-tab>
+</dnn-tabs>
+```
 
-## Overview
 
-Represents a single tab and must be used inside a dnn-tabs element.
 
 ## Properties
 
diff --git a/packages/stencil-library/src/components/dnn-tab/usage/HTML.md b/packages/stencil-library/src/components/dnn-tab/usage/HTML.md
@@ -0,0 +1,10 @@
+```html
+<dnn-tabs>
+    <dnn-tab tab-title="First Tab">
+        <p>Content of the first tab.</p>
+    </dnn-tab>
+    <dnn-tab tab-title="Second Tab">
+        <p>This is the second tab</p>
+    </dnn-tab>
+</dnn-tabs>
+```
diff --git a/packages/stencil-library/src/components/dnn-tab/usage/JSX-TSX.md b/packages/stencil-library/src/components/dnn-tab/usage/JSX-TSX.md
@@ -0,0 +1,10 @@
+```tsx
+<dnn-tabs>
+    <dnn-tab tabTitle="First Tab">
+        <p>Content of the first tab.</p>
+    </dnn-tab>
+    <dnn-tab tabTitle="Second Tab">
+        <p>This is the second tab</p>
+    </dnn-tab>
+</dnn-tabs>
+```
diff --git a/packages/stencil-library/vscode-data.json b/packages/stencil-library/vscode-data.json
@@ -30,7 +30,7 @@
         },
         {
           "name": "form-button-type",
-          "description": "Optional button type,\ncan be either submit, reset or button and defaults to button if not specified.\nWarning: DNN wraps the whole page in a form, only use this if you are handling\nform submission manually.",
+          "description": "Optional button type,\r\ncan be either submit, reset or button and defaults to button if not specified.\r\nWarning: DNN wraps the whole page in a form, only use this if you are handling\r\nform submission manually.",
           "values": [
             {
               "name": "button"
@@ -64,7 +64,7 @@
         },
         {
           "name": "type",
-          "description": "Optional button style,\ncan be either primary, secondary or tertiary or danger and defaults to primary if not specified",
+          "description": "Optional button style,\r\ncan be either primary, secondary or tertiary or danger and defaults to primary if not specified",
           "values": [
             {
               "name": "danger"
@@ -235,11 +235,11 @@
       "attributes": [
         {
           "name": "allow-camera-mode",
-          "description": "If true, will allow the user to take a snapshot\nusing the device camera. (only works over https)."
+          "description": "If true, will allow the user to take a snapshot\r\nusing the device camera. (only works over https)."
         },
         {
           "name": "capture-quality",
-          "description": "Specifies the jpeg quality for when the device\ncamera is used to generate a picture.\nNeeds to be a number between 0 and 1 and defaults to 0.8"
+          "description": "Specifies the jpeg quality for when the device\r\ncamera is used to generate a picture.\r\nNeeds to be a number between 0 and 1 and defaults to 0.8"
         },
         {
           "name": "max-file-size",
@@ -320,7 +320,7 @@
       "name": "dnn-image-cropper",
       "description": {
         "kind": "markdown",
-        "value": "Allows cropping an image in-browser with the option to enforce a specific final size.\nAll computation happens in the browser and the final image is emmited\nin an event that has a data-url of the image."
+        "value": "Allows cropping an image in-browser with the option to enforce a specific final size.\r\nAll computation happens in the browser and the final image is emmited\r\nin an event that has a data-url of the image."
       },
       "attributes": [
         {
@@ -471,15 +471,15 @@
         },
         {
           "name": "close-text",
-          "description": "Optionally pass the aria-label text for the close button.\nDefaults to \"Close modal\" if not provided."
+          "description": "Optionally pass the aria-label text for the close button.\r\nDefaults to \"Close modal\" if not provided."
         },
         {
           "name": "resizable",
           "description": "If set to true, the modal becomes resizable."
         },
         {
           "name": "show-close-button",
-          "description": "Optionally you can pass false to not show the close button.\nIf you decide to do so, you should either not also prevent dismissal by clicking the backdrop\nor provide your own dismissal logic in the modal content."
+          "description": "Optionally you can pass false to not show the close button.\r\nIf you decide to do so, you should either not also prevent dismissal by clicking the backdrop\r\nor provide your own dismissal logic in the modal content."
         },
         {
           "name": "visible",
@@ -896,7 +896,7 @@
       "name": "dnn-vertical-splitview",
       "description": {
         "kind": "markdown",
-        "value": "This allows splitting a UI into vertical adjustable panels, the splitter itself is not part of this component.\n- The content for the left part should be injected in the `left` slot.\n- The content for the right part should be injected in the `right` slot.\n- The content for the actual splitter should go in the default slot and other UI elements can be injected as long as you handle their behaviour, by default only the drag behavior is implemented in the component."
+        "value": "This allows splitting a UI into vertical adjustable panels, the splitter itself is not part of this component.\r\n- The content for the left part should be injected in the `left` slot.\r\n- The content for the right part should be injected in the `right` slot.\r\n- The content for the actual splitter should go in the default slot and other UI elements can be injected as long as you handle their behaviour, by default only the drag behavior is implemented in the component."
       },
       "attributes": [
         {

Original file line number	Diff line number	Diff line change
`@@ -30,7 +30,7 @@`
`30`	`30`	`},`
`31`	`31`	`{`
`32`	`32`	`"name": "form-button-type",`
`33`		`- "description": "Optional button type,\ncan be either submit, reset or button and defaults to button if not specified.\nWarning: DNN wraps the whole page in a form, only use this if you are handling\nform submission manually.",`
	`33`	`+ "description": "Optional button type,\r\ncan be either submit, reset or button and defaults to button if not specified.\r\nWarning: DNN wraps the whole page in a form, only use this if you are handling\r\nform submission manually.",`
`34`	`34`	`"values": [`
`35`	`35`	`{`
`36`	`36`	`"name": "button"`
`@@ -64,7 +64,7 @@`
`64`	`64`	`},`
`65`	`65`	`{`
`66`	`66`	`"name": "type",`
`67`		`- "description": "Optional button style,\ncan be either primary, secondary or tertiary or danger and defaults to primary if not specified",`
	`67`	`+ "description": "Optional button style,\r\ncan be either primary, secondary or tertiary or danger and defaults to primary if not specified",`
`68`	`68`	`"values": [`
`69`	`69`	`{`
`70`	`70`	`"name": "danger"`
`@@ -235,11 +235,11 @@`
`235`	`235`	`"attributes": [`
`236`	`236`	`{`
`237`	`237`	`"name": "allow-camera-mode",`
`238`		`- "description": "If true, will allow the user to take a snapshot\nusing the device camera. (only works over https)."`
	`238`	`+ "description": "If true, will allow the user to take a snapshot\r\nusing the device camera. (only works over https)."`
`239`	`239`	`},`
`240`	`240`	`{`
`241`	`241`	`"name": "capture-quality",`
`242`		`- "description": "Specifies the jpeg quality for when the device\ncamera is used to generate a picture.\nNeeds to be a number between 0 and 1 and defaults to 0.8"`
	`242`	`+ "description": "Specifies the jpeg quality for when the device\r\ncamera is used to generate a picture.\r\nNeeds to be a number between 0 and 1 and defaults to 0.8"`
`243`	`243`	`},`
`244`	`244`	`{`
`245`	`245`	`"name": "max-file-size",`
`@@ -320,7 +320,7 @@`
`320`	`320`	`"name": "dnn-image-cropper",`
`321`	`321`	`"description": {`
`322`	`322`	`"kind": "markdown",`
`323`		`- "value": "Allows cropping an image in-browser with the option to enforce a specific final size.\nAll computation happens in the browser and the final image is emmited\nin an event that has a data-url of the image."`
	`323`	`+ "value": "Allows cropping an image in-browser with the option to enforce a specific final size.\r\nAll computation happens in the browser and the final image is emmited\r\nin an event that has a data-url of the image."`
`324`	`324`	`},`
`325`	`325`	`"attributes": [`
`326`	`326`	`{`
`@@ -471,15 +471,15 @@`
`471`	`471`	`},`
`472`	`472`	`{`
`473`	`473`	`"name": "close-text",`
`474`		`- "description": "Optionally pass the aria-label text for the close button.\nDefaults to \"Close modal\" if not provided."`
	`474`	`+ "description": "Optionally pass the aria-label text for the close button.\r\nDefaults to \"Close modal\" if not provided."`
`475`	`475`	`},`
`476`	`476`	`{`
`477`	`477`	`"name": "resizable",`
`478`	`478`	`"description": "If set to true, the modal becomes resizable."`
`479`	`479`	`},`
`480`	`480`	`{`
`481`	`481`	`"name": "show-close-button",`
`482`		`- "description": "Optionally you can pass false to not show the close button.\nIf you decide to do so, you should either not also prevent dismissal by clicking the backdrop\nor provide your own dismissal logic in the modal content."`
	`482`	`+ "description": "Optionally you can pass false to not show the close button.\r\nIf you decide to do so, you should either not also prevent dismissal by clicking the backdrop\r\nor provide your own dismissal logic in the modal content."`
`483`	`483`	`},`
`484`	`484`	`{`
`485`	`485`	`"name": "visible",`
`@@ -896,7 +896,7 @@`
`896`	`896`	`"name": "dnn-vertical-splitview",`
`897`	`897`	`"description": {`
`898`	`898`	`"kind": "markdown",`
`899`		- "value": "This allows splitting a UI into vertical adjustable panels, the splitter itself is not part of this component.\n- The content for the left part should be injected in the `left` slot.\n- The content for the right part should be injected in the `right` slot.\n- The content for the actual splitter should go in the default slot and other UI elements can be injected as long as you handle their behaviour, by default only the drag behavior is implemented in the component."
	`899`	+ "value": "This allows splitting a UI into vertical adjustable panels, the splitter itself is not part of this component.\r\n- The content for the left part should be injected in the `left` slot.\r\n- The content for the right part should be injected in the `right` slot.\r\n- The content for the actual splitter should go in the default slot and other UI elements can be injected as long as you handle their behaviour, by default only the drag behavior is implemented in the component."
`900`	`900`	`},`
`901`	`901`	`"attributes": [`
`902`	`902`	`{`