@cohesivesystems/presentation-core 0.1.0-alpha.1

package/src/field-display-resolution.ts

@@ -0,0 +1,99 @@
+import type {
+  FieldPresentationDefinition,
+  FieldValueIconDefinition,
+  FieldValueLabelDefinition,
+  FieldValueToneDefinition,
+} from './module'
+import {
+  readObjectPath,
+} from './object-path'
+
+export function resolvePresentationFieldValueLabel(
+  field: FieldPresentationDefinition | null | undefined,
+  value: unknown,
+) {
+  return readDisplayValueLabel(field?.Display?.ValueLabels, value)
+}
+
+export function resolvePresentationFieldValueTone(
+  field: FieldPresentationDefinition | null | undefined,
+  value: unknown,
+  resource?: unknown,
+) {
+  return (
+    readFirstDisplayFieldPathValue(field?.Display?.ToneFieldPaths, resource) ??
+    readDisplayValueTone(field?.Display?.ValueTones, value) ??
+    field?.Display?.Tone ??
+    null
+  )
+}
+
+export function resolvePresentationFieldValueIcon(
+  field: FieldPresentationDefinition | null | undefined,
+  value: unknown,
+) {
+  return readDisplayValueIcon(field?.Display?.ValueIcons, value)
+}
+
+function readDisplayValueLabel(
+  labels: readonly FieldValueLabelDefinition[] | null | undefined,
+  value: unknown,
+) {
+  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: readonly FieldValueToneDefinition[] | null | undefined,
+  value: unknown,
+) {
+  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: readonly FieldValueIconDefinition[] | null | undefined,
+  value: unknown,
+) {
+  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: readonly string[] | null | undefined,
+  resource: unknown,
+) {
+  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
+}

package/src/index.ts

@@ -0,0 +1,104 @@
+export * from './api-scope-request'
+export * from './collection-chrome-runtime'
+export * from './collection-chrome-icons'
+export {
+  collectionChromeSlotAnyPlacement,
+  createCollectionChromeSlotRendererKey,
+  createCollectionChromeSlotRendererRegistry,
+  getCollectionChromeSlotRendererCandidateKeys,
+  getCollectionChromeSlotRendererRegistryKeys,
+  hasCollectionChromeSlotRendererBinding,
+  isCollectionChromeSlotKind,
+  isCollectionChromeSlotPlacement,
+  isCollectionChromeSlotPlacementValue,
+  resolveCollectionChromeSlotRenderer,
+} from './collection-chrome-slot-renderer-registry'
+export type {
+  CollectionChromeSlotRenderer,
+  CollectionChromeSlotRendererBinding,
+  CollectionChromeSlotRendererRegistry,
+} from './collection-chrome-slot-renderer-registry'
+export * from './collection-selection-state'
+export * from './data-source-projection'
+export * from './data-source-query-lowering'
+export * from './date-time-filter-model'
+export * from './document-module'
+export * from './document-badge-icons'
+export * from './document-summary-model'
+export * from './document-workspace-chrome-projection'
+export * from './document-workspace-surface-slots'
+export * from './endpoint-executor'
+export * from './field-display-resolution'
+export * from './module'
+export * from './navigation'
+export * from './navigation-shell-frame-renderer-registry'
+export * from './navigation-shell-layout-runtime'
+export * from './navigation-shell-region-component-registry'
+export * from './navigation-shell-runtime'
+export * from './navigation-shell-slot-renderer-registry'
+export * from './object-path'
+export * from './page-host-renderer-registry'
+export * from './presentation-action-icons'
+export * from './presentation-action-endpoint'
+export * from './presentation-action-endpoint-request-projection'
+export * from './presentation-action-result-state'
+export * from './presentation-action-runtime-binding'
+export * from './presentation-action-runtime-diagnostics'
+export * from './presentation-action-runtime-labels'
+export * from './presentation-action-runtime-projection'
+export * from './presentation-badge-resolution'
+export * from './presentation-collection-pagination'
+export * from './presentation-content-resolution'
+export * from './presentation-content-diagnostics'
+export * from './presentation-data-source-binding-model'
+export * from './presentation-data-source-runtime'
+export * from './presentation-design-intent-diagnostics'
+export * from './presentation-icon-diagnostics'
+export * from './presentation-icon-registry'
+export * from './presentation-navigation-action-runtime-bindings'
+export * from './presentation-pagination'
+export * from './presentation-projection-diagnostics'
+export * from './presentation-projection-coverage'
+export * from './presentation-projection-trace'
+export * from './presentation-query-form-state'
+export * from './projected-query-form-runtime'
+export * from './query-form-url-state'
+export * from './presentation-renderer-registry'
+export * from './presentation-semantics'
+export * from './presentation-standards'
+export * from './presentation-test-selectors'
+export * from './presentation-value-formatting'
+export * from './presentation-value-resolution'
+export * from './presentation-view-tree'
+export * from './prompt-document-preview-projection'
+export * from './prompt-icons'
+export * from './prompt-status-message-resolution'
+export * from './projected-collection-action-runtime-bindings'
+export * from './projected-collection-action-runtime-diagnostics'
+export * from './projected-collection-runtime'
+export * from './projected-action-status-projection'
+export * from './projected-document-action-diagnostics'
+export * from './projected-document-action-enablements'
+export * from './projected-document-action-projection'
+export * from './projected-document-action-runtime-profile'
+export * from './projected-document-action-runtime-profile-diagnostics'
+export * from './projected-document-action-status-notice-diagnostics'
+export * from './projected-document-badge-formatting'
+export * from './projected-document-editor-model'
+export * from './projected-document-field-semantics'
+export * from './projected-document-field-navigation'
+export * from './projected-document-workspace-notice-diagnostics'
+export * from './projected-document-workspace-data-source-bindings'
+export * from './projected-activity-state-model'
+export * from './projected-input-form-runtime'
+export * from './projected-process-task-notice-diagnostics'
+export * from './process-task-model'
+export * from './process-task-projection'
+export * from './query-offset-page'
+export * from './query-form-lowering'
+export * from './relation-query-input-form-target'
+export * from './scope-selection'
+export * from './target-bindings'
+export * from './view-chrome-slot-renderer-registry'
+export * from './view-chrome-icons'
+export * from './view-chrome-content-diagnostics'

package/src/module.ts

@@ -0,0 +1,281 @@
+import { viewChromeSlotKinds } from '@cohesivesystems/presentation-contracts'
+import {
+  createCollectionChromeRuntime,
+  resolveCollectionChromeDataSourceIds,
+} from './collection-chrome-runtime'
+import type {
+  ActionDefinition,
+  ActionPlacementDefinition,
+  DataSourceDefinition,
+  DocumentProfileDefinition,
+  FieldPresentationDefinition,
+  FlowDefinition,
+  InputFormDefinition,
+  NavigationDefinition,
+  QueryFormDefinition,
+  TargetBindingDefinition,
+  ViewDefinition,
+  WorkspaceDefinition,
+} from '@cohesivesystems/presentation-contracts'
+
+export type {
+  ActionDefinition,
+  ActionEnablementCriterionDefinition,
+  ActionEndpointRequestProjectionDefinition,
+  ActionEndpointRequestValueBindingDefinition,
+  ActionPlacementDefinition,
+  ActionResultStateWriteDefinition,
+  CollectionChromeDefinition,
+  CollectionChromeSlotDefinition,
+  CollectionChromeSlotKind,
+  CollectionChromeSlotPlacement,
+  CollectionColumnDefinition,
+  CollectionDetailActivation,
+  CollectionRowActionDefinition,
+  CollectionRowActionParameterBindingDefinition,
+  CollectionSelectionActionDefinition,
+  CollectionSelectionActionParameterBindingDefinition,
+  CollectionSelectionActionParameterSource,
+  CollectionSelectionMode,
+  CollectionViewDefinition,
+  DataSourceDefinition,
+  DataSourceQueryDefinition,
+  DataSourceQueryEndpointBindingDefinition,
+  DataSourceQueryFieldDefinition,
+  DocumentActionStatusNoticeDefinition,
+  DocumentProcessTaskNoticeActionDefinition,
+  DocumentProcessTaskNoticeActionTargetKind,
+  DocumentProcessTaskNoticeDefinition,
+  DocumentProfileDefinition,
+  DocumentWorkspaceSurfaceSlotDefinition,
+  DocumentWorkspaceSurfaceSlotRole,
+  FieldDisplayOptions,
+  FieldEntityReferenceFallbackKind,
+  FieldJsonDisplayMode,
+  FieldPresentationDefinition,
+  FieldValueIconDefinition,
+  FieldValueLabelDefinition,
+  FieldValueToneDefinition,
+  FlowDefinition,
+  FlowStateDefinition,
+  FlowTransitionDefinition,
+  InputFormDefinition,
+  InputFormFieldDefinition,
+  InputFormGroupDefinition,
+  LayoutNodeDefinition,
+  LayoutNodeKind,
+  LayoutOrientation,
+  PresentationAnnotationDefinition,
+  PresentationBadgeDefinition,
+  PresentationBindingDefinition,
+  PresentationContentDefinition,
+  PresentationModuleDefinition,
+  PresentationValueDefinition,
+  ProcessTaskSelectorDefinition,
+  ProcessTaskSelectorMatchDefinition,
+  ProjectionDefinition,
+  PromptDismissPolicyDefinition,
+  PromptDocumentPreviewDefinition,
+  PromptStatusMessageDefinition,
+  QueryFormDefinition,
+  QueryFormUrlPolicyDefinition,
+  TargetBindingDefinition,
+  ViewChromeSlotDefinition,
+  ViewChromeSlotKind,
+  ViewChromeSlotPlacement,
+  ViewDefinition,
+  ViewRegionDefinition,
+  WorkspaceDefinition,
+  WorkspaceLayoutDefinition,
+  WorkspaceLayoutModeDefinition,
+  WorkspaceRefDefinition,
+} from '@cohesivesystems/presentation-contracts'
+
+type IdentifiedDefinition = { readonly Id: string }
+
+export function getDefaultNavigation<TNavigation extends NavigationDefinition>(
+  module: { readonly Navigation: readonly TNavigation[] } | null,
+): TNavigation | null {
+  return module?.Navigation[0] ?? null
+}
+
+export function findPresentationView<TView extends ViewDefinition>(
+  module: { readonly Views: readonly ViewDefinition[] } | null,
+  viewId: string,
+): TView | null {
+  return findById(module?.Views, viewId) as TView | null
+}
+
+export function findPresentationWorkspace<TWorkspace extends WorkspaceDefinition>(
+  module: { readonly Workspaces: readonly WorkspaceDefinition[] } | null,
+  workspaceId: string,
+): TWorkspace | null {
+  return findById(module?.Workspaces, workspaceId) as TWorkspace | null
+}
+
+export function findPresentationDocumentProfile<TProfile extends DocumentProfileDefinition>(
+  workspace: { readonly DocumentProfiles: readonly DocumentProfileDefinition[] } | null,
+  documentProfileId: string,
+): TProfile | null {
+  return findById(workspace?.DocumentProfiles, documentProfileId) as TProfile | null
+}
+
+export function findPresentationDataSource<TDataSource extends DataSourceDefinition>(
+  module: { readonly DataSources: readonly DataSourceDefinition[] } | null,
+  dataSourceId: string,
+): TDataSource | null {
+  return findById(module?.DataSources, dataSourceId) as TDataSource | null
+}
+
+export function findPresentationQueryForm<TQueryForm extends QueryFormDefinition>(
+  module: { readonly QueryForms: readonly QueryFormDefinition[] } | null,
+  queryFormId: string,
+): TQueryForm | null {
+  return findById(module?.QueryForms, queryFormId) as TQueryForm | null
+}
+
+export function findPresentationInputForm<TInputForm extends InputFormDefinition>(
+  module: { readonly InputForms: readonly InputFormDefinition[] } | null,
+  inputFormId: string,
+): TInputForm | null {
+  return findById(module?.InputForms, inputFormId) as TInputForm | null
+}
+
+export function findPresentationInputFormForView<TInputForm extends InputFormDefinition>(
+  module: {
+    readonly InputForms: readonly InputFormDefinition[]
+    readonly QueryForms: readonly QueryFormDefinition[]
+  } | null,
+  view: Pick<ViewDefinition, 'Collection' | 'DataSourceIds' | 'Subject'> | null,
+): TInputForm | null {
+  if (!view) {
+    return null
+  }
+
+  const inputFormId = view.Subject.InputFormId
+  if (inputFormId) {
+    return findPresentationInputForm<TInputForm>(module, inputFormId)
+  }
+
+  const queryFormId = view.Subject.QueryFormId
+  if (queryFormId) {
+    const queryForm = findPresentationQueryForm(module, queryFormId)
+    return queryForm
+      ? findPresentationInputForm<TInputForm>(module, queryForm.FormId)
+      : null
+  }
+
+  const formDataSourceIds = new Set([
+    ...view.DataSourceIds,
+    ...(view.Subject.DataSourceId ? [view.Subject.DataSourceId] : []),
+    ...resolveCollectionChromeDataSourceIds(view.Collection),
+  ])
+  const inputForm = module?.InputForms.find((candidate) =>
+    formDataSourceIds.has(candidate.StateDataSourceId) ||
+    formDataSourceIds.has(candidate.Target.DataSourceId ?? ''),
+  )
+  return (inputForm as TInputForm | undefined) ?? null
+}
+
+export function findPresentationQueryFormForView<TQueryForm extends QueryFormDefinition>(
+  module: {
+    readonly InputForms: readonly InputFormDefinition[]
+    readonly QueryForms: readonly QueryFormDefinition[]
+  } | null,
+  view: Pick<ViewDefinition, 'Collection' | 'DataSourceIds' | 'Subject'> | null,
+): TQueryForm | null {
+  if (!view) {
+    return null
+  }
+
+  const queryFormId = view.Subject.QueryFormId
+  if (queryFormId) {
+    return findPresentationQueryForm<TQueryForm>(module, queryFormId)
+  }
+
+  const collectionQueryFormId = createCollectionChromeRuntime(view.Collection).queryFormSlot
+    ?.QueryFormId
+  if (collectionQueryFormId) {
+    return findPresentationQueryForm<TQueryForm>(module, collectionQueryFormId)
+  }
+
+  const queryDataSourceIds = new Set([
+    ...view.DataSourceIds,
+    ...(view.Subject.DataSourceId ? [view.Subject.DataSourceId] : []),
+    ...resolveCollectionChromeDataSourceIds(view.Collection),
+  ])
+  const queryForm = module?.QueryForms.find((candidate) =>
+    queryDataSourceIds.has(candidate.Target.State.DraftDataSourceId) ||
+    queryDataSourceIds.has(candidate.Target.State.ResultDataSourceId) ||
+    queryDataSourceIds.has(candidate.Target.Result.DataSourceId) ||
+    queryDataSourceIds.has(findPresentationInputForm(module, candidate.FormId)?.StateDataSourceId ?? ''),
+  )
+  return (queryForm as TQueryForm | undefined) ?? null
+}
+
+export function findPresentationAction<TAction extends ActionDefinition>(
+  module: { readonly Actions: readonly ActionDefinition[] } | null,
+  actionId: string,
+): TAction | null {
+  return findById(module?.Actions, actionId) as TAction | null
+}
+
+export function findPresentationFlow<TFlow extends FlowDefinition>(
+  module: { readonly Flows: readonly FlowDefinition[] } | null,
+  flowId: string,
+): TFlow | null {
+  return findById(module?.Flows, flowId) as TFlow | null
+}
+
+export function findPresentationField<TField extends FieldPresentationDefinition>(
+  module: { readonly Fields: readonly FieldPresentationDefinition[] } | null,
+  fieldId: string,
+): TField | null {
+  return findById(module?.Fields, fieldId) as TField | null
+}
+
+export function findPresentationFieldByFieldPath<TField extends FieldPresentationDefinition>(
+  module: { readonly Fields: readonly FieldPresentationDefinition[] } | null,
+  field: string,
+): TField | null {
+  const match = module?.Fields.find((candidate) => candidate.Field === field)
+  return (match as TField | undefined) ?? null
+}
+
+export function findPresentationTargetBinding<TTarget extends TargetBindingDefinition>(
+  module: { readonly Targets: readonly TargetBindingDefinition[] } | null,
+  targetId: string,
+): TTarget | null {
+  return findById(module?.Targets, targetId) as TTarget | null
+}
+
+export function resolvePresentationViewActionPlacements(
+  view: Pick<ViewDefinition, 'Actions' | 'Chrome'> | null,
+): readonly ActionPlacementDefinition[] {
+  const chromeActions =
+    view?.Chrome?.Slots.filter((slot) => isActionsChromeSlotKind(slot.Kind))
+      .flatMap((slot) => slot.Actions) ?? []
+  const actionPlacements = [...chromeActions, ...(view?.Actions ?? [])]
+  const seen = new Set<string>()
+
+  return actionPlacements.filter((placement) => {
+    const key = `${placement.Region}:${placement.ActionId}`
+    if (seen.has(key)) {
+      return false
+    }
+
+    seen.add(key)
+    return true
+  })
+}
+
+function findById<TDefinition extends IdentifiedDefinition>(
+  definitions: readonly TDefinition[] | null | undefined,
+  id: string,
+) {
+  return definitions?.find((definition) => definition.Id === id) ?? null
+}
+
+function isActionsChromeSlotKind(value: string | number) {
+  return value === viewChromeSlotKinds.actions || String(value).toLocaleLowerCase() === 'actions'
+}

package/src/navigation-shell-frame-renderer-registry.ts

@@ -0,0 +1,65 @@
+import {
+  navigationShellKindLabels,
+  type NavigationShellKind,
+} from '@cohesivesystems/presentation-contracts'
+
+export type NavigationShellFrameRendererRegistry<TRenderer = unknown> = Readonly<
+  Record<string, TRenderer>
+>
+
+export interface NavigationShellFrameRendererBinding<TRenderer = unknown> {
+  readonly kind: NavigationShellKind | string | number
+  readonly render: TRenderer
+}
+
+export function createNavigationShellFrameRendererRegistry<TRenderer>(
+  bindings: readonly NavigationShellFrameRendererBinding<TRenderer>[],
+): NavigationShellFrameRendererRegistry<TRenderer> {
+  return Object.fromEntries(
+    bindings.map((binding) => [
+      createNavigationShellFrameRendererKey(binding.kind),
+      binding.render,
+    ]),
+  )
+}
+
+export function createNavigationShellFrameRendererKey(
+  kind: NavigationShellKind | string | number,
+) {
+  return normalizeNavigationShellKind(kind)
+}
+
+export function getNavigationShellFrameRendererRegistryKeys(
+  registry: NavigationShellFrameRendererRegistry | null | undefined,
+) {
+  return Object.keys(registry ?? {})
+}
+
+export function hasNavigationShellFrameRendererBinding(
+  keys: readonly string[],
+  kind: NavigationShellKind | string | number,
+) {
+  return keys.includes(createNavigationShellFrameRendererKey(kind))
+}
+
+export function resolveNavigationShellFrameRenderer<TRenderer>(
+  registry: NavigationShellFrameRendererRegistry<TRenderer> | null | undefined,
+  kind: NavigationShellKind | string | number,
+) {
+  return registry?.[createNavigationShellFrameRendererKey(kind)] ?? null
+}
+
+function normalizeNavigationShellKind(value: unknown) {
+  return normalizeGeneratedEnumToken(value, navigationShellKindLabels)
+}
+
+function normalizeGeneratedEnumToken(
+  value: unknown,
+  labels: Readonly<Record<number, string>>,
+) {
+  const label = typeof value === 'number'
+    ? labels[value] ?? String(value)
+    : String(value)
+
+  return label.replace(/[^a-z0-9]/gi, '').toLocaleLowerCase()
+}

package/src/navigation-shell-layout-runtime.ts

@@ -0,0 +1,124 @@
+import {
+  navigationShellKindLabels,
+  navigationShellSlotKinds,
+  type NavigationDefinition,
+  type NavigationShellSlotDefinition,
+} from '@cohesivesystems/presentation-contracts'
+import {
+  hasNavigationShellFrameRendererBinding,
+} from './navigation-shell-frame-renderer-registry'
+import {
+  findNavigationShellSlot,
+  isNavigationShellSlotKind,
+} from './navigation-shell-runtime'
+import {
+  createPresentationProjectionDiagnostic,
+  type PresentationProjectionDiagnostic,
+} from './presentation-projection-diagnostics'
+
+export interface ProjectedNavigationShellLayout<
+  TFrameLayout = unknown,
+  TSlotLayout = unknown,
+> {
+  readonly brandSlot: NavigationShellSlotDefinition | null
+  readonly frame: TFrameLayout
+  readonly primaryNavigationSlot: NavigationShellSlotDefinition | null
+  readonly routedContentSlot: NavigationShellSlotDefinition | null
+  readonly slotLayouts: Readonly<Record<string, TSlotLayout>>
+  readonly shellSlots: readonly NavigationShellSlotDefinition[]
+  readonly systemNoticeSlots: readonly NavigationShellSlotDefinition[]
+  readonly utilityActionSlots: readonly NavigationShellSlotDefinition[]
+}
+
+export interface ResolveProjectedNavigationShellLayoutOptions<
+  TFrameLayout,
+  TSlotLayout,
+> {
+  readonly navigation: NavigationDefinition
+  readonly resolveFrameLayout: (navigation: NavigationDefinition) => TFrameLayout
+  readonly resolveSlotLayout: (slot: NavigationShellSlotDefinition) => TSlotLayout
+  readonly shellSlots: readonly NavigationShellSlotDefinition[]
+}
+
+export interface NavigationShellLayoutDiagnosticsOptions {
+  readonly navigation: NavigationDefinition
+  readonly shellFrameRendererKeys?: readonly string[]
+}
+
+/**
+ * Groups semantic shell slots and lets adapters attach their own layout
+ * interpretation without making core depend on CSS, React, or Tailwind.
+ */
+export function resolveProjectedNavigationShellLayout<
+  TFrameLayout,
+  TSlotLayout,
+>({
+  navigation,
+  resolveFrameLayout,
+  resolveSlotLayout,
+  shellSlots,
+}: ResolveProjectedNavigationShellLayoutOptions<
+  TFrameLayout,
+  TSlotLayout
+>): ProjectedNavigationShellLayout<TFrameLayout, TSlotLayout> {
+  return {
+    brandSlot: findNavigationShellSlot(shellSlots, navigationShellSlotKinds.brand, 'Brand'),
+    frame: resolveFrameLayout(navigation),
+    primaryNavigationSlot: findNavigationShellSlot(
+      shellSlots,
+      navigationShellSlotKinds.primaryNavigation,
+      'PrimaryNavigation',
+    ),
+    routedContentSlot: findNavigationShellSlot(
+      shellSlots,
+      navigationShellSlotKinds.routedContent,
+      'RoutedContent',
+    ),
+    slotLayouts: Object.fromEntries(
+      shellSlots.map((slot) => [slot.Id, resolveSlotLayout(slot)]),
+    ),
+    shellSlots,
+    systemNoticeSlots: shellSlots.filter((slot) =>
+      isNavigationShellSlotKind(slot, navigationShellSlotKinds.systemNotices, 'SystemNotices')),
+    utilityActionSlots: shellSlots.filter((slot) =>
+      isNavigationShellSlotKind(slot, navigationShellSlotKinds.utilityActions, 'UtilityActions')),
+  }
+}
+
+export function projectNavigationShellLayoutDiagnostics({
+  navigation,
+  shellFrameRendererKeys,
+}: NavigationShellLayoutDiagnosticsOptions): readonly PresentationProjectionDiagnostic[] {
+  if (
+    !shellFrameRendererKeys ||
+    hasNavigationShellFrameRendererBinding(shellFrameRendererKeys, navigation.Shell.Kind)
+  ) {
+    return []
+  }
+
+  const kindLabel =
+    navigationShellKindLabels[navigation.Shell.Kind] ?? String(navigation.Shell.Kind)
+
+  return [
+    createPresentationProjectionDiagnostic({
+      category: 'missing-binding',
+      details: {
+        kind: navigation.Shell.Kind,
+        kindLabel,
+      },
+      id: `navigation-shell.${navigation.Shell.Id}.frame.missing-renderer`,
+      interpretation: {
+        status: 'unbound',
+        target: 'navigation-shell',
+      },
+      message: `Navigation shell '${navigation.Shell.Id}' has no frontend frame renderer for kind '${kindLabel}'.`,
+      severity: 'warning',
+      source: `navigation-shell:${navigation.Shell.Id}`,
+      subject: {
+        id: navigation.Shell.Id,
+        kind: 'NavigationShellDefinition',
+      },
+      suggestedNextStep: 'Register a shell frame renderer for this shell kind.',
+    }),
+  ]
+}