basalt-ui 1.25.0 → 1.27.0

package/dist/state/fields.d.ts

@@ -0,0 +1,565 @@
+/**
+ * Which lanes a field lives on, declared ONCE at definition (C4).
+ *
+ * `url` is the truth; `persist` is the localStorage mirror UNDER it. `history` picks the entry a
+ * write creates. Declare the lane inline (`field.boolean(false, { url: false })`) — a lane held in
+ * a widened variable still behaves correctly at runtime, but the TYPE-level lane filter that keeps
+ * a local-only field out of `validateSearch` can only narrow a literal.
+ *
+ * @default `{ url: true, persist: true, history: 'replace' }`
+ */
+export type FieldLane = {
+    /** Put the field in the URL search. `false` = the mirror-only lane (per-chart selects, compact). */
+    url?: boolean;
+    /**
+     * Mirror the field in localStorage. `false` = the URL-only lane (pagination, one-shot filters);
+     * with `url: false` as well, the MEMORY-only lane — shared across every mount of the store for
+     * the session, gone on reload, never in localStorage. `createLocalStore` ignores `url`, so
+     * `persist: false` alone lands a field there.
+     */
+    persist?: boolean;
+    /** History entry a write creates. @default 'replace' */
+    history?: 'push' | 'replace';
+};
+/** A `FieldLane` with every default applied — what a field descriptor actually carries. */
+export type ResolvedLane = {
+    url: boolean;
+    persist: boolean;
+    history: 'push' | 'replace';
+};
+/** Lane defaults at the type level. Only an inline (const-inferred) lane object narrows. */
+export type ResolveLane<L> = {
+    url: L extends {
+        url: false;
+    } ? false : true;
+    persist: L extends {
+        persist: false;
+    } ? false : true;
+    history: L extends {
+        history: 'push';
+    } ? 'push' : 'replace';
+};
+/**
+ * A field's fallback: the value, or a THUNK evaluated at read time (`field.string({ fallback: () =>
+ * todayIso() })`). A thunk is re-evaluated on every read while nothing is written, and is never
+ * itself persisted — a write stores the value the control produced, like any other.
+ *
+ * The LOCAL and MEMORY lanes only. `createSearchStore` throws at definition for a thunk on a
+ * URL-lane field: `validateSearch` would evaluate it on every navigation and pin the result into the
+ * URL, so a deep link would carry a value nobody chose.
+ */
+export type FieldFallback<T> = T | (() => T);
+/** Resolves a per-preset window at call time. Returns ISO dates — what `toWindow` hands an API. */
+export type RangeWindow = (now: Date) => {
+    from: string;
+    to: string;
+};
+/**
+ * Per-preset window resolvers for a range field. A preset WITH one resolves through `toWindow()` to
+ * `{ from, to }`; a preset without keeps `{ window: preset }` — which is what lets a derived preset
+ * (`3m`, `ytd`) live in the same field as a server-understood one (`7d`) instead of forcing a
+ * hand-rolled `presetToParams` beside the store.
+ */
+export type RangeWindows<P extends string> = Partial<Record<P, RangeWindow>>;
+/** The value of a range field: one preset, plus two ISO dates when the preset is `'custom'`. */
+export type RangeValue<P extends string> = {
+    preset: P;
+    from?: string | undefined;
+    to?: string | undefined;
+};
+/** Renamed URL params for a range field. Defaults: the field's own name, `from`, `to`. */
+export type RangeParams = {
+    preset?: string;
+    from?: string;
+    to?: string;
+};
+export type EnumField<T extends string = string, Ln extends ResolvedLane = ResolvedLane> = {
+    readonly kind: 'enum';
+    readonly values: readonly T[];
+    readonly fallback: FieldFallback<T>;
+    readonly lane: Ln;
+};
+export type MultiField<T extends string = string, Ln extends ResolvedLane = ResolvedLane> = {
+    readonly kind: 'multi';
+    readonly values: readonly T[];
+    readonly fallback: FieldFallback<readonly T[]>;
+    readonly lane: Ln;
+};
+export type RangeField<P extends string = string, C extends boolean = boolean, Pm extends RangeParams = RangeParams, Ln extends ResolvedLane = ResolvedLane, W extends string = never> = {
+    readonly kind: 'range';
+    /** The declared presets — `'custom'` is NOT one of them, it is `custom: true`'s consequence. */
+    readonly presets: readonly P[];
+    readonly fallback: FieldFallback<RangeValue<P>>;
+    /** `true` → the preset `'custom'` plus `from`/`to` ISO dates are legal values. */
+    readonly custom: C;
+    readonly params: Pm;
+    /**
+     * The declared window resolvers, keyed by preset — `W` is exactly the presets that HAVE one, so
+     * `toWindow`'s return type can drop them from its `{ window }` branch and an API param type
+     * accepts the result with no cast.
+     *
+     * `W` defaults to `never` (`window: {}`), which is what keeps every `RangeField<P>` assignable to
+     * the widened `AnyField` a control's props take: a narrower resolver map is assignable to `{}`,
+     * and a widened handle's `toWindow` then excludes nothing rather than everything.
+     */
+    readonly window: RangeWindows<W>;
+    readonly lane: Ln;
+};
+/**
+ * The preset union a range field's VALUES range over: the declared presets, plus `'custom'` unless
+ * the field opted out.
+ *
+ * `C` widened to `boolean` (a bare `RangeField<P>`) keeps `'custom'` — but a PROP typed that way
+ * accepts only a custom-capable handle, because the handle's setter is contravariant in the value:
+ * `field.range` without `custom: true` hands out a `RangeField<P, false>`, whose setter refuses a
+ * `'custom'` preset. A wrapper that must take any range handle is generic over the flag
+ * (`<P extends string, C extends boolean>` + `FieldHandle<RangeField<P, C>>`); one that only ever
+ * takes the preset-only shape pins `RangeField<P, false>`.
+ */
+export type RangePresets<P, C> = (P & string) | (C extends false ? never : 'custom');
+export type NumberField<Ln extends ResolvedLane = ResolvedLane> = {
+    readonly kind: 'number';
+    readonly fallback: FieldFallback<number>;
+    readonly min: number | undefined;
+    readonly max: number | undefined;
+    readonly int: boolean;
+    readonly lane: Ln;
+};
+export type BooleanField<Ln extends ResolvedLane = ResolvedLane> = {
+    readonly kind: 'boolean';
+    readonly fallback: FieldFallback<boolean>;
+    readonly lane: Ln;
+};
+export type StringField<Ln extends ResolvedLane = ResolvedLane> = {
+    readonly kind: 'string';
+    readonly fallback: FieldFallback<string>;
+    readonly max: number | undefined;
+    readonly lane: Ln;
+};
+/** Every field kind, widened — the constraint a store's `fields` map satisfies. */
+export type AnyField = EnumField | MultiField | RangeField | NumberField | BooleanField | StringField;
+/** The value `use()` reads and writes for one field. Range fields deal in `RangeValue`. */
+export type FieldValue<F extends AnyField> = F extends {
+    kind: 'enum';
+    values: readonly (infer T)[];
+} ? T : F extends {
+    kind: 'multi';
+    values: readonly (infer T)[];
+} ? readonly T[] : F extends {
+    kind: 'range';
+    presets: readonly (infer P)[];
+    custom: infer C;
+} ? RangeValue<RangePresets<P, C>> : F extends {
+    kind: 'number';
+} ? number : F extends {
+    kind: 'boolean';
+} ? boolean : F extends {
+    kind: 'string';
+} ? string : never;
+/**
+ * The second, optional argument of a `FieldHandle` setter.
+ *
+ * @example field.tab.use()[1]('overview', { patch: { detailDate: undefined } })
+ */
+export type FieldSetOptions = {
+    /**
+     * Extra search params merged into the SAME navigate as the field's own write — the URL lane only
+     * (a local/memory-lane write has no navigate to merge into, and ignores this). For keys the STORE
+     * DOES NOT OWN: clearing a sibling param the page put there (`{ detailDate: undefined }`) used to
+     * need a second `navigate` beside the setter, which either lost the field's write or produced two
+     * history entries. The field's own params always win, so a `patch` cannot corrupt the value being
+     * set.
+     *
+     * A key ANOTHER field of the same store owns is refused — it would reach the URL while the
+     * mirror kept the old value, so the next paramless visit and every `linkSearch` link disagree
+     * with the page the write happened on. `createSearchStore` throws in dev and logs in production;
+     * write that field through its own setter instead.
+     *
+     * A write from a route that does not validate the field persists only (A1) and drops the patch
+     * with it — there is no navigate to merge into. Dev warns once per field.
+     */
+    readonly patch?: Record<string, unknown>;
+};
+/** One option of an enum / multi / range field, labelled through `store.labels()`. */
+export type FieldOption = {
+    value: string;
+    label: string;
+};
+/** `toWindow` exists on a range handle and nowhere else — it is not an optional convenience. */
+type RangeHandleExtras<F> = F extends {
+    kind: 'range';
+    presets: readonly (infer P)[];
+    custom: infer C;
+    window: RangeWindows<infer W>;
+} ? {
+    /**
+     * The API-facing projection of a range value: a preset becomes `{ window }`, a custom range
+     * becomes `{ from, to }`. Replaces every hand-rolled `presetToParams`.
+     *
+     * A preset declared with a `window` resolver (`field.range({ window: { '3m': ... } })`)
+     * becomes `{ from, to }` too — the resolver runs at CALL time with the current `Date`, so a
+     * derived window (`3m`, `ytd`) is never stale and never leaves the store.
+     *
+     * Those presets are EXCLUDED from the `{ window }` branch, so the result assigns to an API
+     * param type that only knows the server-understood windows with no cast — which is the half
+     * that lets a consumer delete the switch rather than move it. A `custom: true` field keeps
+     * `'custom'` in the union: a custom preset with no dates resolves to `{ window: 'custom' }`,
+     * so that one still needs a guard before it reaches such a type.
+     */
+    readonly toWindow: (v: RangeValue<RangePresets<P, C>>) => {
+        window: Exclude<RangePresets<P, C>, W>;
+    } | {
+        from: string;
+        to: string;
+    };
+} : {
+    readonly toWindow?: undefined;
+};
+/**
+ * A number handle's declared bounds, republished from the field — `RangeHandleExtras`' shape for the
+ * numeric kind, and there for the same reason: a control cannot ask the field descriptor anything,
+ * it only ever sees the handle.
+ *
+ * The codec has always CLAMPED to these on write, so before this the only way a `NumberFilter` could
+ * learn its own limits was for the call site to pass them a second time — a second answer to a
+ * question the field already owns, and one that silently stops matching the moment the field moves.
+ * With them on the handle the input can bound its own stepper, which turns the clamp from a
+ * correction the user watches happen into a value they cannot type in the first place.
+ *
+ * `int` is the third member because it is the same class of fact: it decides the stepper's grain
+ * (`step` 1, decimals refused), and the codec already rejects a non-integer for that field.
+ */
+type NumberHandleExtras<F> = F extends {
+    kind: 'number';
+} ? {
+    /** The field's `min`, or `undefined` when it declared none. Clamped on write regardless. */
+    readonly min: number | undefined;
+    /** The field's `max`, or `undefined` when it declared none. Clamped on write regardless. */
+    readonly max: number | undefined;
+    /** `field.number({ int: true })` — a non-integer is refused by the codec, not rounded. */
+    readonly int: boolean;
+} : {
+    readonly min?: undefined;
+    readonly max?: undefined;
+    readonly int?: undefined;
+};
+/**
+ * The binding every basalt control takes instead of `value`/`onChange` (C2). One field, both lanes,
+ * one resolution law. Handed out by `createSearchStore().field.<name>` /
+ * `createLocalStore().field.<name>`; never constructed by hand.
+ */
+export type FieldHandle<F extends AnyField> = {
+    readonly kind: F['kind'];
+    readonly fallback: FieldValue<F>;
+    /** enum / multi / range options, labelled by `labels()`. Empty for the other kinds. */
+    readonly options: readonly FieldOption[];
+    /**
+     * Read + write. Reads the URL when the field is on the URL lane (`useSearch({ strict: false })`,
+     * so a control renders on a sibling or child route with no `from`), else localStorage, else the
+     * fallback. Writes navigate when the matched route validates the param, then persist.
+     */
+    use(): readonly [FieldValue<F>, (next: FieldValue<F>, opts?: FieldSetOptions) => void];
+    /**
+     * UNSET the field — what a control's reset calls, and deliberately not `set(fallback)`. The
+     * persist lane DELETES the field's key from the mirror, the memory lane drops its value, and the
+     * URL lane navigates back to the fallback params (plus dropping the mirror key under it).
+     *
+     * Writing the fallback instead pins it: a THUNK fallback (`() => todayIso()`) resolves at the
+     * moment of the reset, so a reader who pressed `Reset all` today was handed today's date
+     * tomorrow, with the field counted as active in `Filters (n)`. Unsetting lets the fallback keep
+     * resolving, which is what `FieldFallback`'s contract says it does.
+     *
+     * Callable outside render (an event handler is the only realistic caller); on the URL lane it
+     * navigates through the last render of `use()`, so a handle that no mount has read clears the
+     * mirror only.
+     */
+    clear(): void;
+    isDefault(v: FieldValue<F>): boolean;
+} & RangeHandleExtras<F> & NumberHandleExtras<F>;
+/**
+ * `field.range`'s options. `C` is the `custom` flag, pinned per overload — never inferred; `W` is
+ * inferred from `window`'s KEYS (constrained to the declared presets, so a typo is still an error
+ * here) and is what carries the resolved presets into `toWindow`'s return type.
+ */
+type RangeOptions<P extends string, C extends boolean, Pm extends RangeParams, W extends P> = {
+    presets: readonly P[];
+    fallback: FieldFallback<NoInfer<P>>;
+    custom?: C;
+    params?: Pm;
+    /** Per-preset window resolvers — the presets `toWindow()` answers with `{ from, to }`. */
+    window?: RangeWindows<W>;
+};
+/**
+ * A time window: THREE URL params (preset + `from` + `to`, each renamable through `params`), so a
+ * consumer's existing deep links and loaders keep their shape. `custom: true` additionally
+ * allows the preset `'custom'` with two ISO dates. `window` resolves a DERIVED preset (`3m`, `ytd`)
+ * to `{ from, to }` through `toWindow()` while it stays one preset in the URL.
+ *
+ * A second `field.range` in the same store — or a second range store composed into the same
+ * route's `validateSearch` — MUST rename `from`/`to` via `params`: every range defaults to the
+ * literal param names `'from'`/`'to'`, and two fields silently sharing them makes the later one's
+ * `toSearch` overwrite the earlier one's dates. `createStoreCore` throws at definition for the
+ * in-store case; the cross-store case is not detectable by either store alone.
+ *
+ * THREE overloads, one per `custom` shape, because a single `custom?: C` signature is inferred
+ * against `AnyField` when the call sits inline in `createSearchStore({ fields })` — the contextual
+ * return type wins, `C` widens to `boolean`, and every value type gains a `'custom'` preset the
+ * field never allowed. Overloads have no `C` to widen: an omitted or `false` flag picks the first,
+ * a literal `true` the second, and a value typed `boolean` the third (widened, as declared).
+ */
+declare function rangeField<const P extends string, const Pm extends RangeParams = RangeParams, const L extends FieldLane = FieldLane, const W extends P = never>(o: RangeOptions<P, false, Pm, W>, lane?: L): RangeField<P, false, Pm, ResolveLane<L>, W>;
+declare function rangeField<const P extends string, const Pm extends RangeParams = RangeParams, const L extends FieldLane = FieldLane, const W extends P = never>(o: RangeOptions<P, true, Pm, W>, lane?: L): RangeField<P, true, Pm, ResolveLane<L>, W>;
+declare function rangeField<const P extends string, const Pm extends RangeParams = RangeParams, const L extends FieldLane = FieldLane, const W extends P = never>(o: RangeOptions<P, boolean, Pm, W>, lane?: L): RangeField<P, boolean, Pm, ResolveLane<L>, W>;
+/**
+ * The field vocabulary. Every builder returns plain declarative data — no closures, no router, no
+ * storage — which is what lets one field definition drive `createSearchStore` (URL + storage) and
+ * `createLocalStore` (storage only) without a second description of the same param.
+ *
+ * @example
+ * const store = createSearchStore({
+ *   key: 'analytics',
+ *   fields: {
+ *     range: field.range({ presets: ['7d', '30d', '90d'], fallback: '30d', custom: true }),
+ *     compare: field.enum(['none', 'previous'], 'none'),
+ *     channels: field.multi(CHANNELS, []),
+ *     minDuration: field.number({ fallback: 0, min: 0 }, { persist: false }),
+ *     compact: field.boolean(false, { url: false }),
+ *   },
+ * })
+ */
+export declare const field: {
+    /** A closed string enum — a tab, a compare mode, a single-select filter. */
+    enum<const T extends string, const L extends FieldLane = FieldLane>(values: readonly T[], fallback: FieldFallback<NoInfer<T>>, lane?: L): EnumField<T, ResolveLane<L>>;
+    /** An any-of set over the same closed enum. Decoding is deduped and canonically re-sorted. */
+    multi<const T extends string, const L extends FieldLane = FieldLane>(values: readonly T[], fallback?: FieldFallback<readonly NoInfer<T>[]>, lane?: L): MultiField<T, ResolveLane<L>>;
+    range: typeof rangeField;
+    /** A number — pagination, a threshold. Out-of-range input clamps to `min`/`max`. */
+    number<const L extends FieldLane = FieldLane>(o: {
+        fallback: FieldFallback<number>;
+        min?: number;
+        max?: number;
+        int?: boolean;
+    }, lane?: L): NumberField<ResolveLane<L>>;
+    /** A toggle. Accepts `true`/`false` and the strings `'true'`/`'false'` from a hand-typed URL. */
+    boolean<const L extends FieldLane = FieldLane>(fallback: FieldFallback<boolean>, lane?: L): BooleanField<ResolveLane<L>>;
+    /** Free text — a search box. Defaults to `history: 'replace'` like every other field. */
+    string<const L extends FieldLane = FieldLane>(o?: {
+        fallback?: FieldFallback<string>;
+        max?: number;
+    }, lane?: L): StringField<ResolveLane<L>>;
+};
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type RangeParamName<Pm, K extends keyof RangeParams, D extends string> = Pm extends Record<K, infer N> ? (N extends string ? N : D) : D;
+/** The param entries ONE field owns. A range field owns three; every other kind owns one. */
+type FieldSearch<K extends string, F extends AnyField> = F extends {
+    kind: 'range';
+    presets: readonly (infer P)[];
+    custom: infer C;
+    params: infer Pm;
+} ? {
+    [Q in RangeParamName<Pm, 'preset', K>]: RangePresets<P, C>;
+} & {
+    [Q in RangeParamName<Pm, 'from', 'from'>]?: string | undefined;
+} & {
+    [Q in RangeParamName<Pm, 'to', 'to'>]?: string | undefined;
+} : {
+    [Q in K]: FieldValue<F>;
+};
+type FieldNames<S> = keyof S & string;
+type UrlFieldNames<S> = {
+    [K in FieldNames<S>]: S[K] extends {
+        lane: {
+            url: false;
+        };
+    } ? never : K;
+}[FieldNames<S>];
+/** The search object of a store's URL-lane fields — `validateSearch`'s return, flat. */
+export type SearchValues<S extends Record<string, AnyField>> = Prettify<UnionToIntersection<{
+    [K in UrlFieldNames<S>]: FieldSearch<K, S[K]>;
+}[UrlFieldNames<S>]>>;
+/** The same flat shape over EVERY field, both lanes — what `readStored()` can return. */
+export type StoredValues<S extends Record<string, AnyField>> = Prettify<UnionToIntersection<{
+    [K in FieldNames<S>]: FieldSearch<K, S[K]>;
+}[FieldNames<S>]>>;
+/**
+ * Everything a store needs to move one field between the URL, localStorage and a control.
+ *
+ * @internal Reachable on `basalt-ui/state` only because `./router-tanstack`'s store is built on it
+ * — the two store factories are the public API, not this seam.
+ */
+export type FieldCodec = {
+    readonly kind: AnyField['kind'];
+    readonly lane: ResolvedLane;
+    /** Every URL param this field owns. */
+    readonly params: readonly string[];
+    /**
+     * The param whose PRESENCE in the current search means "the matched route validates this field".
+     * A store's `validateSearch` always returns it, so a route that ran it has the key; a foreign
+     * route does not, and a write there persists only (A1).
+     */
+    readonly primary: string;
+    /**
+     * The fallback, ALREADY resolved — a getter, because `field.*({ fallback: () => … })` is a thunk
+     * that must run at read time and re-run while nothing is written. Every call site reads it as a
+     * plain value, which is why the laziness is invisible past this line.
+     */
+    readonly fallback: unknown;
+    /** Range only: the per-preset window resolvers `toWindow` answers a derived preset through. */
+    readonly windows?: RangeWindows<string>;
+    /**
+     * Number only: the declared bounds and grain the codec clamps to, republished so `handle` can put
+     * them on the handle. The codec is the only thing that reads the field descriptor, so a control
+     * that needs a limit has to be handed it from here — see {@link NumberHandleExtras}.
+     */
+    readonly bounds?: {
+        readonly min: number | undefined;
+        readonly max: number | undefined;
+        readonly int: boolean;
+    };
+    /**
+     * Validate a STORED (or caller-supplied) value. `null` = unusable.
+     *
+     * Deliberately a different function from `fromSearch` for one kind: the deprecated multi store
+     * reads an empty URL array as "absent", and reusing that rule on the storage side would turn a
+     * deliberately CLEARED filter into a miss and resurrect the fallback on upgrade.
+     */
+    decode(raw: unknown): unknown;
+    /** Pull the field out of a router search object. `null` = absent or invalid. */
+    fromSearch(search: Record<string, unknown>): unknown;
+    /** The param entries a write puts on the URL. `undefined` values clear a stale param. */
+    toSearch(value: unknown): Record<string, unknown>;
+    equals(a: unknown, b: unknown): boolean;
+    /** Option values in declaration order — enum, multi and range only. */
+    readonly optionValues: readonly string[];
+};
+/**
+ * Build the codec for one field. `legacyMultiEmpty` restores the DEPRECATED multi-store's rule that
+ * an EMPTY url array means "absent, fall through to storage" — the deprecated wrapper's contract,
+ * never the new store's, where an empty selection is a value like any other.
+ *
+ * @internal — see `FieldCodec`.
+ */
+export declare function resolveFieldCodec(name: string, f: AnyField, opts?: {
+    legacyMultiEmpty?: boolean;
+}): FieldCodec;
+type StoreRecord = Record<string, unknown>;
+/**
+ * A field's write, untyped — the shape both factories build and `handle` hands out. `opts` is the
+ * public `FieldSetOptions`; only the URL lane can act on it.
+ *
+ * @internal — see `FieldCodec`.
+ */
+export type FieldWrite = (next: unknown, opts?: FieldSetOptions) => void;
+/** One field's `use()`, untyped. @internal — see `FieldCodec`. */
+export type FieldUse = () => readonly [unknown, FieldWrite];
+/** One named field plus its codec, in declaration order. @internal — see `FieldCodec`. */
+export type StoreEntry = {
+    readonly name: string;
+    readonly codec: FieldCodec;
+};
+export type StoreCoreOptions = {
+    readonly key: string;
+    readonly fields: Record<string, AnyField>;
+    readonly version?: number | undefined;
+    /**
+     * Legacy single-value storage layout: the whole envelope value IS this field's value, the shape
+     * `createSearchParamStore` has written since 1.0.0. Set ONLY by the deprecated wrappers — a
+     * consumer's already-persisted selection has to keep resolving byte-for-byte.
+     */
+    readonly legacyValueField?: string;
+};
+/**
+ * The storage + resolution kernel. Deliberately NOT exported from any barrel: it is the seam
+ * between `./state`'s router-free store and `./router-tanstack`'s router-coupled one, and both of
+ * those are the public API.
+ *
+ * @internal — see `FieldCodec`.
+ */
+export type StoreCore = {
+    readonly entries: readonly StoreEntry[];
+    readonly urlEntries: readonly StoreEntry[];
+    readonly anyPersisted: boolean;
+    usePersistedRecord(): readonly [StoreRecord, (next: StoreRecord) => void];
+    readRecord(): StoreRecord;
+    setLabels(map: Record<string, Record<string, string> | undefined>): void;
+    optionsFor(entry: StoreEntry): readonly FieldOption[];
+    /** The resolution law, once: URL ⊳ localStorage ⊳ fallback. `search: null` skips the URL lane. */
+    resolve(entry: StoreEntry, search: StoreRecord | null, record: StoreRecord): unknown;
+    writeField(setRecord: (next: StoreRecord) => void, name: string, value: unknown): void;
+    /**
+     * The IN-MEMORY lane's `use()` for one field — a field with neither the URL nor the mirror.
+     * Lives here rather than in either factory because BOTH have such a field: `createLocalStore`'s
+     * `persist: false`, and `createSearchStore`'s `{ url: false, persist: false }`.
+     */
+    memoryUse(entry: StoreEntry): FieldUse;
+    /** The memory lane's value for one field, resolved — its fallback while nothing was written. */
+    readMemoryValue(entry: StoreEntry): unknown;
+    /** Subscribes to the whole memory lane. The snapshot is a write counter, so it is always stable. */
+    useMemoryVersion(): number;
+    /** Drops every memory value, so the next read resolves to the fallback. What `useReset` calls. */
+    resetMemory(): void;
+    /**
+     * Deletes ONE field's key from the localStorage record, so the next read falls through to the
+     * live fallback. Not a hook: `FieldHandle.clear()` runs in an event handler, where the persisted
+     * setter from `usePersistedRecord()` is not in reach — it writes through the same envelope and
+     * wakes the same per-key listeners (`writePersistedValue`).
+     */
+    clearField(name: string): void;
+    /** The memory lane's half of the same: drops ONE field's value. */
+    clearMemory(name: string): void;
+    /** Every stored field, flattened into URL-param shape, `undefined` entries dropped. */
+    readStoredFlat(): StoreRecord;
+    handle(entry: StoreEntry, use: FieldUse, clear: () => void): FieldHandle<AnyField>;
+};
+/** @internal — the seam behind `createSearchStore` and `createLocalStore`. */
+export declare function createStoreCore(o: StoreCoreOptions): StoreCore;
+/** `Pick<SearchStore<S>, 'field' | 'readStored' | 'labels'>` — the same handles, no router. */
+export type LocalStore<S extends Record<string, AnyField>> = {
+    readonly field: {
+        [K in keyof S]: FieldHandle<S[K]>;
+    };
+    readStored: () => Partial<StoredValues<S>>;
+    /**
+     * Option labels for enum / multi / range fields — the same chainable contract
+     * `createSearchStore` has, so `SelectFilter`/`ViewTabs` read their option labels off a local
+     * store too. Call it once, at definition.
+     */
+    labels: (map: Partial<{
+        [K in keyof S]: Record<string, string>;
+    }>) => LocalStore<S>;
+};
+/**
+ * A store with no URL lane and no router import: per-chart selects, a section's view tab, a compact
+ * toggle. Same `field.*` vocabulary and the same `FieldHandle` every basalt control binds to, so a
+ * control cannot tell the two stores apart — which is the point, and why the local lane is not an
+ * excuse to reach for `useState` (C3).
+ *
+ * A field's `url` lane is ignored here (there is no URL to write); `persist: false` is the
+ * IN-MEMORY lane — shared across mounts for the session, gone on reload, never in localStorage.
+ * That is the honest home for a value a reader should not be handed back tomorrow (a scratch
+ * comparison, a temporary drill-down) without dropping to `useState` and losing the handle.
+ *
+ * A fallback may be a THUNK (`field.string({ fallback: () => todayIso() })`) — resolved at read
+ * time, re-resolved while nothing is written, and never persisted on its own. Every lane here
+ * qualifies; `createSearchStore` allows it off the URL lane only, and throws otherwise.
+ *
+ * @example
+ * const chart = createLocalStore({
+ *   key: 'momentum-chart',
+ *   fields: {
+ *     metric: field.enum(['load', 'volume'], 'load'),
+ *     zoomed: field.boolean(false, { persist: false }), // in-memory, this session only
+ *   },
+ * }).labels({ metric: { load: 'Load', volume: 'Volume' } })
+ * // <SelectFilter field={chart.field.metric} label="Metric" />
+ */
+export declare function createLocalStore<const S extends Record<string, AnyField>>(o: {
+    key: string;
+    fields: S;
+    version?: number;
+}): LocalStore<S>;
+export {};
+//# sourceMappingURL=fields.d.ts.map

package/dist/state/fields.d.ts.map

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