vultus-core 0.5.3 → 0.5.4

package/README.md

@@ -31,7 +31,8 @@ npm install vultus-core
   `initialValueOf`, `valueTypeOf`, `sanitizeStored`); the argument layer
   (the value types, `memoryStore`, `localStorageStore`, `ArgStoreProvider` /
   `useArgStore`, `useArg`, `useArgWriter`, `setArg` / `resetArg`, `argOf`,
-  `useStoredField` / `useStoredFields`); `InternalLinkContext` /
+  `useStoredField` / `useStoredFields`); field groups (`useFieldGroup` and
+  its `FieldGroup` type); `InternalLinkContext` /
   `useInternalLink` / `InternalLinkComponent`, `MessageSinkContext` /
   `useMessageSink` / `MessageSink`, and `VultusComponentsContext` /
   `useVultusComponents` / `SpinnerScope` / `useSpinnerKey` /
@@ -466,6 +467,121 @@ function Category() {
 }
 ```
 
+## Field groups
+
+A field's options sometimes depend on another field's value: a print dialog offers some paper
+sizes only for one layout, a filter shows a sub-filter only when another is on. With hooks, an
+option takes a value computed from the other field's controls. Definitions as data say it
+through the field context: `useFieldGroup(definitions)` runs a list of definitions together, and
+every option function of each one receives `ctx.values`, the group's values by field id.
+
+```tsx
+const printOptions: FieldDefinition[] = [
+  { kind: 'oneOf', id: 'layout', choices: [{ value: 'rendered' }, { value: 'original' }] },
+  { kind: 'oneOf', id: 'paper', choices: (ctx) => (ctx.values.layout === 'rendered' ? A_SIZES : ALL_SIZES) },
+  { kind: 'numeric', id: 'copies', min: 1, visible: (ctx) => ctx.values.layout === 'original' },
+];
+
+function PrintDialog() {
+  const group = useFieldGroup(printOptions);
+  return <>{group.fields.map((f) => <FieldWidget key={f.id} field={f} item />)}</>;
+}
+```
+
+It returns `fields`, each field's controls exactly as its kind's hook returns them, in definition
+order; `byId`, the same controls by id; `values`, the shown values by id as of this render (a
+plain object, which keeps its identity until a shown value changes, so an effect keyed on it runs
+only then); `isDefault(id)` (an id not in the group throws), `changedCount` and `resetAll()`
+("more filters (3)", "clear all"). The controls are typed `FieldControls`, which every widget
+takes; for a kind's own controls (a tree's `nodes`, numeric's `format`), cast by kind:
+`group.byId.toc as OneOfTreeFieldControls<string>`.
+
+**References.** Every option function of a group's definition receives `ctx.values` (`label`,
+`description`, `placeholder`, `visible` / `hidden`, `enabled` / `disabled`, `choices`, a tree's
+`nodes`, `min` / `max`, numeric's `format(n, ctx)`, ...), beside the keys of the app's own field
+context (the nearest `FieldContextProvider`), which keep working. A function the controls keep
+and call later (`format`, through `field.format(n)`) sees the group's values too. `initialValue`
+cannot read them. In a plain `FieldDefinition` the context is untyped (`any`); an app wanting
+`ctx.values` typed declares `values` in its context type (`FieldDefinition<Ctx>`,
+`createFieldContext<Ctx>()`).
+
+**The fallback rule.** A field's shown value is its kept value checked as a stored value is
+(`sanitizeStored`), with its options evaluated in the group's context. A value that another
+field's change made invalid (a paper size the layout no longer offers) shows the field's
+fallback, and the other fields see that fallback. Nothing is rewritten: the kept value shows
+again once it is valid again (the layout back). A hidden field keeps its value, and the others
+still see it.
+
+**Defaults follow the options.** A field's default is its `initialValue`, else its kind's
+implicit initial value from its options as they are now (the first enabled choice of its current
+`choices`, a tree's first choosable node, `min`, ...), so it moves with the fields those options
+read. A field never set, or set to its current default, keeps nothing and shows its current
+default as it moves. `isDefault(id)` is useStoredFields' rule: nothing kept, or the kept value or
+the value shown equals the current default.
+
+**Errors.** These fail loudly, naming the field and the option where there is one:
+
+- an option reading an id not in the group: `Field 'paper': option 'choices': no field 'layot'
+  in the group (fields: layout, paper, copies)`;
+- reading `ctx.values` outside a group, with a `FieldContextProvider` above: `... ctx.values is
+  only available inside a field group`; with none, a function declaring `ctx` gets the existing
+  `... is a function of the field context, but no FieldContextProvider is above it`;
+- `initialValue` reading `ctx.values`: `... initialValue cannot read other fields' values`;
+- fields whose values depend on each other (A's choices read B, and B's read A): `Fields 'a' ->
+  'b' -> 'a' depend on each other's values`. Options that never affect a value (`visible`,
+  `enabled`, `label`, `unit`, `format`, ...) cannot form a cycle;
+- two definitions with the same id; a mixed-boolean definition (it shows an aggregate of other
+  data, not a value of its own); an app field context that already has `values` (the group
+  would shadow it);
+- a list of another shape than the first render's. The hooks run per field, so the ids and kinds
+  stay the same, in the same order: to swap lists, remount the component running the group with
+  a React `key`. The definitions' contents may change, and new objects of the same shape on
+  every render (inline literals) are fine.
+
+**Storage**, for the whole group, is the runner's choice. By default the group keeps the values
+in its own state, as a store keeps them: a field without a kept value shows its current default,
+and a value set equal to it is not kept. A fallback is silent here, as it is the designed
+behaviour, not bad input. `resetAll()` clears every kept value.
+
+With `useFieldGroup(definitions, { stored: true })` the values live in the nearest `ArgStore`
+(the URL through vultus-react-router's `<ReactRouterArgStore>`, or localStorage) under each
+field's id, as `useStoredField` keeps a single field there, all read in one store subscription:
+
+```tsx
+const filters: FieldDefinition[] = [
+  { kind: 'text', id: 'search' },
+  { kind: 'oneOfTree', id: 'toc', optional: true, nodes: CHAPTERS, widget: 'list', visible: (ctx) => ctx.values.search === '' },
+];
+
+function Filters() {
+  const group = useFieldGroup(filters, { stored: true }); // ?search=...&toc=...
+  return <>{group.fields.map((f) => <FieldWidget key={f.id} field={f} />)}</>;
+}
+```
+
+An absent key reads as the field's current default, and a value equal to it is written as an
+absent key (with `'replace'`). The default compared with is the one under the store's values at
+the moment of the write (a store reads its own writes back at once), so, as in the group's own
+state, `layout.setValue('original'); paper.setValue('a4')` in one handler keeps `a4` even where
+`a4` was paper's default under the old layout. Each field's `hrefFor` links a value through the
+store, as rendered (`undefined` where the store has no links). The fallback rule is the same,
+and the stored value is never rewritten (the search above hides `toc`; `?toc=` stays). A stored
+raw value that does not parse, or does not fit its field, warns once, in the render that first
+reads it, as `useStoredField`'s does; one that does not parse reads as the current default. A
+value that another field's change makes fall back later does not warn: that is how a group
+behaves, not bad input. Nor does a raw value the group itself wrote:
+`layout.setValue('rendered'); paper.setValue('letter')` in one handler (Letter offered under the
+original layout) stores `letter`, which falls back at once; the warnings are for raw values from
+elsewhere (the URL, another tab). `resetAll(method = 'replace')` removes every field's key in one store
+write (one history entry). Switching between the two storages is a change of shape: it throws
+(remount with a React `key`).
+
+**Rendering.** vultus-antd's `<FieldWidget>` renders the controls (by the definition's `widget`
+hint; `item` for a labelled form item), in order as above or by id
+(`<FieldWidget field={group.byId.paper} />`). A request goes through the kind's own checks (a
+paper size the layout does not offer is refused with a warning, as the kind's hook alone refuses
+it). The group then keeps the value and re-renders, so every option is computed again.
+
 ## Components
 
 `VultusComponentsContext` (default `{}`) / `useVultusComponents()` is how an app lends its own

package/dist/FieldContext.d.ts

@@ -6,6 +6,22 @@ import { type JSX, type ReactNode } from 'react';
 export declare const NO_FIELD_CONTEXT: unique symbol;
 /** The field context as the hooks hold it: the guarded value, or the mark that there is none. */
 export type FieldCtx = object | typeof NO_FIELD_CONTEXT;
+/**
+ * What the guard throws for a key no provider gave, so readingContext can tell it from the
+ * function's own errors. Exported for the field group (fieldGroupValues), whose own reads that
+ * fail (an id not in the group, `values` read from `initialValue`) get the field and option in
+ * front the same way; not part of the package's API.
+ */
+export declare class MissingKeyError extends Error {
+}
+/**
+ * `raw` guarded against reading a key it lacks: such a read throws a MissingKeyError with
+ * `missing(key)` as its message, which readingContext puts the field and the option in front
+ * of. `has` says whether `raw` has the key; by default inherited members (`toString`) count,
+ * and `Object.hasOwn` makes them missing too. Probes and symbol keys read as usual. Exported for
+ * the field group's `values` (an id not in the group); not part of the package's API.
+ */
+export declare function guardKeys(raw: object, missing: (key: string) => string, has?: (target: object, key: string) => boolean): object;
 /**
  * Runs `read`, a call of a definition's function with the field context. A key it reads that
  * no provider gave throws with `where` (`Field '<id>': option '<name>'`) in front of the
@@ -33,6 +49,26 @@ export declare function createFieldContext<Ctx extends object>(): {
         children?: ReactNode;
     }) => JSX.Element;
 };
-/** The field context the hooks resolve functions with: the guarded value, or NO_FIELD_CONTEXT. */
+/**
+ * A field context with `base`'s keys (none for NO_FIELD_CONTEXT) and `extra`'s, guarded as a
+ * provider's value is: how a field group gives its fields' functions `values` beside the app's
+ * own keys. `extra`'s properties are copied as defined, so a getter among them runs when its
+ * key is read, not here. A key of `extra` that `base` already has throws, `where` in front,
+ * instead of shadowing the app's value; every key the copy takes is checked (non-enumerable
+ * and symbol keys too).
+ */
+export declare function extendFieldContext(base: FieldCtx, extra: Record<string, unknown>, where: string): object;
+/**
+ * Runs `run` with `ctx` as the field context: a hook it calls gets `ctx` from useFieldContext
+ * instead of the providers' value. It is for a hook that calls other hooks in its own render,
+ * each with its own context (a field group runs each field's kind hook with the group's); the
+ * components rendered below do not see it. `run` must be synchronous: the previous context
+ * comes back when it returns or throws. Calls nest.
+ */
+export declare function withFieldContext<T>(ctx: FieldCtx, run: () => T): T;
+/**
+ * The field context the hooks resolve functions with: the one withFieldContext gives while it
+ * runs, else the providers' guarded value, or NO_FIELD_CONTEXT.
+ */
 export declare function useFieldContext(): FieldCtx;
 //# sourceMappingURL=FieldContext.d.ts.map

package/dist/FieldContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FieldContext.d.ts","sourceRoot":"","sources":["../src/FieldContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,MAAwC,CAAC;AAE/E,iGAAiG;AACjG,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,gBAAgB,CAAC;AA2CxD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAOjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,eAShG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,SAAS,MAAM,KAAK;IACxD,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;KAAE,KAAK,GAAG,CAAC,OAAO,CAAC;CACjF,CAEA;AAED,kGAAkG;AAClG,wBAAgB,eAAe,IAAI,QAAQ,CAE1C"}
+{"version":3,"file":"FieldContext.d.ts","sourceRoot":"","sources":["../src/FieldContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,MAAwC,CAAC;AAE/E,iGAAiG;AACjG,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,gBAAgB,CAAC;AAwBxD;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAChC,GAAG,GAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAwC,GAC7E,MAAM,CAOR;AAcD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAOjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,eAShG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,SAAS,MAAM,KAAK;IACxD,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;KAAE,KAAK,GAAG,CAAC,OAAO,CAAC;CACjF,CAEA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxG;AAKD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAQlE;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAI1C"}

package/dist/FieldContext.js

@@ -18,24 +18,41 @@ const PROBED_KEYS = new Set([
 function isProbe(key) {
     return PROBED_KEYS.has(key) || key.startsWith('@@');
 }
-/** What the guard throws for a key no provider gave, so readingContext can tell it from the function's own errors. */
-class MissingKeyError extends Error {
+/**
+ * What the guard throws for a key no provider gave, so readingContext can tell it from the
+ * function's own errors. Exported for the field group (fieldGroupValues), whose own reads that
+ * fail (an id not in the group, `values` read from `initialValue`) get the field and option in
+ * front the same way; not part of the package's API.
+ */
+export class MissingKeyError extends Error {
 }
 /**
- * The context value as the definitions' functions receive it: reading a key that no provider
- * gave throws, naming it and the keys present, so a forgotten value fails loudly instead of
- * passing `undefined` along. A key provided with the value `undefined` is fine.
+ * `raw` guarded against reading a key it lacks: such a read throws a MissingKeyError with
+ * `missing(key)` as its message, which readingContext puts the field and the option in front
+ * of. `has` says whether `raw` has the key; by default inherited members (`toString`) count,
+ * and `Object.hasOwn` makes them missing too. Probes and symbol keys read as usual. Exported for
+ * the field group's `values` (an id not in the group); not part of the package's API.
  */
-function guard(raw) {
+export function guardKeys(raw, missing, has = (target, key) => key in target) {
     return new Proxy(raw, {
         get(target, key, receiver) {
-            if (typeof key === 'string' && !isProbe(key) && !(key in target)) {
-                throw new MissingKeyError(`Field context: '${key}' was never provided (provided: ${Object.keys(target).join(', ')})`);
-            }
+            if (typeof key === 'string' && !isProbe(key) && !has(target, key))
+                throw new MissingKeyError(missing(key));
             return Reflect.get(target, key, receiver);
         },
     });
 }
+/**
+ * The context value as the definitions' functions receive it: reading a key that no provider
+ * gave throws, naming it and the keys present, so a forgotten value fails loudly instead of
+ * passing `undefined` along. A key provided with the value `undefined` is fine. `values` is the
+ * key a field group adds (extendFieldContext), so reading it from any other context says so.
+ */
+function guard(raw) {
+    return guardKeys(raw, (key) => (key === 'values'
+        ? 'ctx.values is only available inside a field group'
+        : `Field context: '${key}' was never provided (provided: ${Object.keys(raw).join(', ')})`));
+}
 /**
  * Runs `read`, a call of a definition's function with the field context. A key it reads that
  * no provider gave throws with `where` (`Field '<id>': option '<name>'`) in front of the
@@ -75,8 +92,48 @@ export function FieldContextProvider({ value, children }) {
 export function createFieldContext() {
     return { Provider: FieldContextProvider };
 }
-/** The field context the hooks resolve functions with: the guarded value, or NO_FIELD_CONTEXT. */
+/**
+ * A field context with `base`'s keys (none for NO_FIELD_CONTEXT) and `extra`'s, guarded as a
+ * provider's value is: how a field group gives its fields' functions `values` beside the app's
+ * own keys. `extra`'s properties are copied as defined, so a getter among them runs when its
+ * key is read, not here. A key of `extra` that `base` already has throws, `where` in front,
+ * instead of shadowing the app's value; every key the copy takes is checked (non-enumerable
+ * and symbol keys too).
+ */
+export function extendFieldContext(base, extra, where) {
+    const raw = base === NO_FIELD_CONTEXT ? {} : { ...base };
+    for (const key of Reflect.ownKeys(extra)) {
+        if (Object.hasOwn(raw, key))
+            throw new Error(`${where}: the field context already has '${String(key)}'; a field group provides it`);
+    }
+    return guard(Object.defineProperties(raw, Object.getOwnPropertyDescriptors(extra)));
+}
+/** The context withFieldContext gives the hooks it is running, if any. */
+let override;
+/**
+ * Runs `run` with `ctx` as the field context: a hook it calls gets `ctx` from useFieldContext
+ * instead of the providers' value. It is for a hook that calls other hooks in its own render,
+ * each with its own context (a field group runs each field's kind hook with the group's); the
+ * components rendered below do not see it. `run` must be synchronous: the previous context
+ * comes back when it returns or throws. Calls nest.
+ */
+export function withFieldContext(ctx, run) {
+    const previous = override;
+    override = ctx;
+    try {
+        return run();
+    }
+    finally {
+        override = previous;
+    }
+}
+/**
+ * The field context the hooks resolve functions with: the one withFieldContext gives while it
+ * runs, else the providers' guarded value, or NO_FIELD_CONTEXT.
+ */
 export function useFieldContext() {
-    return useContext(FieldContext)?.guarded ?? NO_FIELD_CONTEXT;
+    // Called under an override too, so that the hooks' order never depends on one.
+    const provided = useContext(FieldContext);
+    return override ?? provided?.guarded ?? NO_FIELD_CONTEXT;
 }
 //# sourceMappingURL=FieldContext.js.map

package/dist/FieldContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldContext.js","sourceRoot":"","sources":["../src/FieldContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAA4B,MAAM,OAAO,CAAC;AAErF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkB,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAW/E,MAAM,YAAY,GAAG,aAAa,CAAuB,SAAS,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB;CAC1G,CAAC,CAAC;AAEH,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,sHAAsH;AACtH,MAAM,eAAgB,SAAQ,KAAK;CAAG;AAEtC;;;;GAIG;AACH,SAAS,KAAK,CAAC,GAAW;IACxB,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE;QACpB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ;YACvB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;gBACjE,MAAM,IAAI,eAAe,CAAC,mBAAmB,GAAG,mCAAmC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxH,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAI,KAAa,EAAE,IAAa;IAC5D,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACtG,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAA2C;IAC/F,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACvC,4FAA4F;IAC5F,8FAA8F;IAC9F,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QACxC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACtC,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACnB,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAAG,QAAQ,GAAyB,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAGhC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC;AAC5C,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,YAAY,CAAC,EAAE,OAAO,IAAI,gBAAgB,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"FieldContext.js","sourceRoot":"","sources":["../src/FieldContext.tsx"],"names":[],"mappings":"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"}

package/dist/fieldGroupValues.d.ts

@@ -0,0 +1,63 @@
+import { type FieldCtx } from './FieldContext.js';
+import { type FieldDefinition } from './kinds.js';
+/**
+ * One render's values of a field group (see useFieldGroup): each field's shown value and
+ * default, computed on demand by id from the kept values, with the definitions' options
+ * evaluated in the group's context, and each computed once.
+ */
+export interface GroupValues {
+    /**
+     * The field context the group's option functions receive: the app's own keys (guarded as a
+     * provider's value is) and `values`, the fields' shown values by id.
+     */
+    ctx: object;
+    /**
+     * A field's shown value: its kept value, else its current default, made fit for its options
+     * as they are now (sanitizeStored); one that no longer fits shows the field's fallback. The
+     * kept value itself is never touched, so it shows again once it fits again.
+     */
+    valueOf(id: string): unknown;
+    /**
+     * A field's default: its `initialValue` (which cannot read `values`), else its kind's
+     * implicit initial value from its options as they are now (the first enabled choice, `min`,
+     * ...), so it moves with the fields those options read.
+     */
+    defaultOf(id: string): unknown;
+    /** The shown values by id, each computed when first read; `ctx.values` is the same object. */
+    values: Readonly<Record<string, unknown>>;
+}
+/** What createGroupValues computes the values from. */
+export interface GroupValuesParams {
+    /** The group's fields, as data: unique ids, no mixed-boolean. */
+    definitions: readonly FieldDefinition[];
+    /** The app's field context (useFieldContext), which `values` is added to. */
+    appCtx: FieldCtx;
+    /** A field's kept value; `undefined` when none is kept, so the field shows its current default. */
+    kept(id: string): unknown | undefined;
+    /**
+     * Where a kept value's sanitizing warnings go, with the field's id: the caller decides whether
+     * to show them (and how often). A default made fit is the definer's, not kept input, so it
+     * never warns.
+     */
+    warn(id: string, message: string): void;
+}
+/**
+ * The values of a field group for one render, computed from its definitions and kept values.
+ *
+ * Every option function of the definitions receives `ctx`: the app's field context and
+ * `values`, the fields' shown values by id. A field's value is computed when an option (or the
+ * caller) first reads it, and kept for the rest of this snapshot; a new render makes a new one.
+ * The shown value is the kept value (else the current default) checked against the field's
+ * options as they are now, as a store's value is (sanitizeStored); one that no longer fits
+ * shows the fallback, which the other fields see too.
+ *
+ * Throws here for two definitions with the same id and for a mixed-boolean definition (naming
+ * the field), and for an app context that already has `values`. Throws when read, naming the
+ * field and the option, for an option reading an id not in the group and for `initialValue`
+ * reading `values`. Fields whose values depend on each other throw when read, naming the cycle
+ * (`Fields 'a' -> 'b' -> 'a' depend on each other's values`): a field's value and default are in
+ * progress while its options run, and reading one in progress is a cycle. Options that never
+ * affect a value (`visible`, `label`, `unit`, ...) are not run here, so they cannot form one.
+ */
+export declare function createGroupValues({ definitions, appCtx, kept, warn }: GroupValuesParams): GroupValues;
+//# sourceMappingURL=fieldGroupValues.d.ts.map

package/dist/fieldGroupValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldGroupValues.d.ts","sourceRoot":"","sources":["../src/fieldGroupValues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAkC,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAElF;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,8FAA8F;IAC9F,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3C;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;IACxC,6EAA6E;IAC7E,MAAM,EAAE,QAAQ,CAAC;IACjB,mGAAmG;IACnG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACtC;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AA8BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,iBAAiB,GAAG,WAAW,CA4ErG"}

package/dist/fieldGroupValues.js

@@ -0,0 +1,119 @@
+import { extendFieldContext, guardKeys, MissingKeyError } from './FieldContext.js';
+import { initialValueOf, sanitizeStored } from './kinds.js';
+const WHERE = 'Field group';
+const INITIAL_VALUE_READS_VALUES = "initialValue cannot read other fields' values";
+const NOT_IN_A_GROUP = 'a mixed-boolean field shows an aggregate of other data, not a value of its own, so it cannot be in a field group';
+function silently(_message) { }
+/**
+ * A definition as its values are computed from it. Its `initialValue` function receives
+ * `initialCtx`, whose `values` throws: a default cannot depend on other fields' values. A
+ * number's or range's display options (`step`, `unit`, `format`) are left out, because resolving
+ * its bounds (resolveNumeric) resolves them too, and an option that never affects the value
+ * (`unit: (ctx) => ctx.values.copies === 1 ? ...`) must not count as a dependency, nor form a
+ * cycle.
+ */
+function forComputingValues(definition, initialCtx) {
+    const computing = { ...definition };
+    const { initialValue } = definition;
+    if (typeof initialValue === 'function') {
+        Object.assign(computing, { initialValue: () => initialValue(initialCtx) });
+    }
+    if (computing.kind === 'numeric' || computing.kind === 'range') {
+        delete computing.step;
+        delete computing.unit;
+        delete computing.format;
+    }
+    return computing;
+}
+/**
+ * The values of a field group for one render, computed from its definitions and kept values.
+ *
+ * Every option function of the definitions receives `ctx`: the app's field context and
+ * `values`, the fields' shown values by id. A field's value is computed when an option (or the
+ * caller) first reads it, and kept for the rest of this snapshot; a new render makes a new one.
+ * The shown value is the kept value (else the current default) checked against the field's
+ * options as they are now, as a store's value is (sanitizeStored); one that no longer fits
+ * shows the fallback, which the other fields see too.
+ *
+ * Throws here for two definitions with the same id and for a mixed-boolean definition (naming
+ * the field), and for an app context that already has `values`. Throws when read, naming the
+ * field and the option, for an option reading an id not in the group and for `initialValue`
+ * reading `values`. Fields whose values depend on each other throw when read, naming the cycle
+ * (`Fields 'a' -> 'b' -> 'a' depend on each other's values`): a field's value and default are in
+ * progress while its options run, and reading one in progress is a cycle. Options that never
+ * affect a value (`visible`, `label`, `unit`, ...) are not run here, so they cannot form one.
+ */
+export function createGroupValues({ definitions, appCtx, kept, warn }) {
+    const ids = definitions.map((definition) => definition.id);
+    for (const definition of definitions) {
+        if (ids.indexOf(definition.id) !== ids.lastIndexOf(definition.id)) {
+            throw new Error(`Field '${definition.id}': another field in the group has the same id`);
+        }
+        if (definition.kind === 'mixed-boolean')
+            throw new Error(`Field '${definition.id}': ${NOT_IN_A_GROUP}`);
+    }
+    const noField = (id) => `no field '${id}' in the group (fields: ${ids.join(', ')})`;
+    const getters = {};
+    for (const id of ids)
+        Object.defineProperty(getters, id, { get: () => valueOf(id), enumerable: true });
+    // Own keys only: `values.toString` is a typo for an id, not Object's member. `constructor`
+    // reads as usual, as the probes do, because printers (vitest's) name an object by it.
+    const values = guardKeys(getters, noField, (target, key) => key === 'constructor' || Object.hasOwn(target, key));
+    const ctx = extendFieldContext(appCtx, { values }, WHERE);
+    // `values` not enumerable: a missing key's message lists the keys provided, and this one only throws.
+    const initialCtx = extendFieldContext(appCtx, Object.defineProperty({}, 'values', {
+        get() {
+            throw new MissingKeyError(INITIAL_VALUE_READS_VALUES);
+        },
+    }), WHERE);
+    const computingDefinitions = new Map(definitions.map((definition) => [definition.id, forComputingValues(definition, initialCtx)]));
+    const shown = new Map();
+    const defaults = new Map();
+    /** The fields whose value or default is being computed, outermost first. */
+    const inProgress = [];
+    function definitionOf(id) {
+        const definition = computingDefinitions.get(id);
+        if (definition === undefined)
+            throw new MissingKeyError(noField(id));
+        return definition;
+    }
+    /** Runs `compute` with `id` in progress; reading `id` again before it returns is a cycle. */
+    function computing(id, compute) {
+        const at = inProgress.indexOf(id);
+        if (at !== -1) {
+            const cycle = [...inProgress.slice(at), id].map((each) => `'${each}'`).join(' -> ');
+            throw new Error(`Fields ${cycle} depend on each other's values`);
+        }
+        inProgress.push(id);
+        try {
+            return compute();
+        }
+        finally {
+            inProgress.pop();
+        }
+    }
+    /** The default, computed as part of `id`'s own value or default (already in progress). */
+    function ownDefault(id) {
+        if (!defaults.has(id))
+            defaults.set(id, initialValueOf(definitionOf(id), ctx));
+        return defaults.get(id);
+    }
+    function defaultOf(id) {
+        definitionOf(id);
+        return defaults.has(id) ? defaults.get(id) : computing(id, () => ownDefault(id));
+    }
+    function valueOf(id) {
+        const definition = definitionOf(id);
+        if (!shown.has(id)) {
+            shown.set(id, computing(id, () => {
+                const value = kept(id);
+                return value === undefined
+                    ? sanitizeStored(definition, ownDefault(id), ctx, silently)
+                    : sanitizeStored(definition, value, ctx, (message) => warn(id, message));
+            }));
+        }
+        return shown.get(id);
+    }
+    return { ctx, valueOf, defaultOf, values };
+}
+//# sourceMappingURL=fieldGroupValues.js.map

package/dist/fieldGroupValues.js.map

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

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export { localStorageStore } from './localStorageStore.js';
 export { ArgStoreProvider, useArgStore } from './ArgStoreContext.js';
 export { useArg, useArgWriter, setArg, resetArg, type ArgDefinition, type ArgControls, type ArgChange, } from './useArg.js';
 export { argOf, useStoredField, useStoredFields, type StoredField, type StoredFields, } from './useStoredField.js';
+export { useFieldGroup, type FieldGroup } from './useFieldGroup.js';
 export { InternalLinkContext, useInternalLink, type InternalLinkComponent } from './LinkContext.js';
 export { MessageSinkContext, useMessageSink, type MessageSink } from './MessageSink.js';
 export { VultusComponentsContext, useVultusComponents, SpinnerScope, useSpinnerKey, type VultusComponents, type SpinnerProps, type SpinnerComponent, } from './Components.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -27,6 +27,7 @@ export { localStorageStore } from './localStorageStore.js';
 export { ArgStoreProvider, useArgStore } from './ArgStoreContext.js';
 export { useArg, useArgWriter, setArg, resetArg, } from './useArg.js';
 export { argOf, useStoredField, useStoredFields, } from './useStoredField.js';
+export { useFieldGroup } from './useFieldGroup.js';
 export { InternalLinkContext, useInternalLink } from './LinkContext.js';
 export { MessageSinkContext, useMessageSink } from './MessageSink.js';
 export { VultusComponentsContext, useVultusComponents, SpinnerScope, useSpinnerKey, } from './Components.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,oBAAoB,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,GAC5E,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,GAGnE,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAA8C,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAiD,MAAM,mBAAmB,CAAC;AAClH,OAAO,EACL,iBAAiB,EAAE,aAAa,EAAE,qBAAqB,GAExD,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EAAE,iBAAiB,GACjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EAAE,kBAAkB,GAEnC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,cAAc,EAA4C,MAAM,cAAc,CAAC;AAC/F,OAAO,EACL,eAAe,EAAE,mBAAmB,GAErC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EAAE,iBAAiB,GAEjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAC/E,aAAa,EAAE,eAAe,EAAE,QAAQ,GAEzC,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,kBAAkB,EAAE,sBAAsB,GAE3C,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,EAAE,qBAAqB,GAEzC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,YAAY,EAAE,gBAAgB,GAE/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,GAC9D,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAwB,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAoD,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,GAEvC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,EAAE,cAAc,EAAE,eAAe,GACvC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAA8B,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAoB,MAAM,kBAAkB,CAAC;AACxF,OAAO,EACL,uBAAuB,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,GAE1E,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,oBAAoB,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,GAC5E,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,GAGnE,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAA8C,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAiD,MAAM,mBAAmB,CAAC;AAClH,OAAO,EACL,iBAAiB,EAAE,aAAa,EAAE,qBAAqB,GAExD,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EAAE,iBAAiB,GACjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EAAE,kBAAkB,GAEnC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,cAAc,EAA4C,MAAM,cAAc,CAAC;AAC/F,OAAO,EACL,eAAe,EAAE,mBAAmB,GAErC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EAAE,iBAAiB,GAEjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAC/E,aAAa,EAAE,eAAe,EAAE,QAAQ,GAEzC,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,kBAAkB,EAAE,sBAAsB,GAE3C,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,EAAE,qBAAqB,GAEzC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,YAAY,EAAE,gBAAgB,GAE/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,GAC9D,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAwB,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAoD,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,GAEvC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,EAAE,cAAc,EAAE,eAAe,GACvC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAmB,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAA8B,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAoB,MAAM,kBAAkB,CAAC;AACxF,OAAO,EACL,uBAAuB,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,GAE1E,MAAM,iBAAiB,CAAC"}

package/dist/kindHooks.d.ts

@@ -0,0 +1,23 @@
+import type { FieldControls } from './field.js';
+import type { FieldDefinition } from './kinds.js';
+/**
+ * A definition in its outside form, as its kind's hook takes it: without `initialValue` (whoever
+ * keeps the value keeps its default too), with the value, its writer, and the link a value
+ * amounts to where whoever keeps it has one.
+ */
+export type KindFieldOptions = OutsideForm<FieldDefinition>;
+/** The outside form of a definition, member by member for a union (the conditional type distributes). */
+type OutsideForm<D> = D extends FieldDefinition ? Omit<D, 'initialValue'> & {
+    value: unknown;
+    onChange(value: any): void;
+    hrefFor?(value: any): string | undefined;
+} : never;
+/**
+ * Runs the hook of `definition`'s kind with `options` and returns its controls, exactly as that
+ * hook returns them. The hook called depends on the kind, so a caller running several fields
+ * (useFieldGroup) keeps each field's kind the same across renders. A kind that is none of
+ * FieldKind's (plain data can carry anything) throws, naming the field.
+ */
+export declare function useKindField(definition: FieldDefinition, options: KindFieldOptions): FieldControls<any, any>;
+export {};
+//# sourceMappingURL=kindHooks.d.ts.map

package/dist/kindHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kindHooks.d.ts","sourceRoot":"","sources":["../src/kindHooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAWlD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;AAE5D,yGAAyG;AACzG,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,eAAe,GAC3C,IAAI,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GAClH,KAAK,CAAC;AAkBV;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAK5G"}

package/dist/kindHooks.js

@@ -0,0 +1,38 @@
+import { useBoolField } from './useBoolField.js';
+import { useManyOfField } from './useManyOfField.js';
+import { useManyOfTreeField } from './useManyOfTreeField.js';
+import { useMixedBoolField } from './useMixedBoolField.js';
+import { useNumericField } from './useNumericField.js';
+import { useOneOfField } from './useOneOfField.js';
+import { useOneOfTreeField } from './useOneOfTreeField.js';
+import { useRangeField } from './useRangeField.js';
+import { useTextField } from './useTextField.js';
+/**
+ * Each kind's hook. Its options are checked against the definition in kinds.ts
+ * (DefinitionsFitTheirHooks); the mapped type makes leaving a kind out a compile error.
+ */
+const KIND_HOOKS = {
+    boolean: useBoolField,
+    'mixed-boolean': useMixedBoolField,
+    oneOf: useOneOfField,
+    manyOf: useManyOfField,
+    numeric: useNumericField,
+    range: useRangeField,
+    manyOfTree: useManyOfTreeField,
+    oneOfTree: useOneOfTreeField,
+    text: useTextField,
+};
+/**
+ * Runs the hook of `definition`'s kind with `options` and returns its controls, exactly as that
+ * hook returns them. The hook called depends on the kind, so a caller running several fields
+ * (useFieldGroup) keeps each field's kind the same across renders. A kind that is none of
+ * FieldKind's (plain data can carry anything) throws, naming the field.
+ */
+export function useKindField(definition, options) {
+    const { id, kind } = definition;
+    if (!Object.hasOwn(KIND_HOOKS, kind))
+        throw new Error(`Field '${id}': unknown kind '${String(kind)}'`);
+    const useHook = KIND_HOOKS[kind];
+    return useHook(options);
+}
+//# sourceMappingURL=kindHooks.js.map

package/dist/kindHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kindHooks.js","sourceRoot":"","sources":["../src/kindHooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAcjD;;;GAGG;AACH,MAAM,UAAU,GAAoE;IAClF,OAAO,EAAE,YAAY;IACrB,eAAe,EAAE,iBAAiB;IAClC,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,eAAe;IACxB,KAAK,EAAE,aAAa;IACpB,UAAU,EAAE,kBAAkB;IAC9B,SAAS,EAAE,iBAAiB;IAC5B,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,UAA2B,EAAE,OAAyB;IACjF,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,oBAAoB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvG,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC"}