@cohesivesystems/presentation-core 0.1.0-alpha.1

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

@@ -0,0 +1,80 @@
+import { readObjectPath, } from './object-path.js';
+import { createQueryActivityState, } from './projected-activity-state-model.js';
+import { getPresentationViewProjectedDataSourceIds, } from './presentation-semantics.js';
+import { resolveCollectionChromePrimaryDataSourceId, } from './collection-chrome-runtime.js';
+export { readObjectPath, readObjectProperty, } from './object-path.js';
+/**
+ * Creates a stable semantic resolver over a bound presentation data source map.
+ */
+export function createPresentationDataSourceResolver(dataSources) {
+    return {
+        dataSources,
+        read(dataSourceId) {
+            return dataSources[dataSourceId]?.data;
+        },
+        readPath(dataSourceId, fieldPath) {
+            return readObjectPath(dataSources[dataSourceId]?.data, fieldPath ?? '');
+        },
+        resolve(dataSourceId) {
+            return dataSources[dataSourceId];
+        },
+        resolveViewDataSources(view) {
+            return resolvePresentationViewDataSourceIds(view)
+                .map((dataSourceId) => dataSources[dataSourceId])
+                .filter((state) => Boolean(state));
+        },
+        resolveViewPrimary(view) {
+            const dataSourceId = resolvePresentationViewPrimaryDataSourceId(view);
+            return dataSourceId
+                ? dataSources[dataSourceId]
+                : undefined;
+        },
+    };
+}
+export function createPresentationViewActivityState({ blockedLabel = 'Attach an authenticated context to load this view.', dataSourceResolver, pendingLabel = 'Loading view data...', view, }) {
+    const states = dataSourceResolver.resolveViewDataSources(view);
+    const blockedState = states.find((state) => state.isBlocked);
+    const pendingState = states.find((state) => state.isPending);
+    const errorState = states.find((state) => state.error);
+    return createQueryActivityState({
+        blockedLabel: blockedState?.blockedLabel ?? blockedLabel,
+        error: errorState?.error,
+        isBlocked: Boolean(blockedState),
+        isPending: Boolean(pendingState),
+        pendingLabel: pendingState?.pendingLabel ?? pendingLabel,
+    });
+}
+export function isPresentationViewFetching(view, dataSourceResolver) {
+    return resolvePresentationViewDataSourceIds(view).some((dataSourceId) => dataSourceResolver.resolve(dataSourceId)?.isFetching);
+}
+export function readPresentationDataSourceItems(state) {
+    const data = state?.data;
+    if (Array.isArray(data)) {
+        return data;
+    }
+    if (data && typeof data === 'object') {
+        const items = data.Items;
+        if (Array.isArray(items)) {
+            return items;
+        }
+    }
+    return [];
+}
+export async function refreshPresentationDataSources(dataSourceResolver, dataSourceIds) {
+    const uniqueDataSourceIds = Array.from(new Set(dataSourceIds));
+    await Promise.all(uniqueDataSourceIds.map((dataSourceId) => Promise.resolve(dataSourceResolver.resolve(dataSourceId)?.refetch?.())));
+    return undefined;
+}
+export function resolvePresentationViewDataSourceIds(view) {
+    return getPresentationViewProjectedDataSourceIds(view);
+}
+export function resolvePresentationViewPrimaryDataSourceId(view) {
+    return view.Subject.DataSourceId ??
+        resolvePresentationViewCollectionPrimarySlotDataSourceId(view) ??
+        view.DataSourceIds[0] ??
+        null;
+}
+function resolvePresentationViewCollectionPrimarySlotDataSourceId(view) {
+    return resolveCollectionChromePrimaryDataSourceId(view.Collection);
+}
+//# sourceMappingURL=presentation-data-source-runtime.js.map

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

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

package/dist/presentation-design-intent-diagnostics.d.ts

@@ -0,0 +1,25 @@
+import { type PresentationProjectionDiagnostic } from './presentation-projection-diagnostics.js';
+import type { DesignIntent } from '@cohesivesystems/presentation-contracts';
+export declare const presentationDesignIntentFieldNames: readonly ["Role", "Variant", "Tone", "Density", "Size", "Layout"];
+export type PresentationDesignIntentFieldName = (typeof presentationDesignIntentFieldNames)[number];
+export interface ProjectPresentationDesignIntentDiagnosticsOptions {
+    readonly design: DesignIntent | null | undefined;
+    readonly ignoredFields: readonly PresentationDesignIntentFieldName[];
+    readonly interpretedFields: readonly PresentationDesignIntentFieldName[];
+    readonly message: string;
+    readonly semanticInputs?: readonly string[];
+    readonly source: string;
+    readonly subject: {
+        readonly id: string;
+        readonly kind: string;
+        readonly name?: string | null;
+    };
+    readonly suggestedNextStep?: string;
+    readonly target: string;
+}
+/**
+ * Reports which design-intent fields a frontend interpreter currently consumes
+ * and which declared fields remain TODOs for the active target.
+ */
+export declare function projectPresentationDesignIntentDiagnostics({ design, ignoredFields, interpretedFields, message, semanticInputs, source, subject, suggestedNextStep, target, }: ProjectPresentationDesignIntentDiagnosticsOptions): readonly PresentationProjectionDiagnostic[];
+//# sourceMappingURL=presentation-design-intent-diagnostics.d.ts.map

package/dist/presentation-design-intent-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-design-intent-diagnostics.d.ts","sourceRoot":"","sources":["../src/presentation-design-intent-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,uCAAuC,CAAA;AAC9C,OAAO,KAAK,EACV,YAAY,EACb,MAAM,yCAAyC,CAAA;AAEhD,eAAO,MAAM,kCAAkC,mEAOrC,CAAA;AAEV,MAAM,MAAM,iCAAiC,GAC3C,CAAC,OAAO,kCAAkC,CAAC,CAAC,MAAM,CAAC,CAAA;AAErD,MAAM,WAAW,iDAAiD;IAChE,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,aAAa,EAAE,SAAS,iCAAiC,EAAE,CAAA;IACpE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,iCAAiC,EAAE,CAAA;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC9B,CAAA;IACD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAgB,0CAA0C,CAAC,EACzD,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,cAAmB,EACnB,MAAM,EACN,OAAO,EACP,iBACsF,EACtF,MAAM,GACP,EAAE,iDAAiD,GAAG,SAAS,gCAAgC,EAAE,CA4CjG"}

package/dist/presentation-design-intent-diagnostics.js

@@ -0,0 +1,55 @@
+import { createPresentationProjectionDiagnostic, } from './presentation-projection-diagnostics.js';
+export const presentationDesignIntentFieldNames = [
+    'Role',
+    'Variant',
+    'Tone',
+    'Density',
+    'Size',
+    'Layout',
+];
+/**
+ * Reports which design-intent fields a frontend interpreter currently consumes
+ * and which declared fields remain TODOs for the active target.
+ */
+export function projectPresentationDesignIntentDiagnostics({ design, ignoredFields, interpretedFields, message, semanticInputs = [], source, subject, suggestedNextStep = 'Extend the design interpreter for these fields or remove the unused design intent.', target, }) {
+    if (!design) {
+        return [];
+    }
+    const declaredFields = presentationDesignIntentFieldNames.filter((field) => isPresentationDesignIntentFieldDeclared(design, field));
+    const declaredIgnoredFields = ignoredFields.filter((field) => declaredFields.includes(field));
+    if (declaredIgnoredFields.length === 0) {
+        return [];
+    }
+    const declaredInterpretedFields = interpretedFields.filter((field) => declaredFields.includes(field));
+    return [
+        createPresentationProjectionDiagnostic({
+            category: 'incomplete-projection',
+            details: {
+                ignoredFields: declaredIgnoredFields.map((field) => `Design.${field}`),
+                ignoredValues: Object.fromEntries(declaredIgnoredFields.map((field) => [
+                    field,
+                    design[field],
+                ])),
+                interpretedFields: [
+                    ...semanticInputs,
+                    ...declaredInterpretedFields.map((field) => `Design.${field}`),
+                ],
+            },
+            id: `presentation-design.${subject.id}.design-intent.partial`,
+            interpretation: {
+                status: 'projected',
+                target,
+            },
+            message,
+            severity: 'info',
+            source,
+            subject,
+            suggestedNextStep,
+        }),
+    ];
+}
+function isPresentationDesignIntentFieldDeclared(design, field) {
+    const value = design[field];
+    return value !== null && value !== undefined && value !== '';
+}
+//# sourceMappingURL=presentation-design-intent-diagnostics.js.map

package/dist/presentation-design-intent-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-design-intent-diagnostics.js","sourceRoot":"","sources":["../src/presentation-design-intent-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sCAAsC,GAEvC,MAAM,uCAAuC,CAAA;AAK9C,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,MAAM;IACN,SAAS;IACT,MAAM;IACN,SAAS;IACT,MAAM;IACN,QAAQ;CACA,CAAA;AAqBV;;;GAGG;AACH,MAAM,UAAU,0CAA0C,CAAC,EACzD,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,cAAc,GAAG,EAAE,EACnB,MAAM,EACN,OAAO,EACP,iBAAiB,GACf,oFAAoF,EACtF,MAAM,GAC4C;IAClD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,cAAc,GAAG,kCAAkC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACzE,uCAAuC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IACzD,MAAM,qBAAqB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3D,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IACjC,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACnE,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAEjC,OAAO;QACL,sCAAsC,CAAC;YACrC,QAAQ,EAAE,uBAAuB;YACjC,OAAO,EAAE;gBACP,aAAa,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC;gBACtE,aAAa,EAAE,MAAM,CAAC,WAAW,CAC/B,qBAAqB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;oBACnC,KAAK;oBACL,MAAM,CAAC,KAAK,CAAC;iBACd,CAAC,CACH;gBACD,iBAAiB,EAAE;oBACjB,GAAG,cAAc;oBACjB,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC;iBAC/D;aACF;YACD,EAAE,EAAE,uBAAuB,OAAO,CAAC,EAAE,wBAAwB;YAC7D,cAAc,EAAE;gBACd,MAAM,EAAE,WAAW;gBACnB,MAAM;aACP;YACD,OAAO;YACP,QAAQ,EAAE,MAAM;YAChB,MAAM;YACN,OAAO;YACP,iBAAiB;SAClB,CAAC;KACH,CAAA;AACH,CAAC;AAED,SAAS,uCAAuC,CAC9C,MAAoB,EACpB,KAAwC;IAExC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAA;AAC9D,CAAC"}

package/dist/presentation-icon-diagnostics.d.ts

@@ -0,0 +1,45 @@
+import { type PresentationIconModuleProjection, type PresentationIconRegistry } from './presentation-icon-registry.js';
+import { type PresentationProjectionDiagnostic } from './presentation-projection-diagnostics.js';
+export interface PresentationActionIconPlacement {
+    readonly ActionId: string;
+    readonly Icon?: string | null;
+    readonly Label?: string | null;
+    readonly Region?: string | null;
+}
+export interface PresentationIconDiagnosticSubject {
+    readonly details?: Readonly<Record<string, unknown>>;
+    readonly icon: string | null | undefined;
+    readonly id: string;
+    readonly kind: string;
+    readonly label?: string | null;
+}
+export interface ProjectPresentationIconDiagnosticsOptions<TSubject extends PresentationIconDiagnosticSubject> {
+    readonly componentSet?: string;
+    readonly icons: readonly TSubject[];
+    readonly module?: PresentationIconModuleProjection | null;
+    readonly registry?: PresentationIconRegistry<TSubject> | null;
+    readonly source: string;
+    readonly surfaceId?: string | null;
+    readonly surfaceName?: string | null;
+}
+export interface ProjectPresentationActionIconDiagnosticsOptions<TPlacement extends PresentationActionIconPlacement> {
+    readonly actionPlacements: readonly TPlacement[];
+    readonly componentSet?: string;
+    readonly module?: PresentationIconModuleProjection | null;
+    readonly registry?: PresentationIconRegistry<TPlacement> | null;
+    readonly source: string;
+    readonly surfaceId?: string | null;
+    readonly surfaceName?: string | null;
+}
+/**
+ * Reports arbitrary semantic icon ids that are not fully interpreted by the
+ * frontend icon target.
+ */
+export declare function projectPresentationIconDiagnostics<TSubject extends PresentationIconDiagnosticSubject>({ componentSet, icons, module, registry, source, surfaceId, surfaceName, }: ProjectPresentationIconDiagnosticsOptions<TSubject>): readonly PresentationProjectionDiagnostic[];
+/**
+ * Reports action icon placements that are not fully interpreted by the
+ * frontend icon target. The UI can still render through raw icon-key fallback,
+ * but this keeps IR target-binding coverage visible in the developer toolbar.
+ */
+export declare function projectPresentationActionIconDiagnostics<TPlacement extends PresentationActionIconPlacement>({ actionPlacements, componentSet, module, registry, source, surfaceId, surfaceName, }: ProjectPresentationActionIconDiagnosticsOptions<TPlacement>): readonly PresentationProjectionDiagnostic[];
+//# sourceMappingURL=presentation-icon-diagnostics.d.ts.map

package/dist/presentation-icon-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-icon-diagnostics.d.ts","sourceRoot":"","sources":["../src/presentation-icon-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gCAAgC,EACrC,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,uCAAuC,CAAA;AAE9C,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,yCAAyC,CACxD,QAAQ,SAAS,iCAAiC;IAElD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,gCAAgC,GAAG,IAAI,CAAA;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAA;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrC;AAED,MAAM,WAAW,+CAA+C,CAC9D,UAAU,SAAS,+BAA+B;IAElD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,UAAU,EAAE,CAAA;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,gCAAgC,GAAG,IAAI,CAAA;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC,UAAU,CAAC,GAAG,IAAI,CAAA;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrC;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,SAAS,iCAAiC,EAClD,EACA,YAA8C,EAC9C,KAAK,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,SAAS,EACT,WAAW,GACZ,EAAE,yCAAyC,CAAC,QAAQ,CAAC,GAAG,SAAS,gCAAgC,EAAE,CAyFnG;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,UAAU,SAAS,+BAA+B,EAClD,EACA,gBAAgB,EAChB,YAA8C,EAC9C,MAAM,EACN,QAAQ,EACR,MAAM,EACN,SAAS,EACT,WAAW,GACZ,EAAE,+CAA+C,CAAC,UAAU,CAAC,GAAG,SAAS,gCAAgC,EAAE,CAyF3G"}

package/dist/presentation-icon-diagnostics.js

@@ -0,0 +1,235 @@
+import { defaultPresentationComponentSet, resolvePresentationIcon, } from './presentation-icon-registry.js';
+import { createPresentationProjectionDiagnostic, } from './presentation-projection-diagnostics.js';
+/**
+ * Reports arbitrary semantic icon ids that are not fully interpreted by the
+ * frontend icon target.
+ */
+export function projectPresentationIconDiagnostics({ componentSet = defaultPresentationComponentSet, icons, module, registry, source, surfaceId, surfaceName, }) {
+    return icons.flatMap((subject) => {
+        const icon = subject.icon;
+        if (!icon) {
+            return [];
+        }
+        const resolution = resolvePresentationIcon({
+            componentSet,
+            icon,
+            module,
+            registry,
+        });
+        if (!resolution.renderer) {
+            return [
+                createGenericIconDiagnostic({
+                    details: {
+                        componentKey: resolution.componentKey,
+                        componentRole: resolution.componentRole,
+                        icon,
+                        surfaceId,
+                        ...subject.details,
+                    },
+                    icon,
+                    message: `${formatIconSubject(subject)} declares icon '${icon}', ` +
+                        'but the frontend icon registry has no renderer for it.',
+                    reason: 'missing-icon-renderer',
+                    severity: 'warning',
+                    source,
+                    status: 'unbound',
+                    subject,
+                    surfaceName,
+                    target: 'presentation-icon-registry',
+                }),
+            ];
+        }
+        if (resolution.targetBindingSource) {
+            if (resolution.resolutionSource === 'icon-key') {
+                return [
+                    createGenericIconDiagnostic({
+                        details: {
+                            componentKey: resolution.componentKey,
+                            componentRole: resolution.componentRole,
+                            icon,
+                            surfaceId,
+                            ...subject.details,
+                        },
+                        icon,
+                        message: `${formatIconSubject(subject)} declares icon '${icon}', ` +
+                            'but its target binding was not resolved by the frontend icon registry; raw icon-key fallback was used.',
+                        reason: 'icon-target-binding-fallback',
+                        severity: 'warning',
+                        source,
+                        status: 'locally-interpreted',
+                        subject,
+                        surfaceName,
+                        target: 'presentation-icon-target-binding',
+                    }),
+                ];
+            }
+            return [];
+        }
+        return [
+            createGenericIconDiagnostic({
+                details: {
+                    icon,
+                    surfaceId,
+                    ...subject.details,
+                },
+                icon,
+                message: `${formatIconSubject(subject)} declares icon '${icon}', ` +
+                    'but no presentation icon target binding was found; raw icon-key fallback was used.',
+                reason: 'missing-icon-target-binding',
+                severity: 'info',
+                source,
+                status: 'locally-interpreted',
+                subject,
+                surfaceName,
+                target: 'presentation-icon-target-binding',
+            }),
+        ];
+    });
+}
+/**
+ * Reports action icon placements that are not fully interpreted by the
+ * frontend icon target. The UI can still render through raw icon-key fallback,
+ * but this keeps IR target-binding coverage visible in the developer toolbar.
+ */
+export function projectPresentationActionIconDiagnostics({ actionPlacements, componentSet = defaultPresentationComponentSet, module, registry, source, surfaceId, surfaceName, }) {
+    return actionPlacements.flatMap((placement) => {
+        const icon = placement.Icon;
+        if (!icon) {
+            return [];
+        }
+        const resolution = resolvePresentationIcon({
+            componentSet,
+            icon,
+            module,
+            registry,
+        });
+        if (!resolution.renderer) {
+            return [
+                createIconDiagnostic({
+                    details: {
+                        componentKey: resolution.componentKey,
+                        componentRole: resolution.componentRole,
+                        icon,
+                        region: placement.Region,
+                        surfaceId,
+                    },
+                    icon,
+                    message: `Action '${formatActionPlacement(placement)}' declares icon '${icon}', ` +
+                        'but the frontend icon registry has no renderer for it.',
+                    placement,
+                    reason: 'missing-icon-renderer',
+                    severity: 'warning',
+                    source,
+                    status: 'unbound',
+                    surfaceName,
+                    target: 'presentation-icon-registry',
+                }),
+            ];
+        }
+        if (resolution.targetBindingSource) {
+            if (resolution.resolutionSource === 'icon-key') {
+                return [
+                    createIconDiagnostic({
+                        details: {
+                            componentKey: resolution.componentKey,
+                            componentRole: resolution.componentRole,
+                            icon,
+                            region: placement.Region,
+                            surfaceId,
+                        },
+                        icon,
+                        message: `Action '${formatActionPlacement(placement)}' declares icon '${icon}', ` +
+                            'but its target binding was not resolved by the frontend icon registry; raw icon-key fallback was used.',
+                        placement,
+                        reason: 'icon-target-binding-fallback',
+                        severity: 'warning',
+                        source,
+                        status: 'locally-interpreted',
+                        surfaceName,
+                        target: 'presentation-icon-target-binding',
+                    }),
+                ];
+            }
+            return [];
+        }
+        return [
+            createIconDiagnostic({
+                details: {
+                    icon,
+                    region: placement.Region,
+                    surfaceId,
+                },
+                icon,
+                message: `Action '${formatActionPlacement(placement)}' declares icon '${icon}', ` +
+                    'but no presentation icon target binding was found; raw icon-key fallback was used.',
+                placement,
+                reason: 'missing-icon-target-binding',
+                severity: 'info',
+                source,
+                status: 'locally-interpreted',
+                surfaceName,
+                target: 'presentation-icon-target-binding',
+            }),
+        ];
+    });
+}
+function createIconDiagnostic({ details, icon, message, placement, reason, severity, source, status, surfaceName, target, }) {
+    return createPresentationProjectionDiagnostic({
+        category: reason === 'missing-icon-renderer'
+            ? 'missing-binding'
+            : 'local-interpretation',
+        details,
+        id: `action-icon.${formatDiagnosticToken(placement.ActionId)}.${formatDiagnosticToken(placement.Region ?? 'default')}.${formatDiagnosticToken(icon)}.${reason}`,
+        interpretation: {
+            status,
+            target,
+        },
+        message,
+        severity,
+        source,
+        subject: {
+            id: placement.ActionId,
+            kind: 'action-placement',
+            name: placement.Label ?? surfaceName ?? null,
+        },
+        suggestedNextStep: reason === 'missing-icon-target-binding'
+            ? 'Add a presentation icon target binding for this icon id.'
+            : 'Bind the icon target to a frontend icon renderer.',
+    });
+}
+function createGenericIconDiagnostic({ details, icon, message, reason, severity, source, status, subject, surfaceName, target, }) {
+    return createPresentationProjectionDiagnostic({
+        category: reason === 'missing-icon-renderer'
+            ? 'missing-binding'
+            : 'local-interpretation',
+        details,
+        id: `icon.${formatDiagnosticToken(subject.kind)}.${formatDiagnosticToken(subject.id)}.${formatDiagnosticToken(icon)}.${reason}`,
+        interpretation: {
+            status,
+            target,
+        },
+        message,
+        severity,
+        source,
+        subject: {
+            id: subject.id,
+            kind: subject.kind,
+            name: subject.label ?? surfaceName ?? null,
+        },
+        suggestedNextStep: reason === 'missing-icon-target-binding'
+            ? 'Add a presentation icon target binding for this semantic icon id.'
+            : 'Bind the icon target to a frontend icon renderer.',
+    });
+}
+function formatActionPlacement(placement) {
+    return placement.Label ?? placement.ActionId;
+}
+function formatIconSubject(subject) {
+    return subject.label
+        ? `${subject.kind} '${subject.label}'`
+        : `${subject.kind} '${subject.id}'`;
+}
+function formatDiagnosticToken(value) {
+    return value.replaceAll(/[^a-zA-Z0-9_.-]+/g, '-');
+}
+//# sourceMappingURL=presentation-icon-diagnostics.js.map

package/dist/presentation-icon-diagnostics.js.map

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

package/dist/presentation-icon-registry.d.ts

@@ -0,0 +1,36 @@
+import type { PresentationBindingDefinition } from './module.js';
+export interface PresentationIconRenderContext<TSubject = unknown> {
+    readonly className?: string;
+    readonly icon: string;
+    readonly subject?: TSubject;
+}
+export type PresentationIconRenderer<TSubject = unknown, TResult = unknown> = (context: PresentationIconRenderContext<TSubject>) => TResult;
+export interface PresentationIconRegistry<TSubject = unknown, TResult = unknown> {
+    readonly byComponentKey?: Readonly<Record<string, PresentationIconRenderer<TSubject, TResult>>>;
+    readonly byComponentRole?: Readonly<Record<string, PresentationIconRenderer<TSubject, TResult>>>;
+    readonly byIconKey?: Readonly<Record<string, PresentationIconRenderer<TSubject, TResult>>>;
+}
+export interface PresentationIconModuleProjection {
+    readonly Targets?: readonly {
+        readonly Bindings: readonly PresentationBindingDefinition[];
+        readonly ComponentSet?: string | null;
+        readonly Target: string | number;
+    }[];
+}
+export interface PresentationIconResolution<TSubject = unknown, TResult = unknown> {
+    readonly componentKey: string | null;
+    readonly componentRole: string | null;
+    readonly icon: string;
+    readonly renderer: PresentationIconRenderer<TSubject, TResult> | null;
+    readonly resolutionSource: 'component-key' | 'component-role' | 'icon-key' | null;
+    readonly targetBindingSource: 'target-icon-binding' | null;
+}
+export declare const defaultPresentationComponentSet = "cohesive.presentation.default";
+export declare function createPresentationIconRegistry<TSubject = unknown, TResult = unknown>(registry: PresentationIconRegistry<TSubject, TResult>): PresentationIconRegistry<TSubject, TResult>;
+export declare function resolvePresentationIcon<TSubject = unknown, TResult = unknown>({ componentSet, icon, module, registry, }: {
+    readonly componentSet?: string;
+    readonly icon: string | null | undefined;
+    readonly module?: PresentationIconModuleProjection | null;
+    readonly registry: PresentationIconRegistry<TSubject, TResult> | null | undefined;
+}): PresentationIconResolution<TSubject, TResult>;
+//# sourceMappingURL=presentation-icon-registry.d.ts.map

package/dist/presentation-icon-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-icon-registry.d.ts","sourceRoot":"","sources":["../src/presentation-icon-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC9B,MAAM,UAAU,CAAA;AAUjB,MAAM,WAAW,6BAA6B,CAAC,QAAQ,GAAG,OAAO;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;CAC5B;AAED,MAAM,MAAM,wBAAwB,CAClC,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,IACf,CAAC,OAAO,EAAE,6BAA6B,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAA;AAEjE,MAAM,WAAW,wBAAwB,CACvC,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IAC/F,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IAChG,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAC3F;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;QAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,CAAA;QAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;KACjC,EAAE,CAAA;CACJ;AAED,MAAM,WAAW,0BAA0B,CACzC,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACrE,QAAQ,CAAC,gBAAgB,EACrB,eAAe,GACf,gBAAgB,GAChB,UAAU,GACV,IAAI,CAAA;IACR,QAAQ,CAAC,mBAAmB,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAC3D;AAED,eAAO,MAAM,+BAA+B,kCAAkC,CAAA;AAE9E,wBAAgB,8BAA8B,CAC5C,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,EAEjB,QAAQ,EAAE,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,+CAGtD;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,EACjB,EACA,YAA8C,EAC9C,IAAI,EACJ,MAAM,EACN,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,gCAAgC,GAAG,IAAI,CAAA;IACzD,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;CAClF,GAAG,0BAA0B,CAAC,QAAQ,EAAE,OAAO,CAAC,CA0DhD"}

package/dist/presentation-icon-registry.js

@@ -0,0 +1,81 @@
+import { createPresentationEnumDiscriminator, resolvePresentationComponentBinding, } from './target-bindings.js';
+import { presentationBindingKinds, presentationTargetKinds, } from '@cohesivesystems/presentation-contracts';
+export const defaultPresentationComponentSet = 'cohesive.presentation.default';
+export function createPresentationIconRegistry(registry) {
+    return registry;
+}
+export function resolvePresentationIcon({ componentSet = defaultPresentationComponentSet, icon, module, registry, }) {
+    const iconKey = icon ?? '';
+    const targetBinding = iconKey
+        ? resolvePresentationIconTargetBinding({ componentSet, icon: iconKey, module })
+        : null;
+    const componentRole = targetBinding?.componentRole ?? null;
+    const componentKey = targetBinding?.componentKey ?? null;
+    if (componentRole) {
+        const renderer = registry?.byComponentRole?.[componentRole];
+        if (renderer) {
+            return {
+                componentKey,
+                componentRole,
+                icon: iconKey,
+                renderer,
+                resolutionSource: 'component-role',
+                targetBindingSource: targetBinding?.source ?? null,
+            };
+        }
+    }
+    if (componentKey) {
+        const renderer = registry?.byComponentKey?.[componentKey];
+        if (renderer) {
+            return {
+                componentKey,
+                componentRole,
+                icon: iconKey,
+                renderer,
+                resolutionSource: 'component-key',
+                targetBindingSource: targetBinding?.source ?? null,
+            };
+        }
+    }
+    if (iconKey) {
+        const renderer = registry?.byIconKey?.[iconKey];
+        if (renderer) {
+            return {
+                componentKey,
+                componentRole,
+                icon: iconKey,
+                renderer,
+                resolutionSource: 'icon-key',
+                targetBindingSource: targetBinding?.source ?? null,
+            };
+        }
+    }
+    return {
+        componentKey,
+        componentRole,
+        icon: iconKey,
+        renderer: null,
+        resolutionSource: null,
+        targetBindingSource: targetBinding?.source ?? null,
+    };
+}
+function resolvePresentationIconTargetBinding({ componentSet, icon, module, }) {
+    if (!module?.Targets) {
+        return null;
+    }
+    const resolvedBinding = resolvePresentationComponentBinding({ Targets: module.Targets }, {
+        bindingKind: createPresentationEnumDiscriminator(presentationBindingKinds, 'icon', 'Icon'),
+        componentSet,
+        id: icon,
+        targetKind: createPresentationEnumDiscriminator(presentationTargetKinds, 'react', 'React'),
+    });
+    if (!resolvedBinding.binding) {
+        return null;
+    }
+    return {
+        componentKey: resolvedBinding.componentKey,
+        componentRole: resolvedBinding.componentRole,
+        source: 'target-icon-binding',
+    };
+}
+//# sourceMappingURL=presentation-icon-registry.js.map

package/dist/presentation-icon-registry.js.map

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

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

@@ -0,0 +1,13 @@
+import type { ActionDefinition } from './module.js';
+import type { PresentationActionRuntimeBinding } from './presentation-action-runtime-binding.js';
+export interface ProjectPresentationNavigationActionRuntimeBindingsOptions {
+    readonly navigateHref: (href: string) => void;
+    readonly resolveHref: (action: ActionDefinition) => string | null;
+}
+/**
+ * Projects parameterless navigation actions into local navigation runtime
+ * bindings. The presentation IR declares route navigation semantics; the host
+ * still supplies href construction and navigation side effects.
+ */
+export declare function projectPresentationNavigationActionRuntimeBindings<TExecuteContext = unknown, TLabel = string>({ navigateHref, resolveHref, }: ProjectPresentationNavigationActionRuntimeBindingsOptions): readonly PresentationActionRuntimeBinding<TExecuteContext, TLabel>[];
+//# sourceMappingURL=presentation-navigation-action-runtime-bindings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-navigation-action-runtime-bindings.d.ts","sourceRoot":"","sources":["../src/presentation-navigation-action-runtime-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,uCAAuC,CAAA;AAS9C,MAAM,WAAW,yDAAyD;IACxE,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,MAAM,GAAG,IAAI,CAAA;CAClE;AAED;;;;GAIG;AACH,wBAAgB,kDAAkD,CAChE,eAAe,GAAG,OAAO,EACzB,MAAM,GAAG,MAAM,EACf,EACA,YAAY,EACZ,WAAW,GACZ,EAAE,yDAAyD,GAAG,SAAS,gCAAgC,CACtG,eAAe,EACf,MAAM,CACP,EAAE,CAoBF"}