vultus-core 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,72 @@
+# vultus-core
+
+Framework-neutral action model, hooks, and error-routing for the vultus UI
+family. It is antd-free by design: no Ant Design import appears anywhere in
+this package. Consumed by `vultus-antd` and, transitively, by excavator and
+optio-conversation-ui.
+
+## Install
+
+```sh
+npm install vultus-core
+```
+
+## Peer dependencies
+
+- `react` >=18
+- `react-i18next` >=15
+
+## Entry points
+
+- `.` — the action model, exporting: the core `types`, `decision`, `resolve`,
+  `parseApiError`, `routeApiError`, `ActionErrorContext` / `useActionErrorCtx`,
+  `useAction`, `useActionList`, the fields (`useBoolField`, `useFieldCore` and
+  their types), `InternalLinkContext` / `useInternalLink` /
+  `InternalLinkComponent`, and `MessageSinkContext` / `useMessageSink` /
+  `MessageSink`.
+- `./link` — `InternalLinkContext`, `useInternalLink`, and the
+  `InternalLinkComponent` type on their own, for consumers that only need the
+  link-injection seam.
+
+## Actions report messages
+
+An action's `fire(args, ctx)` receives an `ExecutionContext` next to its arguments:
+`ctx.info(text)`, `ctx.warn(text)` and `ctx.error(text)` report messages while it runs.
+They land on the action's status as `messages` (with their `severity`) and go to the
+`MessageSink` (`(text, severity?)`). A thrown error still fails the action and ends the
+run's messages; `errors` lists the error texts among them.
+
+## Fields
+
+`useBoolField(options)` is the first field hook: the value half of vultus, next to
+actions. Fields are built by composition on a shared core (`useFieldCore`): label,
+description, `visible`/`hidden`, `enabled`/`disabled` (a `Decision`, so with a reason),
+and where the value lives:
+
+- inside the field: `initialValue` (default `false`), changed locally;
+- outside, changed locally: `value` + `onChange` (the caller owns the value, e.g. a form);
+- outside, committed immediately: `value` + `commit: { fire(next, ctx), confirmation?, errorRoute? }`.
+  The commit runs as an action, so the field is `pending` while it runs and carries its
+  `messages`; afterwards it shows whatever `value` the caller passes. `confirmation` may
+  depend on the requested value.
+
+The returned controls (`value`, `setValue`, `toggle`, `pending`, `enabled`, `whyDisabled`,
+`description`, `valueDescription`, `messages`, `confirmationFor(next)`, ...) are what widgets
+render: vultus-antd's `BoolSwitch` and `BoolCheckbox` take the same field.
+`valueDescriptions` (texts keyed by value: `true`, `false`, `mixed`) say what the current value
+means, next to `description` (what the field is).
+
+`useMixedBoolField` is the same field over an aggregate: it shows `true`, `false` or `'mixed'`
+and can be asked for `true` or `false` only (the field core separates the shown type from the
+requestable one); a toggle from mixed requests `true`. `aggregateBool(values)` derives the
+value; with no items at all, disable the field with a reason instead.
+
+## Distribution
+
+This package ships compiled ESM (`dist/`) with TypeScript declarations to
+npm; the repository's own `exports` field resolves `src/` directly for
+workspace consumers.
+
+## License
+
+Apache-2.0

package/dist/LinkContext.d.ts

@@ -0,0 +1,13 @@
+import { type ComponentType, type ReactNode } from 'react';
+/**
+ * How an internal (`/`-prefixed) markdown link renders. Hosts with a router
+ * inject an SPA link; the default is a full-navigation anchor so router-less
+ * consumers (optio-conversation-ui) work with zero setup.
+ */
+export type InternalLinkComponent = ComponentType<{
+    href: string;
+    children?: ReactNode;
+}>;
+export declare const InternalLinkContext: import("react").Context<InternalLinkComponent>;
+export declare function useInternalLink(): InternalLinkComponent;
+//# sourceMappingURL=LinkContext.d.ts.map

package/dist/LinkContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkContext.d.ts","sourceRoot":"","sources":["../src/LinkContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAM1F,eAAO,MAAM,mBAAmB,gDAA4D,CAAC;AAE7F,wBAAgB,eAAe,IAAI,qBAAqB,CAEvD"}

package/dist/LinkContext.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+const DefaultInternalLink = ({ href, children }) => (_jsx("a", { href: href, children: children }));
+export const InternalLinkContext = createContext(DefaultInternalLink);
+export function useInternalLink() {
+    return useContext(InternalLinkContext);
+}
+//# sourceMappingURL=LinkContext.js.map

package/dist/LinkContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkContext.js","sourceRoot":"","sources":["../src/LinkContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAsC,MAAM,OAAO,CAAC;AAStF,MAAM,mBAAmB,GAA0B,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CACzE,YAAG,IAAI,EAAE,IAAI,YAAG,QAAQ,GAAK,CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAwB,mBAAmB,CAAC,CAAC;AAE7F,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC"}

package/dist/MessageSink.d.ts

@@ -0,0 +1,13 @@
+import type { Severity } from './types.js';
+/**
+ * How the action framework surfaces messages: an otherwise-unhandled error (no
+ * form field, no inline error target), and the messages an action reports
+ * through its ExecutionContext. `severity` defaults to 'error'. Default is a
+ * no-op so vultus-core stays antd-free and framework-neutral; vultus-antd's
+ * VultusProvider wires this to antd's message API. Hosts may inject any
+ * toast/notification mechanism.
+ */
+export type MessageSink = (text: string, severity?: Severity) => void;
+export declare const MessageSinkContext: import("react").Context<MessageSink>;
+export declare function useMessageSink(): MessageSink;
+//# sourceMappingURL=MessageSink.d.ts.map

package/dist/MessageSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageSink.d.ts","sourceRoot":"","sources":["../src/MessageSink.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEtE,eAAO,MAAM,kBAAkB,sCAAuC,CAAC;AAEvE,wBAAgB,cAAc,IAAI,WAAW,CAE5C"}

package/dist/MessageSink.js

@@ -0,0 +1,6 @@
+import { createContext, useContext } from 'react';
+export const MessageSinkContext = createContext(() => { });
+export function useMessageSink() {
+    return useContext(MessageSinkContext);
+}
+//# sourceMappingURL=MessageSink.js.map

package/dist/MessageSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageSink.js","sourceRoot":"","sources":["../src/MessageSink.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAalD,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAc,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAEvE,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC;AACxC,CAAC"}

package/dist/action-core.d.ts

@@ -0,0 +1,36 @@
+import type React from 'react';
+import type { MutableRefObject } from 'react';
+import type { MessageSink } from './MessageSink.js';
+import type { ActionErrorCtx, ActionOptions, ActionStatus, ConfirmationSpec, ErrorRoutesRegistry, Message } from './types.js';
+/**
+ * Hookless core of the action framework, shared by useAction (single) and
+ * useActionList (dynamic list) so the firing machinery + ActionStatus shape
+ * live in exactly one place — neither entry point reimplements the other.
+ */
+export interface ResolvedFields {
+    label: string;
+    icon: React.ReactNode | undefined;
+    variant: 'default' | 'primary' | 'danger';
+    disabled: boolean;
+    reason: string | undefined;
+    invisible: boolean;
+    confirmation: ConfirmationSpec | undefined;
+}
+/** Resolve the static (hookless) ActionStatus fields from the options. */
+export declare function resolveActionFields(opts: ActionOptions<any, any, any>): ResolvedFields;
+export interface FirePromiseDeps<RouteId extends string> {
+    disabled: boolean;
+    reason: string | undefined;
+    getPending: () => boolean;
+    setPending: (value: boolean) => void;
+    setMessages: (messages: Message[]) => void;
+    errCtxRef: MutableRefObject<ActionErrorCtx | null>;
+    t: (key: string, opts?: Record<string, unknown>) => string;
+    registry?: ErrorRoutesRegistry<RouteId>;
+    messageSink?: MessageSink;
+}
+/** Build the async fire (pending guard + error routing) for one action. */
+export declare function makeFirePromise<TArgs, TResult, RouteId extends string>(opts: ActionOptions<TArgs, TResult, RouteId>, deps: FirePromiseDeps<RouteId>): (args: TArgs) => Promise<void>;
+/** Assemble the public ActionStatus from resolved fields + state + fire. */
+export declare function assembleStatus<TArgs>(opts: ActionOptions<TArgs, any, any>, fields: ResolvedFields, pending: boolean, messages: Message[], firePromise: (args: TArgs) => Promise<void>): ActionStatus<TArgs>;
+//# sourceMappingURL=action-core.d.ts.map

package/dist/action-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-core.d.ts","sourceRoot":"","sources":["../src/action-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAK9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,gBAAgB,EAEhB,mBAAmB,EAEnB,OAAO,EAER,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAC5C;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,cAAc,CAWtF;AAED,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAC3C,SAAS,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACnD,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IAC3D,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAS,MAAM,EACpE,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAC5C,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,GAC7B,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAmDhC;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAClC,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EACpC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EAAE,EACnB,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1C,YAAY,CAAC,KAAK,CAAC,CAmBrB"}

package/dist/action-core.js

@@ -0,0 +1,91 @@
+import { getVerdict, getReason } from './decision.js';
+import { resolve } from './resolve.js';
+import { routeApiError } from './routeApiError.js';
+import { parseApiError } from './parseApiError.js';
+/** Resolve the static (hookless) ActionStatus fields from the options. */
+export function resolveActionFields(opts) {
+    const enabledD = resolve(opts.enabled, true);
+    return {
+        label: resolve(opts.label, ''),
+        icon: resolve(opts.icon, undefined),
+        variant: resolve(opts.variant, 'default'),
+        disabled: !getVerdict(enabledD, true),
+        reason: getReason(enabledD),
+        invisible: resolve(opts.invisible, false),
+        confirmation: resolve(opts.confirmation, undefined),
+    };
+}
+/** Build the async fire (pending guard + error routing) for one action. */
+export function makeFirePromise(opts, deps) {
+    return async (args) => {
+        if (deps.disabled) {
+            console.warn(`Action '${opts.id}': disabled — ${deps.reason ?? '(no reason)'}`);
+            return;
+        }
+        if (deps.getPending()) {
+            console.warn(`Action '${opts.id}': already pending — ignoring fire`);
+            return;
+        }
+        // Messages of this run: reported through the context while it runs, then
+        // the thrown error if it fails. Each report updates the status at once.
+        const messages = [];
+        const report = (severity) => (text) => {
+            messages.push({ text, severity });
+            deps.setMessages([...messages]);
+            deps.messageSink?.(text, severity);
+        };
+        const ctx = { info: report('info'), warn: report('warning'), error: report('error') };
+        deps.setMessages([]);
+        deps.setPending(true);
+        try {
+            const result = await opts.fire(args, ctx);
+            opts.onSuccess?.(result);
+        }
+        catch (err) {
+            const parsed = parseApiError(err);
+            const text = parsed.message ?? 'Action failed';
+            if (opts.errorRoute && deps.registry) {
+                // A routed action: routeApiError decides where the error shows (a form
+                // field, the inline error, or the sink).
+                routeApiError(err, {
+                    route: opts.errorRoute,
+                    form: deps.errCtxRef.current?.form,
+                    setInlineError: deps.errCtxRef.current?.setInlineError,
+                    t: deps.t,
+                    showError: deps.messageSink,
+                }, deps.registry);
+            }
+            else {
+                // No route: the sink shows it, like the messages reported through ctx.
+                deps.messageSink?.(text, 'error');
+            }
+            messages.push({ text, severity: 'error' });
+            deps.setMessages([...messages]);
+        }
+        finally {
+            deps.setPending(false);
+        }
+    };
+}
+/** Assemble the public ActionStatus from resolved fields + state + fire. */
+export function assembleStatus(opts, fields, pending, messages, firePromise) {
+    const fire = (args) => {
+        void firePromise(args);
+    };
+    return {
+        id: opts.id,
+        label: fields.label,
+        icon: fields.icon,
+        variant: fields.variant,
+        pending,
+        disabled: fields.disabled,
+        reason: fields.reason,
+        invisible: fields.invisible,
+        confirmation: fields.confirmation,
+        messages,
+        errors: messages.filter((m) => m.severity === 'error').map((m) => m.text),
+        fire: fire,
+        firePromise: firePromise,
+    };
+}
+//# sourceMappingURL=action-core.js.map

package/dist/action-core.js.map

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

package/dist/decision.d.ts

@@ -0,0 +1,10 @@
+import type { Decision } from './types.js';
+export declare const allow: (reason?: string) => Decision;
+export declare const deny: (reason?: string) => Decision;
+export declare const denyWithReason: (reason: string) => Decision;
+export declare const getVerdict: (d: Decision | undefined, fallback: boolean) => boolean;
+export declare const getReason: (d: Decision | undefined) => string | undefined;
+export declare const andDecisions: (a: Decision, b: Decision) => Decision;
+/** The opposite verdict, keeping the reason (a reason to disable is a reason not to enable). */
+export declare const invertDecision: (d: Decision) => Decision;
+//# sourceMappingURL=decision.d.ts.map

package/dist/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../src/decision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,KAAK,GAAI,SAAS,MAAM,KAAG,QAAuC,CAAC;AAChF,eAAO,MAAM,IAAI,GAAI,SAAS,MAAM,KAAG,QAAwC,CAAC;AAChF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,QAAwC,CAAC;AAEzF,eAAO,MAAM,UAAU,GAAI,GAAG,QAAQ,GAAG,SAAS,EAAE,UAAU,OAAO,KAAG,OACH,CAAC;AAEtE,eAAO,MAAM,SAAS,GAAI,GAAG,QAAQ,GAAG,SAAS,KAAG,MAAM,GAAG,SACgB,CAAC;AAE9E,eAAO,MAAM,YAAY,GAAI,GAAG,QAAQ,EAAE,GAAG,QAAQ,KAAG,QAQvD,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,cAAc,GAAI,GAAG,QAAQ,KAAG,QAC4B,CAAC"}

package/dist/decision.js

@@ -0,0 +1,17 @@
+export const allow = (reason) => ({ verdict: true, reason });
+export const deny = (reason) => ({ verdict: false, reason });
+export const denyWithReason = (reason) => ({ verdict: false, reason });
+export const getVerdict = (d, fallback) => d === undefined ? fallback : typeof d === 'boolean' ? d : d.verdict;
+export const getReason = (d) => d === undefined ? undefined : typeof d === 'boolean' ? undefined : d.reason;
+export const andDecisions = (a, b) => {
+    const av = getVerdict(a, false);
+    const bv = getVerdict(b, false);
+    if (av && bv) {
+        const reasons = [getReason(a), getReason(b)].filter(Boolean);
+        return { verdict: true, reason: reasons.join('; ') || undefined };
+    }
+    return av ? b : a;
+};
+/** The opposite verdict, keeping the reason (a reason to disable is a reason not to enable). */
+export const invertDecision = (d) => typeof d === 'boolean' ? !d : { verdict: !d.verdict, reason: d.reason };
+//# sourceMappingURL=decision.js.map

package/dist/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../src/decision.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAe,EAAY,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAe,EAAY,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAY,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AAEzF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAuB,EAAE,QAAiB,EAAW,EAAE,CAChF,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAEtE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAuB,EAAsB,EAAE,CACvE,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAW,EAAE,CAAW,EAAY,EAAE;IACjE,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;QACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF,gGAAgG;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAW,EAAY,EAAE,CACtD,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/field.d.ts

@@ -0,0 +1,97 @@
+import type { ConfirmationSpec, Decision, ErrorRoutesRegistry, ExecutionContext, Message, ValueOrFn } from './types.js';
+/**
+ * Fields: the value half of vultus, on the pattern of the sidedao InputFields.
+ * A field hook (useBoolField, later others) is built on useFieldCore by
+ * composition, never by inheritance. A field's value lives either inside the
+ * field (its own state) or outside it (the caller passes it every render);
+ * from outside it is changed either locally (`onChange`, e.g. a form) or by an
+ * immediate commit (`commit`), whose setter runs as an action.
+ * Design notes: unitas docs/2026-10-05-vultus-field-model-design.md.
+ */
+/** How an immediately committing field stores a change: an action that receives the requested value. */
+export interface FieldCommit<TRequest, RouteId extends string = string> {
+    fire: (next: TRequest, ctx: ExecutionContext) => Promise<void> | void;
+    /** Confirmation before committing; may depend on the requested value (e.g. only when switching off). */
+    confirmation?: ConfirmationSpec | ((next: TRequest) => ConfirmationSpec | undefined);
+    errorRoute?: RouteId;
+}
+/** The key of a value in `valueDescriptions`: 'true' / 'false' for booleans, the value itself for strings. */
+export type ValueKey<T> = T extends boolean ? `${T}` : T extends string | number ? `${T}` : never;
+interface FieldBaseOptions<TValue> {
+    id: string;
+    label?: ValueOrFn<string>;
+    description?: ValueOrFn<string | undefined>;
+    /** Shown? Default true. Use `visible` or `hidden`, not contradicting each other. */
+    visible?: ValueOrFn<boolean>;
+    hidden?: ValueOrFn<boolean>;
+    /** Changeable? Default true, optionally with a reason. Use `enabled` or `disabled`, not contradicting each other. */
+    enabled?: ValueOrFn<Decision>;
+    disabled?: ValueOrFn<Decision>;
+    /**
+     * What each value means right now, keyed by value (for booleans `true` / `false`, and `mixed`
+     * where the field can show it). Shown with the current value, next to `description`, which
+     * says what the field is in general.
+     */
+    valueDescriptions?: Partial<Record<ValueKey<TValue>, string>>;
+}
+/**
+ * Where the value lives, and what setting it does. Exactly one of the three. The field shows a
+ * `TValue` and can be asked for a `TRequest`; usually the same type, but an aggregate can show
+ * a state that cannot be requested (a boolean field showing 'mixed').
+ */
+export type FieldStorage<TValue, TRequest = TValue, RouteId extends string = string> = 
+/** Inside the field: its own state, starting at `initialValue`. */
+{
+    initialValue?: TValue;
+    value?: never;
+    onChange?: never;
+    commit?: never;
+}
+/** Outside, changed locally: the caller owns the value and applies `onChange`. */
+ | {
+    value: TValue;
+    onChange: (value: TRequest) => void;
+    initialValue?: never;
+    commit?: never;
+}
+/** Outside, committed immediately: `commit.fire` stores the change (pending, messages, confirmation). */
+ | {
+    value: TValue;
+    commit: FieldCommit<TRequest, RouteId>;
+    initialValue?: never;
+    onChange?: never;
+};
+export type FieldOptions<TValue, TRequest = TValue, RouteId extends string = string> = FieldBaseOptions<TValue> & FieldStorage<TValue, TRequest, RouteId>;
+/** What a field widget receives: everything it shows, and the one way to change the value. */
+export interface FieldControls<TValue, TRequest = TValue> {
+    type: string;
+    id: string;
+    label: string;
+    description: string | undefined;
+    /** What the current value means (from `valueDescriptions`). */
+    valueDescription: string | undefined;
+    visible: boolean;
+    enabled: boolean;
+    whyDisabled: string | undefined;
+    value: TValue;
+    /** Request a new value. Ignored (with a warning) when disabled or while a commit is pending. */
+    setValue(next: TRequest): void;
+    /** A commit is running. */
+    pending: boolean;
+    /** Messages of the last commit. */
+    messages: Message[];
+    /** The confirmation a widget must obtain before requesting `next`, if any. */
+    confirmationFor(next: TRequest): ConfirmationSpec | undefined;
+}
+export type FieldStorageMode = 'inside' | 'local' | 'commit';
+export declare function fieldStorageMode(id: string, opts: FieldStorage<unknown, unknown, string>): FieldStorageMode;
+export declare function calculateVisible(id: string, visible: boolean | undefined, hidden: boolean | undefined): boolean;
+export declare function calculateEnabled(id: string, enabled: Decision | undefined, disabled: Decision | undefined): Decision;
+/**
+ * The shared core of every field hook: label and description, visibility and
+ * enabled state (with reason), the storage mode, and in commit mode the setter
+ * as an action (its pending state and messages become the field's).
+ */
+export declare function useFieldCore<TValue, TRequest extends TValue = TValue, RouteId extends string = string>(type: string, opts: FieldOptions<TValue, TRequest, RouteId>, registry?: ErrorRoutesRegistry<RouteId>): FieldControls<TValue, TRequest>;
+export {};
+//# sourceMappingURL=field.d.ts.map

package/dist/field.d.ts.map

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

package/dist/field.js

@@ -0,0 +1,95 @@
+import { useState } from 'react';
+import { getReason, getVerdict, invertDecision } from './decision.js';
+import { resolve } from './resolve.js';
+import { useAction } from './useAction.js';
+export function fieldStorageMode(id, opts) {
+    const { initialValue, value, onChange, commit } = opts;
+    if (commit && onChange)
+        throw new Error(`Field '${id}': "commit" and "onChange" are mutually exclusive`);
+    if ((commit || onChange) && initialValue !== undefined) {
+        throw new Error(`Field '${id}': "initialValue" is for a value inside the field; with "${commit ? 'commit' : 'onChange'}" the caller passes "value"`);
+    }
+    if (commit)
+        return 'commit';
+    if (onChange)
+        return 'local';
+    if (value !== undefined)
+        throw new Error(`Field '${id}': "value" needs "onChange" or "commit"`);
+    return 'inside';
+}
+export function calculateVisible(id, visible, hidden) {
+    if (visible === undefined)
+        return hidden === undefined ? true : !hidden;
+    if (hidden === undefined || visible !== hidden)
+        return visible;
+    throw new Error(`Field '${id}': "visible" and "hidden" contradict each other`);
+}
+export function calculateEnabled(id, enabled, disabled) {
+    if (enabled === undefined)
+        return disabled === undefined ? true : invertDecision(disabled);
+    if (disabled === undefined)
+        return enabled;
+    if (getVerdict(enabled, false) !== getVerdict(disabled, false)) {
+        return { verdict: getVerdict(enabled, false), reason: getReason(disabled) ?? getReason(enabled) };
+    }
+    throw new Error(`Field '${id}': "enabled" and "disabled" contradict each other`);
+}
+/**
+ * The shared core of every field hook: label and description, visibility and
+ * enabled state (with reason), the storage mode, and in commit mode the setter
+ * as an action (its pending state and messages become the field's).
+ */
+export function useFieldCore(type, opts, registry) {
+    const mode = fieldStorageMode(opts.id, opts);
+    const [inner, setInner] = useState(opts.initialValue);
+    const label = resolve(opts.label, '');
+    const description = resolve(opts.description, undefined);
+    const visible = calculateVisible(opts.id, resolve(opts.visible, undefined), resolve(opts.hidden, undefined));
+    const enabledDecision = calculateEnabled(opts.id, resolve(opts.enabled, undefined), resolve(opts.disabled, undefined));
+    const enabled = getVerdict(enabledDecision, true);
+    const whyDisabled = enabled ? undefined : getReason(enabledDecision);
+    // Hooks run unconditionally; the setter action is only fired in commit mode.
+    const setter = useAction({
+        id: `${opts.id}.set`,
+        label,
+        enabled: enabledDecision,
+        invisible: !visible,
+        errorRoute: opts.commit?.errorRoute,
+        fire: (next, ctx) => opts.commit?.fire(next, ctx),
+    }, registry);
+    const value = mode === 'inside' ? inner : opts.value;
+    const pending = mode === 'commit' && setter.pending;
+    const valueDescription = opts.valueDescriptions?.[String(value)];
+    const setValue = (next) => {
+        if (!enabled) {
+            console.warn(`Field '${opts.id}': disabled — ${whyDisabled ?? '(no reason)'}`);
+            return;
+        }
+        if (mode === 'inside')
+            setInner(next);
+        else if (mode === 'local')
+            opts.onChange(next);
+        else
+            setter.fire(next);
+    };
+    const confirmationFor = (next) => {
+        const spec = opts.commit?.confirmation;
+        return typeof spec === 'function' ? spec(next) : spec;
+    };
+    return {
+        type,
+        id: opts.id,
+        label,
+        description,
+        valueDescription,
+        visible,
+        enabled,
+        whyDisabled,
+        value,
+        setValue,
+        pending,
+        messages: mode === 'commit' ? (setter.messages ?? []) : [],
+        confirmationFor,
+    };
+}
+//# sourceMappingURL=field.js.map

package/dist/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../src/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAyF3C,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,IAA4C;IACvF,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAEjD,CAAC;IACF,IAAI,MAAM,IAAI,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,mDAAmD,CAAC,CAAC;IACzG,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,4DAA4D,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,6BAA6B,CAAC,CAAC;IACvJ,CAAC;IACD,IAAI,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC5B,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC7B,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,yCAAyC,CAAC,CAAC;IAChG,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,OAA4B,EAAE,MAA2B;IACpG,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACxE,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC;IAC/D,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,iDAAiD,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,OAA6B,EAAE,QAA8B;IACxG,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC3F,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IACpG,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,mDAAmD,CAAC,CAAC;AACnF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,IAA6C,EAC7C,QAAuC;IAEvC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,IAA8C,CAAC,CAAC;IACvF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAS,IAAI,CAAC,YAAsB,CAAC,CAAC;IAExE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,OAAO,CAAqB,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,gBAAgB,CAC9B,IAAI,CAAC,EAAE,EACP,OAAO,CAAsB,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EACrD,OAAO,CAAsB,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CACrD,CAAC;IACF,MAAM,eAAe,GAAG,gBAAgB,CACtC,IAAI,CAAC,EAAE,EACP,OAAO,CAAuB,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EACtD,OAAO,CAAuB,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CACxD,CAAC;IACF,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAErE,6EAA6E;IAC7E,MAAM,MAAM,GAAG,SAAS,CACtB;QACE,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,MAAM;QACpB,KAAK;QACL,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,CAAC,OAAO;QACnB,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU;QACnC,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC;KAClD,EACD,QAAQ,CACT,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,KAAgB,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC;IACpD,MAAM,gBAAgB,GAAI,IAAI,CAAC,iBAAoE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAErH,MAAM,QAAQ,GAAG,CAAC,IAAc,EAAE,EAAE;QAClC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,iBAAiB,WAAW,IAAI,aAAa,EAAE,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;aACjC,IAAI,IAAI,KAAK,OAAO;YAAE,IAAI,CAAC,QAAS,CAAC,IAAI,CAAC,CAAC;;YAC1C,MAAM,CAAC,IAAiC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,IAAc,EAAgC,EAAE;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC;QACvC,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK;QACL,WAAW;QACX,gBAAgB;QAChB,OAAO;QACP,OAAO;QACP,WAAW;QACX,KAAK;QACL,QAAQ;QACR,OAAO;QACP,QAAQ,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QAC1D,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from './types.js';
+export * from './decision.js';
+export * from './resolve.js';
+export * from './parseApiError.js';
+export * from './routeApiError.js';
+export { ActionErrorContext, useActionErrorCtx } from './useActionErrorCtx.js';
+export { useAction } from './useAction.js';
+export { useActionList } from './useActionList.js';
+export { useFieldCore, fieldStorageMode, calculateVisible, calculateEnabled, type FieldCommit, type FieldControls, type FieldOptions, type FieldStorage, type FieldStorageMode, type ValueKey, } from './field.js';
+export { useBoolField, type BoolFieldControls, type BoolFieldOptions } from './useBoolField.js';
+export { useMixedBoolField, aggregateBool, type MixedBool, type MixedBoolFieldControls, type MixedBoolFieldOptions, } from './useMixedBoolField.js';
+export { InternalLinkContext, useInternalLink, type InternalLinkComponent } from './LinkContext.js';
+export { MessageSinkContext, useMessageSink, type MessageSink } from './MessageSink.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,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,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAClE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,QAAQ,GACjH,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EACL,iBAAiB,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,GAC1G,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from './types.js';
+export * from './decision.js';
+export * from './resolve.js';
+export * from './parseApiError.js';
+export * from './routeApiError.js';
+export { ActionErrorContext, useActionErrorCtx } from './useActionErrorCtx.js';
+export { useAction } from './useAction.js';
+export { useActionList } from './useActionList.js';
+export { useFieldCore, fieldStorageMode, calculateVisible, calculateEnabled, } from './field.js';
+export { useBoolField } from './useBoolField.js';
+export { useMixedBoolField, aggregateBool, } from './useMixedBoolField.js';
+export { InternalLinkContext, useInternalLink } from './LinkContext.js';
+export { MessageSinkContext, useMessageSink } from './MessageSink.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,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,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,GAEnE,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAiD,MAAM,mBAAmB,CAAC;AAChG,OAAO,EACL,iBAAiB,EAAE,aAAa,GACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAA8B,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAoB,MAAM,kBAAkB,CAAC"}

package/dist/parseApiError.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedApiError } from './types.js';
+export declare function parseApiError(err: unknown): ParsedApiError;
+//# sourceMappingURL=parseApiError.d.ts.map

package/dist/parseApiError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseApiError.d.ts","sourceRoot":"","sources":["../src/parseApiError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAQ1D"}

package/dist/parseApiError.js

@@ -0,0 +1,11 @@
+export function parseApiError(err) {
+    if (typeof err !== 'object' || err === null)
+        return { status: 0 };
+    const e = err;
+    return {
+        status: e.status ?? 0,
+        reason: e.body?.reason,
+        message: e.body?.message,
+    };
+}
+//# sourceMappingURL=parseApiError.js.map

package/dist/parseApiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseApiError.js","sourceRoot":"","sources":["../src/parseApiError.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAClE,MAAM,CAAC,GAAG,GAAwE,CAAC;IACnF,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC;QACrB,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM;QACtB,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO;KACzB,CAAC;AACJ,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,3 @@
+import type { ValueOrFn } from './types.js';
+export declare function resolve<T>(v: ValueOrFn<T> | undefined, fallback: T): T;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +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"}

package/dist/resolve.js

@@ -0,0 +1,6 @@
+export function resolve(v, fallback) {
+    if (v === undefined)
+        return fallback;
+    return typeof v === 'function' ? v() : v;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +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"}

package/dist/routeApiError.d.ts

@@ -0,0 +1,3 @@
+import type { ApiErrorContext, ErrorRoutesRegistry } from './types.js';
+export declare function routeApiError<RouteId extends string>(err: unknown, ctx: ApiErrorContext<RouteId>, registry: ErrorRoutesRegistry<RouteId>): void;
+//# sourceMappingURL=routeApiError.d.ts.map

package/dist/routeApiError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeApiError.d.ts","sourceRoot":"","sources":["../src/routeApiError.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEvE,wBAAgB,aAAa,CAAC,OAAO,SAAS,MAAM,EAClD,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,eAAe,CAAC,OAAO,CAAC,EAC7B,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACrC,IAAI,CAiBN"}