@orianatech/pire 0.7.0 → 0.9.0

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

@@ -11,20 +11,39 @@ export interface ComboBoxProps {
     defaultValue?: string;
     onChange?: (value: string | null) => void;
     /**
-     * Free-text as typed, on every keystroke.
+     * Free-text as typed, on every keystroke. Debounce it before calling the server.
      *
-     * Server-side search is only partly supported. `options` is passed to React Aria as
-     * `defaultItems`, so React Aria applies its own local "contains" filter on top of
-     * whatever you supply: any result whose `label` does not literally contain the typed
-     * text is hidden client-side, and when the local filter matches nothing the menu
-     * closes. Fuzzy, synonym, code-to-description and server-ranked matches are therefore
-     * dropped. Use this to observe input (analytics, a debounced prefetch, mirroring the
-     * text elsewhere), or for server search only where the returned labels are guaranteed
-     * to contain the query as a substring. For true server-driven search with no local
-     * filtering, use ValueHelpField.
+     * Without `isFilteredExternally`, React Aria also applies its own local "contains" filter,
+     * so a result whose label does not literally contain the typed text is hidden client-side.
      */
     onInputChange?: (text: string) => void;
     options?: Array<string | ComboBoxOption>;
+    /**
+     * `options` is the final list and React Aria filters nothing locally. Required for server
+     * search: fuzzy matches, synonyms, code-to-description and server ranking do not survive a
+     * local "contains" pass.
+     *
+     * Turns `options` into a controlled collection, so the popover reflects exactly what you
+     * pass — including an empty list, which is why `isLoading` and `emptyLabel` exist.
+     */
+    isFilteredExternally?: boolean;
+    /**
+     * Shows a loading row instead of closing the popover. Without it a 300ms debounce reads as
+     * a menu that flickers open and shut.
+     *
+     * Also blocks selection while it is set: confirming here would commit an item from the
+     * previous response.
+     */
+    isLoading?: boolean;
+    /** Overrides the dictionary's `comboBoxLoading`. */
+    loadingLabel?: string;
+    /**
+     * Shown when the server answered with nothing. Without it the popover closes and the user
+     * cannot tell a bad query from a slow one.
+     */
+    emptyLabel?: React.ReactNode;
+    /** Called when the list is scrolled near its end, for paginated results. */
+    onLoadMore?: () => void;
     placeholder?: string;
     description?: React.ReactNode;
     errorMessage?: React.ReactNode;
@@ -42,4 +61,4 @@ export interface ComboBoxProps {
 }
 /** Type-ahead picker for lists too long to scroll — material, cost centre, G/L account.
  *  Below ~10 fixed options use Select; for master-data search with several columns use ValueHelpField. */
-export declare function ComboBox({ label, value, defaultValue, onChange, onInputChange, options, description, errorMessage, size, fullWidth, className, style, ...rest }: ComboBoxProps): React.JSX.Element;
+export declare function ComboBox({ label, value, defaultValue, onChange, onInputChange, options, description, errorMessage, size, fullWidth, isFilteredExternally, isLoading, loadingLabel, emptyLabel, onLoadMore, className, style, ...rest }: ComboBoxProps): React.JSX.Element;

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

@@ -11,20 +11,39 @@ export interface ComboBoxProps {
     defaultValue?: string;
     onChange?: (value: string | null) => void;
     /**
-     * Free-text as typed, on every keystroke.
+     * Free-text as typed, on every keystroke. Debounce it before calling the server.
      *
-     * Server-side search is only partly supported. `options` is passed to React Aria as
-     * `defaultItems`, so React Aria applies its own local "contains" filter on top of
-     * whatever you supply: any result whose `label` does not literally contain the typed
-     * text is hidden client-side, and when the local filter matches nothing the menu
-     * closes. Fuzzy, synonym, code-to-description and server-ranked matches are therefore
-     * dropped. Use this to observe input (analytics, a debounced prefetch, mirroring the
-     * text elsewhere), or for server search only where the returned labels are guaranteed
-     * to contain the query as a substring. For true server-driven search with no local
-     * filtering, use ValueHelpField.
+     * Without `isFilteredExternally`, React Aria also applies its own local "contains" filter,
+     * so a result whose label does not literally contain the typed text is hidden client-side.
      */
     onInputChange?: (text: string) => void;
     options?: Array<string | ComboBoxOption>;
+    /**
+     * `options` is the final list and React Aria filters nothing locally. Required for server
+     * search: fuzzy matches, synonyms, code-to-description and server ranking do not survive a
+     * local "contains" pass.
+     *
+     * Turns `options` into a controlled collection, so the popover reflects exactly what you
+     * pass — including an empty list, which is why `isLoading` and `emptyLabel` exist.
+     */
+    isFilteredExternally?: boolean;
+    /**
+     * Shows a loading row instead of closing the popover. Without it a 300ms debounce reads as
+     * a menu that flickers open and shut.
+     *
+     * Also blocks selection while it is set: confirming here would commit an item from the
+     * previous response.
+     */
+    isLoading?: boolean;
+    /** Overrides the dictionary's `comboBoxLoading`. */
+    loadingLabel?: string;
+    /**
+     * Shown when the server answered with nothing. Without it the popover closes and the user
+     * cannot tell a bad query from a slow one.
+     */
+    emptyLabel?: React.ReactNode;
+    /** Called when the list is scrolled near its end, for paginated results. */
+    onLoadMore?: () => void;
     placeholder?: string;
     description?: React.ReactNode;
     errorMessage?: React.ReactNode;
@@ -42,5 +61,5 @@ export interface ComboBoxProps {
 }
 /** Type-ahead picker for lists too long to scroll — material, cost centre, G/L account.
  *  Below ~10 fixed options use Select; for master-data search with several columns use ValueHelpField. */
-export declare function ComboBox({ label, value, defaultValue, onChange, onInputChange, options, description, errorMessage, size, fullWidth, className, style, ...rest }: ComboBoxProps): React.JSX.Element;
+export declare function ComboBox({ label, value, defaultValue, onChange, onInputChange, options, description, errorMessage, size, fullWidth, isFilteredExternally, isLoading, loadingLabel, emptyLabel, onLoadMore, className, style, ...rest }: ComboBoxProps): React.JSX.Element;
 //# sourceMappingURL=ComboBox.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ComboBox.d.ts","sourceRoot":"","sources":["../../../src/components/forms/ComboBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAOpC,MAAM,WAAW,cAAc;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE;AAE1G,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IACzC,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,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4GAA4G;IAC5G,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAKD;0GAC0G;AAC1G,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAY,EAC1F,WAAW,EAAE,YAAY,EAAE,IAAW,EAAE,SAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,aAAa,qBAkCrG"}
+{"version":3,"file":"ComboBox.d.ts","sourceRoot":"","sources":["../../../src/components/forms/ComboBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAOpC,MAAM,WAAW,cAAc;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE;AAE1G,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IACzC;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,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,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4GAA4G;IAC5G,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAKD;0GAC0G;AAC1G,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAY,EAC1F,WAAW,EAAE,YAAY,EAAE,IAAW,EAAE,SAAgB,EAAE,oBAAoB,EAAE,SAAS,EACzF,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,aAAa,qBAiEjF"}

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

@@ -0,0 +1,57 @@
+import * as React from 'react';
+export interface PireFile {
+    /** The browser's `File`. Pire uploads nothing — that is the app's job. */
+    file: File;
+    /** Object URL, only for images with `showPreview`. Revoked on unmount. */
+    previewUrl?: string;
+}
+export interface FileRejection {
+    file: File;
+    reason: 'size' | 'type';
+}
+export interface FileUploadProps {
+    label?: React.ReactNode;
+    /** Controlled / uncontrolled, the same pair as `Tabs` and `MultiComboBox`. */
+    value?: PireFile[];
+    defaultValue?: PireFile[];
+    onChange?: (files: PireFile[]) => void;
+    /** Mime types or extensions, exactly as `FileTrigger.acceptedFileTypes` takes them. */
+    acceptedFileTypes?: readonly string[];
+    allowsMultiple?: boolean;
+    /** Ceiling in bytes. Oversized files are rejected and reported, never held. */
+    maxSize?: number;
+    /** Rejections, so the app can word its own message. */
+    onError?: (rejections: FileRejection[]) => void;
+    /** Thumbnail for images. Turn it off for CSVs, where a thumbnail says nothing. */
+    showPreview?: boolean;
+    /** Upload progress 0–100, while the app is doing the uploading. */
+    uploadProgress?: number;
+    /** Overrides the dictionary's `fileUploadChoose`. */
+    chooseLabel?: string;
+    description?: React.ReactNode;
+    errorMessage?: React.ReactNode;
+    isInvalid?: boolean;
+    isDisabled?: boolean;
+    isRequired?: boolean;
+    isReadOnly?: boolean;
+    fullWidth?: boolean;
+    name?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/** Human-readable size. Deliberately not localised digits: `toLocaleString` on the number only. */
+export declare function formatFileSize(bytes: number): string;
+/** Splits a picked list into keepers and rejections, without uploading or mutating anything. */
+export declare function screenFiles(files: File[], { maxSize, acceptedFileTypes }: {
+    maxSize?: number;
+    acceptedFileTypes?: readonly string[];
+}): {
+    accepted: File[];
+    rejected: FileRejection[];
+};
+/**
+ * File picker with a list of what was chosen. Pire hands back `File`s through `onChange` and
+ * uploads nothing: the app owns the `FormData`, the request and the progress it reports back
+ * through `uploadProgress`.
+ */
+export declare function FileUpload({ label, value, defaultValue, onChange, acceptedFileTypes, allowsMultiple, maxSize, onError, showPreview, uploadProgress, chooseLabel, description, errorMessage, isInvalid, isDisabled, isReadOnly, isRequired, fullWidth, className, style, }: FileUploadProps): React.JSX.Element;

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

@@ -0,0 +1,58 @@
+import * as React from 'react';
+export interface PireFile {
+    /** The browser's `File`. Pire uploads nothing — that is the app's job. */
+    file: File;
+    /** Object URL, only for images with `showPreview`. Revoked on unmount. */
+    previewUrl?: string;
+}
+export interface FileRejection {
+    file: File;
+    reason: 'size' | 'type';
+}
+export interface FileUploadProps {
+    label?: React.ReactNode;
+    /** Controlled / uncontrolled, the same pair as `Tabs` and `MultiComboBox`. */
+    value?: PireFile[];
+    defaultValue?: PireFile[];
+    onChange?: (files: PireFile[]) => void;
+    /** Mime types or extensions, exactly as `FileTrigger.acceptedFileTypes` takes them. */
+    acceptedFileTypes?: readonly string[];
+    allowsMultiple?: boolean;
+    /** Ceiling in bytes. Oversized files are rejected and reported, never held. */
+    maxSize?: number;
+    /** Rejections, so the app can word its own message. */
+    onError?: (rejections: FileRejection[]) => void;
+    /** Thumbnail for images. Turn it off for CSVs, where a thumbnail says nothing. */
+    showPreview?: boolean;
+    /** Upload progress 0–100, while the app is doing the uploading. */
+    uploadProgress?: number;
+    /** Overrides the dictionary's `fileUploadChoose`. */
+    chooseLabel?: string;
+    description?: React.ReactNode;
+    errorMessage?: React.ReactNode;
+    isInvalid?: boolean;
+    isDisabled?: boolean;
+    isRequired?: boolean;
+    isReadOnly?: boolean;
+    fullWidth?: boolean;
+    name?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/** Human-readable size. Deliberately not localised digits: `toLocaleString` on the number only. */
+export declare function formatFileSize(bytes: number): string;
+/** Splits a picked list into keepers and rejections, without uploading or mutating anything. */
+export declare function screenFiles(files: File[], { maxSize, acceptedFileTypes }: {
+    maxSize?: number;
+    acceptedFileTypes?: readonly string[];
+}): {
+    accepted: File[];
+    rejected: FileRejection[];
+};
+/**
+ * File picker with a list of what was chosen. Pire hands back `File`s through `onChange` and
+ * uploads nothing: the app owns the `FormData`, the request and the progress it reports back
+ * through `uploadProgress`.
+ */
+export declare function FileUpload({ label, value, defaultValue, onChange, acceptedFileTypes, allowsMultiple, maxSize, onError, showPreview, uploadProgress, chooseLabel, description, errorMessage, isInvalid, isDisabled, isReadOnly, isRequired, fullWidth, className, style, }: FileUploadProps): React.JSX.Element;
+//# sourceMappingURL=FileUpload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileUpload.d.ts","sourceRoot":"","sources":["../../../src/components/forms/FileUpload.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,MAAM,WAAW,QAAQ;IACvB,0EAA0E;IAC1E,IAAI,EAAE,IAAI,CAAC;IACX,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACvC,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IAChD,kFAAkF;IAClF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,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,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAID,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CACzB,KAAK,EAAE,IAAI,EAAE,EACb,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC1F;IAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAwBjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EACzF,WAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAC1E,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAgB,EAAE,SAAS,EAAE,KAAK,GAClF,EAAE,eAAe,qBA2EjB"}

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

@@ -7,18 +7,27 @@ export interface MultiComboBoxProps {
     defaultValue?: string[];
     onChange?: (values: string[]) => void;
     /**
-     * Free-text as typed, on every keystroke.
+     * Free-text as typed, on every keystroke. Debounce it before calling the server.
      *
-     * Server-side search is only partly supported, exactly as on ComboBox. `options` is passed
-     * to React Aria as `defaultItems`, so React Aria applies its own local "contains" filter on
-     * top of whatever you supply: any result whose `label` does not literally contain the typed
-     * text is hidden client-side, and when the local filter matches nothing the menu closes.
-     * Fuzzy, synonym, code-to-description and server-ranked matches are therefore dropped. Use
-     * this to observe input (analytics, a debounced prefetch), or for server search only where
-     * the returned labels are guaranteed to contain the query as a substring.
+     * Without `isFilteredExternally`, React Aria also applies its own local "contains" filter,
+     * so a result whose label does not literally contain the typed text is hidden client-side.
      */
     onInputChange?: (text: string) => void;
     options?: Array<string | ComboBoxOption>;
+    /**
+     * `options` is the final list and React Aria filters nothing locally. Same meaning and same
+     * name as on `ComboBox`. Required for server search, where fuzzy matches, synonyms and
+     * server ranking do not survive a local "contains" pass.
+     */
+    isFilteredExternally?: boolean;
+    /** Shows a loading row instead of closing the popover, and blocks selection while set. */
+    isLoading?: boolean;
+    /** Overrides the dictionary's `comboBoxLoading`. */
+    loadingLabel?: string;
+    /** Shown when the server answered with nothing, so a bad query reads differently from a slow one. */
+    emptyLabel?: React.ReactNode;
+    /** Called when the list is scrolled near its end, for paginated results. */
+    onLoadMore?: () => void;
     placeholder?: string;
     description?: React.ReactNode;
     errorMessage?: React.ReactNode;
@@ -55,4 +64,4 @@ export interface MultiComboBoxProps {
  *    component nested inside it — a TagGroup there registers its tags as listbox items and then
  *    crashes looking for grid state. Each chip's remove button is an ordinary Tab stop instead,
  *    and removals are announced through the live region below. */
-export declare function MultiComboBox({ label, value, defaultValue, onChange, onInputChange, options, description, errorMessage, allowsCustomValue, size, fullWidth, className, style, ...rest }: MultiComboBoxProps): React.JSX.Element;
+export declare function MultiComboBox({ label, value, defaultValue, onChange, onInputChange, options, description, errorMessage, allowsCustomValue, size, isFilteredExternally, isLoading, loadingLabel, emptyLabel, onLoadMore, fullWidth, className, style, ...rest }: MultiComboBoxProps): React.JSX.Element;

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

@@ -7,18 +7,27 @@ export interface MultiComboBoxProps {
     defaultValue?: string[];
     onChange?: (values: string[]) => void;
     /**
-     * Free-text as typed, on every keystroke.
+     * Free-text as typed, on every keystroke. Debounce it before calling the server.
      *
-     * Server-side search is only partly supported, exactly as on ComboBox. `options` is passed
-     * to React Aria as `defaultItems`, so React Aria applies its own local "contains" filter on
-     * top of whatever you supply: any result whose `label` does not literally contain the typed
-     * text is hidden client-side, and when the local filter matches nothing the menu closes.
-     * Fuzzy, synonym, code-to-description and server-ranked matches are therefore dropped. Use
-     * this to observe input (analytics, a debounced prefetch), or for server search only where
-     * the returned labels are guaranteed to contain the query as a substring.
+     * Without `isFilteredExternally`, React Aria also applies its own local "contains" filter,
+     * so a result whose label does not literally contain the typed text is hidden client-side.
      */
     onInputChange?: (text: string) => void;
     options?: Array<string | ComboBoxOption>;
+    /**
+     * `options` is the final list and React Aria filters nothing locally. Same meaning and same
+     * name as on `ComboBox`. Required for server search, where fuzzy matches, synonyms and
+     * server ranking do not survive a local "contains" pass.
+     */
+    isFilteredExternally?: boolean;
+    /** Shows a loading row instead of closing the popover, and blocks selection while set. */
+    isLoading?: boolean;
+    /** Overrides the dictionary's `comboBoxLoading`. */
+    loadingLabel?: string;
+    /** Shown when the server answered with nothing, so a bad query reads differently from a slow one. */
+    emptyLabel?: React.ReactNode;
+    /** Called when the list is scrolled near its end, for paginated results. */
+    onLoadMore?: () => void;
     placeholder?: string;
     description?: React.ReactNode;
     errorMessage?: React.ReactNode;
@@ -55,5 +64,5 @@ export interface MultiComboBoxProps {
  *    component nested inside it — a TagGroup there registers its tags as listbox items and then
  *    crashes looking for grid state. Each chip's remove button is an ordinary Tab stop instead,
  *    and removals are announced through the live region below. */
-export declare function MultiComboBox({ label, value, defaultValue, onChange, onInputChange, options, description, errorMessage, allowsCustomValue, size, fullWidth, className, style, ...rest }: MultiComboBoxProps): React.JSX.Element;
+export declare function MultiComboBox({ label, value, defaultValue, onChange, onInputChange, options, description, errorMessage, allowsCustomValue, size, isFilteredExternally, isLoading, loadingLabel, emptyLabel, onLoadMore, fullWidth, className, style, ...rest }: MultiComboBoxProps): React.JSX.Element;
 //# sourceMappingURL=MultiComboBox.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MultiComboBox.d.ts","sourceRoot":"","sources":["../../../src/components/forms/MultiComboBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACtC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IACzC,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,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAKD;;;;;;;;;;;;;;;;;;;;kEAoBkE;AAClE,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAY,EAC/F,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,IAAW,EACzD,SAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,kBAAkB,qBAkHlE"}
+{"version":3,"file":"MultiComboBox.d.ts","sourceRoot":"","sources":["../../../src/components/forms/MultiComboBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACtC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IACzC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qGAAqG;IACrG,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,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,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAKD;;;;;;;;;;;;;;;;;;;;kEAoBkE;AAClE,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAY,EAC/F,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,IAAW,EACzD,oBAAoB,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EACrE,SAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,kBAAkB,qBAqIlE"}

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

@@ -40,9 +40,16 @@ export interface SideNavProps extends Omit<React.HTMLAttributes<HTMLElement>, 'o
     defaultExpandedIds?: string[];
     /** Fires with every expanded id after a toggle, controlled or not. */
     onExpandedChange?: (ids: string[]) => void;
-    /** 48px icon rail. Labels move into tooltips, and second-level items are not rendered at all —
-     *  see the note on {@link SideNav}. */
+    /** 48px icon rail. Labels move into tooltips or, for a group, into its flyout. */
     collapsed?: boolean;
+    /**
+     * In the rail, a group opens its children in a flyout beside it. On by default: without it the
+     * rail records an expansion nothing can draw, leaving second-level destinations reachable only
+     * by expanding the nav again.
+     *
+     * Pass `false` for the previous behaviour, where a rail group toggles expansion invisibly.
+     */
+    railFlyout?: boolean;
     footer?: React.ReactNode;
 }
 /** Primary navigation. A first-level entry is either a destination (icon + label, selectable) or a
@@ -63,12 +70,11 @@ export interface SideNavProps extends Omit<React.HTMLAttributes<HTMLElement>, 'o
  *    UA's `[hidden] { display: none }`, leaving collapsed children focusable under
  *    `aria-hidden="true"`. `.pire-sidenav-subnav[hidden]` in `components.css` is that guard.
  *  - **`collapsed` and expansion are different axes, and the rail wins.** With `collapsed` set there
- *    are no labels, and a second level is nothing *but* labels, so children are not rendered in the
- *    rail. A group's row becomes an ordinary icon button that records the expansion (so the group is
- *    already open when the rail expands) and lights up while it holds `value`, which is the one thing
- *    a rail must still communicate. It follows that a nav with collapsible groups needs a way back
- *    out of the rail — `ShellBar`'s `onMenu` — or 25 of those 35 destinations are unreachable, for
- *    everyone, exactly as the labels already are.
+ *    are no labels, and a second level is nothing *but* labels. A group therefore opens its children
+ *    in a flyout beside the rail (`railFlyout`, on by default) rather than inline. With
+ *    `railFlyout={false}` the row falls back to recording the expansion silently — which leaves
+ *    second-level destinations reachable only by expanding the nav again, so it is off the
+ *    accessible path and exists for compatibility.
  *  - **Several groups can be open at once**, and there is no accordion mode. Closing the group you
  *    are in to open another is the wrong trade in a nav whose whole job is showing where you are. */
-export declare function SideNav({ groups, value, onChange, expandedIds, defaultExpandedIds, onExpandedChange, collapsed, footer, className, ...rest }: SideNavProps): React.JSX.Element;
+export declare function SideNav({ groups, value, onChange, expandedIds, defaultExpandedIds, onExpandedChange, collapsed, railFlyout, footer, className, ...rest }: SideNavProps): React.JSX.Element;

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

@@ -40,9 +40,16 @@ export interface SideNavProps extends Omit<React.HTMLAttributes<HTMLElement>, 'o
     defaultExpandedIds?: string[];
     /** Fires with every expanded id after a toggle, controlled or not. */
     onExpandedChange?: (ids: string[]) => void;
-    /** 48px icon rail. Labels move into tooltips, and second-level items are not rendered at all —
-     *  see the note on {@link SideNav}. */
+    /** 48px icon rail. Labels move into tooltips or, for a group, into its flyout. */
     collapsed?: boolean;
+    /**
+     * In the rail, a group opens its children in a flyout beside it. On by default: without it the
+     * rail records an expansion nothing can draw, leaving second-level destinations reachable only
+     * by expanding the nav again.
+     *
+     * Pass `false` for the previous behaviour, where a rail group toggles expansion invisibly.
+     */
+    railFlyout?: boolean;
     footer?: React.ReactNode;
 }
 /** Primary navigation. A first-level entry is either a destination (icon + label, selectable) or a
@@ -63,13 +70,12 @@ export interface SideNavProps extends Omit<React.HTMLAttributes<HTMLElement>, 'o
  *    UA's `[hidden] { display: none }`, leaving collapsed children focusable under
  *    `aria-hidden="true"`. `.pire-sidenav-subnav[hidden]` in `components.css` is that guard.
  *  - **`collapsed` and expansion are different axes, and the rail wins.** With `collapsed` set there
- *    are no labels, and a second level is nothing *but* labels, so children are not rendered in the
- *    rail. A group's row becomes an ordinary icon button that records the expansion (so the group is
- *    already open when the rail expands) and lights up while it holds `value`, which is the one thing
- *    a rail must still communicate. It follows that a nav with collapsible groups needs a way back
- *    out of the rail — `ShellBar`'s `onMenu` — or 25 of those 35 destinations are unreachable, for
- *    everyone, exactly as the labels already are.
+ *    are no labels, and a second level is nothing *but* labels. A group therefore opens its children
+ *    in a flyout beside the rail (`railFlyout`, on by default) rather than inline. With
+ *    `railFlyout={false}` the row falls back to recording the expansion silently — which leaves
+ *    second-level destinations reachable only by expanding the nav again, so it is off the
+ *    accessible path and exists for compatibility.
  *  - **Several groups can be open at once**, and there is no accordion mode. Closing the group you
  *    are in to open another is the wrong trade in a nav whose whole job is showing where you are. */
-export declare function SideNav({ groups, value, onChange, expandedIds, defaultExpandedIds, onExpandedChange, collapsed, footer, className, ...rest }: SideNavProps): React.JSX.Element;
+export declare function SideNav({ groups, value, onChange, expandedIds, defaultExpandedIds, onExpandedChange, collapsed, railFlyout, footer, className, ...rest }: SideNavProps): React.JSX.Element;
 //# sourceMappingURL=SideNav.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SideNav.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/SideNav.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B;;;;8EAI8E;AAC9E,MAAM,WAAW,gBAAgB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAE/E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;wEAGoE;IACpE,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE;AAEtE,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IACvF,uDAAuD;IACvD,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;mGAC+F;IAC/F,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;sEACkE;IAClE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;mCAE+B;IAC/B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC3C;2CACuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;qGAyBqG;AACrG,wBAAgB,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAClG,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,YAAY,qBAgHtD"}
+{"version":3,"file":"SideNav.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/SideNav.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B;;;;8EAI8E;AAC9E,MAAM,WAAW,gBAAgB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAE/E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;wEAGoE;IACpE,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE;AAEtE,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IACvF,uDAAuD;IACvD,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;mGAC+F;IAC/F,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;sEACkE;IAClE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;mCAE+B;IAC/B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC3C,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAaD;;;;;;;;;;;;;;;;;;;;;;;;qGAwBqG;AACrG,wBAAgB,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAClG,SAAS,EAAE,UAAiB,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,YAAY,qBAwIzE"}

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

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import { type FileUploadProps } from '../forms/FileUpload.cjs';
+export interface FileDropZoneProps extends Omit<FileUploadProps, 'chooseLabel'> {
+    /** Instruction inside the zone. Overrides the dictionary's `fileDropZonePrompt`. */
+    promptLabel?: React.ReactNode;
+    /** `compact` for an import modal, where the zone competes with a table for height. */
+    height?: 'compact' | 'regular';
+}
+/**
+ * The large drop surface, for import screens and anywhere a file is the point of the page.
+ *
+ * Built on React Aria's `DropZone`, so it is a real drop target for keyboard and assistive tech —
+ * not a div with `onDragOver`. It still contains a `FileTrigger`, because drag-and-drop alone is
+ * not an accessible way to supply a file.
+ */
+export declare function FileDropZone({ label, value, defaultValue, onChange, acceptedFileTypes, allowsMultiple, maxSize, onError, showPreview, uploadProgress, promptLabel, height, description, errorMessage, isInvalid, isDisabled, isReadOnly, isRequired, fullWidth, className, style, }: FileDropZoneProps): React.JSX.Element;

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

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import { type FileUploadProps } from '../forms/FileUpload.js';
+export interface FileDropZoneProps extends Omit<FileUploadProps, 'chooseLabel'> {
+    /** Instruction inside the zone. Overrides the dictionary's `fileDropZonePrompt`. */
+    promptLabel?: React.ReactNode;
+    /** `compact` for an import modal, where the zone competes with a table for height. */
+    height?: 'compact' | 'regular';
+}
+/**
+ * The large drop surface, for import screens and anywhere a file is the point of the page.
+ *
+ * Built on React Aria's `DropZone`, so it is a real drop target for keyboard and assistive tech —
+ * not a div with `onDragOver`. It still contains a `FileTrigger`, because drag-and-drop alone is
+ * not an accessible way to supply a file.
+ */
+export declare function FileDropZone({ label, value, defaultValue, onChange, acceptedFileTypes, allowsMultiple, maxSize, onError, showPreview, uploadProgress, promptLabel, height, description, errorMessage, isInvalid, isDisabled, isReadOnly, isRequired, fullWidth, className, style, }: FileDropZoneProps): React.JSX.Element;
+//# sourceMappingURL=FileDropZone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileDropZone.d.ts","sourceRoot":"","sources":["../../../src/components/patterns/FileDropZone.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAA+B,KAAK,eAAe,EAAiB,MAAM,qBAAqB,CAAC;AAIvG,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC;IAC7E,oFAAoF;IACpF,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,sFAAsF;IACtF,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC;AAID;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EACzF,WAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAkB,EAAE,WAAW,EAAE,YAAY,EAC9F,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAgB,EAAE,SAAS,EAAE,KAAK,GAClF,EAAE,iBAAiB,qBAyFnB"}

package/dist/components.css

@@ -481,6 +481,37 @@
 .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}
 
+/* ---- FileUpload / FileDropZone ------------------------------------------- */
+.pire-fileupload-list{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:var(--sp-1)}
+.pire-fileupload-item{display:flex;align-items:center;gap:var(--sp-2);min-height:var(--row-h-condensed);padding:0 var(--sp-2);border:1px solid var(--border-subtle);border-radius:var(--radius-1);background:var(--surface-card)}
+.pire-fileupload-icon{flex:0 0 auto;color:var(--text-secondary)}
+.pire-fileupload-thumb{flex:0 0 auto;width:24px;height:24px;object-fit:cover;border-radius:var(--radius-1)}
+.pire-fileupload-name{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font:var(--type-body)}
+.pire-fileupload-size{flex:0 0 auto;font:var(--type-caption);color:var(--text-secondary);font-variant-numeric:tabular-nums}
+.pire-dropzone{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:var(--sp-2);padding:var(--sp-6);border:1px dashed var(--border-default);border-radius:var(--radius-2);background:var(--surface-sunken);color:var(--text-secondary);text-align:center;transition:var(--transition-surface)}
+.pire-dropzone[data-height="compact"]{padding:var(--sp-4)}
+/* React Aria sets data-drop-target while a drag hovers, and data-focus-visible on keyboard
+   focus — the zone is a real drop target, so both states have to read as active. */
+.pire-dropzone[data-drop-target]{border-color:var(--accent-bg);border-style:solid;background:var(--accent-subtle-bg)}
+.pire-dropzone[data-focus-visible]{outline:var(--focus-w) solid var(--focus-color);outline-offset:var(--focus-offset)}
+.pire-dropzone[data-disabled]{background:var(--surface-disabled);color:var(--text-disabled);border-color:var(--border-subtle)}
+.pire-dropzone-icon{color:var(--text-tertiary)}
+.pire-dropzone-prompt{font:var(--type-body)}
+
+/* ---- SideNav rail flyout -------------------------------------------------- */
+/* Matches the expanded nav's width so the flyout is not visibly narrower than the menu it
+   stands in for. The rows drop the second-level indent: there is no first level beside them
+   here, so the indent would be measuring against something that is not on screen. */
+.pire-sidenav-flyout{min-width:var(--sidenav-w)}
+.pire-sidenav-flyout .pire-menu-item{padding-left:var(--sp-4)}
+
+/* ---- ComboBox async status ----------------------------------------------- */
+/* Same height as an option row so the popover does not resize when results replace the
+   loading line — a popover that jumps has already moved the row under the pointer. */
+.pire-listbox-status{display:flex;align-items:center;min-height:var(--row-h-condensed);padding:0 var(--sp-3);font:var(--type-caption);color:var(--text-secondary)}
+.pire-option-label{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.pire-option-secondary{flex:0 0 auto;font:var(--type-code);color:var(--text-tertiary)}
+
 /* ---- PageBand ------------------------------------------------------------ */
 .pire-pageband{display:flex;flex-direction:column;gap:var(--sp-3);padding:var(--sp-4) var(--page-pad-x);background:var(--surface-card)}
 .pire-pageband[data-surface="page"]{background:var(--surface-page)}

package/dist/i18n/messages.d.cts

@@ -33,6 +33,8 @@ export interface PireMessages {
     toastRegionLabel: string;
     /** Accessible name of the button that opens a ComboBox's list. */
     comboBoxShowSuggestions: string;
+    /** Row shown in the popover while a server search is in flight. */
+    comboBoxLoading: string;
     /** Accessible name of the button that opens the calendar popover. */
     datePickerOpenCalendar: string;
     datePickerPreviousMonth: string;
@@ -61,6 +63,14 @@ export interface PireMessages {
     paginationRowsPerPage: string;
     /** Landmark name of the main SideNav. Override it when a screen has more than one nav. */
     sideNavLabel: string;
+    /** Button that opens the OS file picker. */
+    fileUploadChoose: string;
+    /** Removes one picked file. `{name}` is replaced with the file name. */
+    fileUploadRemoveNamed: string;
+    /** Label on the progress bar while the app uploads. */
+    fileUploadUploading: string;
+    /** Instruction inside the drop surface. */
+    fileDropZonePrompt: string;
 }
 export declare const enMessages: PireMessages;
 export declare const esMessages: PireMessages;

package/dist/i18n/messages.d.ts

@@ -33,6 +33,8 @@ export interface PireMessages {
     toastRegionLabel: string;
     /** Accessible name of the button that opens a ComboBox's list. */
     comboBoxShowSuggestions: string;
+    /** Row shown in the popover while a server search is in flight. */
+    comboBoxLoading: string;
     /** Accessible name of the button that opens the calendar popover. */
     datePickerOpenCalendar: string;
     datePickerPreviousMonth: string;
@@ -61,6 +63,14 @@ export interface PireMessages {
     paginationRowsPerPage: string;
     /** Landmark name of the main SideNav. Override it when a screen has more than one nav. */
     sideNavLabel: string;
+    /** Button that opens the OS file picker. */
+    fileUploadChoose: string;
+    /** Removes one picked file. `{name}` is replaced with the file name. */
+    fileUploadRemoveNamed: string;
+    /** Label on the progress bar while the app uploads. */
+    fileUploadUploading: string;
+    /** Instruction inside the drop surface. */
+    fileDropZonePrompt: string;
 }
 export declare const enMessages: PireMessages;
 export declare const esMessages: PireMessages;

package/dist/i18n/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/i18n/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAE1B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IAEvB,6DAA6D;IAC7D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,kEAAkE;IAClE,uBAAuB,EAAE,MAAM,CAAC;IAEhC,qEAAqE;IACrE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAE5B,kEAAkE;IAClE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,uBAAuB,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uDAAuD;IACvD,qBAAqB,EAAE,MAAM,CAAC;IAE9B,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAE9B,0FAA0F;IAC1F,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,UAAU,EAAE,YAuCxB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,YAuCxB,CAAC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/i18n/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAE1B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IAEvB,6DAA6D;IAC7D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,kEAAkE;IAClE,uBAAuB,EAAE,MAAM,CAAC;IAChC,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;IAExB,qEAAqE;IACrE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAE5B,kEAAkE;IAClE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,uBAAuB,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uDAAuD;IACvD,qBAAqB,EAAE,MAAM,CAAC;IAE9B,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAE9B,0FAA0F;IAC1F,YAAY,EAAE,MAAM,CAAC;IAErB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,UAAU,EAAE,YA6CxB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,YA6CxB,CAAC"}