@cohesivesystems/presentation-core 0.1.0-alpha.1

package/dist/projected-document-action-runtime-profile-diagnostics.js

@@ -0,0 +1,168 @@
+import { findPresentationAction, } from './module.js';
+import { findDocumentProcessPreviewActions, } from './projected-document-action-projection.js';
+/**
+ * Reports process-preview actions that are declared on a document profile but
+ * have no matching document action runtime profile.
+ */
+export function projectDocumentActionRuntimeProfileDiagnostics({ actionPlacements, dataSourceId, documentProfile, module, source = 'document-action-runtime-profile-projection', }) {
+    const actionRuntimeProfiles = documentProfile.ActionRuntimeProfiles ?? [];
+    const placedActionIds = new Set(actionPlacements.map((placement) => placement.ActionId));
+    const profiledActionIds = new Set(actionRuntimeProfiles.map((profile) => profile.ActionId));
+    const processPreviewActions = distinctActionsById(findDocumentProcessPreviewActions({
+        actionPlacements,
+        dataSourceId,
+        module,
+    }));
+    const processPreviewActionIds = new Set(processPreviewActions.map((action) => action.Id));
+    const missingProfileDiagnostics = processPreviewActions
+        .filter((action) => !profiledActionIds.has(action.Id))
+        .map((action) => createMissingActionRuntimeProfileDiagnostic({
+        action,
+        documentProfile,
+        source,
+    }));
+    const invalidProfileDiagnostics = actionRuntimeProfiles.flatMap((profile) => {
+        const action = findPresentationAction(module, profile.ActionId);
+        if (!action) {
+            return [
+                createInvalidActionRuntimeProfileDiagnostic({
+                    details: {
+                        actionId: profile.ActionId,
+                        documentProfileId: documentProfile.Id,
+                        runtimeProfileId: profile.Id,
+                    },
+                    documentProfile,
+                    message: `Document action runtime profile '${profile.Name ?? profile.Id}' references ` +
+                        `action '${profile.ActionId}', but that action is not present in the catalog.`,
+                    reason: 'missing-action',
+                    severity: 'error',
+                    source,
+                    subject: {
+                        id: profile.Id,
+                        kind: 'document-action-runtime-profile',
+                        name: profile.Name,
+                    },
+                }),
+            ];
+        }
+        if (!placedActionIds.has(profile.ActionId)) {
+            return [
+                createInvalidActionRuntimeProfileDiagnostic({
+                    details: {
+                        actionId: profile.ActionId,
+                        documentProfileId: documentProfile.Id,
+                        runtimeProfileId: profile.Id,
+                    },
+                    documentProfile,
+                    message: `Document action runtime profile '${profile.Name ?? profile.Id}' references ` +
+                        `action '${action.Name}', but that action is not placed on this document profile.`,
+                    reason: 'unplaced-action',
+                    severity: 'warning',
+                    source,
+                    subject: {
+                        id: profile.ActionId,
+                        kind: 'action',
+                        name: action.Name,
+                    },
+                }),
+            ];
+        }
+        if (!processPreviewActionIds.has(profile.ActionId)) {
+            return [
+                createInvalidActionRuntimeProfileDiagnostic({
+                    details: {
+                        actionId: profile.ActionId,
+                        bindingKind: action.Binding.Kind,
+                        documentProfileId: documentProfile.Id,
+                        flowId: action.Preparation?.FlowId ?? null,
+                        kind: action.Kind,
+                        runtimeProfileId: profile.Id,
+                    },
+                    documentProfile,
+                    message: `Document action runtime profile '${profile.Name ?? profile.Id}' references ` +
+                        `action '${action.Name}', but that action is not a document process-preview action.`,
+                    reason: 'unsupported-action',
+                    severity: 'warning',
+                    source,
+                    subject: {
+                        id: profile.ActionId,
+                        kind: 'action',
+                        name: action.Name,
+                    },
+                }),
+            ];
+        }
+        if (profile.FlowId &&
+            action.Preparation?.FlowId &&
+            profile.FlowId !== action.Preparation.FlowId) {
+            return [
+                createInvalidActionRuntimeProfileDiagnostic({
+                    details: {
+                        actionFlowId: action.Preparation.FlowId,
+                        actionId: profile.ActionId,
+                        documentProfileId: documentProfile.Id,
+                        runtimeProfileFlowId: profile.FlowId,
+                        runtimeProfileId: profile.Id,
+                    },
+                    documentProfile,
+                    message: `Document action runtime profile '${profile.Name ?? profile.Id}' declares flow ` +
+                        `'${profile.FlowId}', but action '${action.Name}' prepares flow ` +
+                        `'${action.Preparation.FlowId}'.`,
+                    reason: 'flow-mismatch',
+                    severity: 'error',
+                    source,
+                    subject: {
+                        id: profile.ActionId,
+                        kind: 'action',
+                        name: action.Name,
+                    },
+                }),
+            ];
+        }
+        return [];
+    });
+    return [
+        ...missingProfileDiagnostics,
+        ...invalidProfileDiagnostics,
+    ];
+}
+function createMissingActionRuntimeProfileDiagnostic({ action, documentProfile, source, }) {
+    return {
+        details: {
+            actionId: action.Id,
+            documentProfileId: documentProfile.Id,
+            flowId: action.Preparation?.FlowId ?? null,
+        },
+        id: `document-action-runtime-profile.${documentProfile.Id}.${action.Id}.missing`,
+        message: `Document profile '${documentProfile.Name ?? documentProfile.Id}' places ` +
+            `process-preview action '${action.Name}', but does not declare an action runtime profile.`,
+        severity: 'warning',
+        source,
+        subject: {
+            id: action.Id,
+            kind: 'action',
+            name: action.Name,
+        },
+    };
+}
+function createInvalidActionRuntimeProfileDiagnostic({ details, documentProfile, message, reason, severity, source, subject, }) {
+    return {
+        details,
+        id: `document-action-runtime-profile.${documentProfile.Id}.${details.runtimeProfileId}.${reason}`,
+        message,
+        severity,
+        source,
+        subject,
+    };
+}
+function distinctActionsById(actions) {
+    const seen = new Set();
+    return actions.filter((action) => {
+        if (seen.has(action.Id)) {
+            return false;
+        }
+        seen.add(action.Id);
+        return true;
+    });
+}
+//# sourceMappingURL=projected-document-action-runtime-profile-diagnostics.js.map

package/dist/projected-document-action-runtime-profile-diagnostics.js.map

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

package/dist/projected-document-action-runtime-profile.d.ts

@@ -0,0 +1,64 @@
+import type { DocumentProfileProjection } from './document-module.js';
+import type { ActionPlacementDefinition } from './module.js';
+export type ProjectedDocumentActionRuntimeProfile = NonNullable<DocumentProfileProjection['ActionRuntimeProfiles']>[number];
+/**
+ * Frontend runtime selection contract derived from a document action runtime
+ * profile declared by the presentation module.
+ *
+ * The spec keeps semantic identifiers and state conventions in core while
+ * allowing application adapters to supply concrete preview/start request and
+ * response types.
+ *
+ * @typeParam TPreviewRequest - Request shape sent to the action preview endpoint.
+ * @typeParam TPreviewResponse - Response shape returned from the action preview endpoint.
+ * @typeParam TStartInput - Input shape used to start the action after preview.
+ * @typeParam TStartResult - Result shape returned when the action is started.
+ * @typeParam TMetadata - Metadata shape associated with the action runtime.
+ */
+export interface ProjectedDocumentActionRuntimeProfileSpec<TPreviewRequest extends object = Record<string, unknown>, TPreviewResponse = unknown, TStartInput = TPreviewRequest, TStartResult = unknown, TMetadata = unknown> {
+    /** Action id that this runtime profile handles. */
+    readonly actionId?: string;
+    /** Prefix used when registering diagnostics for this runtime profile. */
+    readonly diagnosticsKeyPrefix?: string;
+    /** Presentation flow id used for preview/review UI, when one is modeled. */
+    readonly flowId?: string | null;
+    /** Runtime profile id selected from the document profile projection. */
+    readonly profileId?: string;
+    /**
+     * Optional suffix used to partition process input state for this action.
+     */
+    readonly processInputStateKeySuffix?: string | null;
+    /** Source identifier for tracing where this runtime profile was projected. */
+    readonly source?: string;
+    /**
+     * Compile-time-only type anchors for application adapters. These values are
+     * not populated by projection; they preserve strongly typed request,
+     * response, result, and metadata shapes through generic inference.
+     */
+    readonly typeHints?: {
+        /** Metadata shape associated with the runtime profile. */
+        readonly metadata?: TMetadata;
+        /** Preview request shape sent before starting the action. */
+        readonly previewRequest?: TPreviewRequest;
+        /** Preview response shape rendered by the review flow. */
+        readonly previewResponse?: TPreviewResponse;
+        /** Start input shape submitted when the action is accepted. */
+        readonly startInput?: TStartInput;
+        /** Start result shape returned after the action is accepted. */
+        readonly startResult?: TStartResult;
+    };
+}
+export interface SelectDocumentActionRuntimeProfileOptions {
+    readonly actionPlacements?: readonly ActionPlacementDefinition[];
+}
+/**
+ * Selects the document action runtime profile that best matches placed actions
+ * for a document workspace profile.
+ */
+export declare function selectDocumentActionRuntimeProfile(documentProfile: Pick<DocumentProfileProjection, 'ActionRuntimeProfiles' | 'Actions'> | null, options?: SelectDocumentActionRuntimeProfileOptions): ProjectedDocumentActionRuntimeProfile | null;
+/**
+ * Projects a backend-declared document action runtime profile into the frontend
+ * action-runtime spec consumed by document workspace adapters.
+ */
+export declare function projectDocumentActionRuntimeProfileSpec<TPreviewRequest extends object = Record<string, unknown>, TPreviewResponse = unknown, TStartInput = TPreviewRequest, TStartResult = unknown, TMetadata = unknown>(documentProfile: Pick<DocumentProfileProjection, 'ActionRuntimeProfiles' | 'Actions'> | null, options?: SelectDocumentActionRuntimeProfileOptions): ProjectedDocumentActionRuntimeProfileSpec<TPreviewRequest, TPreviewResponse, TStartInput, TStartResult, TMetadata> | null;
+//# sourceMappingURL=projected-document-action-runtime-profile.d.ts.map

package/dist/projected-document-action-runtime-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-action-runtime-profile.d.ts","sourceRoot":"","sources":["../src/projected-document-action-runtime-profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EAC1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,yBAAyB,EAC1B,MAAM,UAAU,CAAA;AAEjB,MAAM,MAAM,qCAAqC,GAC/C,WAAW,CAAC,yBAAyB,CAAC,uBAAuB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yCAAyC,CACxD,eAAe,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,gBAAgB,GAAG,OAAO,EAC1B,WAAW,GAAG,eAAe,EAC7B,YAAY,GAAG,OAAO,EACtB,SAAS,GAAG,OAAO;IAEnB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAE1B,yEAAyE;IACzE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAEtC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE/B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACH,QAAQ,CAAC,0BAA0B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnD,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IAExB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,0DAA0D;QAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;QAE7B,6DAA6D;QAC7D,QAAQ,CAAC,cAAc,CAAC,EAAE,eAAe,CAAA;QAEzC,0DAA0D;QAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,gBAAgB,CAAA;QAE3C,+DAA+D;QAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAA;QAEjC,gEAAgE;QAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAA;KACpC,CAAA;CACF;AAED,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAA;CACjE;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,eAAe,EAAE,IAAI,CAAC,yBAAyB,EAAE,uBAAuB,GAAG,SAAS,CAAC,GAAG,IAAI,EAC5F,OAAO,GAAE,yCAA8C,GACtD,qCAAqC,GAAG,IAAI,CAc9C;AAED;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,eAAe,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,gBAAgB,GAAG,OAAO,EAC1B,WAAW,GAAG,eAAe,EAC7B,YAAY,GAAG,OAAO,EACtB,SAAS,GAAG,OAAO,EAEnB,eAAe,EAAE,IAAI,CAAC,yBAAyB,EAAE,uBAAuB,GAAG,SAAS,CAAC,GAAG,IAAI,EAC5F,OAAO,GAAE,yCAA8C,GACtD,yCAAyC,CAC1C,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,SAAS,CACV,GAAG,IAAI,CAYP"}

package/dist/projected-document-action-runtime-profile.js

@@ -0,0 +1,33 @@
+/**
+ * Selects the document action runtime profile that best matches placed actions
+ * for a document workspace profile.
+ */
+export function selectDocumentActionRuntimeProfile(documentProfile, options = {}) {
+    const profiles = documentProfile?.ActionRuntimeProfiles ?? [];
+    if (profiles.length <= 1) {
+        return profiles[0] ?? null;
+    }
+    const actionPlacements = options.actionPlacements ?? documentProfile?.Actions ?? [];
+    const placedActionIds = new Set(actionPlacements.map((placement) => placement.ActionId));
+    return (profiles.find((profile) => placedActionIds.has(profile.ActionId)) ??
+        profiles[0] ??
+        null);
+}
+/**
+ * Projects a backend-declared document action runtime profile into the frontend
+ * action-runtime spec consumed by document workspace adapters.
+ */
+export function projectDocumentActionRuntimeProfileSpec(documentProfile, options = {}) {
+    const profile = selectDocumentActionRuntimeProfile(documentProfile, options);
+    return profile
+        ? {
+            actionId: profile.ActionId,
+            diagnosticsKeyPrefix: profile.DiagnosticsKeyPrefix,
+            flowId: profile.FlowId,
+            profileId: profile.Id,
+            processInputStateKeySuffix: profile.ProcessInputStateKeySuffix,
+            source: profile.Source,
+        }
+        : null;
+}
+//# sourceMappingURL=projected-document-action-runtime-profile.js.map

package/dist/projected-document-action-runtime-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-action-runtime-profile.js","sourceRoot":"","sources":["../src/projected-document-action-runtime-profile.ts"],"names":[],"mappings":"AA8EA;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAChD,eAA4F,EAC5F,UAAqD,EAAE;IAEvD,MAAM,QAAQ,GAAG,eAAe,EAAE,qBAAqB,IAAI,EAAE,CAAA;IAC7D,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAC5B,CAAC;IAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,eAAe,EAAE,OAAO,IAAI,EAAE,CAAA;IACnF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;IAExF,OAAO,CACL,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjE,QAAQ,CAAC,CAAC,CAAC;QACX,IAAI,CACL,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uCAAuC,CAOrD,eAA4F,EAC5F,UAAqD,EAAE;IAQvD,MAAM,OAAO,GAAG,kCAAkC,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;IAC5E,OAAO,OAAO;QACZ,CAAC,CAAC;YACE,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;YAClD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,0BAA0B,EAAE,OAAO,CAAC,0BAA0B;YAC9D,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB;QACH,CAAC,CAAC,IAAI,CAAA;AACV,CAAC"}

package/dist/projected-document-action-status-notice-diagnostics.d.ts

@@ -0,0 +1,10 @@
+import type { DocumentProfileProjection } from './document-module.js';
+import type { PresentationModuleDefinition } from './module.js';
+import type { PresentationProjectionDiagnostic } from './presentation-projection-diagnostics.js';
+export interface ProjectDocumentActionStatusNoticeDiagnosticsOptions {
+    readonly module: Pick<PresentationModuleDefinition, 'Actions'> | null;
+    readonly profile: Pick<DocumentProfileProjection, 'ActionStatusNotices'> | null;
+    readonly region?: string;
+}
+export declare function projectDocumentActionStatusNoticeDiagnostics({ module, profile, region, }: ProjectDocumentActionStatusNoticeDiagnosticsOptions): readonly PresentationProjectionDiagnostic[];
+//# sourceMappingURL=projected-document-action-status-notice-diagnostics.d.ts.map

package/dist/projected-document-action-status-notice-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-action-status-notice-diagnostics.d.ts","sourceRoot":"","sources":["../src/projected-document-action-status-notice-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAIlE,OAAO,KAAK,EAEV,4BAA4B,EAC7B,MAAM,UAAU,CAAA;AAIjB,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,uCAAuC,CAAA;AAE9C,MAAM,WAAW,mDAAmD;IAClE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,SAAS,CAAC,GAAG,IAAI,CAAA;IACrE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,yBAAyB,EAAE,qBAAqB,CAAC,GAAG,IAAI,CAAA;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,4CAA4C,CAAC,EAC3D,MAAM,EACN,OAAO,EACP,MAAM,GACP,EAAE,mDAAmD,GAAG,SAAS,gCAAgC,EAAE,CAKnG"}

package/dist/projected-document-action-status-notice-diagnostics.js

@@ -0,0 +1,64 @@
+import { findPresentationAction, } from './module.js';
+import { projectPresentationContentDiagnostics, } from './presentation-content-diagnostics.js';
+export function projectDocumentActionStatusNoticeDiagnostics({ module, profile, region, }) {
+    return getRegionActionStatusNotices(profile, region).flatMap((notice) => [
+        ...projectDocumentActionStatusNoticeContentDiagnostics(notice),
+        ...projectDocumentActionStatusNoticeActionDiagnostics(module, notice),
+    ]);
+}
+function projectDocumentActionStatusNoticeContentDiagnostics(notice) {
+    return projectPresentationContentDiagnostics({
+        content: notice.Content,
+        contentFallbackDescription: 'local action status error message fallback semantics',
+        descriptionFallbackDescription: 'local action status error message fallback semantics',
+        details: createDocumentActionStatusNoticeDiagnosticDetails(notice),
+        diagnosticIdPrefix: `action-status-notice.${notice.Id}.content`,
+        requireDescription: true,
+        source: 'document-workspace-notice-projection',
+        subject: createDocumentActionStatusNoticeDiagnosticSubject(notice),
+        surfaceLabel: `Action status notice '${notice.Name}'`,
+    });
+}
+function projectDocumentActionStatusNoticeActionDiagnostics(module, notice) {
+    if (findPresentationAction(module, notice.ActionId)) {
+        return [];
+    }
+    return [
+        createDocumentActionStatusNoticeDiagnostic({
+            message: `Action status notice '${notice.Name}' references action ` +
+                `'${notice.ActionId}', but the presentation module does not define it.`,
+            notice,
+            reason: 'missing-action',
+            severity: 'warning',
+        }),
+    ];
+}
+function getRegionActionStatusNotices(profile, region) {
+    return profile?.ActionStatusNotices?.filter((notice) => !region || notice.Region === region) ?? [];
+}
+function createDocumentActionStatusNoticeDiagnostic({ message, notice, reason, severity, }) {
+    return {
+        details: createDocumentActionStatusNoticeDiagnosticDetails(notice),
+        id: `action-status-notice.${notice.Id}.${reason}`,
+        message,
+        severity,
+        source: 'document-workspace-notice-projection',
+        subject: createDocumentActionStatusNoticeDiagnosticSubject(notice),
+    };
+}
+function createDocumentActionStatusNoticeDiagnosticDetails(notice) {
+    return {
+        actionId: notice.ActionId,
+        kind: notice.Kind,
+        noticeId: notice.Id,
+        region: notice.Region,
+    };
+}
+function createDocumentActionStatusNoticeDiagnosticSubject(notice) {
+    return {
+        id: notice.Id,
+        kind: 'document-action-status-notice',
+        name: notice.Name,
+    };
+}
+//# sourceMappingURL=projected-document-action-status-notice-diagnostics.js.map

package/dist/projected-document-action-status-notice-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-action-status-notice-diagnostics.js","sourceRoot":"","sources":["../src/projected-document-action-status-notice-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,GACvB,MAAM,UAAU,CAAA;AAKjB,OAAO,EACL,qCAAqC,GACtC,MAAM,oCAAoC,CAAA;AAW3C,MAAM,UAAU,4CAA4C,CAAC,EAC3D,MAAM,EACN,OAAO,EACP,MAAM,GAC8C;IACpD,OAAO,4BAA4B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACvE,GAAG,mDAAmD,CAAC,MAAM,CAAC;QAC9D,GAAG,kDAAkD,CAAC,MAAM,EAAE,MAAM,CAAC;KACtE,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,mDAAmD,CAC1D,MAA4C;IAE5C,OAAO,qCAAqC,CAAC;QAC3C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,0BAA0B,EAAE,sDAAsD;QAClF,8BAA8B,EAAE,sDAAsD;QACtF,OAAO,EAAE,iDAAiD,CAAC,MAAM,CAAC;QAClE,kBAAkB,EAAE,wBAAwB,MAAM,CAAC,EAAE,UAAU;QAC/D,kBAAkB,EAAE,IAAI;QACxB,MAAM,EAAE,sCAAsC;QAC9C,OAAO,EAAE,iDAAiD,CAAC,MAAM,CAAC;QAClE,YAAY,EAAE,yBAAyB,MAAM,CAAC,IAAI,GAAG;KACtD,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,kDAAkD,CACzD,MAA4D,EAC5D,MAA4C;IAE5C,IAAI,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO;QACL,0CAA0C,CAAC;YACzC,OAAO,EACL,yBAAyB,MAAM,CAAC,IAAI,sBAAsB;gBAC1D,IAAI,MAAM,CAAC,QAAQ,oDAAoD;YACzE,MAAM;YACN,MAAM,EAAE,gBAAgB;YACxB,QAAQ,EAAE,SAAS;SACpB,CAAC;KACH,CAAA;AACH,CAAC;AAED,SAAS,4BAA4B,CACnC,OAAsE,EACtE,MAAe;IAEf,OAAO,OAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,EAAE,CAAA;AACpG,CAAC;AAED,SAAS,0CAA0C,CAAC,EAClD,OAAO,EACP,MAAM,EACN,MAAM,EACN,QAAQ,GAMT;IACC,OAAO;QACL,OAAO,EAAE,iDAAiD,CAAC,MAAM,CAAC;QAClE,EAAE,EAAE,wBAAwB,MAAM,CAAC,EAAE,IAAI,MAAM,EAAE;QACjD,OAAO;QACP,QAAQ;QACR,MAAM,EAAE,sCAAsC;QAC9C,OAAO,EAAE,iDAAiD,CAAC,MAAM,CAAC;KACnE,CAAA;AACH,CAAC;AAED,SAAS,iDAAiD,CACxD,MAA4C;IAE5C,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAA;AACH,CAAC;AAED,SAAS,iDAAiD,CACxD,MAA4C;IAE5C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,+BAA+B;QACrC,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAA;AACH,CAAC"}

package/dist/projected-document-badge-formatting.d.ts

@@ -0,0 +1,2 @@
+export declare function formatBadgeValue(value: unknown): string | null;
+//# sourceMappingURL=projected-document-badge-formatting.d.ts.map

package/dist/projected-document-badge-formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-badge-formatting.d.ts","sourceRoot":"","sources":["../src/projected-document-badge-formatting.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,iBAM9C"}

package/dist/projected-document-badge-formatting.js

@@ -0,0 +1,7 @@
+export function formatBadgeValue(value) {
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return value.toString();
+    }
+    return null;
+}
+//# sourceMappingURL=projected-document-badge-formatting.js.map

package/dist/projected-document-badge-formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-badge-formatting.js","sourceRoot":"","sources":["../src/projected-document-badge-formatting.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACzF,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAA;IACzB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/projected-document-editor-model.d.ts

@@ -0,0 +1,4 @@
+import type { FieldPresentationDefinition } from './module.js';
+export type DocumentEditorLayout = 'single' | 'split';
+export type ProjectedDocumentFieldDefinitionLike = FieldPresentationDefinition;
+//# sourceMappingURL=projected-document-editor-model.d.ts.map

package/dist/projected-document-editor-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-editor-model.d.ts","sourceRoot":"","sources":["../src/projected-document-editor-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC5B,MAAM,UAAU,CAAA;AAEjB,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,CAAA;AAErD,MAAM,MAAM,oCAAoC,GAAG,2BAA2B,CAAA"}

package/dist/projected-document-editor-model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projected-document-editor-model.js.map

package/dist/projected-document-editor-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-editor-model.js","sourceRoot":"","sources":["../src/projected-document-editor-model.ts"],"names":[],"mappings":""}

package/dist/projected-document-field-navigation.d.ts

@@ -0,0 +1,72 @@
+import type { FieldPresentationDefinition, PresentationModuleDefinition } from './module.js';
+import type { NavigationRouteParameters, PresentationNavigationHrefFactory } from './navigation.js';
+/**
+ * Inputs used to project a document field value into a navigation binding.
+ */
+export interface ProjectDocumentFieldNavigationBindingOptions {
+    /** Optional route-to-href factory supplied by the host navigation runtime. */
+    readonly createHref?: PresentationNavigationHrefFactory;
+    /** Presentation field whose target binding may declare a navigation route. */
+    readonly field: FieldPresentationDefinition;
+    /** Presentation module target bindings used to find the field route binding. */
+    readonly module: Pick<PresentationModuleDefinition, 'Targets'> | null;
+    /** Resource that contains route parameter source fields. */
+    readonly resource: unknown;
+    /** Field value rendered as the navigation label and default route parameter. */
+    readonly value: unknown;
+}
+/**
+ * Concrete navigation binding projected from a document field.
+ */
+export interface ProjectedDocumentFieldNavigationBinding {
+    /** Host-generated href, or `null` when no href factory was supplied. */
+    readonly href: string | null;
+    /** Scalar label rendered for the navigable field value. */
+    readonly label: string;
+    /** Required route parameter names that could not be resolved. */
+    readonly missingParameterNames: readonly string[];
+    /** Route parameter values projected from the field value and resource. */
+    readonly parameters: NavigationRouteParameters;
+    /** Human-facing prefix rendered before the navigation label. */
+    readonly prefix: string;
+    /** Semantic navigation route id selected by the field target binding. */
+    readonly routeId: string;
+}
+/**
+ * Route projection for a document field before href generation is applied.
+ */
+export interface ProjectedDocumentFieldNavigationProjection {
+    /** Scalar label rendered for the navigable field value. */
+    readonly label: string;
+    /** Required route parameter names that could not be resolved. */
+    readonly missingParameterNames: readonly string[];
+    /** Route parameter values projected from the field value and resource. */
+    readonly parameters: NavigationRouteParameters;
+    /** Human-facing prefix rendered before the navigation label. */
+    readonly prefix: string;
+    /** Semantic navigation route id selected by the field target binding. */
+    readonly routeId: string;
+}
+/**
+ * Projects a document field into a complete navigation binding.
+ *
+ * Returns `null` when the field has no navigation route binding or the field
+ * value cannot be rendered as a scalar navigation label.
+ */
+export declare function projectDocumentFieldNavigationBinding({ createHref, field, module, resource, value, }: ProjectDocumentFieldNavigationBindingOptions): ProjectedDocumentFieldNavigationBinding | null;
+/**
+ * Projects a document field into route id, label, prefix, and route parameters.
+ *
+ * The projection uses target binding options to map route parameters from the
+ * current field value or backing resource. If no parameter mapping is declared,
+ * it defaults to an `id` parameter sourced from the field value.
+ */
+export declare function projectDocumentFieldNavigation({ field, module, resource, value, }: Omit<ProjectDocumentFieldNavigationBindingOptions, 'createHref'>): ProjectedDocumentFieldNavigationProjection | null;
+/**
+ * Finds the navigation-route target binding declared for a presentation field.
+ *
+ * Route-bearing bindings are preferred when multiple target bindings share the
+ * same field id; otherwise the first matching binding is returned.
+ */
+export declare function findDocumentFieldNavigationRouteBinding(module: Pick<PresentationModuleDefinition, 'Targets'> | null, field: FieldPresentationDefinition): import("@cohesivesystems/presentation-contracts").PresentationBindingDefinition;
+//# sourceMappingURL=projected-document-field-navigation.d.ts.map

package/dist/projected-document-field-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projected-document-field-navigation.d.ts","sourceRoot":"","sources":["../src/projected-document-field-navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EACV,yBAAyB,EACzB,iCAAiC,EAClC,MAAM,cAAc,CAAA;AAYrB;;GAEG;AACH,MAAM,WAAW,4CAA4C;IAC3D,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,CAAC,EAAE,iCAAiC,CAAA;IAEvD,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAA;IAE3C,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,SAAS,CAAC,GAAG,IAAI,CAAA;IAErE,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAE1B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uCAAuC;IACtD,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,iEAAiE;IACjE,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAA;IAEjD,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAA;IAE9C,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,0CAA0C;IACzD,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,iEAAiE;IACjE,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAA;IAEjD,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAA;IAE9C,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAaD;;;;;GAKG;AACH,wBAAgB,qCAAqC,CAAC,EACpD,UAAU,EACV,KAAK,EACL,MAAM,EACN,QAAQ,EACR,KAAK,GACN,EAAE,4CAA4C,GAAG,uCAAuC,GAAG,IAAI,CAe/F;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,KAAK,EACL,MAAM,EACN,QAAQ,EACR,KAAK,GACN,EAAE,IAAI,CAAC,4CAA4C,EAAE,YAAY,CAAC,GAAG,0CAA0C,GAAG,IAAI,CAyBtH;AAED;;;;;GAKG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,SAAS,CAAC,GAAG,IAAI,EAC5D,KAAK,EAAE,2BAA2B,mFASnC"}

package/dist/projected-document-field-navigation.js

@@ -0,0 +1,143 @@
+import { readObjectPath, } from './object-path.js';
+import { createPresentationEnumDiscriminator, matchesPresentationEnum, } from './target-bindings.js';
+import { presentationBindingKinds, } from '@cohesivesystems/presentation-contracts';
+/**
+ * Projects a document field into a complete navigation binding.
+ *
+ * Returns `null` when the field has no navigation route binding or the field
+ * value cannot be rendered as a scalar navigation label.
+ */
+export function projectDocumentFieldNavigationBinding({ createHref, field, module, resource, value, }) {
+    const projection = projectDocumentFieldNavigation({
+        field,
+        module,
+        resource,
+        value,
+    });
+    if (!projection) {
+        return null;
+    }
+    return {
+        ...projection,
+        href: createHref?.(projection.routeId, projection.parameters) ?? null,
+    };
+}
+/**
+ * Projects a document field into route id, label, prefix, and route parameters.
+ *
+ * The projection uses target binding options to map route parameters from the
+ * current field value or backing resource. If no parameter mapping is declared,
+ * it defaults to an `id` parameter sourced from the field value.
+ */
+export function projectDocumentFieldNavigation({ field, module, resource, value, }) {
+    const binding = findDocumentFieldNavigationRouteBinding(module, field);
+    if (!binding?.RouteId) {
+        return null;
+    }
+    const label = readNavigationScalar(value);
+    if (!label) {
+        return null;
+    }
+    const options = readDocumentFieldNavigationBindingOptions(binding.Options);
+    const parameterProjection = projectNavigationRouteParameters({
+        options,
+        resource,
+        value,
+    });
+    return {
+        label,
+        missingParameterNames: parameterProjection.missingParameterNames,
+        parameters: parameterProjection.parameters,
+        prefix: options.labelPrefix ?? field.Label,
+        routeId: binding.RouteId,
+    };
+}
+/**
+ * Finds the navigation-route target binding declared for a presentation field.
+ *
+ * Route-bearing bindings are preferred when multiple target bindings share the
+ * same field id; otherwise the first matching binding is returned.
+ */
+export function findDocumentFieldNavigationRouteBinding(module, field) {
+    const bindings = module?.Targets
+        .flatMap((target) => target.Bindings)
+        .filter((binding) => matchesPresentationEnum(binding.Kind, navigationRouteBindingKind) &&
+        binding.Id === field.Id) ?? [];
+    return bindings.find((binding) => binding.RouteId) ?? bindings[0] ?? null;
+}
+function projectNavigationRouteParameters({ options, resource, value, }) {
+    const parameterBindings = options.parameters?.length
+        ? options.parameters
+        : [{ name: 'id', source: 'value' }];
+    const parameters = {};
+    const missingParameterNames = [];
+    for (const parameter of parameterBindings) {
+        const parameterValue = projectNavigationRouteParameterValue({
+            parameter,
+            resource,
+            value,
+        });
+        if (parameterValue === null || parameterValue === undefined) {
+            missingParameterNames.push(parameter.name);
+            continue;
+        }
+        parameters[parameter.name] = parameterValue;
+    }
+    return {
+        missingParameterNames,
+        parameters,
+    };
+}
+function projectNavigationRouteParameterValue({ parameter, resource, value, }) {
+    const source = parameter.source ?? 'value';
+    const resolvedValue = source === 'resource' && parameter.fieldPath
+        ? readObjectPath(resource, parameter.fieldPath)
+        : value;
+    return readNavigationScalar(resolvedValue);
+}
+function readDocumentFieldNavigationBindingOptions(value) {
+    if (!value || typeof value !== 'object') {
+        return {};
+    }
+    const source = value;
+    const labelPrefix = readOptionalString(source.labelPrefix ?? source.LabelPrefix);
+    const rawParameters = source.parameters ?? source.Parameters;
+    const parameters = Array.isArray(rawParameters)
+        ? rawParameters
+            .map(readDocumentFieldNavigationParameterBinding)
+            .filter((parameter) => Boolean(parameter))
+        : undefined;
+    return {
+        labelPrefix,
+        parameters,
+    };
+}
+function readDocumentFieldNavigationParameterBinding(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    const source = value;
+    const name = readOptionalString(source.name ?? source.Name);
+    if (!name) {
+        return null;
+    }
+    return {
+        fieldPath: readOptionalString(source.fieldPath ?? source.FieldPath),
+        name,
+        source: readOptionalString(source.source ?? source.Source),
+    };
+}
+function readNavigationScalar(value) {
+    if (typeof value === 'string' && value.length > 0) {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'bigint' || typeof value === 'boolean') {
+        return value.toString();
+    }
+    return null;
+}
+function readOptionalString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+const navigationRouteBindingKind = createPresentationEnumDiscriminator(presentationBindingKinds, 'navigationRoute', 'NavigationRoute');
+//# sourceMappingURL=projected-document-field-navigation.js.map

package/dist/projected-document-field-navigation.js.map

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