@orianatech/pire 0.13.0 → 0.15.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/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,qBAkCpE"}

package/dist/components.css

@@ -195,6 +195,13 @@
 .pire-shellbar-title{font:var(--type-body-strong)}
 .pire-shellbar-spacer{flex:1}
 .pire-avatar{display:inline-flex;align-items:center;justify-content:center;width:28px;height:28px;border-radius:var(--radius-pill);background:var(--blue-60);color:var(--text-inverse);font:var(--type-label)}
+/* The avatar as a real button, once ShellBar is given a userMenu. Resets the UA button styling the
+   span never carried, and adds what a span cannot: a pointer, interaction states, and a focus ring
+   that reads against the dark shell instead of against the page. */
+.pire-avatar-trigger{border:0;padding:0;cursor:pointer;transition:var(--transition-control)}
+.pire-avatar-trigger[data-hovered]{background:var(--blue-50)}
+.pire-avatar-trigger[data-pressed]{background:var(--blue-70)}
+.pire-avatar-trigger[data-focus-visible]{outline:var(--focus-w) solid var(--text-inverse);outline-offset:2px}
 .pire-sidenav{display:flex;flex-direction:column;width:var(--sidenav-w);flex:0 0 auto;background:var(--surface-nav);border-right:1px solid var(--border-subtle);overflow:auto}
 .pire-sidenav[data-collapsed="true"]{width:var(--sidenav-w-collapsed)}
 .pire-sidenav-group{padding:var(--sp-3) 0}
@@ -504,7 +511,9 @@
 .pire-menu-item-label{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .pire-menu-item-desc{font:var(--type-caption);color:var(--text-secondary)}
 .pire-menu-item[data-disabled] .pire-menu-item-desc{color:var(--text-disabled)}
-.pire-menu-item-shortcut{flex:0 0 auto;align-self:center;font:var(--type-code);color:var(--text-tertiary)}
+/* A row of Kbd caps rather than a run of mono text, so a shortcut is drawn the same way
+   everywhere — including beside the command palette's key hints, in the same panel. */
+.pire-menu-item-shortcut{flex:0 0 auto;align-self:center;display:flex;align-items:center;gap:2px}
 .pire-menu-section-title{display:block;padding:var(--sp-1) var(--sp-3);font:var(--type-label);letter-spacing:var(--ls-caps);text-transform:uppercase;color:var(--text-secondary)}
 .pire-menu-separator{border:0;border-top:var(--border-w-hairline) solid var(--border-subtle);margin:var(--sp-1) 0}
 
@@ -665,8 +674,73 @@
 .pire-chart-table th,.pire-chart-table td{padding:var(--sp-1) var(--sp-2);border-block-end:1px solid var(--border-subtle);text-align:left;color:var(--text-primary)}
 .pire-chart-table td{font-variant-numeric:tabular-nums}
 
+/* ---- ValueHelpField ------------------------------------------------------ */
+/* The triggers sit inside .pire-control, flush with its trailing edge. `stretch` makes them the
+   control's full height whatever the size, and the negative margins cancel the control's own
+   padding and gap so there is no seam between the input and the first button. */
+.pire-valuehelp-actions{display:flex;align-items:stretch;align-self:stretch;margin-inline-start:calc(var(--sp-2) * -1);margin-inline-end:calc(var(--control-pad-x) * -1)}
+.pire-valuehelp-actions .pire-iconbtn{height:auto;border-radius:0;border-inline-start:1px solid var(--border-field)}
+/* Only the last button rounds, so the group follows the control's own corner instead of cutting it. */
+.pire-valuehelp-actions .pire-iconbtn:last-child{border-start-end-radius:var(--radius-1);border-end-end-radius:var(--radius-1)}
+/* `.pire-control :focus-visible` clears inner rings so the whole control shows one. That is right
+   with a single input, but here two buttons share the control and the outer ring cannot say which
+   is focused — so each gets its own, drawn inside its own box. */
+.pire-valuehelp-actions .pire-iconbtn[data-focus-visible]{outline:var(--focus-w) solid var(--focus-color);outline-offset:calc(var(--focus-w) * -1)}
+
+/* ---- Icon --------------------------------------------------------------- */
+/* Development-only marker for a name that resolved to no glyph. Rendered by Icon in dev builds
+   only, so it never reaches a user; it exists so a typo is visible on the page rather than only in
+   a console warning. Sized from the host span, so the box a typo leaves stays the icon's size. */
+.pire-icon-missing{display:block;width:100%;height:100%;box-sizing:border-box;border:1px dashed var(--status-negative-fg);border-radius:2px}
+
+/* ---- Kbd ---------------------------------------------------------------- */
+/* min-width equals the height, so a single character is a square cap and a word like "esc" grows
+   sideways from it rather than every cap being sized for the longest one. */
+.pire-kbd{display:inline-flex;align-items:center;justify-content:center;min-width:20px;height:20px;padding:0 var(--sp-1);border:1px solid var(--border-default);border-radius:var(--radius-1);background:var(--surface-card);font:var(--type-code);color:var(--text-secondary);white-space:nowrap}
+.pire-kbd[data-size="sm"]{min-width:16px;height:16px;font-size:11px}
+/* Lives here rather than in the Menu section so it follows the base rule it refines. A disabled
+   row must fade its caps too, or the shortcut is the one part of the row still looking live on a
+   command the user cannot run. */
+.pire-menu-item[data-disabled] .pire-kbd{color:var(--text-disabled);border-color:var(--border-subtle)}
+
+/* ---- CommandPalette ----------------------------------------------------- */
+/* Anchored near the top rather than centred: the list grows downwards as it fills, and a centred
+   palette would shift its own input under the caret while the user is still typing. */
+.pire-cp-overlay{position:fixed;inset:0;z-index:950;display:flex;align-items:flex-start;justify-content:center;padding:var(--sp-6);padding-block-start:12vh;background:var(--surface-overlay);animation:pire-fade-in var(--dur-fast) var(--ease-entrance)}
+.pire-cp-modal{display:flex;flex-direction:column;width:min(640px,100%);max-height:min(60vh,480px);background:var(--surface-raised);border-radius:var(--radius-2);box-shadow:var(--shadow-3);animation:pire-dialog-in var(--dur-base) var(--ease-entrance);outline:none;overflow:hidden}
+.pire-cp-dialog{display:flex;flex-direction:column;min-height:0;outline:none}
+.pire-cp-search{display:flex;align-items:center;gap:var(--sp-2);padding:0 var(--sp-4);border-block-end:1px solid var(--border-subtle);flex:0 0 auto}
+.pire-cp-search-icon{flex:0 0 auto;color:var(--text-tertiary)}
+/* Borderless by design: the modal edge is the field's boundary, and a second border inside it
+   would read as a control within a control. */
+.pire-cp-input{flex:1;min-width:0;height:var(--control-h-lg);border:0;background:transparent;font:var(--type-h4);color:var(--text-primary)}
+/* No ring here, deliberately overriding base.css's global input outline. The palette takes the
+   caret on open, and the input is the only focusable thing in it — the list is navigated by
+   virtual focus, which never moves real focus off the input. So focus cannot be anywhere else
+   while this is on screen, the caret is the indicator, and a ring around a full-width borderless
+   field reads as a stray box rather than as focus. This reasoning does not transfer: on any field
+   sitting among other controls, the ring is what says which one is live. */
+.pire-cp-input:focus-visible{outline:none}
+.pire-cp-input::placeholder{font:var(--type-body);color:var(--text-tertiary)}
+/* React Aria's SearchField renders type="search", which Chrome decorates with its own clear
+   affordance. It cannot be styled, does not exist in Firefox, and ignores every token here, so a
+   design system is better off without it. Escape closes the palette. */
+.pire-cp-input::-webkit-search-cancel-button{display:none}
+.pire-cp-list{flex:1;min-height:0;overflow:auto;padding:var(--sp-1) 0;outline:none;display:flex;flex-direction:column}
+/* Explicitly a column: the section is a flex child of .pire-cp-list, and leaving it as a block
+   makes its rows depend on the default layout of whatever React Aria renders for a section. */
+.pire-cp-section{display:flex;flex-direction:column}
+.pire-cp-section-title{display:block;padding:var(--sp-1) var(--sp-4);font:var(--type-label);letter-spacing:var(--ls-caps);text-transform:uppercase;color:var(--text-secondary)}
+/* The rows are Menu's, so they inherit its focus, tone and disabled treatment; only the gutter
+   widens to match the palette's larger input. */
+.pire-cp-list .pire-menu-item{padding-inline:var(--sp-4)}
+.pire-cp-status{padding:var(--sp-4);text-align:center;font:var(--type-body);color:var(--text-secondary)}
+.pire-cp-foot{flex:0 0 auto;display:flex;align-items:center;gap:var(--sp-4);padding:var(--sp-2) var(--sp-4);border-block-start:1px solid var(--border-subtle);background:var(--surface-sunken)}
+.pire-cp-hint{display:flex;align-items:center;gap:var(--sp-1);font:var(--type-caption);color:var(--text-secondary)}
+.pire-cp-loading{padding:var(--sp-1) var(--sp-4);font:var(--type-caption);color:var(--text-secondary);border-block-end:1px solid var(--border-subtle)}
+
 /* ---- Reduced motion --------------------------------------------------- */
-@media (prefers-reduced-motion: reduce){.pire-modal,.pire-toast,.pire-popover,.pire-tooltip,.pire-sidepanel{animation:none}
+@media (prefers-reduced-motion: reduce){.pire-modal,.pire-toast,.pire-popover,.pire-tooltip,.pire-sidepanel,.pire-cp-overlay,.pire-cp-modal{animation:none}
 /* The skeleton also drops its background sweep, not just the animation: an infinite shimmer is
    exactly the "large, repeated motion" the preference is asking us to stop, and the placeholder
    still reads from its shape and surface contrast alone. */