le-kit 0.1.19 → 0.2.0

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-12-27T22:40:49",
+  "timestamp": "2026-01-05T16:20:53",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.39.0",
@@ -1839,17 +1839,17 @@
       "usage": {},
       "props": [
         {
-          "name": "collapseOnHeaderShrink",
+          "name": "closed",
           "type": "boolean",
           "complexType": {
             "original": "boolean",
             "resolved": "boolean",
             "references": {}
           },
-          "mutable": false,
-          "attr": "collapse-on-header-shrink",
+          "mutable": true,
+          "attr": "closed",
           "reflectToAttr": true,
-          "docs": "If true, collapse/expand based on the nearest header shrink event.",
+          "docs": "Since Stencil boolean props default to `false` when the attribute is missing.\ninstead of `open` defaulting to `true`, using a `closed` prop.",
           "docsTags": [
             {
               "name": "default",
@@ -1868,7 +1868,7 @@
           "setter": false
         },
         {
-          "name": "noFading",
+          "name": "collapseOnHeaderShrink",
           "type": "boolean",
           "complexType": {
             "original": "boolean",
@@ -1876,9 +1876,9 @@
             "references": {}
           },
           "mutable": false,
-          "attr": "no-fading",
+          "attr": "collapse-on-header-shrink",
           "reflectToAttr": true,
-          "docs": "Stop fading the content when collapsing/expanding.",
+          "docs": "If true, collapse/expand based on the nearest header shrink event.",
           "docsTags": [
             {
               "name": "default",
@@ -1897,24 +1897,24 @@
           "setter": false
         },
         {
-          "name": "open",
+          "name": "noFading",
           "type": "boolean",
           "complexType": {
             "original": "boolean",
             "resolved": "boolean",
             "references": {}
           },
-          "mutable": true,
-          "attr": "open",
+          "mutable": false,
+          "attr": "no-fading",
           "reflectToAttr": true,
-          "docs": "Whether the content should be shown.",
+          "docs": "Stop fading the content when collapsing/expanding.",
           "docsTags": [
             {
               "name": "default",
-              "text": "true"
+              "text": "false"
             }
           ],
-          "default": "true",
+          "default": "false",
           "values": [
             {
               "type": "boolean"
@@ -1978,7 +1978,9 @@
           "docs": ""
         }
       ],
-      "dependents": [],
+      "dependents": [
+        "le-navigation"
+      ],
       "dependencies": [
         "le-component"
       ],
@@ -2024,6 +2026,9 @@
           "le-slot",
           "le-button",
           "le-component"
+        ],
+        "le-navigation": [
+          "le-collapse"
         ]
       }
     },
@@ -2747,6 +2752,7 @@
         "le-combobox",
         "le-header",
         "le-multiselect",
+        "le-navigation",
         "le-number-input",
         "le-popup",
         "le-segmented-control",
@@ -2818,6 +2824,9 @@
         "le-multiselect": [
           "le-component"
         ],
+        "le-navigation": [
+          "le-component"
+        ],
         "le-number-input": [
           "le-component"
         ],
@@ -3954,6 +3963,90 @@
       "dependencies": [],
       "dependencyGraph": {}
     },
+    {
+      "filePath": "src/components/le-icon/le-icon.tsx",
+      "encapsulation": "shadow",
+      "tag": "le-icon",
+      "readme": "# le-icon\n\n\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "name",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "name",
+          "reflectToAttr": false,
+          "docs": "Name of the icon to display. Corresponds to a JSON file in the assets folder.\nFor example, \"search\" will load the \"search.json\" file.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "null"
+            }
+          ],
+          "default": "null",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "size",
+          "type": "number",
+          "complexType": {
+            "original": "number",
+            "resolved": "number",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "size",
+          "reflectToAttr": false,
+          "docs": "Size of the icon in pixels. Default is 16.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "16"
+            }
+          ],
+          "default": "16",
+          "values": [
+            {
+              "type": "number"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "le-navigation"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "le-navigation": [
+          "le-icon"
+        ]
+      }
+    },
     {
       "filePath": "src/components/le-multiselect/le-multiselect.tsx",
       "encapsulation": "shadow",
@@ -4560,6 +4653,383 @@
         ]
       }
     },
+    {
+      "filePath": "src/components/le-navigation/le-navigation.tsx",
+      "encapsulation": "shadow",
+      "tag": "le-navigation",
+      "readme": "# le-navigation\n\n\n",
+      "docs": "Navigation component with vertical (tree) and horizontal (menu) layouts.\n\n- Accepts items as `LeOption[]` or a JSON string.\n- Supports hierarchical items via `children`.\n- Supports persisted expansion via `open` on items.",
+      "docsTags": [
+        {
+          "name": "cmsEditable",
+          "text": "true"
+        },
+        {
+          "name": "cmsCategory",
+          "text": "Navigation"
+        }
+      ],
+      "usage": {},
+      "props": [
+        {
+          "name": "emptyText",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "empty-text",
+          "reflectToAttr": false,
+          "docs": "Text shown when no items match the filter.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'No results found'"
+            }
+          ],
+          "default": "'No results found'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "items",
+          "type": "LeOption[] | string",
+          "complexType": {
+            "original": "LeOption[] | string",
+            "resolved": "LeOption[] | string",
+            "references": {
+              "LeOption": {
+                "location": "import",
+                "path": "../../types/options",
+                "id": "src/types/options.ts::LeOption"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "items",
+          "reflectToAttr": false,
+          "docs": "Navigation items.\nCan be passed as an array or JSON string (same pattern as le-select).",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "[]"
+            }
+          ],
+          "default": "[]",
+          "values": [
+            {
+              "type": "LeOption[]"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "orientation",
+          "type": "\"horizontal\" | \"vertical\"",
+          "complexType": {
+            "original": "'vertical' | 'horizontal'",
+            "resolved": "\"horizontal\" | \"vertical\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "orientation",
+          "reflectToAttr": true,
+          "docs": "Layout orientation.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'vertical'"
+            }
+          ],
+          "default": "'vertical'",
+          "values": [
+            {
+              "value": "horizontal",
+              "type": "string"
+            },
+            {
+              "value": "vertical",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "overflowMode",
+          "type": "\"hamburger\" | \"more\"",
+          "complexType": {
+            "original": "'more' | 'hamburger'",
+            "resolved": "\"hamburger\" | \"more\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "overflow-mode",
+          "reflectToAttr": true,
+          "docs": "Overflow behavior for horizontal, non-wrapping menus.\n- more: moves overflow items into a \"More\" popover\n- hamburger: turns the whole nav into a hamburger popover",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'more'"
+            }
+          ],
+          "default": "'more'",
+          "values": [
+            {
+              "value": "hamburger",
+              "type": "string"
+            },
+            {
+              "value": "more",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "searchPlaceholder",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "search-placeholder",
+          "reflectToAttr": false,
+          "docs": "Placeholder text for the search input.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'Search...'"
+            }
+          ],
+          "default": "'Search...'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "searchable",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "searchable",
+          "reflectToAttr": false,
+          "docs": "Enables a search input for the vertical navigation.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "submenuSearchable",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "submenu-searchable",
+          "reflectToAttr": false,
+          "docs": "Whether submenu popovers should include a filter input.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "wrap",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "wrap",
+          "reflectToAttr": true,
+          "docs": "Horizontal wrapping behavior.\nIf false, overflow behavior depends on `overflowMode`.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [
+        {
+          "event": "leNavItemSelect",
+          "detail": "LeNavigationItemSelectDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "LeNavigationItemSelectDetail",
+            "resolved": "LeNavigationItemSelectDetail",
+            "references": {
+              "LeNavigationItemSelectDetail": {
+                "location": "local",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-navigation/le-navigation.tsx",
+                "id": "src/components/le-navigation/le-navigation.tsx::LeNavigationItemSelectDetail"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fired when a navigation item is activated.\n\nThis event is cancelable. Call `event.preventDefault()` to prevent\ndefault browser navigation and implement custom routing.",
+          "docsTags": []
+        },
+        {
+          "event": "leNavItemToggle",
+          "detail": "LeNavigationItemToggleDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "LeNavigationItemToggleDetail",
+            "resolved": "LeNavigationItemToggleDetail",
+            "references": {
+              "LeNavigationItemToggleDetail": {
+                "location": "local",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-navigation/le-navigation.tsx",
+                "id": "src/components/le-navigation/le-navigation.tsx::LeNavigationItemToggleDetail"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fired when a tree branch is toggled.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "le-string-input",
+        "le-icon",
+        "le-collapse",
+        "le-popover",
+        "le-component"
+      ],
+      "dependencyGraph": {
+        "le-navigation": [
+          "le-string-input",
+          "le-icon",
+          "le-collapse",
+          "le-popover",
+          "le-component"
+        ],
+        "le-string-input": [
+          "le-component",
+          "le-slot"
+        ],
+        "le-component": [
+          "le-button",
+          "le-select",
+          "le-checkbox",
+          "le-string-input",
+          "le-popover",
+          "le-popup"
+        ],
+        "le-button": [
+          "le-component",
+          "le-slot"
+        ],
+        "le-slot": [
+          "le-popover",
+          "le-button",
+          "le-string-input"
+        ],
+        "le-select": [
+          "le-component",
+          "le-dropdown-base",
+          "le-button",
+          "le-string-input"
+        ],
+        "le-dropdown-base": [
+          "le-popover"
+        ],
+        "le-checkbox": [
+          "le-component",
+          "le-slot"
+        ],
+        "le-popup": [
+          "le-slot",
+          "le-button",
+          "le-component"
+        ],
+        "le-collapse": [
+          "le-component"
+        ]
+      }
+    },
     {
       "filePath": "src/components/le-number-input/le-number-input.tsx",
       "encapsulation": "shadow",
@@ -5605,6 +6075,7 @@
       "dependents": [
         "le-component",
         "le-dropdown-base",
+        "le-navigation",
         "le-slot"
       ],
       "dependencies": [],
@@ -5615,6 +6086,9 @@
         "le-dropdown-base": [
           "le-popover"
         ],
+        "le-navigation": [
+          "le-popover"
+        ],
         "le-slot": [
           "le-popover"
         ]
@@ -5943,7 +6417,7 @@
             "references": {
               "PopupPosition": {
                 "location": "local",
-                "path": "/Users/leechy/Projects/le-kit/src/components/le-popup/le-popup.tsx",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-popup/le-popup.tsx",
                 "id": "src/components/le-popup/le-popup.tsx::PopupPosition"
               }
             }
@@ -6003,7 +6477,7 @@
             "references": {
               "PopupType": {
                 "location": "local",
-                "path": "/Users/leechy/Projects/le-kit/src/components/le-popup/le-popup.tsx",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-popup/le-popup.tsx",
                 "id": "src/components/le-popup/le-popup.tsx::PopupType"
               }
             }
@@ -6066,7 +6540,7 @@
               },
               "PopupResult": {
                 "location": "local",
-                "path": "/Users/leechy/Projects/le-kit/src/components/le-popup/le-popup.tsx",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-popup/le-popup.tsx",
                 "id": "src/components/le-popup/le-popup.tsx::PopupResult"
               }
             },
@@ -6099,7 +6573,7 @@
               },
               "PopupResult": {
                 "location": "local",
-                "path": "/Users/leechy/Projects/le-kit/src/components/le-popup/le-popup.tsx",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-popup/le-popup.tsx",
                 "id": "src/components/le-popup/le-popup.tsx::PopupResult"
               }
             },
@@ -6122,7 +6596,7 @@
             "references": {
               "PopupResult": {
                 "location": "local",
-                "path": "/Users/leechy/Projects/le-kit/src/components/le-popup/le-popup.tsx",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-popup/le-popup.tsx",
                 "id": "src/components/le-popup/le-popup.tsx::PopupResult"
               }
             }
@@ -6142,7 +6616,7 @@
             "references": {
               "PopupResult": {
                 "location": "local",
-                "path": "/Users/leechy/Projects/le-kit/src/components/le-popup/le-popup.tsx",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-popup/le-popup.tsx",
                 "id": "src/components/le-popup/le-popup.tsx::PopupResult"
               }
             }
@@ -6162,7 +6636,7 @@
             "references": {
               "PopupResult": {
                 "location": "local",
-                "path": "/Users/leechy/Projects/le-kit/src/components/le-popup/le-popup.tsx",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-popup/le-popup.tsx",
                 "id": "src/components/le-popup/le-popup.tsx::PopupResult"
               }
             }
@@ -8757,6 +9231,7 @@
         "le-combobox",
         "le-component",
         "le-multiselect",
+        "le-navigation",
         "le-select",
         "le-slot"
       ],
@@ -8799,6 +9274,9 @@
         ],
         "le-multiselect": [
           "le-string-input"
+        ],
+        "le-navigation": [
+          "le-string-input"
         ]
       }
     },
@@ -11503,6 +11981,21 @@
     }
   ],
   "typeLibrary": {
+    "src/types/options.ts::LeOption": {
+      "declaration": "export interface LeOption {\n  /**\n   * Unique identifier for the option.\n   * Auto-generated if not provided.\n   */\n  id?: string;\n\n  /**\n   * Display text for the option (required).\n   */\n  label: string;\n\n  /**\n   * Selection value. Defaults to label if not provided.\n   */\n  value?: string | number;\n\n  /**\n   * Main icon, used in the tab bar or as a start icon in menus.\n   * Can be a URL, icon name, or emoji character.\n   */\n  icon?: string;\n\n  /**\n   * Whether the option is disabled and cannot be selected.\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether the option is currently selected.\n   * Used for multiselect and menu components.\n   */\n  selected?: boolean;\n\n  /**\n   * Whether the option is checked.\n   * Used for checkbox/radio menu items.\n   */\n  checked?: boolean;\n\n  /**\n   * Icon displayed at the start (left) of the option.\n   * Can be a URL, icon name, or emoji character.\n   */\n  iconStart?: string;\n\n  /**\n   * Icon displayed at the end (right) of the option.\n   * Can be a URL, icon name, or emoji character.\n   */\n  iconEnd?: string;\n\n  /**\n   * Secondary description text displayed below the label.\n   */\n  description?: string;\n\n  /**\n   * Nested child options for hierarchical menus or submenus.\n   */\n  children?: LeOption[];\n\n  /**\n   * Whether a hierarchical option is expanded (open).\n   * Used by tree-like components (e.g., navigation).\n   */\n  open?: boolean;\n\n  /**\n   * Group label for categorizing options in flat lists.\n   * Options with the same group value are visually grouped together.\n   */\n  group?: string;\n\n  /**\n   * Add a visual separator line before or after this option.\n   */\n  separator?: 'before' | 'after';\n\n  /**\n   * URL to navigate to when the option is selected.\n   */\n  href?: string;\n\n  /**\n   * Custom data passthrough for application-specific needs.\n   * This data is included in selection events.\n   */\n  data?: Record<string, unknown>;\n}",
+      "docstring": "Universal option interface used across Le-Kit components.\n\nUsed by: le-select, le-combobox, le-multiselect, le-tabs,\nle-block-menu, le-emoji-picker, and any menu/list components.",
+      "path": "src/types/options.ts"
+    },
+    "src/components/le-navigation/le-navigation.tsx::LeNavigationItemSelectDetail": {
+      "declaration": "export interface LeNavigationItemSelectDetail {\n  item: LeOption;\n  id: string;\n  href?: string;\n  originalEvent: MouseEvent;\n}",
+      "docstring": "",
+      "path": "src/components/le-navigation/le-navigation.tsx"
+    },
+    "src/components/le-navigation/le-navigation.tsx::LeNavigationItemToggleDetail": {
+      "declaration": "export interface LeNavigationItemToggleDetail {\n  item: LeOption;\n  id: string;\n  open: boolean;\n  originalEvent: MouseEvent;\n}",
+      "docstring": "",
+      "path": "src/components/le-navigation/le-navigation.tsx"
+    },
     "src/global/app.ts::LeKitMode": {
       "declaration": "string",
       "docstring": "",
@@ -11523,11 +12016,6 @@
       "docstring": "Result returned by the popup when closed",
       "path": "src/components/le-popup/le-popup.tsx"
     },
-    "src/types/options.ts::LeOption": {
-      "declaration": "export interface LeOption {\n  /**\n   * Unique identifier for the option.\n   * Auto-generated if not provided.\n   */\n  id?: string;\n\n  /**\n   * Display text for the option (required).\n   */\n  label: string;\n\n  /**\n   * Selection value. Defaults to label if not provided.\n   */\n  value?: string | number;\n\n  /**\n   * Main icon, used in the tab bar or as a start icon in menus.\n   * Can be a URL, icon name, or emoji character.\n   */\n  icon?: string;\n\n  /**\n   * Whether the option is disabled and cannot be selected.\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether the option is currently selected.\n   * Used for multiselect and menu components.\n   */\n  selected?: boolean;\n\n  /**\n   * Whether the option is checked.\n   * Used for checkbox/radio menu items.\n   */\n  checked?: boolean;\n\n  /**\n   * Icon displayed at the start (left) of the option.\n   * Can be a URL, icon name, or emoji character.\n   */\n  iconStart?: string;\n\n  /**\n   * Icon displayed at the end (right) of the option.\n   * Can be a URL, icon name, or emoji character.\n   */\n  iconEnd?: string;\n\n  /**\n   * Secondary description text displayed below the label.\n   */\n  description?: string;\n\n  /**\n   * Nested child options for hierarchical menus or submenus.\n   */\n  children?: LeOption[];\n\n  /**\n   * Group label for categorizing options in flat lists.\n   * Options with the same group value are visually grouped together.\n   */\n  group?: string;\n\n  /**\n   * Add a visual separator line before or after this option.\n   */\n  separator?: 'before' | 'after';\n\n  /**\n   * URL to navigate to when the option is selected.\n   */\n  href?: string;\n\n  /**\n   * Custom data passthrough for application-specific needs.\n   * This data is included in selection events.\n   */\n  data?: Record<string, unknown>;\n}",
-      "docstring": "Universal option interface used across Le-Kit components.\n\nUsed by: le-select, le-combobox, le-multiselect, le-tabs,\nle-block-menu, le-emoji-picker, and any menu/list components.",
-      "path": "src/types/options.ts"
-    },
     "src/types/options.ts::LeOptionValue": {
       "declaration": "export type LeOptionValue = string | number;",
       "docstring": "",