@orianatech/pire 0.13.0 → 0.16.0

package/dist/components/core/Icon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../../../src/components/core/Icon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AA2BpC;6FAC6F;AAC7F,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB;wEACoE;IACpE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;yEAEqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;qFAEiF;IACjF,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAChD;AAID;2CAC2C;AAC3C,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAerD;AAED,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;IACxF,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED;;;;;4EAK4E;AAC5E,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,IAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,qBAqC/E"}
+{"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../../../src/components/core/Icon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AA2BpC;6FAC6F;AAC7F,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB;wEACoE;IACpE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;yEAEqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;qFAEiF;IACjF,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAChD;AAID;2CAC2C;AAC3C,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAerD;AAED,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;IACxF,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED;;;;;4EAK4E;AAC5E,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,IAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,qBA4C/E"}

package/dist/components/core/Kbd.d.cts

@@ -0,0 +1,17 @@
+import type * as React from 'react';
+export interface KbdProps extends React.HTMLAttributes<HTMLElement> {
+    /** One key per element — compose several for a chord: `<Kbd>⌘</Kbd><Kbd>K</Kbd>`. */
+    children: React.ReactNode;
+    /** `sm` for inline use inside running text, where a full-size cap sits taller than the line. */
+    size?: 'sm' | 'md';
+}
+/**
+ * A single key, drawn as a key cap.
+ *
+ * Renders a real `<kbd>`, so assistive tech announces it as keyboard input rather than as loose
+ * text. It is painted only — nothing here binds a shortcut; that stays with the app.
+ *
+ * One key per element. A chord is several of these side by side, which keeps each cap the size of
+ * its own glyph instead of stretching one cap across "Ctrl+Shift+K".
+ */
+export declare function Kbd({ children, size, className, ...rest }: KbdProps): React.JSX.Element;

package/dist/components/core/Kbd.d.ts

@@ -0,0 +1,18 @@
+import type * as React from 'react';
+export interface KbdProps extends React.HTMLAttributes<HTMLElement> {
+    /** One key per element — compose several for a chord: `<Kbd>⌘</Kbd><Kbd>K</Kbd>`. */
+    children: React.ReactNode;
+    /** `sm` for inline use inside running text, where a full-size cap sits taller than the line. */
+    size?: 'sm' | 'md';
+}
+/**
+ * A single key, drawn as a key cap.
+ *
+ * Renders a real `<kbd>`, so assistive tech announces it as keyboard input rather than as loose
+ * text. It is painted only — nothing here binds a shortcut; that stays with the app.
+ *
+ * One key per element. A chord is several of these side by side, which keeps each cap the size of
+ * its own glyph instead of stretching one cap across "Ctrl+Shift+K".
+ */
+export declare function Kbd({ children, size, className, ...rest }: KbdProps): React.JSX.Element;
+//# sourceMappingURL=Kbd.d.ts.map

package/dist/components/core/Kbd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Kbd.d.ts","sourceRoot":"","sources":["../../../src/components/core/Kbd.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,MAAM,WAAW,QAAS,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACjE,qFAAqF;IACrF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,gGAAgG;IAChG,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAW,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,QAAQ,qBAI1E"}

package/dist/components/core/icon-data.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icon-data.generated.d.ts","sourceRoot":"","sources":["../../../src/components/core/icon-data.generated.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgE9C,CAAC"}
+{"version":3,"file":"icon-data.generated.d.ts","sourceRoot":"","sources":["../../../src/components/core/icon-data.generated.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2I9C,CAAC"}

package/dist/components/core/icon-map.d.cts

@@ -11,3 +11,12 @@
  *  point at one slug (`boxes` and `package` both mean `box`); the generator de-duplicates.
  */
 export declare const CARBON_MAP: Record<string, string>;
+/**
+ * Every name `Icon` can render, frozen and sorted.
+ *
+ * Exported because an unknown slug fails quietly — an empty box and one dev-only console warning,
+ * which is easy to lose in a busy log. A consumer that generates icon names from data can assert
+ * against this list at build time instead of discovering the gap in production, which is how
+ * `credit-card` shipped as a blank square.
+ */
+export declare const ICON_NAMES: readonly string[];

package/dist/components/core/icon-map.d.ts

@@ -11,4 +11,13 @@
  *  point at one slug (`boxes` and `package` both mean `box`); the generator de-duplicates.
  */
 export declare const CARBON_MAP: Record<string, string>;
+/**
+ * Every name `Icon` can render, frozen and sorted.
+ *
+ * Exported because an unknown slug fails quietly — an empty box and one dev-only console warning,
+ * which is easy to lose in a busy log. A consumer that generates icon names from data can assert
+ * against this list at build time instead of discovering the gap in production, which is how
+ * `credit-card` shipped as a blank square.
+ */
+export declare const ICON_NAMES: readonly string[];
 //# sourceMappingURL=icon-map.d.ts.map

package/dist/components/core/icon-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icon-map.d.ts","sourceRoot":"","sources":["../../../src/components/core/icon-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiB7C,CAAC"}
+{"version":3,"file":"icon-map.d.ts","sourceRoot":"","sources":["../../../src/components/core/icon-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAuD7C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAAkD,CAAC"}

package/dist/components/forms/Input.d.cts

@@ -1,4 +1,4 @@
-import type * as React from 'react';
+import * as React from 'react';
 export interface InputProps {
     label?: React.ReactNode;
     value?: string;
@@ -16,6 +16,24 @@ export interface InputProps {
     icon?: string;
     /** Trailing static text: unit, currency, "of 40". */
     suffix?: React.ReactNode;
+    /**
+     * Adds a clear affordance once the field has a value.
+     *
+     * Use it on every search field. `type="search"` gets one from the browser for free, but only in
+     * Chrome and Safari, and it cannot be styled or sized — Pire hides that one so a search box does
+     * not look different per browser. This is the replacement, and it is a real button: focusable,
+     * labelled, and the same shape everywhere.
+     *
+     * Works controlled or uncontrolled.
+     */
+    isClearable?: boolean;
+    /**
+     * The clear button's visible text. Defaults to the dictionary's `inputClear`.
+     *
+     * Deliberately a word rather than an icon: an "x" beside a dialog's own close "x" reads as a
+     * second way to dismiss the dialog. Keep it short — it sits inside the field.
+     */
+    clearLabel?: string;
     /** Help text below the field. Replaced by errorMessage when invalid. */
     description?: React.ReactNode;
     errorMessage?: React.ReactNode;
@@ -35,4 +53,4 @@ export interface InputProps {
 }
 /** Single-line text entry. Labels, descriptions and errors are wired to the input by React Aria,
  *  so no manual aria-describedby is ever needed. */
-export declare function Input({ label, icon, suffix, description, errorMessage, size, numeric, fullWidth, className, style, inputRef, onChange, ...rest }: InputProps): React.JSX.Element;
+export declare function Input({ label, icon, suffix, description, errorMessage, size, numeric, isClearable, clearLabel, fullWidth, className, style, inputRef, onChange, ...rest }: InputProps): React.JSX.Element;

package/dist/components/forms/Input.d.ts

@@ -1,4 +1,4 @@
-import type * as React from 'react';
+import * as React from 'react';
 export interface InputProps {
     label?: React.ReactNode;
     value?: string;
@@ -16,6 +16,24 @@ export interface InputProps {
     icon?: string;
     /** Trailing static text: unit, currency, "of 40". */
     suffix?: React.ReactNode;
+    /**
+     * Adds a clear affordance once the field has a value.
+     *
+     * Use it on every search field. `type="search"` gets one from the browser for free, but only in
+     * Chrome and Safari, and it cannot be styled or sized — Pire hides that one so a search box does
+     * not look different per browser. This is the replacement, and it is a real button: focusable,
+     * labelled, and the same shape everywhere.
+     *
+     * Works controlled or uncontrolled.
+     */
+    isClearable?: boolean;
+    /**
+     * The clear button's visible text. Defaults to the dictionary's `inputClear`.
+     *
+     * Deliberately a word rather than an icon: an "x" beside a dialog's own close "x" reads as a
+     * second way to dismiss the dialog. Keep it short — it sits inside the field.
+     */
+    clearLabel?: string;
     /** Help text below the field. Replaced by errorMessage when invalid. */
     description?: React.ReactNode;
     errorMessage?: React.ReactNode;
@@ -35,5 +53,5 @@ export interface InputProps {
 }
 /** Single-line text entry. Labels, descriptions and errors are wired to the input by React Aria,
  *  so no manual aria-describedby is ever needed. */
-export declare function Input({ label, icon, suffix, description, errorMessage, size, numeric, fullWidth, className, style, inputRef, onChange, ...rest }: InputProps): React.JSX.Element;
+export declare function Input({ label, icon, suffix, description, errorMessage, size, numeric, isClearable, clearLabel, fullWidth, className, style, inputRef, onChange, ...rest }: InputProps): React.JSX.Element;
 //# sourceMappingURL=Input.d.ts.map

package/dist/components/forms/Input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../src/components/forms/Input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAKpC,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;IACpF,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,wEAAwE;IACxE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;CACxC;AAED;oDACoD;AACpD,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,IAAW,EAAE,OAAO,EAC1F,SAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,UAAU,qBAmB9E"}
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../src/components/forms/Input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;IACpF,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;CACxC;AAED;oDACoD;AACpD,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,IAAW,EAAE,OAAO,EAC1F,WAAW,EAAE,UAAU,EAAE,SAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,UAAU,qBAyCvG"}

package/dist/components/forms/ValueHelpField.d.cts

@@ -13,6 +13,17 @@ export interface ValueHelpFieldProps<T extends {
     rows?: T[];
     columns?: DataTableColumn<T>[];
     dialogTitle?: React.ReactNode;
+    /**
+     * Forwarded to {@link ValueHelpDialog}. Set `isFilteredExternally` and feed `rows` from
+     * `onSearch` when the list is too large to sit in the browser — which is the usual case for
+     * suppliers, customers and products.
+     */
+    onSearch?: (query: string) => void;
+    isFilteredExternally?: boolean;
+    isLoading?: boolean;
+    onLoadMore?: () => void;
+    /** Shown in the dialog when the search returns nothing. */
+    emptyLabel?: string;
     placeholder?: string;
     description?: React.ReactNode;
     errorMessage?: React.ReactNode;
@@ -28,4 +39,4 @@ export interface ValueHelpFieldProps<T extends {
  *  the value-help trigger. Pairs Input with ValueHelpDialog so screens stop rewiring both. */
 export declare function ValueHelpField<T extends {
     id: string | number;
-}>({ label, value, onChange, format, rows, columns, dialogTitle, placeholder, description, errorMessage, isInvalid, isDisabled, isRequired, allowsClear, className, style }: ValueHelpFieldProps<T>): React.JSX.Element;
+}>({ label, value, onChange, format, rows, columns, dialogTitle, onSearch, isFilteredExternally, isLoading, onLoadMore, emptyLabel, placeholder, description, errorMessage, isInvalid, isDisabled, isRequired, allowsClear, className, style }: ValueHelpFieldProps<T>): React.JSX.Element;

package/dist/components/forms/ValueHelpField.d.ts

@@ -13,6 +13,17 @@ export interface ValueHelpFieldProps<T extends {
     rows?: T[];
     columns?: DataTableColumn<T>[];
     dialogTitle?: React.ReactNode;
+    /**
+     * Forwarded to {@link ValueHelpDialog}. Set `isFilteredExternally` and feed `rows` from
+     * `onSearch` when the list is too large to sit in the browser — which is the usual case for
+     * suppliers, customers and products.
+     */
+    onSearch?: (query: string) => void;
+    isFilteredExternally?: boolean;
+    isLoading?: boolean;
+    onLoadMore?: () => void;
+    /** Shown in the dialog when the search returns nothing. */
+    emptyLabel?: string;
     placeholder?: string;
     description?: React.ReactNode;
     errorMessage?: React.ReactNode;
@@ -28,5 +39,5 @@ export interface ValueHelpFieldProps<T extends {
  *  the value-help trigger. Pairs Input with ValueHelpDialog so screens stop rewiring both. */
 export declare function ValueHelpField<T extends {
     id: string | number;
-}>({ label, value, onChange, format, rows, columns, dialogTitle, placeholder, description, errorMessage, isInvalid, isDisabled, isRequired, allowsClear, className, style }: ValueHelpFieldProps<T>): React.JSX.Element;
+}>({ label, value, onChange, format, rows, columns, dialogTitle, onSearch, isFilteredExternally, isLoading, onLoadMore, emptyLabel, placeholder, description, errorMessage, isInvalid, isDisabled, isRequired, allowsClear, className, style }: ValueHelpFieldProps<T>): React.JSX.Element;
 //# sourceMappingURL=ValueHelpField.d.ts.map

package/dist/components/forms/ValueHelpField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ValueHelpField.d.ts","sourceRoot":"","sources":["../../../src/components/forms/ValueHelpField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,GAAG;IAC1E,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,kCAAkC;IAClC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IACnC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IAC5B,yEAAyE;IACzE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACX,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAMD;8FAC8F;AAC9F,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAsB,EAChH,IAAS,EAAE,OAAY,EAAE,WAAW,EAAE,WAA4B,EAAE,WAAW,EAAE,YAAY,EAC7F,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,qBAsB3F"}
+{"version":3,"file":"ValueHelpField.d.ts","sourceRoot":"","sources":["../../../src/components/forms/ValueHelpField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,GAAG;IAC1E,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,kCAAkC;IAClC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IACnC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IAC5B,yEAAyE;IACzE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACX,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAMD;8FAC8F;AAC9F,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAsB,EAChH,IAAS,EAAE,OAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,EAAE,SAAS,EAAE,UAAU,EAC3F,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAClD,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,qBAiC3F"}

package/dist/components/navigation/Menu.d.cts

@@ -16,8 +16,13 @@ export interface MenuItemProps extends Omit<AriaMenuItemProps, 'className' | 'ch
     icon?: string;
     /** Second line, for an action whose effect is not obvious from its label. */
     description?: React.ReactNode;
-    /** Keyboard shortcut, right-aligned. Painted only — it registers nothing. */
-    shortcut?: string;
+    /**
+     * Keyboard shortcut, right-aligned and drawn as key caps. Painted only — it registers nothing.
+     *
+     * A string is split on `+` and spaces, so `"Ctrl+Shift+P"` renders as three caps. Pass an array
+     * when the split cannot be inferred: `['⌘', 'N']`, since `"⌘N"` has no separator to split on.
+     */
+    shortcut?: string | string[];
     /** `danger` for a destructive action. Put it last, behind a `MenuSeparator`. */
     tone?: 'default' | 'danger';
     className?: string;

package/dist/components/navigation/Menu.d.ts

@@ -16,8 +16,13 @@ export interface MenuItemProps extends Omit<AriaMenuItemProps, 'className' | 'ch
     icon?: string;
     /** Second line, for an action whose effect is not obvious from its label. */
     description?: React.ReactNode;
-    /** Keyboard shortcut, right-aligned. Painted only — it registers nothing. */
-    shortcut?: string;
+    /**
+     * Keyboard shortcut, right-aligned and drawn as key caps. Painted only — it registers nothing.
+     *
+     * A string is split on `+` and spaces, so `"Ctrl+Shift+P"` renders as three caps. Pass an array
+     * when the split cannot be inferred: `['⌘', 'N']`, since `"⌘N"` has no separator to split on.
+     */
+    shortcut?: string | string[];
     /** `danger` for a destructive action. Put it last, behind a `MenuSeparator`. */
     tone?: 'default' | 'danger';
     className?: string;

package/dist/components/navigation/Menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/Menu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,EAGL,KAAK,SAAS,IAAI,aAAa,EAAE,KAAK,aAAa,IAAI,iBAAiB,EACzE,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAClD,SAAQ,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IACrD,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED,yFAAyF;AACzF,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,qBAapG;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,UAAU,CAAC;IACtF,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAgB,EAAE,SAAS,EAAE,GAAG,IAAI,EAC5E,EAAE,aAAa,qBAef;AAGD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IACxF,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,qBAOpF;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,kBAAkB,qBAE9D"}
+{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/Menu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,EAGL,KAAK,SAAS,IAAI,aAAa,EAAE,KAAK,aAAa,IAAI,iBAAiB,EACzE,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAClD,SAAQ,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IACrD,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED,yFAAyF;AACzF,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,qBAapG;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,UAAU,CAAC;IACtF,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,gFAAgF;IAChF,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAgB,EAAE,SAAS,EAAE,GAAG,IAAI,EAC5E,EAAE,aAAa,qBAqBf;AAGD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IACxF,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,qBAOpF;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,kBAAkB,qBAE9D"}

package/dist/components/navigation/ShellBar.d.cts

@@ -19,6 +19,18 @@ export interface ShellBarProps extends Omit<React.HTMLAttributes<HTMLElement>, '
     actions?: React.ReactNode;
     /** Full name — initials render into the avatar. */
     user?: string;
+    /**
+     * Turns the avatar into a menu trigger. Pass a `Menu` — the entries are the product's, because
+     * they differ per app; only the trigger belongs here.
+     *
+     * Without it the avatar stays a plain `role="img"`, so nothing that renders a bare `user` today
+     * changes. With it the avatar becomes a real `<button>` carrying `aria-haspopup` and
+     * `aria-expanded`.
+     */
+    userMenu?: React.ReactNode;
+    /** Accessible name of the avatar button. `{user}` is replaced with the name. Defaults to the
+     *  dictionary's `shellBarUserMenu`, for the same reason as {@link ShellBarProps.menuLabel}. */
+    userMenuLabel?: string;
 }
 /** Fixed 48px application chrome. One per page, always the first landmark. */
-export declare function ShellBar({ product, monogram, title, onMenu, onSearch, menuLabel, searchLabel, actions, user, className, ...rest }: ShellBarProps): React.JSX.Element;
+export declare function ShellBar({ product, monogram, title, onMenu, onSearch, menuLabel, searchLabel, actions, user, userMenu, userMenuLabel, className, ...rest }: ShellBarProps): React.JSX.Element;

package/dist/components/navigation/ShellBar.d.ts

@@ -19,7 +19,19 @@ export interface ShellBarProps extends Omit<React.HTMLAttributes<HTMLElement>, '
     actions?: React.ReactNode;
     /** Full name — initials render into the avatar. */
     user?: string;
+    /**
+     * Turns the avatar into a menu trigger. Pass a `Menu` — the entries are the product's, because
+     * they differ per app; only the trigger belongs here.
+     *
+     * Without it the avatar stays a plain `role="img"`, so nothing that renders a bare `user` today
+     * changes. With it the avatar becomes a real `<button>` carrying `aria-haspopup` and
+     * `aria-expanded`.
+     */
+    userMenu?: React.ReactNode;
+    /** Accessible name of the avatar button. `{user}` is replaced with the name. Defaults to the
+     *  dictionary's `shellBarUserMenu`, for the same reason as {@link ShellBarProps.menuLabel}. */
+    userMenuLabel?: string;
 }
 /** Fixed 48px application chrome. One per page, always the first landmark. */
-export declare function ShellBar({ product, monogram, title, onMenu, onSearch, menuLabel, searchLabel, actions, user, className, ...rest }: ShellBarProps): React.JSX.Element;
+export declare function ShellBar({ product, monogram, title, onMenu, onSearch, menuLabel, searchLabel, actions, user, userMenu, userMenuLabel, className, ...rest }: ShellBarProps): React.JSX.Element;
 //# sourceMappingURL=ShellBar.d.ts.map

package/dist/components/navigation/ShellBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShellBar.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/ShellBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IACrF,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB;kGAC8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;oEAEgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAA6B,EAClG,WAAsB,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,aAAa,qBAa3E"}
+{"version":3,"file":"ShellBar.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/ShellBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAMpC,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IACrF,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB;kGAC8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;oEAEgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;mGAC+F;IAC/F,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAA6B,EAClG,WAAsB,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,aAAa,qBA2BpG"}

package/dist/components/patterns/CommandPalette.d.cts

@@ -0,0 +1,97 @@
+import * as React from 'react';
+export interface CommandPaletteItem {
+    /** Passed back to `onAction`. Must be unique across every group in the palette. */
+    id: string;
+    label: string;
+    /** Second line — what the command does, or what identifies the record. */
+    description?: string;
+    /** Icon slug, same vocabulary as `Button.icon`. */
+    icon?: string;
+    /**
+     * Painted on the right as key caps. Registers nothing; bind the key yourself.
+     *
+     * A string is split on `+` and spaces; pass an array when it cannot be — `['⌘', 'N']`.
+     */
+    shortcut?: string | string[];
+    /**
+     * Extra terms this item should match on, beyond its label. The place to put synonyms, the
+     * English name of a Spanish command, and the abbreviations people actually type — a palette
+     * that only matches the visible label makes users guess the wording.
+     *
+     * Matched against, never announced: the accessible name stays the label alone.
+     */
+    keywords?: string;
+    isDisabled?: boolean;
+}
+export interface CommandPaletteGroup {
+    id: string;
+    /** Heading above the group. Omit for a single unlabelled list. */
+    label?: string;
+    items: CommandPaletteItem[];
+}
+export interface CommandPaletteProps {
+    isOpen?: boolean;
+    onOpenChange?: (isOpen: boolean) => void;
+    /**
+     * Static groups — navigation targets and actions. Filtered locally as the user types, so these
+     * are the whole list, not a page of it.
+     */
+    groups?: CommandPaletteGroup[];
+    /**
+     * Server-backed results, appended after the static groups and **never filtered locally**: the
+     * server already ranked them, and a local "contains" pass would drop fuzzy and synonym matches.
+     * Feed it from `onSearch`.
+     */
+    resultsGroup?: CommandPaletteGroup;
+    /** The chosen item's `id`. The palette does not close itself — decide in the handler. */
+    onAction?: (id: string) => void;
+    /**
+     * The query on every keystroke. **Debounce before calling the server.**
+     *
+     * Only needed for `resultsGroup`; the static groups filter without it.
+     */
+    onSearch?: (query: string) => void;
+    /** Shows a status row rather than an empty list while a request is in flight. */
+    isLoading?: boolean;
+    /** Overrides the dictionary's `commandPaletteEmpty`. */
+    emptyLabel?: React.ReactNode;
+    /** Overrides the dictionary's `commandPaletteLoading`. */
+    loadingLabel?: string;
+    placeholder?: string;
+    /**
+     * Replaces the default key hints along the bottom. Use it for a product-specific affordance —
+     * a scope switch, a "search everything" toggle.
+     */
+    footer?: React.ReactNode;
+    /** Drops the footer entirely. The hints are worth their space until an app teaches the keys elsewhere. */
+    showFooter?: boolean;
+    /** Names the dialog for assistive tech. Defaults to the dictionary's `commandPaletteLabel`. */
+    'aria-label'?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Application-wide search over commands, navigation targets and records — the Cmd/Ctrl+K surface.
+ *
+ * Behaviour is React Aria's `Autocomplete`: focus stays in the input while the arrow keys move
+ * `aria-activedescendant` through the list, so typing and choosing never fight each other. Pire
+ * supplies the overlay, the grouping and the empty/loading states.
+ *
+ * Open state is always the product's. Bind the shortcut with {@link useCommandPaletteShortcut},
+ * or with anything else — an ERP may already own that key.
+ */
+export declare function CommandPalette({ isOpen, onOpenChange, groups, resultsGroup, onAction, onSearch, isLoading, emptyLabel, loadingLabel, placeholder, footer, showFooter, 'aria-label': ariaLabel, className, style, }: CommandPaletteProps): React.JSX.Element;
+export interface CommandPaletteShortcutOptions {
+    /** The key pressed with Cmd (macOS) or Ctrl. Single character, matched case-insensitively. */
+    key?: string;
+    /** Stop listening — while a modal owns the keyboard, for instance. */
+    isDisabled?: boolean;
+}
+/**
+ * Binds Cmd+K / Ctrl+K to open the palette.
+ *
+ * Opt-in rather than built into {@link CommandPalette}, because a global key listener is the
+ * component's to grant and the app's to own: an ERP may already bind that combination, and a
+ * component that claims it on mount takes it silently.
+ */
+export declare function useCommandPaletteShortcut(onTrigger: () => void, { key, isDisabled }?: CommandPaletteShortcutOptions): void;

package/dist/components/patterns/CommandPalette.d.ts

@@ -0,0 +1,98 @@
+import * as React from 'react';
+export interface CommandPaletteItem {
+    /** Passed back to `onAction`. Must be unique across every group in the palette. */
+    id: string;
+    label: string;
+    /** Second line — what the command does, or what identifies the record. */
+    description?: string;
+    /** Icon slug, same vocabulary as `Button.icon`. */
+    icon?: string;
+    /**
+     * Painted on the right as key caps. Registers nothing; bind the key yourself.
+     *
+     * A string is split on `+` and spaces; pass an array when it cannot be — `['⌘', 'N']`.
+     */
+    shortcut?: string | string[];
+    /**
+     * Extra terms this item should match on, beyond its label. The place to put synonyms, the
+     * English name of a Spanish command, and the abbreviations people actually type — a palette
+     * that only matches the visible label makes users guess the wording.
+     *
+     * Matched against, never announced: the accessible name stays the label alone.
+     */
+    keywords?: string;
+    isDisabled?: boolean;
+}
+export interface CommandPaletteGroup {
+    id: string;
+    /** Heading above the group. Omit for a single unlabelled list. */
+    label?: string;
+    items: CommandPaletteItem[];
+}
+export interface CommandPaletteProps {
+    isOpen?: boolean;
+    onOpenChange?: (isOpen: boolean) => void;
+    /**
+     * Static groups — navigation targets and actions. Filtered locally as the user types, so these
+     * are the whole list, not a page of it.
+     */
+    groups?: CommandPaletteGroup[];
+    /**
+     * Server-backed results, appended after the static groups and **never filtered locally**: the
+     * server already ranked them, and a local "contains" pass would drop fuzzy and synonym matches.
+     * Feed it from `onSearch`.
+     */
+    resultsGroup?: CommandPaletteGroup;
+    /** The chosen item's `id`. The palette does not close itself — decide in the handler. */
+    onAction?: (id: string) => void;
+    /**
+     * The query on every keystroke. **Debounce before calling the server.**
+     *
+     * Only needed for `resultsGroup`; the static groups filter without it.
+     */
+    onSearch?: (query: string) => void;
+    /** Shows a status row rather than an empty list while a request is in flight. */
+    isLoading?: boolean;
+    /** Overrides the dictionary's `commandPaletteEmpty`. */
+    emptyLabel?: React.ReactNode;
+    /** Overrides the dictionary's `commandPaletteLoading`. */
+    loadingLabel?: string;
+    placeholder?: string;
+    /**
+     * Replaces the default key hints along the bottom. Use it for a product-specific affordance —
+     * a scope switch, a "search everything" toggle.
+     */
+    footer?: React.ReactNode;
+    /** Drops the footer entirely. The hints are worth their space until an app teaches the keys elsewhere. */
+    showFooter?: boolean;
+    /** Names the dialog for assistive tech. Defaults to the dictionary's `commandPaletteLabel`. */
+    'aria-label'?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Application-wide search over commands, navigation targets and records — the Cmd/Ctrl+K surface.
+ *
+ * Behaviour is React Aria's `Autocomplete`: focus stays in the input while the arrow keys move
+ * `aria-activedescendant` through the list, so typing and choosing never fight each other. Pire
+ * supplies the overlay, the grouping and the empty/loading states.
+ *
+ * Open state is always the product's. Bind the shortcut with {@link useCommandPaletteShortcut},
+ * or with anything else — an ERP may already own that key.
+ */
+export declare function CommandPalette({ isOpen, onOpenChange, groups, resultsGroup, onAction, onSearch, isLoading, emptyLabel, loadingLabel, placeholder, footer, showFooter, 'aria-label': ariaLabel, className, style, }: CommandPaletteProps): React.JSX.Element;
+export interface CommandPaletteShortcutOptions {
+    /** The key pressed with Cmd (macOS) or Ctrl. Single character, matched case-insensitively. */
+    key?: string;
+    /** Stop listening — while a modal owns the keyboard, for instance. */
+    isDisabled?: boolean;
+}
+/**
+ * Binds Cmd+K / Ctrl+K to open the palette.
+ *
+ * Opt-in rather than built into {@link CommandPalette}, because a global key listener is the
+ * component's to grant and the app's to own: an ERP may already bind that combination, and a
+ * component that claims it on mount takes it silently.
+ */
+export declare function useCommandPaletteShortcut(onTrigger: () => void, { key, isDisabled }?: CommandPaletteShortcutOptions): void;
+//# sourceMappingURL=CommandPalette.d.ts.map

package/dist/components/patterns/CommandPalette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandPalette.d.ts","sourceRoot":"","sources":["../../../src/components/patterns/CommandPalette.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC;;;OAGG;IACH,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,0GAA0G;IAC1G,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+FAA+F;IAC/F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAiBD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,YAAY,EAAE,MAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAC9E,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,UAAiB,EAChE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,GAC1C,EAAE,mBAAmB,qBAsFrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,8FAA8F;IAC9F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,IAAI,EAAE,EAAE,GAAS,EAAE,UAAU,EAAE,GAAE,6BAAkC,GACnF,IAAI,CAiBN"}

package/dist/components/patterns/ValueHelpDialog.d.cts

@@ -10,6 +10,27 @@ export interface ValueHelpDialogProps<T extends {
     rows?: T[];
     searchPlaceholder?: string;
     emptyLabel?: string;
+    /**
+     * The query on every keystroke. **Debounce before calling the server.**
+     *
+     * On its own this only observes; it does not change how `rows` is treated. Pair it with
+     * `isFilteredExternally` to actually hand filtering to the server.
+     */
+    onSearch?: (query: string) => void;
+    /**
+     * `rows` is the final list and the dialog filters nothing locally. Required for server search:
+     * fuzzy matches, synonyms, code-to-description and server ranking do not survive a local
+     * "contains" pass over the fields that happen to be in the row.
+     *
+     * Named to match `ComboBox`, deliberately. The same idea under two names is worse than either
+     * name — the ERP's supplier, customer, product and purchase-order pickers all need this, and
+     * they already know the ComboBox spelling.
+     */
+    isFilteredExternally?: boolean;
+    /** Keeps the table's skeleton up instead of showing "no records" while a request is in flight. */
+    isLoading?: boolean;
+    /** Called when the table is scrolled near its end, for paginated results. */
+    onLoadMore?: () => void;
     /** Receives the picked row. */
     onSelect?: (row: T) => void;
     onClose?: () => void;
@@ -17,4 +38,4 @@ export interface ValueHelpDialogProps<T extends {
 /** The ERP value help: search a master-data list and pick one record back into a field. */
 export declare function ValueHelpDialog<T extends {
     id: string | number;
-}>({ isOpen, title, columns, rows, searchPlaceholder, emptyLabel, onSelect, onClose }: ValueHelpDialogProps<T>): React.JSX.Element;
+}>({ isOpen, title, columns, rows, searchPlaceholder, emptyLabel, onSearch, isFilteredExternally, isLoading, onLoadMore, onSelect, onClose }: ValueHelpDialogProps<T>): React.JSX.Element;

package/dist/components/patterns/ValueHelpDialog.d.ts

@@ -10,6 +10,27 @@ export interface ValueHelpDialogProps<T extends {
     rows?: T[];
     searchPlaceholder?: string;
     emptyLabel?: string;
+    /**
+     * The query on every keystroke. **Debounce before calling the server.**
+     *
+     * On its own this only observes; it does not change how `rows` is treated. Pair it with
+     * `isFilteredExternally` to actually hand filtering to the server.
+     */
+    onSearch?: (query: string) => void;
+    /**
+     * `rows` is the final list and the dialog filters nothing locally. Required for server search:
+     * fuzzy matches, synonyms, code-to-description and server ranking do not survive a local
+     * "contains" pass over the fields that happen to be in the row.
+     *
+     * Named to match `ComboBox`, deliberately. The same idea under two names is worse than either
+     * name — the ERP's supplier, customer, product and purchase-order pickers all need this, and
+     * they already know the ComboBox spelling.
+     */
+    isFilteredExternally?: boolean;
+    /** Keeps the table's skeleton up instead of showing "no records" while a request is in flight. */
+    isLoading?: boolean;
+    /** Called when the table is scrolled near its end, for paginated results. */
+    onLoadMore?: () => void;
     /** Receives the picked row. */
     onSelect?: (row: T) => void;
     onClose?: () => void;
@@ -17,5 +38,5 @@ export interface ValueHelpDialogProps<T extends {
 /** The ERP value help: search a master-data list and pick one record back into a field. */
 export declare function ValueHelpDialog<T extends {
     id: string | number;
-}>({ isOpen, title, columns, rows, searchPlaceholder, emptyLabel, onSelect, onClose }: ValueHelpDialogProps<T>): React.JSX.Element;
+}>({ isOpen, title, columns, rows, searchPlaceholder, emptyLabel, onSearch, isFilteredExternally, isLoading, onLoadMore, onSelect, onClose }: ValueHelpDialogProps<T>): React.JSX.Element;
 //# sourceMappingURL=ValueHelpDialog.d.ts.map

package/dist/components/patterns/ValueHelpDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ValueHelpDialog.d.ts","sourceRoot":"","sources":["../../../src/components/patterns/ValueHelpDialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpE,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,GAAG;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,sDAAsD;IACtD,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAAE,EAAE,MAAM,EAAE,KAAyB,EACpG,OAAY,EAAE,IAAS,EAAE,iBAA0C,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,qBAqB9H"}
+{"version":3,"file":"ValueHelpDialog.d.ts","sourceRoot":"","sources":["../../../src/components/patterns/ValueHelpDialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpE,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,GAAG;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,sDAAsD;IACtD,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,kGAAkG;IAClG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAChF,OAAY,EAAE,IAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,oBAAoB,EACtF,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,qBAmCpE"}