vultus-core 0.3.0 → 0.5.0

package/dist/useArg.js

@@ -0,0 +1,83 @@
+import { useCallback, useMemo, useRef, useSyncExternalStore } from 'react';
+import { useArgStore } from './ArgStoreContext.js';
+import { useFieldContext } from './FieldContext.js';
+import { resolveIn } from './resolve.js';
+/** The raw value a write needs for `value`: `undefined` (removes the key) when it equals the default, else its formatted form. */
+function rawFor(value, defaultValue, valueType) {
+    return valueType.isEqual(value, defaultValue) ? undefined : valueType.format(value);
+}
+/**
+ * An argument read from and written to the nearest ArgStore. An absent key reads as the default;
+ * writing the default removes the key.
+ *
+ * `parse(raw)` is memoized on `[raw, key, valueType]` (not the default, which may be a context
+ * function with its own, independently changing inputs): re-rendering with the same raw value
+ * does not re-parse and does not re-warn; a raw value that does not parse warns once per such
+ * change and the default is used instead. `value` itself then keeps its previous identity
+ * whenever it is still `isEqual` to the freshly computed one (parsed-or-default), so a default
+ * that builds a fresh value every render (`() => []`) does not change `value`'s identity either —
+ * effects keyed on `value` do not re-run just because nothing meaningful changed.
+ */
+export function useArg(definition) {
+    const { key, valueType, default: defaultOrFn } = definition;
+    const store = useArgStore();
+    const ctx = useFieldContext();
+    // Called on the store, not passed detached: a store written as a class uses `this`.
+    const subscribe = useCallback((listener) => store.subscribe(listener), [store]);
+    const read = useCallback(() => store.read(key), [store, key]);
+    const raw = useSyncExternalStore(subscribe, read);
+    const defaultValue = resolveIn(defaultOrFn, undefined, ctx, `Argument '${key}': option 'default'`);
+    const parsed = useMemo(() => {
+        if (raw === undefined)
+            return undefined;
+        const p = valueType.parse(raw);
+        if (p === undefined)
+            console.warn(`Argument '${key}': cannot read '${raw}', using the default`);
+        return p;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [raw, key, valueType]);
+    const candidate = parsed ?? defaultValue;
+    const previousRef = useRef(undefined);
+    const value = previousRef.current !== undefined && valueType.isEqual(previousRef.current.value, candidate)
+        ? previousRef.current.value
+        : candidate;
+    previousRef.current = { value };
+    const set = useCallback((next, method = 'replace') => {
+        store.write([{ key, raw: rawFor(next, defaultValue, valueType) }], method);
+    }, [store, key, valueType, defaultValue]);
+    const reset = useCallback((method = 'replace') => {
+        store.write([{ key, raw: undefined }], method);
+    }, [store, key]);
+    const hrefFor = useCallback((next) => {
+        if (!store.hrefFor)
+            return undefined;
+        return store.hrefFor([{ key, raw: rawFor(next, defaultValue, valueType) }]);
+    }, [store, key, valueType, defaultValue]);
+    return { value, isDefault: valueType.isEqual(value, defaultValue), set, reset, hrefFor };
+}
+export function setArg(definition, value) {
+    return { definition, value };
+}
+export function resetArg(definition) {
+    return { definition, reset: true };
+}
+/**
+ * Applies several argument changes as one store write (one history entry: "clear all", a chip
+ * that also closes a task). Each change's default is resolved at call time, from the field
+ * context captured when this hook rendered.
+ */
+export function useArgWriter() {
+    const store = useArgStore();
+    const ctx = useFieldContext();
+    return useCallback((changes, method = 'replace') => {
+        const rawChanges = changes.map((change) => {
+            const { key, valueType, default: defaultOrFn } = change.definition;
+            if (change.reset)
+                return { key, raw: undefined };
+            const defaultValue = resolveIn(defaultOrFn, undefined, ctx, `Argument '${key}': option 'default'`);
+            return { key, raw: rawFor(change.value, defaultValue, valueType) };
+        });
+        store.write(rawChanges, method);
+    }, [store, ctx]);
+}
+//# sourceMappingURL=useArg.js.map

package/dist/useArg.js.map

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

package/dist/useBoolField.d.ts

@@ -1,6 +1,7 @@
 import { type FieldControls, type FieldOptions } from './field.js';
-import type { ErrorRoutesRegistry } from './types.js';
-export type BoolFieldOptions<RouteId extends string = string> = FieldOptions<boolean, boolean, RouteId>;
+import { type FieldCtx } from './FieldContext.js';
+import type { ErrorRoutesRegistry, ValueOrFn } from './types.js';
+export type BoolFieldOptions<RouteId extends string = string, Ctx = any> = FieldOptions<boolean, boolean, RouteId, Ctx>;
 export interface BoolFieldControls extends FieldControls<boolean, boolean> {
     /**
      * Request the opposite value. Programmatic use; widgets obtain the field's
@@ -8,10 +9,14 @@ export interface BoolFieldControls extends FieldControls<boolean, boolean> {
      */
     toggle(): void;
 }
+/** The implicit initial value for a boolean field: `initialValue` resolved, else false. */
+export declare function boolInitialValue(opts: {
+    initialValue?: ValueOrFn<boolean>;
+}, ctx: FieldCtx, id: string): boolean;
 /**
  * A boolean field (moxb's Bool, the sidedao boolean field). Rendered by
  * vultus-antd's BoolCheckbox and BoolSwitch, which take the same controls.
  * Inside the field the value starts at `initialValue` (default false).
  */
-export declare function useBoolField<RouteId extends string = string>(opts: BoolFieldOptions<RouteId>, registry?: ErrorRoutesRegistry<RouteId>): BoolFieldControls;
+export declare function useBoolField<RouteId extends string = string, Ctx = any>(opts: BoolFieldOptions<RouteId, Ctx>, registry?: ErrorRoutesRegistry<RouteId>): BoolFieldControls;
 //# sourceMappingURL=useBoolField.d.ts.map

package/dist/useBoolField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBoolField.d.ts","sourceRoot":"","sources":["../src/useBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,gBAAgB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAExG,MAAM,WAAW,iBAAkB,SAAQ,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC;IACxE;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC1D,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAC/B,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,iBAAiB,CAQnB"}
+{"version":3,"file":"useBoolField.d.ts","sourceRoot":"","sources":["../src/useBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,gBAAgB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;AAExH,MAAM,WAAW,iBAAkB,SAAQ,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC;IACxE;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;CAAE,EAC3C,GAAG,EAAE,QAAQ,EACb,EAAE,EAAE,MAAM,GACT,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,EACrE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,EACpC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,iBAAiB,CAUnB"}

package/dist/useBoolField.js

@@ -1,12 +1,20 @@
 import { useFieldCore } from './field.js';
+import { useFieldContext } from './FieldContext.js';
+import { resolveIn } from './resolve.js';
+/** The implicit initial value for a boolean field: `initialValue` resolved, else false. */
+export function boolInitialValue(opts, ctx, id) {
+    return resolveIn(opts.initialValue, false, ctx, `Field '${id}': option 'initialValue'`);
+}
 /**
  * A boolean field (moxb's Bool, the sidedao boolean field). Rendered by
  * vultus-antd's BoolCheckbox and BoolSwitch, which take the same controls.
  * Inside the field the value starts at `initialValue` (default false).
  */
 export function useBoolField(opts, registry) {
+    const ctx = useFieldContext();
     const inside = !opts.onChange && !opts.commit;
-    const field = useFieldCore('boolean', inside ? { ...opts, initialValue: opts.initialValue ?? false } : opts, registry);
+    const initialValue = () => boolInitialValue(opts, ctx, opts.id);
+    const field = useFieldCore('boolean', inside ? { ...opts, initialValue } : opts, registry);
     return { ...field, toggle: () => field.setValue(!field.value) };
 }
 //# sourceMappingURL=useBoolField.js.map

package/dist/useBoolField.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBoolField.js","sourceRoot":"","sources":["../src/useBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AAajF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAA+B,EAC/B,QAAuC;IAEvC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,MAAM,KAAK,GAAG,YAAY,CACxB,SAAS,EACT,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EACrE,QAAQ,CACT,CAAC;IACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAClE,CAAC"}
+{"version":3,"file":"useBoolField.js","sourceRoot":"","sources":["../src/useBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,eAAe,EAAiB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAazC,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAC9B,IAA2C,EAC3C,GAAa,EACb,EAAU;IAEV,OAAO,SAAS,CAAU,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,0BAA0B,CAAC,CAAC;AACnG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAoC,EACpC,QAAuC;IAEvC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,YAAY,CACxB,SAAS,EACT,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,EACzC,QAAQ,CACT,CAAC;IACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAClE,CAAC"}

package/dist/useManyOfField.d.ts

@@ -0,0 +1,35 @@
+import { type FieldControls, type FieldOptions } from './field.js';
+import { type OneOfChoice, type OneOfChoiceControls } from './choices.js';
+import { type FieldCtx } from './FieldContext.js';
+import type { ErrorRoutesRegistry, ValueOrFn } from './types.js';
+export type ManyOfOwnOptions<T extends string = string, Ctx = any> = {
+    /** The choices, in order; static or derived (a function, of the field context if it declares a parameter). */
+    choices: ValueOrFn<OneOfChoice<T>[], Ctx>;
+};
+export type ManyOfFieldOptions<T extends string = string, RouteId extends string = string, Ctx = any> = FieldOptions<T[], T[], RouteId, Ctx> & ManyOfOwnOptions<T, Ctx>;
+export interface ManyOfChoiceControls<T extends string = string> extends OneOfChoiceControls<T> {
+    selected: boolean;
+}
+export interface ManyOfFieldControls<T extends string = string> extends FieldControls<T[], T[]> {
+    choices: ManyOfChoiceControls<T>[];
+    isSelected(value: T): boolean;
+    /** Flips a choice's membership in the value; ignored (with a warning) for an unknown or disabled choice. */
+    toggle(value: T): void;
+}
+/** The implicit initial value for a many-of field: `initialValue` resolved, else the empty list. */
+export declare function manyOfInitialValue<T extends string>(opts: {
+    initialValue?: ValueOrFn<T[]>;
+}, ctx: FieldCtx, id: string): T[];
+/**
+ * A field whose value is a set of choices (moxb's ManyOf). A request (to
+ * `setValue` or `toggle`) is normalized to the known choices in their order,
+ * without duplicates, followed by the values the field already holds that are
+ * no longer among the choices and that the request keeps (in their current
+ * order: `toggle` keeps them, so a stored value naming a choice that was
+ * removed is not silently dropped, while `setValue([])` clears it). A request
+ * naming a value that is neither a choice nor already held, or that changes a
+ * disabled choice's membership, is ignored with a warning — as useOneOfField
+ * refuses a disabled or unknown choice.
+ */
+export declare function useManyOfField<T extends string = string, RouteId extends string = string, Ctx = any>(opts: ManyOfFieldOptions<T, RouteId, Ctx>, registry?: ErrorRoutesRegistry<RouteId>): ManyOfFieldControls<T>;
+//# sourceMappingURL=useManyOfField.d.ts.map

package/dist/useManyOfField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useManyOfField.d.ts","sourceRoot":"","sources":["../src/useManyOfField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI;IACnE,8GAA8G;IAC9G,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,IAClG,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAElE,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IAC7F,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7F,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IAC9B,4GAA4G;IAC5G,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CACxB;AAED,oGAAoG;AACpG,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAA;CAAE,EACvC,GAAG,EAAE,QAAQ,EACb,EAAE,EAAE,MAAM,GACT,CAAC,EAAE,CAEL;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,EAClG,IAAI,EAAE,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EACzC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,mBAAmB,CAAC,CAAC,CAAC,CA0DxB"}

package/dist/useManyOfField.js

@@ -0,0 +1,74 @@
+import { useFieldCore } from './field.js';
+import { resolveChoice } from './choices.js';
+import { useFieldContext } from './FieldContext.js';
+import { resolveIn } from './resolve.js';
+/** The implicit initial value for a many-of field: `initialValue` resolved, else the empty list. */
+export function manyOfInitialValue(opts, ctx, id) {
+    return resolveIn(opts.initialValue, [], ctx, `Field '${id}': option 'initialValue'`);
+}
+/**
+ * A field whose value is a set of choices (moxb's ManyOf). A request (to
+ * `setValue` or `toggle`) is normalized to the known choices in their order,
+ * without duplicates, followed by the values the field already holds that are
+ * no longer among the choices and that the request keeps (in their current
+ * order: `toggle` keeps them, so a stored value naming a choice that was
+ * removed is not silently dropped, while `setValue([])` clears it). A request
+ * naming a value that is neither a choice nor already held, or that changes a
+ * disabled choice's membership, is ignored with a warning — as useOneOfField
+ * refuses a disabled or unknown choice.
+ */
+export function useManyOfField(opts, registry) {
+    const ctx = useFieldContext();
+    const resolvedChoices = resolveIn(opts.choices, [], ctx, `Field '${opts.id}': option 'choices'`)
+        .map((c) => resolveChoice(opts.id, c));
+    const byValue = new Map(resolvedChoices.map((c) => [c.value, c]));
+    const choiceOrder = resolvedChoices.map((c) => c.value);
+    const inside = !opts.onChange && !opts.commit;
+    const initialValue = () => manyOfInitialValue(opts, ctx, opts.id);
+    const field = useFieldCore('manyOf', inside ? { ...opts, initialValue } : opts, registry);
+    /** The normalized list a request becomes, or undefined when the request is refused (with a warning already issued). */
+    const normalize = (request, current) => {
+        const requestSet = new Set(request);
+        const currentSet = new Set(current);
+        const heldUnknown = current.filter((v) => !byValue.has(v));
+        const heldUnknownSet = new Set(heldUnknown);
+        for (const v of request) {
+            if (!byValue.has(v) && !heldUnknownSet.has(v)) {
+                console.warn(`Field '${opts.id}': '${v}' is not one of its choices`);
+                return undefined;
+            }
+        }
+        for (const choice of resolvedChoices) {
+            if (choice.enabled)
+                continue;
+            if (currentSet.has(choice.value) !== requestSet.has(choice.value)) {
+                console.warn(`Field '${opts.id}': choice '${choice.value}' is disabled — ${choice.whyDisabled ?? '(no reason)'}`);
+                return undefined;
+            }
+        }
+        return [...choiceOrder.filter((v) => requestSet.has(v)), ...heldUnknown.filter((v) => requestSet.has(v))];
+    };
+    const setValue = (next) => {
+        const normalized = normalize(next, field.value);
+        if (normalized === undefined)
+            return;
+        field.setValue(normalized);
+    };
+    const isSelected = (value) => field.value.includes(value);
+    const toggle = (value) => {
+        const choice = byValue.get(value);
+        if (!choice) {
+            console.warn(`Field '${opts.id}': '${value}' is not one of its choices`);
+            return;
+        }
+        if (!choice.enabled) {
+            console.warn(`Field '${opts.id}': choice '${value}' is disabled — ${choice.whyDisabled ?? '(no reason)'}`);
+            return;
+        }
+        const current = field.value;
+        setValue(current.includes(value) ? current.filter((v) => v !== value) : [...current, value]);
+    };
+    const choices = resolvedChoices.map((c) => ({ ...c, selected: field.value.includes(c.value) }));
+    return { ...field, setValue, choices, isSelected, toggle };
+}
+//# sourceMappingURL=useManyOfField.js.map

package/dist/useManyOfField.js.map

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

package/dist/useMixedBoolField.d.ts

@@ -1,12 +1,17 @@
 import { type FieldControls, type FieldOptions } from './field.js';
-import type { ErrorRoutesRegistry } from './types.js';
+import { type FieldCtx } from './FieldContext.js';
+import type { ErrorRoutesRegistry, ValueOrFn } from './types.js';
 /** What a mixed boolean field shows: on, off, or some of its items on and some off. */
 export type MixedBool = boolean | 'mixed';
-export type MixedBoolFieldOptions<RouteId extends string = string> = FieldOptions<MixedBool, boolean, RouteId>;
+export type MixedBoolFieldOptions<RouteId extends string = string, Ctx = any> = FieldOptions<MixedBool, boolean, RouteId, Ctx>;
 export interface MixedBoolFieldControls extends FieldControls<MixedBool, boolean> {
     /** Request the opposite: off when on, on when off or mixed. Programmatic use, as in BoolFieldControls. */
     toggle(): void;
 }
+/** The implicit initial value for a mixed-boolean field: `initialValue` resolved, else false. */
+export declare function mixedBoolInitialValue(opts: {
+    initialValue?: ValueOrFn<MixedBool>;
+}, ctx: FieldCtx, id: string): MixedBool;
 /**
  * A boolean field over an aggregate (moxb's indeterminate Bool, ARIA's
  * "mixed"): it shows true, false or 'mixed', and can be asked for true or
@@ -14,7 +19,7 @@ export interface MixedBoolFieldControls extends FieldControls<MixedBool, boolean
  * its knob in the middle, BoolCheckbox is indeterminate. Derive the value with
  * `aggregateBool`; with no items at all, disable the field with a reason.
  */
-export declare function useMixedBoolField<RouteId extends string = string>(opts: MixedBoolFieldOptions<RouteId>, registry?: ErrorRoutesRegistry<RouteId>): MixedBoolFieldControls;
+export declare function useMixedBoolField<RouteId extends string = string, Ctx = any>(opts: MixedBoolFieldOptions<RouteId, Ctx>, registry?: ErrorRoutesRegistry<RouteId>): MixedBoolFieldControls;
 /**
  * The aggregate of several booleans: true when all are on, false when none is,
  * 'mixed' otherwise; `undefined` when there are none (a case for disabling the

package/dist/useMixedBoolField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMixedBoolField.d.ts","sourceRoot":"","sources":["../src/useMixedBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1C,MAAM,MAAM,qBAAqB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAE/G,MAAM,WAAW,sBAAuB,SAAQ,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC;IAC/E,0GAA0G;IAC1G,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/D,IAAI,EAAE,qBAAqB,CAAC,OAAO,CAAC,EACpC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,sBAAsB,CAQxB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GAAG,SAAS,CAI/E"}
+{"version":3,"file":"useMixedBoolField.d.ts","sourceRoot":"","sources":["../src/useMixedBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEjE,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1C,MAAM,MAAM,qBAAqB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;AAE/H,MAAM,WAAW,sBAAuB,SAAQ,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC;IAC/E,0GAA0G;IAC1G,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,iGAAiG;AACjG,wBAAgB,qBAAqB,CACnC,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAAE,EAC7C,GAAG,EAAE,QAAQ,EACb,EAAE,EAAE,MAAM,GACT,SAAS,CAEX;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,EAC1E,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,EACzC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,sBAAsB,CAUxB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GAAG,SAAS,CAI/E"}

package/dist/useMixedBoolField.js

@@ -1,4 +1,10 @@
 import { useFieldCore } from './field.js';
+import { useFieldContext } from './FieldContext.js';
+import { resolveIn } from './resolve.js';
+/** The implicit initial value for a mixed-boolean field: `initialValue` resolved, else false. */
+export function mixedBoolInitialValue(opts, ctx, id) {
+    return resolveIn(opts.initialValue, false, ctx, `Field '${id}': option 'initialValue'`);
+}
 /**
  * A boolean field over an aggregate (moxb's indeterminate Bool, ARIA's
  * "mixed"): it shows true, false or 'mixed', and can be asked for true or
@@ -7,8 +13,10 @@ import { useFieldCore } from './field.js';
  * `aggregateBool`; with no items at all, disable the field with a reason.
  */
 export function useMixedBoolField(opts, registry) {
+    const ctx = useFieldContext();
     const inside = !opts.onChange && !opts.commit;
-    const field = useFieldCore('mixed-boolean', inside ? { ...opts, initialValue: opts.initialValue ?? false } : opts, registry);
+    const initialValue = () => mixedBoolInitialValue(opts, ctx, opts.id);
+    const field = useFieldCore('mixed-boolean', inside ? { ...opts, initialValue } : opts, registry);
     return { ...field, toggle: () => field.setValue(field.value !== true) };
 }
 /**

package/dist/useMixedBoolField.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMixedBoolField.js","sourceRoot":"","sources":["../src/useMixedBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AAajF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAoC,EACpC,QAAuC;IAEvC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,MAAM,KAAK,GAAG,YAAY,CACxB,eAAe,EACf,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EACrE,QAAQ,CACT,CAAC;IACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AAClE,CAAC"}
+{"version":3,"file":"useMixedBoolField.js","sourceRoot":"","sources":["../src/useMixedBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,eAAe,EAAiB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAazC,iGAAiG;AACjG,MAAM,UAAU,qBAAqB,CACnC,IAA6C,EAC7C,GAAa,EACb,EAAU;IAEV,OAAO,SAAS,CAAY,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,0BAA0B,CAAC,CAAC;AACrG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAyC,EACzC,QAAuC;IAEvC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,YAAY,CACxB,eAAe,EACf,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,EACzC,QAAQ,CACT,CAAC;IACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AAClE,CAAC"}

package/dist/useNumericField.d.ts

@@ -0,0 +1,25 @@
+import { type FieldControls, type FieldOptions } from './field.js';
+import { type FieldCtx } from './FieldContext.js';
+import { type NumericBounds, type ResolvedNumeric } from './numeric.js';
+import type { ErrorRoutesRegistry } from './types.js';
+export type NumericOwnOptions<Ctx = any> = NumericBounds<Ctx>;
+export type NumericFieldOptions<RouteId extends string = string, Ctx = any> = FieldOptions<number, number, RouteId, Ctx> & NumericOwnOptions<Ctx>;
+export interface NumericFieldControls extends FieldControls<number, number>, ResolvedNumeric {
+    /** The value, formatted (default: the number and the unit; `format` overrides it). */
+    valueText: string;
+}
+/**
+ * The implicit initial value for a numeric field: `initialValue` resolved, else `min` (or 0),
+ * clamped into the bounds. Only those options are resolved, not `format`, so a `format` of the
+ * field context needs no provider here.
+ */
+export declare function numericInitialValue(opts: NumericFieldOptions, ctx: FieldCtx, id: string): number;
+/**
+ * A field whose value is a single number (moxb's Numeric). The shown value is always clamped
+ * into the bounds, then rounded when `integer`, since a value from outside (a stored or
+ * passed-in one) may fall outside them or be fractional even when every request this hook makes
+ * fits. A request is clamped and rounded the same way; a non-finite request (e.g. a widget
+ * parsing `''`) is refused with a warning, as a disabled field refuses any request.
+ */
+export declare function useNumericField<RouteId extends string = string, Ctx = any>(opts: NumericFieldOptions<RouteId, Ctx>, registry?: ErrorRoutesRegistry<RouteId>): NumericFieldControls;
+//# sourceMappingURL=useNumericField.d.ts.map

package/dist/useNumericField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNumericField.d.ts","sourceRoot":"","sources":["../src/useNumericField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAyB,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,iBAAiB,CAAC,GAAG,GAAG,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;AAE9D,MAAM,MAAM,mBAAmB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,IACxE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAEtE,MAAM,WAAW,oBAAqB,SAAQ,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe;IAC1F,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAMhG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,EACxE,IAAI,EAAE,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,EACvC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,oBAAoB,CA6BtB"}

package/dist/useNumericField.js

@@ -0,0 +1,52 @@
+import { useFieldCore } from './field.js';
+import { useFieldContext } from './FieldContext.js';
+import { resolveIn } from './resolve.js';
+import { clamp, resolveNumeric } from './numeric.js';
+/**
+ * The implicit initial value for a numeric field: `initialValue` resolved, else `min` (or 0),
+ * clamped into the bounds. Only those options are resolved, not `format`, so a `format` of the
+ * field context needs no provider here.
+ */
+export function numericInitialValue(opts, ctx, id) {
+    const resolved = resolveIn(opts.initialValue, undefined, ctx, `Field '${id}': option 'initialValue'`);
+    if (resolved !== undefined)
+        return resolved;
+    const min = resolveIn(opts.min, undefined, ctx, `Field '${id}': option 'min'`);
+    const max = resolveIn(opts.max, undefined, ctx, `Field '${id}': option 'max'`);
+    return clamp(min ?? 0, min, max);
+}
+/**
+ * A field whose value is a single number (moxb's Numeric). The shown value is always clamped
+ * into the bounds, then rounded when `integer`, since a value from outside (a stored or
+ * passed-in one) may fall outside them or be fractional even when every request this hook makes
+ * fits. A request is clamped and rounded the same way; a non-finite request (e.g. a widget
+ * parsing `''`) is refused with a warning, as a disabled field refuses any request.
+ */
+export function useNumericField(opts, registry) {
+    const ctx = useFieldContext();
+    const resolved = resolveNumeric(opts.id, opts, ctx);
+    const inside = !opts.onChange && !opts.commit;
+    const initialValue = () => numericInitialValue(opts, ctx, opts.id);
+    const field = useFieldCore('numeric', inside ? { ...opts, initialValue } : opts, registry);
+    /** A number clamped into the bounds, then rounded when `integer`. */
+    const fit = (n) => {
+        const clamped = clamp(n, resolved.min, resolved.max);
+        return resolved.integer ? Math.round(clamped) : clamped;
+    };
+    const value = fit(field.value);
+    const setValue = (next) => {
+        if (!Number.isFinite(next)) {
+            console.warn(`Field '${opts.id}': '${next}' is not a finite number`);
+            return;
+        }
+        field.setValue(fit(next));
+    };
+    return {
+        ...field,
+        ...resolved,
+        value,
+        setValue,
+        valueText: resolved.format(value),
+    };
+}
+//# sourceMappingURL=useNumericField.js.map

package/dist/useNumericField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNumericField.js","sourceRoot":"","sources":["../src/useNumericField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,eAAe,EAAiB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,cAAc,EAA4C,MAAM,cAAc,CAAC;AAa/F;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAyB,EAAE,GAAa,EAAE,EAAU;IACtF,MAAM,QAAQ,GAAG,SAAS,CAAqB,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,0BAA0B,CAAC,CAAC;IAC1H,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAqB,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACnG,MAAM,GAAG,GAAG,SAAS,CAAqB,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACnG,OAAO,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAuC,EACvC,QAAuC;IAEvC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,YAAY,CAA+B,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEzH,qEAAqE;IACrE,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QACrD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1D,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE/B,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE;QAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,OAAO,IAAI,0BAA0B,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,KAAK;QACR,GAAG,QAAQ;QACX,KAAK;QACL,QAAQ;QACR,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/useOneOfField.d.ts

@@ -1,38 +1,22 @@
-import type { ReactNode } from 'react';
 import { type FieldControls, type FieldOptions } from './field.js';
-import type { Decision, ErrorRoutesRegistry, ValueOrFn } from './types.js';
-/** One choice of a one-of field (moxb's BindOneOfChoice). */
-export interface OneOfChoice<T extends string = string> {
-    value: T;
-    /** Shown for the choice; default: the value. */
-    label?: string;
-    /** What choosing it does (moxb's `help`), markdown; also the field's current state when it is chosen. */
-    description?: string;
-    /** Shown before the label (or instead of it, for an icon-only widget), like an action's icon. */
-    icon?: ReactNode;
-    /** Choosable? Default true, optionally with a reason. Use `enabled` or `disabled`, not contradicting each other. */
-    enabled?: Decision;
-    disabled?: Decision;
-    /** Shown as the main or a dangerous choice, like an action's variant. Default 'default'. */
-    variant?: 'default' | 'primary' | 'danger';
-    /** A heading the choice is listed under, after the choices without one (OneOfSelect); default none. */
-    group?: string;
-}
-/** A choice as the widgets get it. */
-export interface OneOfChoiceControls<T extends string = string> {
-    value: T;
-    label: string;
-    description: string | undefined;
-    icon: ReactNode | undefined;
-    enabled: boolean;
-    whyDisabled: string | undefined;
-    variant: 'default' | 'primary' | 'danger';
-    group: string | undefined;
-}
-export type OneOfFieldOptions<T extends string = string, RouteId extends string = string> = FieldOptions<T, T, RouteId> & {
-    /** The choices, in order; static or derived. */
-    choices: ValueOrFn<OneOfChoice<T>[]>;
+import { type OneOfChoice, type OneOfChoiceControls } from './choices.js';
+import { type FieldCtx } from './FieldContext.js';
+import type { ErrorRoutesRegistry, ValueOrFn } from './types.js';
+export type { OneOfChoice, OneOfChoiceControls };
+export type OneOfOwnOptions<T extends string = string, Ctx = any> = {
+    /** The choices, in order; static or derived (a function, of the field context if it declares a parameter). */
+    choices: ValueOrFn<OneOfChoice<T>[], Ctx>;
 };
+export type OneOfFieldOptions<T extends string = string, RouteId extends string = string, Ctx = any> = FieldOptions<T, T, RouteId, Ctx> & OneOfOwnOptions<T, Ctx>;
+/**
+ * The implicit initial value for a one-of field: `initialValue` resolved through the field
+ * context, else the first enabled choice. Resolving first (rather than `opts.initialValue ??
+ * ...`) matters when `initialValue` is a context function that returns undefined: `??` would
+ * see the function, not its result, and never fall back.
+ */
+export declare function oneOfInitialValue<T extends string>(opts: {
+    initialValue?: ValueOrFn<T>;
+}, ctx: FieldCtx, id: string, choices: OneOfChoiceControls<T>[]): T | undefined;
 export interface OneOfFieldControls<T extends string = string> extends FieldControls<T, T> {
     choices: OneOfChoiceControls<T>[];
     /** The choice the value is, if it is one of them. */
@@ -47,5 +31,5 @@ export interface OneOfFieldControls<T extends string = string> extends FieldCont
  * warning, as a disabled field ignores any request. Inside the field the value
  * starts at `initialValue`, else at the first enabled choice.
  */
-export declare function useOneOfField<T extends string = string, RouteId extends string = string>(opts: OneOfFieldOptions<T, RouteId>, registry?: ErrorRoutesRegistry<RouteId>): OneOfFieldControls<T>;
+export declare function useOneOfField<T extends string = string, RouteId extends string = string, Ctx = any>(opts: OneOfFieldOptions<T, RouteId, Ctx>, registry?: ErrorRoutesRegistry<RouteId>): OneOfFieldControls<T>;
 //# sourceMappingURL=useOneOfField.d.ts.map

package/dist/useOneOfField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOneOfField.d.ts","sourceRoot":"","sources":["../src/useOneOfField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAkC,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGnG,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3E,6DAA6D;AAC7D,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACpD,KAAK,EAAE,CAAC,CAAC;IACT,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iGAAiG;IACjG,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,oHAAoH;IACpH,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,uGAAuG;IACvG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC5D,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,IACtF,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG;IAC5B,gDAAgD;IAChD,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;CACtC,CAAC;AAEJ,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IACxF,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,qDAAqD;IACrD,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CAC7C;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,EACtF,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,EACnC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,kBAAkB,CAAC,CAAC,CAAC,CA2BvB"}
+{"version":3,"file":"useOneOfField.d.ts","sourceRoot":"","sources":["../src/useOneOfField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIjE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;AAEjD,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,IAAI;IAClE,8GAA8G;IAC9G,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,IACjG,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;CAAE,EACrC,GAAG,EAAE,QAAQ,EACb,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAChC,CAAC,GAAG,SAAS,CAGf;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IACxF,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,qDAAqD;IACrD,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,GAAG,EACjG,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EACxC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,kBAAkB,CAAC,CAAC,CAAC,CA8BvB"}

package/dist/useOneOfField.js

@@ -1,19 +1,16 @@
-import { calculateEnabled, useFieldCore } from './field.js';
-import { getReason, getVerdict } from './decision.js';
-import { resolve } from './resolve.js';
-function resolveChoice(fieldId, choice) {
-    const decision = calculateEnabled(`${fieldId}.${choice.value}`, choice.enabled, choice.disabled);
-    const enabled = getVerdict(decision, true);
-    return {
-        value: choice.value,
-        label: choice.label ?? choice.value,
-        description: choice.description,
-        icon: choice.icon,
-        enabled,
-        whyDisabled: enabled ? undefined : getReason(decision),
-        variant: choice.variant ?? 'default',
-        group: choice.group,
-    };
+import { useFieldCore } from './field.js';
+import { resolveChoice } from './choices.js';
+import { useFieldContext } from './FieldContext.js';
+import { resolveIn } from './resolve.js';
+/**
+ * The implicit initial value for a one-of field: `initialValue` resolved through the field
+ * context, else the first enabled choice. Resolving first (rather than `opts.initialValue ??
+ * ...`) matters when `initialValue` is a context function that returns undefined: `??` would
+ * see the function, not its result, and never fall back.
+ */
+export function oneOfInitialValue(opts, ctx, id, choices) {
+    const resolved = resolveIn(opts.initialValue, undefined, ctx, `Field '${id}': option 'initialValue'`);
+    return resolved ?? choices.find((c) => c.enabled)?.value;
 }
 /**
  * A field whose value is one of a list of choices (moxb's OneOf). Rendered by
@@ -25,9 +22,12 @@ function resolveChoice(fieldId, choice) {
  * starts at `initialValue`, else at the first enabled choice.
  */
 export function useOneOfField(opts, registry) {
-    const choices = resolve(opts.choices, []).map((c) => resolveChoice(opts.id, c));
+    const ctx = useFieldContext();
+    const choices = resolveIn(opts.choices, [], ctx, `Field '${opts.id}': option 'choices'`)
+        .map((c) => resolveChoice(opts.id, c));
     const inside = !opts.onChange && !opts.commit;
-    const initialValue = opts.initialValue ?? choices.find((c) => c.enabled)?.value;
+    // Undefined when no choice is enabled, and then so is the value.
+    const initialValue = () => oneOfInitialValue(opts, ctx, opts.id, choices);
     const field = useFieldCore('oneOf', inside ? { ...opts, initialValue } : opts, registry);
     const current = choices.find((c) => c.value === field.value);
     const setValue = (next) => {

package/dist/useOneOfField.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOneOfField.js","sourceRoot":"","sources":["../src/useOneOfField.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA6CvC,SAAS,aAAa,CAAmB,OAAe,EAAE,MAAsB;IAC9E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK;QACnC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO;QACP,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;QACtD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS;QACpC,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAmC,EACnC,QAAuC;IAEvC,MAAM,OAAO,GAAG,OAAO,CAAmB,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAClG,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAChF,MAAM,KAAK,GAAG,YAAY,CAAgB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxG,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,CAAC,IAAO,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,OAAO,IAAI,6BAA6B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,cAAc,IAAI,mBAAmB,MAAM,CAAC,WAAW,IAAI,aAAa,EAAE,CAAC,CAAC;YAC1G,OAAO;QACT,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,KAAK;QACR,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,OAAO,EAAE,WAAW;QAChE,QAAQ;QACR,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useOneOfField.js","sourceRoot":"","sources":["../src/useOneOfField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,aAAa,EAA8C,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,eAAe,EAAiB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAezC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAqC,EACrC,GAAa,EACb,EAAU,EACV,OAAiC;IAEjC,MAAM,QAAQ,GAAG,SAAS,CAAgB,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,0BAA0B,CAAC,CAAC;IACrH,OAAO,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;AAC3D,CAAC;AAQD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAwC,EACxC,QAAuC;IAEvC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,SAAS,CAAmB,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,IAAI,CAAC,EAAE,qBAAqB,CAAC;SACvG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,iEAAiE;IACjE,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAM,CAAC;IAC/E,MAAM,KAAK,GAAG,YAAY,CAAqB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7G,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,CAAC,IAAO,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,OAAO,IAAI,6BAA6B,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,cAAc,IAAI,mBAAmB,MAAM,CAAC,WAAW,IAAI,aAAa,EAAE,CAAC,CAAC;YAC1G,OAAO;QACT,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,KAAK;QACR,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,OAAO,EAAE,WAAW;QAChE,QAAQ;QACR,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC"}