@timeax/form-palette 0.1.3 → 0.1.5

package/dist/{core-BD0ObjuE.d.mts → core-EVtvQ-ma.d.mts}

@@ -2226,6 +2226,12 @@ declare function Badge({ className, variant, asChild, ...props }: React.Componen
 }): react_jsx_runtime.JSX.Element;
 
 type FileSourceKind = "native" | "path" | "url" | "custom";
+/**
+ * ✅ What the form receives on submit:
+ * - native picker -> File
+ * - custom pickers -> string (url/path)
+ */
+type FileValue = File | string;
 interface FileItem {
     id: string;
     kind: FileSourceKind;
@@ -2259,8 +2265,7 @@ type CustomFileLoader = (ctx: {
     allowedTypes?: string[];
 }) => Promise<CustomFileLoaderResult> | CustomFileLoaderResult;
 type BadgeVariant = React.ComponentProps<typeof Badge>["variant"];
-type FileVariantBaseProps = Pick<VariantBaseProps<FileItem[]>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> & {
-    multiple?: boolean;
+type FileVariantExtras = {
     accept?: string | string[];
     maxFiles?: number;
     maxTotalSize?: number;
@@ -2269,6 +2274,10 @@ type FileVariantBaseProps = Pick<VariantBaseProps<FileItem[]>, "value" | "onValu
     dropTitle?: React.ReactNode;
     dropDescription?: React.ReactNode;
     custom?: boolean;
+    /**
+     * Kept for compatibility; we now always submit File|string.
+     * (Raw FileItem[] is available in ChangeDetail.meta.items)
+     */
     asRaw?: boolean;
     renderDropArea?: (ctx: {
         openPicker: () => void;
@@ -2295,6 +2304,20 @@ type FileVariantBaseProps = Pick<VariantBaseProps<FileItem[]>, "value" | "onValu
     listClassName?: string;
     triggerClassName?: string;
 };
+type FileSingleValueProps = Omit<VariantBaseProps<FileValue | null>, "value"> & {
+    multiple?: false;
+    /**
+     * Accepts File | string | FileLike-object (url/path/file/name/etc)
+     */
+    value?: FileLike | null;
+};
+type FileMultiValueProps = Omit<VariantBaseProps<FileValue[]>, "value"> & {
+    multiple: true;
+    /**
+     * Accepts (File | string | FileLike-object)[]
+     */
+    value?: FileLike[] | null;
+};
 type FileDefaultModeProps = {
     mode?: "default";
     leadingIcons?: React.ReactNode[];
@@ -2341,7 +2364,7 @@ type FileButtonModeProps = {
     joinControls?: never;
     extendBoxToControls?: never;
 };
-type ShadcnFileVariantProps = FileVariantBaseProps & (FileDefaultModeProps | FileButtonModeProps);
+type ShadcnFileVariantProps = FileVariantExtras & (FileSingleValueProps | FileMultiValueProps) & (FileDefaultModeProps | FileButtonModeProps);
 
 type SelectPrimitive = string | number;
 type SelectOption = SelectPrimitive | {
@@ -3059,6 +3082,7 @@ type ListerPermissionCtx = {
     endpoint?: string;
     filters?: any;
     sessionId?: ListerSessionId;
+    ownerKey?: string;
 };
 interface ListerProviderHost {
     /** Host decides permission logic. Mandatory permissions end with '!' */
@@ -3142,6 +3166,7 @@ type ListerSearchSpec<TColumn extends string = string> = {
 type ListerDefinition<TRaw, TValue extends ListerId, TFilters = unknown, TMeta = unknown, TCtx = any, TSearchColumn extends string = string> = {
     /** optional stable id used by presets */
     id?: string;
+    title?: string;
     source: ListerSource<TFilters>;
     /** If missing: default extraction uses body.data (runtime). Must produce an array. */
     selector?: Selector<TRaw>;
@@ -3326,6 +3351,7 @@ type ListerOpenOptions<TRaw, TValue extends ListerId, TFilters, TMeta, TMode ext
     }) => any;
     /** Live change hook (sync + veto) */
     onChange?: (value: ListerValueForMode<TValue, TMode>, details: ListerDetails<TRaw, TValue, TMeta, TMode>, e: ListerChangeEvent) => void;
+    ownerKey?: string;
 };
 type ListerOpenResult<TRaw, TValue extends ListerId, TMeta, TMode extends ListerMode> = {
     reason: ListerOpenReason;
@@ -3418,6 +3444,7 @@ type ListerRuntimeState<TRaw, TValue extends ListerId, TFilters, TMeta, TMode ex
     searchSpec?: ListerSearchSpec<string>;
     /** Persisted user selection (subject/all/only) */
     searchTarget?: ListerSearchTarget;
+    ownerKey?: string;
 };
 type ListerStoreState = {
     /** rendering order (last = topmost) */
@@ -4353,4 +4380,4 @@ interface CoreContext<V extends Dict> {
     isDirty(): boolean;
 }
 
-export { type ListerSearchMode as $, type LayoutResolveContext as A, type BaseProps as B, type CoreProps as C, type Dict as D, type ErrorTextPlacement as E, type Field as F, type LayoutResolver as G, type HelpTextPlacement as H, InputNumber as I, type VariantEntry as J, type Variants as K, type LabelPlacement as L, type VariantValidateFn as M, type VariantLayoutDefaults as N, type VariantModuleFor as O, type PhoneCountry as P, type ListerDefinition as Q, type RelativeRootsMap as R, type SublabelPlacement as S, Textarea as T, type ListerRuntimeState as U, type VariantKey as V, type ListerProviderHost as W, type PresetMap as X, type ListerStoreState as Y, type ListerSessionId as Z, type ListerId as _, type CoreContext as a, type ListerSearchTarget as a0, type ListerSearchPayload as a1, type ListerFilterCtx as a2, type ListerFilterOption as a3, type ListerMode as a4, type ListerApi as a5, type ShadcnJsonEditorProps as a6, type JsonEditorIndexHandle as a7, type ListerOpenReason as a8, type Selector as a9, type PresetValue as aA, type PresetFilters as aB, type PresetMeta as aC, type ListerSessionState as aD, type Resolver as aa, type OpenAnchor as ab, type ListerChangeEvent as ac, type ListerLogLevel as ad, type ListerLogCode as ae, type ListerLogEntry as af, type ListerPermissionCtx as ag, type ListerOption as ah, type ListerMapping as ai, type ListerSource as aj, type ListerSearchSpec as ak, type ListerFilterApplyMode as al, type ListerFilterApply as am, type ListerFilterBindKey as an, type ListerFilterInput as ao, type ListerFilterGroupOption as ap, type ListerFilterValueOption as aq, type ListerFilterInputOption as ar, type ListerFilterSpec as as, type ListerValueForMode as at, type ListerRawForMode as au, type ListerOptionsForMode as av, type ListerDetails as aw, type ListerOpenOptions as ax, type ListerOpenResult as ay, type PresetRaw as az, type DescriptionPlacement as b, type SlotPlacement as c, type FieldSize as d, type FieldDensity as e, type ValidateResult as f, type ChangeDetail as g, type VariantValueFor as h, type VariantPropsFor as i, type VariantModule as j, type PasswordDefinitionMap as k, type CustomFileLoader as l, type FileItem as m, type InferFromSchema as n, type SubmitEvent as o, type FormProps as p, type ValuesResult as q, type InputStore as r, type ButtonRef as s, type FieldSlots as t, type FieldRoots as u, type FieldSlotId as v, type FieldRootId as w, type FieldOrdering as x, type FieldLayoutConfig as y, type EffectiveFieldLayout as z };
+export { type ListerSessionId as $, type LayoutResolveContext as A, type BaseProps as B, type CoreProps as C, type Dict as D, type ErrorTextPlacement as E, type Field as F, type LayoutResolver as G, type HelpTextPlacement as H, InputNumber as I, type VariantEntry as J, type Variants as K, type LabelPlacement as L, type VariantValidateFn as M, type VariantLayoutDefaults as N, type VariantModuleFor as O, type PhoneCountry as P, type ListerSearchPayload as Q, type RelativeRootsMap as R, type SublabelPlacement as S, Textarea as T, type ListerId as U, type VariantKey as V, type ListerDefinition as W, type ListerOption as X, type PresetMap as Y, type ListerApi as Z, type ListerStoreState as _, type CoreContext as a, type ListerSearchTarget as a0, type ListerSearchMode as a1, type ListerFilterCtx as a2, type ListerDetails as a3, type ListerProviderHost as a4, type ListerRuntimeState as a5, type ShadcnJsonEditorProps as a6, type JsonEditorIndexHandle as a7, type ListerMode as a8, type ListerOpenReason as a9, type PresetValue as aA, type PresetFilters as aB, type PresetMeta as aC, type ListerSessionState as aD, type Selector as aa, type Resolver as ab, type OpenAnchor as ac, type ListerChangeEvent as ad, type ListerLogLevel as ae, type ListerLogCode as af, type ListerLogEntry as ag, type ListerPermissionCtx as ah, type ListerMapping as ai, type ListerSource as aj, type ListerSearchSpec as ak, type ListerFilterApplyMode as al, type ListerFilterApply as am, type ListerFilterBindKey as an, type ListerFilterInput as ao, type ListerFilterGroupOption as ap, type ListerFilterValueOption as aq, type ListerFilterInputOption as ar, type ListerFilterOption as as, type ListerFilterSpec as at, type ListerValueForMode as au, type ListerRawForMode as av, type ListerOptionsForMode as aw, type ListerOpenOptions as ax, type ListerOpenResult as ay, type PresetRaw as az, type DescriptionPlacement as b, type SlotPlacement as c, type FieldSize as d, type FieldDensity as e, type ValidateResult as f, type ChangeDetail as g, type VariantValueFor as h, type VariantPropsFor as i, type VariantModule as j, type PasswordDefinitionMap as k, type CustomFileLoader as l, type FileItem as m, type InferFromSchema as n, type SubmitEvent as o, type FormProps as p, type ValuesResult as q, type InputStore as r, type ButtonRef as s, type FieldSlots as t, type FieldRoots as u, type FieldSlotId as v, type FieldRootId as w, type FieldOrdering as x, type FieldLayoutConfig as y, type EffectiveFieldLayout as z };

package/dist/{core-q_p0E4W9.d.ts → core-ZuVzbe2m.d.ts}

@@ -2226,6 +2226,12 @@ declare function Badge({ className, variant, asChild, ...props }: React.Componen
 }): react_jsx_runtime.JSX.Element;
 
 type FileSourceKind = "native" | "path" | "url" | "custom";
+/**
+ * ✅ What the form receives on submit:
+ * - native picker -> File
+ * - custom pickers -> string (url/path)
+ */
+type FileValue = File | string;
 interface FileItem {
     id: string;
     kind: FileSourceKind;
@@ -2259,8 +2265,7 @@ type CustomFileLoader = (ctx: {
     allowedTypes?: string[];
 }) => Promise<CustomFileLoaderResult> | CustomFileLoaderResult;
 type BadgeVariant = React.ComponentProps<typeof Badge>["variant"];
-type FileVariantBaseProps = Pick<VariantBaseProps<FileItem[]>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> & {
-    multiple?: boolean;
+type FileVariantExtras = {
     accept?: string | string[];
     maxFiles?: number;
     maxTotalSize?: number;
@@ -2269,6 +2274,10 @@ type FileVariantBaseProps = Pick<VariantBaseProps<FileItem[]>, "value" | "onValu
     dropTitle?: React.ReactNode;
     dropDescription?: React.ReactNode;
     custom?: boolean;
+    /**
+     * Kept for compatibility; we now always submit File|string.
+     * (Raw FileItem[] is available in ChangeDetail.meta.items)
+     */
     asRaw?: boolean;
     renderDropArea?: (ctx: {
         openPicker: () => void;
@@ -2295,6 +2304,20 @@ type FileVariantBaseProps = Pick<VariantBaseProps<FileItem[]>, "value" | "onValu
     listClassName?: string;
     triggerClassName?: string;
 };
+type FileSingleValueProps = Omit<VariantBaseProps<FileValue | null>, "value"> & {
+    multiple?: false;
+    /**
+     * Accepts File | string | FileLike-object (url/path/file/name/etc)
+     */
+    value?: FileLike | null;
+};
+type FileMultiValueProps = Omit<VariantBaseProps<FileValue[]>, "value"> & {
+    multiple: true;
+    /**
+     * Accepts (File | string | FileLike-object)[]
+     */
+    value?: FileLike[] | null;
+};
 type FileDefaultModeProps = {
     mode?: "default";
     leadingIcons?: React.ReactNode[];
@@ -2341,7 +2364,7 @@ type FileButtonModeProps = {
     joinControls?: never;
     extendBoxToControls?: never;
 };
-type ShadcnFileVariantProps = FileVariantBaseProps & (FileDefaultModeProps | FileButtonModeProps);
+type ShadcnFileVariantProps = FileVariantExtras & (FileSingleValueProps | FileMultiValueProps) & (FileDefaultModeProps | FileButtonModeProps);
 
 type SelectPrimitive = string | number;
 type SelectOption = SelectPrimitive | {
@@ -3059,6 +3082,7 @@ type ListerPermissionCtx = {
     endpoint?: string;
     filters?: any;
     sessionId?: ListerSessionId;
+    ownerKey?: string;
 };
 interface ListerProviderHost {
     /** Host decides permission logic. Mandatory permissions end with '!' */
@@ -3142,6 +3166,7 @@ type ListerSearchSpec<TColumn extends string = string> = {
 type ListerDefinition<TRaw, TValue extends ListerId, TFilters = unknown, TMeta = unknown, TCtx = any, TSearchColumn extends string = string> = {
     /** optional stable id used by presets */
     id?: string;
+    title?: string;
     source: ListerSource<TFilters>;
     /** If missing: default extraction uses body.data (runtime). Must produce an array. */
     selector?: Selector<TRaw>;
@@ -3326,6 +3351,7 @@ type ListerOpenOptions<TRaw, TValue extends ListerId, TFilters, TMeta, TMode ext
     }) => any;
     /** Live change hook (sync + veto) */
     onChange?: (value: ListerValueForMode<TValue, TMode>, details: ListerDetails<TRaw, TValue, TMeta, TMode>, e: ListerChangeEvent) => void;
+    ownerKey?: string;
 };
 type ListerOpenResult<TRaw, TValue extends ListerId, TMeta, TMode extends ListerMode> = {
     reason: ListerOpenReason;
@@ -3418,6 +3444,7 @@ type ListerRuntimeState<TRaw, TValue extends ListerId, TFilters, TMeta, TMode ex
     searchSpec?: ListerSearchSpec<string>;
     /** Persisted user selection (subject/all/only) */
     searchTarget?: ListerSearchTarget;
+    ownerKey?: string;
 };
 type ListerStoreState = {
     /** rendering order (last = topmost) */
@@ -4353,4 +4380,4 @@ interface CoreContext<V extends Dict> {
     isDirty(): boolean;
 }
 
-export { type ListerSearchMode as $, type LayoutResolveContext as A, type BaseProps as B, type CoreProps as C, type Dict as D, type ErrorTextPlacement as E, type Field as F, type LayoutResolver as G, type HelpTextPlacement as H, InputNumber as I, type VariantEntry as J, type Variants as K, type LabelPlacement as L, type VariantValidateFn as M, type VariantLayoutDefaults as N, type VariantModuleFor as O, type PhoneCountry as P, type ListerDefinition as Q, type RelativeRootsMap as R, type SublabelPlacement as S, Textarea as T, type ListerRuntimeState as U, type VariantKey as V, type ListerProviderHost as W, type PresetMap as X, type ListerStoreState as Y, type ListerSessionId as Z, type ListerId as _, type CoreContext as a, type ListerSearchTarget as a0, type ListerSearchPayload as a1, type ListerFilterCtx as a2, type ListerFilterOption as a3, type ListerMode as a4, type ListerApi as a5, type ShadcnJsonEditorProps as a6, type JsonEditorIndexHandle as a7, type ListerOpenReason as a8, type Selector as a9, type PresetValue as aA, type PresetFilters as aB, type PresetMeta as aC, type ListerSessionState as aD, type Resolver as aa, type OpenAnchor as ab, type ListerChangeEvent as ac, type ListerLogLevel as ad, type ListerLogCode as ae, type ListerLogEntry as af, type ListerPermissionCtx as ag, type ListerOption as ah, type ListerMapping as ai, type ListerSource as aj, type ListerSearchSpec as ak, type ListerFilterApplyMode as al, type ListerFilterApply as am, type ListerFilterBindKey as an, type ListerFilterInput as ao, type ListerFilterGroupOption as ap, type ListerFilterValueOption as aq, type ListerFilterInputOption as ar, type ListerFilterSpec as as, type ListerValueForMode as at, type ListerRawForMode as au, type ListerOptionsForMode as av, type ListerDetails as aw, type ListerOpenOptions as ax, type ListerOpenResult as ay, type PresetRaw as az, type DescriptionPlacement as b, type SlotPlacement as c, type FieldSize as d, type FieldDensity as e, type ValidateResult as f, type ChangeDetail as g, type VariantValueFor as h, type VariantPropsFor as i, type VariantModule as j, type PasswordDefinitionMap as k, type CustomFileLoader as l, type FileItem as m, type InferFromSchema as n, type SubmitEvent as o, type FormProps as p, type ValuesResult as q, type InputStore as r, type ButtonRef as s, type FieldSlots as t, type FieldRoots as u, type FieldSlotId as v, type FieldRootId as w, type FieldOrdering as x, type FieldLayoutConfig as y, type EffectiveFieldLayout as z };
+export { type ListerSessionId as $, type LayoutResolveContext as A, type BaseProps as B, type CoreProps as C, type Dict as D, type ErrorTextPlacement as E, type Field as F, type LayoutResolver as G, type HelpTextPlacement as H, InputNumber as I, type VariantEntry as J, type Variants as K, type LabelPlacement as L, type VariantValidateFn as M, type VariantLayoutDefaults as N, type VariantModuleFor as O, type PhoneCountry as P, type ListerSearchPayload as Q, type RelativeRootsMap as R, type SublabelPlacement as S, Textarea as T, type ListerId as U, type VariantKey as V, type ListerDefinition as W, type ListerOption as X, type PresetMap as Y, type ListerApi as Z, type ListerStoreState as _, type CoreContext as a, type ListerSearchTarget as a0, type ListerSearchMode as a1, type ListerFilterCtx as a2, type ListerDetails as a3, type ListerProviderHost as a4, type ListerRuntimeState as a5, type ShadcnJsonEditorProps as a6, type JsonEditorIndexHandle as a7, type ListerMode as a8, type ListerOpenReason as a9, type PresetValue as aA, type PresetFilters as aB, type PresetMeta as aC, type ListerSessionState as aD, type Selector as aa, type Resolver as ab, type OpenAnchor as ac, type ListerChangeEvent as ad, type ListerLogLevel as ae, type ListerLogCode as af, type ListerLogEntry as ag, type ListerPermissionCtx as ah, type ListerMapping as ai, type ListerSource as aj, type ListerSearchSpec as ak, type ListerFilterApplyMode as al, type ListerFilterApply as am, type ListerFilterBindKey as an, type ListerFilterInput as ao, type ListerFilterGroupOption as ap, type ListerFilterValueOption as aq, type ListerFilterInputOption as ar, type ListerFilterOption as as, type ListerFilterSpec as at, type ListerValueForMode as au, type ListerRawForMode as av, type ListerOptionsForMode as aw, type ListerOpenOptions as ax, type ListerOpenResult as ay, type PresetRaw as az, type DescriptionPlacement as b, type SlotPlacement as c, type FieldSize as d, type FieldDensity as e, type ValidateResult as f, type ChangeDetail as g, type VariantValueFor as h, type VariantPropsFor as i, type VariantModule as j, type PasswordDefinitionMap as k, type CustomFileLoader as l, type FileItem as m, type InferFromSchema as n, type SubmitEvent as o, type FormProps as p, type ValuesResult as q, type InputStore as r, type ButtonRef as s, type FieldSlots as t, type FieldRoots as u, type FieldSlotId as v, type FieldRootId as w, type FieldOrdering as x, type FieldLayoutConfig as y, type EffectiveFieldLayout as z };

package/dist/extra.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { Q as ListerDefinition, U as ListerRuntimeState, W as ListerProviderHost, X as PresetMap, Y as ListerStoreState, Z as ListerSessionId, _ as ListerId, $ as ListerSearchMode, a0 as ListerSearchTarget, a1 as ListerSearchPayload, a2 as ListerFilterCtx, a3 as ListerFilterOption, a4 as ListerMode, a5 as ListerApi, a6 as ShadcnJsonEditorProps, a7 as JsonEditorIndexHandle } from './core-BD0ObjuE.mjs';
-export { ac as ListerChangeEvent, aw as ListerDetails, am as ListerFilterApply, al as ListerFilterApplyMode, an as ListerFilterBindKey, ap as ListerFilterGroupOption, ao as ListerFilterInput, ar as ListerFilterInputOption, as as ListerFilterSpec, aq as ListerFilterValueOption, ae as ListerLogCode, af as ListerLogEntry, ad as ListerLogLevel, ai as ListerMapping, ax as ListerOpenOptions, a8 as ListerOpenReason, ay as ListerOpenResult, ah as ListerOption, av as ListerOptionsForMode, ag as ListerPermissionCtx, au as ListerRawForMode, ak as ListerSearchSpec, aD as ListerSessionState, aj as ListerSource, at as ListerValueForMode, ab as OpenAnchor, aB as PresetFilters, aC as PresetMeta, az as PresetRaw, aA as PresetValue, aa as Resolver, a9 as Selector } from './core-BD0ObjuE.mjs';
+import { Q as ListerSearchPayload, U as ListerId, W as ListerDefinition, X as ListerOption, Y as PresetMap, Z as ListerApi, _ as ListerStoreState, $ as ListerSessionId, a0 as ListerSearchTarget, a1 as ListerSearchMode, a2 as ListerFilterCtx, a3 as ListerDetails, a4 as ListerProviderHost, a5 as ListerRuntimeState, a6 as ShadcnJsonEditorProps, a7 as JsonEditorIndexHandle } from './core-EVtvQ-ma.mjs';
+export { ad as ListerChangeEvent, am as ListerFilterApply, al as ListerFilterApplyMode, an as ListerFilterBindKey, ap as ListerFilterGroupOption, ao as ListerFilterInput, ar as ListerFilterInputOption, as as ListerFilterOption, at as ListerFilterSpec, aq as ListerFilterValueOption, af as ListerLogCode, ag as ListerLogEntry, ae as ListerLogLevel, ai as ListerMapping, a8 as ListerMode, ax as ListerOpenOptions, a9 as ListerOpenReason, ay as ListerOpenResult, aw as ListerOptionsForMode, ah as ListerPermissionCtx, av as ListerRawForMode, ak as ListerSearchSpec, aD as ListerSessionState, aj as ListerSource, au as ListerValueForMode, ac as OpenAnchor, aB as PresetFilters, aC as PresetMeta, az as PresetRaw, aA as PresetValue, ab as Resolver, aa as Selector } from './core-EVtvQ-ma.mjs';
 import 'zod';
 import './adapter-CvjXO9Gi.mjs';
 import '@inertiajs/core';
@@ -11,189 +11,155 @@ import 'class-variance-authority/types';
 import 'class-variance-authority';
 import '@radix-ui/react-switch';
 
+type HttpMethod = "GET" | "POST";
 type HttpReq = {
     endpoint: string;
-    method: "GET" | "POST";
+    method?: HttpMethod;
     params?: any;
     body?: any;
-    headers?: any;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+    requestId?: string;
 };
 type ListerHttpClient = (req: HttpReq) => Promise<any>;
 
-type AnyDef = ListerDefinition<any, any, any, any>;
-/**
- * IMPORTANT:
- * Your types file may not yet include these runtime-only fields (searchSpec/searchTarget).
- * Without widening here, TS2353 will fire when we create session objects containing them.
- *
- * This keeps compilation green while you finish syncing the types.
- */
-type AnyState = ListerRuntimeState<any, any, any, any, any> & {
-    searchSpec?: any;
-    searchTarget?: any;
-    searchPayload?: any;
-    ownerKey?: string;
+type ListerFetchOpts<TCtx = any> = {
+    query?: string;
+    search?: ListerSearchPayload;
+    cursor?: string | null;
+    /** request control */
+    signal?: AbortSignal;
+    requestId?: string;
+    /** mapping context override */
+    ctx?: TCtx;
 };
-type InternalContextValue = {
-    host: ListerProviderHost;
+declare function fetchListerList<TRaw, TValue extends ListerId, TFilters, TMeta, TCtx>(args: {
+    def: ListerDefinition<TRaw, TValue, TFilters, TMeta, TCtx>;
     http: ListerHttpClient;
-    presetsRef: React.RefObject<PresetMap>;
-    store: ListerStoreState;
-    apiFetchAny: (kindOrDef: string | AnyDef, filters?: any, opts?: any) => Promise<any>;
-    apiOpenAny: (kindOrDef: string | AnyDef, filters?: any, opts?: any) => Promise<any>;
-    focus(id: ListerSessionId): void;
-    dispose(id: ListerSessionId): void;
-    apply(id: ListerSessionId): void;
-    cancel(id: ListerSessionId): void;
-    close(id: ListerSessionId): void;
-    toggle(id: ListerSessionId, value: ListerId): void;
-    select(id: ListerSessionId, value: ListerId): void;
-    deselect(id: ListerSessionId, value: ListerId): void;
-    clear(id: ListerSessionId): void;
-    setQuery(id: ListerSessionId, q: string): void;
-    setSearchMode(id: ListerSessionId, mode: ListerSearchMode): void;
-    /**
-     * Persist the user's current search target (subject/all/only)
-     * so all searches (local/remote/hybrid) can include it.
-     */
-    setSearchTarget(id: ListerSessionId, target: ListerSearchTarget): void;
-    /**
-     * Backwards compatible signatures:
-     * - existing calls still work: searchRemote(id, q)
-     * - new calls can optionally override payload: searchRemote(id, q, payload)
-     *
-     * If payload is omitted, implementation should read from session.searchTarget.
-     */
-    searchLocal: {
-        (id: ListerSessionId, q: string): void;
-        (id: ListerSessionId, q: string, payload?: ListerSearchPayload): void;
-    };
-    searchRemote: {
-        (id: ListerSessionId, q: string): void;
-        (id: ListerSessionId, q: string, payload?: ListerSearchPayload): void;
-    };
-    refresh(id: ListerSessionId): void;
-    setPosition(id: ListerSessionId, pos: {
-        x: number;
-        y: number;
-    } | null): void;
-    /** Filters (non-UI logic; per session) */
-    getFilterCtx<TFilters>(id: ListerSessionId): ListerFilterCtx<TFilters>;
-    /**
-     * NEW semantics:
-     * - `optionId` is the UI identifier of the filter option (NOT the db value)
-     * - `selectedFilterValues` tracks selected option ids (for UI checkmarks/badge)
-     */
-    applyFilterOption(id: ListerSessionId, optionId: string | number): void;
-    registerPreset(kind: string, def: AnyDef): void;
-    getPreset(kind: string): AnyDef | undefined;
-    /** Derived list for UI later (local/hybrid filtering) */
-    getVisibleOptions(id: ListerSessionId): any[];
-};
-declare const Ctx: React.Context<InternalContextValue | null>;
-type ResolvedFilterNode<TFilters> = {
-    option: ListerFilterOption<TFilters>;
-    id: string;
-    kind?: string;
-    disabled?: boolean;
-    bindKey?: string;
-    dbValue?: any;
-    apply?: {
-        key?: string;
-        mode?: "replace" | "merge" | "unset";
-        toggleable?: boolean;
-        value?: any;
-    };
+    filters?: TFilters;
+    opts?: ListerFetchOpts<TCtx>;
+}): Promise<{
+    rawList: TRaw[];
+    optionsList: Array<ListerOption<TRaw, TValue, TMeta>>;
+    responseBody: any;
+    requestId?: string;
+}>;
+
+type ListerEngine = {
+    http: ListerHttpClient;
+    fetch: <TRaw, TValue extends ListerId, TFilters, TMeta, TCtx>(args: {
+        def: ListerDefinition<TRaw, TValue, TFilters, TMeta, TCtx>;
+        filters?: TFilters;
+        opts?: ListerFetchOpts<TCtx> & {
+            search?: ListerSearchPayload;
+        };
+    }) => ReturnType<typeof fetchListerList<TRaw, TValue, TFilters, TMeta, TCtx>>;
 };
-declare function buildSearchPayloadFromTarget(target?: ListerSearchTarget | null): ListerSearchPayload | undefined;
-declare function ListerProvider(props: {
+
+type CreateListerRuntimeOptions<P extends PresetMap> = {
     host: ListerProviderHost;
-    presets?: PresetMap;
-    http?: ListerHttpClient;
-    /** provider-side debounce for remote search (default 300ms) */
+    /** Provide your own engine (for tests / custom http). */
+    engine?: ListerEngine;
+    /** Initial preset map (kind => definition). */
+    presets?: P;
+    /** Debounce used when searchMode is remote/hybrid and query changes. */
     remoteDebounceMs?: number;
-    children: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
+    now?: () => number;
+    makeSessionId?: () => string;
+};
+type ListerRuntime<P extends PresetMap> = {
+    engine: ListerEngine;
+    api: ListerApi<P>;
+    getState(): ListerStoreState;
+    subscribe(fn: () => void): () => void;
+    actions: {
+        focus(sessionId: ListerSessionId): void;
+        close(sessionId: ListerSessionId): void;
+        cancel(sessionId: ListerSessionId): void;
+        apply(sessionId: ListerSessionId): void;
+        clear(sessionId: ListerSessionId): void;
+        toggle(sessionId: ListerSessionId, value: any): void;
+        select(sessionId: ListerSessionId, value: any): void;
+        deselect(sessionId: ListerSessionId, value: any): void;
+        setQuery(sessionId: ListerSessionId, query: string): void;
+        setSearchTarget(sessionId: ListerSessionId, target?: ListerSearchTarget): void;
+        setSearchMode(sessionId: ListerSessionId, mode: ListerSearchMode): void;
+        setFiltersPatch(sessionId: ListerSessionId, patch: any): void;
+        mergeFiltersPatch(sessionId: ListerSessionId, patch: any): void;
+        getFilterCtx<TFilters>(id: ListerSessionId): ListerFilterCtx<TFilters>;
+        applyFilterOption(id: ListerSessionId, optionId: string | number): void;
+        refresh(sessionId: ListerSessionId): void;
+    };
+    selectors: {
+        effectiveFilters(sessionId: ListerSessionId): any;
+        visibleOptions(sessionId: ListerSessionId): any[];
+        detailsPayload(sessionId: ListerSessionId, action: ListerDetails<any, any, any, any>["action"]): any;
+    };
+};
 
 /**
- * Search bar + trailing controls:
- * - Search target (all/subject/only) popover (leading control)
- * - Search mode toggle (remote/local/hybrid)
- * - Filters UI (custom popover button)
+ * Context for Lister runtime bridge.
+ */
+declare const ListerContext: React.Context<ListerRuntime<any> | null>;
+type ListerProviderProps<P extends PresetMap> = React.PropsWithChildren<CreateListerRuntimeOptions<P>>;
+/**
+ * ListerProvider — creates a singleton runtime and exposes it via React context.
  *
- * Notes:
- * - Search mode is bound to session.searchMode via actions.setSearchMode(id, mode)
- * - Search target is bound to session.searchTarget via actions.setSearchTarget(id, target)
- * - Filters live in session.filtersSpec?.options and session.selectedFilterValues
+ * Responsibilities:
+ * - instantiate `createListerRuntime` once per provider
+ * - subscribe to runtime store (if needed by descendants)
+ * - expose `api`, `actions`, `selectors`, and `state`
  */
-declare function SearchBar(props: {
-    id: ListerSessionId;
-    store: ListerStoreState;
-}): react_jsx_runtime.JSX.Element;
-
-declare function ListerUI(): react_jsx_runtime.JSX.Element | null;
-declare function HeaderBar(props: {
-    id: ListerSessionId;
-    title: string;
-    loading: boolean;
-    refreshing: boolean;
-    showRefresh: boolean;
-    draggable: boolean;
-    onRefresh(): void;
-    onClose(): void;
-}): react_jsx_runtime.JSX.Element;
+declare function ListerProvider<P extends PresetMap>({ children, ...opts }: ListerProviderProps<P>): react_jsx_runtime.JSX.Element;
+/**
+ * Helper: get current runtime or throw
+ */
+declare function useListerRuntime<P extends PresetMap>(): ListerRuntime<P>;
 
-declare function OptionList(props: {
-    id: ListerSessionId;
-    className?: string;
-}): react_jsx_runtime.JSX.Element;
-declare function FooterBar(props: {
-    id: ListerSessionId;
-    mode: ListerMode;
-    confirm: boolean;
-    onClear(): void;
-    onCancel(): void;
-    onApply(): void;
-}): react_jsx_runtime.JSX.Element;
+declare function ListerUI(): React.ReactPortal | null;
 
+/**
+ * useLister — stable hook returning { api, store/state, actions, selectors }.
+ *
+ * It directly mirrors the current runtime, with stable reference equality
+ * for top-level properties (api/actions/selectors), while `state` updates on
+ * store changes.
+ */
 declare function useLister<P extends PresetMap>(): {
     api: ListerApi<P>;
-    store: ListerStoreState;
-    /** active session convenience (can be undefined if none open) */
-    state: AnyState | undefined;
     actions: {
-        focus(id: ListerSessionId): void;
-        dispose(id: ListerSessionId): void;
-        apply(id: ListerSessionId): void;
-        cancel(id: ListerSessionId): void;
-        close(id: ListerSessionId): void;
-        toggle(id: ListerSessionId, value: ListerId): void;
-        select(id: ListerSessionId, value: ListerId): void;
-        deselect(id: ListerSessionId, value: ListerId): void;
-        clear(id: ListerSessionId): void;
-        setQuery(id: ListerSessionId, q: string): void;
-        setSearchMode(id: ListerSessionId, mode: ListerSearchMode): void;
-        setSearchTarget(id: ListerSessionId, target: ListerSearchTarget): void;
-        searchLocal: {
-            (id: ListerSessionId, q: string): void;
-            (id: ListerSessionId, q: string, payload?: ListerSearchPayload): void;
-        };
-        searchRemote: {
-            (id: ListerSessionId, q: string): void;
-            (id: ListerSessionId, q: string, payload?: ListerSearchPayload): void;
-        };
-        refresh(id: ListerSessionId): void;
-        setPosition(id: ListerSessionId, pos: {
-            x: number;
-            y: number;
-        } | null): void;
-        /** Filters (non-UI logic) */
+        focus(sessionId: ListerSessionId): void;
+        close(sessionId: ListerSessionId): void;
+        cancel(sessionId: ListerSessionId): void;
+        apply(sessionId: ListerSessionId): void;
+        clear(sessionId: ListerSessionId): void;
+        toggle(sessionId: ListerSessionId, value: any): void;
+        select(sessionId: ListerSessionId, value: any): void;
+        deselect(sessionId: ListerSessionId, value: any): void;
+        setQuery(sessionId: ListerSessionId, query: string): void;
+        setSearchTarget(sessionId: ListerSessionId, target?: ListerSearchTarget): void;
+        setSearchMode(sessionId: ListerSessionId, mode: ListerSearchMode): void;
+        setFiltersPatch(sessionId: ListerSessionId, patch: any): void;
+        mergeFiltersPatch(sessionId: ListerSessionId, patch: any): void;
         getFilterCtx<TFilters>(id: ListerSessionId): ListerFilterCtx<TFilters>;
         applyFilterOption(id: ListerSessionId, optionId: string | number): void;
-        registerPreset(kind: string, def: AnyDef): void;
-        getPreset(kind: string): AnyDef | undefined;
-        getVisibleOptions(id: ListerSessionId): any[];
+        refresh(sessionId: ListerSessionId): void;
+    };
+    selectors: {
+        effectiveFilters(sessionId: ListerSessionId): any;
+        visibleOptions(sessionId: ListerSessionId): any[];
+        detailsPayload(sessionId: ListerSessionId, action: ListerDetails<any, any, any, any>["action"]): any;
     };
+    state: ListerStoreState;
+    store: ListerStoreState;
+};
+/**
+ * useListerSession — convenience hook for one active session.
+ * Example: UI overlays or modals can call this to get the current session.
+ */
+declare function useListerSession<P extends PresetMap>(sessionId?: ListerSessionId): {
+    session: ListerRuntimeState<any, any, any, any, any> | undefined;
+    activeId: string | undefined;
 };
 
 /**
@@ -239,7 +205,7 @@ type UseDataOptions<TItem = any, TFilters = Record<string, any>> = {
     method?: "GET" | "POST";
     selector?: DataSelector<TItem>;
     /**
-     * Passed through into the inline def source.buildRequest (same signature as provider)
+     * Passed through into request builder (same signature shape as legacy provider)
      */
     buildRequest?: (ctx: DataBuildRequestCtx<TFilters>) => DataBuildRequestResult;
     /**
@@ -260,6 +226,10 @@ type UseDataOptions<TItem = any, TFilters = Record<string, any>> = {
      * Optional selection support (by stable item key)
      */
     selection?: DataSelectionConfig<TItem>;
+    /**
+     * Optional override: custom http client (otherwise uses global axios / axios import)
+     */
+    http?: ListerHttpClient;
 };
 type UseDataResult<TItem = any, TFilters = Record<string, any>> = {
     id?: string;
@@ -291,10 +261,11 @@ type UseDataResult<TItem = any, TFilters = Record<string, any>> = {
         query?: string;
         filters?: TFilters;
         searchTarget?: ListerSearchTarget;
+        search?: ListerSearchPayload;
     }) => Promise<TItem[]>;
 };
 declare function useData<TItem = any, TFilters = Record<string, any>>(opts: UseDataOptions<TItem, TFilters>): UseDataResult<TItem, TFilters>;
 
 declare const ShadcnJsonEditorVariant: React.ForwardRefExoticComponent<ShadcnJsonEditorProps & React.RefAttributes<JsonEditorIndexHandle>>;
 
-export { type AnyDef, type AnyState, Ctx, type DataBuildRequestCtx, type DataBuildRequestResult, type DataKey, type DataSearchConfig, type DataSelectionConfig, type DataSelectionKey, type DataSelectionMode, type DataSelector, FooterBar, HeaderBar, type InternalContextValue, ShadcnJsonEditorVariant as JsonEditor, ListerApi, ListerDefinition, ListerFilterCtx, ListerFilterOption, ListerId, ListerMode, ListerProvider, ListerProviderHost, ListerRuntimeState, ListerSearchMode, ListerSearchPayload, ListerSearchTarget, ListerSessionId, ListerStoreState, ListerUI, OptionList, PresetMap, type ResolvedFilterNode, SearchBar, type UseDataOptions, type UseDataResult, buildSearchPayloadFromTarget, useData, useLister };
+export { type DataBuildRequestCtx, type DataBuildRequestResult, type DataKey, type DataSearchConfig, type DataSelectionConfig, type DataSelectionKey, type DataSelectionMode, type DataSelector, ShadcnJsonEditorVariant as JsonEditor, ListerApi, ListerContext, ListerDefinition, ListerDetails, ListerFilterCtx, ListerId, ListerOption, ListerProvider, ListerProviderHost, type ListerProviderProps, ListerRuntimeState, ListerSearchMode, ListerSearchPayload, ListerSearchTarget, ListerSessionId, ListerStoreState, ListerUI, PresetMap, type UseDataOptions, type UseDataResult, useData, useLister, useListerRuntime, useListerSession };