@akinon/akifilter 1.8.0 → 1.9.0

package/dist/cjs/types.d.ts

@@ -13,8 +13,40 @@ export interface AkifilterFieldConfig<TFieldValues extends FieldValues = FieldVa
      */
     visible?: boolean | ((formValues: TFieldValues, currentVisible?: boolean) => boolean);
 }
-type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
-export type AkifilterField<TFieldValues extends FieldValues = FieldValues> = DistributiveOmit<FormField<TFieldValues>, 'config'> & {
+/**
+ * One applied-filter chip produced by a field that owns several filters at
+ * once (see `appliedChips`).
+ */
+export type AkifilterFieldChip = {
+    /**
+     * Identifies the chip inside its field. Passed back to
+     * `onRemoveAppliedChip` when the chip is removed, so it has to be stable for
+     * the same logical entry (e.g. the filter type it represents) and unique
+     * within the field — two chips sharing an id cannot be told apart on
+     * removal.
+     */
+    id: string;
+    /**
+     * Text before the colon. Defaults to the field's applied label
+     * (`appliedLabel`, else `label`).
+     */
+    label?: string;
+    /**
+     * Text after the colon — already formatted, since only the field knows how
+     * to render its own value.
+     */
+    value: string;
+    /**
+     * Renders the chip with the exclude styling. Defaults to whether the field
+     * belongs to an exclude section.
+     */
+    isExclude?: boolean;
+};
+/**
+ * Props Akifilter adds on top of the shared `FormField`. Kept separate so the
+ * mapping below can apply them to nested fields as well as top-level ones.
+ */
+type AkifilterFieldExtras<TFieldValues extends FieldValues = FieldValues> = {
     /**
      * Configuration options for field behavior (disabled, visible).
      */
@@ -24,14 +56,109 @@ export type AkifilterField<TFieldValues extends FieldValues = FieldValues> = Dis
      * Only applicable when `type` is `'file'`.
      */
     fileAccept?: string;
+    /**
+     * Expands this field's value into one chip per entry, instead of the single
+     * chip Akifilter derives from the value itself.
+     *
+     * This is what lets one field own several filters at once — a value that
+     * holds a bucket per filter type, a range that reads better as two chips,
+     * and so on. Because the buckets stay inside the field's form value,
+     * Akifilter persists and rehydrates them like any other value; nothing has
+     * to be mirrored outside the component.
+     *
+     * Pair it with `onRemoveAppliedChip` to make the chips removable. Return an
+     * empty array for "no chips right now".
+     *
+     * Only called while the field's own value is non-empty: the emptiness rules
+     * that suppress a plain chip (`null`/`undefined`, a blank string, an empty
+     * array) suppress these too. `formValues` is there to *format* the chips —
+     * a unit or a mode held by a sibling field — not to derive them from a
+     * sibling while this field holds nothing.
+     */
+    appliedChips?: (context: {
+        field: AkifilterField<TFieldValues>;
+        value: unknown;
+        formValues: Partial<TFieldValues>;
+    }) => AkifilterFieldChip[];
+    /**
+     * Maps the removal of one `appliedChips` chip back onto a new value for the
+     * field, which Akifilter then commits, persists and emits.
+     *
+     * Return the value the field should hold after the removal — `null` to clear
+     * the field entirely. Without this callback the chips render but cannot be
+     * removed.
+     */
+    onRemoveAppliedChip?: (context: {
+        field: AkifilterField<TFieldValues>;
+        value: unknown;
+        id: string;
+    }) => unknown;
+    /**
+     * Renders a CSV import button in the section header, paired with the
+     * `onSectionImportCsv` callback. Section fields only.
+     */
+    enableImportCsv?: boolean;
+    /**
+     * Renders an XLS/XLSX import button in the section header, paired with the
+     * `onSectionImportXls` callback. Section fields only.
+     */
+    enableImportXls?: boolean;
+    /**
+     * Overrides `label` for this field's applied-filter chip only.
+     *
+     * The form input and the "select visible filters" modal keep using `label`.
+     * Use this when the chip needs a shorter or more explicit name than the form
+     * does (e.g. `label: 'Created At'` next to a date range, `appliedLabel:
+     * 'Order date'` in the chip).
+     */
+    appliedLabel?: string;
+    /**
+     * Overrides `label` for this field's row in the "select visible filters"
+     * modal only. Also what the modal's search box matches against.
+     *
+     * The form input and the applied-filter chip keep using `label`. Use this
+     * when the modal lists fields out of context and needs a fully qualified
+     * name (e.g. `label: 'Status'`, `visibilityLabel: 'Order status'`).
+     */
+    visibilityLabel?: string;
 };
+/**
+ * Applies `AkifilterFieldExtras` to one member of the `FormField` union.
+ *
+ * Container fields (`section`, `field-array`, `column`) get their `fields`
+ * re-typed recursively: without that, the shared `FormField[]` child type
+ * would reject every Akifilter-only prop — a field inside a section could not
+ * declare `config.visible`, `fileAccept`, or a label override at all.
+ */
+type Akifiltered<TField, TFieldValues extends FieldValues> = TField extends {
+    fields: unknown[];
+} ? Omit<TField, 'config' | 'fields'> & AkifilterFieldExtras<TFieldValues> & {
+    fields: AkifilterField<TFieldValues>[];
+} : Omit<TField, 'config'> & AkifilterFieldExtras<TFieldValues>;
+/**
+ * A single Akifilter schema entry. `TField` below is a naked type parameter,
+ * so the conditional distributes over every member of the `FormField` union
+ * and each variant keeps its own discriminating `type` literal.
+ */
+export type AkifilterField<TFieldValues extends FieldValues = FieldValues> = Akifiltered<FormField<TFieldValues>, TFieldValues>;
 /**
  * Section field as consumed by Akifilter. Derived from the shared
  * `SectionField` so flags like `selectableFields`/`isExcludeSection` stay
  * single-sourced, but omits `collapsible` — Akifilter always renders sections
  * as collapsible panels and does not honor that prop.
  */
-export type AkifilterSectionField<TFieldValues extends FieldValues = FieldValues> = Omit<SectionField<TFieldValues>, 'collapsible'>;
+export type AkifilterSectionField<TFieldValues extends FieldValues = FieldValues> = Omit<SectionField<TFieldValues>, 'collapsible' | 'fields'> & {
+    /**
+     * Child fields, typed as Akifilter fields rather than the shared
+     * `FormField` so section children accept the same Akifilter-only props as
+     * top-level ones (`config.visible`, `fileAccept`, the label overrides).
+     */
+    fields: AkifilterField<TFieldValues>[];
+    /** Renders a CSV import button in the section header. */
+    enableImportCsv?: boolean;
+    /** Renders an XLS/XLSX import button in the section header. */
+    enableImportXls?: boolean;
+};
 export type AkifilterFieldKey<TFieldValues extends FieldValues = FieldValues> = Path<TFieldValues>;
 export type AkifilterSchema<TFieldValues extends FieldValues = FieldValues> = AkifilterField<TFieldValues>[];
 /**
@@ -88,5 +215,21 @@ export interface AkifilterActionsRef {
      */
     clearValue: (keys: string | string[]) => void;
 }
+declare module '@akinon/akiform-builder' {
+    interface FieldExtensions {
+        /** @see AkifilterField.appliedLabel */
+        appliedLabel?: AkifilterField['appliedLabel'];
+        /** @see AkifilterField.visibilityLabel */
+        visibilityLabel?: AkifilterField['visibilityLabel'];
+        /** @see AkifilterField.appliedChips */
+        appliedChips?: AkifilterField['appliedChips'];
+        /** @see AkifilterField.onRemoveAppliedChip */
+        onRemoveAppliedChip?: AkifilterField['onRemoveAppliedChip'];
+        /** @see AkifilterField.enableImportCsv */
+        enableImportCsv?: boolean;
+        /** @see AkifilterField.enableImportXls */
+        enableImportXls?: boolean;
+    }
+}
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,oBAAoB,CACnC,YAAY,SAAS,WAAW,GAAG,WAAW;IAE9C;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,UAAU,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC;IAC7D;;;OAGG;IACH,OAAO,CAAC,EACJ,OAAO,GACP,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;CACvE;AAED,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GAC/D,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GACV,KAAK,CAAC;AAEV,MAAM,MAAM,cAAc,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IACvE,gBAAgB,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,GAAG;IACpD;;OAEG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAC5C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,CAC/B,YAAY,SAAS,WAAW,GAAG,WAAW,IAC5C,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,MAAM,iBAAiB,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IAC1E,IAAI,CAAC,YAAY,CAAC,CAAC;AAErB,MAAM,MAAM,eAAe,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IACxE,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC;CAC/C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/cjs/utils/schema.d.ts

@@ -14,6 +14,16 @@ export declare const partitionSchema: <TFieldValues extends FieldValues = FieldV
 };
 export declare const deriveExcludeSectionKeys: <TFieldValues extends FieldValues = FieldValues>(sectionFields: Array<AkifilterSectionField<TFieldValues>>) => Set<string>;
 export declare const getDisplayLabel: <TFieldValues extends FieldValues = FieldValues>(field: AkifilterField<TFieldValues>) => string;
+/**
+ * Label for the field's applied-filter chip. Falls back to the shared display
+ * label, so a schema that sets no override behaves exactly as before.
+ */
+export declare const getAppliedLabel: <TFieldValues extends FieldValues = FieldValues>(field: AkifilterField<TFieldValues>) => string;
+/**
+ * Label for the field's row in the visibility modal. Falls back to the shared
+ * display label, so a schema that sets no override behaves exactly as before.
+ */
+export declare const getVisibilityLabel: <TFieldValues extends FieldValues = FieldValues>(field: AkifilterField<TFieldValues>) => string;
 export declare const getFieldAriaLabel: <TFieldValues extends FieldValues = FieldValues>(field: AkifilterField<TFieldValues>) => string;
 export declare const ensureSchemaOrder: <TFieldValues extends FieldValues = FieldValues>(schema: AkifilterSchema<TFieldValues>, keys: string[]) => string[];
 /**

package/dist/cjs/utils/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/utils/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,SAAS,WAAW,GAAG,WAAW,EAC1E,QAAQ,eAAe,CAAC,YAAY,CAAC,KACpC,eAAe,CAAC,YAAY,CAW9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,GAAG,WAAW,EAC5E,QAAQ,eAAe,CAAC,YAAY,CAAC,KACpC;IACD,aAAa,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC7C,aAAa,EAAE,KAAK,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;CAc3D,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,eAAe,KAAK,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,KACxD,GAAG,CAAC,MAAM,CAKV,CAAC;AAEJ,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,GAAG,WAAW,EAC5E,OAAO,cAAc,CAAC,YAAY,CAAC,KAClC,MAEF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,OAAO,cAAc,CAAC,YAAY,CAAC,KAClC,MAEF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,QAAQ,eAAe,CAAC,YAAY,CAAC,EACrC,MAAM,MAAM,EAAE,KACb,MAAM,EAGR,CAAC;AAkBF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,OAAO,cAAc,CAAC,YAAY,CAAC,EACnC,aAAa,YAAY,EACzB,iBAAiB,OAAO,KACvB,OAAO,GAAG,SAC8D,CAAC;AAE5E,eAAO,MAAM,wBAAwB,GACnC,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,QAAQ,eAAe,CAAC,YAAY,CAAC,KACpC,MAAM,EAUR,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,QAAQ,eAAe,CAAC,YAAY,CAAC,KACpC,OAAO,CAAC,YAAY,CAQtB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,YAAY,SAAS,WAAW,EACnE,OAAO,cAAc,CAAC,YAAY,CAAC,KAClC,OAA4C,CAAC;AAEhD,eAAO,MAAM,uBAAuB,GAClC,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,QAAQ,eAAe,CAAC,YAAY,CAAC,EACrC,SAAS,OAAO,CAAC,YAAY,CAAC,KAC7B,OAAO,CAAC,YAAY,CA0CtB,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/utils/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,SAAS,WAAW,GAAG,WAAW,EAC1E,QAAQ,eAAe,CAAC,YAAY,CAAC,KACpC,eAAe,CAAC,YAAY,CAW9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,GAAG,WAAW,EAC5E,QAAQ,eAAe,CAAC,YAAY,CAAC,KACpC;IACD,aAAa,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC7C,aAAa,EAAE,KAAK,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;CAc3D,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,eAAe,KAAK,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,KACxD,GAAG,CAAC,MAAM,CAKV,CAAC;AAEJ,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,GAAG,WAAW,EAC5E,OAAO,cAAc,CAAC,YAAY,CAAC,KAClC,MAEF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,GAAG,WAAW,EAC5E,OAAO,cAAc,CAAC,YAAY,CAAC,KAClC,MAAsD,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,OAAO,cAAc,CAAC,YAAY,CAAC,KAClC,MAAyD,CAAC;AAE7D,eAAO,MAAM,iBAAiB,GAC5B,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,OAAO,cAAc,CAAC,YAAY,CAAC,KAClC,MAEF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,QAAQ,eAAe,CAAC,YAAY,CAAC,EACrC,MAAM,MAAM,EAAE,KACb,MAAM,EAGR,CAAC;AAkBF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,OAAO,cAAc,CAAC,YAAY,CAAC,EACnC,aAAa,YAAY,EACzB,iBAAiB,OAAO,KACvB,OAAO,GAAG,SAC8D,CAAC;AAE5E,eAAO,MAAM,wBAAwB,GACnC,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,QAAQ,eAAe,CAAC,YAAY,CAAC,KACpC,MAAM,EAUR,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,QAAQ,eAAe,CAAC,YAAY,CAAC,KACpC,OAAO,CAAC,YAAY,CAQtB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,YAAY,SAAS,WAAW,EACnE,OAAO,cAAc,CAAC,YAAY,CAAC,KAClC,OAA4C,CAAC;AAEhD,eAAO,MAAM,uBAAuB,GAClC,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,QAAQ,eAAe,CAAC,YAAY,CAAC,EACrC,SAAS,OAAO,CAAC,YAAY,CAAC,KAC7B,OAAO,CAAC,YAAY,CA0CtB,CAAC"}

package/dist/cjs/utils/schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normaliseValuesBySchema = exports.hasDynamicVisibility = exports.extractDefaultValues = exports.deriveDefaultVisibleKeys = exports.resolveFieldVisibility = exports.ensureSchemaOrder = exports.getFieldAriaLabel = exports.getDisplayLabel = exports.deriveExcludeSectionKeys = exports.partitionSchema = exports.flattenSchema = void 0;
+exports.normaliseValuesBySchema = exports.hasDynamicVisibility = exports.extractDefaultValues = exports.deriveDefaultVisibleKeys = exports.resolveFieldVisibility = exports.ensureSchemaOrder = exports.getFieldAriaLabel = exports.getVisibilityLabel = exports.getAppliedLabel = exports.getDisplayLabel = exports.deriveExcludeSectionKeys = exports.partitionSchema = exports.flattenSchema = void 0;
 const akidate_1 = require("@akinon/akidate");
 const lodash_es_1 = require("lodash-es");
 const constants_1 = require("../constants");
@@ -46,6 +46,18 @@ const getDisplayLabel = (field) => {
     return field.label || field.placeholder || String(field.key);
 };
 exports.getDisplayLabel = getDisplayLabel;
+/**
+ * Label for the field's applied-filter chip. Falls back to the shared display
+ * label, so a schema that sets no override behaves exactly as before.
+ */
+const getAppliedLabel = (field) => field.appliedLabel || (0, exports.getDisplayLabel)(field);
+exports.getAppliedLabel = getAppliedLabel;
+/**
+ * Label for the field's row in the visibility modal. Falls back to the shared
+ * display label, so a schema that sets no override behaves exactly as before.
+ */
+const getVisibilityLabel = (field) => field.visibilityLabel || (0, exports.getDisplayLabel)(field);
+exports.getVisibilityLabel = getVisibilityLabel;
 const getFieldAriaLabel = (field) => {
     return field.label || field.placeholder || String(field.key);
 };

package/dist/esm/akifilter.d.ts

@@ -71,6 +71,25 @@ export type AkifilterProps<TFieldValues extends AkifilterFieldValues = Akifilter
      * Notified whenever the set of active filter buttons changes.
      */
     onFilterButtonsChange?: (activeButtons: AkifilterButton[]) => void;
+    /**
+     * Triggered when a user picks a CSV file from a section header's import
+     * button. Receives the section's `key` and the selected file, so one handler
+     * can serve every section.
+     *
+     * The button only renders for sections that set `enableImportCsv: true` —
+     * mirroring how the top-level toolbar pairs `enableImportCsv` with
+     * `onImportCsv`. Akifilter never parses the file; the host application
+     * decides what to do with it (e.g. call an exclude-by-file endpoint and
+     * surface a chip through `externalAppliedFilters`).
+     */
+    onSectionImportCsv?: (sectionKey: string, file: File) => void;
+    /**
+     * Triggered when a user picks an XLS/XLSX file from a section header's import
+     * button. Receives the section's `key` and the selected file.
+     *
+     * The button only renders for sections that set `enableImportXls: true`.
+     */
+    onSectionImportXls?: (sectionKey: string, file: File) => void;
 };
 export declare const Akifilter: {
     <TFieldValues extends AkifilterFieldValues = FieldValues>(props: AkifilterProps<TFieldValues>): React.JSX.Element;

package/dist/esm/akifilter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"akifilter.d.ts","sourceRoot":"","sources":["../../src/akifilter.tsx"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAGtB,OAAO,EAIL,WAAW,EACX,IAAI,EAIL,MAAM,iBAAiB,CAAC;AAYzB,OAAO,KAAK,MAAM,OAAO,CAAC;AAc1B,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,8BAA8B,CAAC;AAgBtC,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EAEf,eAAe,EAChB,MAAM,SAAS,CAAC;AAWjB,KAAK,oBAAoB,GAAG,WAAW,CAAC;AA2KxC,MAAM,MAAM,cAAc,CACxB,YAAY,SAAS,oBAAoB,GAAG,oBAAoB,IAC9D;IACF;;OAEG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC7C;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACtC;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACzD;;OAEG;IACH,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,IAAI,CAAC;IAClE;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAClD;;;OAGG;IACH,sBAAsB,CAAC,EAAE,aAAa,EAAE,CAAC;IACzC;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC;;OAEG;IACH,qBAAqB,CAAC,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;CACpE,CAAC;AA+3BF,eAAO,MAAM,SAAS;KACpB,YAAY,SAAS,oBAAoB,uBAElC,cAAc,CAAC,YAAY,CAAC;;CAoBpC,CAAC"}
+{"version":3,"file":"akifilter.d.ts","sourceRoot":"","sources":["../../src/akifilter.tsx"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAGtB,OAAO,EAIL,WAAW,EACX,IAAI,EAIL,MAAM,iBAAiB,CAAC;AAYzB,OAAO,KAAK,MAAM,OAAO,CAAC;AAc1B,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,8BAA8B,CAAC;AAgBtC,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EAEf,eAAe,EAChB,MAAM,SAAS,CAAC;AAYjB,KAAK,oBAAoB,GAAG,WAAW,CAAC;AAiLxC,MAAM,MAAM,cAAc,CACxB,YAAY,SAAS,oBAAoB,GAAG,oBAAoB,IAC9D;IACF;;OAEG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC7C;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACtC;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACzD;;OAEG;IACH,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,IAAI,CAAC;IAClE;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAClD;;;OAGG;IACH,sBAAsB,CAAC,EAAE,aAAa,EAAE,CAAC;IACzC;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC;;OAEG;IACH,qBAAqB,CAAC,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;IACnE;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC9D;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAC/D,CAAC;AAk9BF,eAAO,MAAM,SAAS;KACpB,YAAY,SAAS,oBAAoB,uBAElC,cAAc,CAAC,YAAY,CAAC;;CAoBpC,CAAC"}

package/dist/esm/akifilter.js

@@ -37,7 +37,7 @@ import { useDynamicVisibility } from './hooks/use-dynamic-visibility';
 import { useFieldVisibility } from './hooks/use-field-visibility';
 import { useVisibilityCleanup } from './hooks/use-visibility-cleanup';
 import { i18n } from './i18n';
-import { deriveExcludeSectionKeys, extractDefaultValues, flattenSchema, getFieldAriaLabel, normaliseValuesBySchema, partitionSchema } from './utils/schema';
+import { deriveExcludeSectionKeys, extractDefaultValues, flattenSchema, getAppliedLabel, getFieldAriaLabel, normaliseValuesBySchema, partitionSchema } from './utils/schema';
 import { normaliseOutputValues } from './utils/values';
 /**
  * Prefix for applied-filter chip keys that originate from filter buttons.
@@ -45,6 +45,12 @@ import { normaliseOutputValues } from './utils/values';
  * routed back to the owning button.
  */
 const BUTTON_CHIP_PREFIX = 'akifilter-button:';
+// Chips a field produced through `appliedChips`. The key carries both halves —
+// `<field key>::<chip id>` — so a removal can be routed back to the field that
+// owns it. Split at the *first* separator, so a chip id may contain one; a
+// field key may not, which holds for form paths.
+const FIELD_CHIP_PREFIX = 'akifilter-field:';
+const FIELD_CHIP_SEPARATOR = '::';
 const FilterFormItem = (_a) => {
     var _b, _c;
     var { children, control, name, valuePropName } = _a, props = __rest(_a, ["children", "control", "name", "valuePropName"]);
@@ -125,7 +131,7 @@ const resolveClearedFieldValue = (field, defaultValue) => {
             return undefined;
     }
 };
-const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onValuesChange, onVisibleFieldsChange, onImportCsv, onImportXls, onClearAll, enableImportCsv, enableImportXls, filterActionsRef, externalAppliedFilters, onRemoveExternalFilter, filterButtons, onFilterButtonsChange }) => {
+const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onValuesChange, onVisibleFieldsChange, onImportCsv, onImportXls, onClearAll, enableImportCsv, enableImportXls, filterActionsRef, externalAppliedFilters, onRemoveExternalFilter, filterButtons, onFilterButtonsChange, onSectionImportCsv, onSectionImportXls }) => {
     // Separate regular fields from section fields
     const { regularFields, sectionFields } = React.useMemo(() => partitionSchema(filterSchema), [filterSchema]);
     const excludeSectionKeys = React.useMemo(() => deriveExcludeSectionKeys(sectionFields), [sectionFields]);
@@ -135,16 +141,19 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
     const schemaDefaults = React.useMemo(() => normaliseValuesBySchema(flattenedSchema, extractDefaultValues(flattenedSchema)), [flattenedSchema]);
     const externalDefaults = React.useMemo(() => normaliseValuesBySchema(flattenedSchema, defaultValues), [flattenedSchema, defaultValues]);
     const baseDefaultValues = React.useMemo(() => (Object.assign(Object.assign({}, schemaDefaults), externalDefaults)), [schemaDefaults, externalDefaults]);
-    // Use state for persistedDefaults to make it reactive to localStorage changes
+    // Use state for persistedDefaults to make it reactive to localStorage changes.
+    // Read against the *flattened* schema: `readStoredValues` drops keys that are
+    // not in the schema it is given, so passing only the top-level fields would
+    // silently discard every section field's persisted value on reload.
     const [persistedDefaults, setPersistedDefaults] = React.useState(() => {
         var _a;
-        return normaliseValuesBySchema(flattenedSchema, (_a = readStoredValues(regularFields, storageKey)) !== null && _a !== void 0 ? _a : undefined);
+        return normaliseValuesBySchema(flattenedSchema, (_a = readStoredValues(flattenedSchema, storageKey)) !== null && _a !== void 0 ? _a : undefined);
     });
     // Re-read from localStorage when storageKey changes
     React.useEffect(() => {
         var _a;
-        setPersistedDefaults(normaliseValuesBySchema(flattenedSchema, (_a = readStoredValues(regularFields, storageKey)) !== null && _a !== void 0 ? _a : undefined));
-    }, [flattenedSchema, regularFields, storageKey]);
+        setPersistedDefaults(normaliseValuesBySchema(flattenedSchema, (_a = readStoredValues(flattenedSchema, storageKey)) !== null && _a !== void 0 ? _a : undefined));
+    }, [flattenedSchema, storageKey]);
     const mergedDefaultValues = React.useMemo(() => (Object.assign(Object.assign({}, baseDefaultValues), persistedDefaults)), [baseDefaultValues, persistedDefaults]);
     const formMethods = useForm({
         defaultValues: mergedDefaultValues
@@ -197,7 +206,23 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
             if (field.type === FIELD_TYPES.CHECKBOX && currentValue !== true) {
                 return acc;
             }
-            const label = field.label || field.placeholder || key;
+            const label = getAppliedLabel(field);
+            // A field that owns several filters renders its own chips: only it knows
+            // how to split its value and how to format each part.
+            if (typeof field.appliedChips === 'function') {
+                field
+                    .appliedChips({ field, value: currentValue, formValues })
+                    .forEach(chip => {
+                    var _a, _b;
+                    acc.push({
+                        key: `${FIELD_CHIP_PREFIX}${key}${FIELD_CHIP_SEPARATOR}${chip.id}`,
+                        label: (_a = chip.label) !== null && _a !== void 0 ? _a : label,
+                        value: chip.value,
+                        isExclude: (_b = chip.isExclude) !== null && _b !== void 0 ? _b : excludeSectionKeys.has(key)
+                    });
+                });
+                return acc;
+            }
             const fieldOptions = 'options' in field && field.options ? field.options : undefined;
             const resolveLabel = (val) => {
                 var _a;
@@ -415,17 +440,14 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
         emitValues,
         persistValues
     ]);
-    const handleRemoveFilter = React.useCallback((key) => {
-        const schemaField = flattenedSchema.find(field => String(field.key) === key);
-        if (!schemaField) {
-            return;
-        }
-        const defaultValue = schemaDefaults[String(schemaField.key)];
-        const nextValue = resolveClearedFieldValue(schemaField, defaultValue);
+    // Writes one field's value and pushes the result through the whole
+    // persist/emit path immediately, bypassing the debounce the way a removal
+    // has to. Shared by chip removals — whole-field and per-chip alike.
+    const commitFieldValue = React.useCallback((fieldKey, nextValue) => {
         // Manually construct the updated form values instead of relying on setValue + getValues
         // because setValue is batched and getValues() wouldn't reflect the change immediately
         const currentFormValues = formMethods.getValues();
-        const updatedFormValues = Object.assign(Object.assign({}, currentFormValues), { [String(schemaField.key)]: nextValue });
+        const updatedFormValues = Object.assign(Object.assign({}, currentFormValues), { [fieldKey]: nextValue });
         // Normalize the values (removes empty/undefined entries)
         const nextValues = normaliseOutputValues(flattenedSchema, updatedFormValues);
         // updatedFormValues holds an explicit cleared value (e.g. `null` for custom/file
@@ -447,7 +469,36 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
         hasInitialValuesRef.current = Object.keys(nextValues).length > 0;
         // Emit the change to parent
         emitValues(nextValues);
-    }, [schemaDefaults, flattenedSchema, formMethods, emitValues, persistValues]);
+    }, [flattenedSchema, formMethods, emitValues, persistValues]);
+    const handleRemoveFilter = React.useCallback((key) => {
+        const schemaField = flattenedSchema.find(field => String(field.key) === key);
+        if (!schemaField) {
+            return;
+        }
+        const defaultValue = schemaDefaults[String(schemaField.key)];
+        commitFieldValue(String(schemaField.key), resolveClearedFieldValue(schemaField, defaultValue));
+    }, [schemaDefaults, flattenedSchema, commitFieldValue]);
+    // Removal of a single chip produced by a field's own `appliedChips`. The
+    // field decides what its value becomes; Akifilter just commits it.
+    const handleFieldChipRemove = React.useCallback((chipKey) => {
+        const separatorIndex = chipKey.indexOf(FIELD_CHIP_SEPARATOR);
+        if (separatorIndex === -1) {
+            return;
+        }
+        const fieldKey = chipKey.slice(0, separatorIndex);
+        const chipId = chipKey.slice(separatorIndex + FIELD_CHIP_SEPARATOR.length);
+        const schemaField = flattenedSchema.find(field => String(field.key) === fieldKey);
+        if (!schemaField ||
+            typeof schemaField.onRemoveAppliedChip !== 'function') {
+            return;
+        }
+        const currentValue = formMethods.getValues()[fieldKey];
+        commitFieldValue(fieldKey, schemaField.onRemoveAppliedChip({
+            field: schemaField,
+            value: currentValue,
+            id: chipId
+        }));
+    }, [flattenedSchema, formMethods, commitFieldValue]);
     // Toggle a filter button. Button state lives outside the form, so this syncs
     // the value ref, persists, and emits immediately (bypassing the form debounce).
     const handleButtonToggle = React.useCallback((button) => {
@@ -511,6 +562,9 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
         if (key.startsWith(BUTTON_CHIP_PREFIX)) {
             handleButtonRemove(key.slice(BUTTON_CHIP_PREFIX.length));
         }
+        else if (key.startsWith(FIELD_CHIP_PREFIX)) {
+            handleFieldChipRemove(key.slice(FIELD_CHIP_PREFIX.length));
+        }
         else if (externalAppliedFilters === null || externalAppliedFilters === void 0 ? void 0 : externalAppliedFilters.some(f => f.key === key)) {
             onRemoveExternalFilter === null || onRemoveExternalFilter === void 0 ? void 0 : onRemoveExternalFilter(key);
         }
@@ -521,7 +575,8 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
         externalAppliedFilters,
         onRemoveExternalFilter,
         handleRemoveFilter,
-        handleButtonRemove
+        handleButtonRemove,
+        handleFieldChipRemove
     ]);
     const handleClearAllApplied = React.useCallback(() => {
         // Reset filter buttons before clearing the form so the merged emission in
@@ -596,7 +651,9 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
                     React.createElement("div", { className: "akinon-filter__form-grid", "data-testid": "akifilter-form-grid" },
                         visibleFields.map(renderFormField),
                         visibleFields.length === 0 && regularFields.length > 0 ? (React.createElement("div", { className: "akinon-filter__empty" }, i18n.t('form.noVisibleFields'))) : null),
-                    sectionFields.length > 0 && (React.createElement("div", { className: "akinon-filter__section-fields" }, sectionFields.map(section => (React.createElement(SectionFieldset, { key: String(section.key), section: section, storageKey: storageKey, renderFormField: renderFormField, onRemoveField: handleRemoveFilter, formValues: normalisedValues }))))))),
+                    sectionFields.length > 0 && (React.createElement("div", { className: "akinon-filter__section-fields" }, sectionFields.map(section => (React.createElement(SectionFieldset, { key: String(section.key), section: section, storageKey: storageKey, renderFormField: renderFormField, onRemoveField: handleRemoveFilter, formValues: normalisedValues, onImportCsv: onSectionImportCsv &&
+                            (file => onSectionImportCsv(String(section.key), file)), onImportXls: onSectionImportXls &&
+                            (file => onSectionImportXls(String(section.key), file)) }))))))),
             React.createElement(VisibilityModal, Object.assign({}, modalProps)))));
 };
 const AkifilterEmptyState = () => {

package/dist/esm/common/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/common/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA4B/C,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,EAC9D,QAAQ,cAAc,CAAC,YAAY,CAAC,EAAE,EACtC,YAAY,MAAM,KACjB,MAKF,CAAC;AAIF,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,EAC9D,QAAQ,cAAc,CAAC,YAAY,CAAC,EAAE,EACtC,YAAY,MAAM,KACjB,MAAM,EAAE,GAAG,IAoBb,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,EAAE,MAAM,MAAM,EAAE,KAAG,IAQrE,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,YAAY,MAAM,EAClB,YAAY,MAAM,GAAG,MAAM,KAC1B,MAAuD,CAAC;AAE3D,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,IAQrD,CAAC;AAKF,eAAO,MAAM,gBAAgB,GAAI,YAAY,SAAS,WAAW,EAC/D,QAAQ,cAAc,CAAC,YAAY,CAAC,EAAE,EACtC,YAAY,MAAM,KACjB,OAAO,CAAC,YAAY,CAAC,GAAG,IA+B1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,YAAY,SAAS,WAAW,EAChE,YAAY,MAAM,EAClB,QAAQ,OAAO,CAAC,YAAY,CAAC,KAC5B,IAeF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,IAQtD,CAAC;AAKF,eAAO,MAAM,sBAAsB,GACjC,YAAY,MAAM,KACjB,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAwB3B,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,YAAY,MAAM,EAClB,QAAQ,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAC7B,IAcF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,YAAY,MAAM,KAAG,IAQ5D,CAAC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/common/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA4B/C,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,EAC9D,QAAQ,cAAc,CAAC,YAAY,CAAC,EAAE,EACtC,YAAY,MAAM,KACjB,MAKF,CAAC;AAIF,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,EAC9D,QAAQ,cAAc,CAAC,YAAY,CAAC,EAAE,EACtC,YAAY,MAAM,KACjB,MAAM,EAAE,GAAG,IAoBb,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,EAAE,MAAM,MAAM,EAAE,KAAG,IAQrE,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,YAAY,MAAM,EAClB,YAAY,MAAM,GAAG,MAAM,KAC1B,MAAuD,CAAC;AAE3D,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,IAQrD,CAAC;AA0DF,eAAO,MAAM,gBAAgB,GAAI,YAAY,SAAS,WAAW,EAC/D,QAAQ,cAAc,CAAC,YAAY,CAAC,EAAE,EACtC,YAAY,MAAM,KACjB,OAAO,CAAC,YAAY,CAAC,GAAG,IAqC1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,YAAY,SAAS,WAAW,EAChE,YAAY,MAAM,EAClB,QAAQ,OAAO,CAAC,YAAY,CAAC,KAC5B,IAeF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,IAQtD,CAAC;AAKF,eAAO,MAAM,sBAAsB,GACjC,YAAY,MAAM,KACjB,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAwB3B,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,YAAY,MAAM,EAClB,QAAQ,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAC7B,IAcF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,YAAY,MAAM,KAAG,IAQ5D,CAAC"}

package/dist/esm/common/storage.js

@@ -1,3 +1,4 @@
+import { FIELD_MODES, FIELD_TYPES } from '../constants';
 import { i18n } from '../i18n';
 const STORAGE_PREFIX = 'akifilter:v1';
 const VALUES_SUFFIX = ':values';
@@ -68,6 +69,46 @@ export const clearVisibleKeys = (storageKey) => {
     }
 };
 const buildValuesStorageKey = (storageKey) => `${storageKey}${VALUES_SUFFIX}`;
+/**
+ * Guards a persisted value against schema drift.
+ *
+ * The storage key is hashed from the top-level field signature only, so a
+ * section field whose `type`/`mode` changed between releases keeps the same key
+ * and its stale value would otherwise be restored into an incompatible widget
+ * (e.g. a multi-select's array landing in a text input, which then renders
+ * `a,b` and is re-emitted as an array to a host expecting a string).
+ *
+ * Deliberately conservative: it only rejects shapes that no widget of that type
+ * can hold, and never polices string-vs-number.
+ */
+const isStoredValueCompatible = (field, value) => {
+    // `File` objects stringify to `{}`, so a persisted file value is always junk.
+    if (field.type === FIELD_TYPES.FILE) {
+        return false;
+    }
+    // Custom fields own their value shape; the package cannot judge it. So does
+    // any field that renders its own chips: `appliedChips` means the value is a
+    // composite only that field interprets, whatever the field's type is.
+    if (field.type === FIELD_TYPES.CUSTOM ||
+        typeof field.appliedChips === 'function') {
+        return true;
+    }
+    const isMultiSelect = field.type === FIELD_TYPES.SELECT &&
+        (field.mode === FIELD_MODES.MULTIPLE || field.mode === FIELD_MODES.TAGS);
+    if (Array.isArray(value)) {
+        // Only multi-selects hold arrays. A bare scalar is still fine for them —
+        // `normaliseValuesBySchema` wraps it.
+        return isMultiSelect;
+    }
+    // Nothing else round-trips through a filter widget as a plain object.
+    if (value !== null && typeof value === 'object') {
+        return false;
+    }
+    if (field.type === FIELD_TYPES.CHECKBOX) {
+        return typeof value === 'boolean';
+    }
+    return true;
+};
 export const readStoredValues = (schema, storageKey) => {
     if (!isBrowser)
         return null;
@@ -80,9 +121,13 @@ export const readStoredValues = (schema, storageKey) => {
         if (!parsed || typeof parsed !== 'object') {
             return null;
         }
-        const schemaKeys = new Set(schema.map(field => String(field.key)));
+        const fieldsByKey = new Map(schema.map(field => [String(field.key), field]));
         return Object.entries(parsed).reduce((acc, [key, value]) => {
-            if (schemaKeys.has(String(key))) {
+            const field = fieldsByKey.get(String(key));
+            // Unknown keys belong to a different schema version; values whose shape no
+            // longer fits their field are stale leftovers of one (see
+            // `isStoredValueCompatible`).
+            if (field && isStoredValueCompatible(field, value)) {
                 acc[key] =
                     value;
             }

package/dist/esm/components/file-import-button.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+export type FileImportButtonProps = {
+    /**
+     * Accepted file extensions, forwarded to the hidden file input
+     * (e.g. `'.csv'`, `'.xls,.xlsx'`).
+     */
+    accept: string;
+    /**
+     * Text rendered inside the button (e.g. `'CSV'`).
+     */
+    label: string;
+    /**
+     * Tooltip / accessible name. Falls back to `label` when omitted, which is
+     * what the top-level toolbar relies on.
+     */
+    title?: string;
+    /**
+     * Called with the picked file. The component never uploads anything itself;
+     * the host application decides what to do with the file.
+     */
+    onImport: (file: File) => void;
+    /**
+     * Extra class names appended to the button.
+     */
+    className?: string;
+};
+/**
+ * Button that opens the native file picker and hands the selected file to
+ * `onImport`. Shared by the top-level filter toolbar and the section headers so
+ * both surfaces behave identically.
+ */
+export declare const FileImportButton: ({ accept, label, title, onImport, className }: FileImportButtonProps) => React.JSX.Element;
+//# sourceMappingURL=file-import-button.d.ts.map

package/dist/esm/components/file-import-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-import-button.d.ts","sourceRoot":"","sources":["../../../src/components/file-import-button.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,+CAM9B,qBAAqB,sBA6CvB,CAAC"}

package/dist/esm/components/file-import-button.js

@@ -0,0 +1,33 @@
+import { Button } from '@akinon/ui-button';
+import React from 'react';
+/**
+ * Button that opens the native file picker and hands the selected file to
+ * `onImport`. Shared by the top-level filter toolbar and the section headers so
+ * both surfaces behave identically.
+ */
+export const FileImportButton = ({ accept, label, title, onImport, className }) => {
+    const inputRef = React.useRef(null);
+    const resolvedTitle = title !== null && title !== void 0 ? title : label;
+    const handleClick = () => { var _a; return (_a = inputRef.current) === null || _a === void 0 ? void 0 : _a.click(); };
+    const handleChange = (event) => {
+        var _a;
+        const file = (_a = event.target.files) === null || _a === void 0 ? void 0 : _a[0];
+        if (file) {
+            onImport(file);
+        }
+        // Reset so same file can be re-selected
+        event.target.value = '';
+    };
+    return (React.createElement(React.Fragment, null,
+        React.createElement("input", { ref: inputRef, type: "file", accept: accept, style: { display: 'none' }, onChange: handleChange }),
+        React.createElement(Button, { className: [
+                'akinon-filter__toolbar-item',
+                'akinon-filter__toolbar-item--file',
+                className
+            ]
+                .filter(Boolean)
+                .join(' '), icon: "filter", 
+            // Smaller than the icon-only toolbar buttons: the icon shares its 36px
+            // square with the label underneath it.
+            iconSize: 12, onClick: handleClick, type: "primary", title: resolvedTitle, "aria-label": resolvedTitle }, label)));
+};

package/dist/esm/components/filter-toolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter-toolbar.d.ts","sourceRoot":"","sources":["../../../src/components/filter-toolbar.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,KAAK,kBAAkB,GAAG;IACxB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACpC,CAAC;AAgDF,eAAO,MAAM,aAAa,GAAI,6EAM3B,kBAAkB,sBAoCpB,CAAC"}
+{"version":3,"file":"filter-toolbar.d.ts","sourceRoot":"","sources":["../../../src/components/filter-toolbar.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,KAAK,kBAAkB,GAAG;IACxB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,6EAM3B,kBAAkB,sBAoCpB,CAAC"}