@cohesivesystems/presentation-core 0.1.0-alpha.1

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

@@ -0,0 +1,305 @@
+import { pageHostComponentRoles, presentationBindingKinds, viewKindLabels, viewKinds, } from '@cohesivesystems/presentation-contracts';
+import { getPresentationViewSemanticRole } from './presentation-semantics.js';
+import { createPresentationEnumDiscriminator, resolvePresentationComponentBinding, } from './target-bindings.js';
+export const presentationPageHostComponentRoles = pageHostComponentRoles;
+/**
+ * Resolves a page-host renderer without rendering it.
+ *
+ * Resolution order is:
+ * semantic role, component role, view kind, component key, explicit id
+ * overrides, fallback. Id and component-key branches are treated as escape
+ * hatches by diagnostics.
+ */
+export function resolvePageHostRenderer({ componentKey, componentRole, componentSet, module, pageHost, registry, route, targetKind, }) {
+    const resolvedComponentKey = componentKey ?? null;
+    const resolvedComponentRole = componentRole ?? null;
+    const view = findPageHostView(module, pageHost);
+    const semanticRole = view ? getPresentationViewSemanticRole(view) : null;
+    const targetBinding = resolvePageHostTargetRendererBinding({
+        componentSet,
+        module,
+        pageHost,
+        route,
+        targetKind,
+        view,
+    });
+    const targetRendererKey = targetBinding?.rendererKey ?? null;
+    const targetComponentKey = targetBinding?.componentKey ?? null;
+    const targetComponentRole = targetBinding?.componentRole ?? null;
+    const defaultComponentRole = resolveDefaultPresentationPageHostComponentRole({
+        module,
+        pageHost,
+        view,
+    });
+    const effectiveComponentKey = resolvedComponentKey ?? targetComponentKey;
+    const effectiveComponentRole = resolvedComponentRole ?? targetComponentRole ?? defaultComponentRole;
+    const pageHostId = pageHost?.Id;
+    const routeId = route?.Id;
+    const workspaceId = pageHost?.Workspace?.WorkspaceId;
+    const viewId = pageHost?.View?.ViewId;
+    if (semanticRole) {
+        const renderer = registry.bySemanticRole?.[semanticRole];
+        if (renderer !== undefined && renderer !== null) {
+            return createResolution({
+                componentKey: effectiveComponentKey,
+                componentRole: effectiveComponentRole,
+                renderer,
+                rendererKey: targetRendererKey,
+                resolutionSource: 'semantic-role',
+                semanticRole,
+                targetBindingSource: targetBinding?.source ?? null,
+                view,
+            });
+        }
+    }
+    if (effectiveComponentRole) {
+        const renderer = registry.byComponentRole?.[effectiveComponentRole];
+        if (renderer !== undefined && renderer !== null) {
+            return createResolution({
+                componentKey: effectiveComponentKey,
+                componentRole: effectiveComponentRole,
+                renderer,
+                rendererKey: targetRendererKey,
+                resolutionSource: 'component-role',
+                semanticRole,
+                targetBindingSource: targetBinding?.source ?? null,
+                view,
+            });
+        }
+    }
+    if (view) {
+        const renderer = findPageHostViewKindRenderer(registry, view);
+        if (renderer !== undefined && renderer !== null) {
+            return createResolution({
+                componentKey: effectiveComponentKey,
+                componentRole: effectiveComponentRole,
+                renderer,
+                rendererKey: targetRendererKey,
+                resolutionSource: 'view-kind',
+                semanticRole,
+                targetBindingSource: targetBinding?.source ?? null,
+                view,
+            });
+        }
+    }
+    if (effectiveComponentKey) {
+        const renderer = registry.byComponentKey?.[effectiveComponentKey];
+        if (renderer !== undefined && renderer !== null) {
+            return createResolution({
+                componentKey: effectiveComponentKey,
+                componentRole: effectiveComponentRole,
+                renderer,
+                rendererKey: targetRendererKey,
+                resolutionSource: 'component-key',
+                semanticRole,
+                targetBindingSource: targetBinding?.source ?? null,
+                view,
+            });
+        }
+    }
+    if (pageHostId) {
+        const renderer = registry.byPageHostId?.[pageHostId];
+        if (renderer !== undefined && renderer !== null) {
+            return createResolution({
+                componentKey: effectiveComponentKey,
+                componentRole: effectiveComponentRole,
+                renderer,
+                rendererKey: targetRendererKey,
+                resolutionSource: 'page-host-id',
+                semanticRole,
+                targetBindingSource: targetBinding?.source ?? null,
+                view,
+            });
+        }
+    }
+    if (routeId) {
+        const renderer = registry.byRouteId?.[routeId];
+        if (renderer !== undefined && renderer !== null) {
+            return createResolution({
+                componentKey: effectiveComponentKey,
+                componentRole: effectiveComponentRole,
+                renderer,
+                rendererKey: targetRendererKey,
+                resolutionSource: 'route-id',
+                semanticRole,
+                targetBindingSource: targetBinding?.source ?? null,
+                view,
+            });
+        }
+    }
+    if (workspaceId) {
+        const renderer = registry.byWorkspaceId?.[workspaceId];
+        if (renderer !== undefined && renderer !== null) {
+            return createResolution({
+                componentKey: effectiveComponentKey,
+                componentRole: effectiveComponentRole,
+                renderer,
+                rendererKey: targetRendererKey,
+                resolutionSource: 'workspace-id',
+                semanticRole,
+                targetBindingSource: targetBinding?.source ?? null,
+                view,
+            });
+        }
+    }
+    if (viewId) {
+        const renderer = registry.byViewId?.[viewId];
+        if (renderer !== undefined && renderer !== null) {
+            return createResolution({
+                componentKey: effectiveComponentKey,
+                componentRole: effectiveComponentRole,
+                renderer,
+                rendererKey: targetRendererKey,
+                resolutionSource: 'view-id',
+                semanticRole,
+                targetBindingSource: targetBinding?.source ?? null,
+                view,
+            });
+        }
+    }
+    if (registry.fallback !== undefined && registry.fallback !== null) {
+        return createResolution({
+            componentKey: effectiveComponentKey,
+            componentRole: effectiveComponentRole,
+            renderer: registry.fallback,
+            rendererKey: targetRendererKey,
+            resolutionSource: 'fallback',
+            semanticRole,
+            targetBindingSource: targetBinding?.source ?? null,
+            view,
+        });
+    }
+    return createResolution({
+        componentKey: effectiveComponentKey,
+        componentRole: effectiveComponentRole,
+        renderer: null,
+        rendererKey: targetRendererKey,
+        resolutionSource: null,
+        semanticRole,
+        targetBindingSource: targetBinding?.source ?? null,
+        view,
+    });
+}
+/**
+ * Infers the standard component role for a page host from its workspace and
+ * root view semantics. Target bindings can override this when a host needs a
+ * more specific frontend interpretation.
+ */
+export function resolveDefaultPresentationPageHostComponentRole({ module, pageHost, view, }) {
+    const workspaceRef = pageHost?.Workspace;
+    if (workspaceRef) {
+        const workspace = module.Workspaces?.find((candidate) => candidate.Id === workspaceRef.WorkspaceId);
+        return workspace?.DocumentProfiles && workspace.DocumentProfiles.length > 0
+            ? presentationPageHostComponentRoles.documentWorkspace
+            : presentationPageHostComponentRoles.routedSurface;
+    }
+    if (!view) {
+        return null;
+    }
+    const semanticRole = getPresentationViewSemanticRole(view);
+    if (semanticRole === 'surface-root' || semanticRole === 'surface-section') {
+        return presentationPageHostComponentRoles.routedSurface;
+    }
+    return viewKindComponentRoles[String(view.Kind)] ?? null;
+}
+function findPageHostView(module, pageHost) {
+    const viewId = pageHost?.View?.ViewId;
+    if (!viewId) {
+        return null;
+    }
+    return module.Views?.find((view) => view.Id === viewId) ?? null;
+}
+function findPageHostViewKindRenderer(registry, view) {
+    const keys = new Set([String(view.Kind)]);
+    const label = viewKindLabels[view.Kind];
+    if (label) {
+        keys.add(label);
+        keys.add(label.charAt(0).toLowerCase() + label.slice(1));
+    }
+    for (const key of keys) {
+        const renderer = registry.byViewKind?.[key];
+        if (renderer !== undefined && renderer !== null) {
+            return renderer;
+        }
+    }
+    return undefined;
+}
+function resolvePageHostTargetRendererBinding({ componentSet, module, pageHost, route, targetKind, view, }) {
+    if (!module.Targets) {
+        return null;
+    }
+    const targetBindingModule = { Targets: module.Targets };
+    const candidates = [
+        pageHost ? { id: pageHost.Id, source: 'target-page-host-binding' } : null,
+        route ? { id: route.Id, source: 'target-route-binding' } : null,
+        pageHost?.Workspace?.WorkspaceId
+            ? {
+                id: pageHost.Workspace.WorkspaceId,
+                source: 'target-workspace-binding',
+            }
+            : null,
+        view ? { id: view.Id, source: 'target-view-binding' } : null,
+    ].filter((candidate) => candidate !== null);
+    for (const candidate of candidates) {
+        const resolvedBinding = resolvePresentationComponentBinding(targetBindingModule, {
+            bindingKind: createPresentationEnumDiscriminator(presentationBindingKinds, 'pageHostComponent', 'PageHostComponent'),
+            componentSet,
+            id: candidate.id,
+            routeId: route?.Id,
+            targetKind,
+        });
+        const binding = resolvedBinding.binding;
+        if (!binding) {
+            continue;
+        }
+        const rendererKey = readPageHostRendererKey(binding);
+        if (resolvedBinding.componentRole || resolvedBinding.componentKey || rendererKey) {
+            return {
+                componentKey: resolvedBinding.componentKey,
+                componentRole: resolvedBinding.componentRole,
+                rendererKey,
+                source: candidate.source,
+            };
+        }
+    }
+    return null;
+}
+function createResolution(resolution) {
+    return resolution;
+}
+const viewKindComponentRoles = createViewKindComponentRoles();
+function createViewKindComponentRoles() {
+    const keys = {};
+    addViewKindComponentRole(keys, viewKinds.collection, 'Collection', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.dashboard, 'Dashboard', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.documentWorkspace, 'DocumentWorkspace', presentationPageHostComponentRoles.documentWorkspace);
+    addViewKindComponentRole(keys, viewKinds.form, 'Form', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.graph, 'Graph', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.page, 'Page', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.prompt, 'Prompt', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.recordDetail, 'RecordDetail', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.search, 'Search', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.surface, 'Surface', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.tabbedSurface, 'TabbedSurface', presentationPageHostComponentRoles.routedSurface);
+    addViewKindComponentRole(keys, viewKinds.timeline, 'Timeline', presentationPageHostComponentRoles.routedSurface);
+    return keys;
+}
+function addViewKindComponentRole(keys, numericValue, label, componentRole) {
+    keys[String(numericValue)] = componentRole;
+    keys[label] = componentRole;
+    keys[label.charAt(0).toLowerCase() + label.slice(1)] = componentRole;
+}
+function readPageHostRendererKey(binding) {
+    const options = binding.Options;
+    if (!isRecord(options)) {
+        return null;
+    }
+    const rendererKey = options.rendererKey ?? options.RendererKey;
+    return typeof rendererKey === 'string' && rendererKey.length > 0
+        ? rendererKey
+        : null;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# 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.ts"],"names":[],"mappings":"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"}

package/dist/presentation-action-endpoint-request-projection.d.ts

@@ -0,0 +1,23 @@
+import type { ActionDefinition } from './module.js';
+import type { EndpointExecutionRequest } from './endpoint-executor.js';
+export type PresentationActionEndpointExecutionRequest<TBody = unknown, TQuery = unknown> = EndpointExecutionRequest<TBody, TQuery>;
+export interface PresentationActionEndpointRequestProjectionOptions {
+    readonly action: ActionDefinition | null;
+    readonly dataSourceId?: string | null;
+    readonly endpointId: string;
+    readonly sources: Readonly<Record<string, unknown>>;
+}
+export interface RequiredPresentationActionEndpointRequestProjectionOptions extends PresentationActionEndpointRequestProjectionOptions {
+    readonly actionId: string;
+}
+/**
+ * Lowers a Presentation IR action endpoint request projection into the concrete
+ * endpoint request envelope used by the app transport.
+ */
+export declare function projectPresentationActionEndpointRequest({ action, dataSourceId, endpointId, sources, }: PresentationActionEndpointRequestProjectionOptions): PresentationActionEndpointExecutionRequest | null;
+/**
+ * Projects a required action endpoint request, failing early when the action
+ * lacks an endpoint request projection for the selected endpoint/data source.
+ */
+export declare function projectRequiredPresentationActionEndpointRequest({ action, actionId, dataSourceId, endpointId, sources, }: RequiredPresentationActionEndpointRequestProjectionOptions): PresentationActionEndpointExecutionRequest;
+//# sourceMappingURL=presentation-action-endpoint-request-projection.d.ts.map

package/dist/presentation-action-endpoint-request-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-endpoint-request-projection.d.ts","sourceRoot":"","sources":["../src/presentation-action-endpoint-request-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,UAAU,CAAA;AAMjB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAEnE,MAAM,MAAM,0CAA0C,CACpD,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,OAAO,IACd,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AAE3C,MAAM,WAAW,kDAAkD;IACjE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,0DACf,SAAQ,kDAAkD;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,wCAAwC,CAAC,EACvD,MAAM,EACN,YAAY,EACZ,UAAU,EACV,OAAO,GACR,EAAE,kDAAkD,GAAG,0CAA0C,GAAG,IAAI,CAcxG;AAED;;;GAGG;AACH,wBAAgB,gDAAgD,CAAC,EAC/D,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,OAAO,GACR,EAAE,0DAA0D,GAAG,0CAA0C,CAczG"}

package/dist/presentation-action-endpoint-request-projection.js

@@ -0,0 +1,117 @@
+import { presentationValueKinds } from '@cohesivesystems/presentation-contracts';
+import { readObjectPath, writeObjectPath, } from './object-path.js';
+/**
+ * Lowers a Presentation IR action endpoint request projection into the concrete
+ * endpoint request envelope used by the app transport.
+ */
+export function projectPresentationActionEndpointRequest({ action, dataSourceId, endpointId, sources, }) {
+    const projection = selectActionEndpointRequestProjection({
+        action,
+        dataSourceId,
+        endpointId,
+    });
+    if (!projection) {
+        return null;
+    }
+    return {
+        body: projectRequestBody(projection.BodyFields, sources),
+        routeParameters: projectRouteParameters(projection.RouteParameters, sources),
+    };
+}
+/**
+ * Projects a required action endpoint request, failing early when the action
+ * lacks an endpoint request projection for the selected endpoint/data source.
+ */
+export function projectRequiredPresentationActionEndpointRequest({ action, actionId, dataSourceId, endpointId, sources, }) {
+    const request = projectPresentationActionEndpointRequest({
+        action,
+        dataSourceId,
+        endpointId,
+        sources,
+    });
+    if (!request) {
+        throw new Error(`No endpoint request projection is registered for action '${actionId}' and endpoint '${endpointId}'.`);
+    }
+    return request;
+}
+function selectActionEndpointRequestProjection({ action, dataSourceId, endpointId, }) {
+    const endpointRequests = action?.EndpointRequests ?? [];
+    const endpointMatches = endpointRequests.filter((candidate) => candidate.EndpointId === endpointId);
+    if (!dataSourceId && endpointMatches.length === 1) {
+        return endpointMatches[0];
+    }
+    return endpointRequests.find((candidate) => candidate.EndpointId === endpointId && candidate.DataSourceId === dataSourceId) ??
+        endpointRequests.find((candidate) => candidate.EndpointId === endpointId && !candidate.DataSourceId) ??
+        endpointRequests.find((candidate) => !candidate.EndpointId && candidate.DataSourceId === dataSourceId) ??
+        endpointRequests.find((candidate) => !candidate.EndpointId && !candidate.DataSourceId) ??
+        null;
+}
+function projectRouteParameters(bindings, sources) {
+    return Object.fromEntries(bindings.flatMap((binding) => {
+        const value = resolvePresentationActionRequestValue(binding.Source, sources) ??
+            resolveFallbackRouteParameterValue(binding.TargetPath, sources);
+        if ((value === null || value === undefined) && binding.OmitWhenNull) {
+            return [];
+        }
+        return [[binding.TargetPath, value == null ? value : String(value)]];
+    }));
+}
+function resolveFallbackRouteParameterValue(targetPath, sources) {
+    if (targetPath !== 'id') {
+        return undefined;
+    }
+    return readObjectPath(sources, 'route.id') ?? readObjectPath(sources, 'resource.Id');
+}
+function projectRequestBody(bindings, sources) {
+    if (bindings.length === 0) {
+        return undefined;
+    }
+    const body = {};
+    for (const binding of bindings) {
+        const resolvedValue = resolvePresentationActionRequestValue(binding.Source, sources);
+        const value = resolvedValue === undefined
+            ? resolveFallbackRequestBodyValue(binding.TargetPath, sources)
+            : resolvedValue;
+        if ((value === null || value === undefined) && binding.OmitWhenNull) {
+            continue;
+        }
+        if (value === undefined && isDocumentRequestBodyTarget(binding.TargetPath)) {
+            throw new Error(`Unable to project request body field '${binding.TargetPath}' because its source did not resolve.`);
+        }
+        writeObjectPath(body, binding.TargetPath, value);
+    }
+    return body;
+}
+function resolveFallbackRequestBodyValue(targetPath, sources) {
+    if (!isDocumentRequestBodyTarget(targetPath)) {
+        return undefined;
+    }
+    const documentValue = readObjectPath(sources, 'document.value');
+    if (documentValue !== undefined) {
+        return documentValue;
+    }
+    return readObjectPath(sources, 'document.Document');
+}
+function isDocumentRequestBodyTarget(targetPath) {
+    return targetPath.toLowerCase() === 'document';
+}
+function resolvePresentationActionRequestValue(value, sources) {
+    if (isPresentationValueKind(value.Kind, presentationValueKinds.literal, 'literal')) {
+        return value.Literal;
+    }
+    if (isPresentationValueKind(value.Kind, presentationValueKinds.field, 'field')) {
+        return value.Field ? readObjectPath(sources, value.Field) : undefined;
+    }
+    if (isPresentationValueKind(value.Kind, presentationValueKinds.state, 'state')) {
+        return value.StateId ? sources[value.StateId] : undefined;
+    }
+    if (isPresentationValueKind(value.Kind, presentationValueKinds.expression, 'expression')) {
+        throw new Error('Action endpoint request expression values are not supported yet.');
+    }
+    return undefined;
+}
+function isPresentationValueKind(value, numericKind, stringKind) {
+    return value === numericKind ||
+        (typeof value === 'string' && value.toLowerCase() === stringKind.toLowerCase());
+}
+//# sourceMappingURL=presentation-action-endpoint-request-projection.js.map

package/dist/presentation-action-endpoint-request-projection.js.map

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

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

@@ -0,0 +1,24 @@
+import { type PresentationBindingDefinition, type PresentationModuleDefinition } from './module.js';
+import { type PresentationEnumDiscriminator } from './target-bindings.js';
+interface PresentationTargetBindingProjection {
+    readonly Bindings: readonly PresentationBindingDefinition[];
+    readonly ComponentSet?: string | null;
+    readonly Target: string | number;
+}
+export interface ResolvePresentationActionEndpointBindingOptions {
+    readonly actionId: string;
+    readonly componentSet?: string | null;
+    readonly dataSourceId?: string | null;
+    readonly module: Pick<PresentationModuleDefinition, 'Actions'> & {
+        readonly Targets?: readonly PresentationTargetBindingProjection[];
+    } | null;
+    readonly targetKind?: PresentationEnumDiscriminator | null;
+}
+/**
+ * Resolves the concrete endpoint that realizes a semantic action for the
+ * current projection target. Target bindings can specialize an action by data
+ * source while the action definition remains semantic and reusable.
+ */
+export declare function resolvePresentationActionEndpointBinding({ actionId, componentSet, dataSourceId, module, targetKind, }: ResolvePresentationActionEndpointBindingOptions): PresentationBindingDefinition | null;
+export {};
+//# sourceMappingURL=presentation-action-endpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-endpoint.d.ts","sourceRoot":"","sources":["../src/presentation-action-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAClC,MAAM,UAAU,CAAA;AACjB,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,mBAAmB,CAAA;AAM1B,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,CAAA;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,+CAA+C;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,SAAS,CAAC,GAAG;QAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,mCAAmC,EAAE,CAAA;KAClE,GAAG,IAAI,CAAA;IACR,QAAQ,CAAC,UAAU,CAAC,EAAE,6BAA6B,GAAG,IAAI,CAAA;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CAAC,EACvD,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,UAA2F,GAC5F,EAAE,+CAA+C,GAAG,6BAA6B,GAAG,IAAI,CAexF"}

package/dist/presentation-action-endpoint.js

@@ -0,0 +1,56 @@
+import { findPresentationAction, } from './module.js';
+import { createPresentationEnumDiscriminator, matchesPresentationEnum, } from './target-bindings.js';
+import { presentationBindingKinds, presentationTargetKinds, } from '@cohesivesystems/presentation-contracts';
+/**
+ * Resolves the concrete endpoint that realizes a semantic action for the
+ * current projection target. Target bindings can specialize an action by data
+ * source while the action definition remains semantic and reusable.
+ */
+export function resolvePresentationActionEndpointBinding({ actionId, componentSet, dataSourceId, module, targetKind = createPresentationEnumDiscriminator(presentationTargetKinds, 'react', 'React'), }) {
+    if (!module) {
+        return null;
+    }
+    return (resolveActionEndpointTargetBinding({
+        actionId,
+        componentSet,
+        dataSourceId,
+        module,
+        targetKind,
+    }) ??
+        resolveActionDefinitionEndpointBinding(module, actionId) ??
+        null);
+}
+function resolveActionEndpointTargetBinding({ actionId, componentSet, dataSourceId, module, targetKind, }) {
+    const targets = resolveCandidateTargets(module?.Targets ?? [], {
+        componentSet,
+        targetKind,
+    });
+    const bindings = targets
+        .flatMap((target) => target.Bindings)
+        .filter((binding) => matchesPresentationEnum(binding.Kind, actionEndpointBindingKind) &&
+        binding.Id === actionId);
+    return (bindings.find((binding) => dataSourceId && binding.DataSourceId === dataSourceId) ??
+        bindings.find((binding) => !binding.DataSourceId) ??
+        bindings[0] ??
+        null);
+}
+function resolveActionDefinitionEndpointBinding(module, actionId) {
+    const binding = findPresentationAction(module, actionId)?.Binding ?? null;
+    return binding && isEndpointBinding(binding) ? binding : null;
+}
+function resolveCandidateTargets(targets, { componentSet, targetKind, }) {
+    const filteredTargets = targets.filter((target) => {
+        if (targetKind && !matchesPresentationEnum(target.Target, targetKind)) {
+            return false;
+        }
+        return !componentSet || target.ComponentSet === componentSet;
+    });
+    return filteredTargets.length > 0 ? filteredTargets : targets;
+}
+function isEndpointBinding(binding) {
+    return (matchesPresentationEnum(binding.Kind, actionEndpointBindingKind) ||
+        matchesPresentationEnum(binding.Kind, apiEndpointBindingKind));
+}
+const actionEndpointBindingKind = createPresentationEnumDiscriminator(presentationBindingKinds, 'actionEndpoint', 'ActionEndpoint');
+const apiEndpointBindingKind = createPresentationEnumDiscriminator(presentationBindingKinds, 'apiEndpoint', 'ApiEndpoint');
+//# sourceMappingURL=presentation-action-endpoint.js.map

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

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

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

@@ -0,0 +1,4 @@
+export declare const presentationActionIconIds: {
+    readonly pending: "action.pending";
+};
+//# sourceMappingURL=presentation-action-icons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-icons.d.ts","sourceRoot":"","sources":["../src/presentation-action-icons.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB;;CAE5B,CAAA"}

package/dist/presentation-action-icons.js

@@ -0,0 +1,4 @@
+export const presentationActionIconIds = {
+    pending: 'action.pending',
+};
+//# sourceMappingURL=presentation-action-icons.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-icons.js","sourceRoot":"","sources":["../src/presentation-action-icons.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,gBAAgB;CACjB,CAAA"}

package/dist/presentation-action-result-state.d.ts

@@ -0,0 +1,48 @@
+import { type ActionResultPolicy, type ActionResultStateWriteDefinition } from '@cohesivesystems/presentation-contracts';
+/**
+ * Route-scoped presentation state keyed by semantic data-source id.
+ *
+ * Values in this map are action outputs, or values derived from action outputs,
+ * that should be projected as local data-source values until the route scope is
+ * reset.
+ */
+export type PresentationActionResultStateValues = Readonly<Record<string, unknown>>;
+/**
+ * Inputs for applying explicit action-result state writes.
+ */
+export interface ApplyPresentationActionResultStateWritesOptions {
+    /** Action endpoint response used as the source value for each write. */
+    readonly result: unknown;
+    /** Current route-scoped action-result state. */
+    readonly state: PresentationActionResultStateValues;
+    /** State-write declarations to apply. */
+    readonly writes?: readonly ActionResultStateWriteDefinition[] | null;
+}
+/**
+ * Inputs for applying the state-write policy declared by an action result.
+ */
+export interface ApplyPresentationActionResultPolicyStateWritesOptions {
+    /** Action result policy that declares state writes, when one is present. */
+    readonly policy?: ActionResultPolicy | null;
+    /** Action endpoint response used as the source value for each policy write. */
+    readonly result: unknown;
+    /** Current route-scoped action-result state. */
+    readonly state: PresentationActionResultStateValues;
+}
+/**
+ * Applies the state writes declared by an action result policy.
+ *
+ * The returned state preserves object identity when the policy has no writes,
+ * which lets React callers avoid unnecessary rebinding work.
+ */
+export declare function applyPresentationActionResultPolicyStateWrites({ policy, result, state, }: ApplyPresentationActionResultPolicyStateWritesOptions): Readonly<Record<string, unknown>>;
+/**
+ * Applies backend-declared action response writes to route-local presentation
+ * data-source state.
+ *
+ * Each write targets a semantic data-source id and reads either the full action
+ * response or a dot-separated response path. The function returns a new state
+ * object only when at least one valid write is applied.
+ */
+export declare function applyPresentationActionResultStateWrites({ result, state, writes, }: ApplyPresentationActionResultStateWritesOptions): PresentationActionResultStateValues;
+//# sourceMappingURL=presentation-action-result-state.d.ts.map

package/dist/presentation-action-result-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-result-state.d.ts","sourceRoot":"","sources":["../src/presentation-action-result-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,gCAAgC,EAEtC,MAAM,yCAAyC,CAAA;AAMhD;;;;;;GAMG;AACH,MAAM,MAAM,mCAAmC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEnF;;GAEG;AACH,MAAM,WAAW,+CAA+C;IAC9D,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAExB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,mCAAmC,CAAA;IAEnD,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,gCAAgC,EAAE,GAAG,IAAI,CAAA;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,qDAAqD;IACpE,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAE3C,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAExB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,mCAAmC,CAAA;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,8CAA8C,CAAC,EAC7D,MAAM,EACN,MAAM,EACN,KAAK,GACN,EAAE,qDAAqD,qCAMvD;AAED;;;;;;;GAOG;AACH,wBAAgB,wCAAwC,CAAC,EACvD,MAAM,EACN,KAAK,EACL,MAAM,GACP,EAAE,+CAA+C,GAAG,mCAAmC,CAgBvF"}