admin-ui-starter-kit 0.4.4 → 0.4.5

package/.agents/skills/admin-ui-consumer-migration/references/actions-service.md

@@ -55,6 +55,60 @@ export function AppRoot() {
 Do not put router, query, toast, telemetry, or i18n packages inside a package
 wrapper. They stay in the consuming app and enter through callbacks.
 
+For serious migrations, prefer the package adapters over app-local action
+wrappers:
+
+```tsx
+import {
+	ActionOverlayOutlet,
+	ActionProvider,
+	createInertiaActionRunner,
+	createReactQueryActionFeedback,
+} from 'admin-ui-starter-kit/services/actions';
+
+<ActionProvider
+	requestRunner={createInertiaActionRunner({
+		router,
+		route,
+		defaults: { preserveScroll: true },
+	})}
+	feedback={createReactQueryActionFeedback({
+		queryClient,
+		invalidate: (event) => ({ queryKey: [event.actionId] }),
+		feedback: {
+			onError: (event) => event.message && toast.error(event.message),
+		},
+	})}
+	guards={{
+		can: (permission) => auth.can(permission),
+		hasAnyRole: (roles) => auth.hasAnyRole(roles),
+	}}
+	parseErrors={(error) => parseLaravelErrors(error)}
+	onOverlayOpenChange={(open) => polling.setPaused(open)}
+	onRunningChange={(running) => activity.setBusy(running)}
+>
+	<App />
+	<ActionOverlayOutlet />
+</ActionProvider>
+```
+
+These helpers are dependency-free. They accept router-like and query-client-like
+objects, so the package stays framework-neutral.
+
+Provider contract:
+
+| Prop | Consumer responsibility |
+| --- | --- |
+| `feedback` | Toasts, telemetry, global success/error handling. |
+| `requestRunner` | Execute normalized `request` definitions through the app transport. |
+| `guards` | Permission and role checks for `permission` and `roles`. |
+| `parseErrors` | Normalize backend validation/errors into `{ fieldErrors, message }`. |
+| `onOverlayOpenChange` | Pause polling or background refresh while action overlays are open. |
+| `onRunningChange` | Track whether any action is running. |
+
+Per-action `run`, `requestRunner`, and `parseErrors` override provider-level
+defaults when a workflow needs special handling.
+
 ## Page Scope
 
 Register definitions once per scope. Do not register one action array per row.
@@ -116,6 +170,93 @@ For row menus, call `useActionSurface({ surface: 'table-row', payload: row })`
 from the row component and map the returned actions into the existing menu
 component.
 
+Use `toPageAction`, `toMenuAction`, `toTableAction`, and `toCommandAction` to
+map resolved package actions into package-owned surfaces without rebuilding the
+same glue in every app.
+
+## Local Actions
+
+Use `useLocalAction(definition, options)` when migrating an existing page-owned
+action hook. It keeps the definition local to the component but still uses the
+package lifecycle, guards, overlays, provider feedback, and request runner.
+
+```tsx
+const action = useLocalAction<Booking, { note: string }, Booking>({
+	id: 'booking.confirm',
+	label: 'Confirm booking',
+	modality: {
+		type: 'dialog',
+		title: ({ payload }) => `Confirm ${payload?.reference}`,
+		formId: 'confirm-booking-form',
+		render: ({ getFormProps, isRunning }) => (
+			<form {...getFormProps()} id="confirm-booking-form">
+				<textarea name="note" disabled={isRunning} />
+			</form>
+		),
+	},
+	request: {
+		method: 'post',
+		route: 'bookings.confirm',
+		params: ({ payload }) => payload?.id,
+		data: ({ values }) => values,
+	},
+}, { payload: booking });
+```
+
+Prefer `ActionScope` + `useActionSurface` once multiple surfaces need the same
+definition.
+
+## Requests, Guards, And Errors
+
+Use `run` for bespoke behavior. Use `request` when actions repeat the same
+route/request boilerplate and a provider adapter can execute it.
+
+```tsx
+const archiveBooking: ActionDefinition<Booking, undefined, Booking> = {
+	id: 'booking.archive',
+	label: 'Archive booking',
+	permission: ['bookings.archive', 'bookings.manage'],
+	roles: ['admin', 'ops'],
+	request: {
+		method: 'post',
+		route: 'bookings.archive',
+		params: ({ payload }) => payload?.id,
+		options: { preserveScroll: true },
+	},
+	successMessage: ({ payload }) => `${payload?.reference} archived`,
+};
+```
+
+`permission` arrays require every permission through `guards.can`. `roles`
+passes the full role list to `guards.hasAnyRole`. If a definition declares a
+permission or role and the matching guard is missing, the action is hidden.
+
+Normalize backend errors once at the provider for Laravel/Inertia-style
+validation:
+
+```tsx
+<ActionProvider
+	parseErrors={(error) => {
+		const response = error as {
+			errors?: Record<string, string | string[]>;
+			message?: string;
+		};
+
+		return {
+			fieldErrors: response.errors,
+			message: response.message ?? 'Action failed.',
+		};
+	}}
+>
+	<App />
+	<ActionOverlayOutlet />
+</ActionProvider>
+```
+
+Parsed `fieldErrors` land on `action.errors` and overlay render contexts.
+Parsed messages are used by failed lifecycle feedback unless the action defines
+an explicit `errorMessage`.
+
 ## Modality And Overlay Parity
 
 Use action modality for reusable modal workflows. A delete confirmation opened

package/CHANGELOG.md

@@ -6,7 +6,7 @@ this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
-## [0.4.4] — 2026-06-20
+## [0.4.5] — 2026-06-20
 
 ### Added
 
@@ -16,6 +16,13 @@ this project adheres to [Semantic Versioning](https://semver.org/).
   now supports alert messages, custom footer composition, hidden headers,
   focus refs, escape/backdrop behavior, content classes, confirm style, icon /
   emphasis controls, and drawer footer visibility.
+- **Action migration APIs** — added `useLocalAction` for incremental
+  page-owned action migration, provider-level guards, provider/action error
+  parsing, request runner support, overlay/running state callbacks, typed action
+  factories, and surface mapping helpers.
+- **Dependency-free action adapters** — added HTTP, Inertia-like, and React
+  Query-like helpers that accept router/query-client objects without importing
+  framework packages into the library.
 
 ### Fixed
 
@@ -29,6 +36,10 @@ this project adheres to [Semantic Versioning](https://semver.org/).
 - Documented the recommended modality pattern: use
   `services/actions` + `ActionOverlayOutlet` for reusable modal workflows, and
   reserve `features/overlays` for one-off local state.
+- Expanded package-facing action docs across `README.md`, `INTEGRATION.md`,
+  the service README, and the consumer migration skill with provider contracts,
+  request runners, guards, error parsing, local actions, and migration choice
+  points.
 
 ## [0.1.3] — 2026-05-22
 
@@ -122,7 +133,7 @@ Initial public release.
 - **What this is not:** a marketing-site UI kit. Built for admin panels
   and SaaS dashboards.
 
-[Unreleased]: https://github.com/nicolasvlachos/admin-ui-starter-kit/compare/v0.4.4...HEAD
-[0.4.4]: https://github.com/nicolasvlachos/admin-ui-starter-kit/compare/v0.1.3...v0.4.4
+[Unreleased]: https://github.com/nicolasvlachos/admin-ui-starter-kit/compare/v0.4.5...HEAD
+[0.4.5]: https://github.com/nicolasvlachos/admin-ui-starter-kit/compare/v0.1.3...v0.4.5
 [0.1.3]: https://github.com/nicolasvlachos/admin-ui-starter-kit/compare/v0.1.0...v0.1.3
 [0.1.0]: https://github.com/nicolasvlachos/admin-ui-starter-kit/releases/tag/v0.1.0

package/INTEGRATION.md

@@ -157,13 +157,15 @@ components from a client component file (`'use client'`). The package is
 framework-neutral, but interactive UI still runs on the client.
 
 For shared actions, keep the registry framework-neutral and put framework
-calls inside callbacks:
+calls inside callbacks or provider adapters:
 
 ```tsx
 import {
 	ActionOverlayOutlet,
 	ActionProvider,
 	ActionScope,
+	createInertiaActionRunner,
+	createReactQueryActionFeedback,
 	type ActionDefinition,
 } from 'admin-ui-starter-kit/services/actions';
 
@@ -180,9 +182,45 @@ const customerActions: ActionDefinition<Customer>[] = [
 		run: ({ payload }) => router.delete(`/customers/${payload?.id}`),
 		successMessage: ({ payload }) => `${payload?.name} deleted`,
 	},
+	{
+		id: 'customer.archive',
+		label: 'Archive customer',
+		permission: 'customers.archive',
+		roles: ['admin', 'ops'],
+		modality: {
+			type: 'alert',
+			tone: 'warning',
+			title: ({ payload }) => `Archive ${payload?.name}?`,
+			confirmLabel: 'Archive',
+		},
+		request: {
+			method: 'post',
+			route: 'customers.archive',
+			params: ({ payload }) => payload?.id,
+			options: { preserveScroll: true },
+		},
+		successMessage: ({ payload }) => `${payload?.name} archived`,
+	},
 ];
 
-<ActionProvider feedback={{ onSuccess: (event) => event.message && toast.success(event.message) }}>
+<ActionProvider
+	requestRunner={createInertiaActionRunner({ router, route })}
+	feedback={createReactQueryActionFeedback({
+		queryClient,
+		invalidate: (event) => ({ queryKey: [event.actionId] }),
+		feedback: {
+			onSuccess: (event) => event.message && toast.success(event.message),
+			onError: (event) => event.message && toast.error(event.message),
+		},
+	})}
+	guards={{
+		can: (permission) => auth.can(permission),
+		hasAnyRole: (roles) => auth.hasAnyRole(roles),
+	}}
+	parseErrors={(error) => parseLaravelActionError(error)}
+	onOverlayOpenChange={(open) => polling.setPaused(open)}
+	onRunningChange={(running) => activity.setBusy(running)}
+>
 	<ActionScope scope={`customer:${customer.id}`} actions={customerActions}>
 		<CustomerPage />
 	</ActionScope>
@@ -190,6 +228,14 @@ const customerActions: ActionDefinition<Customer>[] = [
 </ActionProvider>;
 ```
 
+Use `useLocalAction(definition, options)` for one page-owned action during an
+incremental migration. Use `<ActionScope>` and `useActionSurface(...)` once the
+same definition needs to appear in page actions, table row menus, command
+palette entries, cards, or action-owned overlays. `ActionOverlayOutlet` renders
+action modality through the package `features/overlays`, so reusable modal
+workflows keep the same focus, backdrop, loading, submit, and error behavior as
+direct overlay usage.
+
 For form actions, set `modality.formId` and render a form through the modality
 render prop. The context exposes `getFormProps(...)`, `submit(values)`,
 `errors`, and loading/status flags. Keep `react-hook-form`, validation schemas,

package/README.md

@@ -186,25 +186,86 @@ loading/error/overlay lifecycle. Keep one-off dialogs local with
 import {
   ActionOverlayOutlet,
   ActionProvider,
+  createInertiaActionRunner,
+  createReactQueryActionFeedback,
+  useLocalAction,
 } from 'admin-ui-starter-kit/services/actions';
 
 <ActionProvider
-  feedback={{
-    onSuccess: (event) => event.message && toast.success(event.message),
-    onError: (event) => event.message && toast.error(event.message),
+  requestRunner={createInertiaActionRunner({
+    router,
+    route,
+    defaults: { preserveScroll: true },
+  })}
+  feedback={createReactQueryActionFeedback({
+    queryClient,
+    invalidate: (event) => ({ queryKey: [event.actionId] }),
+    feedback: {
+      onSuccess: (event) => event.message && toast.success(event.message),
+      onError: (event) => event.message && toast.error(event.message),
+    },
+  })}
+  guards={{
+    can: (permission) => auth.can(permission),
+    hasAnyRole: (roles) => auth.hasAnyRole(roles),
   }}
+  parseErrors={(error) => {
+    const response = error as {
+      errors?: Record<string, string | string[]>;
+      message?: string;
+    };
+
+    return {
+      fieldErrors: response.errors,
+      message: response.message ?? 'Action failed.',
+    };
+  }}
+  onOverlayOpenChange={(open) => polling.setPaused(open)}
+  onRunningChange={(running) => activity.setBusy(running)}
 >
   <App />
   <ActionOverlayOutlet />
 </ActionProvider>
 ```
 
+Actions can be callback-driven with `run`, or data-driven through `request`
+plus a provider/action `requestRunner`. Provider `guards` keep permission and
+role checks app-owned, while `parseErrors` normalizes backend validation
+payloads into `action.errors` and failed lifecycle messages. Use
+`useLocalAction` for incremental page-owned migrations, and use
+`<ActionScope>` + `useActionSurface` when one definition needs to power page,
+table, card, command, or overlay surfaces.
+
+```tsx
+const confirmBooking = useLocalAction<Booking, { note: string }, Booking>({
+  id: 'booking.confirm',
+  label: 'Confirm booking',
+  permission: 'bookings.confirm',
+  modality: {
+    type: 'dialog',
+    title: ({ payload }) => `Confirm ${payload?.reference}`,
+    formId: 'confirm-booking-form',
+    render: ({ getFormProps, isRunning }) => (
+      <form {...getFormProps()} id="confirm-booking-form">
+        <textarea name="note" disabled={isRunning} />
+      </form>
+    ),
+  },
+  request: {
+    method: 'post',
+    route: 'bookings.confirm',
+    params: ({ payload }) => payload?.id,
+    data: ({ values }) => values,
+  }}
+}, { payload: booking });
+```
+
 Pages register contextual actions with `useRegisterActions` or
 `<ActionScope>`. Routing, permissions, translations, cache invalidation, and
-toasts stay in the consuming app through callbacks. Resolved actions expose
-`status`, `isRunning`, `isSuccess`, `isError`, `errors`, `result`, and
-timestamps; overlay form actions can use `modality.formId` with
-`getFormProps(...)` in the render context.
+toasts stay in the consuming app through callbacks, provider adapters, and
+lifecycle hooks. Resolved actions expose `status`, `isRunning`, `isSuccess`,
+`isError`, `errors`, `message`, `result`, and timestamps; overlay form actions
+can use `modality.formId` with `getFormProps(...)` in the render context.
 
 ### 7. Install the AI agent skills (optional)
 

package/dist/services/actions/action-adapters.d.ts

@@ -0,0 +1,97 @@
+import { ActionDefinition, ActionFeedbackHandlers, ActionLifecycleEvent, ActionMetadata, ActionModalityConfig, ActionRequestRunner, ResolvedAction } from './actions.types';
+type MaybePromise<T> = T | Promise<T>;
+export interface ActionHttpErrorOptions {
+    status: number;
+    statusText: string;
+    body: unknown;
+    response: Response;
+}
+export declare class ActionHttpError extends Error {
+    status: number;
+    statusText: string;
+    body: unknown;
+    response: Response;
+    errors?: unknown;
+    constructor({ status, statusText, body, response }: ActionHttpErrorOptions);
+}
+export interface CreateHttpActionRunnerOptions {
+    baseUrl?: string;
+    fetcher?: typeof fetch;
+    parseResponse?: (response: Response) => Promise<unknown>;
+}
+export declare function createHttpActionRunner<TResult = unknown>({ baseUrl, fetcher, parseResponse, }?: CreateHttpActionRunnerOptions): ActionRequestRunner<TResult>;
+export interface InertiaRouterLike {
+    visit: (url: string, options?: Record<string, unknown>) => unknown;
+}
+export interface CreateInertiaActionRunnerOptions {
+    router: InertiaRouterLike;
+    route?: (name: string, params?: unknown) => string;
+    defaults?: Record<string, unknown>;
+}
+export declare function createInertiaActionRunner<TResult = unknown>({ router, route, defaults, }: CreateInertiaActionRunnerOptions): ActionRequestRunner<TResult>;
+export interface QueryClientLike {
+    invalidateQueries?: (...args: unknown[]) => MaybePromise<unknown>;
+}
+export type QueryInvalidation = unknown | readonly unknown[] | ((event: ActionLifecycleEvent) => unknown | readonly unknown[] | undefined);
+export interface CreateReactQueryActionFeedbackOptions {
+    queryClient: QueryClientLike;
+    invalidate?: QueryInvalidation;
+    feedback?: ActionFeedbackHandlers;
+}
+export declare function createReactQueryActionFeedback({ queryClient, invalidate, feedback, }: CreateReactQueryActionFeedbackOptions): ActionFeedbackHandlers;
+export declare function defineAction<TPayload = unknown, TValues = unknown, TResult = unknown>(definition: ActionDefinition<TPayload, TValues, TResult>): ActionDefinition<TPayload, TValues, TResult>;
+export declare function defineDeleteAction<TPayload = unknown, TResult = unknown>(definition: Omit<ActionDefinition<TPayload, undefined, TResult>, 'modality'> & {
+    modality: Omit<ActionModalityConfig<TPayload, undefined, TResult>, 'type' | 'tone'> & Partial<Pick<ActionModalityConfig<TPayload, undefined, TResult>, 'type' | 'tone'>>;
+}): ActionDefinition<TPayload, undefined, TResult>;
+export declare function defineFormAction<TPayload = unknown, TValues = unknown, TResult = unknown>(definition: Omit<ActionDefinition<TPayload, TValues, TResult>, 'modality'> & {
+    modality: Omit<ActionModalityConfig<TPayload, TValues, TResult>, 'type'> & Partial<Pick<ActionModalityConfig<TPayload, TValues, TResult>, 'type'>>;
+}): ActionDefinition<TPayload, TValues, TResult>;
+export declare function defineSilentAction<TPayload = unknown, TValues = unknown, TResult = unknown>(definition: Omit<ActionDefinition<TPayload, TValues, TResult>, 'modality'>): ActionDefinition<TPayload, TValues, TResult>;
+type ActionVariant = 'primary' | 'secondary' | 'destructive' | 'success' | 'warning';
+export declare function toPageAction<TPayload = unknown, TValues = unknown, TResult = unknown>(action: ResolvedAction<TPayload, TValues, TResult>): {
+    id: string;
+    label: import('react').ReactNode;
+    onClick: () => void;
+    disabled: boolean;
+    loading: boolean;
+    icon: import('react').ComponentType<{
+        className?: string;
+    }> | undefined;
+    variant: ActionVariant | undefined;
+    visible: boolean;
+    group: string | undefined;
+    placement: import('./actions.types').ActionPlacement;
+};
+export declare function toMenuAction<TPayload = unknown, TValues = unknown, TResult = unknown>(action: ResolvedAction<TPayload, TValues, TResult>): {
+    label: string;
+    onClick: () => void;
+    disabled: boolean;
+    icon: import('react').ComponentType<{
+        className?: string;
+    }> | undefined;
+    variant: string;
+};
+export declare function toTableAction<TData = unknown>(action: ResolvedAction<TData>): {
+    id: string;
+    label: string;
+    onClick: (row: TData) => void;
+    disabled: boolean;
+    isDisabled: () => boolean;
+    isVisible: () => boolean;
+    icon: import('react').ReactElement<{
+        className?: string;
+    }, string | import('react').JSXElementConstructor<any>> | undefined;
+    variant: string;
+};
+export declare function toCommandAction<TPayload = unknown, TValues = unknown, TResult = unknown>(action: ResolvedAction<TPayload, TValues, TResult>, metadata?: ActionMetadata): {
+    id: string;
+    label: string;
+    group: string | undefined;
+    disabled: boolean;
+    icon: import('react').ComponentType<{
+        className?: string;
+    }> | undefined;
+    onSelect: () => void;
+};
+export {};
+//# sourceMappingURL=action-adapters.d.ts.map

package/dist/services/actions/action-adapters.d.ts.map

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

package/dist/services/actions/action-provider.d.ts

@@ -3,6 +3,6 @@ import { ActionStore } from './action-store';
 import { ActionProviderProps } from './actions.types';
 export declare const ActionStoreContext: import('react').Context<ActionStore | null>;
 export declare const ActionScopeContext: import('react').Context<string | null>;
-export declare function ActionProvider<TPayload = unknown, TValues = unknown, TResult = unknown>({ actions, feedback, children, }: ActionProviderProps<TPayload, TValues, TResult>): ReactNode;
+export declare function ActionProvider<TPayload = unknown, TValues = unknown, TResult = unknown>({ actions, feedback, guards, parseErrors, requestRunner, onOverlayOpenChange, onRunningChange, children, }: ActionProviderProps<TPayload, TValues, TResult>): ReactNode;
 export declare function useActionStore(): ActionStore;
 //# sourceMappingURL=action-provider.d.ts.map

package/dist/services/actions/action-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-provider.d.ts","sourceRoot":"","sources":["../../../src/services/actions/action-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKN,KAAK,SAAS,EACd,MAAM,OAAO,CAAC;AAEf,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,eAAO,MAAM,kBAAkB,6CAA0C,CAAC;AAC1E,eAAO,MAAM,kBAAkB,wCAAqC,CAAC;AAErE,wBAAgB,cAAc,CAC7B,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,EACjB,OAAO,GAAG,OAAO,EAChB,EACD,OAAO,EACP,QAAQ,EACR,QAAQ,GACR,EAAE,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,CAuB7D;AAED,wBAAgB,cAAc,IAAI,WAAW,CAM5C"}
+{"version":3,"file":"action-provider.d.ts","sourceRoot":"","sources":["../../../src/services/actions/action-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAMN,KAAK,SAAS,EACd,MAAM,OAAO,CAAC;AAEf,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAEN,KAAK,mBAAmB,EAExB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,kBAAkB,6CAA0C,CAAC;AAC1E,eAAO,MAAM,kBAAkB,wCAAqC,CAAC;AAErE,wBAAgB,cAAc,CAC7B,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,EACjB,OAAO,GAAG,OAAO,EAChB,EACD,OAAO,EACP,QAAQ,EACR,MAAM,EACN,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,QAAQ,GACR,EAAE,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,CAiC7D;AAsDD,wBAAgB,cAAc,IAAI,WAAW,CAM5C"}

package/dist/services/actions/action-store.d.ts

@@ -1,6 +1,8 @@
-import { ActionDefinition, ActionFeedbackHandlers, ActionFieldErrors, ActionMessage, ActionMessageContext, ActionMetadata, ActionRegistrationOptions, ActionStoreSnapshot, ActionSurfaceOptions, ResolvedAction, UseActionOptions } from './actions.types';
+import { ActionDefinition, ActionErrorParseContext, ActionErrorParser, ActionFeedbackHandlers, ActionFieldErrors, ActionGuards, ActionMessage, ActionMessageContext, ActionMetadata, ActionRegistrationOptions, ActionRequestConfig, ActionRequestRunner, ActionRunContext, ParsedActionError, ResolvedActionRequest, ActionStoreSnapshot, ActionSurfaceOptions, ResolvedAction, UseActionOptions } from './actions.types';
 export declare function extractActionFieldErrors(error: unknown): ActionFieldErrors;
 export declare function resolveActionMessage<TPayload = unknown, TValues = unknown, TResult = unknown>(message: ActionMessage<TPayload, TValues, TResult> | undefined, context: ActionMessageContext<TPayload, TValues, TResult>): string | undefined;
+export declare function resolveActionRequest<TPayload = unknown, TValues = unknown>(request: ActionRequestConfig<TPayload, TValues>, context: ActionRunContext<TPayload, TValues>): ResolvedActionRequest;
+export declare function parseActionError<TPayload = unknown, TValues = unknown>(error: unknown, context: ActionErrorParseContext<TPayload, TValues>, parser?: ActionErrorParser): ParsedActionError;
 export declare class ActionStore {
     private registrations;
     private runStates;
@@ -9,11 +11,20 @@ export declare class ActionStore {
     private snapshot;
     private readonly listeners;
     private feedback;
+    private guards;
+    private errorParser;
+    private requestRunner;
     private readonly abortControllers;
     private readonly runTokens;
     subscribe: (listener: () => void) => (() => void);
     getSnapshot: () => ActionStoreSnapshot;
     setFeedback(feedback?: ActionFeedbackHandlers): void;
+    setOptions(options: {
+        feedback?: ActionFeedbackHandlers;
+        guards?: ActionGuards;
+        parseErrors?: ActionErrorParser;
+        requestRunner?: ActionRequestRunner;
+    }): void;
     registerActions<TPayload = unknown, TValues = unknown, TResult = unknown>(actions: readonly ActionDefinition<TPayload, TValues, TResult>[], options?: ActionRegistrationOptions): () => void;
     selectSurfaceActions<TPayload = unknown, TValues = unknown, TResult = unknown>(options: ActionSurfaceOptions<TPayload>): ResolvedAction<TPayload, TValues, TResult>[];
     selectAction<TPayload = unknown, TValues = unknown, TResult = unknown>(actionId: string, options?: UseActionOptions<TPayload>): ResolvedAction<TPayload, TValues, TResult> | null;
@@ -32,6 +43,7 @@ export declare class ActionStore {
     private resolveEntry;
     private createRunContext;
     private isEntryDisabled;
+    private isEntryVisible;
     private emitLifecycle;
     private findEntry;
     private getRunState;

package/dist/services/actions/action-store.d.ts.map

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