@cohesivesystems/presentation-core 0.1.0-alpha.1

package/dist/navigation-shell-slot-renderer-registry.d.ts

@@ -0,0 +1,15 @@
+import { type NavigationShellSlotDefinition, type NavigationShellSlotKind } from '@cohesivesystems/presentation-contracts';
+export declare const navigationShellSlotAnyPlacement = "*";
+export type NavigationShellSlotRendererRegistry<TRenderer = unknown> = Readonly<Record<string, TRenderer>>;
+export interface NavigationShellSlotRendererBinding<TRenderer = unknown> {
+    readonly kind: NavigationShellSlotKind | string | number;
+    readonly placement?: string | number | null;
+    readonly render: TRenderer;
+}
+export declare function createNavigationShellSlotRendererRegistry<TRenderer>(bindings: readonly NavigationShellSlotRendererBinding<TRenderer>[]): NavigationShellSlotRendererRegistry<TRenderer>;
+export declare function createNavigationShellSlotRendererKey(kind: NavigationShellSlotKind | string | number, placement?: string | number | null): string;
+export declare function getNavigationShellSlotRendererRegistryKeys(registry: NavigationShellSlotRendererRegistry | null | undefined): string[];
+export declare function getNavigationShellSlotRendererCandidateKeys(slot: NavigationShellSlotDefinition): string[];
+export declare function hasNavigationShellSlotRendererBinding(keys: readonly string[], slot: NavigationShellSlotDefinition): boolean;
+export declare function resolveNavigationShellSlotRenderer<TRenderer>(registry: NavigationShellSlotRendererRegistry<TRenderer> | null | undefined, slot: NavigationShellSlotDefinition): (TRenderer & {}) | null;
+//# sourceMappingURL=navigation-shell-slot-renderer-registry.d.ts.map

package/dist/navigation-shell-slot-renderer-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-shell-slot-renderer-registry.d.ts","sourceRoot":"","sources":["../src/navigation-shell-slot-renderer-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC7B,MAAM,yCAAyC,CAAA;AAEhD,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD,MAAM,MAAM,mCAAmC,CAAC,SAAS,GAAG,OAAO,IAAI,QAAQ,CAC7E,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAC1B,CAAA;AAED,MAAM,WAAW,kCAAkC,CAAC,SAAS,GAAG,OAAO;IACrE,QAAQ,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,GAAG,MAAM,CAAA;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAC3B;AAED,wBAAgB,yCAAyC,CAAC,SAAS,EACjE,QAAQ,EAAE,SAAS,kCAAkC,CAAC,SAAS,CAAC,EAAE,GACjE,mCAAmC,CAAC,SAAS,CAAC,CAOhD;AAED,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,uBAAuB,GAAG,MAAM,GAAG,MAAM,EAC/C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,UAKnC;AAED,wBAAgB,0CAA0C,CACxD,QAAQ,EAAE,mCAAmC,GAAG,IAAI,GAAG,SAAS,YAGjE;AAED,wBAAgB,2CAA2C,CACzD,IAAI,EAAE,6BAA6B,YAMpC;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,6BAA6B,WAIpC;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAC1D,QAAQ,EAAE,mCAAmC,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3E,IAAI,EAAE,6BAA6B,2BAWpC"}

package/dist/navigation-shell-slot-renderer-registry.js

@@ -0,0 +1,48 @@
+import { navigationShellSlotKindLabels, } from '@cohesivesystems/presentation-contracts';
+export const navigationShellSlotAnyPlacement = '*';
+export function createNavigationShellSlotRendererRegistry(bindings) {
+    return Object.fromEntries(bindings.map((binding) => [
+        createNavigationShellSlotRendererKey(binding.kind, binding.placement),
+        binding.render,
+    ]));
+}
+export function createNavigationShellSlotRendererKey(kind, placement) {
+    return `${normalizeNavigationShellSlotKind(kind)}:${placement == null
+        ? navigationShellSlotAnyPlacement
+        : normalizeNavigationShellSlotPlacement(placement)}`;
+}
+export function getNavigationShellSlotRendererRegistryKeys(registry) {
+    return Object.keys(registry ?? {});
+}
+export function getNavigationShellSlotRendererCandidateKeys(slot) {
+    return [
+        createNavigationShellSlotRendererKey(slot.Kind, slot.Placement),
+        createNavigationShellSlotRendererKey(slot.Kind),
+    ];
+}
+export function hasNavigationShellSlotRendererBinding(keys, slot) {
+    return getNavigationShellSlotRendererCandidateKeys(slot).some((key) => keys.includes(key));
+}
+export function resolveNavigationShellSlotRenderer(registry, slot) {
+    const renderers = registry ?? {};
+    for (const key of getNavigationShellSlotRendererCandidateKeys(slot)) {
+        const renderer = renderers[key];
+        if (renderer !== undefined && renderer !== null) {
+            return renderer;
+        }
+    }
+    return null;
+}
+function normalizeNavigationShellSlotKind(value) {
+    return normalizeGeneratedEnumToken(value, navigationShellSlotKindLabels);
+}
+function normalizeNavigationShellSlotPlacement(value) {
+    return String(value).replace(/[^a-z0-9]/gi, '').toLocaleLowerCase();
+}
+function normalizeGeneratedEnumToken(value, labels) {
+    const label = typeof value === 'number'
+        ? labels[value] ?? String(value)
+        : String(value);
+    return label.replace(/[^a-z0-9]/gi, '').toLocaleLowerCase();
+}
+//# sourceMappingURL=navigation-shell-slot-renderer-registry.js.map

package/dist/navigation-shell-slot-renderer-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-shell-slot-renderer-registry.js","sourceRoot":"","sources":["../src/navigation-shell-slot-renderer-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,GAG9B,MAAM,yCAAyC,CAAA;AAEhD,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAA;AAYlD,MAAM,UAAU,yCAAyC,CACvD,QAAkE;IAElE,OAAO,MAAM,CAAC,WAAW,CACvB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACxB,oCAAoC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC;QACrE,OAAO,CAAC,MAAM;KACf,CAAC,CACH,CAAA;AACH,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,IAA+C,EAC/C,SAAkC;IAElC,OAAO,GAAG,gCAAgC,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,IAAI;QACnE,CAAC,CAAC,+BAA+B;QACjC,CAAC,CAAC,qCAAqC,CAAC,SAAS,CAAC,EAAE,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,QAAgE;IAEhE,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,2CAA2C,CACzD,IAAmC;IAEnC,OAAO;QACL,oCAAoC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;QAC/D,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC;KAChD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,IAAuB,EACvB,IAAmC;IAEnC,OAAO,2CAA2C,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACpE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,QAA2E,EAC3E,IAAmC;IAEnC,MAAM,SAAS,GAAG,QAAQ,IAAI,EAAE,CAAA;IAChC,KAAK,MAAM,GAAG,IAAI,2CAA2C,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;QAC/B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAChD,OAAO,QAAQ,CAAA;QACjB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,gCAAgC,CAAC,KAAc;IACtD,OAAO,2BAA2B,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAA;AAC1E,CAAC;AAED,SAAS,qCAAqC,CAAC,KAAc;IAC3D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAA;AACrE,CAAC;AAED,SAAS,2BAA2B,CAClC,KAAc,EACd,MAAwC;IAExC,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ;QACrC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAEjB,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAA;AAC7D,CAAC"}

package/dist/navigation.d.ts

@@ -0,0 +1,84 @@
+import type { NavigationDefinition, NavigationRouteDefinition, NavigationShellRegionDefinition, PageHostDefinition, PageHostKind } from '@cohesivesystems/presentation-contracts';
+/**
+ * Primitive parameter bag used when resolving semantic navigation route
+ * templates into concrete hrefs.
+ */
+export type NavigationRouteParameters = Record<string, boolean | number | string | null | undefined>;
+/**
+ * Resolves a semantic route id and optional route parameters into a concrete
+ * href, or `null` when the route cannot be represented for the active
+ * navigation definition.
+ */
+export type PresentationNavigationHrefFactory = (routeId: string, parameters?: NavigationRouteParameters) => string | null;
+/**
+ * Executes navigation to a concrete href that has already been resolved from a
+ * presentation navigation route.
+ *
+ * The href may be absolute, root-relative, or application-relative depending on
+ * the active host router binding.
+ */
+export type PresentationHrefNavigator = (href: string) => void;
+/**
+ * Executes navigation by semantic route id using the active presentation
+ * navigation definition.
+ *
+ * Implementations are responsible for resolving route parameters into a href
+ * and ignoring navigation when the route cannot be resolved.
+ */
+export type PresentationRouteNavigator = (routeId: string, parameters?: NavigationRouteParameters) => void;
+/**
+ * Runtime navigation services exposed to projected presentation components.
+ *
+ * This keeps projected components coupled to Cohesive navigation semantics
+ * rather than to a concrete host router such as React Router.
+ */
+export interface PresentationNavigationRuntime {
+    /** Resolves a semantic route id and optional parameters into a concrete href. */
+    readonly createHref: PresentationNavigationHrefFactory;
+    /** Navigates to an already resolved href in the active host application. */
+    readonly navigateHref: PresentationHrefNavigator;
+    /** Resolves and navigates to a semantic route in the active host application. */
+    readonly navigateRoute: PresentationRouteNavigator;
+}
+export type NavigationDefinitionProjection<TRoute extends NavigationRouteDefinition = NavigationRouteDefinition, TPageHost extends PageHostDefinition = PageHostDefinition> = Omit<NavigationDefinition, 'PageHosts' | 'Routes'> & {
+    readonly Routes: readonly TRoute[];
+    readonly PageHosts: readonly TPageHost[];
+};
+export declare function createNavigationHref<TRoute extends NavigationRouteDefinition>(navigation: NavigationDefinitionProjection<TRoute>, routeId: string, parameters?: NavigationRouteParameters): string | null;
+export declare function findNavigationRoute<TRoute extends NavigationRouteDefinition>(navigation: Pick<NavigationDefinitionProjection<TRoute>, 'Routes'>, routeId: string): TRoute | null;
+export declare function findNavigationPageHost<TPageHost extends PageHostDefinition>(navigation: Pick<NavigationDefinitionProjection<NavigationRouteDefinition, TPageHost>, 'PageHosts'>, pageHostId: string): TPageHost | null;
+export declare function createNavigationRoute({ id, kind, label, pageHostId, parameterName, pathTemplate, parameterType, }: {
+    readonly id: string;
+    readonly kind?: NavigationRouteDefinition['Kind'];
+    readonly label?: string;
+    readonly pageHostId: string;
+    readonly parameterName?: string;
+    readonly parameterType?: string;
+    readonly pathTemplate: string;
+}): NavigationRouteDefinition;
+export declare function createPageHost({ id, kind, viewId, }: {
+    readonly id: string;
+    readonly kind?: PageHostKind;
+    readonly viewId: string;
+}): PageHostDefinition;
+export declare function createWorkspacePageHost({ documentProfileId, id, viewId, workspaceId, }: {
+    readonly documentProfileId: string;
+    readonly id: string;
+    readonly viewId: string;
+    readonly workspaceId: string;
+}): PageHostDefinition;
+export declare function hasNavigationShellRegion(navigation: Pick<NavigationDefinition, 'Shell'> | null, regionId: string): boolean;
+export declare function getNavigationShellRegions(navigation: Pick<NavigationDefinition, 'Shell'> | null, options?: {
+    readonly placement?: string;
+    readonly regionIds?: readonly string[];
+}): readonly NavigationShellRegionDefinition[];
+export declare function resolveNavigationRouteId(navigation: Pick<NavigationDefinitionProjection, 'Routes'> | null, pathname: string): string | null;
+export declare function shouldUseNavigationRouteTransitions(navigation: Pick<NavigationDefinition, 'Contexts'> | null): boolean;
+export declare function createNavigationRouteInstanceKey(navigation: Pick<NavigationDefinitionProjection, 'Contexts' | 'Routes'> | null, location: {
+    readonly hash?: string;
+    readonly pathname: string;
+    readonly search?: string;
+}): string;
+export declare function doesRouteTemplateMatch(pathname: string, template: string): boolean;
+export declare function toPathSegments(path: string): string[];
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

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

package/dist/navigation.js

@@ -0,0 +1,167 @@
+import { layoutNodeKinds, layoutOrientations, navigationContextKinds, navigationHistoryKinds, navigationRouteInstanceIdentityKinds, navigationRouteKinds, navigationRouteUpdateModes, pageHostKinds, pageRegionKinds, workspaceInstantiationModes, } from '@cohesivesystems/presentation-contracts';
+export function createNavigationHref(navigation, routeId, parameters) {
+    const route = findNavigationRoute(navigation, routeId);
+    if (!route) {
+        return null;
+    }
+    let href = route.PathTemplate;
+    for (const parameter of route.Parameters) {
+        const token = `{${parameter.Name}}`;
+        if (!href.includes(token)) {
+            continue;
+        }
+        const value = parameters?.[parameter.Name];
+        if (value === null || value === undefined || String(value).length === 0) {
+            if (parameter.IsRequired) {
+                return null;
+            }
+            continue;
+        }
+        href = href.replace(token, encodeURIComponent(String(value)));
+    }
+    return /\{[^}]+\}/.test(href) ? null : href;
+}
+export function findNavigationRoute(navigation, routeId) {
+    return navigation.Routes.find((route) => route.Id === routeId) ?? null;
+}
+export function findNavigationPageHost(navigation, pageHostId) {
+    return navigation.PageHosts?.find((pageHost) => pageHost.Id === pageHostId) ?? null;
+}
+export function createNavigationRoute({ id, kind, label, pageHostId, parameterName, pathTemplate, parameterType = 'string', }) {
+    return {
+        Id: id,
+        Kind: kind ?? (parameterName
+            ? navigationRouteKinds.entityDetail
+            : navigationRouteKinds.page),
+        Label: label ?? createNavigationLabel(id),
+        PageHostId: pageHostId,
+        Parameters: parameterName
+            ? [{ IsRequired: true, Name: parameterName, Type: parameterType }]
+            : [],
+        PathTemplate: pathTemplate,
+    };
+}
+export function createPageHost({ id, kind = pageHostKinds.singleView, viewId, }) {
+    return {
+        Annotations: [],
+        Id: id,
+        Kind: kind,
+        Layout: createSingleViewPageHostLayout(viewId),
+        Regions: [
+            {
+                Annotations: [],
+                Id: 'content',
+                Kind: pageRegionKinds.content,
+                Name: 'Content',
+                PageHostIds: [],
+                Placement: 'main',
+                ProjectionIds: [],
+                ViewIds: [viewId],
+            },
+        ],
+        State: null,
+        View: { Annotations: [], ViewId: viewId },
+        Workspace: null,
+    };
+}
+export function createWorkspacePageHost({ documentProfileId, id, viewId, workspaceId, }) {
+    return {
+        ...createPageHost({ id, kind: pageHostKinds.workspace, viewId }),
+        Workspace: {
+            DocumentProfileId: documentProfileId,
+            DocumentBinding: null,
+            InitialProjectionIds: [],
+            Instantiation: workspaceInstantiationModes.shared,
+            LayoutProfileId: null,
+            WorkspaceId: workspaceId,
+        },
+    };
+}
+export function hasNavigationShellRegion(navigation, regionId) {
+    return navigation?.Shell.Regions.some((region) => region.Id === regionId) ?? false;
+}
+export function getNavigationShellRegions(navigation, options = {}) {
+    const regionIds = options.regionIds ? new Set(options.regionIds) : null;
+    return navigation?.Shell.Regions.filter((region) => (!options.placement || region.Placement === options.placement) &&
+        (!regionIds || regionIds.has(region.Id))) ?? [];
+}
+export function resolveNavigationRouteId(navigation, pathname) {
+    if (!navigation) {
+        return null;
+    }
+    return (navigation.Routes.find((route) => doesRouteTemplateMatch(pathname, route.PathTemplate))?.Id ?? null);
+}
+export function shouldUseNavigationRouteTransitions(navigation) {
+    return (resolveNavigationHistory(navigation)?.RouteUpdateMode ??
+        navigationRouteUpdateModes.transition) !== navigationRouteUpdateModes.synchronous;
+}
+export function createNavigationRouteInstanceKey(navigation, location) {
+    const identity = resolveNavigationHistory(navigation)?.RouteInstanceIdentity ??
+        navigationRouteInstanceIdentityKinds.matchedRoute;
+    switch (identity) {
+        case navigationRouteInstanceIdentityKinds.fullLocation:
+            return `${location.pathname}${location.search ?? ''}${location.hash ?? ''}`;
+        case navigationRouteInstanceIdentityKinds.pathAndSearch:
+            return `${location.pathname}${location.search ?? ''}`;
+        case navigationRouteInstanceIdentityKinds.path:
+            return location.pathname;
+        case navigationRouteInstanceIdentityKinds.matchedRoute:
+        default:
+            return resolveNavigationRouteId(navigation, location.pathname) ?? location.pathname;
+    }
+}
+function resolveNavigationHistory(navigation) {
+    return (navigation?.Contexts.find((context) => context.Kind === navigationContextKinds.browser &&
+        context.History.Kind === navigationHistoryKinds.browser)?.History ??
+        navigation?.Contexts.find((context) => context.Kind === navigationContextKinds.browser)
+            ?.History ??
+        navigation?.Contexts[0]?.History ??
+        null);
+}
+export function doesRouteTemplateMatch(pathname, template) {
+    const pathSegments = toPathSegments(pathname);
+    const templateSegments = toPathSegments(template);
+    if (pathSegments.length !== templateSegments.length) {
+        return false;
+    }
+    for (let index = 0; index < templateSegments.length; index += 1) {
+        const templateSegment = templateSegments[index];
+        if (templateSegment.startsWith('{') && templateSegment.endsWith('}')) {
+            continue;
+        }
+        if (templateSegment !== pathSegments[index]) {
+            return false;
+        }
+    }
+    return true;
+}
+export function toPathSegments(path) {
+    const pathname = path.split(/[?#]/)[0] ?? '/';
+    if (pathname === '/') {
+        return [];
+    }
+    return pathname.replace(/^\/+|\/+$/g, '').split('/').filter(Boolean);
+}
+function createSingleViewPageHostLayout(viewId) {
+    return {
+        DefaultRegionId: 'content',
+        Root: {
+            Children: [],
+            Id: 'content',
+            Kind: layoutNodeKinds.view,
+            Orientation: layoutOrientations.none,
+            Placement: 'main',
+            ProjectionIds: [],
+            Size: null,
+            ViewIds: [viewId],
+        },
+    };
+}
+function createNavigationLabel(id) {
+    return id
+        .split(/[-_.\s]+/)
+        .filter(Boolean)
+        .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
+        .join(' ');
+}
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

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

package/dist/object-path.d.ts

@@ -0,0 +1,23 @@
+export type ObjectPath = string;
+export interface ObjectPathOptions {
+    readonly caseInsensitive?: boolean;
+}
+/**
+ * Parses a dot-separated object path into normalized path segments.
+ */
+export declare function parseObjectPath(path: ObjectPath | null | undefined): string[];
+/**
+ * Reads a dot-separated object path.
+ *
+ * Case-insensitive segment fallback is enabled by default because generated API
+ * payload casing can differ from semantic field metadata.
+ */
+export declare function readObjectPath(value: unknown, path: ObjectPath | null | undefined, options?: ObjectPathOptions): unknown;
+export declare function readObjectProperty(value: unknown, propertyName: string, options?: ObjectPathOptions): unknown;
+/**
+ * Writes a value to a dot-separated object path, creating object parents as
+ * needed. Empty paths are ignored.
+ */
+export declare function writeObjectPath(target: Record<string, unknown>, path: ObjectPath | null | undefined, value: unknown): void;
+export declare function writeObjectPathIfDefined(target: Record<string, unknown>, path: ObjectPath | null | undefined, value: unknown): void;
+//# sourceMappingURL=object-path.d.ts.map

package/dist/object-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-path.d.ts","sourceRoot":"","sources":["../src/object-path.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAE/B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CACnC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,YAElE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACnC,OAAO,GAAE,iBAAsB,WAahC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,iBAAsB,WAmBhC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACnC,KAAK,EAAE,OAAO,QAkBf;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACnC,KAAK,EAAE,OAAO,QAOf"}

package/dist/object-path.js

@@ -0,0 +1,63 @@
+/**
+ * Parses a dot-separated object path into normalized path segments.
+ */
+export function parseObjectPath(path) {
+    return (path ?? '').split('.').map((segment) => segment.trim()).filter(Boolean);
+}
+/**
+ * Reads a dot-separated object path.
+ *
+ * Case-insensitive segment fallback is enabled by default because generated API
+ * payload casing can differ from semantic field metadata.
+ */
+export function readObjectPath(value, path, options = {}) {
+    if (path === null || path === undefined) {
+        return undefined;
+    }
+    if (path === '') {
+        return value;
+    }
+    return parseObjectPath(path).reduce((current, segment) => {
+        return readObjectProperty(current, segment, options);
+    }, value);
+}
+export function readObjectProperty(value, propertyName, options = {}) {
+    if (value === null || value === undefined || typeof value !== 'object') {
+        return undefined;
+    }
+    const record = value;
+    if (Object.prototype.hasOwnProperty.call(record, propertyName)) {
+        return record[propertyName];
+    }
+    if (options.caseInsensitive === false) {
+        return undefined;
+    }
+    const match = Object.keys(record).find((candidate) => candidate.toLocaleLowerCase() === propertyName.toLocaleLowerCase());
+    return match ? record[match] : undefined;
+}
+/**
+ * Writes a value to a dot-separated object path, creating object parents as
+ * needed. Empty paths are ignored.
+ */
+export function writeObjectPath(target, path, value) {
+    const segments = parseObjectPath(path);
+    if (segments.length === 0) {
+        return;
+    }
+    let current = target;
+    for (const segment of segments.slice(0, -1)) {
+        const next = current[segment];
+        if (!next || typeof next !== 'object' || Array.isArray(next)) {
+            current[segment] = {};
+        }
+        current = current[segment];
+    }
+    current[segments[segments.length - 1]] = value;
+}
+export function writeObjectPathIfDefined(target, path, value) {
+    if (value === undefined || !path) {
+        return;
+    }
+    writeObjectPath(target, path, value);
+}
+//# sourceMappingURL=object-path.js.map

package/dist/object-path.js.map

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

package/dist/page-host-renderer-registry.d.ts

@@ -0,0 +1,119 @@
+import { type NavigationRouteDefinition, type PageHostDefinition, type PresentationBindingDefinition, type ViewDefinition } from '@cohesivesystems/presentation-contracts';
+import { type PresentationEnumDiscriminator } from './target-bindings.js';
+/**
+ * Minimal presentation module shape needed to resolve page-host renderer
+ * defaults and target bindings. Apps can pass richer generated module types as
+ * long as they expose these structural members.
+ */
+export interface PresentationPageHostRendererModuleProjection {
+    /** Target adapter bindings, including optional PageHostComponent bindings. */
+    readonly Targets?: readonly {
+        readonly Bindings: readonly PresentationBindingDefinition[];
+        readonly ComponentSet?: string | null;
+        readonly Target: string | number;
+    }[];
+    /** Presentation views used to infer semantic roles and view-kind defaults. */
+    readonly Views?: readonly ViewDefinition[];
+    /** Workspaces used to distinguish generic workspaces from document workspaces. */
+    readonly Workspaces?: readonly {
+        readonly DocumentProfiles?: readonly unknown[];
+        readonly Id: string;
+    }[];
+}
+export declare const presentationPageHostComponentRoles: {
+    readonly documentWorkspace: "cohesive.presentation.page-host.document-workspace";
+    readonly routedSurface: "cohesive.presentation.page-host.routed-surface";
+};
+/**
+ * Ordered registry of page-host renderer overrides and defaults. Resolution
+ * prefers semantic page-host shape first: workspace defaults, root-view semantic
+ * roles, view kinds, and target-declared component roles. Id and component-key
+ * bindings remain available as explicit escape hatches for hosts not yet
+ * modeled by first-class IR semantics.
+ */
+export interface PageHostRendererRegistry<TRenderer = unknown> {
+    /** Renderers keyed by concrete adapter component keys. */
+    readonly byComponentKey?: Readonly<Record<string, TRenderer>>;
+    /** Renderers keyed by semantic adapter component roles. */
+    readonly byComponentRole?: Readonly<Record<string, TRenderer>>;
+    /** Exact page-host id overrides. These win over route and workspace matches. */
+    readonly byPageHostId?: Readonly<Record<string, TRenderer>>;
+    /** Renderers keyed by semantic role, such as `surface-root`. */
+    readonly bySemanticRole?: Readonly<Record<string, TRenderer>>;
+    /** Exact route id overrides. Useful when multiple routes share a page host. */
+    readonly byRouteId?: Readonly<Record<string, TRenderer>>;
+    /** Exact root-view id overrides for page hosts that mount a view. */
+    readonly byViewId?: Readonly<Record<string, TRenderer>>;
+    /** Renderers keyed by generated `ViewKind` value or compatible string form. */
+    readonly byViewKind?: Readonly<Record<string, TRenderer>>;
+    /** Exact workspace id overrides for workspace-backed page hosts. */
+    readonly byWorkspaceId?: Readonly<Record<string, TRenderer>>;
+    /** Last-resort renderer when no explicit or inferred renderer matches. */
+    readonly fallback?: TRenderer;
+}
+/**
+ * Convenience registry type for apps that use the standard generated
+ * navigation, route, and page-host shapes.
+ */
+export type SimplePageHostRendererRegistry<TRenderer = unknown> = PageHostRendererRegistry<TRenderer>;
+/**
+ * Describes which resolution branch selected a page-host renderer. These
+ * values are intentionally stable because projection diagnostics display them.
+ */
+export type PageHostRendererResolutionSource = 'component-key' | 'component-role' | 'fallback' | 'page-host-id' | 'route-id' | 'semantic-role' | 'view-id' | 'view-kind' | 'workspace-id';
+/**
+ * Result of resolving a page-host renderer. The resolution includes both the
+ * selected renderer and the semantic facts used for diagnostics and tracing.
+ */
+export interface PageHostRendererResolution<TRenderer = unknown> {
+    /** Effective component key after caller and target bindings are considered. */
+    readonly componentKey: string | null;
+    /** Effective component role after caller and target bindings are considered. */
+    readonly componentRole: string | null;
+    /** Renderer selected from the registry, or null when no renderer matched. */
+    readonly renderer: TRenderer | null;
+    /** Registry branch or target binding source that selected the renderer. */
+    readonly resolutionSource: PageHostRendererResolutionSource | null;
+    /**
+     * Legacy renderer key declared by a target binding, when present. Page-host
+     * dispatch no longer consumes renderer keys; this value is retained only so
+     * diagnostics can point at unprojected legacy IR.
+     */
+    readonly rendererKey: string | null;
+    /** Semantic role inferred from the root view, when available. */
+    readonly semanticRole: string | null;
+    /** Target-binding source that supplied a role, key, or renderer key, when any. */
+    readonly targetBindingSource: PageHostTargetBindingSource | null;
+    /** Root view mounted by the page host, when the page host references one. */
+    readonly view: ViewDefinition | null;
+}
+/**
+ * Resolves a page-host renderer without rendering it.
+ *
+ * Resolution order is:
+ * semantic role, component role, view kind, component key, explicit id
+ * overrides, fallback. Id and component-key branches are treated as escape
+ * hatches by diagnostics.
+ */
+export declare function resolvePageHostRenderer<TRenderer, TModule extends PresentationPageHostRendererModuleProjection = PresentationPageHostRendererModuleProjection, TRoute extends NavigationRouteDefinition = NavigationRouteDefinition, TPageHost extends PageHostDefinition = PageHostDefinition>({ componentKey, componentRole, componentSet, module, pageHost, registry, route, targetKind, }: {
+    readonly componentKey?: string | null;
+    readonly componentRole?: string | null;
+    readonly componentSet?: string | null;
+    readonly module: TModule;
+    readonly pageHost: TPageHost | null;
+    readonly registry: PageHostRendererRegistry<TRenderer>;
+    readonly route?: TRoute | null;
+    readonly targetKind?: PresentationEnumDiscriminator | null;
+}): PageHostRendererResolution<TRenderer>;
+/**
+ * Infers the standard component role for a page host from its workspace and
+ * root view semantics. Target bindings can override this when a host needs a
+ * more specific frontend interpretation.
+ */
+export declare function resolveDefaultPresentationPageHostComponentRole({ module, pageHost, view, }: {
+    readonly module: PresentationPageHostRendererModuleProjection;
+    readonly pageHost: PageHostDefinition | null;
+    readonly view: ViewDefinition | null;
+}): string | null;
+export type PageHostTargetBindingSource = 'target-page-host-binding' | 'target-route-binding' | 'target-view-binding' | 'target-workspace-binding';
+//# sourceMappingURL=page-host-renderer-registry.d.ts.map

package/dist/page-host-renderer-registry.d.ts.map

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