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

package/src/presentation-component-system.ts

@@ -0,0 +1,365 @@
+export type PresentationComponentSystemComponents<
+  TActions extends object = object,
+  TBadges extends object = object,
+  TCollectionChrome extends object = object,
+  TCollections extends object = object,
+  TDocumentWorkspaces extends object = object,
+  TFieldValues extends object = object,
+  TFeedback extends object = object,
+  TForms extends object = object,
+  TMetrics extends object = object,
+  TNavigation extends object = object,
+  TProcesses extends object = object,
+  TPrompts extends object = object,
+  TRecords extends object = object,
+  TSurfaces extends object = object,
+  TTabs extends object = object,
+  TViewChrome extends object = object,
+> = TActions &
+  TBadges &
+  TCollectionChrome &
+  TCollections &
+  TDocumentWorkspaces &
+  TFieldValues &
+  TFeedback &
+  TForms &
+  TMetrics &
+  TNavigation &
+  TProcesses &
+  TPrompts &
+  TRecords &
+  TSurfaces &
+  TTabs &
+  TViewChrome
+
+export interface PresentationComponentSystemRoleGroups<
+  TActions extends object = object,
+  TBadges extends object = object,
+  TCollectionChrome extends object = object,
+  TCollections extends object = object,
+  TDocumentWorkspaces extends object = object,
+  TFieldValues extends object = object,
+  TFeedback extends object = object,
+  TForms extends object = object,
+  TMetrics extends object = object,
+  TNavigation extends object = object,
+  TProcesses extends object = object,
+  TPrompts extends object = object,
+  TRecords extends object = object,
+  TSurfaces extends object = object,
+  TTabs extends object = object,
+  TViewChrome extends object = object,
+> {
+  readonly actions: TActions
+  readonly badges: TBadges
+  readonly collectionChrome: TCollectionChrome
+  readonly collections: TCollections
+  readonly documentWorkspaces: TDocumentWorkspaces
+  readonly fieldValues: TFieldValues
+  readonly feedback: TFeedback
+  readonly forms: TForms
+  readonly metrics: TMetrics
+  readonly navigation: TNavigation
+  readonly processes: TProcesses
+  readonly prompts: TPrompts
+  readonly records: TRecords
+  readonly surfaces: TSurfaces
+  readonly tabs: TTabs
+  readonly viewChrome: TViewChrome
+}
+
+export type CreatePresentationComponentSystemOptions<
+  TActions extends object = object,
+  TBadges extends object = object,
+  TCollectionChrome extends object = object,
+  TCollections extends object = object,
+  TDocumentWorkspaces extends object = object,
+  TFieldValues extends object = object,
+  TFeedback extends object = object,
+  TForms extends object = object,
+  TMetrics extends object = object,
+  TNavigation extends object = object,
+  TProcesses extends object = object,
+  TPrompts extends object = object,
+  TRecords extends object = object,
+  TSurfaces extends object = object,
+  TTabs extends object = object,
+  TViewChrome extends object = object,
+> = PresentationComponentSystemRoleGroups<
+  TActions,
+  TBadges,
+  TCollectionChrome,
+  TCollections,
+  TDocumentWorkspaces,
+  TFieldValues,
+  TFeedback,
+  TForms,
+  TMetrics,
+  TNavigation,
+  TProcesses,
+  TPrompts,
+  TRecords,
+  TSurfaces,
+  TTabs,
+  TViewChrome
+> & {
+  readonly id: string
+  readonly target: string
+}
+
+export interface PresentationComponentSystem<
+  TActions extends object = object,
+  TBadges extends object = object,
+  TCollectionChrome extends object = object,
+  TCollections extends object = object,
+  TDocumentWorkspaces extends object = object,
+  TFieldValues extends object = object,
+  TFeedback extends object = object,
+  TForms extends object = object,
+  TMetrics extends object = object,
+  TNavigation extends object = object,
+  TProcesses extends object = object,
+  TPrompts extends object = object,
+  TRecords extends object = object,
+  TSurfaces extends object = object,
+  TTabs extends object = object,
+  TViewChrome extends object = object,
+> extends PresentationComponentSystemRoleGroups<
+    TActions,
+    TBadges,
+    TCollectionChrome,
+    TCollections,
+    TDocumentWorkspaces,
+    TFieldValues,
+    TFeedback,
+    TForms,
+    TMetrics,
+    TNavigation,
+    TProcesses,
+    TPrompts,
+    TRecords,
+    TSurfaces,
+    TTabs,
+    TViewChrome
+  > {
+  readonly components: PresentationComponentSystemComponents<
+    TActions,
+    TBadges,
+    TCollectionChrome,
+    TCollections,
+    TDocumentWorkspaces,
+    TFieldValues,
+    TFeedback,
+    TForms,
+    TMetrics,
+    TNavigation,
+    TProcesses,
+    TPrompts,
+    TRecords,
+    TSurfaces,
+    TTabs,
+    TViewChrome
+  >
+  readonly id: string
+  readonly target: string
+}
+
+export function createPresentationComponentSystem<
+  TActions extends object,
+  TBadges extends object,
+  TCollectionChrome extends object,
+  TCollections extends object,
+  TDocumentWorkspaces extends object,
+  TFieldValues extends object,
+  TFeedback extends object,
+  TForms extends object,
+  TMetrics extends object,
+  TNavigation extends object,
+  TProcesses extends object,
+  TPrompts extends object,
+  TRecords extends object,
+  TSurfaces extends object,
+  TTabs extends object,
+  TViewChrome extends object,
+>({
+  actions,
+  badges,
+  collectionChrome,
+  collections,
+  documentWorkspaces,
+  fieldValues,
+  feedback,
+  forms,
+  id,
+  metrics,
+  navigation,
+  processes,
+  prompts,
+  records,
+  surfaces,
+  tabs,
+  target,
+  viewChrome,
+}: CreatePresentationComponentSystemOptions<
+  TActions,
+  TBadges,
+  TCollectionChrome,
+  TCollections,
+  TDocumentWorkspaces,
+  TFieldValues,
+  TFeedback,
+  TForms,
+  TMetrics,
+  TNavigation,
+  TProcesses,
+  TPrompts,
+  TRecords,
+  TSurfaces,
+  TTabs,
+  TViewChrome
+>): PresentationComponentSystem<
+  TActions,
+  TBadges,
+  TCollectionChrome,
+  TCollections,
+  TDocumentWorkspaces,
+  TFieldValues,
+  TFeedback,
+  TForms,
+  TMetrics,
+  TNavigation,
+  TProcesses,
+  TPrompts,
+  TRecords,
+  TSurfaces,
+  TTabs,
+  TViewChrome
+> {
+  return {
+    actions,
+    badges,
+    collectionChrome,
+    collections,
+    components: createPresentationComponentSystemComponents({
+      actions,
+      badges,
+      collectionChrome,
+      collections,
+      documentWorkspaces,
+      fieldValues,
+      feedback,
+      forms,
+      metrics,
+      navigation,
+      processes,
+      prompts,
+      records,
+      surfaces,
+      tabs,
+      viewChrome,
+    }),
+    documentWorkspaces,
+    fieldValues,
+    feedback,
+    forms,
+    id,
+    metrics,
+    navigation,
+    processes,
+    prompts,
+    records,
+    surfaces,
+    tabs,
+    target,
+    viewChrome,
+  }
+}
+
+export function createPresentationComponentSystemComponents<
+  TActions extends object,
+  TBadges extends object,
+  TCollectionChrome extends object,
+  TCollections extends object,
+  TDocumentWorkspaces extends object,
+  TFieldValues extends object,
+  TFeedback extends object,
+  TForms extends object,
+  TMetrics extends object,
+  TNavigation extends object,
+  TProcesses extends object,
+  TPrompts extends object,
+  TRecords extends object,
+  TSurfaces extends object,
+  TTabs extends object,
+  TViewChrome extends object,
+>({
+  actions,
+  badges,
+  collectionChrome,
+  collections,
+  documentWorkspaces,
+  fieldValues,
+  feedback,
+  forms,
+  metrics,
+  navigation,
+  processes,
+  prompts,
+  records,
+  surfaces,
+  tabs,
+  viewChrome,
+}: PresentationComponentSystemRoleGroups<
+  TActions,
+  TBadges,
+  TCollectionChrome,
+  TCollections,
+  TDocumentWorkspaces,
+  TFieldValues,
+  TFeedback,
+  TForms,
+  TMetrics,
+  TNavigation,
+  TProcesses,
+  TPrompts,
+  TRecords,
+  TSurfaces,
+  TTabs,
+  TViewChrome
+>): PresentationComponentSystemComponents<
+  TActions,
+  TBadges,
+  TCollectionChrome,
+  TCollections,
+  TDocumentWorkspaces,
+  TFieldValues,
+  TFeedback,
+  TForms,
+  TMetrics,
+  TNavigation,
+  TProcesses,
+  TPrompts,
+  TRecords,
+  TSurfaces,
+  TTabs,
+  TViewChrome
+> {
+  return {
+    ...actions,
+    ...badges,
+    ...collectionChrome,
+    ...collections,
+    ...documentWorkspaces,
+    ...fieldValues,
+    ...feedback,
+    ...forms,
+    ...metrics,
+    ...navigation,
+    ...processes,
+    ...prompts,
+    ...records,
+    ...surfaces,
+    ...tabs,
+    ...viewChrome,
+  }
+}

package/src/presentation-icon-diagnostics.ts

@@ -0,0 +1,53 @@
+import {
+  projectPresentationActionIconDiagnostics as projectCorePresentationActionIconDiagnostics,
+  projectPresentationIconDiagnostics as projectCorePresentationIconDiagnostics,
+  type PresentationActionIconPlacement,
+  type PresentationIconDiagnosticSubject,
+  type ProjectPresentationActionIconDiagnosticsOptions as CoreProjectPresentationActionIconDiagnosticsOptions,
+  type ProjectPresentationIconDiagnosticsOptions as CoreProjectPresentationIconDiagnosticsOptions,
+} from '@cohesivesystems/presentation-core'
+
+import {
+  standardLucidePresentationIconRegistry,
+  type PresentationIconRegistry,
+} from './presentation-icon-registry'
+
+export type {
+  PresentationActionIconPlacement,
+  PresentationIconDiagnosticSubject,
+  PresentationIconModuleProjection,
+} from '@cohesivesystems/presentation-core'
+
+export interface ProjectPresentationIconDiagnosticsOptions<
+  TSubject extends PresentationIconDiagnosticSubject,
+> extends Omit<CoreProjectPresentationIconDiagnosticsOptions<TSubject>, 'registry'> {
+  readonly registry?: PresentationIconRegistry<TSubject> | null
+}
+
+export interface ProjectPresentationActionIconDiagnosticsOptions<
+  TPlacement extends PresentationActionIconPlacement,
+> extends Omit<CoreProjectPresentationActionIconDiagnosticsOptions<TPlacement>, 'registry'> {
+  readonly registry?: PresentationIconRegistry<TPlacement> | null
+}
+
+export function projectPresentationIconDiagnostics<
+  TSubject extends PresentationIconDiagnosticSubject,
+>(options: ProjectPresentationIconDiagnosticsOptions<TSubject>) {
+  return projectCorePresentationIconDiagnostics({
+    ...options,
+    registry:
+      options.registry ??
+      (standardLucidePresentationIconRegistry as PresentationIconRegistry<TSubject>),
+  })
+}
+
+export function projectPresentationActionIconDiagnostics<
+  TPlacement extends PresentationActionIconPlacement,
+>(options: ProjectPresentationActionIconDiagnosticsOptions<TPlacement>) {
+  return projectCorePresentationActionIconDiagnostics({
+    ...options,
+    registry:
+      options.registry ??
+      (standardLucidePresentationIconRegistry as PresentationIconRegistry<TPlacement>),
+  })
+}

package/src/presentation-icon-registry.tsx

@@ -0,0 +1,181 @@
+import {
+  Activity,
+  AlertCircle,
+  ArrowLeft,
+  Box,
+  Braces,
+  Check,
+  CheckCircle2,
+  ChevronLeft,
+  ChevronRight,
+  ChevronsLeft,
+  Clock3,
+  Columns2,
+  Database,
+  ExternalLink,
+  FileCode2,
+  GitBranch,
+  Hammer,
+  History,
+  Home,
+  ListChecks,
+  ListTree,
+  LoaderCircle,
+  LogIn,
+  MoreHorizontal,
+  RefreshCw,
+  RotateCcw,
+  Save,
+  Search,
+  ShieldCheck,
+  Square,
+  SquareArrowOutUpRight,
+  X,
+  type LucideIcon,
+} from 'lucide-react'
+import type { ReactNode } from 'react'
+
+import {
+  createPresentationIconRegistry,
+  defaultPresentationComponentSet,
+  resolvePresentationIcon as resolveCorePresentationIcon,
+  type PresentationIconModuleProjection,
+  type PresentationIconRegistry as CorePresentationIconRegistry,
+  type PresentationIconRenderContext,
+  type PresentationIconResolution as CorePresentationIconResolution,
+} from '@cohesivesystems/presentation-core'
+
+export {
+  createPresentationIconRegistry,
+}
+
+export type {
+  PresentationIconModuleProjection,
+  PresentationIconRenderContext,
+}
+
+export type PresentationIconRegistry<TSubject = unknown> =
+  CorePresentationIconRegistry<TSubject, ReactNode>
+
+export type PresentationIconResolution<TSubject = unknown> =
+  CorePresentationIconResolution<TSubject, ReactNode>
+
+export function resolvePresentationIcon<TSubject = unknown>({
+  componentSet = defaultPresentationComponentSet,
+  icon,
+  module,
+  registry,
+}: {
+  readonly componentSet?: string
+  readonly icon: string | null | undefined
+  readonly module?: PresentationIconModuleProjection | null
+  readonly registry: PresentationIconRegistry<TSubject> | null | undefined
+}): PresentationIconResolution<TSubject> {
+  return resolveCorePresentationIcon<TSubject, ReactNode>({
+    componentSet,
+    icon,
+    module,
+    registry,
+  })
+}
+
+export function hasPresentationIconBinding<TSubject = unknown>({
+  componentSet,
+  icon,
+  module,
+  registry = standardLucidePresentationIconRegistry as PresentationIconRegistry<TSubject>,
+}: {
+  readonly componentSet?: string
+  readonly icon: string | null | undefined
+  readonly module?: PresentationIconModuleProjection | null
+  readonly registry?: PresentationIconRegistry<TSubject> | null
+}) {
+  return Boolean(resolvePresentationIcon({
+    componentSet,
+    icon,
+    module,
+    registry,
+  }).renderer)
+}
+
+export function renderPresentationIcon<TSubject = unknown>({
+  className = 'size-3.5',
+  componentSet,
+  icon,
+  module,
+  registry = standardLucidePresentationIconRegistry as PresentationIconRegistry<TSubject>,
+  subject,
+}: {
+  readonly className?: string
+  readonly componentSet?: string
+  readonly icon: string | null | undefined
+  readonly module?: PresentationIconModuleProjection | null
+  readonly registry?: PresentationIconRegistry<TSubject> | null
+  readonly subject?: TSubject
+}) {
+  const resolution = resolvePresentationIcon({
+    componentSet,
+    icon,
+    module,
+    registry,
+  })
+
+  return resolution.renderer?.({
+    className,
+    icon: resolution.icon,
+    subject,
+  }) ?? null
+}
+
+export const standardLucidePresentationIconRegistry = createPresentationIconRegistry({
+  byComponentKey: createLucideIconRendererMap('component-key'),
+  byIconKey: createLucideIconRendererMap('icon-key'),
+})
+
+function createLucideIconRendererMap(
+  keyKind: 'component-key' | 'icon-key',
+) {
+  const prefix = keyKind === 'component-key' ? 'lucide.' : ''
+  return {
+    [`${prefix}activity`]: createLucideIconRenderer(Activity),
+    [`${prefix}alert-circle`]: createLucideIconRenderer(AlertCircle),
+    [`${prefix}arrow-left`]: createLucideIconRenderer(ArrowLeft),
+    [`${prefix}box`]: createLucideIconRenderer(Box),
+    [`${prefix}braces`]: createLucideIconRenderer(Braces),
+    [`${prefix}check`]: createLucideIconRenderer(Check),
+    [`${prefix}check-circle-2`]: createLucideIconRenderer(CheckCircle2),
+    [`${prefix}chevron-left`]: createLucideIconRenderer(ChevronLeft),
+    [`${prefix}chevron-right`]: createLucideIconRenderer(ChevronRight),
+    [`${prefix}chevrons-left`]: createLucideIconRenderer(ChevronsLeft),
+    [`${prefix}clock-3`]: createLucideIconRenderer(Clock3),
+    [`${prefix}columns-2`]: createLucideIconRenderer(Columns2),
+    [`${prefix}database`]: createLucideIconRenderer(Database),
+    [`${prefix}external-link`]: createLucideIconRenderer(ExternalLink),
+    [`${prefix}file-code-2`]: createLucideIconRenderer(FileCode2),
+    [`${prefix}git-branch`]: createLucideIconRenderer(GitBranch),
+    [`${prefix}hammer`]: createLucideIconRenderer(Hammer),
+    [`${prefix}history`]: createLucideIconRenderer(History),
+    [`${prefix}home`]: createLucideIconRenderer(Home),
+    [`${prefix}list-checks`]: createLucideIconRenderer(ListChecks),
+    [`${prefix}list-tree`]: createLucideIconRenderer(ListTree),
+    [`${prefix}loader-circle`]: createLucideIconRenderer(LoaderCircle),
+    [`${prefix}log-in`]: createLucideIconRenderer(LogIn),
+    [`${prefix}more-horizontal`]: createLucideIconRenderer(MoreHorizontal),
+    [`${prefix}refresh-cw`]: createLucideIconRenderer(RefreshCw),
+    [`${prefix}rotate-ccw`]: createLucideIconRenderer(RotateCcw),
+    [`${prefix}save`]: createLucideIconRenderer(Save),
+    [`${prefix}search`]: createLucideIconRenderer(Search),
+    [`${prefix}shield-check`]: createLucideIconRenderer(ShieldCheck),
+    [`${prefix}square`]: createLucideIconRenderer(Square),
+    [`${prefix}square-arrow-out-up-right`]: createLucideIconRenderer(SquareArrowOutUpRight),
+    [`${prefix}x`]: createLucideIconRenderer(X),
+  }
+}
+
+function createLucideIconRenderer<TSubject = unknown>(Icon: LucideIcon) {
+  return function renderLucideIcon({
+    className = 'size-3.5',
+  }: PresentationIconRenderContext<TSubject>) {
+    return <Icon className={className} />
+  }
+}