vultus-core 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,38 @@
+# 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`, `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.
+
+## 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,10 @@
+/**
+ * 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.
+ */
+export type MessageSink = (text: string) => 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":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEjD,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;AAUlD,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 } 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;
+    setErrors: (errors: string[]) => 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, errors: string[], 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,EACpB,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,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACtC,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,CAmChC;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,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1C,YAAY,CAAC,KAAK,CAAC,CAkBrB"}

package/dist/action-core.js

@@ -0,0 +1,73 @@
+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;
+        }
+        deps.setErrors([]);
+        deps.setPending(true);
+        try {
+            const result = await opts.fire(args);
+            opts.onSuccess?.(result);
+        }
+        catch (err) {
+            if (opts.errorRoute && deps.registry) {
+                routeApiError(err, {
+                    route: opts.errorRoute,
+                    form: deps.errCtxRef.current?.form,
+                    setInlineError: deps.errCtxRef.current?.setInlineError,
+                    t: deps.t,
+                    showError: deps.messageSink,
+                }, deps.registry);
+            }
+            const parsed = parseApiError(err);
+            deps.setErrors([parsed.message ?? 'Action failed']);
+        }
+        finally {
+            deps.setPending(false);
+        }
+    };
+}
+/** Assemble the public ActionStatus from resolved fields + state + fire. */
+export function assembleStatus(opts, fields, pending, errors, 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,
+        errors,
+        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,8 @@
+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;
+//# 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"}

package/dist/decision.js

@@ -0,0 +1,15 @@
+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;
+};
+//# 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"}

package/dist/index.d.ts

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

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,80 @@
+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 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) => 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;
+    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,EAAE,MAAM,YAAY,CAAC;AAEnF,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 [errors, setErrors] = 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,
+        setErrors,
+        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, errors, 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,
+        errors,
+        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,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAW,EAAE,CAAC,CAAC;IACnD,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,SAAS;QACT,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,MAAM,EAAE,WAAW,CAAC;IAChE,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,MAAM;QACN,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/errors map, one memo), so it is usable where
+ * useAction — a per-call hook — cannot be looped (rules of hooks). Pending and
+ * errors 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,EAAE,MAAM,YAAY,CAAC;AAEnF;;;;;;;;;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/errors map, one memo), so it is usable where
+ * useAction — a per-call hook — cannot be looped (rules of hooks). Pending and
+ * errors 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 [errorsMap, setErrorsMap] = 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 })),
+            setErrors: (errs) => setErrorsMap((m) => ({ ...m, [opts.id]: errs })),
+            errCtxRef,
+            t,
+            registry,
+            messageSink,
+        });
+        return assembleStatus(opts, fields, !!pendingMap[opts.id], errorsMap[opts.id] ?? [], firePromise);
+    }), [specs, pendingMap, errorsMap, 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,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAA2B,EAAE,CAAC,CAAC;IACzE,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,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,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,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EACxB,WAAW,CACZ,CAAC;IACJ,CAAC,CAAC,EACJ,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,CAAC,CACzD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vultus-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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"
 }