vultus-core 0.1.0 → 0.2.0

package/dist/routeApiError.js

@@ -0,0 +1,19 @@
+import { parseApiError } from './parseApiError.js';
+export function routeApiError(err, ctx, registry) {
+    const parsed = parseApiError(err);
+    const routeMap = registry[ctx.route];
+    const entry = parsed.reason ? routeMap?.[parsed.reason] : undefined;
+    const text = entry?.i18nKey
+        ? ctx.t(entry.i18nKey)
+        : (parsed.message ?? ctx.t('common.error'));
+    if (entry?.field && ctx.form) {
+        ctx.form.setFields([{ name: entry.field, errors: [text] }]);
+        return;
+    }
+    if (ctx.setInlineError) {
+        ctx.setInlineError(text);
+        return;
+    }
+    (ctx.showError ?? (() => { }))(text);
+}
+//# sourceMappingURL=routeApiError.js.map

package/dist/routeApiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeApiError.js","sourceRoot":"","sources":["../src/routeApiError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,UAAU,aAAa,CAC3B,GAAY,EACZ,GAA6B,EAC7B,QAAsC;IAEtC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,MAAM,IAAI,GAAG,KAAK,EAAE,OAAO;QACzB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QACtB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;IAE9C,IAAI,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IACD,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;QACvB,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IACD,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,104 @@
+import type React from 'react';
+import type { MessageSink } from './MessageSink.js';
+/**
+ * Minimal structural form contract used by error-routing (antd's FormInstance is
+ * assignable to this). Keeps vultus-core antd-free — see AGENTS.md.
+ */
+export interface FormLike {
+    setFields(fields: {
+        name: string | number | (string | number)[];
+        errors: string[];
+    }[]): void;
+}
+export type Decision = boolean | {
+    verdict: boolean;
+    reason?: string;
+};
+export type ValueOrFn<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 {
+    text: string;
+    severity: Severity;
+}
+/**
+ * What an action's `fire` receives next to its arguments: a way to report
+ * messages while it runs (absorbed from the sidedao InputFields). Messages land
+ * on the action's status (`messages`) and go to the MessageSink. A thrown
+ * error still fails the action; `error()` reports an error without throwing.
+ */
+export interface ExecutionContext {
+    info(text: string): void;
+    warn(text: string): void;
+    error(text: string): void;
+}
+export type ConfirmationSpec = {
+    kind: 'popconfirm';
+    question: string;
+} | {
+    kind: 'cascade-modal';
+    title: string;
+    content: React.ReactNode;
+} | {
+    kind: 'typing';
+    title: string;
+    entityName: string;
+    description: React.ReactNode;
+};
+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>;
+    errorRoute?: RouteId;
+    fire: (args: TArgs, ctx: ExecutionContext) => Promise<TResult> | TResult;
+    onSuccess?: (result: TResult) => void;
+}
+type FireArgs<TArgs> = [TArgs] extends [void] ? [] : [args: TArgs];
+export interface ActionStatus<TArgs = void> {
+    id: string;
+    label: string;
+    icon?: React.ReactNode;
+    variant: 'default' | 'primary' | 'danger';
+    pending: boolean;
+    disabled: boolean;
+    reason?: string;
+    invisible: boolean;
+    confirmation?: ConfirmationSpec;
+    /**
+     * Messages of the last run: reported through the ExecutionContext, or the thrown error.
+     * Optional so hand-built statuses (adapters, test fixtures) stay valid; read it as `[]` when
+     * absent. Statuses from useAction and useActionList always carry it.
+     */
+    messages?: Message[];
+    /** The error texts among `messages` (kept for callers that only show errors). */
+    errors: string[];
+    fire(...args: FireArgs<TArgs>): void;
+    firePromise(...args: FireArgs<TArgs>): Promise<void>;
+}
+export type ParsedApiError = {
+    status: number;
+    reason?: string;
+    message?: string;
+};
+export type RegistryEntry = {
+    i18nKey: string;
+    field?: string;
+};
+export type ErrorRoutesRegistry<RouteId extends string> = Record<RouteId, Record<string, RegistryEntry>>;
+export type ApiErrorContext<RouteId extends string> = {
+    route: RouteId;
+    form?: FormLike;
+    setInlineError?: (text: string | null) => void;
+    t: (key: string) => string;
+    showError?: MessageSink;
+};
+export type ActionErrorCtx = {
+    form: FormLike;
+    setInlineError: (text: string | null) => void;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/useAction.d.ts

@@ -0,0 +1,3 @@
+import type { ActionOptions, ActionStatus, ErrorRoutesRegistry } from './types.js';
+export declare function useAction<TArgs = void, TResult = void, RouteId extends string = string>(opts: ActionOptions<TArgs, TResult, RouteId>, registry?: ErrorRoutesRegistry<RouteId>): ActionStatus<TArgs>;
+//# sourceMappingURL=useAction.d.ts.map

package/dist/useAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAction.d.ts","sourceRoot":"","sources":["../src/useAction.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAW,MAAM,YAAY,CAAC;AAE5F,wBAAgB,SAAS,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,EACrF,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAC5C,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,YAAY,CAAC,KAAK,CAAC,CAkDrB"}

package/dist/useAction.js

@@ -0,0 +1,47 @@
+import { useMemo, useRef, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { useActionErrorCtx } from './useActionErrorCtx.js';
+import { useMessageSink } from './MessageSink.js';
+import { resolveActionFields, makeFirePromise, assembleStatus } from './action-core.js';
+export function useAction(opts, registry) {
+    const errCtx = useActionErrorCtx();
+    const errCtxRef = useRef(errCtx);
+    errCtxRef.current = errCtx;
+    const { t } = useTranslation();
+    const messageSink = useMessageSink();
+    const [pending, setPending] = useState(false);
+    const [messages, setMessages] = useState([]);
+    const pendingRef = useRef(pending);
+    pendingRef.current = pending;
+    const fields = resolveActionFields(opts);
+    const firePromise = useMemo(() => makeFirePromise(opts, {
+        disabled: fields.disabled,
+        reason: fields.reason,
+        getPending: () => pendingRef.current,
+        setPending,
+        setMessages,
+        errCtxRef,
+        t,
+        registry,
+        messageSink,
+    }), [opts, fields.disabled, fields.reason, registry, t, messageSink]);
+    // Granular deps by design: memo invalidates on the specific opts/fields
+    // primitives below, not on the whole `opts`/`fields` objects (which are
+    // fresh each render and would defeat the memo).
+    return useMemo(() => assembleStatus(opts, fields, pending, messages, firePromise), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+        opts.id,
+        fields.label,
+        fields.icon,
+        fields.variant,
+        pending,
+        fields.disabled,
+        fields.reason,
+        fields.invisible,
+        fields.confirmation,
+        messages,
+        firePromise,
+    ]);
+}
+//# sourceMappingURL=useAction.js.map

package/dist/useAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAction.js","sourceRoot":"","sources":["../src/useAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGxF,MAAM,UAAU,SAAS,CACvB,IAA4C,EAC5C,QAAuC;IAEvC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAY,EAAE,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAEzC,MAAM,WAAW,GAAG,OAAO,CACzB,GAAG,EAAE,CACH,eAAe,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO;QACpC,UAAU;QACV,WAAW;QACX,SAAS;QACT,CAAC;QACD,QAAQ;QACR,WAAW;KACZ,CAAC,EACJ,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,CAAC,CACjE,CAAC;IAEF,wEAAwE;IACxE,wEAAwE;IACxE,gDAAgD;IAChD,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;IAClE,uDAAuD;IACvD;QACE,IAAI,CAAC,EAAE;QACP,MAAM,CAAC,KAAK;QACZ,MAAM,CAAC,IAAI;QACX,MAAM,CAAC,OAAO;QACd,OAAO;QACP,MAAM,CAAC,QAAQ;QACf,MAAM,CAAC,MAAM;QACb,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,YAAY;QACnB,QAAQ;QACR,WAAW;KACZ,CACF,CAAC;AACJ,CAAC"}

package/dist/useActionErrorCtx.d.ts

@@ -0,0 +1,4 @@
+import type { ActionErrorCtx } from './types.js';
+export declare const ActionErrorContext: import("react").Context<ActionErrorCtx | null>;
+export declare function useActionErrorCtx(): ActionErrorCtx | null;
+//# sourceMappingURL=useActionErrorCtx.d.ts.map

package/dist/useActionErrorCtx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActionErrorCtx.d.ts","sourceRoot":"","sources":["../src/useActionErrorCtx.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,kBAAkB,gDAA6C,CAAC;AAE7E,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAEzD"}

package/dist/useActionErrorCtx.js

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

package/dist/useActionErrorCtx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActionErrorCtx.js","sourceRoot":"","sources":["../src/useActionErrorCtx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGlD,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAwB,IAAI,CAAC,CAAC;AAE7E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC;AACxC,CAAC"}

package/dist/useActionList.d.ts

@@ -0,0 +1,13 @@
+import type { ActionOptions, ActionStatus, ErrorRoutesRegistry } from './types.js';
+/**
+ * Build a DYNAMIC list of actions from a spec array — the list counterpart to
+ * useAction. The hook count is fixed regardless of list length (one shared
+ * error context, one pending/messages map, one memo), so it is usable where
+ * useAction — a per-call hook — cannot be looped (rules of hooks). Pending and
+ * messages are tracked per action id in the shared maps; each action gets real
+ * per-item pending. The firing machinery + ActionStatus shape are the exact
+ * same shared helpers useAction uses (see action-core.ts) — nothing is
+ * reimplemented.
+ */
+export declare function useActionList<TArgs = void, TResult = void, RouteId extends string = string>(specs: ActionOptions<TArgs, TResult, RouteId>[], registry?: ErrorRoutesRegistry<RouteId>): ActionStatus<TArgs>[];
+//# sourceMappingURL=useActionList.d.ts.map

package/dist/useActionList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActionList.d.ts","sourceRoot":"","sources":["../src/useActionList.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAW,MAAM,YAAY,CAAC;AAE5F;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,EACzF,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAC/C,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,YAAY,CAAC,KAAK,CAAC,EAAE,CAqCvB"}

package/dist/useActionList.js

@@ -0,0 +1,42 @@
+import { useMemo, useRef, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { useActionErrorCtx } from './useActionErrorCtx.js';
+import { useMessageSink } from './MessageSink.js';
+import { resolveActionFields, makeFirePromise, assembleStatus } from './action-core.js';
+/**
+ * Build a DYNAMIC list of actions from a spec array — the list counterpart to
+ * useAction. The hook count is fixed regardless of list length (one shared
+ * error context, one pending/messages map, one memo), so it is usable where
+ * useAction — a per-call hook — cannot be looped (rules of hooks). Pending and
+ * messages are tracked per action id in the shared maps; each action gets real
+ * per-item pending. The firing machinery + ActionStatus shape are the exact
+ * same shared helpers useAction uses (see action-core.ts) — nothing is
+ * reimplemented.
+ */
+export function useActionList(specs, registry) {
+    const errCtx = useActionErrorCtx();
+    const errCtxRef = useRef(errCtx);
+    errCtxRef.current = errCtx;
+    const { t } = useTranslation();
+    const messageSink = useMessageSink();
+    const [pendingMap, setPendingMap] = useState({});
+    const [messagesMap, setMessagesMap] = useState({});
+    const pendingRef = useRef(pendingMap);
+    pendingRef.current = pendingMap;
+    return useMemo(() => specs.map((opts) => {
+        const fields = resolveActionFields(opts);
+        const firePromise = makeFirePromise(opts, {
+            disabled: fields.disabled,
+            reason: fields.reason,
+            getPending: () => !!pendingRef.current[opts.id],
+            setPending: (value) => setPendingMap((m) => ({ ...m, [opts.id]: value })),
+            setMessages: (msgs) => setMessagesMap((m) => ({ ...m, [opts.id]: msgs })),
+            errCtxRef,
+            t,
+            registry,
+            messageSink,
+        });
+        return assembleStatus(opts, fields, !!pendingMap[opts.id], messagesMap[opts.id] ?? [], firePromise);
+    }), [specs, pendingMap, messagesMap, registry, t, messageSink]);
+}
+//# sourceMappingURL=useActionList.js.map

package/dist/useActionList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActionList.js","sourceRoot":"","sources":["../src/useActionList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGxF;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,KAA+C,EAC/C,QAAuC;IAEvC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAA0B,EAAE,CAAC,CAAC;IAC1E,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAA4B,EAAE,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACtC,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC;IAEhC,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,EAAE;YACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACzE,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACzE,SAAS;YACT,CAAC;YACD,QAAQ;YACR,WAAW;SACZ,CAAC,CAAC;QACH,OAAO,cAAc,CACnB,IAAI,EACJ,MAAM,EACN,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EACrB,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAC1B,WAAW,CACZ,CAAC;IACJ,CAAC,CAAC,EACJ,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,CAAC,CAC3D,CAAC;AACJ,CAAC"}

package/dist/useBoolField.d.ts

@@ -0,0 +1,17 @@
+import { type FieldControls, type FieldOptions } from './field.js';
+import type { ErrorRoutesRegistry } from './types.js';
+export type BoolFieldOptions<RouteId extends string = string> = FieldOptions<boolean, boolean, RouteId>;
+export interface BoolFieldControls extends FieldControls<boolean, boolean> {
+    /**
+     * Request the opposite value. Programmatic use; widgets obtain the field's
+     * confirmation for `!value` first, then call `setValue`.
+     */
+    toggle(): void;
+}
+/**
+ * A boolean field (moxb's Bool, the sidedao boolean field). Rendered by
+ * vultus-antd's BoolCheckbox and BoolSwitch, which take the same controls.
+ * Inside the field the value starts at `initialValue` (default false).
+ */
+export declare function useBoolField<RouteId extends string = string>(opts: BoolFieldOptions<RouteId>, registry?: ErrorRoutesRegistry<RouteId>): BoolFieldControls;
+//# sourceMappingURL=useBoolField.d.ts.map

package/dist/useBoolField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoolField.d.ts","sourceRoot":"","sources":["../src/useBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,gBAAgB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAExG,MAAM,WAAW,iBAAkB,SAAQ,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC;IACxE;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC1D,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAC/B,QAAQ,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACtC,iBAAiB,CAQnB"}

package/dist/useBoolField.js

@@ -0,0 +1,12 @@
+import { useFieldCore } from './field.js';
+/**
+ * A boolean field (moxb's Bool, the sidedao boolean field). Rendered by
+ * vultus-antd's BoolCheckbox and BoolSwitch, which take the same controls.
+ * Inside the field the value starts at `initialValue` (default false).
+ */
+export function useBoolField(opts, registry) {
+    const inside = !opts.onChange && !opts.commit;
+    const field = useFieldCore('boolean', inside ? { ...opts, initialValue: opts.initialValue ?? false } : opts, registry);
+    return { ...field, toggle: () => field.setValue(!field.value) };
+}
+//# sourceMappingURL=useBoolField.js.map

package/dist/useBoolField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoolField.js","sourceRoot":"","sources":["../src/useBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AAajF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAA+B,EAC/B,QAAuC;IAEvC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,MAAM,KAAK,GAAG,YAAY,CACxB,SAAS,EACT,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EACrE,QAAQ,CACT,CAAC;IACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAClE,CAAC"}

package/dist/useMixedBoolField.d.ts

@@ -0,0 +1,24 @@
+import { type FieldControls, type FieldOptions } from './field.js';
+import type { ErrorRoutesRegistry } from './types.js';
+/** What a mixed boolean field shows: on, off, or some of its items on and some off. */
+export type MixedBool = boolean | 'mixed';
+export type MixedBoolFieldOptions<RouteId extends string = string> = FieldOptions<MixedBool, boolean, RouteId>;
+export interface MixedBoolFieldControls extends FieldControls<MixedBool, boolean> {
+    /** Request the opposite: off when on, on when off or mixed. Programmatic use, as in BoolFieldControls. */
+    toggle(): void;
+}
+/**
+ * A boolean field over an aggregate (moxb's indeterminate Bool, ARIA's
+ * "mixed"): it shows true, false or 'mixed', and can be asked for true or
+ * false only. Rendered by the same widgets as useBoolField: BoolSwitch puts
+ * its knob in the middle, BoolCheckbox is indeterminate. Derive the value with
+ * `aggregateBool`; with no items at all, disable the field with a reason.
+ */
+export declare function useMixedBoolField<RouteId extends string = string>(opts: MixedBoolFieldOptions<RouteId>, registry?: ErrorRoutesRegistry<RouteId>): MixedBoolFieldControls;
+/**
+ * The aggregate of several booleans: true when all are on, false when none is,
+ * 'mixed' otherwise; `undefined` when there are none (a case for disabling the
+ * field, not a value).
+ */
+export declare function aggregateBool(values: readonly boolean[]): MixedBool | undefined;
+//# sourceMappingURL=useMixedBoolField.d.ts.map

package/dist/useMixedBoolField.d.ts.map

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

package/dist/useMixedBoolField.js

@@ -0,0 +1,25 @@
+import { useFieldCore } from './field.js';
+/**
+ * A boolean field over an aggregate (moxb's indeterminate Bool, ARIA's
+ * "mixed"): it shows true, false or 'mixed', and can be asked for true or
+ * false only. Rendered by the same widgets as useBoolField: BoolSwitch puts
+ * its knob in the middle, BoolCheckbox is indeterminate. Derive the value with
+ * `aggregateBool`; with no items at all, disable the field with a reason.
+ */
+export function useMixedBoolField(opts, registry) {
+    const inside = !opts.onChange && !opts.commit;
+    const field = useFieldCore('mixed-boolean', inside ? { ...opts, initialValue: opts.initialValue ?? false } : opts, registry);
+    return { ...field, toggle: () => field.setValue(field.value !== true) };
+}
+/**
+ * The aggregate of several booleans: true when all are on, false when none is,
+ * 'mixed' otherwise; `undefined` when there are none (a case for disabling the
+ * field, not a value).
+ */
+export function aggregateBool(values) {
+    if (values.length === 0)
+        return undefined;
+    const on = values.filter(Boolean).length;
+    return on === values.length ? true : on === 0 ? false : 'mixed';
+}
+//# sourceMappingURL=useMixedBoolField.js.map

package/dist/useMixedBoolField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMixedBoolField.js","sourceRoot":"","sources":["../src/useMixedBoolField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AAajF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAoC,EACpC,QAAuC;IAEvC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,MAAM,KAAK,GAAG,YAAY,CACxB,eAAe,EACf,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EACrE,QAAQ,CACT,CAAC;IACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AAClE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vultus-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "Apache-2.0",
   "description": "Framework-neutral action model + hooks for vultus (antd-free by design)",
   "repository": {
@@ -11,16 +11,29 @@
   "author": "Kristof Csillag <kristof.csillag@deai-labs.com>",
   "type": "module",
   "exports": {
-    ".": "./src/index.ts",
-    "./link": "./src/LinkContext.tsx"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./link": {
+      "types": "./dist/LinkContext.d.ts",
+      "import": "./dist/LinkContext.js",
+      "default": "./dist/LinkContext.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
+    "dist",
     "src",
     "!src/**/__tests__",
     "!src/**/*.test.ts",
     "!src/**/*.test.tsx",
     "README.md"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "peerDependencies": {
     "react": ">=18",
     "react-i18next": ">=15"
@@ -39,7 +52,9 @@
     "vitest": "^3.2.4"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "test": "vitest run"
-  }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
 }

package/src/MessageSink.tsx

@@ -1,12 +1,15 @@
 import { createContext, useContext } from 'react';
+import type { Severity } from './types.js';
 
 /**
- * How the action framework surfaces an otherwise-unhandled error (no form field,
- * no inline error target). Default is a no-op so vultus-core stays antd-free and
- * framework-neutral; vultus-antd's VultusProvider wires this to antd's
- * message.error. Hosts may inject any toast/notification mechanism.
+ * 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) => void;
+export type MessageSink = (text: string, severity?: Severity) => void;
 
 export const MessageSinkContext = createContext<MessageSink>(() => {});
 

package/src/action-core.ts

@@ -12,6 +12,9 @@ import type {
   ConfirmationSpec,
   Decision,
   ErrorRoutesRegistry,
+  ExecutionContext,
+  Message,
+  Severity,
 } from './types.js';
 
 /**
@@ -49,7 +52,7 @@ export interface FirePromiseDeps<RouteId extends string> {
   reason: string | undefined;
   getPending: () => boolean;
   setPending: (value: boolean) => void;
-  setErrors: (errors: string[]) => void;
+  setMessages: (messages: Message[]) => void;
   errCtxRef: MutableRefObject<ActionErrorCtx | null>;
   t: (key: string, opts?: Record<string, unknown>) => string;
   registry?: ErrorRoutesRegistry<RouteId>;
@@ -70,13 +73,26 @@ export function makeFirePromise<TArgs, TResult, RouteId extends string>(
       console.warn(`Action '${opts.id}': already pending — ignoring fire`);
       return;
     }
-    deps.setErrors([]);
+    // 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: Message[] = [];
+    const report = (severity: Severity) => (text: string) => {
+      messages.push({ text, severity });
+      deps.setMessages([...messages]);
+      deps.messageSink?.(text, severity);
+    };
+    const ctx: ExecutionContext = { info: report('info'), warn: report('warning'), error: report('error') };
+    deps.setMessages([]);
     deps.setPending(true);
     try {
-      const result = await opts.fire(args);
+      const result = await opts.fire(args, ctx);
       opts.onSuccess?.(result as TResult);
     } 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,
           {
@@ -88,9 +104,12 @@ export function makeFirePromise<TArgs, TResult, RouteId extends string>(
           },
           deps.registry,
         );
+      } else {
+        // No route: the sink shows it, like the messages reported through ctx.
+        deps.messageSink?.(text, 'error');
       }
-      const parsed = parseApiError(err);
-      deps.setErrors([parsed.message ?? 'Action failed']);
+      messages.push({ text, severity: 'error' });
+      deps.setMessages([...messages]);
     } finally {
       deps.setPending(false);
     }
@@ -102,7 +121,7 @@ export function assembleStatus<TArgs>(
   opts: ActionOptions<TArgs, any, any>,
   fields: ResolvedFields,
   pending: boolean,
-  errors: string[],
+  messages: Message[],
   firePromise: (args: TArgs) => Promise<void>,
 ): ActionStatus<TArgs> {
   const fire = (args: TArgs) => {
@@ -118,7 +137,8 @@ export function assembleStatus<TArgs>(
     reason: fields.reason,
     invisible: fields.invisible,
     confirmation: fields.confirmation,
-    errors,
+    messages,
+    errors: messages.filter((m) => m.severity === 'error').map((m) => m.text),
     fire: fire as ActionStatus<TArgs>['fire'],
     firePromise: firePromise as ActionStatus<TArgs>['firePromise'],
   };

package/src/decision.ts

@@ -19,3 +19,7 @@ export const andDecisions = (a: Decision, b: Decision): Decision => {
   }
   return av ? b : a;
 };
+
+/** The opposite verdict, keeping the reason (a reason to disable is a reason not to enable). */
+export const invertDecision = (d: Decision): Decision =>
+  typeof d === 'boolean' ? !d : { verdict: !d.verdict, reason: d.reason };