@judo/actions 0.1.0

package/dist/provider/api-context.d.ts

@@ -0,0 +1,30 @@
+import { ReactNode } from 'react';
+import { JudoRestApi } from '../api/judo-rest-api';
+/**
+ * API context type.
+ */
+export interface ApiContextType {
+    /** JUDO REST API client */
+    api: JudoRestApi;
+}
+/**
+ * Hook to access the JUDO REST API client.
+ *
+ * @returns JudoRestApi
+ * @throws Error if used outside ApiProvider
+ */
+export declare function useApi(): JudoRestApi;
+/**
+ * Props for ApiProvider.
+ */
+export interface ApiProviderProps {
+    children: ReactNode;
+    /** JUDO REST API client instance */
+    api: JudoRestApi;
+}
+/**
+ * Provider for JUDO REST API client.
+ * Makes the API client available to action handlers via the useApi hook.
+ */
+export declare function ApiProvider({ children, api }: ApiProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=api-context.d.ts.map

package/dist/provider/api-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-context.d.ts","sourceRoot":"","sources":["../../src/provider/api-context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA6B,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,2BAA2B;IAC3B,GAAG,EAAE,WAAW,CAAC;CACjB;AAID;;;;;GAKG;AACH,wBAAgB,MAAM,IAAI,WAAW,CAMpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB,oCAAoC;IACpC,GAAG,EAAE,WAAW,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,gBAAgB,2CAG9D"}

package/dist/provider/index.d.ts

@@ -0,0 +1,2 @@
+export { ApiProvider, useApi, type ApiContextType, type ApiProviderProps } from './api-context';
+//# sourceMappingURL=index.d.ts.map

package/dist/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/registry/action-handler-registry.d.ts

@@ -0,0 +1,11 @@
+import { Action, ActionHandlerHook } from '../types';
+/**
+ * Get the handler for an action.
+ * Returns the handler hook if found, undefined otherwise.
+ */
+export declare function getActionHandler(action: Action): ActionHandlerHook | undefined;
+/**
+ * Check if a handler exists for the given action.
+ */
+export declare function hasActionHandler(action: Action): boolean;
+//# sourceMappingURL=action-handler-registry.d.ts.map

package/dist/registry/action-handler-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-handler-registry.d.ts","sourceRoot":"","sources":["../../src/registry/action-handler-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAgI1D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAG9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/registry/index.d.ts

@@ -0,0 +1,2 @@
+export { getActionHandler, hasActionHandler } from './action-handler-registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/types-BsQmyhQI.js

@@ -0,0 +1,14 @@
+var ValidationError = class extends Error {
+	feedbackItems;
+	status = 400;
+	constructor(e) {
+		let t = e.find((e) => e.level === "ERROR");
+		super(t?.message ?? "Validation failed"), this.name = "ValidationError", this.feedbackItems = e;
+	}
+	toFieldErrors() {
+		let e = {};
+		for (let t of this.feedbackItems) t.level === "ERROR" && t.location && (e[t.location] = t.message ?? t.code);
+		return e;
+	}
+};
+export { ValidationError as t };

package/dist/types-BsQmyhQI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BsQmyhQI.js","names":["errors: Record<string, string>"],"sources":["../src/api/types.ts"],"sourcesContent":["/**\n * JUDO REST API types.\n * Based on REST_REQUEST_MAPPING_SPECIFICATION.md\n */\n\n// ============================================\n// HTTP/Response Types\n// ============================================\n\n/**\n * HTTP method types used in the REST layer.\n * GET is used for template retrieval, file downloads, metadata, principal.\n * POST is used for all other operations (CRUD, list, range, operations, validation).\n */\nexport type HttpMethod = \"GET\" | \"POST\";\n\n/**\n * Response type indicating how to handle the response body.\n */\nexport type ResponseType = \"json\" | \"blob\";\n\n/**\n * How to deserialize the response.\n * - single: Deserialize as a single transfer\n * - array: Deserialize as an array of transfers\n * - void: No deserialization needed (response is empty)\n * - nullable: Deserialize as single transfer or null\n */\nexport type DeserializationType = \"single\" | \"array\" | \"void\" | \"nullable\";\n\n/**\n * Service type categories.\n */\nexport type ServiceType = \"class\" | \"relation\" | \"access\";\n\n// ============================================\n// Serialization/Deserialization\n// ============================================\n\n/**\n * Configuration for deserializing the response.\n */\nexport interface ResponseDeserializerConfig {\n\t/** Type of deserialization to apply */\n\ttype: DeserializationType;\n\t/** Target class FQName for deserialization (if applicable) */\n\ttargetClassFqName?: string;\n\t/** Whether the target is a stored (persisted) transfer */\n\tisStored: boolean;\n}\n\n/**\n * Transfer serializer interface for transforming transfers before sending.\n * The input type is unknown to support any transfer type.\n */\nexport interface TransferSerializer {\n\t/** Serialize an transfer for sending in request body */\n\tserialize(transfer: unknown): unknown;\n}\n\n/**\n * Transfer deserializer interface for transforming responses.\n * The output type is unknown to support any transfer type.\n */\nexport interface TransferDeserializer {\n\t/** Deserialize a response into an transfer */\n\tdeserialize(data: unknown): unknown;\n}\n\n// ============================================\n// Temporal Field Types\n// ============================================\n\n/**\n * Classification of temporal (date/time) field types.\n *\n * - `date`: Date-only value (`YYYY-MM-DD`) — converted to `Date` at local midnight\n * - `time`: Time-only value (`HH:mm[:ss]`) — kept as `string` (no `Date` conversion)\n * - `timestamp`: Full datetime with timezone (`YYYY-MM-DDTHH:mm:ss[.SSS]Z`) — converted to `Date`\n */\nexport type TemporalFieldType = \"date\" | \"time\" | \"timestamp\";\n\n/**\n * Registry mapping transfer type FQNs to their temporal field declarations.\n *\n * Keys match `__entityType` values from API responses (e.g., `\"Demo::OrderDTO\"`).\n * Values map field names to their temporal type for serialization/deserialization.\n *\n * @example\n * ```typescript\n * const registry: TemporalFieldRegistry = {\n *   \"Demo::OrderDTO\": { orderDate: \"date\", createdAt: \"timestamp\" },\n *   \"Demo::MissionDTO\": { startDate: \"date\", endDate: \"date\" },\n * };\n * ```\n */\nexport type TemporalFieldRegistry = Record<string, Record<string, TemporalFieldType>>;\n\n// ============================================\n// API Configuration\n// ============================================\n\n/**\n * Configuration for JUDO REST API client.\n */\nexport interface JudoRestApiConfig {\n\t/** Base URL for the API (e.g., http://localhost:8080) */\n\tbaseUrl: string;\n\t/** Application base path (e.g., /api) */\n\tbasePath: string;\n\t/** Application model name (e.g., edemokracia) */\n\tmodelName: string;\n\t/** Actor path (e.g., admin/Admin) */\n\tactorPath: string;\n\t/** Request timeout in milliseconds */\n\ttimeout?: number;\n\t/** Default headers to include in all requests */\n\tdefaultHeaders?: Record<string, string>;\n\t/** Optional custom fetch implementation */\n\tfetch?: typeof fetch;\n\t/** Optional request interceptor */\n\tonRequest?: (request: RequestInit) => RequestInit | Promise<RequestInit>;\n\t/** Optional response interceptor */\n\tonResponse?: (response: Response) => Response | Promise<Response>;\n\t/** Optional error handler */\n\tonError?: (error: Error) => void;\n\t/**\n\t * Optional transfer serializer for transforming transfers before sending.\n\t * If not provided, transfers are sent as-is (JSON.stringify).\n\t */\n\ttransferSerializer?: TransferSerializer;\n\t/**\n\t * Optional transfer deserializer for transforming responses.\n\t * If not provided, responses are used as-is (JSON.parse result).\n\t */\n\ttransferDeserializer?: TransferDeserializer;\n}\n\n/**\n * Query customizer for list/get operations.\n */\nexport interface QueryCustomizer {\n\t_mask?: string;\n\t_orderBy?: Array<{ attribute: string; descending?: boolean }>;\n\t_seek?: { limit?: number; lastItem?: unknown };\n\t_filter?: unknown;\n\t_identifier?: string;\n}\n\n/**\n * Base transfer data interface.\n *\n */\nexport interface TransferData {\n\t[key: string]: unknown;\n}\n\n/**\n * Strict transfer data — a TransferData whose *own* properties conform to `T`.\n *\n * Use in generated code and userland APIs where the exact field set is known.\n *\n * @typeParam T - Strict field definitions (e.g. `{ name: string; age: number }`)\n */\nexport type StrictTransferData<T extends Record<string, unknown> = Record<string, unknown>> = TransferData & T;\n\n/**\n * Stored transfer with identifiers.\n */\nexport interface TransferStored extends TransferData {\n\t__identifier?: string;\n\t__signedIdentifier?: string;\n\t__typename?: string;\n\t__entityType?: string;\n}\n\n/**\n * Strict stored transfer — a TransferStored with compile-time field types from `T`.\n *\n * @typeParam T - Strict field definitions\n */\nexport type StrictTransferStored<T extends Record<string, unknown> = Record<string, unknown>> = TransferStored & T;\n\n/**\n * Response wrapper for JUDO REST responses.\n */\nexport interface JudoRestResponse<T> {\n\tdata: T;\n\tstatus: number;\n\theaders: Headers;\n}\n\n/**\n * Path context for building REST paths.\n */\nexport interface PathContext {\n\t/** Package name tokens (e.g., [\"admin\"]) */\n\tpackageNameTokens: string[];\n\t/** Simple name (e.g., \"Issue\") */\n\tsimpleName: string;\n}\n\n/**\n * Class type metadata for path building.\n */\nexport interface ClassTypeMetadata extends PathContext {\n\t/** Fully qualified name */\n\tfqName?: string;\n\t/** Whether the class is mapped */\n\tisMapped?: boolean;\n}\n\n/**\n * Relation type metadata for path building.\n */\nexport interface RelationMetadata {\n\t/** Relation name */\n\tname: string;\n\t/** Owner class metadata */\n\towner: ClassTypeMetadata;\n\t/** Target class metadata */\n\ttarget: ClassTypeMetadata;\n\t/** Whether this is an access relation */\n\tisAccess?: boolean;\n\t/** Whether this is a collection relation */\n\tisCollection?: boolean;\n}\n\n/**\n * Operation type metadata.\n */\nexport interface OperationMetadata {\n\t/** Operation name */\n\tname: string;\n\t/** Whether the operation is static */\n\tisStatic?: boolean;\n\t/** Whether the operation is mapped */\n\tisMapped?: boolean;\n\t/** Whether the operation has input */\n\thasInput?: boolean;\n\t/** Whether the operation has output */\n\thasOutput?: boolean;\n\t/** Input type metadata */\n\tinputType?: ClassTypeMetadata;\n\t/** Output type metadata */\n\toutputType?: ClassTypeMetadata;\n}\n\n/**\n * Range request body structure.\n */\nexport interface RangeRequestBody {\n\towner?: TransferStored;\n\tqueryCustomizer?: QueryCustomizer;\n}\n\n// ============================================\n// Validation & Error Types\n// ============================================\n\n/**\n * Validation feedback item from REST API.\n * Returned in response body for 400 validation errors.\n */\nexport interface FeedbackItem {\n\t/** Error code identifier */\n\tcode: string;\n\t/** Severity level of the feedback */\n\tlevel: \"ERROR\" | \"WARNING\" | \"INFO\";\n\t/**\n\t * Location of the error - typically the attribute path.\n\t * For nested properties, format is: \"relationName.attributeName\"\n\t * For simple attributes, format is: \"attributeName\"\n\t */\n\tlocation: string;\n\t/** Human-readable error message */\n\tmessage?: string;\n}\n\n/**\n * Validation error thrown when API returns 400 status.\n * Contains array of FeedbackItem with field-level error details.\n */\nexport class ValidationError extends Error {\n\treadonly feedbackItems: FeedbackItem[];\n\treadonly status: number = 400;\n\n\tconstructor(feedbackItems: FeedbackItem[]) {\n\t\tconst firstError = feedbackItems.find((f) => f.level === \"ERROR\");\n\t\tsuper(firstError?.message ?? \"Validation failed\");\n\t\tthis.name = \"ValidationError\";\n\t\tthis.feedbackItems = feedbackItems;\n\t}\n\n\t/**\n\t * Get errors as a map of field location to error message.\n\t * Useful for setting form field errors.\n\t */\n\ttoFieldErrors(): Record<string, string> {\n\t\tconst errors: Record<string, string> = {};\n\t\tfor (const item of this.feedbackItems) {\n\t\t\tif (item.level === \"ERROR\" && item.location) {\n\t\t\t\terrors[item.location] = item.message ?? item.code;\n\t\t\t}\n\t\t}\n\t\treturn errors;\n\t}\n}\n\n// ============================================\n// Dialog Response Types\n// ============================================\n\n/**\n * Result type for dialog submission.\n * Used for create dialogs opened from eager/lazy components.\n */\nexport type DialogResult<T = TransferData> = { outcome: \"cancel\" } | { outcome: \"submit\"; data: T };\n\n/**\n * Callback for dialog submission.\n * Called when user submits the create form.\n */\nexport type OnDialogSubmit<T = TransferData> = (data: T) => Promise<void>;\n\n/**\n * Callback for dialog validation.\n * Called before submission to validate form data.\n * Returns field errors or null if valid.\n */\nexport type OnDialogValidate<T = TransferData> = (data: T) => Promise<Record<string, string> | null>;\n"],"mappings":"AA2RA,IAAa,kBAAb,cAAqC,MAAM;CAC1C;CACA,SAA0B;CAE1B,YAAY,GAA+B;EAC1C,IAAM,IAAa,EAAc,MAAM,MAAM,EAAE,UAAU,QAAQ;AAGjE,EAFA,MAAM,GAAY,WAAW,oBAAoB,EACjD,KAAK,OAAO,mBACZ,KAAK,gBAAgB;;CAOtB,gBAAwC;EACvC,IAAMA,IAAiC,EAAE;AACzC,OAAK,IAAM,KAAQ,KAAK,cACvB,CAAI,EAAK,UAAU,WAAW,EAAK,aAClC,EAAO,EAAK,YAAY,EAAK,WAAW,EAAK;AAG/C,SAAO"}

package/dist/types-CbA9-fcJ.js

@@ -0,0 +1,2 @@
+import { t as ValidationError } from "./types-BsQmyhQI.js";
+export { ValidationError };

package/dist/types.d.ts

@@ -0,0 +1,260 @@
+import { Action, Application } from '@judo/model-api';
+/**
+ * @judo/actions - Type definitions
+ *
+ * Defines action-specific types for the built-in handlers.
+ * All action handlers use the hook factory pattern for React hooks compatibility.
+ *
+ * NOTE: This package defines its own ActionHandlerHook type with typed context
+ * because model-api uses `unknown` for maximum flexibility, but built-in handlers
+ * need typed access to navigation, data store, and registry services.
+ */
+export type { Action, ActionDefinition, Application } from '@judo/model-api';
+export { ACTION_HANDLER_FACTORY } from '@judo/model-api';
+/**
+ * Action types supported by the action handlers.
+ */
+export type ActionType = "BackActionDefinition" | "OpenPageActionDefinition" | "RowOpenPageActionDefinition" | "CancelActionDefinition" | "OpenFormActionDefinition" | "OpenCreateFormActionDefinition" | "OpenOperationInputFormActionDefinition" | "OpenSelectorActionDefinition" | "OpenAddSelectorActionDefinition" | "OpenSetSelectorActionDefinition" | "OpenOperationInputSelectorActionDefinition" | "SelectorRangeActionDefinition" | "RefreshActionDefinition" | "CreateActionDefinition" | "UpdateActionDefinition" | "DeleteActionDefinition" | "BulkDeleteActionDefinition" | "RowDeleteActionDefinition" | "GetTemplateActionDefinition" | "SetActionDefinition" | "UnsetActionDefinition" | "AddActionDefinition" | "RemoveActionDefinition" | "BulkRemoveActionDefinition" | "ClearActionDefinition" | "RefreshRelationActionDefinition" | "FilterRelationActionDefinition" | "FilterActionDefinition" | "ExportActionDefinition" | "InlineCreateRowActionDefinition" | "CallOperationActionDefinition" | "BulkCallOperationActionDefinition" | "InputFormCallOperationActionDefinition" | "InputSelectorCallOperationActionDefinition" | "ParameterlessCallOperationActionDefinition" | "AutocompleteRangeActionDefinition" | "AutocompleteSetActionDefinition" | "AutocompleteAddActionDefinition" | "PreFetchActionDefinition" | "CustomActionDefinition";
+/**
+ * Transfer data with identifier.
+ *
+ */
+export interface TransferData {
+    __identifier?: string;
+    [key: string]: unknown;
+}
+/**
+ * Strict transfer data — a TransferData whose *own* properties conform to `T`.
+ *
+ * @typeParam T - Strict field definitions
+ */
+export type StrictTransferData<T extends Record<string, unknown> = Record<string, unknown>> = TransferData & T;
+/**
+ * Dialog close result types.
+ */
+export type DialogCloseResultType = "cancelled" | "created" | "updated" | "deleted" | "selected" | "submitted";
+/**
+ * Result returned when dialog closes.
+ * Uses discriminated union for type-safe handling of different outcomes.
+ */
+export type DialogCloseResult = {
+    type: "cancelled";
+} | {
+    type: "created";
+    isEager: boolean;
+    data?: unknown;
+} | {
+    type: "updated";
+    data?: unknown;
+} | {
+    type: "deleted";
+    data?: unknown;
+} | {
+    type: "selected";
+    data?: unknown;
+} | {
+    type: "submitted";
+    data?: unknown;
+};
+/**
+ * Navigation context interface.
+ */
+export interface NavigationContext {
+    goBack(): void;
+    navigateTo(page: unknown, params?: Record<string, unknown>): void;
+    replacePage(page: unknown, params?: Record<string, unknown>): void;
+    openDialog(page: unknown, params?: Record<string, unknown>, onClose?: (result?: DialogCloseResult) => void): void;
+}
+/**
+ * Data store interface for transfer operations.
+ */
+export interface DataStore {
+    setTransferLoading(id: string, loading: boolean): void;
+    setTransferData<T extends Record<string, unknown> = Record<string, unknown>>(id: string, data: TransferData & T): void;
+    setTransferError(id: string, error: Error): void;
+    clearTransfer(id: string): void;
+    resetTransfer(id: string): void;
+    getSnapshot<T>(selector: (state: unknown) => T): T;
+    updateTransferFields<T extends Record<string, unknown> = Record<string, unknown>>(id: string, updates: Partial<T>): void;
+}
+/**
+ * Model registry interface for handler lookups.
+ * Note: In most cases, handlers should use resolved properties from Action/ActionDefinition
+ * directly rather than calling these methods.
+ *
+ * At runtime, this is typically the ApplicationContextType from @judo/core,
+ * which provides access to the current application and its actor.
+ */
+export interface ModelRegistry {
+    resolvePageDefinition?(ref: string): unknown;
+    resolveClassType?(ref: string): unknown;
+    resolveById?(id: string): unknown;
+    /** Current active application (contains the actor ClassType). */
+    application?: Application;
+}
+/**
+ * Validation context interface for setting field errors from API responses.
+ */
+export interface ValidationContext {
+    /** Set error for a specific field */
+    setError(fieldId: string, error: string | null): void;
+    /** Set multiple errors at once (typically from API validation response) */
+    setErrors(errors: Record<string, string>): void;
+    /** Clear all validation errors */
+    clearErrors(): void;
+    /** Clear error for a specific field */
+    clearError(fieldId: string): void;
+    /** Touch all fields (mark as visited/modified) */
+    touchAll?(): void;
+}
+/**
+ * Notification service interface for showing toast notifications.
+ * Used by action handlers to provide user feedback.
+ */
+export interface NotificationService {
+    /** Show success notification */
+    success(message: string): void;
+    /** Show error notification */
+    error(message: string): void;
+    /** Show warning notification */
+    warning(message: string): void;
+    /** Show info notification */
+    info(message: string): void;
+}
+/**
+ * Dialog context for create form submissions.
+ * Provides callbacks for validation and submission.
+ */
+export interface CreateDialogContext {
+    /**
+     * Whether this is a create dialog for an eager (aggregated) component.
+     * Eager dialogs return data to the caller instead of persisting via API.
+     */
+    isEager?: boolean;
+    /**
+     * Owner transfer for the relation being created.
+     * Required for non-access relations to build the correct API path.
+     */
+    ownerTransfer?: TransferData;
+    /**
+     * Relation type for the create operation.
+     * Used to determine API endpoints and validation paths.
+     */
+    relation?: unknown;
+    /**
+     * Parent transfer ID in the data store where created transfer should be added.
+     * For eager tables embedded in VIEW pages, this is the VIEW page's transfer ID.
+     */
+    parentTransferId?: string;
+    /**
+     * Relation name (property name) on the parent transfer where created transfer should be added.
+     * For eager tables, this is the relation property (e.g., "addresses" on a customer transfer).
+     */
+    relationName?: string;
+    /**
+     * Callback to submit created transfer data.
+     * For eager components: returns data to caller (table/link adds to local state)
+     * For lazy components: persists via API then refreshes parent data
+     */
+    onSubmitCreate?: (data: TransferData) => Promise<void>;
+    /**
+     * Callback for dialog cancellation.
+     */
+    onCancel?: () => void;
+}
+/**
+ * Action handler context for built-in handlers.
+ * This is the concrete typed version used by built-in action handlers.
+ * It provides specific types for navigation, data store, and registry.
+ *
+ * Note: This has the same shape as ActionHandlerContext from model-api but with specific types.
+ * Properties are optional to maintain compatibility with base type, but built-in handlers
+ * expect them to be provided at runtime.
+ */
+export interface TypedActionHandlerContext {
+    /** The transfer being acted upon */
+    transfer?: TransferData;
+    /** Selected rows for bulk/table operations */
+    selectedRows?: TransferData[];
+    /** Dialog closer if action is in a dialog, with optional result */
+    closeDialog?: (result?: DialogCloseResult) => void;
+    /** Navigation context for page transitions (typed, expected to be present) */
+    navigation?: NavigationContext;
+    /** Data store for transfer operations (typed, expected to be present) */
+    data?: DataStore;
+    /** Model registry for lookups (typed, expected to be present) */
+    registry?: ModelRegistry;
+    /** Validation context for setting field errors */
+    validation?: ValidationContext;
+    /** Notification service for showing toast messages */
+    notifications?: NotificationService;
+    /**
+     * Whether the initiating component is eager (aggregated).
+     * Eager components manage their own data locally without REST calls.
+     */
+    isEager?: boolean;
+    /**
+     * Current page container type (TABLE, FORM, VIEW).
+     * Used to determine context-specific behavior.
+     */
+    pageType?: "TABLE" | "FORM" | "VIEW";
+    /**
+     * Whether the current view page is in edit mode (has unsaved changes).
+     * Only relevant when pageType is VIEW.
+     */
+    isEditMode?: boolean;
+    /**
+     * Whether this action was triggered from a page-level button (dialog footer).
+     * Page actions bypass certain restrictions that apply to nested operations.
+     */
+    isPageAction?: boolean;
+    /**
+     * Create dialog context for form submissions.
+     * Present when the action is triggered from a create dialog.
+     */
+    createDialog?: CreateDialogContext;
+    /**
+     * Callback to be invoked when a dialog opened by this action closes.
+     * Used by callers (e.g., TableRenderer) to refresh data after successful creates.
+     */
+    onDialogClose?: (result?: DialogCloseResult) => void;
+}
+export type { ActionHandlerFn, ActionHandlerHook } from '@judo/model-api';
+/**
+ * Typed handler function for built-in handlers.
+ * Uses TypedActionHandlerContext instead of base ActionHandlerContext.
+ */
+export type TypedActionHandlerFn = (context: TypedActionHandlerContext) => Promise<unknown>;
+/**
+ * Typed handler hook for built-in handlers.
+ * Returns a handler that uses TypedActionHandlerContext.
+ */
+export type TypedActionHandlerHook = (action: Action) => TypedActionHandlerFn;
+/**
+ * Action handler hook with actionType metadata for built-in handler registration.
+ * Uses typed context for built-in handlers.
+ */
+export interface ActionHandlerHookWithMeta extends TypedActionHandlerHook {
+    /** The action type this handler handles (e.g., 'BackActionDefinition') */
+    actionType: ActionType;
+}
+/**
+ * @internal Framework-internal service properties for custom action handler registration.
+ *
+ * **Do not use directly.** Developers should use the generated `createCustomizations()`
+ * factory with human-readable page and action names instead.
+ */
+export interface ActionHandlerFactoryProperties {
+    /** @internal The action's xmi:id — resolved automatically by the factory */
+    sourceId: string;
+}
+/**
+ * Service properties for built-in action handler registration (internal).
+ */
+export interface BuiltInActionHandlerFactoryProperties {
+    /** The action type this built-in handles (e.g., 'BackActionDefinition') */
+    actionType: string;
+    /** Marker for built-in handlers */
+    builtin: true;
+}
+//# 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/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@judo/actions",
+  "version": "0.1.0",
+  "license": "EPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BlackBeltTechnology/judo-frontend-runtime.git",
+    "directory": "packages/actions"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@judo/model-api": "0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.14",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  }
+}