@cohesivesystems/presentation-core 0.1.0-alpha.1

package/dist/presentation-action-result-state.js

@@ -0,0 +1,109 @@
+import { actionResultStateWriteModes, } from '@cohesivesystems/presentation-contracts';
+import { readObjectPath, } from './object-path.js';
+/**
+ * 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 function applyPresentationActionResultPolicyStateWrites({ policy, result, state, }) {
+    return applyPresentationActionResultStateWrites({
+        result,
+        state,
+        writes: policy?.StateWrites,
+    });
+}
+/**
+ * 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 function applyPresentationActionResultStateWrites({ result, state, writes, }) {
+    if (!writes?.length) {
+        return state;
+    }
+    let next = null;
+    for (const write of writes) {
+        if (!write.TargetDataSourceId) {
+            continue;
+        }
+        next ??= { ...state };
+        applyPresentationActionResultStateWrite(next, write, result);
+    }
+    return next ?? state;
+}
+/**
+ * Applies a single write declaration to a mutable state accumulator.
+ */
+function applyPresentationActionResultStateWrite(state, write, result) {
+    const mode = normalizeActionResultStateWriteMode(write.Mode);
+    if (mode === 'clear') {
+        delete state[write.TargetDataSourceId];
+        return;
+    }
+    const value = write.SourcePath ? readObjectPath(result, write.SourcePath) : result;
+    switch (mode) {
+        case 'append':
+            state[write.TargetDataSourceId] = appendPresentationStateValue(state[write.TargetDataSourceId], value);
+            return;
+        case 'merge':
+            state[write.TargetDataSourceId] = mergePresentationStateValue(state[write.TargetDataSourceId], value);
+            return;
+        case 'replace':
+        default:
+            state[write.TargetDataSourceId] = value;
+            return;
+    }
+}
+/**
+ * Appends one scalar or array-valued write source to the current target value.
+ */
+function appendPresentationStateValue(current, value) {
+    const currentItems = Array.isArray(current) ? current : current === undefined ? [] : [current];
+    const nextItems = Array.isArray(value) ? value : [value];
+    return [...currentItems, ...nextItems];
+}
+/**
+ * Merges object writes shallowly and falls back to replacement for non-objects.
+ */
+function mergePresentationStateValue(current, value) {
+    if (isRecord(current) && isRecord(value)) {
+        return {
+            ...current,
+            ...value,
+        };
+    }
+    return value;
+}
+/**
+ * Narrows values that can participate in shallow merge writes.
+ */
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Normalizes generated numeric enum values and JSON string enum values into the
+ * runtime write-mode labels used by the state applicator.
+ */
+function normalizeActionResultStateWriteMode(mode) {
+    if (mode === actionResultStateWriteModes.merge || matchesModeLabel(mode, 'merge')) {
+        return 'merge';
+    }
+    if (mode === actionResultStateWriteModes.append || matchesModeLabel(mode, 'append')) {
+        return 'append';
+    }
+    if (mode === actionResultStateWriteModes.clear || matchesModeLabel(mode, 'clear')) {
+        return 'clear';
+    }
+    return 'replace';
+}
+/**
+ * Compares a generated JSON enum label case-insensitively.
+ */
+function matchesModeLabel(value, label) {
+    return typeof value === 'string' && value.toLocaleLowerCase() === label;
+}
+//# sourceMappingURL=presentation-action-result-state.js.map

package/dist/presentation-action-result-state.js.map

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

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

@@ -0,0 +1,48 @@
+import type { ActionDefinition, PresentationModuleDefinition } from './module.js';
+import { type ActionKind, type ActionScopeKind, type ActionSemanticsKind, type DocumentWorkspaceActionKind, type LocalDocumentEditorActionKind, type PreparationKind, type PresentationBindingKind } from '@cohesivesystems/presentation-contracts';
+export interface PresentationActionRuntime<TExecuteContext = unknown, TLabel = string> {
+    readonly canExecute?: (context: TExecuteContext) => boolean;
+    readonly disabledReason?: TLabel;
+    readonly execute?: (context: TExecuteContext) => Promise<void> | void;
+    readonly isDisabled?: boolean;
+    readonly isHidden?: boolean;
+    readonly isPending?: boolean;
+    readonly label?: TLabel;
+    readonly pendingLabel?: TLabel;
+}
+export interface PresentationActionRuntimeBindingContext {
+    readonly action: ActionDefinition;
+    readonly actionId: string;
+    readonly module: PresentationModuleDefinition;
+}
+export interface PresentationActionRuntimeBinding<TExecuteContext = unknown, TLabel = string> {
+    readonly id: string;
+    readonly matches: (context: PresentationActionRuntimeBindingContext) => boolean;
+    readonly project: (context: PresentationActionRuntimeBindingContext) => PresentationActionRuntime<TExecuteContext, TLabel> | null | undefined;
+}
+export interface PresentationActionRuntimeBindingSpec<TExecuteContext = unknown, TLabel = string> {
+    /** Optional exact action id match for narrowly scoped or legacy bindings. */
+    readonly actionId?: string | readonly string[];
+    /** Optional infrastructure binding match, such as endpoint, flow event, or local state. */
+    readonly bindingKind?: PresentationBindingKind | readonly PresentationBindingKind[];
+    /** Optional sub-kind match for DocumentWorkspace action semantics. */
+    readonly documentWorkspaceKind?: DocumentWorkspaceActionKind | readonly DocumentWorkspaceActionKind[];
+    readonly id: string;
+    /** Optional semantic action kind match. Prefer semantics-specific fields when possible. */
+    readonly kind?: ActionKind | readonly ActionKind[];
+    /** Optional sub-kind match for LocalDocumentEditor action semantics. */
+    readonly localDocumentEditorKind?: LocalDocumentEditorActionKind | readonly LocalDocumentEditorActionKind[];
+    readonly predicate?: (context: PresentationActionRuntimeBindingContext) => boolean;
+    readonly preparationKind?: PreparationKind | readonly PreparationKind[];
+    /** Optional first-class action semantics match. */
+    readonly semanticsKind?: ActionSemanticsKind | readonly ActionSemanticsKind[];
+    readonly project: (context: PresentationActionRuntimeBindingContext) => PresentationActionRuntime<TExecuteContext, TLabel> | null | undefined;
+    readonly scope?: ActionScopeKind | readonly ActionScopeKind[];
+}
+/**
+ * Creates an adapter-neutral runtime binding for a semantic presentation
+ * action. The binding decides whether an ActionDefinition matches, then
+ * projects frontend-local runtime state for that action.
+ */
+export declare function createPresentationActionRuntimeBinding<TExecuteContext = unknown, TLabel = string>({ actionId, bindingKind, documentWorkspaceKind, id, kind, localDocumentEditorKind, predicate, preparationKind, project, semanticsKind, scope, }: PresentationActionRuntimeBindingSpec<TExecuteContext, TLabel>): PresentationActionRuntimeBinding<TExecuteContext, TLabel>;
+//# sourceMappingURL=presentation-action-runtime-binding.d.ts.map

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

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

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

@@ -0,0 +1,52 @@
+import { actionKindLabels, actionSemanticsKindLabels, actionScopeKindLabels, documentWorkspaceActionKindLabels, localDocumentEditorActionKindLabels, preparationKindLabels, presentationBindingKindLabels, } from '@cohesivesystems/presentation-contracts';
+/**
+ * Creates an adapter-neutral runtime binding for a semantic presentation
+ * action. The binding decides whether an ActionDefinition matches, then
+ * projects frontend-local runtime state for that action.
+ */
+export function createPresentationActionRuntimeBinding({ actionId, bindingKind, documentWorkspaceKind, id, kind, localDocumentEditorKind, predicate, preparationKind, project, semanticsKind, scope, }) {
+    return {
+        id,
+        matches: (context) => matchesStringOption(context.action.Id, actionId) &&
+            matchesEnumOption(context.action.Kind, kind, actionKindLabels) &&
+            matchesEnumOption(context.action.Scope, scope, actionScopeKindLabels) &&
+            matchesEnumOption(context.action.Binding.Kind, bindingKind, presentationBindingKindLabels) &&
+            matchesEnumOption(context.action.Preparation?.Kind, preparationKind, preparationKindLabels) &&
+            matchesEnumOption(context.action.Semantics?.Kind, semanticsKind, actionSemanticsKindLabels) &&
+            matchesEnumOption(context.action.Semantics?.DocumentWorkspace?.Kind, documentWorkspaceKind, documentWorkspaceActionKindLabels) &&
+            matchesEnumOption(context.action.Semantics?.LocalDocumentEditor?.Kind, localDocumentEditorKind, localDocumentEditorActionKindLabels) &&
+            (predicate?.(context) ?? true),
+        project,
+    };
+}
+function matchesStringOption(value, expected) {
+    if (!expected) {
+        return true;
+    }
+    return toArray(expected).includes(value ?? '');
+}
+function matchesEnumOption(value, expected, labels) {
+    if (expected === null || expected === undefined) {
+        return true;
+    }
+    return toArray(expected).some((candidate) => matchesGeneratedEnumValue(value, candidate, labels));
+}
+function matchesGeneratedEnumValue(value, expected, labels) {
+    if (value === expected) {
+        return true;
+    }
+    const expectedLabel = typeof expected === 'number'
+        ? labels[expected] ?? String(expected)
+        : String(expected);
+    const actualLabel = typeof value === 'number'
+        ? labels[value] ?? String(value)
+        : String(value ?? '');
+    return normalizeEnumLabel(actualLabel) === normalizeEnumLabel(expectedLabel);
+}
+function normalizeEnumLabel(value) {
+    return value.replace(/[^a-zA-Z0-9]+/g, '').toLocaleLowerCase();
+}
+function toArray(value) {
+    return Array.isArray(value) ? value : [value];
+}
+//# sourceMappingURL=presentation-action-runtime-binding.js.map

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

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

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

@@ -0,0 +1,18 @@
+import type { ActionPlacementDefinition, PresentationModuleDefinition } from './module.js';
+import type { PresentationActionRuntimeRegistry } from './presentation-action-runtime-projection.js';
+import type { PresentationProjectionDiagnostic } from './presentation-projection-diagnostics.js';
+export interface ProjectPresentationActionRuntimeBindingDiagnosticsOptions<TExecuteContext, TLabel> {
+    readonly actionPlacements: readonly ActionPlacementDefinition[];
+    readonly module: Pick<PresentationModuleDefinition, 'Actions'> | null;
+    readonly runtimes: PresentationActionRuntimeRegistry<TExecuteContext, TLabel>;
+    readonly source: string;
+}
+/**
+ * Reports placed actions that reached the frontend but did not receive an
+ * executable runtime interpretation.
+ *
+ * This keeps IR expansion honest: adding a backend action should either bind a
+ * frontend runtime or show up as a projection TODO.
+ */
+export declare function projectPresentationActionRuntimeBindingDiagnostics<TExecuteContext, TLabel>({ actionPlacements, module, runtimes, source, }: ProjectPresentationActionRuntimeBindingDiagnosticsOptions<TExecuteContext, TLabel>): readonly PresentationProjectionDiagnostic[];
+//# sourceMappingURL=presentation-action-runtime-diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-runtime-diagnostics.d.ts","sourceRoot":"","sources":["../src/presentation-action-runtime-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,UAAU,CAAA;AAIjB,OAAO,KAAK,EACV,iCAAiC,EAClC,MAAM,0CAA0C,CAAA;AACjD,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,uCAAuC,CAAA;AAE9C,MAAM,WAAW,yDAAyD,CACxE,eAAe,EACf,MAAM;IAEN,QAAQ,CAAC,gBAAgB,EAAE,SAAS,yBAAyB,EAAE,CAAA;IAC/D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,SAAS,CAAC,GAAG,IAAI,CAAA;IACrE,QAAQ,CAAC,QAAQ,EAAE,iCAAiC,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,kDAAkD,CAChE,eAAe,EACf,MAAM,EACN,EACA,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,MAAM,GACP,EAAE,yDAAyD,CAC1D,eAAe,EACf,MAAM,CACP,GAAG,SAAS,gCAAgC,EAAE,CA0C9C"}

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

@@ -0,0 +1,69 @@
+import { findPresentationAction, } from './module.js';
+/**
+ * Reports placed actions that reached the frontend but did not receive an
+ * executable runtime interpretation.
+ *
+ * This keeps IR expansion honest: adding a backend action should either bind a
+ * frontend runtime or show up as a projection TODO.
+ */
+export function projectPresentationActionRuntimeBindingDiagnostics({ actionPlacements, module, runtimes, source, }) {
+    return actionPlacements.flatMap((placement) => {
+        const action = findPresentationAction(module, placement.ActionId);
+        if (!action) {
+            return [
+                {
+                    details: {
+                        actionId: placement.ActionId,
+                        placementIntent: placement.Intent,
+                        placementRegion: placement.Region,
+                    },
+                    id: `action-runtime.${placement.ActionId}.missing-action`,
+                    message: `Placed action '${placement.ActionId}' is referenced by the presentation IR ` +
+                        'but is not present in the action catalog.',
+                    severity: 'error',
+                    source,
+                    subject: {
+                        id: placement.ActionId,
+                        kind: 'action',
+                    },
+                },
+            ];
+        }
+        const runtime = runtimes[action.Id];
+        if (runtime?.execute) {
+            return [];
+        }
+        return [
+            createActionRuntimeDiagnostic({
+                action,
+                message: `Action '${action.Name}' is placed in '${placement.Region}' but has no ` +
+                    'frontend runtime binding.',
+                placement,
+                reason: 'missing-execute-binding',
+                source,
+            }),
+        ];
+    });
+}
+function createActionRuntimeDiagnostic({ action, message, placement, reason, source, }) {
+    return {
+        details: {
+            actionId: action.Id,
+            bindingKind: action.Binding.Kind,
+            kind: action.Kind,
+            placementIntent: placement.Intent,
+            placementRegion: placement.Region,
+            scope: action.Scope,
+        },
+        id: `action-runtime.${action.Id}.${reason}`,
+        message,
+        severity: 'warning',
+        source,
+        subject: {
+            id: action.Id,
+            kind: 'action',
+            name: action.Name,
+        },
+    };
+}
+//# sourceMappingURL=presentation-action-runtime-diagnostics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-runtime-diagnostics.js","sourceRoot":"","sources":["../src/presentation-action-runtime-diagnostics.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,sBAAsB,GACvB,MAAM,UAAU,CAAA;AAkBjB;;;;;;GAMG;AACH,MAAM,UAAU,kDAAkD,CAGhE,EACA,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,MAAM,GAIP;IACC,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,sBAAsB,CAAmB,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAA;QACnF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL;oBACE,OAAO,EAAE;wBACP,QAAQ,EAAE,SAAS,CAAC,QAAQ;wBAC5B,eAAe,EAAE,SAAS,CAAC,MAAM;wBACjC,eAAe,EAAE,SAAS,CAAC,MAAM;qBAClC;oBACD,EAAE,EAAE,kBAAkB,SAAS,CAAC,QAAQ,iBAAiB;oBACzD,OAAO,EACL,kBAAkB,SAAS,CAAC,QAAQ,yCAAyC;wBAC7E,2CAA2C;oBAC7C,QAAQ,EAAE,OAAO;oBACjB,MAAM;oBACN,OAAO,EAAE;wBACP,EAAE,EAAE,SAAS,CAAC,QAAQ;wBACtB,IAAI,EAAE,QAAQ;qBACf;iBACyC;aAC7C,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACnC,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,OAAO,EAAE,CAAA;QACX,CAAC;QAED,OAAO;YACL,6BAA6B,CAAC;gBAC5B,MAAM;gBACN,OAAO,EACL,WAAW,MAAM,CAAC,IAAI,mBAAmB,SAAS,CAAC,MAAM,eAAe;oBACxE,2BAA2B;gBAC7B,SAAS;gBACT,MAAM,EAAE,yBAAyB;gBACjC,MAAM;aACP,CAAC;SACH,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,6BAA6B,CAAC,EACrC,MAAM,EACN,OAAO,EACP,SAAS,EACT,MAAM,EACN,MAAM,GAOP;IACC,OAAO;QACL,OAAO,EAAE;YACP,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;YAChC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,eAAe,EAAE,SAAS,CAAC,MAAM;YACjC,eAAe,EAAE,SAAS,CAAC,MAAM;YACjC,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB;QACD,EAAE,EAAE,kBAAkB,MAAM,CAAC,EAAE,IAAI,MAAM,EAAE;QAC3C,OAAO;QACP,QAAQ,EAAE,SAAS;QACnB,MAAM;QACN,OAAO,EAAE;YACP,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { ActionDefinition } from './module.js';
+export interface ResolveActionPendingLabelOptions<TLabel> {
+    readonly action: Pick<ActionDefinition, 'RuntimePresentation'> | null | undefined;
+    readonly data?: unknown;
+    readonly fallback?: TLabel;
+}
+/**
+ * Resolves a pending action label from presentation IR runtime metadata.
+ *
+ * Label variants are checked before the default pending label, which lets a
+ * process-preview action describe response-dependent labels such as overwrite
+ * vs create without product-specific frontend branches.
+ */
+export declare function resolveActionPendingLabel<TLabel = string>({ action, data, fallback, }: ResolveActionPendingLabelOptions<TLabel>): TLabel | undefined;
+//# sourceMappingURL=presentation-action-runtime-labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-runtime-labels.d.ts","sourceRoot":"","sources":["../src/presentation-action-runtime-labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAM,UAAU,CAAA;AAMjB,MAAM,WAAW,gCAAgC,CAAC,MAAM;IACtD,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,GAAG,MAAM,EAAE,EACzD,MAAM,EACN,IAAI,EACJ,QAAQ,GACT,EAAE,gCAAgC,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAc/D"}

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

@@ -0,0 +1,28 @@
+import { formatPresentationValue, resolvePresentationValue, } from './presentation-value-resolution.js';
+/**
+ * Resolves a pending action label from presentation IR runtime metadata.
+ *
+ * Label variants are checked before the default pending label, which lets a
+ * process-preview action describe response-dependent labels such as overwrite
+ * vs create without product-specific frontend branches.
+ */
+export function resolveActionPendingLabel({ action, data, fallback, }) {
+    const runtimePresentation = action?.RuntimePresentation;
+    const variant = runtimePresentation?.PendingLabelVariants.find((candidate) => actionRuntimeLabelVariantMatches({
+        data,
+        expectedValue: candidate.ExpectedValue,
+        value: resolvePresentationValue(candidate.Condition, data),
+    }));
+    const label = variant?.Label ?? runtimePresentation?.PendingLabel;
+    return label === null || label === undefined || label === ''
+        ? fallback
+        : label;
+}
+function actionRuntimeLabelVariantMatches({ data, expectedValue, value, }) {
+    if (data === null || data === undefined) {
+        return false;
+    }
+    const formatted = formatPresentationValue(value);
+    return formatted?.toLocaleLowerCase() === expectedValue.toLocaleLowerCase();
+}
+//# sourceMappingURL=presentation-action-runtime-labels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-runtime-labels.js","sourceRoot":"","sources":["../src/presentation-action-runtime-labels.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,iCAAiC,CAAA;AAQxC;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAkB,EACzD,MAAM,EACN,IAAI,EACJ,QAAQ,GACiC;IACzC,MAAM,mBAAmB,GAAG,MAAM,EAAE,mBAAmB,CAAA;IACvD,MAAM,OAAO,GAAG,mBAAmB,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAC3E,gCAAgC,CAAC;QAC/B,IAAI;QACJ,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,KAAK,EAAE,wBAAwB,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC;KAC3D,CAAC,CACH,CAAA;IACD,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,mBAAmB,EAAE,YAAY,CAAA;IAEjE,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAC1D,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,KAAe,CAAA;AACrB,CAAC;AAED,SAAS,gCAAgC,CAAC,EACxC,IAAI,EACJ,aAAa,EACb,KAAK,GAKN;IACC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAChD,OAAO,SAAS,EAAE,iBAAiB,EAAE,KAAK,aAAa,CAAC,iBAAiB,EAAE,CAAA;AAC7E,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { PresentationModuleDefinition } from './module.js';
+import type { PresentationActionRuntime, PresentationActionRuntimeBinding } from './presentation-action-runtime-binding.js';
+export type PresentationActionRuntimeRegistry<TExecuteContext, TLabel> = Readonly<Record<string, PresentationActionRuntime<TExecuteContext, TLabel> | null | undefined>>;
+export interface ProjectPresentationActionRuntimeRegistryOptions<TExecuteContext, TLabel> {
+    readonly actionIds?: readonly string[];
+    readonly module: PresentationModuleDefinition | null;
+    readonly projections: readonly PresentationActionRuntimeBinding<TExecuteContext, TLabel>[];
+}
+/**
+ * Interprets backend-declared actions through ordered frontend runtime
+ * projections.
+ *
+ * The IR owns action identity and semantics; the frontend contributes concrete
+ * local effects by registering projection bindings that match those semantics.
+ */
+export declare function projectPresentationActionRuntimeRegistry<TExecuteContext, TLabel>({ actionIds, module, projections, }: ProjectPresentationActionRuntimeRegistryOptions<TExecuteContext, TLabel>): PresentationActionRuntimeRegistry<TExecuteContext, TLabel>;
+//# sourceMappingURL=presentation-action-runtime-projection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-runtime-projection.d.ts","sourceRoot":"","sources":["../src/presentation-action-runtime-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC7B,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EACV,yBAAyB,EACzB,gCAAgC,EAEjC,MAAM,uCAAuC,CAAA;AAE9C,MAAM,MAAM,iCAAiC,CAAC,eAAe,EAAE,MAAM,IAAI,QAAQ,CAC/E,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CACtF,CAAA;AAED,MAAM,WAAW,+CAA+C,CAC9D,eAAe,EACf,MAAM;IAEN,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAA;IACpD,QAAQ,CAAC,WAAW,EAAE,SAAS,gCAAgC,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAA;CAC3F;AAED;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CAAC,eAAe,EAAE,MAAM,EAAE,EAChF,SAAS,EACT,MAAM,EACN,WAAW,GACZ,EAAE,+CAA+C,CAChD,eAAe,EACf,MAAM,CACP,GAAG,iCAAiC,CAAC,eAAe,EAAE,MAAM,CAAC,CA8B7D"}

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

@@ -0,0 +1,31 @@
+/**
+ * Interprets backend-declared actions through ordered frontend runtime
+ * projections.
+ *
+ * The IR owns action identity and semantics; the frontend contributes concrete
+ * local effects by registering projection bindings that match those semantics.
+ */
+export function projectPresentationActionRuntimeRegistry({ actionIds, module, projections, }) {
+    if (!module) {
+        return {};
+    }
+    const actionsById = new Map(module.Actions.map((action) => [action.Id, action]));
+    const candidateActionIds = actionIds ?? module.Actions.map((action) => action.Id);
+    const registry = {};
+    for (const actionId of new Set(candidateActionIds)) {
+        const action = actionsById.get(actionId);
+        if (!action) {
+            continue;
+        }
+        const context = { action, actionId, module };
+        for (const projection of projections) {
+            if (!projection.matches(context)) {
+                continue;
+            }
+            registry[actionId] = projection.project(context);
+            break;
+        }
+    }
+    return registry;
+}
+//# sourceMappingURL=presentation-action-runtime-projection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-action-runtime-projection.js","sourceRoot":"","sources":["../src/presentation-action-runtime-projection.ts"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH,MAAM,UAAU,wCAAwC,CAA0B,EAChF,SAAS,EACT,MAAM,EACN,WAAW,GAIZ;IACC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAChF,MAAM,kBAAkB,GAAG,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACjF,MAAM,QAAQ,GAGV,EAAE,CAAA;IAEN,KAAK,MAAM,QAAQ,IAAI,IAAI,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAQ;QACV,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAoD,CAAA;QAC9F,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,SAAQ;YACV,CAAC;YAED,QAAQ,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAChD,MAAK;QACP,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/presentation-badge-resolution.d.ts

@@ -0,0 +1,8 @@
+import type { PresentationBadgeDefinition, PresentationModuleDefinition } from './module.js';
+export interface ResolvedPresentationBadge {
+    readonly id?: string;
+    readonly label: string;
+    readonly tone?: string | null;
+}
+export declare function resolvePresentationBadges(badges: readonly PresentationBadgeDefinition[] | null | undefined, data: unknown, module: Pick<PresentationModuleDefinition, 'Fields'> | null): readonly ResolvedPresentationBadge[];
+//# sourceMappingURL=presentation-badge-resolution.d.ts.map

package/dist/presentation-badge-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-badge-resolution.d.ts","sourceRoot":"","sources":["../src/presentation-badge-resolution.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,UAAU,CAAA;AAYjB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,2BAA2B,EAAE,GAAG,IAAI,GAAG,SAAS,EACjE,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC,GAAG,IAAI,GAC1D,SAAS,yBAAyB,EAAE,CAItC"}

package/dist/presentation-badge-resolution.js

@@ -0,0 +1,73 @@
+import { findPresentationField, } from './module.js';
+import { resolvePresentationContent, } from './presentation-content-resolution.js';
+import { formatPresentationValue, isEmptyPresentationValue, readPresentationFieldValue, resolvePresentationTemplate, resolvePresentationValue, } from './presentation-value-resolution.js';
+export function resolvePresentationBadges(badges, data, module) {
+    return badges?.flatMap((badge) => resolvePresentationBadge(badge, data, module)) ?? [];
+}
+function resolvePresentationBadge(badge, data, module) {
+    const field = badge.FieldId
+        ? findPresentationField(module, badge.FieldId)
+        : null;
+    if (badge.FieldId && !field && !badge.Value && !badge.ValueTemplate && !badge.Content) {
+        return [];
+    }
+    const value = badge.Value
+        ? resolvePresentationValue(badge.Value, data)
+        : readPresentationFieldValue(data, field?.Field);
+    const hasValue = Boolean(badge.Value || field?.Field);
+    if (hasValue &&
+        ((badge.OmitWhenEmpty && isEmptyPresentationValue(value)) ||
+            (badge.OmitWhenZero && isZeroPresentationValue(value)))) {
+        return [];
+    }
+    const formattedValue = formatPresentationBadgeFieldValue(value, field) ??
+        formatPresentationValue(value);
+    const label = resolvePresentationBadgeContentLabel(badge, data, field) ??
+        resolvePresentationTemplate(badge.ValueTemplate, data) ??
+        formatFieldBackedBadgeLabel(formattedValue, badge, field) ??
+        badge.Name;
+    if (badge.OmitWhenEmpty && isEmptyPresentationValue(label)) {
+        return [];
+    }
+    return [{
+            id: badge.Id,
+            label,
+            tone: badge.Tone,
+        }];
+}
+function formatFieldBackedBadgeLabel(formattedValue, badge, field) {
+    if (!formattedValue) {
+        return null;
+    }
+    if (badge.Value || badge.ValueTemplate || !badge.FieldId) {
+        return formattedValue;
+    }
+    const label = field?.Label ?? badge.Name;
+    return label ? `${label}: ${formattedValue}` : formattedValue;
+}
+function resolvePresentationBadgeContentLabel(badge, data, field) {
+    const content = badge.Content;
+    if (!content) {
+        return null;
+    }
+    const descriptionValue = resolvePresentationValue(content.Description, data);
+    if (descriptionValue !== undefined && descriptionValue !== null) {
+        return (formatPresentationBadgeFieldValue(descriptionValue, field) ??
+            formatPresentationValue(descriptionValue));
+    }
+    const resolvedContent = resolvePresentationContent(content, data);
+    return resolvedContent.description ?? resolvedContent.title ?? resolvedContent.subtitle;
+}
+function isZeroPresentationValue(value) {
+    return value === 0 || value === '0';
+}
+function formatPresentationBadgeFieldValue(value, field) {
+    const labels = field?.Display?.ValueLabels;
+    if (!labels || value === null || value === undefined) {
+        return null;
+    }
+    const key = String(value);
+    return labels.find((label) => label.Value === key ||
+        label.Value.toLocaleLowerCase() === key.toLocaleLowerCase())?.Label ?? null;
+}
+//# sourceMappingURL=presentation-badge-resolution.js.map

package/dist/presentation-badge-resolution.js.map

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

package/dist/presentation-collection-pagination.d.ts

@@ -0,0 +1,32 @@
+import { type PresentationModuleDefinition, type ViewDefinition } from './module.js';
+import { type PresentationPaginationBinding } from './presentation-pagination.js';
+import { type PresentationProjectionDiagnostic } from './presentation-projection-diagnostics.js';
+export type PresentationCollectionPaginationRequestMap = Readonly<Record<string, object>>;
+/**
+ * Fallback page size used when neither the data source nor a synchronized query
+ * form declares a default page size.
+ */
+export declare const defaultPresentationCollectionPageSize = 10;
+/**
+ * Options for projecting collection pagination bindings from a presentation
+ * module.
+ */
+export interface CreatePresentationCollectionPaginationBindingsOptions {
+    /** Data source ids that may require collection pagination bindings. */
+    readonly dataSourceIds: readonly string[];
+    /** Fallback page size used when no IR-level default is declared. */
+    readonly defaultPageSize?: number;
+    /** Presentation module containing data-source and query-form definitions. */
+    readonly module: PresentationModuleDefinition | null;
+    /** Optional views used to restrict pagination projection to enabled collections. */
+    readonly views?: readonly Pick<ViewDefinition, 'Collection'>[];
+}
+export declare function createPresentationCollectionPaginationBindings({ dataSourceIds, defaultPageSize, module, views, }: CreatePresentationCollectionPaginationBindingsOptions): readonly PresentationPaginationBinding[];
+export declare function projectPresentationCollectionPaginationDiagnostics({ bindings, footerRendererBound, module, sourceId, views, }: {
+    readonly bindings: readonly PresentationPaginationBinding[];
+    readonly footerRendererBound?: boolean;
+    readonly module: PresentationModuleDefinition | null;
+    readonly sourceId: string;
+    readonly views?: readonly Pick<ViewDefinition, 'Collection' | 'Id' | 'Name'>[];
+}): readonly PresentationProjectionDiagnostic[];
+//# sourceMappingURL=presentation-collection-pagination.d.ts.map

package/dist/presentation-collection-pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-collection-pagination.d.ts","sourceRoot":"","sources":["../src/presentation-collection-pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,cAAc,EACpB,MAAM,UAAU,CAAA;AACjB,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,uCAAuC,CAAA;AAc9C,MAAM,MAAM,0CAA0C,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAEzF;;;GAGG;AACH,eAAO,MAAM,qCAAqC,KAAK,CAAA;AAEvD;;;GAGG;AACH,MAAM,WAAW,qDAAqD;IACpE,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IAEzC,oEAAoE;IACpE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IAEjC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAA;IAEpD,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,EAAE,CAAA;CAC/D;AAED,wBAAgB,8CAA8C,CAAC,EAC7D,aAAa,EACb,eAAuD,EACvD,MAAM,EACN,KAAK,GACN,EAAE,qDAAqD,GAAG,SAAS,6BAA6B,EAAE,CAiBlG;AA0BD,wBAAgB,kDAAkD,CAAC,EACjE,QAAQ,EACR,mBAA0B,EAC1B,MAAM,EACN,QAAQ,EACR,KAAK,GACN,EAAE;IACD,QAAQ,CAAC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,CAAA;IAC3D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAA;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,CAAA;CAC/E,GAAG,SAAS,gCAAgC,EAAE,CAsB9C"}