@cohesivesystems/presentation-core 0.1.0-alpha.1

package/dist/document-summary-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-summary-model.js","sourceRoot":"","sources":["../src/document-summary-model.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yCAAyC,GAAG,mBAAmB,CAAA"}

package/dist/document-workspace-chrome-projection.d.ts

@@ -0,0 +1,18 @@
+import { type PresentationModuleDefinition, type ViewDefinition } from './module.js';
+/**
+ * Resolves document workspace metadata fields from page/header chrome.
+ *
+ * The document editor surface renders these same badge-strip field ids. Keeping
+ * this helper in the projection layer lets adapters build field renderers and
+ * diagnostics from the same IR locations instead of repeating view ids.
+ */
+export declare function resolveDocumentWorkspaceMetadataFieldIds(module: Pick<PresentationModuleDefinition, 'Views'> | null, pageView: ViewDefinition | null): string[];
+/**
+ * Resolves the page-region id used for document workspace header chrome.
+ *
+ * Profile-level notices target region ids, while page layout regions carry
+ * enum kinds. This helper keeps that cross-reference in the projection layer
+ * instead of repeating product constants in workspace hosts.
+ */
+export declare function resolveDocumentWorkspaceHeaderRegionId(pageView: ViewDefinition | null): string | null;
+//# sourceMappingURL=document-workspace-chrome-projection.d.ts.map

package/dist/document-workspace-chrome-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-workspace-chrome-projection.d.ts","sourceRoot":"","sources":["../src/document-workspace-chrome-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,cAAc,EACpB,MAAM,UAAU,CAAA;AAMjB;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,OAAO,CAAC,GAAG,IAAI,EAC1D,QAAQ,EAAE,cAAc,GAAG,IAAI,YAOhC;AAED;;;;;;GAMG;AACH,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,iBAGrF"}

package/dist/document-workspace-chrome-projection.js

@@ -0,0 +1,35 @@
+import { findPresentationView, } from './module.js';
+import { viewChromeSlotKinds, viewRegionKinds, } from '@cohesivesystems/presentation-contracts';
+/**
+ * Resolves document workspace metadata fields from page/header chrome.
+ *
+ * The document editor surface renders these same badge-strip field ids. Keeping
+ * this helper in the projection layer lets adapters build field renderers and
+ * diagnostics from the same IR locations instead of repeating view ids.
+ */
+export function resolveDocumentWorkspaceMetadataFieldIds(module, pageView) {
+    const headerView = findHostedView(module, pageView, viewRegionKinds.header, 'Header');
+    const badgeSlot = headerView?.Chrome?.Slots?.find((slot) => matchesEnum(slot.Kind, viewChromeSlotKinds.badgeStrip, 'BadgeStrip'));
+    return badgeSlot?.FieldIds ?? [];
+}
+/**
+ * Resolves the page-region id used for document workspace header chrome.
+ *
+ * Profile-level notices target region ids, while page layout regions carry
+ * enum kinds. This helper keeps that cross-reference in the projection layer
+ * instead of repeating product constants in workspace hosts.
+ */
+export function resolveDocumentWorkspaceHeaderRegionId(pageView) {
+    return pageView?.Regions?.find((region) => matchesEnum(region.Kind, viewRegionKinds.header, 'Header'))?.Id ?? null;
+}
+function findHostedView(module, view, regionKind, regionKindLabel) {
+    const region = view?.Regions?.find((candidate) => matchesEnum(candidate.Kind, regionKind, regionKindLabel));
+    const viewId = region?.ViewIds?.[0];
+    return viewId ? findPresentationView(module, viewId) : null;
+}
+function matchesEnum(value, numericValue, label) {
+    return value === numericValue ||
+        String(value) === String(numericValue) ||
+        String(value) === label;
+}
+//# sourceMappingURL=document-workspace-chrome-projection.js.map

package/dist/document-workspace-chrome-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-workspace-chrome-projection.js","sourceRoot":"","sources":["../src/document-workspace-chrome-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAGrB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,mBAAmB,EACnB,eAAe,GAChB,MAAM,yCAAyC,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,UAAU,wCAAwC,CACtD,MAA0D,EAC1D,QAA+B;IAE/B,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACrF,MAAM,SAAS,GAAG,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACzD,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAA;IAEvE,OAAO,SAAS,EAAE,QAAQ,IAAI,EAAE,CAAA;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sCAAsC,CAAC,QAA+B;IACpF,OAAO,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACxC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAA;AAC3E,CAAC;AAED,SAAS,cAAc,CACrB,MAA0D,EAC1D,IAA2B,EAC3B,UAA2B,EAC3B,eAAuB;IAEvB,MAAM,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAC/C,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAA;IAC3D,MAAM,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;IAEnC,OAAO,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC7D,CAAC;AAED,SAAS,WAAW,CAClB,KAAyC,EACzC,YAA6B,EAC7B,KAAa;IAEb,OAAO,KAAK,KAAK,YAAY;QAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,YAAY,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAA;AAC3B,CAAC"}

package/dist/document-workspace-surface-slots.d.ts

@@ -0,0 +1,75 @@
+import { type PresentationBindingDefinition, type PresentationModuleDefinition, type ViewDefinition, type ViewRegionDefinition, type WorkspaceDefinition } from './module.js';
+import { type PresentationProjectionDiagnostic } from './presentation-projection-diagnostics.js';
+export interface DocumentWorkspaceSurfaceSlotDescriptor {
+    readonly expectsHostedView: boolean;
+    readonly id: string;
+    readonly regionKind?: string | number | null;
+    readonly regionKindLabel?: string;
+    readonly role: string | number;
+    readonly roleLabel?: string;
+    readonly renderer?: PresentationBindingDefinition | null;
+}
+export interface ResolvedDocumentWorkspaceSurfaceSlot {
+    readonly descriptor: DocumentWorkspaceSurfaceSlotDescriptor;
+    readonly expectsHostedView: boolean;
+    readonly id: string;
+    readonly region: ViewRegionDefinition | null;
+    readonly role: string | number;
+    readonly roleLabel?: string;
+    readonly renderer?: PresentationBindingDefinition | null;
+    readonly view: ViewDefinition | null;
+}
+export interface ResolvedDocumentWorkspaceSurfaceSlots {
+    readonly all: readonly ResolvedDocumentWorkspaceSurfaceSlot[];
+    readonly auxiliary: ResolvedDocumentWorkspaceSurfaceSlot;
+    readonly header: ResolvedDocumentWorkspaceSurfaceSlot;
+    readonly primarySurface: ResolvedDocumentWorkspaceSurfaceSlot;
+}
+export declare const documentWorkspaceSurfaceSlotRoleKeys: {
+    readonly header: "header";
+    readonly primarySurface: "primarySurface";
+    readonly auxiliary: "auxiliary";
+    readonly custom: "custom";
+};
+export declare const documentWorkspaceSurfaceSlotIds: {
+    readonly auxiliary: "auxiliary";
+    readonly header: "header";
+    readonly workspace: "workspace";
+};
+export declare const documentWorkspaceSurfaceSlotDescriptors: {
+    readonly header: {
+        readonly expectsHostedView: true;
+        readonly id: "header";
+        readonly regionKind: 2;
+        readonly regionKindLabel: string;
+        readonly role: 0;
+        readonly roleLabel: string;
+        readonly renderer: null;
+    };
+    readonly workspace: {
+        readonly expectsHostedView: true;
+        readonly id: "workspace";
+        readonly regionKind: 18;
+        readonly regionKindLabel: string;
+        readonly role: 1;
+        readonly roleLabel: string;
+        readonly renderer: null;
+    };
+    readonly auxiliary: {
+        readonly expectsHostedView: false;
+        readonly id: "auxiliary";
+        readonly role: 2;
+        readonly roleLabel: string;
+        readonly renderer: null;
+    };
+};
+export declare function resolveDocumentWorkspaceSurfaceSlots(module: Pick<PresentationModuleDefinition, 'Views'> | null, pageView: ViewDefinition | null, workspace?: Pick<WorkspaceDefinition, 'SurfaceSlots'> | null): ResolvedDocumentWorkspaceSurfaceSlots;
+export declare function projectDocumentWorkspaceSurfaceSlotDiagnostics({ declaredSlots, pageView, renderedSlots, sourceId, }: {
+    readonly declaredSlots: readonly ResolvedDocumentWorkspaceSurfaceSlot[];
+    readonly pageView: ViewDefinition | null;
+    readonly renderedSlots: readonly ResolvedDocumentWorkspaceSurfaceSlot[];
+    readonly sourceId: string;
+}): readonly PresentationProjectionDiagnostic[];
+export declare function resolveDocumentWorkspaceSurfaceSlotRoleKey(role: string | number, roleLabel?: string): string;
+export declare function isStandardDocumentWorkspaceSurfaceSlotRoleKey(roleKey: string): roleKey is "header" | "primarySurface" | "auxiliary";
+//# sourceMappingURL=document-workspace-surface-slots.d.ts.map

package/dist/document-workspace-surface-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-workspace-surface-slots.d.ts","sourceRoot":"","sources":["../src/document-workspace-surface-slots.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,UAAU,CAAA;AACjB,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,uCAAuC,CAAA;AAQ9C,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,GAAG,IAAI,CAAA;CACzD;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,UAAU,EAAE,sCAAsC,CAAA;IAC3D,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,GAAG,IAAI,CAAA;IACxD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;CACrC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,GAAG,EAAE,SAAS,oCAAoC,EAAE,CAAA;IAC7D,QAAQ,CAAC,SAAS,EAAE,oCAAoC,CAAA;IACxD,QAAQ,CAAC,MAAM,EAAE,oCAAoC,CAAA;IACrD,QAAQ,CAAC,cAAc,EAAE,oCAAoC,CAAA;CAC9D;AAED,eAAO,MAAM,oCAAoC;;;;;CAKvC,CAAA;AAEV,eAAO,MAAM,+BAA+B;;;;CAIlC,CAAA;AAEV,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCuB,CAAA;AAE3E,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,OAAO,CAAC,GAAG,IAAI,EAC1D,QAAQ,EAAE,cAAc,GAAG,IAAI,EAC/B,SAAS,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,GAAG,IAAI,GAC3D,qCAAqC,CAiCvC;AAED,wBAAgB,8CAA8C,CAAC,EAC7D,aAAa,EACb,QAAQ,EACR,aAAa,EACb,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,aAAa,EAAE,SAAS,oCAAoC,EAAE,CAAA;IACvE,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,aAAa,EAAE,SAAS,oCAAoC,EAAE,CAAA;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GAAG,SAAS,gCAAgC,EAAE,CA2F9C;AAED,wBAAgB,0CAA0C,CACxD,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,UAiBnB;AAED,wBAAgB,6CAA6C,CAAC,OAAO,EAAE,MAAM,wDAM5E"}

package/dist/document-workspace-surface-slots.js

@@ -0,0 +1,268 @@
+import { findPresentationView, } from './module.js';
+import { createPresentationProjectionDiagnostic, } from './presentation-projection-diagnostics.js';
+import { documentWorkspaceSurfaceSlotRoleLabels, documentWorkspaceSurfaceSlotRoles, viewRegionKindLabels, viewRegionKinds, } from '@cohesivesystems/presentation-contracts';
+export const documentWorkspaceSurfaceSlotRoleKeys = {
+    header: 'header',
+    primarySurface: 'primarySurface',
+    auxiliary: 'auxiliary',
+    custom: 'custom',
+};
+export const documentWorkspaceSurfaceSlotIds = {
+    auxiliary: 'auxiliary',
+    header: 'header',
+    workspace: 'workspace',
+};
+export const documentWorkspaceSurfaceSlotDescriptors = {
+    header: {
+        expectsHostedView: true,
+        id: documentWorkspaceSurfaceSlotIds.header,
+        regionKind: viewRegionKinds.header,
+        regionKindLabel: viewRegionKindLabels[viewRegionKinds.header],
+        role: documentWorkspaceSurfaceSlotRoles.header,
+        roleLabel: documentWorkspaceSurfaceSlotRoleLabels[documentWorkspaceSurfaceSlotRoles.header],
+        renderer: null,
+    },
+    workspace: {
+        expectsHostedView: true,
+        id: documentWorkspaceSurfaceSlotIds.workspace,
+        regionKind: viewRegionKinds.surface,
+        regionKindLabel: viewRegionKindLabels[viewRegionKinds.surface],
+        role: documentWorkspaceSurfaceSlotRoles.primarySurface,
+        roleLabel: documentWorkspaceSurfaceSlotRoleLabels[documentWorkspaceSurfaceSlotRoles.primarySurface],
+        renderer: null,
+    },
+    auxiliary: {
+        expectsHostedView: false,
+        id: documentWorkspaceSurfaceSlotIds.auxiliary,
+        role: documentWorkspaceSurfaceSlotRoles.auxiliary,
+        roleLabel: documentWorkspaceSurfaceSlotRoleLabels[documentWorkspaceSurfaceSlotRoles.auxiliary],
+        renderer: null,
+    },
+};
+export function resolveDocumentWorkspaceSurfaceSlots(module, pageView, workspace) {
+    const descriptors = resolveDocumentWorkspaceSurfaceSlotDescriptors(workspace);
+    const resolvedSlots = descriptors.map((descriptor) => resolveDocumentWorkspaceSurfaceSlot(module, pageView, descriptor));
+    const header = resolveDocumentWorkspaceSurfaceSlotByRole(resolvedSlots, module, pageView, documentWorkspaceSurfaceSlotDescriptors.header);
+    const primarySurface = resolveDocumentWorkspaceSurfaceSlotByRole(resolvedSlots, module, pageView, documentWorkspaceSurfaceSlotDescriptors.workspace);
+    const auxiliary = resolveDocumentWorkspaceSurfaceSlotByRole(resolvedSlots, module, pageView, documentWorkspaceSurfaceSlotDescriptors.auxiliary);
+    return {
+        all: resolvedSlots,
+        auxiliary,
+        header,
+        primarySurface,
+    };
+}
+export function projectDocumentWorkspaceSurfaceSlotDiagnostics({ declaredSlots, pageView, renderedSlots, sourceId, }) {
+    const diagnostics = [];
+    const declaredSlotIds = new Set(declaredSlots.map((slot) => slot.id));
+    const renderedSlotIds = new Set(renderedSlots.map((slot) => slot.id));
+    diagnostics.push(...projectDuplicateDocumentWorkspaceSurfaceSlotRoleDiagnostics({
+        declaredSlots,
+        sourceId,
+    }));
+    for (const slotId of declaredSlotIds) {
+        if (!renderedSlotIds.has(slotId)) {
+            diagnostics.push(createPresentationProjectionDiagnostic({
+                category: 'incomplete-projection',
+                id: `document-workspace-surface-slot:${slotId}:not-rendered`,
+                interpretation: {
+                    status: 'unbound',
+                    target: 'react',
+                },
+                message: `Document workspace surface slot '${slotId}' is declared but is not rendered by the ` +
+                    'document editor surface interpreter.',
+                severity: 'warning',
+                source: sourceId,
+                subject: {
+                    id: slotId,
+                    kind: 'document-workspace-surface-slot',
+                },
+                suggestedNextStep: 'Bind a surface-slot renderer for this slot role or remove it from the workspace SurfaceSlots IR.',
+            }));
+        }
+    }
+    for (const slot of distinctDocumentWorkspaceSurfaceSlots([
+        ...declaredSlots,
+        ...renderedSlots,
+    ])) {
+        if (slot.expectsHostedView && !slot.view) {
+            diagnostics.push(createPresentationProjectionDiagnostic({
+                category: 'missing-definition',
+                details: {
+                    pageViewId: pageView?.Id ?? null,
+                    regionId: slot.region?.Id ?? null,
+                    role: resolveDocumentWorkspaceSurfaceSlotRoleKey(slot.role, slot.roleLabel),
+                },
+                id: `document-workspace-surface-slot:${slot.id}:missing-hosted-view`,
+                interpretation: {
+                    status: 'unbound',
+                    target: 'react',
+                },
+                message: `Document workspace surface slot '${slot.id}' requires a hosted view but has no ` +
+                    'hosted view on the page view.',
+                severity: 'warning',
+                source: sourceId,
+                subject: {
+                    id: slot.id,
+                    kind: 'document-workspace-surface-slot',
+                },
+                suggestedNextStep: 'Declare a page region with the expected ViewRegionKind and a hosted view id for this slot.',
+            }));
+        }
+    }
+    for (const slot of renderedSlots) {
+        if (!declaredSlotIds.has(slot.id)) {
+            diagnostics.push(createPresentationProjectionDiagnostic({
+                category: 'local-interpretation',
+                id: `document-workspace-surface-slot:${slot.id}:fallback`,
+                interpretation: {
+                    status: 'locally-interpreted',
+                    target: 'react',
+                },
+                message: `Document workspace surface slot '${slot.id}' is rendered through the default ` +
+                    'surface-slot fallback because it is not declared on the workspace SurfaceSlots IR.',
+                severity: 'info',
+                source: sourceId,
+                subject: {
+                    id: slot.id,
+                    kind: 'document-workspace-surface-slot',
+                },
+                suggestedNextStep: 'Add this slot to the workspace SurfaceSlots declaration if it is a first-class slot.',
+            }));
+        }
+    }
+    return diagnostics;
+}
+export function resolveDocumentWorkspaceSurfaceSlotRoleKey(role, roleLabel) {
+    for (const [roleKey, roleValue] of Object.entries(documentWorkspaceSurfaceSlotRoles)) {
+        if (isEnumDiscriminator(role, roleValue, documentWorkspaceSurfaceSlotRoleLabels[roleValue])) {
+            return roleKey;
+        }
+    }
+    return normalizeEnumDiscriminator(roleLabel ?? role);
+}
+export function isStandardDocumentWorkspaceSurfaceSlotRoleKey(roleKey) {
+    return (roleKey === documentWorkspaceSurfaceSlotRoleKeys.header ||
+        roleKey === documentWorkspaceSurfaceSlotRoleKeys.primarySurface ||
+        roleKey === documentWorkspaceSurfaceSlotRoleKeys.auxiliary);
+}
+function resolveDocumentWorkspaceSurfaceSlotDescriptors(workspace) {
+    const slots = workspace?.SurfaceSlots ?? [];
+    if (slots.length === 0) {
+        return Object.values(documentWorkspaceSurfaceSlotDescriptors);
+    }
+    return slots.map(createDocumentWorkspaceSurfaceSlotDescriptor);
+}
+function createDocumentWorkspaceSurfaceSlotDescriptor(slot) {
+    const regionKind = slot.RegionKind ?? undefined;
+    return {
+        expectsHostedView: slot.RequiresHostedView,
+        id: slot.Id,
+        regionKind,
+        regionKindLabel: resolveViewRegionKindLabel(regionKind),
+        role: slot.Role,
+        roleLabel: resolveDocumentWorkspaceSurfaceSlotRoleLabel(slot.Role),
+        renderer: slot.Renderer ?? null,
+    };
+}
+function resolveDocumentWorkspaceSurfaceSlotByRole(resolvedSlots, module, pageView, fallbackDescriptor) {
+    return (resolvedSlots.find((slot) => isEnumDiscriminator(slot.role, fallbackDescriptor.role, fallbackDescriptor.roleLabel ?? String(fallbackDescriptor.role))) ??
+        resolveDocumentWorkspaceSurfaceSlot(module, pageView, fallbackDescriptor));
+}
+function resolveDocumentWorkspaceSurfaceSlot(module, pageView, descriptor) {
+    const regionKind = descriptor.regionKind;
+    const regionKindLabel = descriptor.regionKindLabel;
+    const region = regionKind === undefined || regionKind === null || regionKindLabel === undefined
+        ? null
+        : pageView?.Regions?.find((candidate) => isEnumDiscriminator(candidate.Kind, regionKind, regionKindLabel)) ?? null;
+    const viewId = region?.ViewIds?.[0];
+    return {
+        descriptor,
+        expectsHostedView: descriptor.expectsHostedView,
+        id: descriptor.id,
+        region,
+        role: descriptor.role,
+        roleLabel: descriptor.roleLabel,
+        renderer: descriptor.renderer ?? null,
+        view: viewId ? findPresentationView(module, viewId) : null,
+    };
+}
+function isEnumDiscriminator(value, expected, expectedLabel) {
+    const valueLabel = resolveViewRegionKindLabel(value);
+    return (value === expected ||
+        String(value) === String(expected) ||
+        (valueLabel !== undefined &&
+            normalizeEnumDiscriminator(valueLabel) === normalizeEnumDiscriminator(expectedLabel)) ||
+        normalizeEnumDiscriminator(value) === normalizeEnumDiscriminator(expectedLabel));
+}
+function normalizeEnumDiscriminator(value) {
+    return String(value).replace(/[-_\s]/g, '').toLocaleLowerCase();
+}
+function resolveViewRegionKindLabel(regionKind) {
+    if (regionKind === null || regionKind === undefined) {
+        return undefined;
+    }
+    if (typeof regionKind === 'number' &&
+        Object.prototype.hasOwnProperty.call(viewRegionKindLabels, regionKind)) {
+        return viewRegionKindLabels[regionKind];
+    }
+    return String(regionKind);
+}
+function resolveDocumentWorkspaceSurfaceSlotRoleLabel(role) {
+    if (role === null || role === undefined) {
+        return undefined;
+    }
+    if (typeof role === 'number' &&
+        Object.prototype.hasOwnProperty.call(documentWorkspaceSurfaceSlotRoleLabels, role)) {
+        return documentWorkspaceSurfaceSlotRoleLabels[role];
+    }
+    return String(role);
+}
+function projectDuplicateDocumentWorkspaceSurfaceSlotRoleDiagnostics({ declaredSlots, sourceId, }) {
+    const slotsByRoleKey = new Map();
+    for (const slot of declaredSlots) {
+        const roleKey = resolveDocumentWorkspaceSurfaceSlotRoleKey(slot.role, slot.roleLabel);
+        if (!isStandardDocumentWorkspaceSurfaceSlotRoleKey(roleKey)) {
+            continue;
+        }
+        const slots = slotsByRoleKey.get(roleKey) ?? [];
+        slots.push(slot);
+        slotsByRoleKey.set(roleKey, slots);
+    }
+    const diagnostics = [];
+    for (const [roleKey, slots] of slotsByRoleKey) {
+        if (slots.length <= 1) {
+            continue;
+        }
+        diagnostics.push(createPresentationProjectionDiagnostic({
+            category: 'incomplete-projection',
+            details: {
+                role: roleKey,
+                slotIds: slots.map((slot) => slot.id),
+            },
+            id: `document-workspace-surface-slot-role:${roleKey}:duplicate`,
+            interpretation: {
+                status: 'unbound',
+                target: 'react',
+            },
+            message: `Document workspace surface role '${roleKey}' is declared by multiple slots: ` +
+                slots.map((slot) => `'${slot.id}'`).join(', '),
+            severity: 'warning',
+            source: sourceId,
+            subject: {
+                id: roleKey,
+                kind: 'document-workspace-surface-slot-role',
+            },
+            suggestedNextStep: 'Keep one standard slot per role, or introduce a custom role with an explicit renderer.',
+        }));
+    }
+    return diagnostics;
+}
+function distinctDocumentWorkspaceSurfaceSlots(slots) {
+    const distinctSlots = new Map();
+    for (const slot of slots) {
+        distinctSlots.set(slot.id, slot);
+    }
+    return [...distinctSlots.values()];
+}
+//# sourceMappingURL=document-workspace-surface-slots.js.map

package/dist/document-workspace-surface-slots.js.map

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

package/dist/endpoint-executor.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Transport-neutral request envelope passed to an endpoint executor after a
+ * presentation runtime has projected semantic inputs into concrete API inputs.
+ *
+ * @typeParam TBody - Request body payload shape.
+ * @typeParam TQuery - Query payload shape.
+ */
+export interface EndpointExecutionRequest<TBody = unknown, TQuery = unknown> {
+    /** Request body payload for mutation/action endpoints. */
+    readonly body?: TBody;
+    /** Query payload for query/read endpoints. */
+    readonly query?: TQuery | null;
+    /** Route parameters substituted into endpoint paths by the host adapter. */
+    readonly routeParameters?: Readonly<Record<string, string | null | undefined>>;
+}
+/**
+ * Executes a concrete endpoint request.
+ *
+ * Endpoint executors are supplied by applications or adapters because only the
+ * host knows how endpoint ids map to generated clients, fetch calls, auth, and
+ * transport concerns.
+ *
+ * @typeParam TResult - Result shape returned by the endpoint executor.
+ * @typeParam TBody - Request body payload shape.
+ * @typeParam TQuery - Query payload shape.
+ */
+export type EndpointExecutor<TResult = unknown, TBody = unknown, TQuery = unknown> = (request: EndpointExecutionRequest<TBody, TQuery>) => Promise<TResult>;
+/**
+ * Registry keyed by semantic endpoint id.
+ */
+export type EndpointExecutorRegistry = Readonly<Record<string, EndpointExecutor>>;
+/**
+ * Dispatches an endpoint id through a host-provided endpoint executor registry.
+ *
+ * @typeParam TResult - Result shape returned by the selected executor.
+ * @typeParam TBody - Request body payload shape.
+ * @typeParam TQuery - Query payload shape.
+ */
+export type EndpointRegistryExecutor = <TResult = unknown, TBody = unknown, TQuery = unknown>(endpointId: string, request?: EndpointExecutionRequest<TBody, TQuery>) => Promise<TResult>;
+/**
+ * Options for creating an endpoint registry dispatcher.
+ */
+export interface CreateEndpointExecutorOptions {
+    /** Human-readable endpoint family label used in diagnostic errors. */
+    readonly label?: string;
+}
+/**
+ * Creates a generic dispatcher from semantic endpoint ids to concrete endpoint
+ * executors.
+ */
+export declare function createEndpointExecutor(registry: EndpointExecutorRegistry, { label }?: CreateEndpointExecutorOptions): EndpointRegistryExecutor;
+/**
+ * Reads a required route parameter from a projected endpoint request.
+ */
+export declare function readRequiredEndpointRouteParameter(endpointId: string, request: EndpointExecutionRequest, parameterName: string): string;
+/**
+ * Reads a required request body from a projected endpoint request.
+ *
+ * @typeParam TBody - Expected request body payload shape.
+ */
+export declare function readRequiredEndpointBody<TBody>(endpointId: string, request: EndpointExecutionRequest): TBody;
+//# sourceMappingURL=endpoint-executor.d.ts.map

package/dist/endpoint-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-executor.d.ts","sourceRoot":"","sources":["../src/endpoint-executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IACzE,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;IAErB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAA;CAC/E;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,CAC1B,OAAO,GAAG,OAAO,EACjB,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,OAAO,IACd,CAAC,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAE1E;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAEjF;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,GAAG,OAAO,EACjB,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,OAAO,EAEhB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,KAC9C,OAAO,CAAC,OAAO,CAAC,CAAA;AAErB;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,wBAAwB,EAClC,EAAE,KAAa,EAAE,GAAE,6BAAkC,GACpD,wBAAwB,CAgB1B;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,wBAAwB,EACjC,aAAa,EAAE,MAAM,GACpB,MAAM,CASR;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAC5C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,wBAAwB,GAChC,KAAK,CAMP"}

package/dist/endpoint-executor.js

@@ -0,0 +1,35 @@
+/**
+ * Creates a generic dispatcher from semantic endpoint ids to concrete endpoint
+ * executors.
+ */
+export function createEndpointExecutor(registry, { label = 'API' } = {}) {
+    return async function executeEndpoint(endpointId, request = {}) {
+        const executor = registry[endpointId];
+        if (!executor) {
+            throw new Error(`No ${label} endpoint executor is registered for endpoint '${endpointId}'.`);
+        }
+        return await executor(request);
+    };
+}
+/**
+ * Reads a required route parameter from a projected endpoint request.
+ */
+export function readRequiredEndpointRouteParameter(endpointId, request, parameterName) {
+    const value = request.routeParameters?.[parameterName];
+    if (value === null || value === undefined || value === '') {
+        throw new Error(`Endpoint '${endpointId}' requires route parameter '${parameterName}'.`);
+    }
+    return value;
+}
+/**
+ * Reads a required request body from a projected endpoint request.
+ *
+ * @typeParam TBody - Expected request body payload shape.
+ */
+export function readRequiredEndpointBody(endpointId, request) {
+    if (request.body === undefined) {
+        throw new Error(`Endpoint '${endpointId}' requires a request body.`);
+    }
+    return request.body;
+}
+//# sourceMappingURL=endpoint-executor.js.map

package/dist/endpoint-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-executor.js","sourceRoot":"","sources":["../src/endpoint-executor.ts"],"names":[],"mappings":"AAgEA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAkC,EAClC,EAAE,KAAK,GAAG,KAAK,KAAoC,EAAE;IAErD,OAAO,KAAK,UAAU,eAAe,CAKnC,UAAkB,EAClB,UAAmD,EAAE;QAErD,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;QACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,kDAAkD,UAAU,IAAI,CAAC,CAAA;QAC9F,CAAC;QAED,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAY,CAAA;IAC3C,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kCAAkC,CAChD,UAAkB,EAClB,OAAiC,EACjC,aAAqB;IAErB,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,aAAa,CAAC,CAAA;IACtD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,aAAa,UAAU,+BAA+B,aAAa,IAAI,CACxE,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAAkB,EAClB,OAAiC;IAEjC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,aAAa,UAAU,4BAA4B,CAAC,CAAA;IACtE,CAAC;IAED,OAAO,OAAO,CAAC,IAAa,CAAA;AAC9B,CAAC"}

package/dist/field-display-resolution.d.ts

@@ -0,0 +1,5 @@
+import type { FieldPresentationDefinition } from './module.js';
+export declare function resolvePresentationFieldValueLabel(field: FieldPresentationDefinition | null | undefined, value: unknown): string | null;
+export declare function resolvePresentationFieldValueTone(field: FieldPresentationDefinition | null | undefined, value: unknown, resource?: unknown): string | null;
+export declare function resolvePresentationFieldValueIcon(field: FieldPresentationDefinition | null | undefined, value: unknown): string | null;
+//# sourceMappingURL=field-display-resolution.d.ts.map

package/dist/field-display-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-display-resolution.d.ts","sourceRoot":"","sources":["../src/field-display-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAI5B,MAAM,UAAU,CAAA;AAKjB,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,EACrD,KAAK,EAAE,OAAO,iBAGf;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,EACrD,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,OAAO,iBAQnB;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,EACrD,KAAK,EAAE,OAAO,iBAGf"}

package/dist/field-display-resolution.js

@@ -0,0 +1,50 @@
+import { readObjectPath, } from './object-path.js';
+export function resolvePresentationFieldValueLabel(field, value) {
+    return readDisplayValueLabel(field?.Display?.ValueLabels, value);
+}
+export function resolvePresentationFieldValueTone(field, value, resource) {
+    return (readFirstDisplayFieldPathValue(field?.Display?.ToneFieldPaths, resource) ??
+        readDisplayValueTone(field?.Display?.ValueTones, value) ??
+        field?.Display?.Tone ??
+        null);
+}
+export function resolvePresentationFieldValueIcon(field, value) {
+    return readDisplayValueIcon(field?.Display?.ValueIcons, value);
+}
+function readDisplayValueLabel(labels, value) {
+    if (!labels) {
+        return null;
+    }
+    const key = String(value);
+    return labels.find((label) => label.Value === key ||
+        label.Value.toLocaleLowerCase() === key.toLocaleLowerCase())?.Label ?? null;
+}
+function readDisplayValueTone(tones, value) {
+    if (!tones) {
+        return null;
+    }
+    const key = String(value);
+    return tones.find((tone) => tone.Value === key ||
+        tone.Value.toLocaleLowerCase() === key.toLocaleLowerCase())?.Tone ?? null;
+}
+function readDisplayValueIcon(icons, value) {
+    if (!icons) {
+        return null;
+    }
+    const key = String(value);
+    return icons.find((icon) => icon.Value === key ||
+        icon.Value.toLocaleLowerCase() === key.toLocaleLowerCase())?.Icon ?? null;
+}
+function readFirstDisplayFieldPathValue(fieldPaths, resource) {
+    if (!fieldPaths || fieldPaths.length === 0) {
+        return null;
+    }
+    for (const path of fieldPaths) {
+        const value = readObjectPath(resource, path);
+        if (value !== null && value !== undefined && value !== '') {
+            return String(value);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=field-display-resolution.js.map

package/dist/field-display-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-display-resolution.js","sourceRoot":"","sources":["../src/field-display-resolution.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,cAAc,GACf,MAAM,eAAe,CAAA;AAEtB,MAAM,UAAU,kCAAkC,CAChD,KAAqD,EACrD,KAAc;IAEd,OAAO,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,KAAqD,EACrD,KAAc,EACd,QAAkB;IAElB,OAAO,CACL,8BAA8B,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC;QACxE,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC;QACvD,KAAK,EAAE,OAAO,EAAE,IAAI;QACpB,IAAI,CACL,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,KAAqD,EACrD,KAAc;IAEd,OAAO,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAA;AAChE,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAA+D,EAC/D,KAAc;IAEd,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACzB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,KAAK,CAAC,KAAK,KAAK,GAAG;QACnB,KAAK,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,GAAG,CAAC,iBAAiB,EAAE,CAC5D,EAAE,KAAK,IAAI,IAAI,CAAA;AAClB,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA6D,EAC7D,KAAc;IAEd,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,IAAI,CAAC,KAAK,KAAK,GAAG;QAClB,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,GAAG,CAAC,iBAAiB,EAAE,CAC3D,EAAE,IAAI,IAAI,IAAI,CAAA;AACjB,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA6D,EAC7D,KAAc;IAEd,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,IAAI,CAAC,KAAK,KAAK,GAAG;QAClB,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,GAAG,CAAC,iBAAiB,EAAE,CAC3D,EAAE,IAAI,IAAI,IAAI,CAAA;AACjB,CAAC;AAED,SAAS,8BAA8B,CACrC,UAAgD,EAChD,QAAiB;IAEjB,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}