@cohesivesystems/presentation-react-shadcn 0.1.0-alpha.1

package/src/projected-document-workspace-notices.tsx

@@ -0,0 +1,77 @@
+import type { PresentationDesignSystem } from '@cohesivesystems/presentation-tailwind'
+import type {
+  DocumentProfileProjection,
+  ProcessTask,
+  ProcessTaskSelector,
+  ProcessTaskSelectorDefinition,
+  ProjectedDocumentActionStatusMap,
+} from '@cohesivesystems/presentation-core'
+import type {
+  PresentationShadcnComponentSystem as PresentationComponentSystem,
+} from './presentation-shadcn-component-system'
+import {
+  ProjectedDocumentActionStatusNotices,
+} from './projected-document-action-status-notices'
+import {
+  ProjectedProcessTaskNotices,
+  type ProjectedProcessTaskNoticeRenderer,
+} from './projected-process-task-notices'
+
+export interface ProjectedDocumentWorkspaceNoticesProps<TContext> {
+  readonly actionStatuses: ProjectedDocumentActionStatusMap
+  readonly componentSystem: PresentationComponentSystem
+  readonly context: TContext
+  readonly designSystem: PresentationDesignSystem
+  readonly findActiveTask?: (selector: ProcessTaskSelector) => ProcessTask | null
+  readonly profile: Pick<
+    DocumentProfileProjection,
+    'ActionStatusNotices' | 'ProcessTaskNotices' | 'ProcessTaskSelectors'
+  > | null
+  readonly projectSelector: (
+    selector: ProcessTaskSelectorDefinition | null | undefined,
+    context: TContext,
+  ) => ProcessTaskSelector | null
+  readonly region?: string
+  readonly renderProcessTaskNotice?: ProjectedProcessTaskNoticeRenderer
+}
+
+/**
+ * Projects all document-profile notices for a workspace chrome region.
+ *
+ * Action status notices are rendered by the shared presentation layer. Process
+ * task notices resolve from IR selectors here, then delegate their concrete
+ * visual interpretation to the host adapter.
+ */
+export function ProjectedDocumentWorkspaceNotices<TContext>({
+  actionStatuses,
+  componentSystem,
+  context,
+  designSystem,
+  findActiveTask,
+  profile,
+  projectSelector,
+  region,
+  renderProcessTaskNotice,
+}: ProjectedDocumentWorkspaceNoticesProps<TContext>) {
+  return (
+    <>
+      <ProjectedDocumentActionStatusNotices
+        actionStatuses={actionStatuses}
+        profile={profile}
+        region={region}
+      />
+      {findActiveTask ? (
+        <ProjectedProcessTaskNotices
+          componentSystem={componentSystem}
+          context={context}
+          designSystem={designSystem}
+          findActiveTask={findActiveTask}
+          profile={profile}
+          projectSelector={projectSelector}
+          region={region}
+          renderNotice={renderProcessTaskNotice}
+        />
+      ) : null}
+    </>
+  )
+}

package/src/projected-document-workspace-prompt-child-view-registry.ts

@@ -0,0 +1,99 @@
+import { createElement } from 'react'
+
+import type {
+  DocumentWorkspaceProjectionRendererRegistry,
+} from '@cohesivesystems/presentation-react'
+import type {
+  PresentationShadcnComponentSystem as PresentationComponentSystem,
+} from './presentation-shadcn-component-system'
+import type {
+  PresentationDesignSystem,
+} from '@cohesivesystems/presentation-tailwind'
+import type {
+  ProjectedDocumentActionStatusMap,
+} from '@cohesivesystems/presentation-core'
+import {
+  mergeProjectedPromptChildViewRendererRegistries,
+  promptChildViewSemanticRoles,
+  type ProjectedPromptChildViewRenderer,
+  type ProjectedPromptChildViewRendererRegistry,
+} from './projected-prompt-child-view-renderer'
+import {
+  ProjectedDocumentWorkspacePromptPreviewProjection,
+  ProjectedJsonDocumentDiffProjection,
+  type ProjectedDocumentWorkspacePromptPreviewRenderContextOptions,
+} from './projected-document-workspace-prompt-child-view-renderers'
+import {
+  promptChildViewComponentRoles,
+} from '@cohesivesystems/presentation-contracts'
+
+export type {
+  ProjectedDocumentWorkspacePromptPreviewRenderContextOptions,
+} from './projected-document-workspace-prompt-child-view-renderers'
+
+export interface CreateProjectedDocumentWorkspacePromptChildViewRegistryOptions<TContext> {
+  readonly actionStatuses: ProjectedDocumentActionStatusMap
+  readonly createPromptPreviewRenderContext: (
+    context: ProjectedDocumentWorkspacePromptPreviewRenderContextOptions,
+  ) => TContext
+  readonly projectionRenderers: DocumentWorkspaceProjectionRendererRegistry<
+    TContext,
+    PresentationComponentSystem,
+    PresentationDesignSystem
+  >
+  readonly registries?: readonly ProjectedPromptChildViewRendererRegistry<TContext>[]
+  readonly renderJsonDocumentDiff?: ProjectedPromptChildViewRenderer<TContext>
+  readonly renderPromptDocumentPreview?: ProjectedPromptChildViewRenderer<TContext>
+}
+
+/**
+ * Creates the standard prompt child-view registry for document workspaces.
+ *
+ * The backend declares semantic child views such as JSON document diffs and
+ * prompt document previews. This helper binds those roles to reusable
+ * document-workspace renderers while leaving the concrete projection render
+ * context to the app adapter.
+ */
+export function createProjectedDocumentWorkspacePromptChildViewRegistry<TContext>({
+  actionStatuses,
+  createPromptPreviewRenderContext,
+  projectionRenderers,
+  registries = [],
+  renderJsonDocumentDiff,
+  renderPromptDocumentPreview,
+}: CreateProjectedDocumentWorkspacePromptChildViewRegistryOptions<TContext>): ProjectedPromptChildViewRendererRegistry<TContext> {
+  const jsonDocumentDiffRenderer =
+    renderJsonDocumentDiff ?? ((context) =>
+      createElement(ProjectedJsonDocumentDiffProjection, {
+        componentSystem: context.componentSystem,
+        dataSourceResolver: context.dataSourceResolver,
+        view: context.view,
+      }))
+  const promptDocumentPreviewRenderer =
+    renderPromptDocumentPreview ?? ((context) =>
+      createElement(ProjectedDocumentWorkspacePromptPreviewProjection<TContext>, {
+        actionStatuses,
+        componentSystem: context.componentSystem,
+        createProjectionRenderContext: createPromptPreviewRenderContext,
+        dataSourceResolver: context.dataSourceResolver,
+        designSystem: context.designSystem,
+        projectionRenderers,
+        promptView: context.promptView,
+        view: context.view,
+        viewId: context.viewId,
+      }))
+
+  return mergeProjectedPromptChildViewRendererRegistries(
+    {
+      byComponentRole: {
+        [promptChildViewComponentRoles.jsonDocumentDiff]: jsonDocumentDiffRenderer,
+        [promptChildViewComponentRoles.promptDocumentPreview]: promptDocumentPreviewRenderer,
+      },
+      bySemanticRole: {
+        [promptChildViewSemanticRoles.jsonDocumentDiff]: jsonDocumentDiffRenderer,
+        [promptChildViewSemanticRoles.promptDocumentPreview]: promptDocumentPreviewRenderer,
+      },
+    },
+    ...registries,
+  )
+}

package/src/projected-document-workspace-prompt-child-view-renderers.tsx

@@ -0,0 +1,205 @@
+import type {
+  DocumentWorkspaceProjectionRendererRegistry,
+} from '@cohesivesystems/presentation-react'
+import type {
+  PresentationShadcnComponentSystem as PresentationComponentSystem,
+} from './presentation-shadcn-component-system'
+import type {
+  PresentationDesignSystem,
+} from '@cohesivesystems/presentation-tailwind'
+import {
+  findPromptDocumentPreviewRegionId,
+  findPromptDocumentPreviewStatusRegionId,
+  getErrorMessage,
+  readObjectProperty,
+  resolvePromptDocumentPreviewPath,
+  resolvePromptDocumentPreviewText,
+  resolvePromptStatusMessages,
+  resolvePromptStatusMessageText,
+  type PresentationDataSourceResolver,
+  type ProjectedDocumentActionStatusMap,
+  type ProjectedPromptDocumentPreviewData,
+  type ViewDefinition,
+} from '@cohesivesystems/presentation-core'
+import {
+  ProjectedStatusBlock,
+} from './projected-activity-state'
+import {
+  ProjectedPromptDocumentPreview,
+} from './projected-prompt-document-preview'
+
+export interface ProjectedDocumentWorkspacePromptPreviewRenderContextOptions {
+  readonly editorPath: string
+  readonly editorText: string
+  readonly isReadOnly: boolean
+  readonly previewData: ProjectedPromptDocumentPreviewData
+  readonly view: ViewDefinition
+}
+
+interface ProjectedJsonDocumentDiffProjectionProps {
+  readonly componentSystem: PresentationComponentSystem
+  readonly dataSourceResolver: PresentationDataSourceResolver
+  readonly view: ViewDefinition
+}
+
+interface JsonDocumentDiffReviewData {
+  readonly error?: string | null
+  readonly modified?: string | null
+  readonly original?: string | null
+  readonly path?: string | null
+  readonly title?: string | null
+}
+
+interface ProjectedDocumentWorkspacePromptPreviewProjectionProps<TContext> {
+  readonly actionStatuses: ProjectedDocumentActionStatusMap
+  readonly componentSystem: PresentationComponentSystem
+  readonly createProjectionRenderContext: (
+    context: ProjectedDocumentWorkspacePromptPreviewRenderContextOptions,
+  ) => TContext
+  readonly dataSourceResolver: PresentationDataSourceResolver
+  readonly designSystem: PresentationDesignSystem
+  readonly projectionRenderers: DocumentWorkspaceProjectionRendererRegistry<
+    TContext,
+    PresentationComponentSystem,
+    PresentationDesignSystem
+  >
+  readonly promptView: ViewDefinition
+  readonly statusRegionId?: string | null
+  readonly view: ViewDefinition
+  readonly viewId: string
+}
+
+export function ProjectedJsonDocumentDiffProjection({
+  componentSystem,
+  dataSourceResolver,
+  view,
+}: ProjectedJsonDocumentDiffProjectionProps) {
+  const state = dataSourceResolver.resolveViewPrimary<JsonDocumentDiffReviewData>(view)
+  const data = state?.data
+  if (!data || typeof data !== 'object') {
+    return <ProjectedStatusBlock label="JSON diff data is not available." />
+  }
+
+  return componentSystem.documentWorkspaces.JsonDocumentDiff({
+    error: readString(data, 'error') ?? (state.error ? getErrorMessage(state.error) : null),
+    modified: readString(data, 'modified') ?? '',
+    original: readString(data, 'original') ?? '',
+    path: readString(data, 'path') ?? 'document.json',
+    title: readString(data, 'title') ?? view.Name,
+    viewId: view.Id,
+  })
+}
+
+export function ProjectedDocumentWorkspacePromptPreviewProjection<TContext>({
+  actionStatuses,
+  createProjectionRenderContext,
+  componentSystem,
+  dataSourceResolver,
+  designSystem,
+  projectionRenderers,
+  promptView,
+  statusRegionId,
+  view,
+  viewId,
+}: ProjectedDocumentWorkspacePromptPreviewProjectionProps<TContext>) {
+  const previewDefinition = view.PromptDocumentPreview
+  const previewRegionId = findPromptDocumentPreviewRegionId(promptView, view.Id) ?? view.Id
+  const previewMessages = resolvePromptStatusMessages({
+    actionStatuses,
+    dataSourceResolver,
+    region: previewRegionId,
+    view: promptView,
+  })
+  const previewState = resolvePromptDocumentPreviewState({
+    dataSourceResolver,
+    view,
+  })
+  const preview = readPromptDocumentPreviewData({
+    state: previewState,
+  })
+
+  if (!preview) {
+    if (previewState?.error) {
+      return (
+        <ProjectedStatusBlock
+          label={getErrorMessage(previewState.error)}
+          tone="error"
+        />
+      )
+    }
+
+    const pendingMessage = previewMessages[0]
+    return pendingMessage ? (
+      <ProjectedStatusBlock
+        label={pendingMessage.label}
+        tone={pendingMessage.tone}
+      />
+    ) : null
+  }
+
+  const previewError = previewMessages.find((message) => message.tone === 'error')?.label ?? null
+  const resolvedStatusRegionId =
+    statusRegionId ?? findPromptDocumentPreviewStatusRegionId(promptView, view.Id)
+  const statusLabel = resolvedStatusRegionId
+    ? resolvePromptStatusMessageText({
+        actionStatuses,
+        dataSourceResolver,
+        region: resolvedStatusRegionId,
+        view: promptView,
+      })
+    : null
+  const previewText = resolvePromptDocumentPreviewText(previewDefinition, preview)
+  const previewRenderContext = createProjectionRenderContext({
+    editorPath: resolvePromptDocumentPreviewPath(previewDefinition, preview),
+    editorText: previewText,
+    isReadOnly: previewDefinition?.IsReadOnly ?? true,
+    previewData: preview,
+    view,
+  })
+
+  return (
+    <ProjectedPromptDocumentPreview
+      componentSystem={componentSystem}
+      designSystem={designSystem}
+      definition={previewDefinition}
+      error={previewError}
+      fallback={<ProjectedStatusBlock label="Document preview workspace is not available." />}
+      previewData={preview}
+      projectionRenderContext={previewRenderContext}
+      projectionRenderers={projectionRenderers}
+      renderUnavailableProjection={() => (
+        <ProjectedStatusBlock label="This preview view is not available." />
+      )}
+      statusLabel={statusLabel ?? undefined}
+      viewId={viewId}
+    />
+  )
+}
+
+function readPromptDocumentPreviewData({
+  state,
+}: {
+  readonly state: ReturnType<typeof resolvePromptDocumentPreviewState>
+}) {
+  return state?.data ?? null
+}
+
+function resolvePromptDocumentPreviewState({
+  dataSourceResolver,
+  view,
+}: {
+  readonly dataSourceResolver: PresentationDataSourceResolver
+  readonly view: ViewDefinition
+}) {
+  const dataSourceId = view.PromptDocumentPreview?.DataSourceId
+  if (dataSourceId) {
+    return dataSourceResolver.resolve<ProjectedPromptDocumentPreviewData>(dataSourceId)
+  }
+
+  return dataSourceResolver.resolveViewPrimary<ProjectedPromptDocumentPreviewData>(view)
+}
+
+function readString(source: object, key: string) {
+  const value = readObjectProperty(source, key)
+  return typeof value === 'string' ? value : null
+}