@nice2dev/ui-core 1.0.28 → 1.0.30

package/CHANGELOG.md

@@ -1,5 +1,154 @@
 # @nice2dev/ui-core — Changelog
 
+## 1.0.30
+
+### Patch Changes
+
+- 2f9e5d4: Showcase-feedback round 10 (editors state/props + bugs + datetime consolidation):
+  - NiceCheckbox: tri-state `indeterminate` now reaches all three states; expose
+    readOnly/loading/labelPlacement/errorPlacement in the props panel.
+  - NiceToggle/NiceRating: expose readOnly/loading/error/placement props; Rating
+    `loading` now replaces the stars with a spinner.
+  - NiceRadioGroup / NiceTagBox: implement `readOnly` (was ignored).
+  - NiceNumberInput: value stays right-aligned on blur; new `suffixSeparator` prop
+    (default false) gating the value↔suffix divider.
+  - NiceDatePicker: datetime shows a dot separator instead of the ISO `T` (emitted
+    value keeps `T`); datetime mode gains `showSeconds`, `minuteStep`, `showNow`,
+    and `hourFormat` (native picker) — ported from the now-removed
+    NiceDateTimePicker.
+  - NiceTimePicker: honor the `placeholder` prop.
+  - NiceSlider: more spacing around a left-placed label.
+
+  Removed **NiceDateTimePicker** (breaking): its datetime capability is covered by
+  NiceDatePicker's datetime mode; NiceForm, ui-forms `formUtils`, and ui-core
+  `adapters` now resolve datetime fields to NiceDatePicker.
+
+- 7771af3: Round-13 showcase-feedback fixes across ~23 controls.
+
+  **Behaviour / bug fixes**
+  - **NiceUpload** — restored the dropzone look (icon + themed box + hover tint;
+    `variant` now defaults to `"dropzone"`).
+  - **NiceCard** — `selected` now shows a ring (drawn on a `::after` pseudo-element
+    so the display-style inline chrome can't override it).
+  - **NiceMenu** — the active-item highlight fills the bar; `separated` (default)
+    gained a subtle toolbar surface.
+  - **NiceLookup** — implemented `disabled` (gray-out), `readOnly` (inert),
+    `loading` (spinner), and `labelPlacement` / `errorPlacement`.
+  - **NiceColorPicker** — the palette popup follows the theme instead of always
+    rendering light; hex input honours `withAlpha`; `withAlpha`/`compact` are now
+    documented. **`showInput` and `showRandom` now default to `false`** (was `true`).
+  - **NiceSignature** — theme-aware canvas (empty `penColor`/`backgroundColor`
+    resolve to the theme's text/background), plus a `label` prop and an
+    `onChangeDataUrl` callback ported from the removed NiceSignaturePad.
+  - **NiceSegmentedControl** — the active thumb is hidden while `loading`.
+  - **NiceAutocomplete** — multiple-mode selections render as separate bordered
+    chips with per-chip remove; the clear button matches the other controls.
+  - **NiceCalendar** — `multiple` works (uncontrolled fallback); `min`/`max` only
+    apply to complete ISO dates.
+  - **NiceDateRangeBox** — horizontal layout stays on one line; `labelPlacement`
+    works inline.
+  - **NicePickList** — drag-reorder works in both columns with insert-position
+    indicators. **When `sortable` is off (the default), both lists now auto-sort
+    alphabetically** (display-only; consumer arrays keep their order).
+  - **NiceColorPalette** — the hue ring supports press-and-drag.
+  - **NiceVirtualScroller** — `itemHeight`/`height` are honoured, and it gained
+    `size` + `disabled`/`loading`/`error` states.
+  - **NiceBusinessCard** — `variant` (card/inline/compact) and `showLogo` (with a
+    fallback avatar) now render.
+
+  **Breaking (patch, pre-1.2.0 convention)**
+  - **NiceSignaturePad is removed** — it duplicated **NiceSignature**. Its `label`
+    and data-URL value model were ported (`label`, `onChangeDataUrl`). Migrate to
+    `NiceSignature`; for a data-URL value use `onChangeDataUrl` or the imperative
+    `ref.toDataURL()`. (The separate touch-optimised `@nice2dev/ui-mobile`
+    `NiceSignaturePad` is unaffected.)
+
+- da12dfb: Round-17 showcase-feedback fixes (6 select/editor controls).
+  - **Select-dropdown standardization** — the menus of NiceSelect / NiceAutocomplete /
+    NiceLookup / NiceTreeSelect / NiceDropDownBox now abut the input (new
+    `--nice-dropdown-gap`, default `0px`, replacing a hardcoded 4px). NiceAutocomplete /
+    NiceLookup / NiceTreeSelect gain an optional `menuGap` prop. NiceDropDownBox's menu
+    gains the standard border (its `.nice-dropdown` had no CSS), and its clear `×` moved
+    inside the trigger (it was rendering below the control). NiceTreeSelect option rows
+    get more left padding.
+  - **NiceDateTimePicker** — the time-spinner ▲/▼ buttons now support press-and-hold
+    auto-repeat (new shared `useHoldRepeat` hook in `@nice2dev/ui-core`). (The 24-hour
+    default was a demo-seed issue, fixed in the showcase.)
+  - **NiceLookup** — `readOnly` no longer changes the control height (the chevron slot is
+    kept), and `errorPlacement="right"` no longer widens the field when there's no error.
+  - **NiceCardGroup** — new `readOnly` (blocks selection without dimming) and `errorText`
+    props; `size` now scales the child cards (they inherit the group size via context),
+    not just the grid gap.
+
+- bea5451: Round-18 showcase-feedback fixes (12 editor controls).
+  - **Select family** — NiceTreeSelect now has a stable trigger width (min-width like
+    NiceLookup, no longer tracking the value), its dropdown Search reuses the shared
+    `.nice-select__search` (left padding + normal vertical padding), and the empty state
+    gets padding. NiceAutocomplete inserts the option's DisplayName (label) on select
+    instead of the raw lowercase `value`. NiceLookup's `errorPlacement='right'` error is
+    absolutely positioned so it no longer widens the control.
+  - **NiceRangeSlider** — for `valuePlacement` right/bottom the value moves to a header
+    row above the track (mirroring NiceSlider) so it no longer overlaps the slider.
+  - **NiceDateRangeBox** — a stable `min-width` keeps disabled/readOnly from narrowing the
+    control; the loading spinner and `errorPlacement='right'` error align to the input row.
+  - **NiceDateTimePicker** — the time popup is now a slot-machine of vertical scroll-snap
+    columns for hours/minutes (animated, fade-masked); the ▲/▼ buttons keep hold-to-repeat
+    and typing a digit overwrites (INSERT).
+  - **NiceSkeleton** — new `animationSpeed` prop (seconds, default 1.8 ≈ 20% slower);
+    numeric-string `width`/`height` are coerced to px so both props apply.
+  - **NiceUpload** — new `labelPlacement` prop (`'right'` default | `'bottom'`): the text
+    sits beside the icon by default, below it when set.
+  - **NiceSignature** — the placeholder is translated (`signature.placeholder`, added to
+    the ui-core + i18n dictionaries for en/pl/de/fr/es/uk); the demo drops its synthetic
+    label + generic placeholder and the signature line is raised.
+  - **NiceColorPalette** — the collapsed field is a compact multi-colour strip at
+    NiceColorPicker's 32px height (chevron removed); the studio popup is split into
+    NiceTabs (Colors / Presets / Variations / Info / Schemes) and the swatch "kredki" are
+    reshaped into compact bars (chip + hex + remove ×) to the right of the wheel.
+  - **NiceGradientPicker** — redesigned to mirror NiceColorPicker/Palette: a compact 32×32
+    swatch field opens a portaled popup with NiceTabs (Editor / Presets / CSS); the
+    `NiceGradientValue`/`onChange` API and exported helpers are preserved.
+
+- 783d0db: fix(controls): showcase-feedback round 3 — core controls, deeply honed
+  - **NiceButton**: icon-only is a properly padded square (symmetric padding per size), `fullWidth` stretches to 100% width with normal height (no giant square), and the loading spinner no longer collapses the box (the icon is kept in flow, hidden).
+  - **NiceDropDownButton**: the portaled menu now carries the trigger's theme (fixes white-on-white rows in scoped themes) and hover/selected set both background and colour; `readOnly` is now visually distinct from `disabled` (own class, not greyed) while still blocking the menu.
+  - **NiceSegmentedControl**: the active thumb now fills the selected segment exactly (removed a double-counted container inset that left a gap).
+  - **NiceBadge**: `size` now scales width + font too (the display style no longer pins `fontSize`/`padding` inline, so the size class governs).
+  - **NiceCarousel**: slide switching / autoPlay / circular work again (no longer frozen by a bare controlled `activeIndex`), `size` has real rules (arrow size + viewport height), and a new `fullWidth` prop (default `true`) toggles fill-vs-content width.
+  - **NicePDFViewer**: shows `1 / 1` and `100%` and stays interactive (non-positive controlled `page`/`zoom` are ignored); print converts a `data:` URI to a Blob URL so the tab actually prints.
+  - **NiceQRCode / NiceBarcodeGenerator**: the default module/bar colour follows the element's own theme surface (dark → light, light → dark) via a ref-aware `useThemeIsDark`; empty `color`/`background` are guarded.
+  - **NiceTooltip**: new `position: 'auto'` (now the default) picks the on-screen side with the most room (collision detection).
+  - **NiceFAQ**: items collapse regardless of `animateExpand` (only the transition is gated on it).
+  - **NiceTimeline**: horizontal mode draws its connector line and centres the item text; the body line renders at ~70%.
+  - **NiceDivider**: the text variant fills its container so the flanking lines are visible.
+  - **NiceSkeleton**: grouped rows (`count > 1`) get a definite width so `text`/`rect` variants render and animate (not just `circle`).
+
+  `useThemeIsDark` now accepts an optional element ref and resolves against that element's nearest theme scope (backwards-compatible: no-arg still observes `<html>`).
+
+- 9816474: fix(controls): showcase-feedback round 6 — data + nav controls (8 items)
+  - **NiceTabs**: `vertical` now lays out as a sidebar (tab list left, content right) instead of stacking, and the panel keeps a stable size so switching tabs doesn't make the control jump.
+  - **NiceTable**: sort icons match NiceDataGrid — a neutral double-chevron when idle, a single up/down chevron for asc/desc, muted (new `sort` NiceIcon).
+  - **NiceDataGrid**: the aggregate summary is pinned directly above the pagination (no more jump on page change — it's no longer a sticky `<tfoot>`); the Filter button is now a proper `nice-btn` with a filter icon; toolbar placeholder glyphs (`?`/`??`) replaced with NiceIcons.
+  - **NiceList**: `size` now scales row density/font; `disabled`/`readOnly`/`error` states work; the loading spinner is centered and hides the search bar; new optional `header` prop that stays visible during loading.
+  - **NiceMenu**: bar-variant (separated/ghost/borderless) item highlight fills the item box edge-to-edge (no gap frame, no rounded-pill shrink; rounding only on the bar's outer corners).
+  - **NiceContextMenu**: item highlight fills each row (removed the container top/bottom padding and added `overflow:hidden`, so no top gap, no side overflow, corners clipped to the container).
+
+  Plus demo polish: NiceCardView cards now have a coloured header, status badge and footer actions; the NiceSpeedDialAction demo drops its bounded container (just the button).
+
+## 1.0.29
+
+### Patch Changes
+
+- Library-wide consistency pass + showcase overhaul.
+  - **Universal app shell:** every genuine multi-panel editor/studio/designer/builder/workspace standardized onto `NiceAppShell` (slots + `flush`), incl. `NiceTeamsWorkspace` and `NiceAPIDesigner`. No public API changes — internal layout only.
+  - **Icons:** foreign icons (emoji, raw unicode glyphs, inline `<svg>`, FontAwesome) replaced with `@nice2dev/icons` / `NiceIcon` built-ins across the packages; ~110 built-in icon paths added to `NiceIcon`.
+  - **Control sizing:** every basic control now honours the full `xs · sm · md · lg · xl` size scale with working CSS — fixed `NiceCard`, `NiceAlert`, `NiceSkeleton`, `NiceDivider`, `NiceSearchInput`, `NiceCallout`, `NiceStatistic`, `NiceSegmentedControl`, `NiceCheckbox`, `NiceParagraph`, and a `NiceSpinner` CSS-shadow regression (`md` baseline unchanged). `NiceNumericInput` gained a `size` prop.
+  - **NiceKioskShell:** the `style` prop now overrides the default full-screen `position: fixed` (so it can be embedded contained).
+  - **Input devices + spatial navigation:** `NiceGamepad` / `NiceMicrophone` / `NiceDeviceManager` / `NiceDeviceTile` and `NavShell` spatial-navigation support.
+  - **Audio:** AudioVerse → `@nice2dev/ui-audio` parity (15 controls; optional `recharts` visualizers).
+  - **Display atoms + forms:** standardized atoms (`NiceBadge`/`NiceTag`/`NiceAvatarGroup`/`NiceProgress`/…), removed the deprecated `NiceStatusBadge` (migrated to `NiceBadge` variants), entity validation builder, selectable `NiceCard`.
+  - **Editors inside satellites** (`ui-ai`/`ui-api`/`ui-bi`/`ui-math`/`ui-video`/`ui-audio`/`events`) now declare `@nice2dev/ui` (and where used `@nice2dev/icons` / `@nice2dev/ui-core`) as peer dependencies.
+
 All notable changes to the cross-framework core package.
 
 ## [0.2.0] — 2026-03-25
@@ -9,14 +158,17 @@ All notable changes to the cross-framework core package.
 Framework-agnostic TypeScript contracts, state machines, validation utilities, and behavior logic for all major UI component categories. These are consumed by Angular/Vue/Web Component/Blazor adapters.
 
 #### Shared
+
 - `ComponentBaseProps`, `ComponentEvent`, `createComponentEvent`
 - Types: `ComponentSize`, `ComponentVariant`, `ComponentDensity`, `Orientation`, `Placement`, `Alignment`
 
 #### Buttons
+
 - Contracts: `ButtonProps`, `ButtonGroupProps`, `DropDownButtonProps`, `IconButtonProps`, `SpeedDialProps`
 - Types: `ButtonType`, `ButtonStyle`, `DropDownItem`, `SpeedDialAction`
 
 #### Form Controls
+
 - `FormFieldProps`, `ValidationRule`, `ValidationResult` + `validateField()` (pure validation, no framework deps)
 - `TextInputProps` (type, mask, prefix/suffix, maxLength)
 - `NumberInputProps` + `clampNumber()` (min/max/precision clamping)
@@ -26,30 +178,37 @@ Framework-agnostic TypeScript contracts, state machines, validation utilities, a
 - `TextAreaProps`, `AutocompleteProps`, `ColorPickerProps`, `FileUploadProps`
 
 #### Data Display
+
 - `DataGridProps`, `ColumnDef`, `SortState`, `FilterState` + `multiSort()`, `applyFilters()`, `paginate()`
 - `BadgeProps`, `ProgressProps`, `AvatarProps` + `getInitials()`
 
 #### Navigation
+
 - `TabsProps`, `TabItem` + `createTabsState()` (state machine with getActive/setActive/getNext/getPrev)
 - `BreadcrumbProps`, `BreadcrumbItem` + `collapseBreadcrumb()` (keeps first + last N items)
 - `AccordionProps`, `AccordionItem` + `toggleAccordion()` (single/multiple mode logic)
 - `MenuProps`, `MenuItem`, `DrawerProps`
 
 #### Overlays & Feedback
+
 - `ModalProps`, `AlertProps`, `ToastConfig` + `ToastManager` class (queue, subscribe, dismiss, auto-expire)
 - `PopoverProps`, `TooltipProps`
 
 #### Charts
+
 - `ChartProps`, `ChartSeries`, `ChartAxis`, `ChartLegend` (17 chart types)
 
 #### Planning
+
 - `SchedulerProps`, `SchedulerEvent`, `SchedulerResource` (day/week/month/timeline/agenda views)
 - `GanttProps`, `GanttTask` (with dependencies, milestones, progress)
 
 #### Tree View
+
 - `TreeViewProps`, `TreeNode` + `flattenTree()` (for virtual scrolling), `searchTree()` (match with paths)
 
 #### Layout
+
 - `SplitterProps`, `SplitterPane` + `calculatePaneSizes()` (constrained resize logic)
 
 ---

package/dist/core/hooks.d.ts

@@ -19,6 +19,18 @@ export declare function useLongPress(callback: () => void, holdMs?: number): {
     onPointerUp: () => void;
     onPointerCancel: () => void;
 };
+/**
+ * Press-and-hold auto-repeat for stepper buttons. `start(action)` repeats `action`
+ * at an accelerating rate while held (first repeat after 400ms, then speeding up to
+ * ~30ms); `stop()` ends it. Keep the button's own `onClick` for a single tap and
+ * wire `start`/`stop` to `onPointerDown` / `onPointerUp` + `onPointerLeave` (works
+ * for mouse, touch and pen). Used by NiceNumberInput and NiceDateTimePicker's time
+ * spinners.
+ */
+export declare function useHoldRepeat(): {
+    start: (action: () => void) => void;
+    stop: () => void;
+};
 /**
  * Returns a stable unique HTML id. Passes through `externalId` when provided,
  * otherwise generates one via React's `useId()`.

package/dist/core/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAY1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,GAAG,OAAO,CAqBhD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,IAAI,EACpB,MAAM,SAAM,GACX;IACD,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;IAC/C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B,CAmBA;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI;IAC/B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAuBA;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAOjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,IAAI,QAe5F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,QAwCrF;AAMD,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1C,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,0DAA0D;IAC1D,gBAAgB,EAAE,OAAO,GAAG,MAAM,CAAC;IACnC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,uBAAuB;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,qDAAqD;IACrD,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA0E/E;AAMD,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,EAC7C,OAAO,GAAE,qBAA0B,GAClC;IACD,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CA4GA;AAgFD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAqEA"}

package/dist/core/i18nDictionaries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18nDictionaries.d.ts","sourceRoot":"","sources":["../../src/core/i18nDictionaries.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,+IAuBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAi6KtE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBpF,CAAC"}
+{"version":3,"file":"i18nDictionaries.d.ts","sourceRoot":"","sources":["../../src/core/i18nDictionaries.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,+IAuBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAu6KtE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBpF,CAAC"}

package/dist/core/icons.d.ts

@@ -40,6 +40,6 @@ export declare const NiceIcon: React.FC<NiceIconProps>;
 export declare function useNiceIcon(): {
     renderIcon: (icon: React.ReactNode | string | undefined, size?: NiceIconSize | number) => React.ReactNode;
 };
-/** Array of all 78 built-in icon names available without a custom resolver. */
+/** Array of all built-in icon names available without a custom resolver. */
 export declare const NICE_BUILTIN_ICONS: string[];
 //# sourceMappingURL=icons.d.ts.map

package/dist/core/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/core/icons.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiD,MAAM,OAAO,CAAC;AA2FtE,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAU5D,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAW3F,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAE5D,CAAC;AAiDF;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0C5C,CAAC;AAKF;;;GAGG;AACH,wBAAgB,WAAW;uBAKf,KAAK,CAAC,SAAS,GAAG,MAAM,GAAG,SAAS,SACpC,YAAY,GAAG,MAAM,KAC1B,KAAK,CAAC,SAAS;EAarB;AAED,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,UAA6B,CAAC"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/core/icons.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAuNtE,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAU5D,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAW3F,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAE5D,CAAC;AAiDF;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0C5C,CAAC;AAKF;;;GAGG;AACH,wBAAgB,WAAW;uBAKf,KAAK,CAAC,SAAS,GAAG,MAAM,GAAG,SAAS,SACpC,YAAY,GAAG,MAAM,KAC1B,KAAK,CAAC,SAAS;EAarB;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,UAA6B,CAAC"}

package/dist/core/spatialNav.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Spatial navigation — controller + arrow-key directional focus for UI controls.
+ *
+ * Headless mechanism (lives in ui-core so any package can use it): a provider
+ * tracks registered focusable elements and moves focus by direction using a
+ * dot-product gate + nearest-by-distance heuristic. Inputs: keyboard arrows
+ * (+ Enter to activate, Escape to dismiss a focus trap) and a gamepad d-pad /
+ * left-stick (A = activate, B = dismiss trap) via {@link useGamepad}.
+ *
+ * Wrap a subtree in `NiceSpatialNavProvider`; register controls with
+ * `useSpatialFocusable(ref, { id })` or the `<NiceFocusable>` wrapper.
+ */
+import React from 'react';
+import type { NiceBaseProps } from './types';
+export interface SpatialFocusableMeta {
+    id: string;
+    ref: React.RefObject<HTMLElement | null>;
+    onActivate?: () => void;
+    disabled?: boolean;
+}
+export interface NiceSpatialNavContextValue {
+    register: (meta: SpatialFocusableMeta) => void;
+    unregister: (id: string) => void;
+    /** Move focus in a direction (dx,dy ∈ {-1,0,1}). */
+    moveFocus: (dx: number, dy: number) => void;
+    /** Activate the active (or given) focusable. */
+    activate: (id?: string) => void;
+    setActive: (id: string) => void;
+    activeId: string | null;
+    focusables: SpatialFocusableMeta[];
+    /** Constrain navigation to ids starting with `prefix` (modal/menu scope). */
+    pushFocusTrap: (prefix: string, onDismiss?: () => void) => void;
+    popFocusTrap: () => void;
+    /** Ref-counted lock that suspends navigation (e.g. while a slider is open). */
+    pauseNavigation: () => void;
+    resumeNavigation: () => void;
+}
+export interface NiceSpatialNavProviderProps extends NiceBaseProps {
+    /** Handle keyboard arrow keys (default true). */
+    keyboard?: boolean;
+    /** Poll a gamepad for navigation (default true). */
+    gamepad?: boolean;
+    /** Gamepad index forwarded to useGamepad (default 0). */
+    gamepadIndex?: number;
+    children: React.ReactNode;
+}
+export declare const NiceSpatialNavProvider: React.FC<NiceSpatialNavProviderProps>;
+/** Access the spatial-nav context. Returns `null` outside a provider. */
+export declare function useSpatialNavOptional(): NiceSpatialNavContextValue | null;
+/** Access the spatial-nav context. Throws outside a provider. */
+export declare function useSpatialNav(): NiceSpatialNavContextValue;
+export interface UseSpatialFocusableOptions {
+    id: string;
+    onActivate?: () => void;
+    disabled?: boolean;
+}
+/**
+ * Register `ref`'s element as a spatial-nav focusable. No-op (returns
+ * `{ active: false }`) when used outside a provider. Sets `data-active` on the
+ * element while it is the active focusable.
+ */
+export declare function useSpatialFocusable(ref: React.RefObject<HTMLElement | null>, opts: UseSpatialFocusableOptions): {
+    active: boolean;
+};
+export interface NiceFocusableProps extends NiceBaseProps {
+    /** Unique id within the provider (prefix it to scope to a focus trap). */
+    focusId: string;
+    onActivate?: () => void;
+    disabled?: boolean;
+    as?: React.ElementType;
+    children: React.ReactNode;
+}
+/** Thin wrapper that registers its element with the spatial-nav provider. */
+export declare const NiceFocusable: React.FC<NiceFocusableProps>;
+//# sourceMappingURL=spatialNav.d.ts.map

package/dist/core/spatialNav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatialNav.d.ts","sourceRoot":"","sources":["../../src/core/spatialNav.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAQN,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC/C,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,oDAAoD;IACpD,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,gDAAgD;IAChD,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,6EAA6E;IAC7E,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAChE,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,+EAA+E;IAC/E,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAID,MAAM,WAAW,2BAA4B,SAAQ,aAAa;IAChE,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAiBD,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CA+QxE,CAAC;AAIF,yEAAyE;AACzE,wBAAgB,qBAAqB,IAAI,0BAA0B,GAAG,IAAI,CAEzE;AAED,iEAAiE;AACjE,wBAAgB,aAAa,IAAI,0BAA0B,CAM1D;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACxC,IAAI,EAAE,0BAA0B,GAC/B;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CA8CrB;AAID,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,EAAE,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAwBtD,CAAC"}

package/dist/core/useGamepad.d.ts

@@ -0,0 +1,70 @@
+/**
+ * useGamepad — headless hook for gamepad/controller support.
+ *
+ * Supports Xbox, PlayStation and generic controllers via the standard Gamepad
+ * API: button mapping, axis input with deadzone, rumble, action binding and
+ * rising/falling button-edge callbacks. This is the canonical, dependency-free
+ * implementation; `@nice2dev/ui-graphics` and `@nice2dev/game-engine` re-export
+ * it (and add their own game-specific UI on top).
+ */
+export type GamepadButton = 'A' | 'B' | 'X' | 'Y' | 'LB' | 'RB' | 'LT' | 'RT' | 'Back' | 'Start' | 'LS' | 'RS' | 'DpadUp' | 'DpadDown' | 'DpadLeft' | 'DpadRight' | 'Home';
+export type GamepadAxis = 'LeftX' | 'LeftY' | 'RightX' | 'RightY';
+export interface GamepadState {
+    connected: boolean;
+    id: string;
+    buttons: Record<GamepadButton, boolean>;
+    axes: Record<GamepadAxis, number>;
+    /** Trigger pressure (0-1). */
+    leftTrigger: number;
+    rightTrigger: number;
+    /** Trigger rumble on the underlying device (no-op if unsupported). */
+    vibrate: (duration: number, weakMagnitude?: number, strongMagnitude?: number) => void;
+}
+export interface GamepadAction {
+    button?: GamepadButton;
+    buttons?: GamepadButton[];
+    axis?: GamepadAxis;
+    axisDirection?: 'positive' | 'negative';
+    trigger?: 'LT' | 'RT';
+    onPress?: () => void;
+    onRelease?: () => void;
+    onHold?: () => void;
+    onAxisChange?: (value: number) => void;
+    repeatDelay?: number;
+    repeatRate?: number;
+}
+export interface UseGamepadOptions {
+    /** Gamepad index to use (default: 0). */
+    index?: number;
+    /** Deadzone for analog sticks (default: 0.15). */
+    deadzone?: number;
+    /** Polling rate in ms (default: 16 = ~60fps). */
+    pollRate?: number;
+    /** Action bindings. */
+    actions?: Record<string, GamepadAction>;
+    /** Enable/disable (default: true). */
+    enabled?: boolean;
+    /** Fired on the rising edge of any button (for live highlighting). */
+    onButtonDown?: (button: GamepadButton) => void;
+    /** Fired on the falling edge of any button. */
+    onButtonUp?: (button: GamepadButton) => void;
+}
+/** PlayStation button-name aliases → canonical (Xbox) button names. */
+export declare const PS_BUTTON_ALIASES: Record<string, GamepadButton>;
+/** All gamepad button names, in Gamepad-API index order. */
+export declare const GAMEPAD_BUTTONS: GamepadButton[];
+export declare function useGamepad(options?: UseGamepadOptions): GamepadState;
+export interface NavigationActions {
+    onNavigateUp?: () => void;
+    onNavigateDown?: () => void;
+    onNavigateLeft?: () => void;
+    onNavigateRight?: () => void;
+    onConfirm?: () => void;
+    onCancel?: () => void;
+    onTabNext?: () => void;
+    onTabPrev?: () => void;
+    onMenu?: () => void;
+}
+/** Create a standard UI-navigation action map for {@link useGamepad}. */
+export declare function createNavigationActions(handlers: NavigationActions): Record<string, GamepadAction>;
+//# sourceMappingURL=useGamepad.d.ts.map

package/dist/core/useGamepad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGamepad.d.ts","sourceRoot":"","sources":["../../src/core/useGamepad.ts"],"names":[],"mappings":"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"}

package/dist/core/useThemeIsDark.d.ts

@@ -1,15 +1,22 @@
+import type { RefObject } from 'react';
 /**
  * Live boolean indicating whether the active theme renders as "dark".
  *
- * Resolution order:
- * 1. `<html data-theme="dark|light">` attribute (explicit consumer wins)
- * 2. `nice-dark` / `nice-light` (and bare `dark`) class on `<html>`
- * 3. `--text-primary` CSS variable luminance (light text → dark theme)
+ * Resolution order (evaluated against the nearest theme scope of `ref`, or
+ * `<html>` when no ref is given):
+ * 1. `data-theme="dark|light"` on the nearest scoped ancestor (explicit wins)
+ * 2. `nice-dark` / `nice-light` (and bare `dark`) class on that scope
+ * 3. the element's own resolved `--text-primary` luminance (light text → dark)
  * 4. `prefers-color-scheme: dark` media query as last-resort fallback
  *
- * Updates whenever any of the above change (MutationObserver on `<html>`
- * attributes/class/style + media-query listener), so canvas-based renderers
- * (QR, barcode, charts…) stay in sync without consumers wiring `useDarkMode`.
+ * Pass a `ref` to a rendered element (e.g. a canvas) so the result reflects the
+ * element's **own** surface — `NiceThemeProvider` themes a scoped container, not
+ * `<html>`, so a canvas nested under a scoped provider must read its own scope,
+ * not the document root. Without a ref it observes `<html>` as before.
+ *
+ * Updates whenever the observed scope (or `<html>`) attributes/class/style or the
+ * media query change, so canvas-based renderers (QR, barcode, charts…) stay in
+ * sync without consumers wiring `useDarkMode`.
  */
-export declare function useThemeIsDark(): boolean;
+export declare function useThemeIsDark(ref?: RefObject<HTMLElement | null>): boolean;
 //# sourceMappingURL=useThemeIsDark.d.ts.map

package/dist/core/useThemeIsDark.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useThemeIsDark.d.ts","sourceRoot":"","sources":["../../src/core/useThemeIsDark.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,OAAO,CA4BxC"}
+{"version":3,"file":"useThemeIsDark.d.ts","sourceRoot":"","sources":["../../src/core/useThemeIsDark.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,OAAO,CAoC3E"}