le-kit 0.6.4 → 0.7.0

package/LLM_CONTEXT.md

@@ -10,6 +10,7 @@ This file is auto-generated and contains documentation for all Le-Kit web compon
 - [le-box](#le-box)
 - [le-breadcrumbs](#le-breadcrumbs)
 - [le-button](#le-button)
+- [le-button-group](#le-button-group)
 - [le-card](#le-card)
 - [le-checkbox](#le-checkbox)
 - [le-code-input](#le-code-input)
@@ -22,11 +23,14 @@ This file is auto-generated and contains documentation for all Le-Kit web compon
 - [le-header-placeholder](#le-header-placeholder)
 - [le-icon](#le-icon)
 - [le-item](#le-item)
+- [le-kit](#le-kit)
 - [le-multiselect](#le-multiselect)
 - [le-navigation](#le-navigation)
 - [le-number-input](#le-number-input)
+- [le-overflow-menu](#le-overflow-menu)
 - [le-popover](#le-popover)
 - [le-popup](#le-popup)
+- [le-preview-frame](#le-preview-frame)
 - [le-round-progress](#le-round-progress)
 - [le-scroll-progress](#le-scroll-progress)
 - [le-segmented-control](#le-segmented-control)
@@ -42,7 +46,11 @@ This file is auto-generated and contains documentation for all Le-Kit web compon
 - [le-tabs](#le-tabs)
 - [le-tag](#le-tag)
 - [le-text](#le-text)
+- [le-toolbar](#le-toolbar)
+- [le-toolbar-spacer](#le-toolbar-spacer)
+- [le-tooltip](#le-tooltip)
 - [le-turntable](#le-turntable)
+- [le-visibility](#le-visibility)
 
 ---
 
@@ -241,17 +249,23 @@ A flexible button component with multiple variants and states.
 |------|------|---------|-------------|
 | `el` | `HTMLElement` |  |  |
 | `mode` | `'default' \| 'admin' \| undefined` |  | Mode of the popover should be 'default' for internal use |
-| `variant` | `'solid' \| 'outlined' \| 'clear' \| 'system'` | `'solid'` | Button variant style |
+| `variant` | `'solid' \| 'outlined' \| 'clear' \| 'system'` | `'outlined'` | Button variant style |
 | `color` | `\| 'primary'
     \| 'secondary'
     \| 'success'
     \| 'warning'
     \| 'danger'
     \| 'info'
-    \| 'transparent'` | `'primary'` | Button color theme (uses theme semantic colors) |
+    \| 'transparent' \| undefined` |  | Button color theme (uses theme semantic colors) |
 | `size` | `'small' \| 'medium' \| 'large'` | `'medium'` | Button size |
 | `selected` | `boolean` | `false` | Whether the button is in a selected/active state |
+| `label` | `string \| undefined` |  | Optional label for the button, used for accessibility and tooltips when the button is icon-only. |
+| `tooltip` | `string \| undefined` |  | Tooltip text to show on hover |
+| `tooltipPosition` | `TooltipPlacement` | `'top'` | Tooltip position around the button |
 | `fullWidth` | `boolean` | `false` | Whether the button takes full width of its container |
+| `visibility` | `'visible' \| 'collapsing' \| 'collapsed' \| 'expanding'` | `'visible'` | Visibility state used by responsive containers to animate show/hide transitions. |
+| `groupShape` | `'start' \| 'middle' \| 'end' \| 'single'` | `'single'` | Shape of the button when rendered inside grouped containers. |
+| `motionPreset` | `'none' \| 'soft' \| 'fluid' \| 'spring' \| undefined` |  | Optional per-instance motion preset override. |
 | `iconOnly` | `string \| Node \| undefined` |  | Icon only button image or emoji if this prop is set, the button will render only the icon slot |
 | `iconStart` | `string \| Node \| undefined` |  | Start icon image or emoji |
 | `iconEnd` | `string \| Node \| undefined` |  | End icon image or emoji |
@@ -286,6 +300,37 @@ A flexible button component with multiple variants and states.
 
 ---
 
+## <le-button-group>
+
+Groups multiple `le-button` elements and optionally collapses low-priority actions
+into an overflow "more" menu.
+
+### Properties
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `el` | `HTMLElement` |  |  |
+| `label` | `string \| undefined` |  | Optional label used when the whole group is represented as a parent item inside another component's overflow menu. |
+| `collapse` | `boolean \| number \| string \| undefined` |  | Collapse mode.  - `true`: show only the top-priority button - positive number: show top N buttons - `0`: show only the more button - negative number: hide abs(N) lowest-priority buttons  Non-integers are rounded with `Math.round`. |
+| `overflowIcons` | `boolean` | `false` | When true, icons from collapsed buttons are shown in the overflow navigation list. |
+| `disabled` | `boolean` | `false` | Disabled attribute, when the button group is disabled, all buttons inside will be disabled and the overflow menu will not be accessible. |
+| `visibility` | `'visible' \| 'collapsing' \| 'collapsed' \| 'expanding'` | `'visible'` | Visibility state used by responsive containers such as le-toolbar. |
+
+### Events
+
+| Event | Type | Description |
+|-------|------|-------------|
+| `leOverflowSelect` | `EventEmitter<{ id: string }>` |  |
+
+### Slots
+
+| Name | Description |
+|------|-------------|
+| Default | Group button elements (`le-button` children) |
+| `"more"` | Custom icon/content for the overflow trigger button |
+
+---
+
 ## <le-card>
 
 A flexible card component with header, content, and footer slots.
@@ -699,6 +744,27 @@ The header component updates that variable when it renders.
 
 ---
 
+## <le-kit>
+
+Optional app-level context orchestrator for theme, appearance, and active state.
+
+Components continue to work without this wrapper; `le-kit` is opt-in.
+
+### Properties
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `el` | `HTMLElement` |  |  |
+| `theme` | `string` | `'default'` | Current theme scope value. |
+| `appearance` | `string` | `'default'` | Current appearance scope value. |
+| `activeContext` | `LeActiveContext` | `'active'` | Current active context scope value. |
+| `watchWindow` | `boolean` | `true` | Whether this instance reacts to window focus/blur. |
+| `watchModals` | `boolean` | `true` | Whether this instance reacts to descendant modal popup open/close events. |
+| `storageKey` | `string` | `'le-kit'` | Local storage namespace for persisted values. |
+| `persist` | `string` | `'theme appearance'` | Persistence keys as a space-separated list: `all`, `none`, `theme`, `appearance`. |
+
+---
+
 ## <le-multiselect>
 
 A multiselect component for selecting multiple options.
@@ -758,6 +824,8 @@ Navigation component with vertical (tree) and horizontal (menu) layouts.
 | `searchPlaceholder` | `string` | `'Search...'` | Placeholder text for the search input. |
 | `emptyText` | `string` | `'No results found'` | Text shown when no items match the filter. |
 | `submenuSearchable` | `boolean` | `false` | Whether submenu popovers should include a filter input. |
+| `activationMode` | `LeNavigationActivationMode` | `'manual'` | Whether keyboard focus only highlights, or also activates immediately. |
+| `togglePosition` | `'start' \| 'end'` | `'start'` | Position of the toggle arrow for items with children: 'start' | 'end' |
 
 ### Events
 
@@ -837,6 +905,32 @@ A number input component with validation, keyboard controls, and custom spinners
 
 ---
 
+## <le-overflow-menu>
+
+### Properties
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `open` | `boolean` | `false` | Whether the menu popover is open. |
+| `disabled` | `boolean` | `false` | Disables trigger interactions. |
+| `position` | `'top' \| 'right' \| 'bottom' \| 'left'` | `'bottom'` | Popover position. |
+| `align` | `'start' \| 'center' \| 'end'` | `'end'` | Popover alignment relative to trigger. |
+| `offset` | `number` | `8` | Popover offset in px. |
+| `minWidth` | `string` | `'160px'` | Minimum popover width. |
+| `icon` | `string` | `'ellipsis-horizontal'` | Fallback icon name for trigger. |
+| `triggerAriaLabel` | `string` | `'Open menu'` | Aria label for fallback trigger button. |
+| `triggerPart` | `string` | `'trigger-button'` | Part name for fallback trigger button. |
+| `items` | `LeOverflowMenuItem[] \| string` | `[]` | List of menu items represented as options. |
+
+### Events
+
+| Event | Type | Description |
+|-------|------|-------------|
+| `leOverflowMenuItemSelect` | `EventEmitter<LeOverflowMenuItemSelectDetail>` |  |
+| `leOverflowMenuClose` | `EventEmitter<void>` |  |
+
+---
+
 ## <le-popover>
 
 A popover component for displaying floating content.
@@ -925,6 +1019,47 @@ via leAlert(), leConfirm(), lePrompt().
 
 ---
 
+## <le-preview-frame>
+
+A resizable preview frame for showcasing responsive component behavior.
+
+Wraps any content in a resizable viewport, complete with drag handle,
+width indicator, and preset device-size buttons. Designed for use in
+component demos and documentation.
+
+### Properties
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `el` | `HTMLElement` |  |  |
+| `frameWidth` | `number \| undefined` |  | Initial inner width of the preview viewport in pixels. Set to 0 or 'auto' to fill the available container width. |
+| `minWidth` | `number` | `240` | Minimum resizable width in pixels. |
+| `maxWidth` | `number` | `0` | Maximum resizable width in pixels. 0 = unconstrained. |
+| `showControls` | `boolean` | `true` | Whether to show the controls bar (breakpoint buttons + width badge). |
+| `resizable` | `boolean` | `true` | Whether to show drag resize handles. |
+| `handles` | `LePreviewFrameHandleSide[] \| string` | `'right'` | Which handles are rendered. Accepts "right", "left", "bottom", "left,right", etc. or a JSON string/array. |
+| `origin` | `LePreviewFrameResizeOrigin` | `'auto'` | Horizontal resize origin strategy. - auto: detects centered layouts and switches to center math - edge: keeps opposite edge fixed (default left-aligned behavior) - center: grows/shrinks from center |
+| `padding` | `number` | `0` | Extra layout padding to subtract from available container space. Useful when visual page padding is not detectable from the immediate parent. |
+| `breakpoints` | `LePreviewFrameBreakpoint[] \| string` | `DEFAULT_BREAKPOINTS` | Preset breakpoints shown as buttons. Can be a JSON string or a LePreviewFrameBreakpoint[]. |
+| `widthUnit` | `string` | `'px'` | Label for the width badge. Set empty to hide the unit suffix. |
+| `minHeight` | `number` | `64` | Minimum height of the viewport in pixels. |
+| `maxHeight` | `number` | `0` | Maximum resizable viewport height in pixels. 0 = unconstrained. |
+
+### Events
+
+| Event | Type | Description |
+|-------|------|-------------|
+| `lePreviewFrameResize` | `EventEmitter<LePreviewFrameResizeDetail> \| undefined` | Emitted whenever the frame width changes (drag or preset button). |
+
+### Slots
+
+| Name | Description |
+|------|-------------|
+| Default | The content to preview |
+| `"controls"` | Extra content inserted after the preset buttons |
+
+---
+
 ## <le-round-progress>
 
 ### Properties
@@ -1498,6 +1633,89 @@ toolbar for bold, italic, links, and paragraph type selection.
 
 ---
 
+## <le-toolbar>
+
+A priority-aware, overflow-safe toolbar component.
+
+Items are slotted light-DOM children. Each item may carry a
+`priority` attribute (lower = more important). When there
+isn't enough space, lower-priority items move to an overflow menu.
+
+Collapsible `le-button-group` children are asked to reduce their own
+footprint first before their contents are overflowed entirely.
+
+### Properties
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `el` | `HTMLElement` |  |  |
+| `items` | `unknown \| undefined` |  | Optional declarative items input.  The current implementation is slot-driven, but when this prop changes we still invalidate the slotted-items cache and recompute layout. |
+| `alignItems` | `'start' \| 'center' \| 'end' \| 'stretch'` | `'start'` | Alignment of items along the main axis. |
+| `itemGap` | `string` | `'var(--le-toolbar-gap, var(--le-spacing-1, 4px))'` | Spacing between top-level toolbar items. Accepts any valid CSS length (e.g. `8px`, `0.5rem`, `var(--le-spacing-2)`). |
+| `overflowIcon` | `string` | `'ellipsis-horizontal'` | Icon for the overflow trigger button when no custom slot content is provided. |
+| `overflowLabel` | `string` | `'More'` | Accessible label for the overflow trigger button. |
+| `disablePopover` | `boolean` | `false` | Disable the built-in overflow popover. The toolbar will still compute overflow state and emit events, but won't render its own menu. Useful for custom overflow handling. |
+| `debugVirtualToolbar` | `boolean` | `false` | Temporary debug mode: render the virtual toolbar visibly above the live toolbar so collapse measurements can be inspected. |
+| `debugPauseBeforeMeasure` | `boolean` | `false` | Temporary debug mode: stop before measuring virtual widths so the virtual DOM can be inspected before collapse simulation mutates it. |
+
+### Events
+
+| Event | Type | Description |
+|-------|------|-------------|
+| `leToolbarOverflowChange` | `EventEmitter<LeToolbarOverflowChangeDetail> \| undefined` | Emitted when the overflow state changes. |
+
+### Slots
+
+| Name | Description |
+|------|-------------|
+| Default | Toolbar items |
+| `"more"` | Custom content for the overflow trigger button |
+
+---
+
+## <le-toolbar-spacer>
+
+Flexible spacer for le-toolbar layouts.
+
+Default behavior (no width): occupies available free space and shrinks naturally.
+With numeric `width`: behaves as a fixed-width spacer that can be collapsed by le-toolbar.
+
+### Properties
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `width` | `number \| string \| undefined` |  | Optional fixed width. Numeric values (e.g. `24`) are treated as px. String values may be any valid CSS width (e.g. `2rem`, `var(--le-spacing-2)`). |
+
+---
+
+## <le-tooltip>
+
+### Properties
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `el` | `HTMLElement` |  |  |
+| `mode` | `LeKitMode` | `'default'` | The mode of Le Kit. |
+| `open` | `boolean` | `false` | Controls whether the tooltip is open. |
+| `text` | `string` | `''` | Tooltip text shown when no custom content slot is provided. |
+| `placement` | `TooltipPlacement` | `'auto'` | Preferred tooltip placement relative to trigger. |
+| `align` | `TooltipAlign` | `'center'` | Alignment along the cross axis for the chosen placement. |
+| `variant` | `TooltipVariant` | `'default'` | Visual variant of tooltip. |
+| `disabled` | `boolean` | `false` | Disable tooltip interactions and visibility. |
+| `showDelay` | `number` | `500` | Delay in milliseconds before showing the tooltip. |
+| `hideDelay` | `number` | `160` | Delay in milliseconds before hiding the tooltip after leaving trigger/content. |
+| `offset` | `number` | `8` | Distance in pixels between trigger and tooltip. |
+| `maxWidth` | `string` | `'280px'` | Max width of the tooltip box. |
+
+### Events
+
+| Event | Type | Description |
+|-------|------|-------------|
+| `leTooltipOpen` | `EventEmitter<void> \| undefined` | Emitted when the tooltip opens. |
+| `leTooltipClose` | `EventEmitter<void> \| undefined` | Emitted when the tooltip closes. |
+
+---
+
 ## <le-turntable>
 
 ### Properties
@@ -1517,3 +1735,25 @@ toolbar for bold, italic, links, and paragraph type selection.
 
 ---
 
+## <le-visibility>
+
+Internal visibility transition controller.
+
+This component controls transition phase + measured size variables.
+
+Preferred usage wraps the target content:
+<le-visibility state="collapsed"><div>...</div></le-visibility>
+
+For backward compatibility, when no children are provided it
+falls back to controlling the parent host element.
+
+### Properties
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `el` | `HTMLElement` |  |  |
+| `state` | `LeVisibilityState` | `'visible'` | Desired visibility state. |
+| `mode` | `LeVisibilityMode` | `'width'` | Which dimensions to measure and expose as CSS vars. |
+
+---
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "le-kit",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "Themable web components library with CMS admin mode support",
   "main": "dist/index.cjs.js",
   "module": "dist/index.js",
@@ -51,12 +51,16 @@
     "analyze": "cem analyze --stencil && npm run generate:llm",
     "generate:llm": "node scripts/generate-llm-context.mjs"
   },
+  "dependencies": {
+    "@nanostores/persistent": "^0.10.2",
+    "nanostores": "^0.11.4"
+  },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
     "@stencil/core": "^4.27.1",
     "@stencil/react-output-target": "^1.2.0",
     "@types/jest": "^29.5.14",
-    "@types/node": "^22.13.5",
+    "@types/node": "^22.19.17",
     "jest": "^29.7.0",
     "jest-cli": "^29.7.0",
     "puppeteer": "^24.3.0"