@timeax/form-palette 0.1.2 → 0.1.4

package/dist/extra.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { O as ListerDefinition, Q as ListerRuntimeState, U as ListerProviderHost, W as PresetMap, X as ListerStoreState, Y as ListerSessionId, Z as ListerId, _ as ListerSearchMode, $ as ListerSearchTarget, a0 as ListerSearchPayload, a1 as ListerFilterCtx, a2 as ListerFilterOption, a3 as ListerMode, a4 as ListerApi, a5 as ShadcnJsonEditorProps, a6 as JsonEditorIndexHandle } from './variant-BGkGWsSy.mjs';
-export { ab as ListerChangeEvent, av as ListerDetails, al as ListerFilterApply, ak as ListerFilterApplyMode, am as ListerFilterBindKey, ao as ListerFilterGroupOption, an as ListerFilterInput, aq as ListerFilterInputOption, ar as ListerFilterSpec, ap as ListerFilterValueOption, ad as ListerLogCode, ae as ListerLogEntry, ac as ListerLogLevel, ah as ListerMapping, aw as ListerOpenOptions, a7 as ListerOpenReason, ax as ListerOpenResult, ag as ListerOption, au as ListerOptionsForMode, af as ListerPermissionCtx, at as ListerRawForMode, aj as ListerSearchSpec, aC as ListerSessionState, ai as ListerSource, as as ListerValueForMode, aa as OpenAnchor, aA as PresetFilters, aB as PresetMeta, ay as PresetRaw, az as PresetValue, a9 as Resolver, a8 as Selector } from './variant-BGkGWsSy.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 };