vultus-core 0.3.0 → 0.5.0

package/dist/localStorageStore.js

@@ -0,0 +1,72 @@
+/**
+ * An ArgStore over `window.localStorage` (Praeceptor's print options), items kept under
+ * `${prefix}.${key}`. Guarded for SSR/Node (`typeof window === 'undefined'`), so creating one
+ * outside a browser does not crash: reads then give `undefined` and writes are no-ops. A browser
+ * may block storage (a sandboxed frame, blocked site data) or refuse a write (quota), and then
+ * reaching or using `localStorage` throws: a read that fails reads as absent and a write that
+ * fails is skipped, with one warning per store rather than one per call.
+ *
+ * A write notifies this store's own subscribers; a `storage` event (another tab changed a key
+ * under the prefix) notifies them too. The store listens for that event on `window` only while
+ * it has subscribers, so a store that is dropped leaves no listener behind; still, create one
+ * once (outside render, or in `useMemo`) rather than on every render.
+ */
+export function localStorageStore(prefix) {
+    const hasWindow = typeof window !== 'undefined';
+    const listeners = new Set();
+    const storageKey = (key) => `${prefix}.${key}`;
+    // `null` means "another tab cleared the whole storage" (localStorage.clear()): every key under
+    // the prefix may have changed, so this counts as ours too.
+    const isOwnStorageKey = (key) => key === null || key.startsWith(`${prefix}.`);
+    const onStorage = (event) => {
+        if (isOwnStorageKey(event.key))
+            listeners.forEach((listener) => listener());
+    };
+    let warned = false;
+    /** Runs a use of localStorage; if it throws, warns (the first time for this store) and gives `undefined`. */
+    const guarded = (what, use) => {
+        try {
+            return use(window.localStorage);
+        }
+        catch (error) {
+            if (!warned) {
+                warned = true;
+                console.warn(`localStorageStore('${prefix}'): cannot ${what} localStorage (${String(error)}); `
+                    + 'failing reads read as absent and failing writes are skipped, without further warnings');
+            }
+            return undefined;
+        }
+    };
+    return {
+        read(key) {
+            if (!hasWindow)
+                return undefined;
+            return guarded('read', (storage) => storage.getItem(storageKey(key))) ?? undefined;
+        },
+        write(changes, _method) {
+            if (!hasWindow)
+                return;
+            for (const { key, raw } of changes) {
+                guarded('write', (storage) => {
+                    if (raw === undefined)
+                        storage.removeItem(storageKey(key));
+                    else
+                        storage.setItem(storageKey(key), raw);
+                });
+            }
+            listeners.forEach((listener) => listener());
+        },
+        subscribe(listener) {
+            if (hasWindow && listeners.size === 0)
+                window.addEventListener('storage', onStorage);
+            listeners.add(listener);
+            return () => {
+                if (!listeners.delete(listener))
+                    return;
+                if (hasWindow && listeners.size === 0)
+                    window.removeEventListener('storage', onStorage);
+            };
+        },
+    };
+}
+//# sourceMappingURL=localStorageStore.js.map

package/dist/localStorageStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStorageStore.js","sourceRoot":"","sources":["../src/localStorageStore.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IACxC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;IACvD,+FAA+F;IAC/F,2DAA2D;IAC3D,MAAM,eAAe,GAAG,CAAC,GAAkB,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IAC7F,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;QACxC,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC;IAEF,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,6GAA6G;IAC7G,MAAM,OAAO,GAAG,CAAI,IAAY,EAAE,GAA4B,EAAiB,EAAE;QAC/E,IAAI,CAAC;YACH,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,IAAI,CAAC;gBACd,OAAO,CAAC,IAAI,CACV,sBAAsB,MAAM,cAAc,IAAI,kBAAkB,MAAM,CAAC,KAAK,CAAC,KAAK;sBAChF,uFAAuF,CAC1F,CAAC;YACJ,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,CAAC,GAAG;YACN,IAAI,CAAC,SAAS;gBAAE,OAAO,SAAS,CAAC;YACjC,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QACrF,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,OAAO;YACpB,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,KAAK,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;gBACnC,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;oBAC3B,IAAI,GAAG,KAAK,SAAS;wBAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;;wBACtD,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC7C,CAAC,CAAC,CAAC;YACL,CAAC;YACD,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,SAAS,CAAC,QAAQ;YAChB,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;gBAAE,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACrF,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;oBAAE,OAAO;gBACxC,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;oBAAE,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC1F,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/normalizeText.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A key for accent- and case-insensitive comparison of labels (the tree hook's search,
+ * Taskmaster's): decompose, strip the combining marks, lower-case. No quaesitor dependency.
+ */
+export declare function normalizeText(text: string): string;
+//# sourceMappingURL=normalizeText.d.ts.map

package/dist/normalizeText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeText.d.ts","sourceRoot":"","sources":["../src/normalizeText.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/normalizeText.js

@@ -0,0 +1,8 @@
+/**
+ * A key for accent- and case-insensitive comparison of labels (the tree hook's search,
+ * Taskmaster's): decompose, strip the combining marks, lower-case. No quaesitor dependency.
+ */
+export function normalizeText(text) {
+    return text.normalize('NFD').replace(/\p{M}/gu, '').toLowerCase();
+}
+//# sourceMappingURL=normalizeText.js.map

package/dist/normalizeText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeText.js","sourceRoot":"","sources":["../src/normalizeText.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACpE,CAAC"}

package/dist/numeric.d.ts

@@ -0,0 +1,38 @@
+import { type FieldCtx } from './FieldContext.js';
+import type { ValueOrFn } from './types.js';
+/**
+ * The bounds and formatting a numeric field has, shared with the range kind (whose two ends
+ * reuse the same bounds). Each may be a context function, resolved like any other field option.
+ * `format` is not itself a ValueOrFn — it always takes the number as its first argument — so it
+ * is resolved by its own rule, below.
+ */
+export interface NumericBounds<Ctx = any> {
+    min?: ValueOrFn<number | undefined, Ctx>;
+    max?: ValueOrFn<number | undefined, Ctx>;
+    step?: ValueOrFn<number | undefined, Ctx>;
+    integer?: ValueOrFn<boolean, Ctx>;
+    unit?: ValueOrFn<string | undefined, Ctx>;
+    /** Formats a value for display; default: the number followed by the unit, if any. */
+    format?: (n: number, ctx: Ctx) => string;
+}
+/** A NumericBounds with every option resolved through the field context. */
+export interface ResolvedNumeric {
+    min: number | undefined;
+    max: number | undefined;
+    step: number | undefined;
+    integer: boolean;
+    unit: string | undefined;
+    format(n: number): string;
+}
+/** Clamps `n` into [min, max]; either end left out leaves that side open. */
+export declare function clamp(n: number, min?: number, max?: number): number;
+/**
+ * Resolves a numeric field's bounds and formatter with the field context. `format` goes by its
+ * own rule, not resolveIn's, as it always receives the number first; otherwise it is treated
+ * the same way. With a provider above, it receives the context as its second argument, and a
+ * key it reads that no provider gave throws naming the field and the option `'format'`. With
+ * none, a `format` that declares the context parameter (`format.length >= 2`) throws the same
+ * message shape resolveIn uses, and one that does not is called with the number alone.
+ */
+export declare function resolveNumeric(id: string, opts: NumericBounds, ctx: FieldCtx): ResolvedNumeric;
+//# sourceMappingURL=numeric.d.ts.map

package/dist/numeric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric.d.ts","sourceRoot":"","sources":["../src/numeric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,GAAG,GAAG,GAAG;IACtC,GAAG,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1C,qFAAqF;IACrF,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;CAC1C;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,6EAA6E;AAC7E,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,GAAG,eAAe,CAqB9F"}

package/dist/numeric.js

@@ -0,0 +1,43 @@
+import { NO_FIELD_CONTEXT, readingContext } from './FieldContext.js';
+import { resolveIn } from './resolve.js';
+/** Clamps `n` into [min, max]; either end left out leaves that side open. */
+export function clamp(n, min, max) {
+    let result = n;
+    if (min !== undefined)
+        result = Math.max(result, min);
+    if (max !== undefined)
+        result = Math.min(result, max);
+    return result;
+}
+/**
+ * Resolves a numeric field's bounds and formatter with the field context. `format` goes by its
+ * own rule, not resolveIn's, as it always receives the number first; otherwise it is treated
+ * the same way. With a provider above, it receives the context as its second argument, and a
+ * key it reads that no provider gave throws naming the field and the option `'format'`. With
+ * none, a `format` that declares the context parameter (`format.length >= 2`) throws the same
+ * message shape resolveIn uses, and one that does not is called with the number alone.
+ */
+export function resolveNumeric(id, opts, ctx) {
+    const where = (name) => `Field '${id}': option '${name}'`;
+    const min = resolveIn(opts.min, undefined, ctx, where('min'));
+    const max = resolveIn(opts.max, undefined, ctx, where('max'));
+    const step = resolveIn(opts.step, undefined, ctx, where('step'));
+    const integer = resolveIn(opts.integer, false, ctx, where('integer'));
+    const unit = resolveIn(opts.unit, undefined, ctx, where('unit'));
+    const { format } = opts;
+    let resolvedFormat;
+    if (format === undefined) {
+        resolvedFormat = (n) => `${n}${unit ?? ''}`;
+    }
+    else if (ctx !== NO_FIELD_CONTEXT) {
+        resolvedFormat = (n) => readingContext(where('format'), () => format(n, ctx));
+    }
+    else if (format.length < 2) {
+        resolvedFormat = (n) => format(n, undefined);
+    }
+    else {
+        throw new Error(`${where('format')} is a function of the field context, but no FieldContextProvider is above it`);
+    }
+    return { min, max, step, integer, unit, format: resolvedFormat };
+}
+//# sourceMappingURL=numeric.js.map

package/dist/numeric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric.js","sourceRoot":"","sources":["../src/numeric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAiB,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA6BzC,6EAA6E;AAC7E,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,GAAY,EAAE,GAAY;IACzD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,IAAmB,EAAE,GAAa;IAC3E,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,EAAE,cAAc,IAAI,GAAG,CAAC;IAClE,MAAM,GAAG,GAAG,SAAS,CAAqB,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,SAAS,CAAqB,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,SAAS,CAAqB,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,SAAS,CAAU,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,SAAS,CAAqB,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAErF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,IAAI,cAAqC,CAAC;IAC1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,cAAc,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;IAC9C,CAAC;SAAM,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;QACpC,cAAc,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAY,CAAC,CAAC,CAAC;IACzF,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,cAAc,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,SAAkB,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,8EAA8E,CAAC,CAAC;IACpH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AACnE,CAAC"}

package/dist/resolve.d.ts

@@ -1,3 +1,16 @@
+import { type FieldCtx } from './FieldContext.js';
 import type { ValueOrFn } from './types.js';
 export declare function resolve<T>(v: ValueOrFn<T> | undefined, fallback: T): T;
+/**
+ * Resolves a field's option with its context. With a provider above, every function receives
+ * `ctx`, so one whose parameter has a default (`(ctx = {}) => ...`) gets it too. With none, a
+ * function without declared parameters is called with nothing, so it works without a provider,
+ * and one that declares a parameter throws, `where` (`Field '<id>': option '<name>'`) saying
+ * whose it is. A key the function reads that no provider gave throws with `where` in front, so
+ * that error names the field and the option too. A function that returns `undefined` counts as
+ * an absent option, and yields `fallback` — a context lookup that misses (e.g. `(ctx) =>
+ * ctx.items[id]`) should fall back exactly as leaving the option out would, not leave the field
+ * with no value at all.
+ */
+export declare function resolveIn<T>(v: ValueOrFn<T> | undefined, fallback: T, ctx: FieldCtx, where: string): T;
 //# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAGtE"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAGtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAStG"}

package/dist/resolve.js

@@ -1,6 +1,31 @@
+import { NO_FIELD_CONTEXT, readingContext } from './FieldContext.js';
 export function resolve(v, fallback) {
     if (v === undefined)
         return fallback;
     return typeof v === 'function' ? v() : v;
 }
+/**
+ * Resolves a field's option with its context. With a provider above, every function receives
+ * `ctx`, so one whose parameter has a default (`(ctx = {}) => ...`) gets it too. With none, a
+ * function without declared parameters is called with nothing, so it works without a provider,
+ * and one that declares a parameter throws, `where` (`Field '<id>': option '<name>'`) saying
+ * whose it is. A key the function reads that no provider gave throws with `where` in front, so
+ * that error names the field and the option too. A function that returns `undefined` counts as
+ * an absent option, and yields `fallback` — a context lookup that misses (e.g. `(ctx) =>
+ * ctx.items[id]`) should fall back exactly as leaving the option out would, not leave the field
+ * with no value at all.
+ */
+export function resolveIn(v, fallback, ctx, where) {
+    if (v === undefined)
+        return fallback;
+    if (typeof v !== 'function')
+        return v;
+    const fn = v;
+    if (ctx !== NO_FIELD_CONTEXT)
+        return readingContext(where, () => fn(ctx)) ?? fallback;
+    if (fn.length > 0) {
+        throw new Error(`${where} is a function of the field context, but no FieldContextProvider is above it`);
+    }
+    return fn() ?? fallback;
+}
 //# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,OAAO,CAAI,CAA2B,EAAE,QAAW;IACjE,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACrC,OAAO,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAE,CAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAiB,MAAM,mBAAmB,CAAC;AAGpF,MAAM,UAAU,OAAO,CAAI,CAA2B,EAAE,QAAW;IACjE,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACrC,OAAO,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAE,CAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAI,CAA2B,EAAE,QAAW,EAAE,GAAa,EAAE,KAAa;IACjG,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACrC,IAAI,OAAO,CAAC,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,CAAwB,CAAC;IACpC,IAAI,GAAG,KAAK,gBAAgB;QAAE,OAAO,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC;IACtF,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8EAA8E,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,EAAE,EAAE,IAAI,QAAQ,CAAC;AAC1B,CAAC"}

package/dist/tree.d.ts

@@ -0,0 +1,69 @@
+import type { OneOfChoice, OneOfChoiceControls } from './choices.js';
+/** A node of a tree field (Praeceptor's categories): a choice with children. */
+export interface TreeNode<T extends string = string> extends OneOfChoice<T> {
+    children?: TreeNode<T>[];
+}
+/** A node as the widgets get it: the resolved choice, its children likewise, and whether it shows checked. */
+export interface TreeNodeControls<T extends string = string> extends OneOfChoiceControls<T> {
+    children: TreeNodeControls<T>[] | undefined;
+    /** Covered by the value (in the cascading selections), or in the value (`'independent'`). */
+    checked: boolean;
+}
+/**
+ * What a tree field's value lists, as antd TreeSelect's `showCheckedStrategy` and
+ * `checkStrictly` do. In the three cascading selections a node stands for its subtree, and
+ * a node all of whose children are covered is covered too; they differ only in which of the
+ * covered nodes the value names:
+ * - `'topmost'` (`SHOW_PARENT`, the default): the covered nodes whose parent is not covered;
+ * - `'all'` (`SHOW_ALL`): every covered node;
+ * - `'leaves'` (`SHOW_CHILD`): the covered leaves.
+ *
+ * `'independent'` (`checkStrictly`, moxb's `strictSelect`): each node is chosen on its own.
+ */
+export type TreeSelection = 'topmost' | 'all' | 'leaves' | 'independent';
+/**
+ * Which nodes a tree widget opens at first: `'top'` (the default), the roots with children;
+ * `'none'`; `'selected'` (moxb's `expandValues`), the ancestors of the value's nodes; `'all'`,
+ * every node with children.
+ */
+export type TreeExpand = 'top' | 'none' | 'selected' | 'all';
+/**
+ * A tree field's value in its canonical form under `selection` (see TreeSelection): the
+ * nodes it names in tree pre-order, followed by the values that name no node, without
+ * duplicates. With `'topmost'`, `['A1', 'A']` becomes `['A']`, and a node's children all
+ * listed become the node.
+ */
+export declare function normalizeTreeValue<T extends string>(nodes: TreeNode<T>[], value: T[], selection: TreeSelection): T[];
+/**
+ * Every node a tree field's value stands for, in pre-order (what an item filed under some
+ * node matches against): in the cascading selections the covered nodes (the value's nodes,
+ * their descendants, and every node all of whose children are covered); with
+ * `'independent'` the value's nodes themselves. Values that name no node follow, as in
+ * normalizeTreeValue.
+ */
+export declare function coveredNodes<T extends string>(nodes: TreeNode<T>[], value: T[], selection?: TreeSelection): T[];
+/**
+ * The value after flipping `node`, normalized. In the cascading selections a covered node
+ * is removed with its descendants and its ancestors (they no longer have all their
+ * children), and an uncovered one is added with its descendants; with `'independent'` the
+ * node alone is added or removed. A `node` that is not one of the nodes changes nothing.
+ */
+export declare function toggleTreeValue<T extends string>(nodes: TreeNode<T>[], value: T[], node: T, selection: TreeSelection): T[];
+/** The nodes a tree widget opens at first under `expand` (see TreeExpand), in pre-order. */
+export declare function expandedTreeKeys<T extends string>(nodes: TreeNode<T>[], value: T[], expand: TreeExpand): T[];
+/**
+ * The nodes matching a search (Taskmaster's category search), by antd TreeSelect's rule, so a
+ * dropdown and a drawer over the same nodes agree: a node matches if its label (else its
+ * value) contains the query, ignoring accents, case and the query's surrounding spaces. A
+ * matching node stays with its whole subtree; any other node stays if one of its descendants
+ * matches, keeping only the children that stay. A node that stays with no children has
+ * `children` undefined, not an empty list. Generic over the node's shape, so the widgets can
+ * filter resolved node controls; the nodes given are not changed. An empty query returns
+ * them as they are.
+ */
+export declare function filterTree<N extends {
+    label?: string;
+    value: string;
+    children?: N[];
+}>(nodes: N[], query: string): N[];
+//# sourceMappingURL=tree.d.ts.map

package/dist/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGrE,gFAAgF;AAChF,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;CAC1B;AAED,8GAA8G;AAC9G,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IACzF,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC5C,6FAA6F;IAC7F,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;AAwD7D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,aAAa,GAAG,CAAC,EAAE,CAOpH;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,GAAE,aAAyB,GAAG,CAAC,EAAE,CAE1H;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,aAAa,GAAG,CAAC,EAAE,CAgB1H;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,CAU5G;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAYtH"}

package/dist/tree.js

@@ -0,0 +1,151 @@
+import { normalizeText } from './normalizeText.js';
+function hasChildren(node) {
+    return (node.children?.length ?? 0) > 0;
+}
+/** The nodes in pre-order, and each node's parent. */
+function indexTree(nodes) {
+    const order = [];
+    const parent = new Map();
+    const walk = (list, up) => {
+        for (const node of list) {
+            order.push(node);
+            if (up !== undefined)
+                parent.set(node.value, up);
+            if (node.children)
+                walk(node.children, node.value);
+        }
+    };
+    walk(nodes, undefined);
+    return { order, parent };
+}
+/** The values that name no node, in their order, without duplicates (kept, so a stale value is not silently dropped). */
+function unknownValues(order, value) {
+    const known = new Set(order.map((n) => n.value));
+    return [...new Set(value.filter((v) => !known.has(v)))];
+}
+/** The nodes a value covers in the cascading selections: the value's nodes, their descendants, and every node all of whose children are covered. */
+function cascade(nodes, value) {
+    const listed = new Set(value);
+    const covered = new Set();
+    const walk = (node, inherited) => {
+        const self = inherited || listed.has(node.value);
+        const children = (node.children ?? []).map((child) => walk(child, self));
+        const isCovered = self || (children.length > 0 && children.every(Boolean));
+        if (isCovered)
+            covered.add(node.value);
+        return isCovered;
+    };
+    for (const node of nodes)
+        walk(node, false);
+    return covered;
+}
+/** The covered nodes the value names under `selection` (see TreeSelection), in pre-order. */
+function namedNodes(order, parent, covered, selection) {
+    const named = order.filter((node) => {
+        if (!covered.has(node.value))
+            return false;
+        if (selection === 'leaves')
+            return !hasChildren(node);
+        if (selection === 'topmost') {
+            const up = parent.get(node.value);
+            return up === undefined || !covered.has(up);
+        }
+        return true;
+    });
+    return named.map((node) => node.value);
+}
+/**
+ * A tree field's value in its canonical form under `selection` (see TreeSelection): the
+ * nodes it names in tree pre-order, followed by the values that name no node, without
+ * duplicates. With `'topmost'`, `['A1', 'A']` becomes `['A']`, and a node's children all
+ * listed become the node.
+ */
+export function normalizeTreeValue(nodes, value, selection) {
+    const { order, parent } = indexTree(nodes);
+    const covered = selection === 'independent' ? new Set(value) : cascade(nodes, value);
+    const named = selection === 'independent'
+        ? order.filter((node) => covered.has(node.value)).map((node) => node.value)
+        : namedNodes(order, parent, covered, selection);
+    return [...named, ...unknownValues(order, value)];
+}
+/**
+ * Every node a tree field's value stands for, in pre-order (what an item filed under some
+ * node matches against): in the cascading selections the covered nodes (the value's nodes,
+ * their descendants, and every node all of whose children are covered); with
+ * `'independent'` the value's nodes themselves. Values that name no node follow, as in
+ * normalizeTreeValue.
+ */
+export function coveredNodes(nodes, value, selection = 'topmost') {
+    return normalizeTreeValue(nodes, value, selection === 'independent' ? 'independent' : 'all');
+}
+/**
+ * The value after flipping `node`, normalized. In the cascading selections a covered node
+ * is removed with its descendants and its ancestors (they no longer have all their
+ * children), and an uncovered one is added with its descendants; with `'independent'` the
+ * node alone is added or removed. A `node` that is not one of the nodes changes nothing.
+ */
+export function toggleTreeValue(nodes, value, node, selection) {
+    const { order, parent } = indexTree(nodes);
+    const target = order.find((n) => n.value === node);
+    if (!target)
+        return normalizeTreeValue(nodes, value, selection);
+    if (selection === 'independent') {
+        return normalizeTreeValue(nodes, value.includes(node) ? value.filter((v) => v !== node) : [...value, node], selection);
+    }
+    const covered = cascade(nodes, value);
+    const subtree = indexTree([target]).order.map((n) => n.value);
+    if (covered.has(node)) {
+        for (const v of subtree)
+            covered.delete(v);
+        for (let up = parent.get(node); up !== undefined; up = parent.get(up))
+            covered.delete(up);
+    }
+    else {
+        for (const v of subtree)
+            covered.add(v);
+    }
+    return normalizeTreeValue(nodes, [...covered, ...unknownValues(order, value)], selection);
+}
+/** The nodes a tree widget opens at first under `expand` (see TreeExpand), in pre-order. */
+export function expandedTreeKeys(nodes, value, expand) {
+    if (expand === 'none')
+        return [];
+    if (expand === 'top')
+        return nodes.filter(hasChildren).map((node) => node.value);
+    const { order, parent } = indexTree(nodes);
+    if (expand === 'all')
+        return order.filter(hasChildren).map((node) => node.value);
+    const ancestors = new Set();
+    for (const v of value) {
+        for (let up = parent.get(v); up !== undefined; up = parent.get(up))
+            ancestors.add(up);
+    }
+    return order.filter((node) => ancestors.has(node.value)).map((node) => node.value);
+}
+/**
+ * The nodes matching a search (Taskmaster's category search), by antd TreeSelect's rule, so a
+ * dropdown and a drawer over the same nodes agree: a node matches if its label (else its
+ * value) contains the query, ignoring accents, case and the query's surrounding spaces. A
+ * matching node stays with its whole subtree; any other node stays if one of its descendants
+ * matches, keeping only the children that stay. A node that stays with no children has
+ * `children` undefined, not an empty list. Generic over the node's shape, so the widgets can
+ * filter resolved node controls; the nodes given are not changed. An empty query returns
+ * them as they are.
+ */
+export function filterTree(nodes, query) {
+    const q = normalizeText(query.trim());
+    if (!q)
+        return nodes;
+    /** The nodes of `list` that stay; `all` when an ancestor matched, so every node does. */
+    const keep = (list, all) => list.flatMap((node) => {
+        const matches = all || normalizeText(node.label ?? node.value).includes(q);
+        const children = keep(node.children ?? [], matches);
+        if (!matches && children.length === 0)
+            return [];
+        if (node.children === undefined)
+            return [node];
+        return [{ ...node, children: children.length > 0 ? children : undefined }];
+    });
+    return keep(nodes, false);
+}
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

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

package/dist/types.d.ts

@@ -14,7 +14,15 @@ export type Decision = boolean | {
     verdict: boolean;
     reason?: string;
 };
-export type ValueOrFn<T> = T | (() => T);
+/**
+ * A value, or a function giving it, as a field's options take them. With a FieldContextProvider
+ * above, a field calls every such function with its field context (the provider's value); with
+ * none, a function without parameters is called with nothing and one that declares a parameter
+ * throws.
+ */
+export type ValueOrFn<T, Ctx = any> = T | ((ctx: Ctx) => T);
+/** A value, or a function of no arguments giving it, as an action's options take them: an action calls its functions with nothing. */
+export type Thunk<T> = T | (() => T);
 export type Severity = 'info' | 'warning' | 'error';
 /** Something an action (or, later, a field's validation) has to say, with its severity. */
 export interface Message {
@@ -56,12 +64,12 @@ export type ConfirmationSpec = {
 };
 export interface ActionOptions<TArgs = void, TResult = void, RouteId extends string = string> {
     id: string;
-    label: ValueOrFn<string>;
-    icon?: ValueOrFn<React.ReactNode>;
-    variant?: ValueOrFn<'default' | 'primary' | 'danger'>;
-    enabled?: ValueOrFn<Decision>;
-    invisible?: ValueOrFn<boolean>;
-    confirmation?: ValueOrFn<ConfirmationSpec | undefined>;
+    label: Thunk<string>;
+    icon?: Thunk<React.ReactNode>;
+    variant?: Thunk<'default' | 'primary' | 'danger'>;
+    enabled?: Thunk<Decision>;
+    invisible?: Thunk<boolean>;
+    confirmation?: Thunk<ConfirmationSpec | undefined>;
     errorRoute?: RouteId;
     fire: (args: TArgs, ctx: ExecutionContext) => Promise<TResult> | TResult;
     onSuccess?: (result: TResult) => void;

package/dist/types.d.ts.map

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

package/dist/useArg.d.ts

@@ -0,0 +1,45 @@
+import type { UpdateMethod } from './argStore.js';
+import type { ValueOrFn } from './types.js';
+import type { ValueType } from './valueTypes.js';
+/** An argument's shape (moxb's url-arg definition, without a `permanent` flag — that is a router concern). */
+export interface ArgDefinition<T, Ctx = any> {
+    key: string;
+    valueType: ValueType<T>;
+    default: ValueOrFn<T, Ctx>;
+}
+export interface ArgControls<T> {
+    value: T;
+    isDefault: boolean;
+    set(value: T, method?: UpdateMethod): void;
+    reset(method?: UpdateMethod): void;
+    /** The href `set(value)` would produce, where the store supports it (a URL store); `undefined` otherwise. */
+    hrefFor(value: T): string | undefined;
+}
+/**
+ * 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 declare function useArg<T>(definition: ArgDefinition<T>): ArgControls<T>;
+/** One argument's planned change in a batch (moxb's ArgChange): a new value, or a reset. */
+export type ArgChange = {
+    definition: ArgDefinition<any>;
+    value?: unknown;
+    reset?: true;
+};
+export declare function setArg<T>(definition: ArgDefinition<T>, value: T): ArgChange;
+export declare function resetArg(definition: ArgDefinition<any>): ArgChange;
+/**
+ * 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 declare function useArgWriter(): (changes: ArgChange[], method?: UpdateMethod) => void;
+//# sourceMappingURL=useArg.d.ts.map

package/dist/useArg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArg.d.ts","sourceRoot":"","sources":["../src/useArg.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,8GAA8G;AAC9G,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3C,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,6GAA6G;IAC7G,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;CACvC;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CA8CtE;AAED,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG;IAAE,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAE1F,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAE3E;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,CAElE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,EAAE,YAAY,KAAK,IAAI,CAepF"}