@pie-element/cli 0.1.1 → 0.1.2-next.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 (281) hide show
  1. package/README.md +48 -10
  2. package/dist/commands/dev/demo/index.d.ts +1 -1
  3. package/dist/commands/dev/demo/index.js +21 -0
  4. package/dist/commands/dev/demo/index.js.map +1 -1
  5. package/dist/commands/dev/test-bundler.d.ts +0 -1
  6. package/dist/commands/dev/test-bundler.js +2 -10
  7. package/dist/commands/dev/test-bundler.js.map +1 -1
  8. package/dist/commands/docs/generate.d.ts +16 -0
  9. package/dist/commands/docs/generate.js +150 -0
  10. package/dist/commands/docs/generate.js.map +1 -0
  11. package/dist/commands/docs/verify.d.ts +12 -0
  12. package/dist/commands/docs/verify.js +40 -0
  13. package/dist/commands/docs/verify.js.map +1 -0
  14. package/dist/commands/packages/create-controllers.d.ts +0 -1
  15. package/dist/commands/packages/create-controllers.js.map +1 -1
  16. package/dist/commands/packages/create-lib-react.d.ts +0 -1
  17. package/dist/commands/packages/create-lib-react.js +1 -3
  18. package/dist/commands/packages/create-lib-react.js.map +1 -1
  19. package/dist/commands/packages/create-react-elements.d.ts +0 -1
  20. package/dist/commands/packages/create-react-elements.js +2 -3
  21. package/dist/commands/packages/create-react-elements.js.map +1 -1
  22. package/dist/commands/packages/enable-publishing.d.ts +0 -1
  23. package/dist/commands/packages/enable-publishing.js +26 -23
  24. package/dist/commands/packages/enable-publishing.js.map +1 -1
  25. package/dist/commands/packages/init-synced-elements.d.ts +0 -1
  26. package/dist/commands/packages/init-synced-elements.js +1 -1
  27. package/dist/commands/packages/init-synced-elements.js.map +1 -1
  28. package/dist/commands/upstream/analyze-esm.d.ts +0 -1
  29. package/dist/commands/upstream/analyze-esm.js +5 -1
  30. package/dist/commands/upstream/analyze-esm.js.map +1 -1
  31. package/dist/commands/upstream/check.d.ts +0 -1
  32. package/dist/commands/upstream/check.js.map +1 -1
  33. package/dist/commands/upstream/deps.d.ts +0 -1
  34. package/dist/commands/upstream/deps.js.map +1 -1
  35. package/dist/commands/upstream/sync.d.ts +11 -2
  36. package/dist/commands/upstream/sync.js +364 -25
  37. package/dist/commands/upstream/sync.js.map +1 -1
  38. package/dist/commands/upstream/track.d.ts +0 -1
  39. package/dist/commands/upstream/track.js.map +1 -1
  40. package/dist/commands/upstream/update.d.ts +0 -1
  41. package/dist/commands/upstream/update.js +37 -7
  42. package/dist/commands/upstream/update.js.map +1 -1
  43. package/dist/commands/verify/controllers.d.ts +0 -1
  44. package/dist/commands/verify/controllers.js +213 -59
  45. package/dist/commands/verify/controllers.js.map +1 -1
  46. package/dist/commands/verify/dependency-integrity.d.ts +18 -0
  47. package/dist/commands/verify/dependency-integrity.js +147 -0
  48. package/dist/commands/verify/dependency-integrity.js.map +1 -0
  49. package/dist/commands/verify/react-build.d.ts +0 -1
  50. package/dist/commands/verify/react-build.js.map +1 -1
  51. package/dist/index.d.ts +0 -1
  52. package/dist/index.js.map +1 -1
  53. package/dist/lib/docs/contract-validator.d.ts +12 -0
  54. package/dist/lib/docs/contract-validator.js +38 -0
  55. package/dist/lib/docs/contract-validator.js.map +1 -0
  56. package/dist/lib/docs/contracts.d.ts +11 -0
  57. package/dist/lib/docs/contracts.js +241 -0
  58. package/dist/lib/docs/contracts.js.map +1 -0
  59. package/dist/lib/docs/discovery.d.ts +10 -0
  60. package/dist/lib/docs/discovery.js +91 -0
  61. package/dist/lib/docs/discovery.js.map +1 -0
  62. package/dist/lib/docs/generator.d.ts +14 -0
  63. package/dist/lib/docs/generator.js +450 -0
  64. package/dist/lib/docs/generator.js.map +1 -0
  65. package/dist/lib/docs/source-extractor.d.ts +2 -0
  66. package/dist/lib/docs/source-extractor.js +209 -0
  67. package/dist/lib/docs/source-extractor.js.map +1 -0
  68. package/dist/lib/docs/types.d.ts +77 -0
  69. package/dist/lib/docs/types.js +2 -0
  70. package/dist/lib/docs/types.js.map +1 -0
  71. package/dist/lib/upstream/repo-utils.d.ts +0 -1
  72. package/dist/lib/upstream/repo-utils.js.map +1 -1
  73. package/dist/lib/upstream/sync-compatibility.d.ts +0 -1
  74. package/dist/lib/upstream/sync-compatibility.js.map +1 -1
  75. package/dist/lib/upstream/sync-constants.d.ts +35 -7
  76. package/dist/lib/upstream/sync-constants.js +40 -11
  77. package/dist/lib/upstream/sync-constants.js.map +1 -1
  78. package/dist/lib/upstream/sync-controllers-strategy.d.ts +0 -1
  79. package/dist/lib/upstream/sync-controllers-strategy.js +14 -4
  80. package/dist/lib/upstream/sync-controllers-strategy.js.map +1 -1
  81. package/dist/lib/upstream/sync-demo-metadata.d.ts +0 -1
  82. package/dist/lib/upstream/sync-demo-metadata.js +1 -1
  83. package/dist/lib/upstream/sync-demo-metadata.js.map +1 -1
  84. package/dist/lib/upstream/sync-entry-discovery.d.ts +3 -0
  85. package/dist/lib/upstream/sync-entry-discovery.js +23 -0
  86. package/dist/lib/upstream/sync-entry-discovery.js.map +1 -0
  87. package/dist/lib/upstream/sync-externals.d.ts +7 -7
  88. package/dist/lib/upstream/sync-externals.js +51 -35
  89. package/dist/lib/upstream/sync-externals.js.map +1 -1
  90. package/dist/lib/upstream/sync-filesystem.d.ts +0 -1
  91. package/dist/lib/upstream/sync-filesystem.js.map +1 -1
  92. package/dist/lib/upstream/sync-imports.d.ts +82 -62
  93. package/dist/lib/upstream/sync-imports.js +658 -185
  94. package/dist/lib/upstream/sync-imports.js.map +1 -1
  95. package/dist/lib/upstream/sync-package-json.d.ts +0 -1
  96. package/dist/lib/upstream/sync-package-json.js +7 -0
  97. package/dist/lib/upstream/sync-package-json.js.map +1 -1
  98. package/dist/lib/upstream/sync-package-manager.d.ts +14 -4
  99. package/dist/lib/upstream/sync-package-manager.js +405 -72
  100. package/dist/lib/upstream/sync-package-manager.js.map +1 -1
  101. package/dist/lib/upstream/sync-pielib-strategy.d.ts +2 -1
  102. package/dist/lib/upstream/sync-pielib-strategy.js +228 -110
  103. package/dist/lib/upstream/sync-pielib-strategy.js.map +1 -1
  104. package/dist/lib/upstream/sync-presets.d.ts +52 -0
  105. package/dist/lib/upstream/sync-presets.js +175 -0
  106. package/dist/lib/upstream/sync-presets.js.map +1 -0
  107. package/dist/lib/upstream/sync-react-strategy.d.ts +6 -1
  108. package/dist/lib/upstream/sync-react-strategy.js +342 -134
  109. package/dist/lib/upstream/sync-react-strategy.js.map +1 -1
  110. package/dist/lib/upstream/sync-source-edit.d.ts +14 -0
  111. package/dist/lib/upstream/sync-source-edit.js +89 -0
  112. package/dist/lib/upstream/sync-source-edit.js.map +1 -0
  113. package/dist/lib/upstream/sync-source-tree.d.ts +22 -0
  114. package/dist/lib/upstream/sync-source-tree.js +99 -0
  115. package/dist/lib/upstream/sync-source-tree.js.map +1 -0
  116. package/dist/lib/upstream/sync-strategy.d.ts +1 -1
  117. package/dist/lib/upstream/sync-strategy.js.map +1 -1
  118. package/dist/lib/upstream/sync-summary.d.ts +0 -1
  119. package/dist/lib/upstream/sync-summary.js.map +1 -1
  120. package/dist/lib/upstream/sync-transforms.d.ts +13 -11
  121. package/dist/lib/upstream/sync-transforms.js +23 -17
  122. package/dist/lib/upstream/sync-transforms.js.map +1 -1
  123. package/dist/lib/upstream/sync-vite-config.d.ts +13 -1
  124. package/dist/lib/upstream/sync-vite-config.js +65 -46
  125. package/dist/lib/upstream/sync-vite-config.js.map +1 -1
  126. package/dist/utils/compatibility.d.ts +13 -1
  127. package/dist/utils/compatibility.js +143 -2
  128. package/dist/utils/compatibility.js.map +1 -1
  129. package/dist/utils/conversion.d.ts +0 -1
  130. package/dist/utils/conversion.js.map +1 -1
  131. package/dist/utils/dependency-integrity.d.ts +37 -0
  132. package/dist/utils/dependency-integrity.js +557 -0
  133. package/dist/utils/dependency-integrity.js.map +1 -0
  134. package/dist/utils/git.d.ts +0 -1
  135. package/dist/utils/git.js.map +1 -1
  136. package/dist/utils/logger.d.ts +0 -1
  137. package/dist/utils/logger.js.map +1 -1
  138. package/dist/utils/package-json.d.ts +0 -1
  139. package/dist/utils/package-json.js.map +1 -1
  140. package/package.json +25 -8
  141. package/.compatibility/report.json +0 -2491
  142. package/.turbo/turbo-build.log +0 -1
  143. package/CHANGELOG.md +0 -8
  144. package/REFACTORING.md +0 -131
  145. package/bin/dev.js +0 -5
  146. package/dist/commands/dev/demo/index.d.ts.map +0 -1
  147. package/dist/commands/dev/test-bundler.d.ts.map +0 -1
  148. package/dist/commands/mathquill/migrate.d.ts +0 -20
  149. package/dist/commands/mathquill/migrate.d.ts.map +0 -1
  150. package/dist/commands/mathquill/migrate.js +0 -240
  151. package/dist/commands/mathquill/migrate.js.map +0 -1
  152. package/dist/commands/mathquill/status.d.ts +0 -20
  153. package/dist/commands/mathquill/status.d.ts.map +0 -1
  154. package/dist/commands/mathquill/status.js +0 -231
  155. package/dist/commands/mathquill/status.js.map +0 -1
  156. package/dist/commands/packages/create-controllers.d.ts.map +0 -1
  157. package/dist/commands/packages/create-lib-react.d.ts.map +0 -1
  158. package/dist/commands/packages/create-react-elements.d.ts.map +0 -1
  159. package/dist/commands/packages/enable-publishing.d.ts.map +0 -1
  160. package/dist/commands/packages/init-synced-elements.d.ts.map +0 -1
  161. package/dist/commands/upstream/analyze-esm.d.ts.map +0 -1
  162. package/dist/commands/upstream/check.d.ts.map +0 -1
  163. package/dist/commands/upstream/deps.d.ts.map +0 -1
  164. package/dist/commands/upstream/sync-mathquill.d.ts +0 -12
  165. package/dist/commands/upstream/sync-mathquill.d.ts.map +0 -1
  166. package/dist/commands/upstream/sync-mathquill.js +0 -97
  167. package/dist/commands/upstream/sync-mathquill.js.map +0 -1
  168. package/dist/commands/upstream/sync.d.ts.map +0 -1
  169. package/dist/commands/upstream/track.d.ts.map +0 -1
  170. package/dist/commands/upstream/update.d.ts.map +0 -1
  171. package/dist/commands/verify/controllers.d.ts.map +0 -1
  172. package/dist/commands/verify/react-build.d.ts.map +0 -1
  173. package/dist/index.d.ts.map +0 -1
  174. package/dist/lib/mathquill/extension-generator.d.ts +0 -9
  175. package/dist/lib/mathquill/extension-generator.d.ts.map +0 -1
  176. package/dist/lib/mathquill/extension-generator.js +0 -107
  177. package/dist/lib/mathquill/extension-generator.js.map +0 -1
  178. package/dist/lib/mathquill/khan-extractor.d.ts +0 -16
  179. package/dist/lib/mathquill/khan-extractor.d.ts.map +0 -1
  180. package/dist/lib/mathquill/khan-extractor.js +0 -148
  181. package/dist/lib/mathquill/khan-extractor.js.map +0 -1
  182. package/dist/lib/mathquill/learnosity-extractor.d.ts +0 -15
  183. package/dist/lib/mathquill/learnosity-extractor.d.ts.map +0 -1
  184. package/dist/lib/mathquill/learnosity-extractor.js +0 -170
  185. package/dist/lib/mathquill/learnosity-extractor.js.map +0 -1
  186. package/dist/lib/mathquill/migration-orchestrator.d.ts +0 -77
  187. package/dist/lib/mathquill/migration-orchestrator.d.ts.map +0 -1
  188. package/dist/lib/mathquill/migration-orchestrator.js +0 -391
  189. package/dist/lib/mathquill/migration-orchestrator.js.map +0 -1
  190. package/dist/lib/mathquill/package-updater.d.ts +0 -9
  191. package/dist/lib/mathquill/package-updater.d.ts.map +0 -1
  192. package/dist/lib/mathquill/package-updater.js +0 -103
  193. package/dist/lib/mathquill/package-updater.js.map +0 -1
  194. package/dist/lib/mathquill/pie-extractor.d.ts +0 -14
  195. package/dist/lib/mathquill/pie-extractor.d.ts.map +0 -1
  196. package/dist/lib/mathquill/pie-extractor.js +0 -167
  197. package/dist/lib/mathquill/pie-extractor.js.map +0 -1
  198. package/dist/lib/upstream/repo-utils.d.ts.map +0 -1
  199. package/dist/lib/upstream/sync-compatibility.d.ts.map +0 -1
  200. package/dist/lib/upstream/sync-constants.d.ts.map +0 -1
  201. package/dist/lib/upstream/sync-controllers-strategy.d.ts.map +0 -1
  202. package/dist/lib/upstream/sync-demo-metadata.d.ts.map +0 -1
  203. package/dist/lib/upstream/sync-dev-exports.d.ts +0 -13
  204. package/dist/lib/upstream/sync-dev-exports.d.ts.map +0 -1
  205. package/dist/lib/upstream/sync-dev-exports.js +0 -115
  206. package/dist/lib/upstream/sync-dev-exports.js.map +0 -1
  207. package/dist/lib/upstream/sync-externals.d.ts.map +0 -1
  208. package/dist/lib/upstream/sync-filesystem.d.ts.map +0 -1
  209. package/dist/lib/upstream/sync-imports.d.ts.map +0 -1
  210. package/dist/lib/upstream/sync-mathquill.d.ts +0 -19
  211. package/dist/lib/upstream/sync-mathquill.d.ts.map +0 -1
  212. package/dist/lib/upstream/sync-mathquill.js +0 -160
  213. package/dist/lib/upstream/sync-mathquill.js.map +0 -1
  214. package/dist/lib/upstream/sync-package-json.d.ts.map +0 -1
  215. package/dist/lib/upstream/sync-package-manager.d.ts.map +0 -1
  216. package/dist/lib/upstream/sync-pielib-strategy.d.ts.map +0 -1
  217. package/dist/lib/upstream/sync-react-strategy.d.ts.map +0 -1
  218. package/dist/lib/upstream/sync-strategy.d.ts.map +0 -1
  219. package/dist/lib/upstream/sync-summary.d.ts.map +0 -1
  220. package/dist/lib/upstream/sync-transforms.d.ts.map +0 -1
  221. package/dist/lib/upstream/sync-vite-config.d.ts.map +0 -1
  222. package/dist/utils/compatibility.d.ts.map +0 -1
  223. package/dist/utils/conversion.d.ts.map +0 -1
  224. package/dist/utils/git.d.ts.map +0 -1
  225. package/dist/utils/logger.d.ts.map +0 -1
  226. package/dist/utils/package-json.d.ts.map +0 -1
  227. package/packages/cli/bin/dev.js +0 -5
  228. package/packages/cli/bin/run.js +0 -5
  229. package/src/commands/dev/demo/index.ts +0 -313
  230. package/src/commands/dev/test-bundler.ts +0 -345
  231. package/src/commands/mathquill/migrate.ts +0 -269
  232. package/src/commands/mathquill/status.ts +0 -267
  233. package/src/commands/packages/create-controllers.ts +0 -127
  234. package/src/commands/packages/create-lib-react.ts +0 -279
  235. package/src/commands/packages/create-react-elements.ts +0 -306
  236. package/src/commands/packages/enable-publishing.ts +0 -161
  237. package/src/commands/packages/init-synced-elements.ts +0 -259
  238. package/src/commands/upstream/README.md +0 -444
  239. package/src/commands/upstream/analyze-esm.ts +0 -1973
  240. package/src/commands/upstream/check.ts +0 -228
  241. package/src/commands/upstream/deps.ts +0 -222
  242. package/src/commands/upstream/sync-mathquill.ts +0 -108
  243. package/src/commands/upstream/sync.ts +0 -687
  244. package/src/commands/upstream/track.ts +0 -145
  245. package/src/commands/upstream/update.ts +0 -110
  246. package/src/commands/verify/controllers.ts +0 -166
  247. package/src/commands/verify/react-build.ts +0 -171
  248. package/src/index.ts +0 -1
  249. package/src/lib/mathquill/extension-generator.ts +0 -111
  250. package/src/lib/mathquill/khan-extractor.ts +0 -175
  251. package/src/lib/mathquill/learnosity-extractor.ts +0 -198
  252. package/src/lib/mathquill/migration-orchestrator.ts +0 -513
  253. package/src/lib/mathquill/package-updater.ts +0 -120
  254. package/src/lib/mathquill/pie-extractor.ts +0 -194
  255. package/src/lib/upstream/repo-utils.ts +0 -18
  256. package/src/lib/upstream/sync-compatibility.ts +0 -89
  257. package/src/lib/upstream/sync-constants.ts +0 -77
  258. package/src/lib/upstream/sync-controllers-strategy.ts +0 -291
  259. package/src/lib/upstream/sync-demo-metadata.ts +0 -199
  260. package/src/lib/upstream/sync-dev-exports.ts +0 -151
  261. package/src/lib/upstream/sync-externals.ts +0 -159
  262. package/src/lib/upstream/sync-filesystem.ts +0 -87
  263. package/src/lib/upstream/sync-imports.ts +0 -992
  264. package/src/lib/upstream/sync-mathquill.ts +0 -194
  265. package/src/lib/upstream/sync-package-json.ts +0 -86
  266. package/src/lib/upstream/sync-package-manager.ts +0 -694
  267. package/src/lib/upstream/sync-pielib-strategy.ts +0 -441
  268. package/src/lib/upstream/sync-react-strategy.ts +0 -945
  269. package/src/lib/upstream/sync-strategy.ts +0 -61
  270. package/src/lib/upstream/sync-summary.ts +0 -194
  271. package/src/lib/upstream/sync-transforms.ts +0 -154
  272. package/src/lib/upstream/sync-vite-config.ts +0 -243
  273. package/src/types/es-module-lexer.d.ts +0 -4
  274. package/src/utils/compatibility.ts +0 -182
  275. package/src/utils/conversion.ts +0 -153
  276. package/src/utils/git.ts +0 -63
  277. package/src/utils/logger.ts +0 -69
  278. package/src/utils/package-json.ts +0 -43
  279. package/tests/sync-package-manager.test.ts +0 -112
  280. package/tests/transform-assign-props.test.ts +0 -101
  281. package/tsconfig.json +0 -15
@@ -1,687 +0,0 @@
1
- import { Command, Flags } from '@oclif/core';
2
- import { Logger } from '../../utils/logger.js';
3
- import { loadCompatibilityReport, type CompatibilityReport } from '../../utils/compatibility.js';
4
- import { getCurrentCommit } from '../../utils/git.js';
5
- import { printSyncSummary, createEmptySummary } from '../../lib/upstream/sync-summary.js';
6
- import { loadPackageJson, type PackageJson } from '../../utils/package-json.js';
7
- import { spawn } from 'node:child_process';
8
- import { existsSync } from 'node:fs';
9
- import { join } from 'node:path';
10
- import { readdir } from '../../lib/upstream/sync-filesystem.js';
11
- import { getAllDeps } from '../../lib/upstream/sync-package-json.js';
12
- import { ControllersStrategy } from '../../lib/upstream/sync-controllers-strategy.js';
13
- import { ReactComponentsStrategy } from '../../lib/upstream/sync-react-strategy.js';
14
- import { PieLibStrategy } from '../../lib/upstream/sync-pielib-strategy.js';
15
- import type { SyncStrategy, SyncContext } from '../../lib/upstream/sync-strategy.js';
16
- import { DEFAULT_PATHS, COMPATIBILITY_FILE, WORKSPACE } from '../../lib/upstream/sync-constants.js';
17
- import { assertReposExist } from '../../lib/upstream/repo-utils.js';
18
- import { addDevelopmentExports } from '../../lib/upstream/sync-dev-exports.js';
19
-
20
- interface SyncConfig {
21
- pieElements: string;
22
- pieLib: string;
23
- pieElementsNg: string;
24
-
25
- // What to sync
26
- syncControllers: boolean;
27
- syncReactComponents: boolean;
28
- syncPieLibPackages: boolean;
29
-
30
- // Filters
31
- elements?: string[];
32
- pieLibPackages?: string[];
33
- elementsSpecifiedByUser: boolean;
34
- pieLibPackagesSpecifiedByUser: boolean;
35
-
36
- // ESM compatibility
37
- useEsmFilter: boolean;
38
- compatibilityFile: string;
39
-
40
- // Options
41
- dryRun: boolean;
42
- verbose: boolean;
43
- rewritePackageJson: boolean;
44
- skipBuild: boolean;
45
-
46
- // Internal: auto-sync pie-lib deps for selected elements
47
- autoSyncPieLibDeps: boolean;
48
- }
49
-
50
- interface SyncResult {
51
- filesChecked: number;
52
- filesCopied: number;
53
- filesSkipped: number;
54
- filesUpdated: number;
55
- errors: string[];
56
- warnings: string[];
57
- }
58
-
59
- export default class Sync extends Command {
60
- static override description = 'Synchronize code from upstream pie-elements repository';
61
-
62
- static override examples = [
63
- '<%= config.bin %> <%= command.id %> --dry-run',
64
- '<%= config.bin %> <%= command.id %> --element=multiple-choice',
65
- '<%= config.bin %> <%= command.id %>',
66
- ];
67
-
68
- static override flags = {
69
- 'dry-run': Flags.boolean({
70
- description: 'Show what would be synced without making changes',
71
- default: false,
72
- }),
73
- verbose: Flags.boolean({
74
- char: 'v',
75
- description: 'Show detailed output',
76
- default: false,
77
- }),
78
- element: Flags.string({
79
- description: 'Sync only specified element (if ESM-compatible)',
80
- }),
81
- };
82
-
83
- private logger = new Logger();
84
- private touchedElementPackages = new Set<string>();
85
- private touchedPieLibPackages = new Set<string>();
86
-
87
- public async run(): Promise<void> {
88
- const { flags } = await this.parse(Sync);
89
-
90
- this.logger = new Logger(flags.verbose);
91
-
92
- const config: SyncConfig = {
93
- pieElements: DEFAULT_PATHS.PIE_ELEMENTS,
94
- pieLib: DEFAULT_PATHS.PIE_LIB,
95
- pieElementsNg: DEFAULT_PATHS.PIE_ELEMENTS_NG,
96
- syncControllers: true,
97
- syncReactComponents: true,
98
- syncPieLibPackages: false,
99
- useEsmFilter: true,
100
- compatibilityFile: COMPATIBILITY_FILE,
101
- dryRun: flags['dry-run'],
102
- verbose: flags.verbose,
103
- rewritePackageJson: true,
104
- skipBuild: false,
105
- autoSyncPieLibDeps: true,
106
- elementsSpecifiedByUser: !!flags.element,
107
- pieLibPackagesSpecifiedByUser: false,
108
- };
109
-
110
- // Configure filters
111
- if (flags.element) {
112
- config.elements = [flags.element];
113
- }
114
-
115
- await this.syncUpstream(config);
116
- }
117
-
118
- private async syncUpstream(config: SyncConfig): Promise<void> {
119
- const syncSummary = createEmptySummary();
120
-
121
- const result: SyncResult = {
122
- filesChecked: 0,
123
- filesCopied: 0,
124
- filesSkipped: 0,
125
- filesUpdated: 0,
126
- errors: [],
127
- warnings: [],
128
- };
129
-
130
- // Reset touched packages for this run
131
- this.touchedElementPackages = new Set<string>();
132
- this.touchedPieLibPackages = new Set<string>();
133
-
134
- this.logger.section('🔄 Syncing from upstream');
135
- this.logger.info(` Source: ${config.pieElements}`);
136
- this.logger.info(` Destination: ${config.pieElementsNg}/packages/`);
137
- this.logger.info(` Mode: ${config.dryRun ? 'DRY RUN' : 'LIVE'}\n`);
138
-
139
- // Apply ESM compatibility filter (also returns report for summary)
140
- const compatibilityReport = await this.applyEsmFilter(config);
141
-
142
- // Auto-sync pie-lib dependencies for selected elements (unless explicit pie-lib mode)
143
- if (config.autoSyncPieLibDeps) {
144
- const elementsToSync = await this.listElementPackages(config);
145
- const requiredPieLib = await this.collectPieLibDepsFromElements(config, elementsToSync);
146
- if (requiredPieLib.length > 0) {
147
- config.syncPieLibPackages = true;
148
- config.pieLibPackages = requiredPieLib;
149
- if (config.verbose) {
150
- this.logger.info(
151
- ` Auto pie-lib deps: ${requiredPieLib.length} package(s) required by selected elements`
152
- );
153
- }
154
- }
155
- }
156
-
157
- // Merge with ESM-compatible pie-lib packages from compatibility report
158
- // (This ensures packages like controller-utils that are imported in controllers but not declared in package.json get synced)
159
- // BUT: Only merge ALL packages when doing a full sync (no specific elements specified)
160
- // When syncing specific elements, only sync the required deps (don't merge all 23 compat packages)
161
- if (compatibilityReport?.pieLibPackages && compatibilityReport.pieLibPackages.length > 0) {
162
- config.syncPieLibPackages = true;
163
- const autoDeps = new Set(config.pieLibPackages || []);
164
-
165
- // Only merge all compatible packages when doing a full sync
166
- if (!config.elementsSpecifiedByUser) {
167
- const compatiblePkgs = compatibilityReport.pieLibPackages;
168
- const merged = new Set([...autoDeps, ...compatiblePkgs]);
169
- config.pieLibPackages = Array.from(merged);
170
-
171
- const additionalCount = config.pieLibPackages.length - autoDeps.size;
172
- if (config.verbose && additionalCount > 0) {
173
- this.logger.info(
174
- ` Additional ESM-compatible pie-lib: ${additionalCount} package(s) from compatibility report`
175
- );
176
- }
177
- } else {
178
- // For targeted element sync, only sync required deps (don't bloat with all 23 packages)
179
- if (config.verbose && autoDeps.size > 0) {
180
- this.logger.info(
181
- ` Targeted sync: ${autoDeps.size} pie-lib package(s) required by ${config.elements?.[0]}`
182
- );
183
- }
184
- }
185
- }
186
-
187
- // Verify repos exist
188
- try {
189
- assertReposExist([{ label: 'pie-elements', path: config.pieElements }]);
190
- } catch (error) {
191
- this.logger.error(error instanceof Error ? error.message : String(error));
192
- this.error('Sync failed', { exit: 1 });
193
- }
194
-
195
- // Clean target directories first (ensures a clean slate for full syncs)
196
- await this.cleanTargetDirectories(config);
197
-
198
- // Execute sync strategies
199
- const strategies: SyncStrategy[] = [
200
- new ControllersStrategy(),
201
- new ReactComponentsStrategy(),
202
- new PieLibStrategy(),
203
- ];
204
-
205
- const context: SyncContext = {
206
- config: {
207
- pieElements: config.pieElements,
208
- pieLib: config.pieLib,
209
- pieElementsNg: config.pieElementsNg,
210
- syncControllers: config.syncControllers,
211
- syncReactComponents: config.syncReactComponents,
212
- syncPieLib: config.syncPieLibPackages,
213
- pieLibPackages: config.pieLibPackages,
214
- skipDemos: true,
215
- upstreamCommit: getCurrentCommit(config.pieElements),
216
- },
217
- logger: this.logger,
218
- // Only set packageFilter if user explicitly specified a single element
219
- packageFilter: config.elementsSpecifiedByUser ? config.elements?.[0] : undefined,
220
- compatibilityReport: compatibilityReport || undefined,
221
- };
222
-
223
- for (const strategy of strategies) {
224
- if (strategy.shouldRun(context.config)) {
225
- const result = await strategy.execute(context);
226
-
227
- // Track by strategy type
228
- const desc = strategy.getDescription();
229
- if (desc === 'controllers') {
230
- syncSummary.controllersSync = result.count;
231
- } else if (desc === 'React components') {
232
- syncSummary.reactComponentsSynced = result.count;
233
- // Track touched React element packages for build
234
- for (const pkgName of result.packageNames) {
235
- // Only add element packages (not @pie-lib packages)
236
- if (!pkgName.startsWith('@pie-lib/')) {
237
- this.touchedElementPackages.add(pkgName);
238
- }
239
- }
240
- } else if (desc === '@pie-lib packages') {
241
- syncSummary.pieLibPackagesSynced = result.count;
242
- // Track touched pie-lib packages for build
243
- for (const pkgName of result.packageNames) {
244
- if (pkgName.startsWith('@pie-lib/')) {
245
- const libName = pkgName.replace('@pie-lib/', '');
246
- this.touchedPieLibPackages.add(libName);
247
- }
248
- }
249
- }
250
- syncSummary.totalPackagesSynced += result.count;
251
- // Add unique package names (avoid duplicates from multiple strategies syncing same package)
252
- for (const pkgName of result.packageNames) {
253
- if (!syncSummary.syncedPackageNames.includes(pkgName)) {
254
- syncSummary.syncedPackageNames.push(pkgName);
255
- }
256
- }
257
- }
258
- }
259
-
260
- // Ensure external dependencies from synced packages are available at repo root.
261
- if (!config.dryRun) {
262
- await this.rewriteWorkspaceDependencies(config);
263
- }
264
-
265
- // Add development export conditions for HMR support
266
- if (!config.dryRun && this.touchedElementPackages.size > 0) {
267
- await this.addDevelopmentExportsToPackages(config);
268
- }
269
-
270
- // Build by default (unless dry-run or explicitly skipped)
271
- if (!config.dryRun && !config.skipBuild) {
272
- await this.buildTouchedPackages(config, result);
273
- }
274
-
275
- // Add blocked package counts from compatibility report
276
- if (compatibilityReport) {
277
- syncSummary.blockedElements = Object.keys(compatibilityReport.blockedElements).length;
278
- syncSummary.blockedPieLib = Object.values(compatibilityReport.pieLibDetails).filter(
279
- (d) => !d.compatible
280
- ).length;
281
- }
282
-
283
- // Demo metadata generation removed - demos are now tracked in git
284
- // and managed directly in this repository (not synced from upstream)
285
-
286
- // Print summary and handle errors
287
- printSyncSummary(syncSummary, compatibilityReport, config.pieElementsNg, this.logger);
288
-
289
- if (result.errors.length > 0) {
290
- this.error('Sync completed with errors', { exit: 1 });
291
- }
292
- }
293
-
294
- private async applyEsmFilter(config: SyncConfig): Promise<CompatibilityReport | null> {
295
- if (!config.useEsmFilter) {
296
- return null;
297
- }
298
-
299
- let report: CompatibilityReport | null = null;
300
- try {
301
- report = await loadCompatibilityReport(config.compatibilityFile);
302
- } catch (error) {
303
- this.logger.warn(`⚠️ ESM compatibility file not found at ${config.compatibilityFile}`);
304
- this.logger.warn(' Run: bun cli upstream:analyze-esm to generate it');
305
- this.logger.warn(' Proceeding without ESM filter...\n');
306
- return null;
307
- }
308
-
309
- if (!report) {
310
- return null;
311
- }
312
-
313
- this.logger.info(`📋 Using ESM compatibility filter from ${config.compatibilityFile}`);
314
- this.logger.info(` Last analyzed: ${new Date(report.lastAnalyzed).toLocaleString()}`);
315
- this.logger.info(` Compatible elements: ${report.elements.length}`);
316
- this.logger.info(` Compatible pie-lib packages: ${report.pieLibPackages.length}`);
317
-
318
- if (Object.keys(report.blockedElements).length > 0) {
319
- this.logger.info(` Blocked elements: ${Object.keys(report.blockedElements).length}`);
320
- }
321
- this.log('');
322
-
323
- // If user hasn't specified elements, use the compatible list
324
- if (!config.elements) {
325
- config.elements = report.elements;
326
- } else {
327
- // User specified elements - filter to only compatible ones
328
- const incompatible = config.elements.filter((el) => !report.elements.includes(el));
329
- if (incompatible.length > 0) {
330
- this.logger.warn('⚠️ Warning: These elements are not ESM-compatible and will be skipped:');
331
- for (const el of incompatible) {
332
- const blockers = report.blockedElements[el] || [];
333
- this.logger.warn(` - ${el}${blockers.length > 0 ? `: ${blockers[0]}` : ''}`);
334
- }
335
- this.log('');
336
- config.elements = config.elements.filter((el) => report.elements.includes(el));
337
- }
338
- }
339
-
340
- // If syncing pie-lib packages, use the compatible list
341
- if (config.syncPieLibPackages && !config.pieLibPackages) {
342
- config.pieLibPackages = report.pieLibPackages;
343
- }
344
-
345
- return report;
346
- }
347
-
348
- private async listElementPackages(config: SyncConfig): Promise<string[]> {
349
- if (config.elements && config.elements.length > 0) {
350
- return config.elements;
351
- }
352
-
353
- const upstreamElementsDir = join(config.pieElements, 'packages');
354
- return await readdir(upstreamElementsDir);
355
- }
356
-
357
- private async collectPieLibDepsFromElements(
358
- config: SyncConfig,
359
- elements: string[]
360
- ): Promise<string[]> {
361
- const deps = new Set<string>();
362
-
363
- for (const element of elements) {
364
- const pkgPath = join(config.pieElements, 'packages', element, 'package.json');
365
- if (!existsSync(pkgPath)) {
366
- continue;
367
- }
368
- const pkg = (await loadPackageJson(pkgPath)) as PackageJson | null;
369
- const pkgDeps = getAllDeps(pkg);
370
- for (const name of Object.keys(pkgDeps)) {
371
- if (name.startsWith(WORKSPACE.PIE_LIB_PREFIX)) {
372
- deps.add(name.replace(WORKSPACE.PIE_LIB_PREFIX, ''));
373
- }
374
- }
375
- }
376
-
377
- return await this.expandPieLibDeps(config, Array.from(deps));
378
- }
379
-
380
- private async expandPieLibDeps(config: SyncConfig, initial: string[]): Promise<string[]> {
381
- const seen = new Set<string>();
382
- const queue = [...initial];
383
-
384
- while (queue.length > 0) {
385
- const pkg = queue.shift();
386
- if (!pkg || seen.has(pkg)) continue;
387
- seen.add(pkg);
388
-
389
- const pkgPath = join(config.pieLib, 'packages', pkg, 'package.json');
390
- if (!existsSync(pkgPath)) continue;
391
- const pkgJson = (await loadPackageJson(pkgPath)) as PackageJson | null;
392
- const deps = getAllDeps(pkgJson);
393
- for (const name of Object.keys(deps)) {
394
- if (name.startsWith(WORKSPACE.PIE_LIB_PREFIX)) {
395
- const depName = name.replace(WORKSPACE.PIE_LIB_PREFIX, '');
396
- if (!seen.has(depName)) queue.push(depName);
397
- }
398
- }
399
- }
400
-
401
- return Array.from(seen).sort();
402
- }
403
-
404
- private async cleanTargetDirectories(config: SyncConfig): Promise<void> {
405
- if (!config.useEsmFilter || config.dryRun) return;
406
-
407
- // NOTE: We intentionally do NOT delete the entire packages/elements-react/ directory
408
- // because that would delete locally-maintained content like docs/demo/config.mjs files.
409
- // Instead, each sync strategy (ReactComponentsStrategy, PieLibStrategy, etc.) handles
410
- // cleaning individual package directories while preserving specific subdirectories
411
- // (like docs/ and controller/).
412
- //
413
- // This approach ensures:
414
- // 1. Demo configs (docs/demo/*.mjs) are preserved across syncs
415
- // 2. Controllers (src/controller/) are preserved during React component sync
416
- // 3. Only the files that need updating are touched
417
- }
418
-
419
- private async checkViteAvailable(config: SyncConfig): Promise<boolean> {
420
- return new Promise<boolean>((resolve) => {
421
- const child = spawn('bun', ['x', 'vite', '--version'], {
422
- cwd: config.pieElementsNg,
423
- stdio: 'pipe',
424
- env: process.env,
425
- });
426
- let output = '';
427
- child.stdout?.on('data', (data) => {
428
- output += data.toString();
429
- });
430
- child.stderr?.on('data', (data) => {
431
- output += data.toString();
432
- });
433
- child.on('close', (code) => {
434
- resolve(code === 0);
435
- });
436
- child.on('error', () => {
437
- resolve(false);
438
- });
439
- });
440
- }
441
-
442
- private async rewriteWorkspaceDependencies(config: SyncConfig): Promise<void> {
443
- this.logger.section('🔧 Rewriting workspace dependencies');
444
-
445
- // Discover available packages in the workspace
446
- const libReactDir = join(config.pieElementsNg, 'packages/lib-react');
447
- const elementsReactDir = join(config.pieElementsNg, 'packages/elements-react');
448
- const sharedDir = join(config.pieElementsNg, 'packages/shared');
449
-
450
- const availableLibPackages = new Set<string>();
451
- const availableElementPackages = new Set<string>();
452
-
453
- if (existsSync(libReactDir)) {
454
- const libPackages = await readdir(libReactDir);
455
- for (const pkg of libPackages) {
456
- if (existsSync(join(libReactDir, pkg, 'package.json'))) {
457
- availableLibPackages.add(pkg);
458
- }
459
- }
460
- }
461
-
462
- if (existsSync(elementsReactDir)) {
463
- const elementPackages = await readdir(elementsReactDir);
464
- for (const pkg of elementPackages) {
465
- if (existsSync(join(elementsReactDir, pkg, 'package.json'))) {
466
- availableElementPackages.add(pkg);
467
- }
468
- }
469
- }
470
-
471
- // Also scan shared packages - these are @pie-element/shared-* packages
472
- if (existsSync(sharedDir)) {
473
- const sharedPackages = await readdir(sharedDir);
474
- for (const pkg of sharedPackages) {
475
- if (existsSync(join(sharedDir, pkg, 'package.json'))) {
476
- // Shared packages use the pattern @pie-element/shared-{name}
477
- // But the directory is just {name}, so we need to add the "shared-" prefix
478
- availableElementPackages.add(`shared-${pkg}`);
479
- }
480
- }
481
- }
482
-
483
- this.logger.info(` Found ${availableLibPackages.size} lib-react packages`);
484
- this.logger.info(
485
- ` Found ${availableElementPackages.size} elements-react packages (including shared)\n`
486
- );
487
-
488
- // Scan and rewrite package.json files
489
- const packagesToCheck: string[] = [];
490
-
491
- // Add lib-react packages
492
- for (const pkg of availableLibPackages) {
493
- packagesToCheck.push(join(libReactDir, pkg));
494
- }
495
-
496
- // Add elements-react packages (non-shared)
497
- if (existsSync(elementsReactDir)) {
498
- const elementPackages = await readdir(elementsReactDir);
499
- for (const pkg of elementPackages) {
500
- if (existsSync(join(elementsReactDir, pkg, 'package.json'))) {
501
- packagesToCheck.push(join(elementsReactDir, pkg));
502
- }
503
- }
504
- }
505
-
506
- // Note: We don't check shared packages because they are managed separately
507
- // and don't have dependencies on synced packages
508
-
509
- let totalRemoved = 0;
510
- const removedDeps: Array<{ pkg: string; dep: string }> = [];
511
-
512
- for (const pkgPath of packagesToCheck) {
513
- const pkgJsonPath = join(pkgPath, 'package.json');
514
- const pkgJson = (await loadPackageJson(pkgJsonPath)) as PackageJson | null;
515
-
516
- if (!pkgJson || !pkgJson.dependencies) {
517
- continue;
518
- }
519
-
520
- const pkgName = pkgJson.name || pkgPath;
521
- let modified = false;
522
- const depsToRemove: string[] = [];
523
-
524
- for (const [dep, version] of Object.entries(pkgJson.dependencies)) {
525
- // Only check workspace dependencies
526
- if (!version.startsWith('workspace:')) {
527
- continue;
528
- }
529
-
530
- // Check @pie-lib/* dependencies
531
- if (dep.startsWith(WORKSPACE.PIE_LIB_PREFIX)) {
532
- const libName = dep.replace(WORKSPACE.PIE_LIB_PREFIX, '');
533
- if (!availableLibPackages.has(libName)) {
534
- depsToRemove.push(dep);
535
- removedDeps.push({ pkg: pkgName, dep });
536
- modified = true;
537
- }
538
- }
539
-
540
- // Check @pie-element/* dependencies
541
- if (dep.startsWith(WORKSPACE.PIE_ELEMENT_PREFIX)) {
542
- const elementName = dep.replace(WORKSPACE.PIE_ELEMENT_PREFIX, '');
543
- if (!availableElementPackages.has(elementName)) {
544
- depsToRemove.push(dep);
545
- removedDeps.push({ pkg: pkgName, dep });
546
- modified = true;
547
- }
548
- }
549
- }
550
-
551
- if (modified) {
552
- // Remove the invalid dependencies
553
- for (const dep of depsToRemove) {
554
- delete pkgJson.dependencies[dep];
555
- totalRemoved++;
556
- }
557
-
558
- // Write back the modified package.json
559
- const fs = await import('node:fs/promises');
560
- await fs.writeFile(pkgJsonPath, JSON.stringify(pkgJson, null, 2) + '\n', 'utf-8');
561
- }
562
- }
563
-
564
- if (totalRemoved > 0) {
565
- this.logger.info(` Removed ${totalRemoved} invalid workspace dependencies:\n`);
566
- for (const { pkg, dep } of removedDeps) {
567
- this.logger.info(` - ${dep} from ${pkg}`);
568
- }
569
- this.log('');
570
- } else {
571
- this.logger.info(' ✓ All workspace dependencies are valid\n');
572
- }
573
-
574
- // Run bun install to update the lockfile
575
- this.logger.info(' Running bun install to update lockfile...');
576
- const exitCode = await new Promise<number>((resolve) => {
577
- const child = spawn('bun', ['install'], {
578
- cwd: config.pieElementsNg,
579
- stdio: 'inherit',
580
- env: process.env,
581
- });
582
- child.on('close', (code) => resolve(code ?? 1));
583
- child.on('error', () => resolve(1));
584
- });
585
-
586
- if (exitCode !== 0) {
587
- this.logger.warn(' ⚠️ bun install failed');
588
- } else {
589
- this.logger.info(' ✓ bun install completed successfully\n');
590
- }
591
- }
592
-
593
- private async addDevelopmentExportsToPackages(config: SyncConfig): Promise<void> {
594
- this.logger.section('🔧 Adding development export conditions');
595
-
596
- const elementsDir = join(config.pieElementsNg, 'packages/elements-react');
597
- const packageNames = Array.from(this.touchedElementPackages);
598
-
599
- if (packageNames.length === 0) {
600
- this.logger.debug(' No element packages to process');
601
- return;
602
- }
603
-
604
- const updated = await addDevelopmentExports(elementsDir, packageNames, this.logger);
605
-
606
- if (updated > 0) {
607
- this.logger.info(` ✓ Added development exports to ${updated} package(s)\n`);
608
- } else {
609
- this.logger.debug(' → No changes needed\n');
610
- }
611
- }
612
-
613
- private async buildTouchedPackages(config: SyncConfig, result: SyncResult): Promise<void> {
614
- const rootPkgPath = join(config.pieElementsNg, 'package.json');
615
- const rootPkg = (await loadPackageJson(rootPkgPath)) as PackageJson | null;
616
- const workspaces = Array.isArray(rootPkg?.workspaces) ? (rootPkg?.workspaces as string[]) : [];
617
- const hasElementsReactWorkspace = workspaces.some((ws) =>
618
- ws.startsWith('packages/elements-react')
619
- );
620
- const hasLibReactWorkspace = workspaces.some((ws) => ws.startsWith('packages/lib-react'));
621
-
622
- const elementFilters = Array.from(this.touchedElementPackages)
623
- .sort()
624
- .map((el) => `--filter=@pie-element/${el}`);
625
- const pieLibFilters = Array.from(this.touchedPieLibPackages)
626
- .sort()
627
- .map((pkg) => `--filter=@pie-lib/${pkg}`);
628
-
629
- const filters = [...elementFilters, ...pieLibFilters];
630
-
631
- if (
632
- (elementFilters.length > 0 && !hasElementsReactWorkspace) ||
633
- (pieLibFilters.length > 0 && !hasLibReactWorkspace)
634
- ) {
635
- this.logger.info(
636
- '🏗️ Build: Skipped (synced packages are not part of the current workspaces)'
637
- );
638
- this.logger.info(' Hint: add packages/elements-react/* and/or packages/lib-react/* to');
639
- this.logger.info(' root workspaces if you want turbo to build them.');
640
- return;
641
- }
642
-
643
- if (filters.length === 0) {
644
- if (config.verbose) {
645
- this.logger.info('🏗️ Build: Skipped (no touched packages detected)');
646
- }
647
- return;
648
- }
649
-
650
- // Check if vite is available before attempting to build
651
- const viteAvailable = await this.checkViteAvailable(config);
652
- if (!viteAvailable) {
653
- this.logger.warn(
654
- '🏗️ Build: Skipped (vite not found). Run "bun install" to install dependencies, then "bun run build" manually.'
655
- );
656
- return;
657
- }
658
-
659
- this.logger.section('🏗️ Building touched packages');
660
- this.logger.info(` Filters: ${filters.join(' ')}\n`);
661
-
662
- // turbo filters are passed through the root build script:
663
- // package.json: "build": "turbo run build"
664
- // bun run requires `--` to forward args to the script.
665
- // Always use --force to disable Turbo cache for consistency
666
- const args = ['run', 'build', '--', '--force', ...filters];
667
-
668
- const exitCode = await new Promise<number>((resolve) => {
669
- const child = spawn('bun', args, {
670
- cwd: config.pieElementsNg,
671
- stdio: 'inherit',
672
- env: process.env,
673
- });
674
- child.on('close', (code) => resolve(code ?? 1));
675
- child.on('error', () => resolve(1));
676
- });
677
-
678
- if (exitCode !== 0) {
679
- const errorMsg = `Build failed (exit code ${exitCode}). This may be due to missing dependencies. Run 'bun install' to install new devDependencies, then 'bun run build' manually.`;
680
- if (config.skipBuild) {
681
- this.logger.warn(` ⚠️ ${errorMsg}`);
682
- } else {
683
- result.errors.push(errorMsg);
684
- }
685
- }
686
- }
687
- }