@cohesivesystems/presentation-react 0.1.0-alpha.1

package/dist/page-host-renderer-registry.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { presentationTargetKinds, } from '@cohesivesystems/presentation-contracts';
+import { createPresentationEnumDiscriminator, presentationPageHostComponentRoles, resolveDefaultPresentationPageHostComponentRole, resolvePageHostRenderer as resolveCorePageHostRenderer, } from '@cohesivesystems/presentation-core';
+export { presentationPageHostComponentRoles, resolveDefaultPresentationPageHostComponentRole, };
+/**
+ * Adapts a React component that consumes the resolved page-host context into a
+ * registry renderer. This keeps the registry declarative while allowing route
+ * hosts to remain ordinary components at the projection boundary.
+ */
+export function createPageHostComponentRenderer(Component) {
+    return function renderPageHostWithComponent(context) {
+        return _jsx(Component, { ...context });
+    };
+}
+/**
+ * Creates a navigation-target renderer from a page-host registry. Resolution
+ * starts from the semantic page-host shape, resolves an adapter component role,
+ * then invokes the frontend interpreter registered for that role.
+ */
+export function createPageHostTargetRenderer({ componentSet, registry, resolveComponentKey, resolveComponentRole, }) {
+    return function renderPageHostTarget(context) {
+        const componentKey = resolveComponentKey?.(context) ?? null;
+        const componentRole = resolveComponentRole?.(context) ?? null;
+        const resolution = resolvePageHostRenderer({
+            componentKey,
+            componentRole,
+            componentSet,
+            module: context.module,
+            pageHost: context.pageHost,
+            registry,
+            route: context.route,
+        });
+        if (context.pageHost && resolution.renderer) {
+            return resolution.renderer({
+                context: context.context,
+                module: context.module,
+                navigation: context.navigation,
+                navigationTarget: context.navigationTarget,
+                pageHost: context.pageHost,
+                parameters: context.parameters,
+                route: context.route,
+            });
+        }
+        return context.renderBoundPageHost(componentKey);
+    };
+}
+/**
+ * Resolves a page-host renderer without rendering it.
+ */
+export function resolvePageHostRenderer({ componentKey, componentRole, componentSet, module, pageHost, registry, route, }) {
+    return resolveCorePageHostRenderer({
+        componentKey,
+        componentRole,
+        componentSet,
+        module,
+        pageHost,
+        registry,
+        route,
+        targetKind: reactPresentationTargetKind,
+    });
+}
+const reactPresentationTargetKind = createPresentationEnumDiscriminator(presentationTargetKinds, 'react', 'React');
+//# sourceMappingURL=page-host-renderer-registry.js.map

package/dist/page-host-renderer-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-host-renderer-registry.js","sourceRoot":"","sources":["../src/page-host-renderer-registry.tsx"],"names":[],"mappings":";AAEA,OAAO,EACL,uBAAuB,GAGxB,MAAM,yCAAyC,CAAA;AAChD,OAAO,EACL,mCAAmC,EACnC,kCAAkC,EAClC,+CAA+C,EAC/C,uBAAuB,IAAI,2BAA2B,GAOvD,MAAM,oCAAoC,CAAA;AAU3C,OAAO,EACL,kCAAkC,EAClC,+CAA+C,GAChD,CAAA;AAgDD;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAO7C,SAMC;IAQD,OAAO,SAAS,2BAA2B,CAAC,OAAO;QACjD,OAAO,KAAC,SAAS,OAAK,OAAO,GAAI,CAAA;IACnC,CAAC,CAAA;AACH,CAAC;AA8HD;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAO1C,EACA,YAAY,EACZ,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,GAQrB;IAQC,OAAO,SAAS,oBAAoB,CAAC,OAAO;QAC1C,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAA;QAC3D,MAAM,aAAa,GAAG,oBAAoB,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAA;QAC7D,MAAM,UAAU,GAAG,uBAAuB,CAAC;YACzC,YAAY;YACZ,aAAa;YACb,YAAY;YACZ,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ;YACR,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAA;QAEF,IAAI,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC;gBACzB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAClD,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAMrC,EACA,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,KAAK,GAON;IAOC,OAAO,2BAA2B,CAWhC;QACA,YAAY;QACZ,aAAa;QACb,YAAY;QACZ,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,KAAK;QACL,UAAU,EAAE,2BAA2B;KACxC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,2BAA2B,GAAG,mCAAmC,CACrE,uBAAuB,EACvB,OAAO,EACP,OAAO,CACR,CAAA"}

package/dist/presentation-action-group-runtime-options.d.ts

@@ -0,0 +1,36 @@
+import type { ReactNode } from 'react';
+import type { ActionDefinition, ActionPlacementDefinition, PresentationDataSourceResolver, PresentationModuleDefinition, ViewDefinition } from '@cohesivesystems/presentation-core';
+import type { PresentationActionRuntimeRegistry } from '@cohesivesystems/presentation-core';
+export interface PresentationActionRenderState {
+    readonly disabledReason?: ReactNode;
+    readonly isDisabled?: boolean;
+    readonly isHidden?: boolean;
+    readonly isPending?: boolean;
+    readonly label?: ReactNode;
+}
+export interface PresentationActionGroupRenderContext<TContext> {
+    readonly context: TContext;
+    readonly dataSourceResolver: PresentationDataSourceResolver;
+    readonly module: Pick<PresentationModuleDefinition, 'Actions' | 'Targets'>;
+    readonly view: ViewDefinition;
+}
+export interface PresentationActionRenderContext<TContext> extends PresentationActionGroupRenderContext<TContext> {
+    readonly action: ActionDefinition | null;
+    readonly invalidatedDataSourceIds: readonly string[];
+    readonly isFetching: boolean;
+    readonly placement: ActionPlacementDefinition;
+}
+export interface PresentationActionGroupOptions<TContext> {
+    readonly canExecuteAction?: (context: PresentationActionRenderContext<TContext>) => boolean;
+    readonly executeAction?: (context: PresentationActionRenderContext<TContext>) => Promise<void> | void;
+    readonly renderActionLabel?: (context: PresentationActionRenderContext<TContext>) => ReactNode;
+    readonly resolveActionState?: (context: PresentationActionRenderContext<TContext>) => PresentationActionRenderState | null | undefined;
+}
+export interface PresentationActionGroupRuntimeOptions<TContext> extends PresentationActionGroupOptions<TContext> {
+    readonly runtimes?: PresentationActionRuntimeRegistry<PresentationActionRenderContext<TContext>, ReactNode>;
+}
+/**
+ * Creates standard action-group options from a semantic action runtime registry.
+ */
+export declare function createPresentationActionGroupRuntimeOptions<TContext>({ canExecuteAction, executeAction, renderActionLabel, resolveActionState, runtimes, ...options }?: PresentationActionGroupRuntimeOptions<TContext>): PresentationActionGroupOptions<TContext>;
+//# sourceMappingURL=presentation-action-group-runtime-options.d.ts.map

package/dist/presentation-action-group-runtime-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-group-runtime-options.d.ts","sourceRoot":"","sources":["../src/presentation-action-group-runtime-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EACV,gBAAgB,EAChB,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,cAAc,EACf,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EACV,iCAAiC,EAClC,MAAM,oCAAoC,CAAA;AAE3C,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAA;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B;AAED,MAAM,WAAW,oCAAoC,CAAC,QAAQ;IAC5D,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,8BAA8B,CAAA;IAC3D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,SAAS,GAAG,SAAS,CAAC,CAAA;IAC1E,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAC9B;AAED,MAAM,WAAW,+BAA+B,CAAC,QAAQ,CACvD,SAAQ,oCAAoC,CAAC,QAAQ,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,wBAAwB,EAAE,SAAS,MAAM,EAAE,CAAA;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAA;CAC9C;AAED,MAAM,WAAW,8BAA8B,CAAC,QAAQ;IACtD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAA;IAC3F,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACrG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAA;IAC9F,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC5B,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,KAC/C,6BAA6B,GAAG,IAAI,GAAG,SAAS,CAAA;CACtD;AAED,MAAM,WAAW,qCAAqC,CAAC,QAAQ,CAC7D,SAAQ,8BAA8B,CAAC,QAAQ,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,iCAAiC,CACnD,+BAA+B,CAAC,QAAQ,CAAC,EACzC,SAAS,CACV,CAAA;CACF;AAED;;GAEG;AACH,wBAAgB,2CAA2C,CAAC,QAAQ,EAAE,EACpE,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,GAAG,OAAO,EACX,GAAE,qCAAqC,CAAC,QAAQ,CAAM,GAAG,8BAA8B,CAAC,QAAQ,CAAC,CAkDjG"}

package/dist/presentation-action-group-runtime-options.js

@@ -0,0 +1,50 @@
+/**
+ * Creates standard action-group options from a semantic action runtime registry.
+ */
+export function createPresentationActionGroupRuntimeOptions({ canExecuteAction, executeAction, renderActionLabel, resolveActionState, runtimes, ...options } = {}) {
+    const resolvedExecuteAction = runtimes || executeAction
+        ? (context) => {
+            const runtime = resolveRuntime(runtimes, context);
+            if (runtime?.execute &&
+                !runtime.isDisabled &&
+                !runtime.isHidden &&
+                (runtime.canExecute?.(context) ?? true)) {
+                return runtime.execute(context);
+            }
+            return executeAction?.(context);
+        }
+        : undefined;
+    return {
+        ...options,
+        canExecuteAction: (context) => {
+            const runtime = resolveRuntime(runtimes, context);
+            if (runtime?.isDisabled || runtime?.isHidden) {
+                return false;
+            }
+            if (runtime?.canExecute && !runtime.canExecute(context)) {
+                return false;
+            }
+            return canExecuteAction?.(context) ?? true;
+        },
+        executeAction: resolvedExecuteAction,
+        renderActionLabel,
+        resolveActionState: (context) => {
+            const runtime = resolveRuntime(runtimes, context);
+            const baseState = resolveActionState?.(context);
+            return {
+                ...baseState,
+                disabledReason: runtime?.disabledReason ?? baseState?.disabledReason,
+                isDisabled: Boolean(baseState?.isDisabled || runtime?.isDisabled),
+                isHidden: Boolean(baseState?.isHidden || runtime?.isHidden),
+                isPending: Boolean(baseState?.isPending || runtime?.isPending),
+                label: runtime?.isPending && runtime.pendingLabel
+                    ? runtime.pendingLabel
+                    : (runtime?.label ?? baseState?.label),
+            };
+        },
+    };
+}
+function resolveRuntime(runtimes, context) {
+    return runtimes?.[context.placement.ActionId] ?? null;
+}
+//# sourceMappingURL=presentation-action-group-runtime-options.js.map

package/dist/presentation-action-group-runtime-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-group-runtime-options.js","sourceRoot":"","sources":["../src/presentation-action-group-runtime-options.ts"],"names":[],"mappings":"AAqDA;;GAEG;AACH,MAAM,UAAU,2CAA2C,CAAW,EACpE,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,GAAG,OAAO,KACyC,EAAE;IACrD,MAAM,qBAAqB,GACzB,QAAQ,IAAI,aAAa;QACvB,CAAC,CAAC,CAAC,OAAkD,EAAE,EAAE;YACrD,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACjD,IACE,OAAO,EAAE,OAAO;gBAChB,CAAC,OAAO,CAAC,UAAU;gBACnB,CAAC,OAAO,CAAC,QAAQ;gBACjB,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,EACvC,CAAC;gBACD,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACjC,CAAC;YAED,OAAO,aAAa,EAAE,CAAC,OAAO,CAAC,CAAA;QACjC,CAAC;QACH,CAAC,CAAC,SAAS,CAAA;IAEf,OAAO;QACL,GAAG,OAAO;QACV,gBAAgB,EAAE,CAAC,OAAO,EAAE,EAAE;YAC5B,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACjD,IAAI,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;gBAC7C,OAAO,KAAK,CAAA;YACd,CAAC;YAED,IAAI,OAAO,EAAE,UAAU,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxD,OAAO,KAAK,CAAA;YACd,CAAC;YAED,OAAO,gBAAgB,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAA;QAC5C,CAAC;QACD,aAAa,EAAE,qBAAqB;QACpC,iBAAiB;QACjB,kBAAkB,EAAE,CAAC,OAAO,EAAE,EAAE;YAC9B,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACjD,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC,OAAO,CAAC,CAAA;YAC/C,OAAO;gBACL,GAAG,SAAS;gBACZ,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,SAAS,EAAE,cAAc;gBACpE,UAAU,EAAE,OAAO,CAAC,SAAS,EAAE,UAAU,IAAI,OAAO,EAAE,UAAU,CAAC;gBACjE,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,IAAI,OAAO,EAAE,QAAQ,CAAC;gBAC3D,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,OAAO,EAAE,SAAS,CAAC;gBAC9D,KAAK,EACH,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC,YAAY;oBACxC,CAAC,CAAC,OAAO,CAAC,YAAY;oBACtB,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,KAAK,CAAC;aAC3C,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CACrB,QAAiF,EACjF,OAAkD;IAElD,OAAO,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAA;AACvD,CAAC"}

package/dist/presentation-action-runtime.d.ts

@@ -0,0 +1,52 @@
+import { type QueryClient } from '@tanstack/react-query';
+import type { PresentationActionEndpointExecutionRequest } from '@cohesivesystems/presentation-core';
+import { type ActionDefinition, type PresentationBindingDefinition, type PresentationModuleDefinition } from '@cohesivesystems/presentation-core';
+export type { PresentationActionEndpointExecutionRequest } from '@cohesivesystems/presentation-core';
+export type PresentationActionEndpointExecutor = <TResult = unknown>(endpointId: string, request: PresentationActionEndpointExecutionRequest) => Promise<TResult>;
+export interface PresentationActionRequestPreparationContext<TInput> {
+    readonly action: ActionDefinition | null;
+    readonly actionId: string;
+    readonly binding: PresentationBindingDefinition | null;
+    readonly endpointId: string;
+    readonly input: TInput;
+    readonly module: PresentationModuleDefinition | null;
+}
+export interface PresentationActionSuccessContext<TInput, TResult> {
+    readonly action: ActionDefinition | null;
+    readonly actionId: string;
+    readonly endpointId: string;
+    readonly input: TInput;
+    readonly queryClient: QueryClient;
+    readonly result: TResult;
+}
+export interface UsePresentationActionExecutorOptions<TInput, TResult> {
+    readonly actionId: string;
+    readonly componentSet?: string | null;
+    readonly dataSourceId?: string | null;
+    readonly dataSourceQueryKey?: (dataSourceId: string) => readonly unknown[];
+    readonly executeEndpoint: PresentationActionEndpointExecutor;
+    readonly invalidateDataSourceIds?: readonly string[] | ((context: PresentationActionSuccessContext<TInput, TResult>) => readonly string[]);
+    readonly module: PresentationModuleDefinition | null;
+    readonly prepareRequest: (context: PresentationActionRequestPreparationContext<TInput>) => PresentationActionEndpointExecutionRequest;
+    readonly processResult?: (context: PresentationActionSuccessContext<TInput, TResult>) => void;
+    readonly setResultQueryData?: (context: PresentationActionSuccessContext<TInput, TResult>) => void;
+    readonly onSuccess?: (context: PresentationActionSuccessContext<TInput, TResult>) => void;
+}
+export interface PresentationActionExecutor<TInput, TResult> {
+    readonly action: ActionDefinition | null;
+    readonly endpointId: string | null;
+    readonly error: unknown;
+    readonly execute: (input: TInput) => void;
+    readonly executeAsync: (input: TInput) => Promise<TResult>;
+    readonly isPending: boolean;
+    readonly isSuccess: boolean;
+    readonly reset: () => void;
+}
+/**
+ * Runtime projection for endpoint-backed presentation actions. It resolves the
+ * endpoint from the action definition/target bindings, prepares an endpoint
+ * request from the caller's semantic input, executes it through the app's API
+ * adapter, and applies result/query invalidation policy.
+ */
+export declare function usePresentationActionExecutor<TInput = void, TResult = unknown>({ actionId, componentSet, dataSourceId, dataSourceQueryKey, executeEndpoint, invalidateDataSourceIds, module, onSuccess, prepareRequest, processResult, setResultQueryData, }: UsePresentationActionExecutorOptions<TInput, TResult>): PresentationActionExecutor<TInput, TResult>;
+//# sourceMappingURL=presentation-action-runtime.d.ts.map

package/dist/presentation-action-runtime.d.ts.map

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

package/dist/presentation-action-runtime.js

@@ -0,0 +1,78 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { useMemo } from 'react';
+import { findPresentationAction, resolvePresentationActionEndpointBinding, } from '@cohesivesystems/presentation-core';
+/**
+ * Runtime projection for endpoint-backed presentation actions. It resolves the
+ * endpoint from the action definition/target bindings, prepares an endpoint
+ * request from the caller's semantic input, executes it through the app's API
+ * adapter, and applies result/query invalidation policy.
+ */
+export function usePresentationActionExecutor({ actionId, componentSet = 'cohesive.presentation.react', dataSourceId, dataSourceQueryKey, executeEndpoint, invalidateDataSourceIds, module, onSuccess, prepareRequest, processResult, setResultQueryData, }) {
+    const queryClient = useQueryClient();
+    const action = useMemo(() => findPresentationAction(module, actionId), [actionId, module]);
+    const binding = useMemo(() => resolvePresentationActionEndpointBinding({
+        actionId,
+        componentSet,
+        dataSourceId,
+        module,
+    }), [actionId, componentSet, dataSourceId, module]);
+    const endpointId = binding?.EndpointId ?? null;
+    const mutation = useMutation({
+        mutationFn: async (input) => {
+            if (!endpointId) {
+                throw new Error(`No endpoint binding is registered for action '${actionId}'.`);
+            }
+            return await executeEndpoint(endpointId, prepareRequest({
+                action,
+                actionId,
+                binding,
+                endpointId,
+                input,
+                module,
+            }));
+        },
+        onSuccess: async (result, input) => {
+            if (!endpointId) {
+                return;
+            }
+            const context = {
+                action,
+                actionId,
+                endpointId,
+                input,
+                queryClient,
+                result,
+            };
+            setResultQueryData?.(context);
+            processResult?.(context);
+            await invalidatePresentationActionDataSources({
+                action,
+                context,
+                dataSourceQueryKey,
+                invalidateDataSourceIds,
+                queryClient,
+            });
+            onSuccess?.(context);
+        },
+    });
+    return {
+        action,
+        endpointId,
+        error: mutation.error,
+        execute: mutation.mutate,
+        executeAsync: mutation.mutateAsync,
+        isPending: mutation.isPending,
+        isSuccess: mutation.isSuccess,
+        reset: mutation.reset,
+    };
+}
+async function invalidatePresentationActionDataSources({ action, context, dataSourceQueryKey, invalidateDataSourceIds, queryClient, }) {
+    if (!dataSourceQueryKey) {
+        return;
+    }
+    const dataSourceIds = typeof invalidateDataSourceIds === 'function'
+        ? invalidateDataSourceIds(context)
+        : (invalidateDataSourceIds ?? action?.Result?.InvalidateDataSourceIds ?? []);
+    await Promise.all(Array.from(new Set(dataSourceIds)).map((dataSourceId) => queryClient.invalidateQueries({ queryKey: dataSourceQueryKey(dataSourceId) })));
+}
+//# sourceMappingURL=presentation-action-runtime.js.map

package/dist/presentation-action-runtime.js.map

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

package/dist/presentation-data-source-binding-runtime.d.ts

@@ -0,0 +1,3 @@
+import { type PresentationDataSourceBinding, type PresentationDataSourceState } from '@cohesivesystems/presentation-core';
+export declare function usePresentationDataSources(bindings: readonly PresentationDataSourceBinding[]): Readonly<Record<string, PresentationDataSourceState<unknown>>>;
+//# sourceMappingURL=presentation-data-source-binding-runtime.d.ts.map

package/dist/presentation-data-source-binding-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-data-source-binding-runtime.d.ts","sourceRoot":"","sources":["../src/presentation-data-source-binding-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAIjC,MAAM,oCAAoC,CAAA;AAW3C,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,kEA4CnD"}

package/dist/presentation-data-source-binding-runtime.js

@@ -0,0 +1,65 @@
+import { useQueries } from '@tanstack/react-query';
+import { useMemo } from 'react';
+import { findPresentationDataSource, isTanStackQueryBinding, resolveDataSourceAuthorization, } from '@cohesivesystems/presentation-core';
+import { usePresentationModule } from './presentation-module-context.js';
+export function usePresentationDataSources(bindings) {
+    const module = usePresentationModule();
+    const queryBindings = useMemo(() => bindings.filter(isTanStackQueryBinding), [bindings]);
+    const queryResults = useQueries({
+        queries: queryBindings.map((binding) => {
+            const authorization = resolveDataSourceAuthorization(binding);
+            return {
+                enabled: (binding.enabled ?? true) && !authorization.isBlocked,
+                queryFn: binding.queryFn,
+                queryKey: binding.queryKey,
+                refetchInterval: binding.refetchInterval,
+                retry: binding.retry,
+                staleTime: binding.staleTime,
+            };
+        }),
+    });
+    const dataSources = useMemo(() => {
+        const definitionsById = new Map(module?.DataSources.map((definition) => [definition.Id, definition]) ?? []);
+        const asyncResultsByDataSourceId = new Map(queryBindings.map((binding, index) => [binding.dataSourceId, queryResults[index]]));
+        return Object.fromEntries(bindings.map((binding) => {
+            const definition = definitionsById.get(binding.dataSourceId) ??
+                findPresentationDataSource(module, binding.dataSourceId);
+            const state = isTanStackQueryBinding(binding)
+                ? createAsyncDataSourceState(binding, asyncResultsByDataSourceId.get(binding.dataSourceId), definition)
+                : createLocalValueDataSourceState(binding, definition);
+            return [binding.dataSourceId, state];
+        }));
+    }, [bindings, module, queryBindings, queryResults]);
+    return dataSources;
+}
+function createAsyncDataSourceState(binding, result, definition) {
+    const authorization = resolveDataSourceAuthorization(binding);
+    return {
+        blockedLabel: authorization.blockedLabel,
+        data: result.data === undefined ? binding.fallbackData : result.data,
+        definition,
+        emptyMessage: binding.emptyMessage,
+        error: result.error,
+        isBlocked: authorization.isBlocked,
+        isFetching: result.isFetching,
+        isPending: result.isPending,
+        pendingLabel: binding.pendingLabel,
+        refetch: result.refetch,
+    };
+}
+function createLocalValueDataSourceState(binding, definition) {
+    const authorization = resolveDataSourceAuthorization(binding);
+    return {
+        blockedLabel: authorization.blockedLabel,
+        data: binding.data,
+        definition,
+        emptyMessage: binding.emptyMessage,
+        error: binding.error,
+        isBlocked: authorization.isBlocked,
+        isFetching: binding.isFetching,
+        isPending: binding.isPending,
+        pendingLabel: binding.pendingLabel,
+        refetch: binding.refetch,
+    };
+}
+//# sourceMappingURL=presentation-data-source-binding-runtime.js.map

package/dist/presentation-data-source-binding-runtime.js.map

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

package/dist/presentation-data-source-binding.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from 'react';
+import { type PresentationDataSourceBinding, type PresentationDataSourceStateMap } from '@cohesivesystems/presentation-core';
+export interface PresentationDataSourceBinderProps {
+    readonly bindings: readonly PresentationDataSourceBinding[];
+    readonly children: (dataSources: PresentationDataSourceStateMap) => ReactNode;
+}
+/**
+ * Binds declared presentation data sources to runtime state for projected React
+ * components.
+ */
+export declare function PresentationDataSourceBinder({ bindings, children, }: PresentationDataSourceBinderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=presentation-data-source-binding.d.ts.map

package/dist/presentation-data-source-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-data-source-binding.d.ts","sourceRoot":"","sources":["../src/presentation-data-source-binding.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACpC,MAAM,oCAAoC,CAAA;AAG3C,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,CAAA;IAC3D,QAAQ,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,8BAA8B,KAAK,SAAS,CAAA;CAC9E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,QAAQ,EACR,QAAQ,GACT,EAAE,iCAAiC,2CAGnC"}

package/dist/presentation-data-source-binding.js

@@ -0,0 +1,13 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import {} from 'react';
+import {} from '@cohesivesystems/presentation-core';
+import { usePresentationDataSources } from './presentation-data-source-binding-runtime.js';
+/**
+ * Binds declared presentation data sources to runtime state for projected React
+ * components.
+ */
+export function PresentationDataSourceBinder({ bindings, children, }) {
+    const dataSources = usePresentationDataSources(bindings);
+    return _jsx(_Fragment, { children: children(dataSources) });
+}
+//# sourceMappingURL=presentation-data-source-binding.js.map

package/dist/presentation-data-source-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-data-source-binding.js","sourceRoot":"","sources":["../src/presentation-data-source-binding.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAkB,MAAM,OAAO,CAAA;AAEtC,OAAO,EAGN,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAA;AAOvF;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,EAC3C,QAAQ,EACR,QAAQ,GAC0B;IAClC,MAAM,WAAW,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAA;IACxD,OAAO,4BAAG,QAAQ,CAAC,WAAW,CAAC,GAAI,CAAA;AACrC,CAAC"}

package/dist/presentation-flow-runtime.d.ts

@@ -0,0 +1,139 @@
+import { type ActionDefinition, type FlowDefinition, type FlowStateDefinition, type FlowTransitionDefinition, type PresentationModuleDefinition, type ViewDefinition } from '@cohesivesystems/presentation-core';
+export interface PresentationFlowInstance {
+    readonly data: Readonly<Record<string, unknown>>;
+    readonly flowId: string;
+    readonly stateId: string;
+}
+export interface PresentationFlowStartOptions {
+    readonly actionId?: string | null;
+    readonly data?: Readonly<Record<string, unknown>>;
+    readonly event?: string | null;
+    readonly flowId: string;
+    readonly stateId?: string | null;
+}
+export interface PresentationFlowDispatchOptions {
+    readonly actionId?: string | null;
+    readonly data?: Readonly<Record<string, unknown>>;
+}
+export interface PresentationFlowTransitionToOptions {
+    readonly data?: Readonly<Record<string, unknown>>;
+    readonly flowId?: string | null;
+}
+export interface PresentationFlowTransitionContext {
+    readonly flow: FlowDefinition;
+    readonly fromState: FlowStateDefinition | null;
+    readonly instance: PresentationFlowInstance;
+    readonly toState: FlowStateDefinition;
+    readonly transition: FlowTransitionDefinition | null;
+}
+export interface PresentationFlowUnhandledEventContext {
+    readonly actionId: string | null;
+    readonly event: string;
+    readonly flow: FlowDefinition;
+    readonly instance: PresentationFlowInstance;
+}
+export interface UsePresentationFlowRuntimeOptions {
+    readonly initialData?: Readonly<Record<string, unknown>>;
+    readonly initialFlowId?: string | null;
+    readonly initialStateId?: string | null;
+    readonly module: PresentationModuleDefinition | null;
+    readonly onTransition?: (context: PresentationFlowTransitionContext) => void;
+    readonly onUnhandledEvent?: (context: PresentationFlowUnhandledEventContext) => void;
+}
+export interface PresentationActionPreparedFlow {
+    readonly canCancel: boolean;
+    readonly flowId: string;
+    readonly promptViewId: string | null;
+    readonly requiresExplicitCommit: boolean;
+}
+export interface PresentationFlowRuntimeSnapshot {
+    readonly activeFlow: FlowDefinition | null;
+    readonly activeInstance: PresentationFlowInstance | null;
+    readonly activeState: FlowStateDefinition | null;
+    readonly activeView: ViewDefinition | null;
+    readonly clearFlow: () => void;
+    readonly dispatchAction: (actionId: string, options?: PresentationFlowDispatchOptions) => boolean;
+    readonly dispatchEvent: (event: string, options?: PresentationFlowDispatchOptions) => boolean;
+    readonly dispatchTransition: (transitionId: string, options?: PresentationFlowDispatchOptions) => boolean;
+    readonly isFlowActive: (flowId: string) => boolean;
+    readonly isStateActive: (stateId: string) => boolean;
+    readonly startFlow: (options: PresentationFlowStartOptions) => boolean;
+    readonly transitionTo: (stateId: string, options?: PresentationFlowTransitionToOptions) => boolean;
+}
+export interface PresentationFlowRuntimeEntry {
+    readonly flow: FlowDefinition;
+    readonly instance: PresentationFlowInstance;
+    readonly state: FlowStateDefinition;
+    readonly view: ViewDefinition | null;
+}
+export interface PresentationFlowRuntimeRegistrySnapshot {
+    readonly activeEntries: readonly PresentationFlowRuntimeEntry[];
+    readonly clearFlow: (flowId: string) => void;
+    readonly getRuntime: (flowId: string) => PresentationFlowRuntimeSnapshot;
+}
+/**
+ * Tests flow-state kind values across generated numeric constants and backend
+ * string enum serialization.
+ */
+export declare function isPresentationFlowStateKind(value: unknown, ...kinds: readonly (number | string)[]): boolean;
+/**
+ * Returns true when a flow instance is active for a specific data key/value and
+ * the active state is a visible prompt-like state.
+ */
+export declare function isPresentationFlowSurfaceOpenForData({ dataKey, dataValue, flowId, runtime, }: {
+    readonly dataKey: string;
+    readonly dataValue: string | null;
+    readonly flowId: string;
+    readonly runtime: PresentationFlowRuntimeSnapshot;
+}): boolean;
+/** Finds the first visible prompt/pending/error state in a flow definition. */
+export declare function findPresentationFlowSurfaceState(flow: FlowDefinition | null | undefined): FlowStateDefinition | null;
+/** Finds the first visible error state in a flow definition. */
+export declare function findPresentationFlowErrorSurfaceState(flow: FlowDefinition | null | undefined): FlowStateDefinition | null;
+/** Finds the first state matching one of the requested semantic flow kinds. */
+export declare function findPresentationFlowStateByKind(flow: FlowDefinition | null | undefined, ...kinds: readonly (number | string)[]): FlowStateDefinition | null;
+/**
+ * Advances an active runtime instance to a state with the requested semantic
+ * kind, preferring a valid declared transition from the current state.
+ */
+export declare function advancePresentationFlowToStateKind({ allowStateFallback, data, flow, runtime, stateKinds, }: {
+    readonly allowStateFallback?: boolean;
+    readonly data?: Readonly<Record<string, unknown>>;
+    readonly flow: FlowDefinition | null | undefined;
+    readonly runtime: PresentationFlowRuntimeSnapshot;
+    readonly stateKinds: readonly (number | string)[];
+}): boolean;
+/** Finds a valid transition from a state to any state with the requested kind. */
+export declare function findPresentationFlowTransitionToStateKind({ data, flow, fromStateId, stateKinds, }: {
+    readonly data: Readonly<Record<string, unknown>>;
+    readonly flow: FlowDefinition;
+    readonly fromStateId: string;
+    readonly stateKinds: readonly (number | string)[];
+}): FlowTransitionDefinition | null;
+/** Finds a valid action/event transition from the given flow state. */
+export declare function findPresentationFlowTransition({ actionId, data, event, flow, fromStateId, }: {
+    readonly actionId?: string | null;
+    readonly data: Readonly<Record<string, unknown>>;
+    readonly event?: string | null;
+    readonly flow: FlowDefinition;
+    readonly fromStateId: string;
+}): FlowTransitionDefinition | null;
+/**
+ * Interprets client-resident Presentation IR flows into local React state.
+ *
+ * The runtime deliberately stays semantic: it tracks the active flow, resolves
+ * transitions by event or action id, exposes the active prompt view, and leaves
+ * endpoint execution, persistence, and custom rendering to host-specific escape
+ * hatches. That lets app code migrate from imperative conditionals toward IR
+ * projection without requiring every flow side effect to be generalized first.
+ */
+export declare function usePresentationFlowRuntime({ initialData, initialFlowId, initialStateId, module, onTransition, onUnhandledEvent, }: UsePresentationFlowRuntimeOptions): PresentationFlowRuntimeSnapshot;
+/**
+ * Maintains the active instances for all client-resident Presentation IR flows
+ * in a host. Callers can still ask for a flow-scoped runtime, but prompt
+ * projection can iterate active entries instead of wiring each flow manually.
+ */
+export declare function usePresentationFlowRuntimeRegistry({ module, onTransition, onUnhandledEvent, }: Pick<UsePresentationFlowRuntimeOptions, 'module' | 'onTransition' | 'onUnhandledEvent'>): PresentationFlowRuntimeRegistrySnapshot;
+export declare function resolvePresentationActionPreparedFlow(action: ActionDefinition | null): PresentationActionPreparedFlow | null;
+export declare function matchesPresentationFlowTransitionGuard(transition: FlowTransitionDefinition, data: Readonly<Record<string, unknown>>): boolean;
+//# sourceMappingURL=presentation-flow-runtime.d.ts.map

package/dist/presentation-flow-runtime.d.ts.map

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