@preptex/ui 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +54 -2
  3. package/dist/components/CatalogDialog.css +401 -0
  4. package/dist/components/CatalogDialog.d.ts +16 -0
  5. package/dist/components/CatalogDialog.js +224 -0
  6. package/dist/components/CatalogDialog.js.map +1 -0
  7. package/dist/components/Codeview.css +127 -0
  8. package/dist/components/Codeview.d.ts +14 -0
  9. package/dist/components/Codeview.js +74 -0
  10. package/dist/components/Codeview.js.map +1 -0
  11. package/dist/components/ConfigurationSummary.d.ts +18 -0
  12. package/dist/components/ConfigurationSummary.js +44 -0
  13. package/dist/components/ConfigurationSummary.js.map +1 -0
  14. package/dist/components/ControlPanel.css +792 -0
  15. package/dist/components/ControlPanel.d.ts +48 -0
  16. package/dist/components/ControlPanel.js +218 -0
  17. package/dist/components/ControlPanel.js.map +1 -0
  18. package/dist/components/EditPreviewDialog.css +308 -0
  19. package/dist/components/EditPreviewDialog.d.ts +18 -0
  20. package/dist/components/EditPreviewDialog.js +46 -0
  21. package/dist/components/EditPreviewDialog.js.map +1 -0
  22. package/dist/components/Filetree.css +344 -0
  23. package/dist/components/Filetree.d.ts +22 -0
  24. package/dist/components/Filetree.js +250 -0
  25. package/dist/components/Filetree.js.map +1 -0
  26. package/dist/components/LogDialog.css +154 -0
  27. package/dist/components/LogDialog.d.ts +16 -0
  28. package/dist/components/LogDialog.js +42 -0
  29. package/dist/components/LogDialog.js.map +1 -0
  30. package/dist/components/LogPanel.css +106 -0
  31. package/dist/components/LogPanel.d.ts +10 -0
  32. package/dist/components/LogPanel.js +30 -0
  33. package/dist/components/LogPanel.js.map +1 -0
  34. package/dist/components/MetadataDialog.css +275 -0
  35. package/dist/components/MetadataDialog.d.ts +13 -0
  36. package/dist/components/MetadataDialog.js +67 -0
  37. package/dist/components/MetadataDialog.js.map +1 -0
  38. package/dist/components/NodeActionBar.css +163 -0
  39. package/dist/components/NodeActionBar.d.ts +19 -0
  40. package/dist/components/NodeActionBar.js +114 -0
  41. package/dist/components/NodeActionBar.js.map +1 -0
  42. package/dist/components/OperationsDialog.css +154 -0
  43. package/dist/components/OperationsDialog.d.ts +8 -0
  44. package/dist/components/OperationsDialog.js +27 -0
  45. package/dist/components/OperationsDialog.js.map +1 -0
  46. package/dist/components/PrepTeXWorkspace.css +224 -0
  47. package/dist/components/PrepTeXWorkspace.d.ts +125 -0
  48. package/dist/components/PrepTeXWorkspace.js +593 -0
  49. package/dist/components/PrepTeXWorkspace.js.map +1 -0
  50. package/dist/components/ProjectSetupDialog.css +292 -0
  51. package/dist/components/ProjectSetupDialog.d.ts +18 -0
  52. package/dist/components/ProjectSetupDialog.js +134 -0
  53. package/dist/components/ProjectSetupDialog.js.map +1 -0
  54. package/dist/components/WelcomeEmptyState.css +105 -0
  55. package/dist/components/WelcomeEmptyState.d.ts +9 -0
  56. package/dist/components/WelcomeEmptyState.js +28 -0
  57. package/dist/components/WelcomeEmptyState.js.map +1 -0
  58. package/dist/components/WorkspaceHeader.css +410 -0
  59. package/dist/components/WorkspaceHeader.d.ts +66 -0
  60. package/dist/components/WorkspaceHeader.js +297 -0
  61. package/dist/components/WorkspaceHeader.js.map +1 -0
  62. package/dist/components/astview/ASTview.css +690 -0
  63. package/dist/components/astview/ASTview.d.ts +27 -0
  64. package/dist/components/astview/ASTview.js +314 -0
  65. package/dist/components/astview/ASTview.js.map +1 -0
  66. package/dist/components/astview/TreeNode.d.ts +8 -0
  67. package/dist/components/astview/TreeNode.js +237 -0
  68. package/dist/components/astview/TreeNode.js.map +1 -0
  69. package/dist/components/astview/treebuilder.d.ts +13 -0
  70. package/dist/components/astview/treebuilder.js +292 -0
  71. package/dist/components/astview/treebuilder.js.map +1 -0
  72. package/dist/components/index.d.ts +18 -0
  73. package/dist/components/index.js +19 -0
  74. package/dist/components/index.js.map +1 -0
  75. package/dist/docs/architecture.md +46 -0
  76. package/dist/docs/integration.md +107 -0
  77. package/dist/index.d.ts +14 -0
  78. package/dist/index.js +12 -0
  79. package/dist/index.js.map +1 -0
  80. package/dist/model/useArtifacts.d.ts +14 -0
  81. package/dist/model/useArtifacts.js +32 -0
  82. package/dist/model/useArtifacts.js.map +1 -0
  83. package/dist/model/useControl.d.ts +15 -0
  84. package/dist/model/useControl.js +19 -0
  85. package/dist/model/useControl.js.map +1 -0
  86. package/dist/model/useFiles.d.ts +53 -0
  87. package/dist/model/useFiles.js +283 -0
  88. package/dist/model/useFiles.js.map +1 -0
  89. package/dist/model/useProjectConfiguration.d.ts +32 -0
  90. package/dist/model/useProjectConfiguration.js +151 -0
  91. package/dist/model/useProjectConfiguration.js.map +1 -0
  92. package/dist/model/useWorkspaceLayout.d.ts +26 -0
  93. package/dist/model/useWorkspaceLayout.js +55 -0
  94. package/dist/model/useWorkspaceLayout.js.map +1 -0
  95. package/dist/services/zip.d.ts +24 -0
  96. package/dist/services/zip.js +279 -0
  97. package/dist/services/zip.js.map +1 -0
  98. package/dist/styles/bundle.css +4652 -0
  99. package/dist/styles/tokens.css +77 -0
  100. package/dist/types/LayoutNode.d.ts +30 -0
  101. package/dist/types/LayoutNode.js +18 -0
  102. package/dist/types/LayoutNode.js.map +1 -0
  103. package/dist/types/artifacts.d.ts +9 -0
  104. package/dist/types/artifacts.js +2 -0
  105. package/dist/types/artifacts.js.map +1 -0
  106. package/dist/types/errors.d.ts +14 -0
  107. package/dist/types/errors.js +2 -0
  108. package/dist/types/errors.js.map +1 -0
  109. package/dist/types/files.d.ts +12 -0
  110. package/dist/types/files.js +2 -0
  111. package/dist/types/files.js.map +1 -0
  112. package/dist/utils/dropEntries.d.ts +6 -0
  113. package/dist/utils/dropEntries.js +58 -0
  114. package/dist/utils/dropEntries.js.map +1 -0
  115. package/dist/utils/fileFilter.d.ts +10 -0
  116. package/dist/utils/fileFilter.js +68 -0
  117. package/dist/utils/fileFilter.js.map +1 -0
  118. package/dist/utils/transformOutput.d.ts +24 -0
  119. package/dist/utils/transformOutput.js +83 -0
  120. package/dist/utils/transformOutput.js.map +1 -0
  121. package/package.json +103 -4
@@ -0,0 +1,125 @@
1
+ import { type ReactNode } from 'react';
2
+ import type { AnalysisFinding, CoarseTree, ConditionDecision, ConfiguredNode, GeneratedArtifact, ProjectCatalog, ProjectEdit, ProjectEditPlan, ProjectFilePath, ProjectIssue, ProjectMetadata, SourceLocation, SourceToken, SymbolRefactorAction } from '@preptex/core';import type { UnifiedTransformRequest } from './ControlPanel.js';
3
+ import { type SectionCommandName } from './NodeActionBar.js';
4
+ import { type WorkspaceCustomMenuDescriptor, type WorkspaceMenuItemDescriptor, type WorkspaceViewDescriptor } from './WorkspaceHeader.js';
5
+ import { useControl } from '../model/useControl.js';
6
+ import { useFiles } from '../model/useFiles.js';
7
+ import { useProjectConfiguration } from '../model/useProjectConfiguration.js';
8
+ import { useWorkspaceLayout, type WorkspaceViewId } from '../model/useWorkspaceLayout.js';
9
+ import type { ProcessingError } from '../types/errors.js';
10
+ import type { FilesMap } from '../types/files.js';
11
+ export declare const DEFAULT_DEMO_PROJECT_FILES: FilesMap;
12
+ export interface StagedEditMetadata {
13
+ readonly title?: string;
14
+ readonly subtitle?: string;
15
+ readonly historyLabel?: string;
16
+ readonly artifacts?: readonly GeneratedArtifact[];
17
+ readonly issues?: readonly ProjectIssue[];
18
+ }
19
+ export declare function applyProjectEditsToFilesMap(filesByName: FilesMap, edits: readonly ProjectEdit[]): FilesMap;
20
+ export declare function getOperationHistoryLabel(operation: string | undefined, customLabels?: Readonly<Record<string, string>>): string;
21
+ export interface WorkspaceModelData {
22
+ readonly viewStatus?: 'ready' | 'incomplete' | 'blocked' | null;
23
+ readonly viewId?: string | null;
24
+ readonly viewIssue?: ProjectIssue | null;
25
+ readonly hasConditionals?: boolean;
26
+ readonly detectedConditions?: readonly string[];
27
+ readonly conditionDecisions?: readonly ConditionDecision[];
28
+ readonly coarseTree?: CoarseTree | null;
29
+ readonly configuredRoot?: ConfiguredNode | null;
30
+ readonly sourceTokensByFile?: Readonly<Record<ProjectFilePath, readonly SourceToken[]>>;
31
+ readonly catalog?: ProjectCatalog | null;
32
+ readonly metadata?: ProjectMetadata | null;
33
+ readonly diagnostics?: readonly ProjectIssue[];
34
+ readonly findings?: readonly AnalysisFinding[];
35
+ readonly isFindingsStale?: boolean;
36
+ readonly isAnalyzing?: boolean;
37
+ readonly error?: ProcessingError | null;
38
+ readonly pendingEditPlan?: ProjectEditPlan | null;
39
+ readonly pendingEditMetadata?: StagedEditMetadata | null;
40
+ readonly isEditPlanStale?: boolean;
41
+ readonly artifacts?: readonly GeneratedArtifact[];
42
+ readonly canRunSourceTransformations?: boolean;
43
+ readonly canRealizeConditions?: boolean;
44
+ readonly realizeConditionsReason?: string;
45
+ readonly canRunViewTransformations?: boolean;
46
+ readonly viewTransformationReason?: string;
47
+ readonly canRunReferences?: boolean;
48
+ readonly referencesReason?: string;
49
+ readonly canRunCommandUsage?: boolean;
50
+ readonly commandUsageReason?: string;
51
+ }
52
+ export interface WorkspaceActionHandlers {
53
+ readonly onApplyTransformations?: (request: UnifiedTransformRequest) => void;
54
+ readonly onRefactorSymbol?: (action: SymbolRefactorAction) => void;
55
+ readonly onRunReferences?: () => void;
56
+ readonly onRunCommandUsage?: () => void;
57
+ readonly onRemoveNode?: (node: ConfiguredNode) => void;
58
+ readonly onRenameEnvironment?: (node: ConfiguredNode, newName: string) => void;
59
+ readonly onRenameCommand?: (node: ConfiguredNode, newName: string) => void;
60
+ readonly onRenameSection?: (node: ConfiguredNode, sectionCommand: SectionCommandName, starred: boolean) => void;
61
+ readonly onUnwrapNode?: (node: ConfiguredNode) => void;
62
+ readonly onWrapNode?: (node: ConfiguredNode, wrapperName: string) => void;
63
+ readonly onStageEditPlan?: (plan: ProjectEditPlan, metadata?: StagedEditMetadata) => void;
64
+ readonly onApplyPendingEdits?: (options: {
65
+ readonly switchToConditionFree: boolean;
66
+ readonly historyLabel: string;
67
+ }) => boolean | void | Promise<boolean | void>;
68
+ readonly onDiscardPendingEdits?: () => void;
69
+ }
70
+ export interface PrepTeXWorkspaceContextValue {
71
+ readonly filesByName: FilesMap;
72
+ readonly fileNames: readonly ProjectFilePath[];
73
+ readonly fileVersions: Readonly<Record<ProjectFilePath, number>>;
74
+ readonly sourceRevision: number;
75
+ readonly selectedFile: ProjectFilePath;
76
+ readonly selectFile: (path: ProjectFilePath) => void;
77
+ readonly upsertTextFiles: ReturnType<typeof useFiles>['upsertTextFiles'];
78
+ readonly removeFile: ReturnType<typeof useFiles>['removeFile'];
79
+ readonly resetFiles: ReturnType<typeof useFiles>['resetFiles'];
80
+ readonly projectConfig: ReturnType<typeof useProjectConfiguration>;
81
+ readonly layout: ReturnType<typeof useWorkspaceLayout>;
82
+ readonly control: ReturnType<typeof useControl>;
83
+ readonly model: WorkspaceModelData;
84
+ readonly effectiveEntry: ProjectFilePath;
85
+ readonly selectedNode: ConfiguredNode | null;
86
+ readonly setSelectedNode: (node: ConfiguredNode | null) => void;
87
+ readonly selectedArtifact: GeneratedArtifact | null;
88
+ readonly setSelectedArtifact: (artifact: GeneratedArtifact | null) => void;
89
+ readonly jumpToLocation: (location: SourceLocation) => void;
90
+ readonly stageEditPlan: (plan: ProjectEditPlan, metadata?: StagedEditMetadata & {
91
+ readonly switchToDiff?: boolean;
92
+ }) => void;
93
+ readonly loadDemo: () => void;
94
+ }
95
+ export declare function usePrepTeXWorkspace(): PrepTeXWorkspaceContextValue;
96
+ export interface CustomWorkspaceViewDescriptor extends WorkspaceViewDescriptor {
97
+ readonly render: (context: PrepTeXWorkspaceContextValue) => ReactNode;
98
+ }
99
+ export interface PrepTeXWorkspaceProps {
100
+ readonly files?: ReturnType<typeof useFiles>;
101
+ readonly projectConfig?: ReturnType<typeof useProjectConfiguration>;
102
+ readonly layout?: ReturnType<typeof useWorkspaceLayout>;
103
+ readonly control?: ReturnType<typeof useControl>;
104
+ readonly model?: WorkspaceModelData;
105
+ readonly actions?: WorkspaceActionHandlers;
106
+ readonly initialFiles?: FilesMap;
107
+ readonly demoFiles?: FilesMap;
108
+ readonly brandLabel?: string;
109
+ readonly initialView?: WorkspaceViewId;
110
+ readonly enableDemoQueryParams?: boolean;
111
+ readonly extraViews?: readonly CustomWorkspaceViewDescriptor[];
112
+ readonly getExtraViews?: (context: PrepTeXWorkspaceContextValue) => readonly CustomWorkspaceViewDescriptor[];
113
+ readonly getExtraMenus?: (context: PrepTeXWorkspaceContextValue) => readonly WorkspaceCustomMenuDescriptor[];
114
+ readonly getExtraFileMenuItems?: (context: PrepTeXWorkspaceContextValue) => readonly WorkspaceMenuItemDescriptor[];
115
+ readonly getExtraEditMenuItems?: (context: PrepTeXWorkspaceContextValue) => readonly WorkspaceMenuItemDescriptor[];
116
+ readonly renderHeaderRightSlot?: (context: PrepTeXWorkspaceContextValue) => ReactNode;
117
+ readonly renderAstNodeActions?: (node: ConfiguredNode, context: PrepTeXWorkspaceContextValue) => ReactNode;
118
+ readonly renderDiagnosticsActions?: (context: PrepTeXWorkspaceContextValue) => ReactNode;
119
+ readonly renderOperationsExtraContent?: (context: PrepTeXWorkspaceContextValue) => ReactNode;
120
+ readonly renderEmptyStateActions?: (context: PrepTeXWorkspaceContextValue) => ReactNode;
121
+ readonly customOperationLabels?: Readonly<Record<string, string>>;
122
+ readonly onFilesChange?: (files: FilesMap, sourceRevision: number, fileVersions: Readonly<Record<ProjectFilePath, number>>) => void;
123
+ }
124
+ export declare function PrepTeXWorkspace({ files: externalFiles, projectConfig: externalProjectConfig, layout: externalLayout, control: externalControl, model, actions, initialFiles, demoFiles, brandLabel, initialView, enableDemoQueryParams, extraViews, getExtraViews, getExtraMenus, getExtraFileMenuItems, getExtraEditMenuItems, renderHeaderRightSlot, renderAstNodeActions, renderDiagnosticsActions, renderOperationsExtraContent, renderEmptyStateActions, customOperationLabels, onFilesChange, }: PrepTeXWorkspaceProps): import("react").JSX.Element;
125
+ export default PrepTeXWorkspace;