@owlmeans/web-panel 0.1.18-rc.9 → 0.1.18

package/build/components/picker/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/components/picker/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AAKjE,MAAM,OAAO,GAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAA;AAE7D,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAErC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACtE,CAAC,CAAA;AAED,yGAAyG;AACzG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,GAAoB,OAAO,EAAc,EAAE;IACjF,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,QAAgB,EAAU,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IAEhF,6FAA6F;IAC7F,0EAA0E;IAC1E,MAAM,KAAK,GAAG,CAAC,QAA6B,EAAU,EAAE,CACtD,CAAC,QAAQ,CAAC,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAC;QAC3G,CAAC,CAAC,SAAS,CAAC,UAAU,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC;QACrD,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAA;IAEpB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAErD,MAAM,QAAQ,GAAG,CAAC,KAAyB,EAAU,EAAE,CAAC,SAAS,CAAC,cAAc,KAAK,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAEzG,iGAAiG;IACjG,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAEvH,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IAEjH,MAAM,OAAO,GAAG,CACd,QAAmC,EAAE,QAAoC,EAAE,IAAgB,EAC5E,EAAE;QACjB,MAAM,KAAK,GAAG;YACZ,IAAI,KAAK,OAAO,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;YAC/E,IAAI,KAAK,MAAM,IAAI,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;SAC7D,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;QAEhD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACpD,CAAC,CAAA;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC/D,CAAC,CAAA"}

package/build/components/picker/tile.d.ts

@@ -0,0 +1,11 @@
+import type { FC } from 'react';
+import type { IconTileProps } from './types.js';
+/**
+ * A stored mark rendered — the way a list, a chip or a header shows what a person chose.
+ *
+ * `tile` puts the icon in the colour's ink on the colour's ground; `plain` is the ink alone. Both
+ * follow the page's scheme on their own (`.dark`, or the system's dark unless `.light`). An unknown
+ * icon renders the fallback circle and an unknown colour slate — a stored value never breaks a page.
+ */
+export declare const IconTile: FC<IconTileProps>;
+//# sourceMappingURL=tile.d.ts.map

package/build/components/picker/tile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile.d.ts","sourceRoot":"","sources":["../../../src/components/picker/tile.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAK/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/C;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CAmBtC,CAAA"}

package/build/components/picker/tile.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from '../../@/lib/utils.js';
+import { pickerIconHelper } from '../../picker/icons.js';
+import { pickerColorHelper } from '../../picker/vocabulary.js';
+import { PICKER_FALLBACK_ICON } from '../../picker/vocabulary/consts.js';
+import { PICK_SCOPE, PLAIN, PLAIN_SIZE, TILE, TILE_SIZE } from './consts.local.js';
+/**
+ * A stored mark rendered — the way a list, a chip or a header shows what a person chose.
+ *
+ * `tile` puts the icon in the colour's ink on the colour's ground; `plain` is the ink alone. Both
+ * follow the page's scheme on their own (`.dark`, or the system's dark unless `.light`). An unknown
+ * icon renders the fallback circle and an unknown colour slate — a stored value never breaks a page.
+ */
+export const IconTile = ({ icon, color, colors, size = 'md', variant = 'tile', label, className, style }) => {
+    const Icon = pickerIconHelper.iconOf(icon);
+    const resolved = pickerColorHelper.resolve(color, colors);
+    return _jsx("span", { "data-icon-tile": variant, "data-icon": pickerIconHelper.has(icon) ? icon : PICKER_FALLBACK_ICON, "data-color": resolved?.key, role: label != null ? 'img' : undefined, "aria-label": label, "aria-hidden": label != null ? undefined : true, title: label, style: { ...pickerColorHelper.styleOf(color, colors), ...style }, className: cn(PICK_SCOPE, variant === 'tile' ? TILE : PLAIN, variant === 'tile' ? TILE_SIZE[size] : PLAIN_SIZE[size], className), children: _jsx(Icon, { "aria-hidden": "true" }) });
+};
+//# sourceMappingURL=tile.js.map

package/build/components/picker/tile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile.js","sourceRoot":"","sources":["../../../src/components/picker/tile.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAA;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AAExE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAsB,CACzC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAC/E,EAAE;IACF,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAEzD,OAAO,iCACW,OAAO,eACZ,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,gBACvD,QAAQ,EAAE,GAAG,EACzB,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,gBAC3B,KAAK,iBACJ,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAC7C,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,EAChE,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,YAEhI,KAAC,IAAI,mBAAa,MAAM,GAAG,GACtB,CAAA;AACT,CAAC,CAAA"}

package/build/components/picker/translate.d.ts

@@ -0,0 +1,9 @@
+import type { PickerTranslate } from './types.js';
+/**
+ * A `translate` reading the picker's own library bundle (`lib:picker`, eight languages) in the
+ * current language — what an application rendered by `PanelApp` / `render()` passes to every picker
+ * part. It needs that i18n instance: called anywhere without one it throws inside render, which is
+ * exactly why no picker part calls it by itself. Missing keys fall back to the English text.
+ */
+export declare const usePickerTranslate: () => PickerTranslate;
+//# sourceMappingURL=translate.d.ts.map

package/build/components/picker/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../../src/components/picker/translate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAO,eAIrC,CAAA"}

package/build/components/picker/translate.js

@@ -0,0 +1,13 @@
+import { useCallback } from 'react';
+import { useI18nLib } from '@owlmeans/client-i18n';
+/**
+ * A `translate` reading the picker's own library bundle (`lib:picker`, eight languages) in the
+ * current language — what an application rendered by `PanelApp` / `render()` passes to every picker
+ * part. It needs that i18n instance: called anywhere without one it throws inside render, which is
+ * exactly why no picker part calls it by itself. Missing keys fall back to the English text.
+ */
+export const usePickerTranslate = () => {
+    const t = useI18nLib('picker');
+    return useCallback((key, fallback) => t(key, { defaultValue: fallback }), [t]);
+};
+//# sourceMappingURL=translate.js.map

package/build/components/picker/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../../src/components/picker/translate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGlD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAoB,EAAE;IACtD,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAE9B,OAAO,WAAW,CAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AACjG,CAAC,CAAA"}

package/build/components/picker/trigger.d.ts

@@ -0,0 +1,12 @@
+import type { FC } from 'react';
+import type { PickerTriggerProps } from './types.local.js';
+/**
+ * What opens a picker: a field-like button (the mark, its names, a chevron) or the mark alone.
+ *
+ * It is the popover's anchor and stays mounted in one place whichever surface opens, so focus has
+ * one element to return to. Its accessible name is the label and the current choice ("Mark:
+ * Rocket · Indigo"); it carries `data-picker-trigger`, never `data-slot="button"` or `data-tone`.
+ * Extra props — the popover anchor's — land on the button.
+ */
+export declare const PickerTrigger: FC<PickerTriggerProps>;
+//# sourceMappingURL=trigger.d.ts.map

package/build/components/picker/trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../../src/components/picker/trigger.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAI/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAM1D;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,EAAE,CAAC,kBAAkB,CAmChD,CAAA"}

package/build/components/picker/trigger.js

@@ -0,0 +1,29 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ChevronDownIcon, PlusIcon } from 'lucide-react';
+import { cn } from '../../@/lib/utils.js';
+import { pickerColorHelper } from '../../picker/vocabulary.js';
+import { IconTile } from './tile.js';
+import { CHEVRON, HAIRLINE, TRIGGER_BUTTON, TRIGGER_COMPACT, TRIGGER_DISC, TRIGGER_DOT, TRIGGER_EMPTY, } from './consts.local.js';
+/**
+ * What opens a picker: a field-like button (the mark, its names, a chevron) or the mark alone.
+ *
+ * It is the popover's anchor and stays mounted in one place whichever surface opens, so focus has
+ * one element to return to. Its accessible name is the label and the current choice ("Mark:
+ * Rocket · Indigo"); it carries `data-picker-trigger`, never `data-slot="button"` or `data-tone`.
+ * Extra props — the popover anchor's — land on the button.
+ */
+export const PickerTrigger = ({ ref, mode, variant, icon, color, colors, text, label, placeholder, open, disabled, id, className, onOpen, ...anchor }) => {
+    const resolved = pickerColorHelper.resolve(color, colors);
+    const summary = text.summary(icon, resolved, mode);
+    const name = label != null && label !== '' ? `${label}: ${summary ?? placeholder}` : summary ?? placeholder;
+    const empty = summary == null;
+    const mark = mode === 'color'
+        ? empty
+            ? _jsx("span", { "aria-hidden": "true", className: cn(TRIGGER_EMPTY, 'rounded-full', variant === 'dot' && 'size-5') })
+            : _jsx("span", { "aria-hidden": "true", style: pickerColorHelper.styleOf(color, colors), className: cn(TRIGGER_DISC, HAIRLINE, variant === 'dot' && 'size-5') })
+        : empty
+            ? _jsx("span", { "aria-hidden": "true", className: cn(TRIGGER_EMPTY, variant === 'tile' && 'size-full rounded-lg'), children: _jsx(PlusIcon, {}) })
+            : _jsx(IconTile, { icon: icon, color: color, colors: colors, size: variant === 'tile' ? 'md' : 'sm', className: variant === 'tile' ? 'size-full' : undefined });
+    return _jsxs("button", { ...anchor, ref: ref, type: "button", id: id, disabled: disabled, "data-picker-trigger": variant, "aria-haspopup": "dialog", "aria-expanded": open, "aria-label": name, title: variant === 'button' ? undefined : name, onClick: onOpen, className: cn(variant === 'button' ? TRIGGER_BUTTON : TRIGGER_COMPACT, variant === 'dot' && TRIGGER_DOT, className), children: [variant === 'button' && mode === 'color' ? _jsx("span", { className: "inline-flex size-7 shrink-0 items-center justify-center", children: mark }) : mark, variant === 'button' && _jsxs(_Fragment, { children: [_jsx("span", { className: cn('min-w-0 flex-1 truncate', empty && 'text-muted-foreground'), children: summary ?? placeholder }), _jsx(ChevronDownIcon, { "aria-hidden": "true", className: CHEVRON })] })] });
+};
+//# sourceMappingURL=trigger.js.map

package/build/components/picker/trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.js","sourceRoot":"","sources":["../../../src/components/picker/trigger.tsx"],"names":[],"mappings":"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"}

package/build/components/picker/types.d.ts

@@ -0,0 +1,114 @@
+import type { CSSProperties } from 'react';
+import type { PickerColor } from '../../picker/vocabulary/types.js';
+/**
+ * Resolves a picker string: the key (`done`, `colors.indigo`, `categories.work` …) and the English
+ * text to show without a translation. `usePickerTranslate()` gives one reading the packaged
+ * eight-language bundle; without one the parts render English.
+ */
+export interface PickerTranslate {
+    (key: string, fallback: string): string;
+}
+/** Where a picker opens: `auto` — a popover from 768px up, a bottom sheet below (decided when it opens). */
+export type PickerSurfaceChoice = 'auto' | 'popover' | 'sheet';
+/** What the three pickers share. */
+export interface PickerBaseProps {
+    /** The trigger's accessible name and the surface's title. */
+    label?: string;
+    /** The trigger's text while nothing is chosen. */
+    placeholder?: string;
+    disabled?: boolean;
+    surface?: PickerSurfaceChoice;
+    /** Strings; English without it. Never an implicit i18n read — the parts render without a provider. */
+    translate?: PickerTranslate;
+    /** Merged over the trigger's classes. */
+    className?: string;
+    /** Lands on the trigger button, so a `<label htmlFor>` names it. */
+    id?: string;
+}
+/** A stored mark: a palette key or `#rrggbb`, and a kebab-case lucide name. Either may be missing. */
+export interface IconColorValue {
+    icon?: string | null;
+    color?: string | null;
+}
+/** What `IconColorPicker` emits: both halves as they now stand; an unset half stays `undefined`, never `null`. */
+export interface IconColorChange {
+    icon?: string;
+    color?: string;
+}
+export interface IconColorPickerProps extends PickerBaseProps {
+    value?: IconColorValue | null;
+    onChange: (next: IconColorChange) => void;
+    /** The palette offered; default the 24 colours. */
+    colors?: readonly PickerColor[];
+    /** Narrows the icon catalogue (and orders it). */
+    icons?: readonly string[];
+    /** Adds the full colour wheel and a hex field; the value is then a palette key or `#rrggbb`. */
+    customColors?: boolean;
+    /** `button` (default) — tile, names and a chevron; `tile` — the tile alone. */
+    trigger?: 'button' | 'tile';
+}
+export interface IconPickerProps extends PickerBaseProps {
+    value?: string | null;
+    onChange: (icon: string) => void;
+    /** The colour the icons are tinted in. */
+    color?: string | null;
+    colors?: readonly PickerColor[];
+    icons?: readonly string[];
+    trigger?: 'button' | 'tile';
+}
+export interface ColorPickerProps extends PickerBaseProps {
+    value?: string | null;
+    onChange: (color: string) => void;
+    colors?: readonly PickerColor[];
+    customColors?: boolean;
+    /** `button` (default) — dot, name and a chevron; `dot` — the dot alone. */
+    trigger?: 'button' | 'dot';
+}
+/** The swatch grid on its own, for a dialog or sheet the application already owns. */
+export interface ColorSwatchesProps {
+    value?: string | null;
+    onChange: (color: string) => void;
+    colors?: readonly PickerColor[];
+    customColors?: boolean;
+    translate?: PickerTranslate;
+    /** The group's accessible name; default "Colour". */
+    label?: string;
+    className?: string;
+}
+/** The searchable icon grid on its own, for a dialog or sheet the application already owns. */
+export interface IconGridProps {
+    value?: string | null;
+    onChange: (icon: string) => void;
+    /** The colour the icons are tinted in. */
+    color?: string | null;
+    colors?: readonly PickerColor[];
+    icons?: readonly string[];
+    translate?: PickerTranslate;
+    /** The grid's accessible name; default "Icon". */
+    label?: string;
+    className?: string;
+}
+export type PickerTileSize = 'xs' | 'sm' | 'md' | 'lg';
+/** A stored mark rendered: the icon in the colour's ink on its ground (`tile`), or the ink alone (`plain`). */
+export interface IconTileProps {
+    icon?: string | null;
+    color?: string | null;
+    colors?: readonly PickerColor[];
+    size?: PickerTileSize;
+    variant?: 'tile' | 'plain';
+    /** Present — an image with this name; absent — decorative (`aria-hidden`). */
+    label?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+export type PickerDotSize = 'xs' | 'sm' | 'md';
+/** A stored colour rendered as a dot in its ink. */
+export interface ColorDotProps {
+    color?: string | null;
+    colors?: readonly PickerColor[];
+    size?: PickerDotSize;
+    /** Present — an image with this name; absent — decorative (`aria-hidden`). */
+    label?: string;
+    className?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/components/picker/types.d.ts.map

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

package/build/components/picker/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/components/picker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/components/picker/types.ts"],"names":[],"mappings":""}

package/build/components/picker/types.local.d.ts

@@ -0,0 +1,143 @@
+import type { ComponentProps, KeyboardEvent, ReactElement, ReactNode, Ref, RefObject } from 'react';
+import type { PickerColor, PickerIconCategory, ResolvedPickerColor } from '../../picker/vocabulary/types.js';
+import type { PickerTranslate } from './types.js';
+/** Where a panel is laid out — it decides cell sizes and paddings. */
+export type PickerLayout = 'popover' | 'sheet' | 'inline';
+/** Which halves a picker edits. */
+export type PickerMode = 'both' | 'icon' | 'color';
+/** Every string a picker shows, resolved through one `translate`. */
+export interface PickerText {
+    /** A chrome string by key, English fallback. */
+    text: (key: string, fallback: string) => string;
+    /** A colour's name: a palette name through `colors.<key>`, a custom colour's hex as is. */
+    color: (color: ResolvedPickerColor) => string;
+    /** An icon's name — the kebab name humanized; icon names are never translated. */
+    icon: (name: string) => string;
+    category: (category: PickerIconCategory) => string;
+    /** "Icons found: 12" for the live region. */
+    count: (count: number) => string;
+    /** "No icons match …". */
+    empty: (query: string) => string;
+    /** "Rocket · Indigo", or `null` while nothing is chosen. */
+    summary: (icon: string | null | undefined, color: ResolvedPickerColor | null, mode: PickerMode) => string | null;
+}
+/** Arrow-key focus across a grid of buttons; only one of them is in the tab order. */
+export interface RovingGrid {
+    ref: RefObject<HTMLDivElement | null>;
+    onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;
+    /** `0` for the one item in the tab order, `-1` for the rest. */
+    tabIndexOf: (index: number) => number;
+    /** Remember an item as the current one (it took focus). */
+    setCurrent: (index: number) => void;
+    /** Focus the current item. */
+    focusCurrent: () => void;
+}
+export interface RovingGridOptions {
+    count: number;
+    /** The item that starts in the tab order — the selected one. */
+    selected: number;
+    /** ArrowUp from the first row: hand focus back (the search field above a grid). */
+    onExitUp?: () => void;
+    /** `false` — one row, Left/Right only. */
+    grid?: boolean;
+}
+export interface SwatchGridProps {
+    value?: string | null;
+    /** A swatch was pressed. */
+    onChange: (color: string) => void;
+    /** The custom wheel or hex field changed; default `onChange`. A picker that closes on a pick keeps this open. */
+    onCustomChange?: (color: string) => void;
+    colors: readonly PickerColor[];
+    customColors: boolean;
+    text: PickerText;
+    layout: PickerLayout;
+    label: string;
+    className?: string;
+}
+export interface CustomColorProps {
+    /** The current value when it is a custom colour, else `null`. */
+    value: ResolvedPickerColor | null;
+    onChange: (color: string) => void;
+    text: PickerText;
+}
+export interface IconBrowserProps {
+    value?: string | null;
+    onChange: (icon: string) => void;
+    color?: string | null;
+    colors: readonly PickerColor[];
+    icons?: readonly string[];
+    text: PickerText;
+    layout: PickerLayout;
+    label: string;
+    /** The search field — the surface focuses it on open for a fine pointer. */
+    searchRef?: Ref<HTMLInputElement>;
+    className?: string;
+}
+export interface PickerPanelProps {
+    mode: PickerMode;
+    icon?: string | null;
+    color?: string | null;
+    onIcon: (icon: string) => void;
+    /** A swatch was pressed. */
+    onColor: (color: string) => void;
+    /** The custom wheel or hex field changed. */
+    onCustomColor: (color: string) => void;
+    colors: readonly PickerColor[];
+    icons?: readonly string[];
+    customColors: boolean;
+    text: PickerText;
+    layout: 'popover' | 'sheet';
+    title: string;
+    /** The sheet's Done button; the popover has none. */
+    onDone?: () => void;
+    searchRef: Ref<HTMLInputElement>;
+}
+export interface PickerSurfaceProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    kind: 'popover' | 'sheet';
+    /** Holds an icon grid — keep one height so filtering never makes the surface jump. */
+    tall: boolean;
+    /** The trigger — the popover's anchor, kept in the same place in the tree for both surfaces. */
+    anchor: ReactElement;
+    title: string;
+    /** Focus on open (the search field for a fine pointer, the selected cell otherwise). */
+    onOpenFocus: (content: HTMLElement) => void;
+    /** Focus back on the trigger once closed. */
+    onCloseFocus: () => void;
+    children: ReactNode;
+}
+/** The trigger's own props; anything else (the popover anchor's) lands on the button. */
+export interface PickerTriggerProps extends Omit<ComponentProps<'button'>, 'color' | 'onClick' | 'type' | 'children'> {
+    mode: PickerMode;
+    variant: 'button' | 'tile' | 'dot';
+    icon?: string | null;
+    color?: string | null;
+    colors: readonly PickerColor[];
+    text: PickerText;
+    label?: string;
+    placeholder: string;
+    open: boolean;
+    onOpen: () => void;
+}
+export interface PickerRootProps {
+    mode: PickerMode;
+    icon?: string | null;
+    color?: string | null;
+    onIcon: (icon: string) => void;
+    onColor: (color: string) => void;
+    colors?: readonly PickerColor[];
+    icons?: readonly string[];
+    customColors?: boolean;
+    trigger: 'button' | 'tile' | 'dot';
+    /** A single-purpose picker closes once something is picked; the composite stays for the other half. */
+    closeOnPick: boolean;
+    label?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    surface?: 'auto' | 'popover' | 'sheet';
+    translate?: PickerTranslate;
+    className?: string;
+    id?: string;
+}
+//# sourceMappingURL=types.local.d.ts.map

package/build/components/picker/types.local.d.ts.map

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

package/build/components/picker/types.local.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.local.js.map

package/build/components/picker/types.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.js","sourceRoot":"","sources":["../../../src/components/picker/types.local.ts"],"names":[],"mappings":""}

package/build/components/scheme/consts.local.d.ts

@@ -0,0 +1,8 @@
+export declare const DARK_QUERY = "(prefers-color-scheme: dark)";
+/**
+ * A 44px round target in the page's own tokens — muted at rest, the foreground on hover — with
+ * the 3px ring every interactive element shows on keyboard focus. No fill, border, gradient or
+ * shadow: it sits in a footer's bottom row beside the credit and must read as part of it.
+ */
+export declare const TOGGLE: string;
+//# sourceMappingURL=consts.local.d.ts.map

package/build/components/scheme/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../../../src/components/scheme/consts.local.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,iCAAiC,CAAA;AAExD;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAKR,CAAA"}

package/build/components/scheme/consts.local.js

@@ -0,0 +1,13 @@
+export const DARK_QUERY = '(prefers-color-scheme: dark)';
+/**
+ * A 44px round target in the page's own tokens — muted at rest, the foreground on hover — with
+ * the 3px ring every interactive element shows on keyboard focus. No fill, border, gradient or
+ * shadow: it sits in a footer's bottom row beside the credit and must read as part of it.
+ */
+export const TOGGLE = [
+    'inline-flex size-11 shrink-0 cursor-pointer items-center justify-center rounded-full',
+    'bg-transparent text-muted-foreground transition-colors hover:text-foreground',
+    'outline-none focus-visible:ring-[3px] focus-visible:ring-ring focus-visible:ring-offset-2',
+    'focus-visible:ring-offset-background',
+].join(' ');
+//# sourceMappingURL=consts.local.js.map

package/build/components/scheme/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../../../src/components/scheme/consts.local.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,8BAA8B,CAAA;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,sFAAsF;IACtF,8EAA8E;IAC9E,2FAA2F;IAC3F,sCAAsC;CACvC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA"}

package/build/components/scheme/hook.d.ts

@@ -0,0 +1,16 @@
+import type { ColorSchemeModel } from './types.js';
+/**
+ * The page's colour scheme, and the way to choose one.
+ *
+ * Both halves are read synchronously on the first render — the stored choice from storage, the
+ * system preference from `matchMedia` — so a toggle never renders the wrong icon for a frame.
+ * Afterwards it follows three sources: `applyColorScheme` anywhere in this document (its event),
+ * another tab changing the stored key (`storage`), and the operating system switching while no
+ * choice is stored.
+ *
+ * Mounting also re-applies a stored choice's class. The head bootstrap has normally done that
+ * before the first paint; an application without it still ends up on the right scheme, one frame
+ * late rather than never.
+ */
+export declare const useColorScheme: () => ColorSchemeModel;
+//# sourceMappingURL=hook.d.ts.map

package/build/components/scheme/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../src/components/scheme/hook.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAOlD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,QAAO,gBAqCjC,CAAA"}

package/build/components/scheme/hook.js

@@ -0,0 +1,52 @@
+import { useCallback, useEffect, useState } from 'react';
+import { colorSchemeHelper } from '../../scheme/scheme.js';
+import { COLOR_SCHEME_EVENT, COLOR_SCHEME_KEY } from '../../scheme/consts.js';
+import { DARK_QUERY } from './consts.local.js';
+const systemDark = () => typeof window !== 'undefined' && typeof window.matchMedia === 'function'
+    && window.matchMedia(DARK_QUERY).matches;
+/**
+ * The page's colour scheme, and the way to choose one.
+ *
+ * Both halves are read synchronously on the first render — the stored choice from storage, the
+ * system preference from `matchMedia` — so a toggle never renders the wrong icon for a frame.
+ * Afterwards it follows three sources: `applyColorScheme` anywhere in this document (its event),
+ * another tab changing the stored key (`storage`), and the operating system switching while no
+ * choice is stored.
+ *
+ * Mounting also re-applies a stored choice's class. The head bootstrap has normally done that
+ * before the first paint; an application without it still ends up on the right scheme, one frame
+ * late rather than never.
+ */
+export const useColorScheme = () => {
+    const [choice, setState] = useState(colorSchemeHelper.readColorScheme);
+    const [dark, setDark] = useState(systemDark);
+    useEffect(() => {
+        const stored = colorSchemeHelper.readColorScheme();
+        if (stored != null) {
+            colorSchemeHelper.setColorSchemeClass(stored);
+        }
+        setState(stored);
+        const onChoice = () => setState(colorSchemeHelper.readColorScheme());
+        const onStorage = (event) => {
+            if (event.key === COLOR_SCHEME_KEY || event.key == null) {
+                const next = colorSchemeHelper.readColorScheme();
+                colorSchemeHelper.setColorSchemeClass(next);
+                setState(next);
+            }
+        };
+        window.addEventListener(COLOR_SCHEME_EVENT, onChoice);
+        window.addEventListener('storage', onStorage);
+        const media = typeof window.matchMedia === 'function' ? window.matchMedia(DARK_QUERY) : null;
+        const onSystem = () => setDark(media?.matches === true);
+        media?.addEventListener('change', onSystem);
+        onSystem();
+        return () => {
+            window.removeEventListener(COLOR_SCHEME_EVENT, onChoice);
+            window.removeEventListener('storage', onStorage);
+            media?.removeEventListener('change', onSystem);
+        };
+    }, []);
+    const setChoice = useCallback((next) => colorSchemeHelper.applyColorScheme(next), []);
+    return { scheme: choice ?? (dark ? 'dark' : 'light'), choice, setChoice };
+};
+//# sourceMappingURL=hook.js.map

package/build/components/scheme/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../../src/components/scheme/hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAG7E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,UAAU,GAAG,GAAY,EAAE,CAC/B,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;OACnE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,OAAO,CAAA;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAqB,EAAE;IACnD,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA2B,iBAAiB,CAAC,eAAe,CAAC,CAAA;IAChG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAU,UAAU,CAAC,CAAA;IAErD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAA;QAClD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,iBAAiB,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;QAC/C,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,CAAA;QAEhB,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,eAAe,EAAE,CAAC,CAAA;QACpE,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;YACxC,IAAI,KAAK,CAAC,GAAG,KAAK,gBAAgB,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;gBACxD,MAAM,IAAI,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAA;gBAChD,iBAAiB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAA;gBAC3C,QAAQ,CAAC,IAAI,CAAC,CAAA;YAChB,CAAC;QACH,CAAC,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAA;QACrD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAE7C,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAC5F,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,CAAA;QACvD,KAAK,EAAE,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC3C,QAAQ,EAAE,CAAA;QAEV,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAA;YACxD,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;YAChD,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAChD,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,IAA8B,EAAE,EAAE,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IAE/G,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AAC3E,CAAC,CAAA"}

package/build/components/scheme/index.d.ts

@@ -0,0 +1,4 @@
+export type * from './types.js';
+export * from './hook.js';
+export * from './toggle.js';
+//# sourceMappingURL=index.d.ts.map

package/build/components/scheme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/scheme/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAE/B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA"}

package/build/components/scheme/index.js

@@ -0,0 +1,3 @@
+export * from './hook.js';
+export * from './toggle.js';
+//# sourceMappingURL=index.js.map

package/build/components/scheme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/scheme/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA"}

package/build/components/scheme/toggle.d.ts

@@ -0,0 +1,14 @@
+import type { FC } from 'react';
+import type { ThemeToggleProps } from './types.js';
+/**
+ * The light/dark switcher.
+ *
+ * It flips the RESOLVED scheme, not the stored choice: on a system that prefers dark and with no
+ * choice stored, the page is dark, so the first press means "light" — a toggle keyed on the
+ * choice alone would answer that press with "dark", which changes nothing the visitor can see.
+ * The icon is the scheme the page is in (a sun while light, a moon while dark), chosen in script
+ * from the same state rather than by a `dark:` variant, so it is right whatever the app's CSS
+ * calls dark. The accessible name says what pressing does, from `labels` or the English default.
+ */
+export declare const ThemeToggle: FC<ThemeToggleProps>;
+//# sourceMappingURL=toggle.d.ts.map

package/build/components/scheme/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../../src/components/scheme/toggle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAI/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGlD;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,EAAE,CAAC,gBAAgB,CAc5C,CAAA"}

package/build/components/scheme/toggle.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Moon, Sun } from 'lucide-react';
+import { cn } from '../../@/lib/utils.js';
+import { useColorScheme } from './hook.js';
+import { TOGGLE } from './consts.local.js';
+/**
+ * The light/dark switcher.
+ *
+ * It flips the RESOLVED scheme, not the stored choice: on a system that prefers dark and with no
+ * choice stored, the page is dark, so the first press means "light" — a toggle keyed on the
+ * choice alone would answer that press with "dark", which changes nothing the visitor can see.
+ * The icon is the scheme the page is in (a sun while light, a moon while dark), chosen in script
+ * from the same state rather than by a `dark:` variant, so it is right whatever the app's CSS
+ * calls dark. The accessible name says what pressing does, from `labels` or the English default.
+ */
+export const ThemeToggle = ({ labels, className, style }) => {
+    const { scheme, setChoice } = useColorScheme();
+    const dark = scheme === 'dark';
+    const label = dark
+        ? labels?.toLight ?? 'Switch to light mode'
+        : labels?.toDark ?? 'Switch to dark mode';
+    return _jsx("button", { type: "button", "data-theme-toggle": true, "data-scheme": scheme, "aria-label": label, title: label, onClick: () => setChoice(dark ? 'light' : 'dark'), className: cn(TOGGLE, className), style: style, children: dark ? _jsx(Moon, { className: "size-5", "aria-hidden": "true" }) : _jsx(Sun, { className: "size-5", "aria-hidden": "true" }) });
+};
+//# sourceMappingURL=toggle.js.map

package/build/components/scheme/toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../../../src/components/scheme/toggle.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE1C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;IAChF,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAA;IAC9C,MAAM,IAAI,GAAG,MAAM,KAAK,MAAM,CAAA;IAC9B,MAAM,KAAK,GAAG,IAAI;QAChB,CAAC,CAAC,MAAM,EAAE,OAAO,IAAI,sBAAsB;QAC3C,CAAC,CAAC,MAAM,EAAE,MAAM,IAAI,qBAAqB,CAAA;IAE3C,OAAO,iBACL,IAAI,EAAC,QAAQ,4CAAgC,MAAM,gBAAc,KAAK,EAAE,KAAK,EAAE,KAAK,EACpF,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EACjD,SAAS,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,YAE7C,IAAI,CAAC,CAAC,CAAC,KAAC,IAAI,IAAC,SAAS,EAAC,QAAQ,iBAAa,MAAM,GAAG,CAAC,CAAC,CAAC,KAAC,GAAG,IAAC,SAAS,EAAC,QAAQ,iBAAa,MAAM,GAAG,GAC/F,CAAA;AACX,CAAC,CAAA"}