@akinon/akifilter 1.9.1 → 1.10.0

package/dist/esm/akifilter.d.ts

@@ -90,6 +90,17 @@ export type AkifilterProps<TFieldValues extends AkifilterFieldValues = Akifilter
      * The button only renders for sections that set `enableImportXls: true`.
      */
     onSectionImportXls?: (sectionKey: string, file: File) => void;
+    /**
+     * Notified whenever a section's visible field keys change, including on the
+     * first render. Receives the section's `key` and the keys of the fields it
+     * currently renders, so one handler can serve every section.
+     *
+     * For a `selectableFields` section this is the user's selection from the
+     * section's visibility modal; any other section renders all of its fields,
+     * so it reports every field key. Keep the handler's identity stable — a new
+     * function on every render re-notifies with an unchanged list.
+     */
+    onSectionVisibleFieldsChange?: (sectionKey: string, keys: Array<Path<TFieldValues>>) => 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;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"}
+{"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;IAC9D;;;;;;;;;OASG;IACH,4BAA4B,CAAC,EAAE,CAC7B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAC5B,IAAI,CAAC;CACX,CAAC;AAu9BF,eAAO,MAAM,SAAS;KACpB,YAAY,SAAS,oBAAoB,uBAElC,cAAc,CAAC,YAAY,CAAC;;CAoBpC,CAAC"}

package/dist/esm/akifilter.js

@@ -131,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, onSectionImportCsv, onSectionImportXls }) => {
+const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onValuesChange, onVisibleFieldsChange, onImportCsv, onImportXls, onClearAll, enableImportCsv, enableImportXls, filterActionsRef, externalAppliedFilters, onRemoveExternalFilter, filterButtons, onFilterButtonsChange, onSectionImportCsv, onSectionImportXls, onSectionVisibleFieldsChange }) => {
     // Separate regular fields from section fields
     const { regularFields, sectionFields } = React.useMemo(() => partitionSchema(filterSchema), [filterSchema]);
     const excludeSectionKeys = React.useMemo(() => deriveExcludeSectionKeys(sectionFields), [sectionFields]);
@@ -308,6 +308,7 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
     const { visibleKeys, setVisibleKeys, visibleFields, openModal, modalProps } = useFieldVisibility({
         fields: regularFields,
         storageKey,
+        initialValues: mergedDefaultValues,
         onVisibleKeysChange: handleVisibleKeysChange
     });
     const normalisedValues = React.useMemo(() => normaliseOutputValues(flattenedSchema, formValues), [flattenedSchema, formValues]);
@@ -556,6 +557,7 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
     useVisibilityCleanup({
         visibleKeys,
         regularFields,
+        initialValues: mergedDefaultValues,
         onRemove: handleRemoveFilter
     });
     const handleAppliedFilterRemove = React.useCallback((key) => {
@@ -610,7 +612,7 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
             case FIELD_TYPES.CHECKBOX:
                 return React.createElement(Checkbox, { disabled: isDisabled }, field.label);
             case FIELD_TYPES.DATE:
-                return (React.createElement(DatePicker, { placeholder: field.placeholder, showTime: field.showTime, suffixIcon: "calendar", suffixIconSize: "16px", "aria-label": ariaLabel, disabled: isDisabled }));
+                return (React.createElement(DatePicker, { placeholder: field.placeholder, size: "large", showTime: field.showTime, suffixIcon: "calendar", suffixIconSize: "16px", "aria-label": ariaLabel, disabled: isDisabled }));
             case FIELD_TYPES.TEXTAREA:
                 return (React.createElement(InputTextArea, { placeholder: field.placeholder, autoSize: { minRows: 3, maxRows: 6 }, "aria-label": ariaLabel, disabled: isDisabled }));
             case FIELD_TYPES.FILE:
@@ -653,7 +655,7 @@ const AkifilterContent = ({ filterSchema, storageNamespace, defaultValues, onVal
                         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, onImportCsv: onSectionImportCsv &&
                             (file => onSectionImportCsv(String(section.key), file)), onImportXls: onSectionImportXls &&
-                            (file => onSectionImportXls(String(section.key), file)) }))))))),
+                            (file => onSectionImportXls(String(section.key), file)), onVisibleFieldsChange: onSectionVisibleFieldsChange }))))))),
             React.createElement(VisibilityModal, Object.assign({}, modalProps)))));
 };
 const AkifilterEmptyState = () => {

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

@@ -4,7 +4,6 @@ export declare const buildStorageKey: <TFieldValues extends FieldValues>(schema:
 export declare const readVisibleKeys: <TFieldValues extends FieldValues>(schema: AkifilterField<TFieldValues>[], storageKey: string) => string[] | null;
 export declare const writeVisibleKeys: (storageKey: string, keys: string[]) => void;
 export declare const buildSectionVisibilityKey: (storageKey: string, sectionKey: string | number) => string;
-export declare const clearVisibleKeys: (storageKey: string) => void;
 export declare const readStoredValues: <TFieldValues extends FieldValues>(schema: AkifilterField<TFieldValues>[], storageKey: string) => Partial<TFieldValues> | null;
 export declare const writeStoredValues: <TFieldValues extends FieldValues>(storageKey: string, values: Partial<TFieldValues>) => void;
 export declare const clearStoredValues: (storageKey: string) => void;

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;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"}
+{"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;AA0D3D,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

@@ -58,16 +58,6 @@ export const writeVisibleKeys = (storageKey, keys) => {
     }
 };
 export const buildSectionVisibilityKey = (storageKey, sectionKey) => `${storageKey}:section:${String(sectionKey)}`;
-export const clearVisibleKeys = (storageKey) => {
-    if (!isBrowser)
-        return;
-    try {
-        window.localStorage.removeItem(storageKey);
-    }
-    catch (error) {
-        console.warn(i18n.t('errors.storage.clearVisibility'), error);
-    }
-};
 const buildValuesStorageKey = (storageKey) => `${storageKey}${VALUES_SUFFIX}`;
 /**
  * Guards a persisted value against schema drift.

package/dist/esm/components/section-fieldset.d.ts

@@ -1,4 +1,4 @@
-import type { FieldValues } from '@akinon/akiform';
+import type { FieldValues, Path } from '@akinon/akiform';
 import React from 'react';
 import type { AkifilterField, AkifilterSectionField } from '../types';
 type SectionImportHandlers = {
@@ -30,6 +30,11 @@ type SectionFieldsetProps<TFieldValues extends FieldValues = FieldValues> = Sect
      * Current normalised form values, needed to resolve dynamic visibility.
      */
     formValues: Partial<TFieldValues> | undefined;
+    /**
+     * Notified with the section's key and the keys of the fields it currently
+     * renders, on mount and whenever that list changes.
+     */
+    onVisibleFieldsChange?: (sectionKey: string, keys: Array<Path<TFieldValues>>) => void;
 };
 /**
  * Renders a single section field. Sections flagged with `selectableFields`

package/dist/esm/components/section-fieldset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"section-fieldset.d.ts","sourceRoot":"","sources":["../../../src/components/section-fieldset.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AA+CtE,KAAK,qBAAqB,GAAG;IAC3B;;;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;CACpC,CAAC;AA8JF,KAAK,oBAAoB,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IACtE,qBAAqB,GAAG;IACtB,OAAO,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAC7C;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,YAAY,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1E;;;OAGG;IACH,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;CAC/C,CAAC;AAiHJ;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,GAAG,WAAW,EAC5E,OAAO,oBAAoB,CAAC,YAAY,CAAC,sBAO1C,CAAC"}
+{"version":3,"file":"section-fieldset.d.ts","sourceRoot":"","sources":["../../../src/components/section-fieldset.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAMzD,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AA+CtE,KAAK,qBAAqB,GAAG;IAC3B;;;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;CACpC,CAAC;AA8JF,KAAK,oBAAoB,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IACtE,qBAAqB,GAAG;IACtB,OAAO,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAC7C;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,YAAY,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1E;;;OAGG;IACH,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IAC9C;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAC5B,IAAI,CAAC;CACX,CAAC;AAkJJ;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,SAAS,WAAW,GAAG,WAAW,EAC5E,OAAO,oBAAoB,CAAC,YAAY,CAAC,sBAO1C,CAAC"}

package/dist/esm/components/section-fieldset.js

@@ -2,6 +2,7 @@ import { Icon } from '@akinon/icons';
 import { Button } from '@akinon/ui-button';
 import { Collapse } from '@akinon/ui-collapse';
 import { Title } from '@akinon/ui-typography';
+import { isEqual } from 'lodash-es';
 import React from 'react';
 import { buildSectionVisibilityKey } from '../common/storage';
 import { CSV_ACCEPT, XLS_ACCEPT } from '../constants';
@@ -108,11 +109,16 @@ const SectionActionsCollapse = ({ sectionKey, label, defaultExpanded, actions, i
  * mirroring the top-level filter field-selection behaviour. Import buttons are
  * rendered alongside the funnel when the section opts into them.
  */
-const SelectableSectionFieldset = ({ section, storageKey, renderFormField, onRemoveField, formValues, onImportCsv, onImportXls }) => {
+const SelectableSectionFieldset = ({ section, storageKey, renderFormField, onRemoveField, formValues, onImportCsv, onImportXls, onVisibleFieldsChange }) => {
     const sectionStorageKey = React.useMemo(() => buildSectionVisibilityKey(storageKey, section.key), [storageKey, section.key]);
+    const handleVisibleKeysChange = React.useCallback((keys) => {
+        onVisibleFieldsChange === null || onVisibleFieldsChange === void 0 ? void 0 : onVisibleFieldsChange(String(section.key), keys);
+    }, [onVisibleFieldsChange, section.key]);
     const { visibleKeys, setVisibleKeys, visibleFields, openModal, modalProps } = useFieldVisibility({
         fields: section.fields,
-        storageKey: sectionStorageKey
+        storageKey: sectionStorageKey,
+        initialValues: formValues,
+        onVisibleKeysChange: handleVisibleKeysChange
     });
     useDynamicVisibility({
         regularFields: section.fields,
@@ -122,6 +128,7 @@ const SelectableSectionFieldset = ({ section, storageKey, renderFormField, onRem
     useVisibilityCleanup({
         visibleKeys,
         regularFields: section.fields,
+        initialValues: formValues,
         onRemove: onRemoveField
     });
     const actions = resolveSectionHeaderActions({
@@ -138,7 +145,15 @@ const SelectableSectionFieldset = ({ section, storageKey, renderFormField, onRem
  * A section that always renders every one of its fields. Falls back to the
  * plain collapse markup unless the header needs action buttons (e.g. import).
  */
-const PlainSectionFieldset = ({ section, renderFormField, onImportCsv, onImportXls }) => {
+const PlainSectionFieldset = ({ section, renderFormField, onImportCsv, onImportXls, onVisibleFieldsChange }) => {
+    const [fieldKeys, setFieldKeys] = React.useState(() => section.fields.map(field => String(field.key)));
+    React.useEffect(() => {
+        const nextFieldKeys = section.fields.map(field => String(field.key));
+        setFieldKeys(previous => isEqual(previous, nextFieldKeys) ? previous : nextFieldKeys);
+    }, [section.fields]);
+    React.useEffect(() => {
+        onVisibleFieldsChange === null || onVisibleFieldsChange === void 0 ? void 0 : onVisibleFieldsChange(String(section.key), fieldKeys);
+    }, [fieldKeys, onVisibleFieldsChange, section.key]);
     const actions = resolveSectionHeaderActions({
         section,
         onImportCsv,

package/dist/esm/hooks/use-field-visibility.d.ts

@@ -12,6 +12,12 @@ type UseFieldVisibilityParams<TFieldValues extends FieldValues> = {
      * pass distinct keys per group so selections never collide.
      */
     storageKey: string;
+    /**
+     * Form values as of the first render. A `config.visible` function is resolved
+     * against these, so a field whose visibility depends on a restored value is
+     * visible from the very first render instead of appearing one commit later.
+     */
+    initialValues?: Partial<TFieldValues>;
     /**
      * Notified whenever the resolved visible keys change.
      */
@@ -22,7 +28,7 @@ type UseFieldVisibilityParams<TFieldValues extends FieldValues> = {
  * a single group of fields. Used both for the top-level filters and for each
  * selectable section so the two share one implementation.
  */
-export declare const useFieldVisibility: <TFieldValues extends FieldValues = FieldValues>({ fields, storageKey, onVisibleKeysChange }: UseFieldVisibilityParams<TFieldValues>) => {
+export declare const useFieldVisibility: <TFieldValues extends FieldValues = FieldValues>({ fields, storageKey, initialValues, onVisibleKeysChange }: UseFieldVisibilityParams<TFieldValues>) => {
     visibleKeys: string[];
     setVisibleKeys: React.Dispatch<React.SetStateAction<string[]>>;
     visibleFields: import("../types").AkifilterField<TFieldValues>[];

package/dist/esm/hooks/use-field-visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-field-visibility.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-field-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAOhD,KAAK,wBAAwB,CAAC,YAAY,SAAS,WAAW,IAAI;IAChE;;;OAGG;IACH,MAAM,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IACtC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,6CAIC,wBAAwB,CAAC,YAAY,CAAC;;;;;;;;;;;;oCA0HP,MAAM;kCA3D9B,MAAM;mCAgEiB,MAAM,YAAY,MAAM;;;;CA6BxD,CAAC"}
+{"version":3,"file":"use-field-visibility.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-field-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAQhD,KAAK,wBAAwB,CAAC,YAAY,SAAS,WAAW,IAAI;IAChE;;;OAGG;IACH,MAAM,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IACtC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACtC;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,4DAKC,wBAAwB,CAAC,YAAY,CAAC;;;;;;;;;;;;oCAsIP,MAAM;kCA7D9B,MAAM;mCAkEiB,MAAM,YAAY,MAAM;;;;CA6BxD,CAAC"}

package/dist/esm/hooks/use-field-visibility.js

@@ -1,32 +1,32 @@
+import { isEqual } from 'lodash-es';
 import React from 'react';
 import { readVisibleKeys, writeVisibleKeys } from '../common/storage';
 import { DEFAULT_MODAL_PAGE_SIZE } from '../constants';
-import { deriveDefaultVisibleKeys, ensureSchemaOrder, resolveFieldVisibility } from '../utils/schema';
+import { deriveDefaultVisibleKeys, ensureSchemaOrder, hasDynamicVisibility, resolveFieldVisibility } from '../utils/schema';
 /**
  * Encapsulates the visible-field selection and its accompanying modal state for
  * a single group of fields. Used both for the top-level filters and for each
  * selectable section so the two share one implementation.
  */
-export const useFieldVisibility = ({ fields, storageKey, onVisibleKeysChange }) => {
+export const useFieldVisibility = ({ fields, storageKey, initialValues, onVisibleKeysChange }) => {
+    const initialValuesRef = React.useRef(initialValues);
     const [isModalOpen, setIsModalOpen] = React.useState(false);
     const [searchTerm, setSearchTerm] = React.useState('');
     const [modalPage, setModalPage] = React.useState(1);
     const [modalPageSize, setModalPageSize] = React.useState(DEFAULT_MODAL_PAGE_SIZE);
     const resolveInitialVisibleKeys = React.useCallback(() => {
         const storedKeys = readVisibleKeys(fields, storageKey);
-        const defaultKeys = deriveDefaultVisibleKeys(fields);
         const baseKeys = storedKeys && storedKeys.length > 0
             ? ensureSchemaOrder(fields, storedKeys)
-            : defaultKeys;
+            : deriveDefaultVisibleKeys(fields);
         return fields.reduce((acc, field) => {
             const key = String(field.key);
-            const explicitVisibility = resolveFieldVisibility(field);
-            if (explicitVisibility !== undefined) {
-                if (explicitVisibility)
+            if (hasDynamicVisibility(field)) {
+                const visibility = resolveFieldVisibility(field, initialValuesRef.current);
+                if (visibility)
                     acc.push(key);
                 return acc;
             }
-            // No explicit boolean visibility, use stored/default
             if (baseKeys.includes(key)) {
                 acc.push(key);
             }
@@ -38,13 +38,20 @@ export const useFieldVisibility = ({ fields, storageKey, onVisibleKeysChange })
         setVisibleKeys(previous => {
             const ordered = ensureSchemaOrder(fields, previous);
             if (ordered.length) {
-                return ordered;
+                return isEqual(ordered, previous) ? previous : ordered;
             }
             return resolveInitialVisibleKeys();
         });
     }, [fields, resolveInitialVisibleKeys]);
+    // Only a real toggle is persisted. Writing the derived set on mount would
+    // make every user look like they had made a choice, and the storage key is
+    // hashed from the field signature alone — so a later `config.visible` change
+    // would never reach anyone who had simply rendered the filter once.
+    const hasUserSelectionRef = React.useRef(false);
     React.useEffect(() => {
-        writeVisibleKeys(storageKey, visibleKeys);
+        if (hasUserSelectionRef.current) {
+            writeVisibleKeys(storageKey, visibleKeys);
+        }
         onVisibleKeysChange === null || onVisibleKeysChange === void 0 ? void 0 : onVisibleKeysChange(visibleKeys);
     }, [visibleKeys, onVisibleKeysChange, storageKey]);
     const openModal = React.useCallback(() => {
@@ -56,6 +63,7 @@ export const useFieldVisibility = ({ fields, storageKey, onVisibleKeysChange })
         setIsModalOpen(false);
     }, []);
     const handleToggleVisibility = React.useCallback((key) => {
+        hasUserSelectionRef.current = true;
         setVisibleKeys(prev => {
             const exists = prev.includes(key);
             if (exists && prev.length === 1) {

package/dist/esm/hooks/use-visibility-cleanup.d.ts

@@ -2,12 +2,19 @@ import type { FieldValues } from '@akinon/akiform';
 import type { AkifilterSchema } from '../types';
 /**
  * Cleans up form values when fields become hidden.
- * On first render, clears fields explicitly marked as invisible.
- * On subsequent renders, clears fields that were removed from visibleKeys.
+ * On first render, clears fields resolving to `visible: false` that the user
+ * has not turned back on. On subsequent renders, clears fields that were
+ * removed from visibleKeys.
  */
-export declare const useVisibilityCleanup: <TFieldValues extends FieldValues = FieldValues>({ visibleKeys, regularFields, onRemove }: {
+export declare const useVisibilityCleanup: <TFieldValues extends FieldValues = FieldValues>({ visibleKeys, regularFields, initialValues, onRemove }: {
     visibleKeys: string[];
     regularFields: AkifilterSchema<TFieldValues>;
+    /**
+     * Form values as of the first render, so a `config.visible` function is
+     * resolved against restored values rather than an empty object — otherwise
+     * the value that makes the field visible is the one this hook deletes.
+     */
+    initialValues?: Partial<TFieldValues>;
     onRemove: (key: string) => void;
 }) => void;
 //# sourceMappingURL=use-visibility-cleanup.d.ts.map

package/dist/esm/hooks/use-visibility-cleanup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-visibility-cleanup.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-visibility-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA+BhD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,0CAIC;IACD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC7C,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,SAcA,CAAC"}
+{"version":3,"file":"use-visibility-cleanup.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-visibility-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAoChD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,yDAKC;IACD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC7C;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACtC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,SAgBA,CAAC"}

package/dist/esm/hooks/use-visibility-cleanup.js

@@ -1,34 +1,38 @@
 import { isEqual } from 'lodash-es';
 import { useEffect, useRef } from 'react';
 import { resolveFieldVisibility } from '../utils/schema';
-const getInitialKeysToClean = (fields) => fields
-    .filter(field => resolveFieldVisibility(field) === false)
-    .map(field => String(field.key));
+const getInitialKeysToClean = (fields, visibleKeys, formValues) => fields
+    .filter(field => resolveFieldVisibility(field, formValues) === false)
+    .map(field => String(field.key))
+    .filter(key => !visibleKeys.includes(key));
 const getRemovedKeys = (prev, current) => prev.filter(key => !current.includes(key));
 const cleanupKeys = (keys, onRemove) => {
     keys.forEach(key => onRemove(key));
 };
-const resolveKeysToClean = ({ prev, current, fields }) => {
+const resolveKeysToClean = ({ prev, current, fields, formValues }) => {
     if (prev === null)
-        return getInitialKeysToClean(fields);
+        return getInitialKeysToClean(fields, current, formValues);
     if (isEqual(prev, current))
         return [];
     return getRemovedKeys(prev, current);
 };
 /**
  * Cleans up form values when fields become hidden.
- * On first render, clears fields explicitly marked as invisible.
- * On subsequent renders, clears fields that were removed from visibleKeys.
+ * On first render, clears fields resolving to `visible: false` that the user
+ * has not turned back on. On subsequent renders, clears fields that were
+ * removed from visibleKeys.
  */
-export const useVisibilityCleanup = ({ visibleKeys, regularFields, onRemove }) => {
+export const useVisibilityCleanup = ({ visibleKeys, regularFields, initialValues, onRemove }) => {
     const previousVisibleKeysRef = useRef(null);
+    const initialValuesRef = useRef(initialValues);
     useEffect(() => {
         const prev = previousVisibleKeysRef.current;
         previousVisibleKeysRef.current = visibleKeys;
         const keysToClean = resolveKeysToClean({
             prev,
             current: visibleKeys,
-            fields: regularFields
+            fields: regularFields,
+            formValues: initialValuesRef.current
         });
         cleanupKeys(keysToClean, onRemove);
     }, [visibleKeys, onRemove, regularFields]);

package/dist/esm/i18n/translations/en.d.ts

@@ -40,7 +40,6 @@ declare const translations: {
         readonly storage: {
             readonly readVisibility: "Akifilter: unable to read visibility state from storage";
             readonly writeVisibility: "Akifilter: unable to persist visibility state";
-            readonly clearVisibility: "Akifilter: unable to clear visibility state";
             readonly readValues: "Akifilter: unable to read values from storage";
             readonly writeValues: "Akifilter: unable to persist values";
             readonly clearValues: "Akifilter: unable to clear stored values";

package/dist/esm/i18n/translations/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../../src/i18n/translations/en.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDR,CAAC;AAEX,eAAe,YAAY,CAAC"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../../src/i18n/translations/en.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDR,CAAC;AAEX,eAAe,YAAY,CAAC"}

package/dist/esm/i18n/translations/en.js

@@ -40,7 +40,6 @@ const translations = {
         storage: {
             readVisibility: 'Akifilter: unable to read visibility state from storage',
             writeVisibility: 'Akifilter: unable to persist visibility state',
-            clearVisibility: 'Akifilter: unable to clear visibility state',
             readValues: 'Akifilter: unable to read values from storage',
             writeValues: 'Akifilter: unable to persist values',
             clearValues: 'Akifilter: unable to clear stored values',

package/dist/esm/i18n/translations/tr.d.ts

@@ -40,7 +40,6 @@ declare const translations: {
         readonly storage: {
             readonly readVisibility: "Akifilter: görünürlük durumu depodan okunamadı";
             readonly writeVisibility: "Akifilter: görünürlük durumu kalıcı hale getirilemedi";
-            readonly clearVisibility: "Akifilter: görünürlük durumu temizlenemedi";
             readonly readValues: "Akifilter: değerler depodan okunamadı";
             readonly writeValues: "Akifilter: değerler kalıcı hale getirilemedi";
             readonly clearValues: "Akifilter: kayıtlı değerler temizlenemedi";

package/dist/esm/i18n/translations/tr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["../../../../src/i18n/translations/tr.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDR,CAAC;AAEX,eAAe,YAAY,CAAC"}
+{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["../../../../src/i18n/translations/tr.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDR,CAAC;AAEX,eAAe,YAAY,CAAC"}

package/dist/esm/i18n/translations/tr.js

@@ -40,7 +40,6 @@ const translations = {
         storage: {
             readVisibility: 'Akifilter: görünürlük durumu depodan okunamadı',
             writeVisibility: 'Akifilter: görünürlük durumu kalıcı hale getirilemedi',
-            clearVisibility: 'Akifilter: görünürlük durumu temizlenemedi',
             readValues: 'Akifilter: değerler depodan okunamadı',
             writeValues: 'Akifilter: değerler kalıcı hale getirilemedi',
             clearValues: 'Akifilter: kayıtlı değerler temizlenemedi',

package/dist/esm/types.d.ts

@@ -9,7 +9,15 @@ export interface AkifilterFieldConfig<TFieldValues extends FieldValues = FieldVa
     disabled?: boolean | ((formValues: TFieldValues) => boolean);
     /**
      * Controls whether the field is visible.
-     * Can be a boolean or a function that receives form values and returns a boolean.
+     *
+     * A boolean seeds the first render only: it decides whether the field is part
+     * of the default visible set, and from then on the user's selection in the
+     * "Select visible filters" modal wins and is restored on every later mount.
+     *
+     * A function is dynamic and stays authoritative: it is re-evaluated on every
+     * form value change and receives the field's current visibility. A constant
+     * function (`() => true`) is therefore how a field opts out of the picker
+     * altogether.
      */
     visible?: boolean | ((formValues: TFieldValues, currentVisible?: boolean) => boolean);
 }
@@ -106,14 +114,14 @@ type AkifilterFieldExtras<TFieldValues extends FieldValues = FieldValues> = {
     /**
      * Overrides `label` for this field's applied-filter chip only.
      *
-     * The form input and the "select visible filters" modal keep using `label`.
+     * 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"
+     * 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

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

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

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

@@ -30,8 +30,14 @@ export declare const ensureSchemaOrder: <TFieldValues extends FieldValues = Fiel
  * Resolves the visibility of a field.
  */
 export declare const resolveFieldVisibility: <TFieldValues extends FieldValues = FieldValues>(field: AkifilterField<TFieldValues>, formValues?: TFieldValues, currentVisible?: boolean) => boolean | undefined;
+export declare const hasDynamicVisibility: <TFieldValues extends FieldValues>(field: AkifilterField<TFieldValues>) => boolean;
+/**
+ * The visible set of a first render: the fields statically marked
+ * `config.visible: true` if the schema marks any, otherwise the first
+ * `DEFAULT_VISIBLE_COUNT` fields. Fields with a dynamic `config.visible` take
+ * no part in it.
+ */
 export declare const deriveDefaultVisibleKeys: <TFieldValues extends FieldValues = FieldValues>(schema: AkifilterSchema<TFieldValues>) => string[];
 export declare const extractDefaultValues: <TFieldValues extends FieldValues = FieldValues>(schema: AkifilterSchema<TFieldValues>) => Partial<TFieldValues>;
-export declare const hasDynamicVisibility: <TFieldValues extends FieldValues>(field: AkifilterField<TFieldValues>) => boolean;
 export declare const normaliseValuesBySchema: <TFieldValues extends FieldValues = FieldValues>(schema: AkifilterSchema<TFieldValues>, values?: Partial<TFieldValues>) => Partial<TFieldValues>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/esm/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;;;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"}
+{"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,oBAAoB,GAAI,YAAY,SAAS,WAAW,EACnE,OAAO,cAAc,CAAC,YAAY,CAAC,KAClC,OAA4C,CAAC;AAsChD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,YAAY,SAAS,WAAW,GAAG,WAAW,EAE9C,QAAQ,eAAe,CAAC,YAAY,CAAC,KACpC,MAAM,EAMR,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,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/esm/utils/schema.js

@@ -67,14 +67,39 @@ const resolveVisibilityValue = (value, formValues, currentVisible) => {
  * Resolves the visibility of a field.
  */
 export const resolveFieldVisibility = (field, formValues, currentVisible) => { var _a; return resolveVisibilityValue((_a = field.config) === null || _a === void 0 ? void 0 : _a.visible, formValues, currentVisible); };
+export const hasDynamicVisibility = (field) => { var _a; return isFunction((_a = field.config) === null || _a === void 0 ? void 0 : _a.visible); };
+/*
+ * Both helpers below skip fields with a dynamic `config.visible`. Such a field
+ * declares nothing about the default set: `useFieldVisibility` resolves it from
+ * its own function and never consults the default set for it. Resolving the
+ * function here would only mean asking it the wrong question — its answer is
+ * "am I visible for these values", not "am I part of the default set" — and a
+ * `() => true` field would silently switch the whole schema to the explicit
+ * branch, dropping the fallback for every other field.
+ */
+const explicitVisibleKeys = (schema) => schema
+    .filter(field => !hasDynamicVisibility(field) && resolveFieldVisibility(field) === true)
+    .map(field => String(field.key));
+/**
+ * The first `DEFAULT_VISIBLE_COUNT` fields, minus the ones asking to be hidden.
+ * `config.visible: false` never reaches the picker's initial selection, so the
+ * fallback has to drop those keys itself.
+ */
+const fallbackVisibleKeys = (schema) => schema
+    .slice(0, DEFAULT_VISIBLE_COUNT)
+    .filter(field => !hasDynamicVisibility(field) && resolveFieldVisibility(field) !== false)
+    .map(field => String(field.key));
+/**
+ * The visible set of a first render: the fields statically marked
+ * `config.visible: true` if the schema marks any, otherwise the first
+ * `DEFAULT_VISIBLE_COUNT` fields. Fields with a dynamic `config.visible` take
+ * no part in it.
+ */
 export const deriveDefaultVisibleKeys = (schema) => {
-    const explicitKeys = schema
-        .filter(field => resolveFieldVisibility(field) === true)
-        .map(field => String(field.key));
-    if (explicitKeys.length > 0) {
-        return ensureSchemaOrder(schema, explicitKeys);
-    }
-    return schema.slice(0, DEFAULT_VISIBLE_COUNT).map(field => String(field.key));
+    const explicitKeys = explicitVisibleKeys(schema);
+    return explicitKeys.length > 0
+        ? ensureSchemaOrder(schema, explicitKeys)
+        : fallbackVisibleKeys(schema);
 };
 export const extractDefaultValues = (schema) => {
     return schema.reduce((acc, field) => {
@@ -85,7 +110,6 @@ export const extractDefaultValues = (schema) => {
         return acc;
     }, {});
 };
-export const hasDynamicVisibility = (field) => { var _a; return isFunction((_a = field.config) === null || _a === void 0 ? void 0 : _a.visible); };
 export const normaliseValuesBySchema = (schema, values) => {
     if (!values) {
         return {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akinon/akifilter",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "private": false,
   "description": "Akifilter is a filtering library for Akinon frontend applications.",
   "type": "module",
@@ -15,21 +15,21 @@
     "lodash-es": "^4.17.21",
     "@akinon/akiform": "1.1.9",
     "@akinon/akidate": "1.2.7",
-    "@akinon/akilocale": "1.2.8",
     "@akinon/icons": "1.5.0",
-    "@akinon/ui-button": "1.5.5",
-    "@akinon/ui-card": "1.2.10",
-    "@akinon/ui-checkbox": "1.4.10",
+    "@akinon/akilocale": "1.2.8",
+    "@akinon/ui-button": "1.5.6",
+    "@akinon/ui-card": "1.2.11",
+    "@akinon/ui-checkbox": "1.4.11",
     "@akinon/ui-collapse": "1.4.8",
-    "@akinon/ui-date-picker": "1.5.5",
-    "@akinon/ui-input": "1.2.10",
-    "@akinon/ui-input-number": "1.4.10",
-    "@akinon/ui-modal": "1.2.11",
-    "@akinon/ui-pagination": "1.4.16",
-    "@akinon/ui-select": "1.4.16",
-    "@akinon/ui-space": "1.4.10",
+    "@akinon/ui-date-picker": "1.5.6",
+    "@akinon/ui-input": "1.2.11",
+    "@akinon/ui-input-number": "1.4.11",
+    "@akinon/ui-modal": "1.2.12",
+    "@akinon/ui-pagination": "1.4.17",
+    "@akinon/ui-select": "1.4.17",
+    "@akinon/ui-space": "1.4.11",
     "@akinon/ui-typography": "1.2.7",
-    "@akinon/ui-upload": "1.6.2"
+    "@akinon/ui-upload": "1.6.3"
   },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",
@@ -37,11 +37,11 @@
     "copyfiles": "^2.4.1",
     "rimraf": "^5.0.5",
     "typescript": "*",
-    "@akinon/akiform-builder": "1.8.1",
+    "@akinon/akiform-builder": "1.8.2",
     "@akinon/typescript-config": "1.1.8",
-    "@akinon/utils": "1.2.11",
-    "@akinon/ui-theme": "1.3.1",
-    "@akinon/vitest-config": "1.1.8"
+    "@akinon/ui-theme": "1.3.2",
+    "@akinon/vitest-config": "1.1.8",
+    "@akinon/utils": "1.2.12"
   },
   "peerDependencies": {
     "react": "^18 || ^19",