@dimina-kit/compiler 0.0.1-dev.20260707070110 → 0.0.1-dev.20260707110006

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimina-kit/compiler",
-  "version": "0.0.1-dev.20260707070110",
+  "version": "0.0.1-dev.20260707110006",
   "description": "dmcc compiler bundles (browser + node) that drive @dimina/compiler against a caller-injected node:fs replacement (no bundled fs)",
   "license": "MIT",
   "type": "module",

package/src/compile-core.js

@@ -476,8 +476,8 @@ async function runCompile({ fs, workPath = '/work' } = {}) {
   const ctx = await setupCompile({ fs, workPath })
   const { storeInfo: bundle, pages, appId, name, targetPath } = ctx
   // Same order as the original single pass. Stages are independent (no product
-  // read-back), so the order is not load-bearing — Phase 3 runs them concurrently
-  // in separate worker realms over a shared fs.
+  // read-back), so the order is not load-bearing — the worker pool (pool.js) runs
+  // them concurrently in separate worker realms over a shared fs.
   await compileStage({ stage: 'logic', pages, storeInfo: bundle, fs })
   await compileStage({ stage: 'view', pages, storeInfo: bundle, fs })
   await compileStage({ stage: 'style', pages, storeInfo: bundle, fs })

package/src/pool.js

@@ -162,7 +162,7 @@ export function createCompilerPool(options = {}) {
   async function runAttempt(files, workPath) {
     await settleAll(workers.map(ensureWarm))
 
-    // Phase 1 — one worker runs setup ONCE: it allocates the scope-hash ids
+    // Setup step — one worker runs setup ONCE: it allocates the scope-hash ids
     // (page + component data-v-XXXXX) and builds miniprogram_npm/app-config.json.
     // Broadcasting this single bundle to every stage is REQUIRED for correctness:
     // each stage runs in its own realm, and if each ran its own setup it would roll
@@ -173,7 +173,7 @@ export function createCompilerPool(options = {}) {
     const s = await requestChecked(workers[0], { type: 'setup', files, workPath, wantHeartbeat: true }, 'setup', sendTimeoutMs)
     const { bundle, scaffold } = s
 
-    // Phase 2 — every stage compiles in parallel against the SHARED bundle. The
+    // Compile step — every stage compiles in parallel against the SHARED bundle. The
     // non-stage scaffold (app-config.json + npm, produced once) seeds the union.
     const parts = await settleAll(workers.map((x) =>
       requestChecked(x, { type: 'compile-subset', files, workPath, stages: [x.stage], bundle, wantHeartbeat: true }, 'compile-subset', sendTimeoutMs)))