le-kit 0.2.5 → 0.3.0

package/dist/docs.json

@@ -1,11 +1,392 @@
 {
-  "timestamp": "2026-01-09T17:12:10",
+  "timestamp": "2026-01-10T12:12:08",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.39.0",
     "typescriptVersion": "5.8.3"
   },
   "components": [
+    {
+      "filePath": "src/components/le-bar/le-bar.tsx",
+      "encapsulation": "shadow",
+      "tag": "le-bar",
+      "readme": "# le-bar\n\n\n",
+      "docs": "A flexible bar component that handles overflow gracefully.\n\nItems are slotted children. The bar measures which items fit on the first\nrow and handles overflow according to the `overflow` prop.",
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "- Bar items (children will be measured for overflow)"
+        },
+        {
+          "name": "slot",
+          "text": "more - Custom \"more\" button content"
+        },
+        {
+          "name": "slot",
+          "text": "hamburger - Custom hamburger button content"
+        },
+        {
+          "name": "slot",
+          "text": "start-arrow - Custom left scroll arrow"
+        },
+        {
+          "name": "slot",
+          "text": "end-arrow - Custom right scroll arrow"
+        },
+        {
+          "name": "slot",
+          "text": "all-menu - Custom \"show all\" menu button"
+        },
+        {
+          "name": "csspart",
+          "text": "container - The main bar container"
+        },
+        {
+          "name": "csspart",
+          "text": "item - Individual items in the bar"
+        },
+        {
+          "name": "csspart",
+          "text": "more-button - The \"more\" overflow button"
+        },
+        {
+          "name": "csspart",
+          "text": "hamburger-button - The hamburger menu button"
+        },
+        {
+          "name": "csspart",
+          "text": "arrow-start - The start (left) scroll arrow"
+        },
+        {
+          "name": "csspart",
+          "text": "arrow-end - The end (right) scroll arrow"
+        },
+        {
+          "name": "csspart",
+          "text": "all-menu-button - The \"show all\" menu button"
+        },
+        {
+          "name": "csspart",
+          "text": "popover-content - The popover content wrapper"
+        },
+        {
+          "name": "cmsEditable",
+          "text": "true"
+        },
+        {
+          "name": "cmsCategory",
+          "text": "Layout"
+        }
+      ],
+      "usage": {},
+      "props": [
+        {
+          "name": "alignItems",
+          "type": "\"center\" | \"end\" | \"start\" | \"stretch\"",
+          "complexType": {
+            "original": "'start' | 'end' | 'center' | 'stretch'",
+            "resolved": "\"center\" | \"end\" | \"start\" | \"stretch\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "align-items",
+          "reflectToAttr": true,
+          "docs": "Alignment of items within the bar (maps to justify-content).",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'start'"
+            }
+          ],
+          "default": "'start'",
+          "values": [
+            {
+              "value": "center",
+              "type": "string"
+            },
+            {
+              "value": "end",
+              "type": "string"
+            },
+            {
+              "value": "start",
+              "type": "string"
+            },
+            {
+              "value": "stretch",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "arrows",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "arrows",
+          "reflectToAttr": false,
+          "docs": "Show scroll arrows when overflow is \"scroll\".",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "disablePopover",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "disable-popover",
+          "reflectToAttr": false,
+          "docs": "Disable the internal overflow popover.\nWhen true, the bar still detects overflow and hides items,\nbut doesn't render its own popover. Use this when providing\ncustom overflow handling via the leBarOverflowChange event.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "overflow",
+          "type": "\"hamburger\" | \"more\" | \"scroll\" | \"wrap\"",
+          "complexType": {
+            "original": "'more' | 'scroll' | 'hamburger' | 'wrap'",
+            "resolved": "\"hamburger\" | \"more\" | \"scroll\" | \"wrap\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "overflow",
+          "reflectToAttr": true,
+          "docs": "Overflow behavior when items don't fit on one row.\n- `more`: Overflow items appear in a \"more\" dropdown\n- `scroll`: Items scroll horizontally with optional arrows\n- `hamburger`: All items go into a hamburger menu if any overflow\n- `wrap`: Items wrap to additional rows",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'more'"
+            }
+          ],
+          "default": "'more'",
+          "values": [
+            {
+              "value": "hamburger",
+              "type": "string"
+            },
+            {
+              "value": "more",
+              "type": "string"
+            },
+            {
+              "value": "scroll",
+              "type": "string"
+            },
+            {
+              "value": "wrap",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "showAllMenu",
+          "type": "\"end\" | \"start\" | boolean",
+          "complexType": {
+            "original": "boolean | 'start' | 'end'",
+            "resolved": "\"end\" | \"start\" | boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "show-all-menu",
+          "reflectToAttr": false,
+          "docs": "Show an \"all items\" menu button.\n- `false`: Don't show\n- `true` or `'end'`: Show at end\n- `'start'`: Show at start",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "value": "end",
+              "type": "string"
+            },
+            {
+              "value": "start",
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [
+        {
+          "name": "recalculate",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<void>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "recalculate() => Promise<void>",
+          "parameters": [],
+          "docs": "Force recalculation of overflow state.",
+          "docsTags": []
+        }
+      ],
+      "events": [
+        {
+          "event": "leBarOverflowChange",
+          "detail": "LeBarOverflowChangeDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "LeBarOverflowChangeDetail",
+            "resolved": "LeBarOverflowChangeDetail",
+            "references": {
+              "LeBarOverflowChangeDetail": {
+                "location": "local",
+                "path": "/home/runner/work/le-kit/le-kit/src/components/le-bar/le-bar.tsx",
+                "id": "src/components/le-bar/le-bar.tsx::LeBarOverflowChangeDetail"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when overflow state changes.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [
+        {
+          "event": "slotchange",
+          "capture": false,
+          "passive": false
+        }
+      ],
+      "styles": [],
+      "slots": [
+        {
+          "name": "",
+          "docs": "Bar items (children will be measured for overflow)"
+        },
+        {
+          "name": "all-menu",
+          "docs": "Custom \"show all\" menu button"
+        },
+        {
+          "name": "end-arrow",
+          "docs": "Custom right scroll arrow"
+        },
+        {
+          "name": "hamburger",
+          "docs": "Custom hamburger button content"
+        },
+        {
+          "name": "more",
+          "docs": "Custom \"more\" button content"
+        },
+        {
+          "name": "start-arrow",
+          "docs": "Custom left scroll arrow"
+        }
+      ],
+      "parts": [
+        {
+          "name": "all-menu-button",
+          "docs": ""
+        },
+        {
+          "name": "arrow-end",
+          "docs": ""
+        },
+        {
+          "name": "arrow-start",
+          "docs": ""
+        },
+        {
+          "name": "container",
+          "docs": ""
+        },
+        {
+          "name": "hamburger-button",
+          "docs": ""
+        },
+        {
+          "name": "more-button",
+          "docs": ""
+        },
+        {
+          "name": "popover-content",
+          "docs": ""
+        }
+      ],
+      "dependents": [
+        "le-navigation"
+      ],
+      "dependencies": [
+        "le-icon",
+        "le-popover"
+      ],
+      "dependencyGraph": {
+        "le-bar": [
+          "le-icon",
+          "le-popover"
+        ],
+        "le-navigation": [
+          "le-bar"
+        ]
+      }
+    },
     {
       "filePath": "src/components/le-box/le-box.tsx",
       "encapsulation": "shadow",
@@ -4038,10 +4419,14 @@
       "slots": [],
       "parts": [],
       "dependents": [
+        "le-bar",
         "le-navigation"
       ],
       "dependencies": [],
       "dependencyGraph": {
+        "le-bar": [
+          "le-icon"
+        ],
         "le-navigation": [
           "le-icon"
         ]
@@ -5086,30 +5471,23 @@
           "docs": "Custom trigger contents for the \"More\" button"
         }
       ],
-      "parts": [
-        {
-          "name": "hamburger-trigger",
-          "docs": ""
-        },
-        {
-          "name": "more-trigger",
-          "docs": ""
-        }
-      ],
+      "parts": [],
       "dependents": [],
       "dependencies": [
-        "le-icon",
         "le-string-input",
+        "le-icon",
         "le-collapse",
         "le-popover",
+        "le-bar",
         "le-component"
       ],
       "dependencyGraph": {
         "le-navigation": [
-          "le-icon",
           "le-string-input",
+          "le-icon",
           "le-collapse",
           "le-popover",
+          "le-bar",
           "le-component"
         ],
         "le-string-input": [
@@ -5153,6 +5531,10 @@
         ],
         "le-collapse": [
           "le-component"
+        ],
+        "le-bar": [
+          "le-icon",
+          "le-popover"
         ]
       }
     },
@@ -6199,6 +6581,7 @@
         }
       ],
       "dependents": [
+        "le-bar",
         "le-component",
         "le-dropdown-base",
         "le-navigation",
@@ -6206,6 +6589,9 @@
       ],
       "dependencies": [],
       "dependencyGraph": {
+        "le-bar": [
+          "le-popover"
+        ],
         "le-component": [
           "le-popover"
         ],
@@ -12107,6 +12493,11 @@
     }
   ],
   "typeLibrary": {
+    "src/components/le-bar/le-bar.tsx::LeBarOverflowChangeDetail": {
+      "declaration": "export interface LeBarOverflowChangeDetail {\n  /** IDs of items that are currently overflowing (in the \"more\" popover) */\n  overflowingIds: string[];\n  /** Whether hamburger mode is active */\n  hamburgerActive: boolean;\n}",
+      "docstring": "",
+      "path": "src/components/le-bar/le-bar.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   * Whether a hierarchical option is expanded (open).\n   * Used by tree-like components (e.g., navigation).\n   */\n  open?: boolean;\n\n  /**\n   * Optional part tokens for styling from outside shadow DOM.\n   * Components may map this to `part` attributes (e.g. `item item-accent`).\n   */\n  part?: string;\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.",