@fugood/bricks-project 2.25.0-beta.6 → 2.25.0-beta.60

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 (176) hide show
  1. package/compile/action-name-map.ts +64 -0
  2. package/compile/config-diff.ts +155 -0
  3. package/compile/index.ts +668 -352
  4. package/compile/util.ts +134 -10
  5. package/package.json +8 -3
  6. package/package.json.bak +8 -3
  7. package/skills/bricks-ctor/SKILL.md +23 -17
  8. package/skills/bricks-ctor/{rules → references}/animation.md +3 -2
  9. package/skills/bricks-ctor/{rules → references}/architecture-patterns.md +19 -0
  10. package/skills/bricks-ctor/{rules → references}/automations.md +11 -0
  11. package/skills/bricks-ctor/references/buttress.md +245 -0
  12. package/skills/bricks-ctor/references/data-calculation.md +252 -0
  13. package/skills/bricks-ctor/{rules → references}/media-flow.md +7 -0
  14. package/skills/bricks-ctor/references/simulator.md +132 -0
  15. package/skills/bricks-ctor/references/source-editing-tools.md +81 -0
  16. package/skills/bricks-ctor/references/verification-toolchain.md +200 -0
  17. package/skills/bricks-design/SKILL.md +150 -45
  18. package/skills/bricks-design/references/architecture-truths.md +132 -0
  19. package/skills/bricks-design/references/avoiding-complexity.md +91 -0
  20. package/skills/bricks-design/references/design-critique.md +195 -0
  21. package/skills/bricks-design/references/design-languages.md +265 -0
  22. package/skills/bricks-design/references/performance.md +116 -0
  23. package/skills/bricks-design/references/presentation-and-slideshow.md +137 -0
  24. package/skills/bricks-design/references/translating-inputs.md +152 -0
  25. package/skills/bricks-design/references/variations-and-tweaks.md +124 -0
  26. package/skills/bricks-design/references/when-the-brief-is-branded.md +284 -0
  27. package/skills/bricks-design/references/when-the-brief-is-vague.md +85 -0
  28. package/skills/bricks-design/references/workflow.md +134 -0
  29. package/skills/bricks-ux/SKILL.md +114 -0
  30. package/skills/bricks-ux/references/accessibility.md +162 -0
  31. package/skills/bricks-ux/references/flow-states.md +175 -0
  32. package/skills/bricks-ux/references/interaction-archetypes.md +189 -0
  33. package/skills/bricks-ux/references/monitoring-screens.md +153 -0
  34. package/skills/bricks-ux/references/pressable-composition.md +126 -0
  35. package/skills/bricks-ux/references/user-journey.md +168 -0
  36. package/skills/bricks-ux/references/ux-critique.md +256 -0
  37. package/tools/_cli-error.ts +17 -0
  38. package/tools/_edits-log.ts +41 -0
  39. package/tools/_git-author.ts +10 -2
  40. package/tools/_last-pushed-commit.ts +28 -0
  41. package/tools/_mcp-config.ts +42 -0
  42. package/tools/_shell.ts +8 -1
  43. package/tools/deploy.ts +17 -6
  44. package/tools/mcp-env.ts +13 -0
  45. package/tools/mcp-server.ts +8 -0
  46. package/tools/mcp-tools/_editing-helpers.ts +98 -0
  47. package/tools/mcp-tools/_verify.ts +50 -0
  48. package/tools/mcp-tools/compile.ts +21 -9
  49. package/tools/mcp-tools/data-calc-editing.ts +1311 -0
  50. package/tools/mcp-tools/entry-editing.ts +2297 -0
  51. package/tools/mcp-tools/huggingface.ts +23 -13
  52. package/tools/mcp-tools/icons.ts +23 -7
  53. package/tools/mcp-tools/media.ts +4 -1
  54. package/tools/postinstall.ts +95 -38
  55. package/tools/pull.ts +100 -23
  56. package/tools/push-config.ts +114 -0
  57. package/tools/{preview-main.mjs → simulator-main.mjs} +207 -12
  58. package/tools/simulator-preload.cjs +16 -0
  59. package/tools/{preview.ts → simulator.ts} +4 -4
  60. package/types/{animation.ts → animation.d.ts} +24 -8
  61. package/types/{automation.ts → automation.d.ts} +16 -20
  62. package/types/{brick-base.ts → brick-base.d.ts} +1 -1
  63. package/types/bricks/{Camera.ts → Camera.d.ts} +8 -8
  64. package/types/bricks/{Chart.ts → Chart.d.ts} +4 -4
  65. package/types/bricks/{GenerativeMedia.ts → GenerativeMedia.d.ts} +15 -15
  66. package/types/bricks/{Icon.ts → Icon.d.ts} +7 -7
  67. package/types/bricks/{Image.ts → Image.d.ts} +21 -9
  68. package/types/bricks/{Items.ts → Items.d.ts} +11 -7
  69. package/types/bricks/{Lottie.ts → Lottie.d.ts} +10 -10
  70. package/types/bricks/{Maps.ts → Maps.d.ts} +11 -11
  71. package/types/bricks/{QrCode.ts → QrCode.d.ts} +7 -7
  72. package/types/bricks/{Rect.ts → Rect.d.ts} +7 -7
  73. package/types/bricks/{RichText.ts → RichText.d.ts} +12 -9
  74. package/types/bricks/{Rive.ts → Rive.d.ts} +9 -9
  75. package/types/bricks/Scene3D.d.ts +676 -0
  76. package/types/bricks/{Sketch.ts → Sketch.d.ts} +10 -8
  77. package/types/bricks/{Slideshow.ts → Slideshow.d.ts} +7 -7
  78. package/types/bricks/{Svg.ts → Svg.d.ts} +7 -7
  79. package/types/bricks/{Text.ts → Text.d.ts} +9 -9
  80. package/types/bricks/{TextInput.ts → TextInput.d.ts} +10 -10
  81. package/types/bricks/{Video.ts → Video.d.ts} +80 -13
  82. package/types/bricks/{VideoStreaming.ts → VideoStreaming.d.ts} +10 -10
  83. package/types/bricks/{WebRtcStream.ts → WebRtcStream.d.ts} +1 -1
  84. package/types/bricks/{WebView.ts → WebView.d.ts} +4 -4
  85. package/types/bricks/{index.ts → index.d.ts} +1 -0
  86. package/types/{common.ts → common.d.ts} +3 -6
  87. package/types/data-calc-command/base.d.ts +57 -0
  88. package/types/data-calc-command/collection.d.ts +418 -0
  89. package/types/data-calc-command/color.d.ts +432 -0
  90. package/types/data-calc-command/constant.d.ts +50 -0
  91. package/types/data-calc-command/datetime.d.ts +147 -0
  92. package/types/data-calc-command/file.d.ts +129 -0
  93. package/types/data-calc-command/index.d.ts +13 -0
  94. package/types/data-calc-command/iteratee.d.ts +23 -0
  95. package/types/data-calc-command/logictype.d.ts +190 -0
  96. package/types/data-calc-command/math.d.ts +275 -0
  97. package/types/data-calc-command/object.d.ts +119 -0
  98. package/types/data-calc-command/sandbox.d.ts +66 -0
  99. package/types/data-calc-command/string.d.ts +407 -0
  100. package/types/{data-calc.ts → data-calc.d.ts} +1 -0
  101. package/types/{data.ts → data.d.ts} +4 -2
  102. package/types/generators/{Assistant.ts → Assistant.d.ts} +19 -0
  103. package/types/generators/{HttpServer.ts → HttpServer.d.ts} +56 -2
  104. package/types/generators/{LlmGgml.ts → LlmGgml.d.ts} +43 -1
  105. package/types/generators/{LlmMlx.ts → LlmMlx.d.ts} +1 -0
  106. package/types/generators/{RerankerGgml.ts → RerankerGgml.d.ts} +5 -1
  107. package/types/generators/{SoundRecorder.ts → SoundRecorder.d.ts} +10 -1
  108. package/types/generators/{SpeechToTextGgml.ts → SpeechToTextGgml.d.ts} +6 -1
  109. package/types/generators/{SttAppleBuiltin.ts → SttAppleBuiltin.d.ts} +27 -4
  110. package/types/generators/{ThermalPrinter.ts → ThermalPrinter.d.ts} +9 -7
  111. package/types/generators/{Tick.ts → Tick.d.ts} +1 -1
  112. package/types/generators/{VadGgml.ts → VadGgml.d.ts} +12 -2
  113. package/types/{subspace.ts → subspace.d.ts} +1 -1
  114. package/utils/calc.ts +5 -1
  115. package/utils/data.ts +5 -7
  116. package/utils/event-props.ts +27 -1
  117. package/utils/id.ts +109 -56
  118. package/skills/bricks-ctor/rules/buttress.md +0 -156
  119. package/skills/bricks-ctor/rules/data-calculation.md +0 -209
  120. package/skills/bricks-design/LICENSE.txt +0 -180
  121. package/types/data-calc-command.ts +0 -7005
  122. /package/skills/bricks-ctor/{rules → references}/local-sync.md +0 -0
  123. /package/skills/bricks-ctor/{rules → references}/remote-data-bank.md +0 -0
  124. /package/skills/bricks-ctor/{rules → references}/standby-transition.md +0 -0
  125. /package/types/{canvas.ts → canvas.d.ts} +0 -0
  126. /package/types/{data-calc-script.ts → data-calc-script.d.ts} +0 -0
  127. /package/types/generators/{AlarmClock.ts → AlarmClock.d.ts} +0 -0
  128. /package/types/generators/{BleCentral.ts → BleCentral.d.ts} +0 -0
  129. /package/types/generators/{BlePeripheral.ts → BlePeripheral.d.ts} +0 -0
  130. /package/types/generators/{CanvasMap.ts → CanvasMap.d.ts} +0 -0
  131. /package/types/generators/{CastlesPay.ts → CastlesPay.d.ts} +0 -0
  132. /package/types/generators/{DataBank.ts → DataBank.d.ts} +0 -0
  133. /package/types/generators/{File.ts → File.d.ts} +0 -0
  134. /package/types/generators/{GraphQl.ts → GraphQl.d.ts} +0 -0
  135. /package/types/generators/{Http.ts → Http.d.ts} +0 -0
  136. /package/types/generators/{Information.ts → Information.d.ts} +0 -0
  137. /package/types/generators/{Intent.ts → Intent.d.ts} +0 -0
  138. /package/types/generators/{Iterator.ts → Iterator.d.ts} +0 -0
  139. /package/types/generators/{Keyboard.ts → Keyboard.d.ts} +0 -0
  140. /package/types/generators/{LlmAnthropicCompat.ts → LlmAnthropicCompat.d.ts} +0 -0
  141. /package/types/generators/{LlmAppleBuiltin.ts → LlmAppleBuiltin.d.ts} +0 -0
  142. /package/types/generators/{LlmMediaTekNeuroPilot.ts → LlmMediaTekNeuroPilot.d.ts} +0 -0
  143. /package/types/generators/{LlmOnnx.ts → LlmOnnx.d.ts} +0 -0
  144. /package/types/generators/{LlmOpenAiCompat.ts → LlmOpenAiCompat.d.ts} +0 -0
  145. /package/types/generators/{LlmQualcommAiEngine.ts → LlmQualcommAiEngine.d.ts} +0 -0
  146. /package/types/generators/{Mcp.ts → Mcp.d.ts} +0 -0
  147. /package/types/generators/{McpServer.ts → McpServer.d.ts} +0 -0
  148. /package/types/generators/{MediaFlow.ts → MediaFlow.d.ts} +0 -0
  149. /package/types/generators/{MqttBroker.ts → MqttBroker.d.ts} +0 -0
  150. /package/types/generators/{MqttClient.ts → MqttClient.d.ts} +0 -0
  151. /package/types/generators/{Question.ts → Question.d.ts} +0 -0
  152. /package/types/generators/{RealtimeTranscription.ts → RealtimeTranscription.d.ts} +0 -0
  153. /package/types/generators/{SerialPort.ts → SerialPort.d.ts} +0 -0
  154. /package/types/generators/{SoundPlayer.ts → SoundPlayer.d.ts} +0 -0
  155. /package/types/generators/{SpeechToTextOnnx.ts → SpeechToTextOnnx.d.ts} +0 -0
  156. /package/types/generators/{SpeechToTextPlatform.ts → SpeechToTextPlatform.d.ts} +0 -0
  157. /package/types/generators/{SqLite.ts → SqLite.d.ts} +0 -0
  158. /package/types/generators/{Step.ts → Step.d.ts} +0 -0
  159. /package/types/generators/{Tcp.ts → Tcp.d.ts} +0 -0
  160. /package/types/generators/{TcpServer.ts → TcpServer.d.ts} +0 -0
  161. /package/types/generators/{TextToSpeechAppleBuiltin.ts → TextToSpeechAppleBuiltin.d.ts} +0 -0
  162. /package/types/generators/{TextToSpeechGgml.ts → TextToSpeechGgml.d.ts} +0 -0
  163. /package/types/generators/{TextToSpeechOnnx.ts → TextToSpeechOnnx.d.ts} +0 -0
  164. /package/types/generators/{TextToSpeechOpenAiLike.ts → TextToSpeechOpenAiLike.d.ts} +0 -0
  165. /package/types/generators/{Udp.ts → Udp.d.ts} +0 -0
  166. /package/types/generators/{VadOnnx.ts → VadOnnx.d.ts} +0 -0
  167. /package/types/generators/{VadTraditional.ts → VadTraditional.d.ts} +0 -0
  168. /package/types/generators/{VectorStore.ts → VectorStore.d.ts} +0 -0
  169. /package/types/generators/{Watchdog.ts → Watchdog.d.ts} +0 -0
  170. /package/types/generators/{WebCrawler.ts → WebCrawler.d.ts} +0 -0
  171. /package/types/generators/{WebRtc.ts → WebRtc.d.ts} +0 -0
  172. /package/types/generators/{WebSocket.ts → WebSocket.d.ts} +0 -0
  173. /package/types/generators/{index.ts → index.d.ts} +0 -0
  174. /package/types/{index.ts → index.d.ts} +0 -0
  175. /package/types/{switch.ts → switch.d.ts} +0 -0
  176. /package/types/{system.ts → system.d.ts} +0 -0
@@ -350,6 +350,63 @@ export const templateActionNameMap = {
350
350
  strokeWidth: 'BRICK_SKETCH_STROKE_WIDTH',
351
351
  },
352
352
  },
353
+ BRICK_SCENE_3D: {
354
+ BRICK_SCENE_3D_ADD_OBJECT: {
355
+ objectId: 'BRICK_SCENE_3D_OBJECT_ID',
356
+ objectType: 'BRICK_SCENE_3D_OBJECT_TYPE',
357
+ objectUrl: 'BRICK_SCENE_3D_OBJECT_URL',
358
+ objectMd5: 'BRICK_SCENE_3D_OBJECT_MD5',
359
+ objectPosition: 'BRICK_SCENE_3D_OBJECT_POSITION',
360
+ objectRotation: 'BRICK_SCENE_3D_OBJECT_ROTATION',
361
+ objectScale: 'BRICK_SCENE_3D_OBJECT_SCALE',
362
+ objectColor: 'BRICK_SCENE_3D_OBJECT_COLOR',
363
+ },
364
+ BRICK_SCENE_3D_REMOVE_OBJECT: {
365
+ objectId: 'BRICK_SCENE_3D_OBJECT_ID',
366
+ },
367
+ BRICK_SCENE_3D_UPDATE_OBJECT: {
368
+ objectId: 'BRICK_SCENE_3D_OBJECT_ID',
369
+ objectPosition: 'BRICK_SCENE_3D_OBJECT_POSITION',
370
+ objectRotation: 'BRICK_SCENE_3D_OBJECT_ROTATION',
371
+ objectScale: 'BRICK_SCENE_3D_OBJECT_SCALE',
372
+ objectVisible: 'BRICK_SCENE_3D_OBJECT_VISIBLE',
373
+ objectColor: 'BRICK_SCENE_3D_OBJECT_COLOR',
374
+ objectNodes: 'BRICK_SCENE_3D_OBJECT_NODES',
375
+ },
376
+ BRICK_SCENE_3D_SET_CAMERA: {
377
+ cameraPosition: 'BRICK_SCENE_3D_CAMERA_POSITION',
378
+ cameraTarget: 'BRICK_SCENE_3D_CAMERA_TARGET',
379
+ cameraFov: 'BRICK_SCENE_3D_CAMERA_FOV',
380
+ cameraAnimateMs: 'BRICK_SCENE_3D_CAMERA_ANIMATE_MS',
381
+ },
382
+ BRICK_SCENE_3D_LOOK_AT: {
383
+ objectId: 'BRICK_SCENE_3D_OBJECT_ID',
384
+ },
385
+ BRICK_SCENE_3D_PLAY_ANIMATION: {
386
+ objectId: 'BRICK_SCENE_3D_OBJECT_ID',
387
+ animationName: 'BRICK_SCENE_3D_ANIMATION_NAME',
388
+ animationLoop: 'BRICK_SCENE_3D_ANIMATION_LOOP',
389
+ animationSpeed: 'BRICK_SCENE_3D_ANIMATION_SPEED',
390
+ },
391
+ BRICK_SCENE_3D_STOP_ANIMATION: {
392
+ objectId: 'BRICK_SCENE_3D_OBJECT_ID',
393
+ animationName: 'BRICK_SCENE_3D_ANIMATION_NAME',
394
+ },
395
+ BRICK_SCENE_3D_SET_BACKGROUND: {
396
+ backgroundColor: 'BRICK_SCENE_3D_BACKGROUND_COLOR',
397
+ backgroundHdrUrl: 'BRICK_SCENE_3D_BACKGROUND_HDR_URL',
398
+ backgroundMd5: 'BRICK_SCENE_3D_BACKGROUND_MD5',
399
+ },
400
+ BRICK_SCENE_3D_SET_CONTROLS: {
401
+ controlsEnabled: 'BRICK_SCENE_3D_CONTROLS_ENABLED',
402
+ controlsAutoRotate: 'BRICK_SCENE_3D_CONTROLS_AUTO_ROTATE',
403
+ controlsAutoRotateSpeed: 'BRICK_SCENE_3D_CONTROLS_AUTO_ROTATE_SPEED',
404
+ },
405
+ BRICK_SCENE_3D_SCREENSHOT: {
406
+ screenshotFormat: 'BRICK_SCENE_3D_SCREENSHOT_FORMAT',
407
+ screenshotQuality: 'BRICK_SCENE_3D_SCREENSHOT_QUALITY',
408
+ },
409
+ },
353
410
 
354
411
  GENERATOR_FILE: {
355
412
  GENERATOR_FILE_READ_CONTENT: {
@@ -782,6 +839,11 @@ export const templateActionNameMap = {
782
839
  seed: 'GENERATOR_LLM_SEED',
783
840
  typicalP: 'GENERATOR_LLM_TYPICAL_P',
784
841
  ignoreEos: 'GENERATOR_LLM_IGNORE_EOS',
842
+ mtpSpeculativeDecoding: 'GENERATOR_LLM_MTP_SPECULATIVE_DECODING',
843
+ mtpDraftTokens: 'GENERATOR_LLM_MTP_DRAFT_TOKENS',
844
+ mtpDraftMinTokens: 'GENERATOR_LLM_MTP_DRAFT_MIN_TOKENS',
845
+ mtpDraftMinProbability: 'GENERATOR_LLM_MTP_DRAFT_MIN_PROBABILITY',
846
+ mtpDraftSplitProbability: 'GENERATOR_LLM_MTP_DRAFT_SPLIT_PROBABILITY',
785
847
  functionCallEnabled: 'GENERATOR_LLM_FUNCTION_CALL_ENABLED',
786
848
  functionCallSchema: 'GENERATOR_LLM_FUNCTION_CALL_SCHEMA',
787
849
  },
@@ -894,10 +956,12 @@ export const templateActionNameMap = {
894
956
  GENERATOR_APPLE_STT_TRANSCRIBE_FILE: {
895
957
  fileUrl: 'GENERATOR_APPLE_STT_FILE_URL',
896
958
  language: 'GENERATOR_APPLE_STT_LANGUAGE',
959
+ contextualStrings: 'GENERATOR_APPLE_STT_CONTEXTUAL_STRINGS',
897
960
  },
898
961
  GENERATOR_APPLE_STT_TRANSCRIBE_DATA: {
899
962
  data: 'GENERATOR_APPLE_STT_DATA',
900
963
  language: 'GENERATOR_APPLE_STT_LANGUAGE',
964
+ contextualStrings: 'GENERATOR_APPLE_STT_CONTEXTUAL_STRINGS',
901
965
  },
902
966
  },
903
967
  GENERATOR_APPLE_TTS: {
@@ -0,0 +1,155 @@
1
+ import { readFile } from 'node:fs/promises'
2
+ import path from 'node:path'
3
+
4
+ // The compiled config artifact written by `bun compile` (see the generated
5
+ // project's `compile.ts`; bricks-project-generator/index.js:762).
6
+ export const BUILD_CONFIG_RELATIVE = '.bricks/build/application-config.json'
7
+
8
+ // `compile()` derives these top-level fields from `Date.now()`
9
+ // (compile/index.ts `title: \`${app.name}(${timestamp})\`` and `update_timestamp`),
10
+ // so they differ on every run regardless of source. Excluded from the comparison —
11
+ // only the *top-level* keys are dropped, so nested subspace/brick `title`s still diff.
12
+ const VOLATILE_TOP_LEVEL_FIELDS = ['title', 'update_timestamp']
13
+
14
+ // A minimal, path-keyed config change (Option A): a generic patch, not coupled to
15
+ // bricks-config-editor's action vocabulary. `path` is an array of object keys /
16
+ // array indices, ready for the editor's `setYValueAtPath` (or a delete) so applying
17
+ // the patch is a single Yjs `'local'` transaction == one undo/redo entry.
18
+ export type ConfigPatchOp =
19
+ | { op: 'set'; path: Array<string | number>; value: unknown }
20
+ | { op: 'unset'; path: Array<string | number> }
21
+
22
+ export type ConfigChange =
23
+ | { status: 'ok'; ops: ConfigPatchOp[]; opCount: number }
24
+ | { status: 'no_baseline' }
25
+ | { status: 'unavailable' }
26
+
27
+ const isRecord = (value: unknown): value is Record<string, unknown> =>
28
+ typeof value === 'object' && value !== null && !Array.isArray(value)
29
+
30
+ const isJsonDroppedValue = (value: unknown) =>
31
+ value === undefined || typeof value === 'function' || typeof value === 'symbol'
32
+
33
+ const toJsonComparableScalar = (value: unknown) => {
34
+ if (typeof value === 'number' && !Number.isFinite(value)) return null
35
+ return value
36
+ }
37
+
38
+ const toJsonCompatibleValue = (value: unknown): unknown => {
39
+ if (isJsonDroppedValue(value)) return undefined
40
+ if (Array.isArray(value)) {
41
+ return value.map((item) => (isJsonDroppedValue(item) ? null : toJsonCompatibleValue(item)))
42
+ }
43
+ if (isRecord(value)) {
44
+ return Object.entries(value).reduce((acc, [key, item]) => {
45
+ if (!isJsonDroppedValue(item)) acc[key] = toJsonCompatibleValue(item)
46
+ return acc
47
+ }, {})
48
+ }
49
+ return toJsonComparableScalar(value)
50
+ }
51
+
52
+ const hasJsonObjectKey = (value: Record<string, unknown>, key: string) =>
53
+ Object.prototype.hasOwnProperty.call(value, key) && !isJsonDroppedValue(value[key])
54
+
55
+ const getJsonArrayItem = (value: unknown[], index: number) => {
56
+ const item = value[index]
57
+ return isJsonDroppedValue(item) ? null : item
58
+ }
59
+
60
+ const deepEqual = (a: unknown, b: unknown): boolean => {
61
+ a = toJsonComparableScalar(a)
62
+ b = toJsonComparableScalar(b)
63
+ if (a === b) return true
64
+ if (Array.isArray(a) && Array.isArray(b)) {
65
+ if (a.length !== b.length) return false
66
+ for (let index = 0; index < a.length; index += 1) {
67
+ if (!deepEqual(getJsonArrayItem(a, index), getJsonArrayItem(b, index))) return false
68
+ }
69
+ return true
70
+ }
71
+ if (isRecord(a) && isRecord(b)) {
72
+ let comparableAKeys = 0
73
+ for (const key of Object.keys(a)) {
74
+ if (isJsonDroppedValue(a[key])) continue
75
+ comparableAKeys += 1
76
+ if (!hasJsonObjectKey(b, key) || !deepEqual(a[key], b[key])) return false
77
+ }
78
+
79
+ let comparableBKeys = 0
80
+ for (const key of Object.keys(b)) {
81
+ if (!isJsonDroppedValue(b[key])) comparableBKeys += 1
82
+ }
83
+ return comparableAKeys === comparableBKeys
84
+ }
85
+ return false
86
+ }
87
+
88
+ const normalizeConfig = (config: unknown) => {
89
+ if (!isRecord(config)) return config
90
+ const normalized = { ...config }
91
+ for (const field of VOLATILE_TOP_LEVEL_FIELDS) delete normalized[field]
92
+ return normalized
93
+ }
94
+
95
+ // Objects recurse key-wise; equal-length arrays recurse element-wise; everything else
96
+ // (scalars, type changes, length-changed arrays) emits one whole-value `set` at that
97
+ // path. The editor's `applyJsonDiffToYType` minimizes the actual Yjs ops downstream,
98
+ // so a whole-array `set` on insert/remove still yields a minimal CRDT mutation.
99
+ const diffInto = (
100
+ before: unknown,
101
+ after: unknown,
102
+ currentPath: Array<string | number>,
103
+ ops: ConfigPatchOp[],
104
+ ) => {
105
+ if (deepEqual(before, after)) return
106
+
107
+ if (isRecord(before) && isRecord(after)) {
108
+ const keys = new Set([...Object.keys(before), ...Object.keys(after)])
109
+ for (const key of keys) {
110
+ const beforeHasKey = hasJsonObjectKey(before, key)
111
+ const afterHasKey = hasJsonObjectKey(after, key)
112
+ if (!beforeHasKey && !afterHasKey) continue
113
+
114
+ const nextPath = [...currentPath, key]
115
+ if (!afterHasKey) ops.push({ op: 'unset', path: nextPath })
116
+ else if (!beforeHasKey) {
117
+ ops.push({ op: 'set', path: nextPath, value: toJsonCompatibleValue(after[key]) })
118
+ } else diffInto(before[key], after[key], nextPath, ops)
119
+ }
120
+ return
121
+ }
122
+
123
+ if (Array.isArray(before) && Array.isArray(after) && before.length === after.length) {
124
+ for (let index = 0; index < after.length; index += 1) {
125
+ diffInto(
126
+ getJsonArrayItem(before, index),
127
+ getJsonArrayItem(after, index),
128
+ [...currentPath, index],
129
+ ops,
130
+ )
131
+ }
132
+ return
133
+ }
134
+
135
+ ops.push({ op: 'set', path: currentPath, value: toJsonCompatibleValue(after) })
136
+ }
137
+
138
+ // Diff two compiled configs. `before == null` means there was no prior build to compare
139
+ // (first compile); `after == null` means the fresh artifact could not be read.
140
+ export const computeConfigChange = (before: unknown, after: unknown): ConfigChange => {
141
+ if (before == null) return { status: 'no_baseline' }
142
+ if (after == null) return { status: 'unavailable' }
143
+ const ops: ConfigPatchOp[] = []
144
+ diffInto(normalizeConfig(before), normalizeConfig(after), [], ops)
145
+ return { status: 'ok', ops, opCount: ops.length }
146
+ }
147
+
148
+ // Read the last-compiled config artifact. Returns null when it is absent or unreadable.
149
+ export const readBuildConfig = async (projectDir: string): Promise<unknown> => {
150
+ try {
151
+ return JSON.parse(await readFile(path.join(projectDir, BUILD_CONFIG_RELATIVE), 'utf8'))
152
+ } catch {
153
+ return null
154
+ }
155
+ }