@playcraft/devkit 1.0.31-beta.10 → 1.0.31-beta.11

package/core/engines/cocos/pack.js

@@ -1 +1,187 @@
-"use strict";const fs=require("fs");const path=require("path");const{options}=require("../../options.js");const{mergeOptions}=require("../../utils/mergeOptions.js");const{logOptions}=require("../../utils/logOptions.js");const{resolveCreatorOutputDir}=require("./creator-cli");const{runCocosEngineBuild}=require("./cli-build");const{rebundlePreviewMerge}=require("./rebundle-preview.js");const{mergeWebMobile}=require("./merge");const{detectCurrentTheme,loadThemePayload,writeGeneratedThemeModule}=require("./theme-assets");const{emitChannel}=require("../../artifacts/emit");const{isSocialMediaNetwork,stripSocialShareFromDir}=require("./strip-social-share");function resolveWebMobileDir(root,buildOptions){const cocos=buildOptions.cocos||{};const fromCreator=resolveCreatorOutputDir(root,cocos.buildConfig||"build-configs/web-mobile.json");const explicit=cocos.webMobileDir?path.resolve(root,cocos.webMobileDir):null;if(cocos.skipEngineBuild){return explicit||fromCreator||path.resolve(root,"dist/web-mobile")}if(fromCreator){if(explicit&&explicit!==fromCreator){console.warn(`[cocos] webMobileDir (${path.relative(root,explicit)}) != Creator output (${path.relative(root,fromCreator)}); using Creator buildPath/outputName`)}return fromCreator}return explicit||path.resolve(root,"dist/web-mobile")}async function mergeTemplate(root,buildOptions){const webMobileDir=resolveWebMobileDir(root,buildOptions);const singleFilePath=path.join(root,"build","single-file-3x.html");await mergeWebMobile(webMobileDir,singleFilePath,{enableSplash:!!(buildOptions.cocos&&buildOptions.cocos.enableSplash)});return fs.readFileSync(singleFilePath,"utf8")}function resolveThemeName(root,buildOptions,themeConfig){return buildOptions.themeName||detectCurrentTheme(root,themeConfig)||"default"}function loadBuildsThemeConfig(root){const configPath=path.join(root,"builds.config.js");if(!fs.existsSync(configPath))return{sourceDir:"src/theme",entryFile:"src/theme/index.ts"};try{delete require.cache[configPath];const config=require(configPath);return{sourceDir:"src/theme",entryFile:"src/theme/index.ts",...(config.themes||{})}}catch{return{sourceDir:"src/theme",entryFile:"src/theme/index.ts"}}}function stripPackedChannel(outDir,network){if(isSocialMediaNetwork(network)){console.log("[cocos] social_media: keep AiX hooks (inject IIFE later)");return}const packed=stripSocialShareFromDir(outDir);console.log(`[cocos] stripped social-share from ${packed.changed}/${packed.files} files in ${path.relative(process.cwd(),outDir)||"."}`)}async function prepareCocosTemplate(customOptions){const buildOptions=mergeOptions(options,customOptions);const root=process.cwd();await runCocosEngineBuild(root,buildOptions);await rebundlePreviewMerge(root);return mergeTemplate(root,buildOptions)}async function emitCocosChannel(templateHtml,customOptions){const buildOptions=mergeOptions(options,customOptions);const root=process.cwd();const themeConfig=loadBuildsThemeConfig(root);const themeName=resolveThemeName(root,buildOptions,themeConfig);let themePayload={themeName,mergedData:{},i18nOverride:{},assetRecordByPath:{}};try{themePayload=loadThemePayload(root,themeName,themeConfig)}catch(err){console.warn(`[cocos] theme payload skipped: ${err.message}`)}const generated=buildOptions.cocos&&buildOptions.cocos.generatedThemeFile||"assets/scripts/platform/theme.generated.ts";writeGeneratedThemeModule(path.join(root,generated),themePayload);const outDir=path.resolve(root,buildOptions.outDir);await emitChannel({templateHtml,buildOptions,themePayload,outDir});stripPackedChannel(outDir,buildOptions.network)}async function runCocosBuild(customOptions){const buildOptions=mergeOptions(options,customOptions);logOptions(buildOptions);const templateHtml=await prepareCocosTemplate(buildOptions);await emitCocosChannel(templateHtml,customOptions)}async function packCocosBatch({config,themes,tasks,outputDir,projectRoot,isChannelFold2Zip}){const buildOptionsBase=mergeOptions(options,{engine:"cocos",googlePlayUrl:config.googlePlayUrl,appStoreUrl:config.appStoreUrl,isChannelFold2Zip,obfuscateLevel:config.obfuscateLevel,fflateCompression:config.fflateCompression});if(config.cocos)Object.assign(buildOptionsBase.cocos,config.cocos);if(buildOptionsBase.cocos.cleanCache!==false&&process.env.PLAYABLE_KEEP_COCOS_CACHE!=="1"){buildOptionsBase.cocos.cleanCache=true}await runCocosEngineBuild(projectRoot,buildOptionsBase);await rebundlePreviewMerge(projectRoot);const templateHtml=await mergeTemplate(projectRoot,buildOptionsBase);const themeConfig=config.themes||loadBuildsThemeConfig(projectRoot);const results=[];for(const theme of themes){let themePayload;try{themePayload=loadThemePayload(projectRoot,theme,themeConfig)}catch(err){console.error(`[cocos] theme ${theme}: ${err.message}`);for(const task of tasks){results.push({success:false,theme,channel:task.channel,orientation:task.orientation,error:err.message})}continue}for(const task of tasks){const orientationValue=task.orientation||"both";const fileName=config.naming&&typeof config.naming.generator==="function"?config.naming.generator(theme,task.channel):`${theme}-${task.channel}`;const tempDir=path.join(projectRoot,`${config.build.tempDirPrefix||"dist-temp"}-cocos-${theme}-${task.channel}-${orientationValue}`);try{const channelOptions=mergeOptions(buildOptionsBase,{network:task.channel,playcraftOrientationValue:orientationValue,filename:fileName||options.filename,outDir:tempDir,isChannelFold2Zip});await emitChannel({templateHtml,buildOptions:channelOptions,themePayload,outDir:tempDir});stripPackedChannel(tempDir,task.channel);const themeDir=path.join(outputDir,theme);fs.mkdirSync(themeDir,{recursive:true});for(const file of fs.readdirSync(tempDir)){const src=path.join(tempDir,file);if(fs.statSync(src).isDirectory())continue;fs.copyFileSync(src,path.join(themeDir,file))}results.push({success:true,theme,channel:task.channel,orientation:orientationValue})}catch(error){results.push({success:false,theme,channel:task.channel,orientation:orientationValue,error:error.message})}finally{if(config.build.cleanTemp!==false&&fs.existsSync(tempDir)){fs.rmSync(tempDir,{recursive:true,force:true})}}}}return results}async function syncThemeForPreview(projectRoot,themeName,themeConfig,generatedRel){const payload=loadThemePayload(projectRoot,themeName,themeConfig);writeGeneratedThemeModule(path.join(projectRoot,generatedRel),payload);return payload}module.exports={runCocosBuild,prepareCocosTemplate,emitCocosChannel,packCocosBatch,mergeTemplate,syncThemeForPreview};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { options } = require('../../options.js');
+const { mergeOptions } = require('../../utils/mergeOptions.js');
+const { logOptions } = require('../../utils/logOptions.js');
+const { resolveCreatorOutputDir } = require('./creator-cli');
+const { runCocosEngineBuild } = require('./cli-build');
+const { rebundlePreviewMerge } = require('./rebundle-preview.js');
+const { mergeWebMobile } = require('./merge');
+const { detectCurrentTheme, loadThemePayload, writeGeneratedThemeModule } = require('./theme-assets');
+const { emitChannel } = require('../../artifacts/emit');
+const { isSocialMediaNetwork, stripSocialShareFromDir } = require('./strip-social-share');
+
+function resolveWebMobileDir(root, buildOptions) {
+  const cocos = buildOptions.cocos || {};
+  const fromCreator = resolveCreatorOutputDir(root, cocos.buildConfig || 'build-configs/web-mobile.json');
+  const explicit = cocos.webMobileDir ? path.resolve(root, cocos.webMobileDir) : null;
+  if (cocos.skipEngineBuild) {
+    return explicit || fromCreator || path.resolve(root, 'dist/web-mobile');
+  }
+  if (fromCreator) {
+    if (explicit && explicit !== fromCreator) {
+      console.warn(
+        `[cocos] webMobileDir (${path.relative(root, explicit)}) != Creator output (${path.relative(root, fromCreator)}); using Creator buildPath/outputName`
+      );
+    }
+    return fromCreator;
+  }
+  return explicit || path.resolve(root, 'dist/web-mobile');
+}
+
+async function mergeTemplate(root, buildOptions) {
+  const webMobileDir = resolveWebMobileDir(root, buildOptions);
+  const singleFilePath = path.join(root, 'build', 'single-file-3x.html');
+  await mergeWebMobile(webMobileDir, singleFilePath, {
+    enableSplash: !!(buildOptions.cocos && buildOptions.cocos.enableSplash),
+  });
+  return fs.readFileSync(singleFilePath, 'utf8');
+}
+
+function resolveThemeName(root, buildOptions, themeConfig) {
+  return buildOptions.themeName || detectCurrentTheme(root, themeConfig) || 'default';
+}
+
+function loadBuildsThemeConfig(root) {
+  const configPath = path.join(root, 'builds.config.js');
+  if (!fs.existsSync(configPath)) return { sourceDir: 'src/theme', entryFile: 'src/theme/index.ts' };
+  try {
+    delete require.cache[configPath];
+    const config = require(configPath);
+    return { sourceDir: 'src/theme', entryFile: 'src/theme/index.ts', ...(config.themes || {}) };
+  } catch {
+    return { sourceDir: 'src/theme', entryFile: 'src/theme/index.ts' };
+  }
+}
+
+function stripPackedChannel(outDir, network) {
+  if (isSocialMediaNetwork(network)) {
+    console.log('[cocos] social_media: keep AiX hooks (inject IIFE later)');
+    return;
+  }
+  const packed = stripSocialShareFromDir(outDir);
+  console.log(`[cocos] stripped social-share from ${packed.changed}/${packed.files} files in ${path.relative(process.cwd(), outDir) || '.'}`);
+}
+
+async function prepareCocosTemplate(customOptions) {
+  const buildOptions = mergeOptions(options, customOptions);
+  const root = process.cwd();
+  await runCocosEngineBuild(root, buildOptions);
+  await rebundlePreviewMerge(root);
+  return mergeTemplate(root, buildOptions);
+}
+
+async function emitCocosChannel(templateHtml, customOptions) {
+  const buildOptions = mergeOptions(options, customOptions);
+  const root = process.cwd();
+  const themeConfig = loadBuildsThemeConfig(root);
+  const themeName = resolveThemeName(root, buildOptions, themeConfig);
+  let themePayload = { themeName, mergedData: {}, i18nOverride: {}, assetRecordByPath: {} };
+  try {
+    themePayload = loadThemePayload(root, themeName, themeConfig);
+  } catch (err) {
+    console.warn(`[cocos] theme payload skipped: ${err.message}`);
+  }
+  const generated = (buildOptions.cocos && buildOptions.cocos.generatedThemeFile) || 'assets/scripts/platform/theme.generated.ts';
+  writeGeneratedThemeModule(path.join(root, generated), themePayload);
+  const outDir = path.resolve(root, buildOptions.outDir);
+  await emitChannel({ templateHtml, buildOptions, themePayload, outDir });
+  stripPackedChannel(outDir, buildOptions.network);
+}
+
+async function runCocosBuild(customOptions) {
+  const buildOptions = mergeOptions(options, customOptions);
+  logOptions(buildOptions);
+  const templateHtml = await prepareCocosTemplate(buildOptions);
+  await emitCocosChannel(templateHtml, customOptions);
+}
+
+async function packCocosBatch({ config, themes, tasks, outputDir, projectRoot, isChannelFold2Zip }) {
+  const buildOptionsBase = mergeOptions(options, {
+    engine: 'cocos',
+    googlePlayUrl: config.googlePlayUrl,
+    appStoreUrl: config.appStoreUrl,
+    isChannelFold2Zip,
+    obfuscateLevel: config.obfuscateLevel,
+    fflateCompression: config.fflateCompression,
+  });
+  if (config.cocos) Object.assign(buildOptionsBase.cocos, config.cocos);
+  if (buildOptionsBase.cocos.cleanCache !== false && process.env.PLAYABLE_KEEP_COCOS_CACHE !== '1') {
+    buildOptionsBase.cocos.cleanCache = true;
+  }
+
+  await runCocosEngineBuild(projectRoot, buildOptionsBase);
+  await rebundlePreviewMerge(projectRoot);
+  const templateHtml = await mergeTemplate(projectRoot, buildOptionsBase);
+  const themeConfig = config.themes || loadBuildsThemeConfig(projectRoot);
+  const results = [];
+
+  for (const theme of themes) {
+    let themePayload;
+    try {
+      themePayload = loadThemePayload(projectRoot, theme, themeConfig);
+    } catch (err) {
+      console.error(`[cocos] theme ${theme}: ${err.message}`);
+      for (const task of tasks) {
+        results.push({ success: false, theme, channel: task.channel, orientation: task.orientation, error: err.message });
+      }
+      continue;
+    }
+
+    for (const task of tasks) {
+      const orientationValue = task.orientation || 'both';
+      const fileName = (config.naming && typeof config.naming.generator === 'function')
+        ? config.naming.generator(theme, task.channel)
+        : `${theme}-${task.channel}`;
+      const tempDir = path.join(projectRoot, `${config.build.tempDirPrefix || 'dist-temp'}-cocos-${theme}-${task.channel}-${orientationValue}`);
+      try {
+        const channelOptions = mergeOptions(buildOptionsBase, {
+          network: task.channel,
+          playcraftOrientationValue: orientationValue,
+          filename: fileName || options.filename,
+          outDir: tempDir,
+          isChannelFold2Zip,
+        });
+        await emitChannel({
+          templateHtml,
+          buildOptions: channelOptions,
+          themePayload,
+          outDir: tempDir,
+        });
+        stripPackedChannel(tempDir, task.channel);
+        const themeDir = path.join(outputDir, theme);
+        fs.mkdirSync(themeDir, { recursive: true });
+        for (const file of fs.readdirSync(tempDir)) {
+          const src = path.join(tempDir, file);
+          if (fs.statSync(src).isDirectory()) continue;
+          fs.copyFileSync(src, path.join(themeDir, file));
+        }
+        results.push({ success: true, theme, channel: task.channel, orientation: orientationValue });
+      } catch (error) {
+        results.push({ success: false, theme, channel: task.channel, orientation: orientationValue, error: error.message });
+      } finally {
+        if (config.build.cleanTemp !== false && fs.existsSync(tempDir)) {
+          fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+      }
+    }
+  }
+  return results;
+}
+
+async function syncThemeForPreview(projectRoot, themeName, themeConfig, generatedRel) {
+  const payload = loadThemePayload(projectRoot, themeName, themeConfig);
+  writeGeneratedThemeModule(path.join(projectRoot, generatedRel), payload);
+  return payload;
+}
+
+module.exports = {
+  runCocosBuild,
+  prepareCocosTemplate,
+  emitCocosChannel,
+  packCocosBatch,
+  mergeTemplate,
+  syncThemeForPreview,
+};

package/core/engines/cocos/preview-cache.js

@@ -1,5 +1,51 @@
-"use strict";const IMMUTABLE="public, max-age=31536000, immutable";const REVALIDATE="public, max-age=0, must-revalidate";const NO_STORE="no-store";function pathOnly(url){return String(url||"").split("?")[0]}function hasContentHash(url){return /[?&]h=[a-f0-9]{6,}/i.test(String(url||""))}/**
+'use strict';
+
+const IMMUTABLE = 'public, max-age=31536000, immutable';
+const REVALIDATE = 'public, max-age=0, must-revalidate';
+const NO_STORE = 'no-store';
+
+function pathOnly(url) {
+  return String(url || '').split('?')[0];
+}
+
+function hasContentHash(url) {
+  return /[?&]h=[a-f0-9]{6,}/i.test(String(url || ''));
+}
+
+/**
  * Cache-Control for CLI preview. Engine / static never change during a remix
  * session; hashed playcraft artifacts are immutable until the next compile.
  * HTML / settings / MCP stay no-store.
- */function cacheControlFor(url){const pathname=pathOnly(url);if(!pathname||pathname==="/")return NO_STORE;if(pathname.endsWith(".html"))return NO_STORE;if(pathname==="/preview/settings.js")return NO_STORE;if(pathname.startsWith("/mcp"))return NO_STORE;if(pathname.startsWith("/console-log"))return NO_STORE;if(pathname.startsWith("/socket.io/")&&!pathname.endsWith(".js"))return null;if(/^\/scene\/.+\.json$/.test(pathname))return NO_STORE;if(pathname.startsWith("/scripting/engine-dist/"))return IMMUTABLE;if(pathname.startsWith("/static/web/"))return IMMUTABLE;if(pathname.startsWith("/scripting/engine/"))return IMMUTABLE;if(pathname==="/socket.io/socket.io.js")return IMMUTABLE;if(/\/chunks\/[0-9a-f]{2}\/[0-9a-f]{40}\.js$/.test(pathname))return IMMUTABLE;if(hasContentHash(url)&&(pathname.endsWith("/playcraft-bundle.js")||pathname.endsWith("/playcraft-json-pack.json"))){return IMMUTABLE}return REVALIDATE}module.exports={cacheControlFor,IMMUTABLE,REVALIDATE,NO_STORE};
+ */
+function cacheControlFor(url) {
+  const pathname = pathOnly(url);
+  if (!pathname || pathname === '/') return NO_STORE;
+  if (pathname.endsWith('.html')) return NO_STORE;
+  if (pathname === '/preview/settings.js') return NO_STORE;
+  if (pathname.startsWith('/mcp')) return NO_STORE;
+  if (pathname.startsWith('/console-log')) return NO_STORE;
+  if (pathname.startsWith('/socket.io/') && !pathname.endsWith('.js')) return null;
+  if (/^\/scene\/.+\.json$/.test(pathname)) return NO_STORE;
+
+  if (pathname.startsWith('/scripting/engine-dist/')) return IMMUTABLE;
+  if (pathname.startsWith('/static/web/')) return IMMUTABLE;
+  if (pathname.startsWith('/scripting/engine/')) return IMMUTABLE;
+  if (pathname === '/socket.io/socket.io.js') return IMMUTABLE;
+  if (/\/chunks\/[0-9a-f]{2}\/[0-9a-f]{40}\.js$/.test(pathname)) return IMMUTABLE;
+
+  if (
+    hasContentHash(url) &&
+    (pathname.endsWith('/playcraft-bundle.js') || pathname.endsWith('/playcraft-json-pack.json'))
+  ) {
+    return IMMUTABLE;
+  }
+
+  return REVALIDATE;
+}
+
+module.exports = {
+  cacheControlFor,
+  IMMUTABLE,
+  REVALIDATE,
+  NO_STORE,
+};

package/core/engines/cocos/preview-cache.test.js

@@ -1 +1,32 @@
-"use strict";const{describe,it}=require("node:test");const assert=require("node:assert/strict");const{cacheControlFor,IMMUTABLE,REVALIDATE,NO_STORE}=require("./preview-cache.js");describe("cacheControlFor",()=>{it("does not cache html, settings, or mcp",()=>{assert.equal(cacheControlFor("/"),NO_STORE);assert.equal(cacheControlFor("/preview/settings.js"),NO_STORE);assert.equal(cacheControlFor("/mcp"),NO_STORE);assert.equal(cacheControlFor("/scene/0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d.json"),NO_STORE)});it("long-caches engine and static files that do not change",()=>{assert.equal(cacheControlFor("/scripting/engine-dist/bundled/index.js"),IMMUTABLE);assert.equal(cacheControlFor("/static/web/polyfills.bundle.js"),IMMUTABLE);assert.equal(cacheControlFor("/scripting/engine/effect-settings"),IMMUTABLE)});it("long-caches hashed playcraft artifacts and revalidates unhashed ones",()=>{assert.equal(cacheControlFor("/scripting/x/chunks/playcraft-bundle.js?h=abcdef12"),IMMUTABLE);assert.equal(cacheControlFor("/scripting/x/chunks/playcraft-bundle.js"),REVALIDATE);assert.equal(cacheControlFor("/scripting/systemjs/playcraft-json-pack.json?h=abcdef12"),IMMUTABLE)})});
+'use strict';
+
+const { describe, it } = require('node:test');
+const assert = require('node:assert/strict');
+const { cacheControlFor, IMMUTABLE, REVALIDATE, NO_STORE } = require('./preview-cache.js');
+
+describe('cacheControlFor', () => {
+  it('does not cache html, settings, or mcp', () => {
+    assert.equal(cacheControlFor('/'), NO_STORE);
+    assert.equal(cacheControlFor('/preview/settings.js'), NO_STORE);
+    assert.equal(cacheControlFor('/mcp'), NO_STORE);
+    assert.equal(cacheControlFor('/scene/0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d.json'), NO_STORE);
+  });
+
+  it('long-caches engine and static files that do not change', () => {
+    assert.equal(cacheControlFor('/scripting/engine-dist/bundled/index.js'), IMMUTABLE);
+    assert.equal(cacheControlFor('/static/web/polyfills.bundle.js'), IMMUTABLE);
+    assert.equal(cacheControlFor('/scripting/engine/effect-settings'), IMMUTABLE);
+  });
+
+  it('long-caches hashed playcraft artifacts and revalidates unhashed ones', () => {
+    assert.equal(
+      cacheControlFor('/scripting/x/chunks/playcraft-bundle.js?h=abcdef12'),
+      IMMUTABLE,
+    );
+    assert.equal(cacheControlFor('/scripting/x/chunks/playcraft-bundle.js'), REVALIDATE);
+    assert.equal(
+      cacheControlFor('/scripting/systemjs/playcraft-json-pack.json?h=abcdef12'),
+      IMMUTABLE,
+    );
+  });
+});

package/core/engines/cocos/preview-concat.js

@@ -1,8 +1,192 @@
-"use strict";const crypto=require("crypto");const fs=require("fs");const path=require("path");const ENTRY="cce:/internal/x/prerequisite-imports";const SKIP=new Set(["cce:/internal/x/cc"]);const GLOBAL_DEPS=new Set(["cc","cc/env","cc/userland/macro"]);const BUNDLE_FILE="playcraft-bundle.js";const BUNDLE_URL=`./chunks/${BUNDLE_FILE}`;const REGISTER_RE=/^System\.register\(\s*(\[[\s\S]*?\])\s*,\s*function/;function previewDir(projectRoot){return path.join(projectRoot,"temp/programming/packer-driver/targets/preview")}function normalizeChunkUrl(url){const raw=String(url||"").replace(/\\/g,"/");if(raw.startsWith("./chunks/"))return raw;if(raw.startsWith("chunks/"))return`./${raw}`;return raw}function isChunkUrl(url){return normalizeChunkUrl(url).startsWith("./chunks/")&&normalizeChunkUrl(url).endsWith(".js")}function packChunkName(chunkUrl){return`pack-chunk:${path.basename(normalizeChunkUrl(chunkUrl),".js")}`}function shortHash(buf){return crypto.createHash("sha1").update(buf).digest("hex").slice(0,10)}function isBundledImportMap(map){const imports=map&&map.imports||{};const entry=String(imports[ENTRY]||"").split("?")[0];return entry===BUNDLE_URL&&Object.keys(imports).length===1}function loadSourceImportMap(dir){const livePath=path.join(dir,"import-map.json");const backupPath=path.join(dir,"import-map.quickpack.json");if(!fs.existsSync(livePath))return null;const live=JSON.parse(fs.readFileSync(livePath,"utf8"));if(isBundledImportMap(live)){if(!fs.existsSync(backupPath))return null;return JSON.parse(fs.readFileSync(backupPath,"utf8"))}fs.writeFileSync(backupPath,`${JSON.stringify(live,null,2)}\n`);return live}function skipChunkUrls(map){const skip=new Set;const imports=map.imports||{};for(const spec of SKIP){if(isChunkUrl(imports[spec]))skip.add(normalizeChunkUrl(imports[spec]))}return skip}function collectChunkUrls(map){const skipUrls=skipChunkUrls(map);const urls=new Set;const queue=[];const add=url=>{if(!isChunkUrl(url))return;const normalized=normalizeChunkUrl(url);if(skipUrls.has(normalized)||urls.has(normalized))return;urls.add(normalized);queue.push(normalized)};const imports=map.imports||{};for(const[spec,url]of Object.entries(imports)){if(SKIP.has(spec))continue;add(url)}while(queue.length){const scopeUrl=queue.shift();for(const target of Object.values((map.scopes||{})[scopeUrl]||{})){add(target)}}return urls}function rewriteDep(dep,chunkUrl,map,nameOf){if(GLOBAL_DEPS.has(dep))return dep;const mapped=((map.scopes||{})[chunkUrl]||{})[dep]||(map.imports||{})[dep];if(!mapped)return dep;if(typeof mapped==="string"&&mapped.startsWith("cce:/internal/x/cc-fu"))return"cc";if(SKIP.has(mapped)||mapped===(map.imports||{})["cce:/internal/x/cc"])return"cc";if(isChunkUrl(mapped))return nameOf(normalizeChunkUrl(mapped));return mapped}function rewriteChunk(source,name,chunkUrl,map,nameOf,anonymous){const stripped=source.replace(/\n\/\/# sourceMappingURL=.*$/m,"");const match=stripped.match(REGISTER_RE);if(!match){throw new Error(`no System.register in ${chunkUrl}`)}const deps=JSON.parse(match[1]).map(dep=>rewriteDep(dep,chunkUrl,map,nameOf));const head=anonymous?`System.register(${JSON.stringify(deps)}, function`:`System.register(${JSON.stringify(name)}, ${JSON.stringify(deps)}, function`;return`${head}${stripped.slice(match[0].length)}`}/**
+'use strict';
+
+const crypto = require('crypto');
+const fs = require('fs');
+const path = require('path');
+
+const ENTRY = 'cce:/internal/x/prerequisite-imports';
+const SKIP = new Set(['cce:/internal/x/cc']);
+const GLOBAL_DEPS = new Set(['cc', 'cc/env', 'cc/userland/macro']);
+const BUNDLE_FILE = 'playcraft-bundle.js';
+const BUNDLE_URL = `./chunks/${BUNDLE_FILE}`;
+const REGISTER_RE = /^System\.register\(\s*(\[[\s\S]*?\])\s*,\s*function/;
+
+function previewDir(projectRoot) {
+  return path.join(projectRoot, 'temp/programming/packer-driver/targets/preview');
+}
+
+function normalizeChunkUrl(url) {
+  const raw = String(url || '').replace(/\\/g, '/');
+  if (raw.startsWith('./chunks/')) return raw;
+  if (raw.startsWith('chunks/')) return `./${raw}`;
+  return raw;
+}
+
+function isChunkUrl(url) {
+  return normalizeChunkUrl(url).startsWith('./chunks/') && normalizeChunkUrl(url).endsWith('.js');
+}
+
+function packChunkName(chunkUrl) {
+  return `pack-chunk:${path.basename(normalizeChunkUrl(chunkUrl), '.js')}`;
+}
+
+function shortHash(buf) {
+  return crypto.createHash('sha1').update(buf).digest('hex').slice(0, 10);
+}
+
+function isBundledImportMap(map) {
+  const imports = (map && map.imports) || {};
+  const entry = String(imports[ENTRY] || '').split('?')[0];
+  return entry === BUNDLE_URL && Object.keys(imports).length === 1;
+}
+
+function loadSourceImportMap(dir) {
+  const livePath = path.join(dir, 'import-map.json');
+  const backupPath = path.join(dir, 'import-map.quickpack.json');
+  if (!fs.existsSync(livePath)) return null;
+  const live = JSON.parse(fs.readFileSync(livePath, 'utf8'));
+  if (isBundledImportMap(live)) {
+    if (!fs.existsSync(backupPath)) return null;
+    return JSON.parse(fs.readFileSync(backupPath, 'utf8'));
+  }
+  fs.writeFileSync(backupPath, `${JSON.stringify(live, null, 2)}\n`);
+  return live;
+}
+
+function skipChunkUrls(map) {
+  const skip = new Set();
+  const imports = map.imports || {};
+  for (const spec of SKIP) {
+    if (isChunkUrl(imports[spec])) skip.add(normalizeChunkUrl(imports[spec]));
+  }
+  return skip;
+}
+
+function collectChunkUrls(map) {
+  const skipUrls = skipChunkUrls(map);
+  const urls = new Set();
+  const queue = [];
+  const add = (url) => {
+    if (!isChunkUrl(url)) return;
+    const normalized = normalizeChunkUrl(url);
+    if (skipUrls.has(normalized) || urls.has(normalized)) return;
+    urls.add(normalized);
+    queue.push(normalized);
+  };
+  const imports = map.imports || {};
+  for (const [spec, url] of Object.entries(imports)) {
+    if (SKIP.has(spec)) continue;
+    add(url);
+  }
+  while (queue.length) {
+    const scopeUrl = queue.shift();
+    for (const target of Object.values((map.scopes || {})[scopeUrl] || {})) {
+      add(target);
+    }
+  }
+  return urls;
+}
+
+function rewriteDep(dep, chunkUrl, map, nameOf) {
+  if (GLOBAL_DEPS.has(dep)) return dep;
+  const mapped =
+    ((map.scopes || {})[chunkUrl] || {})[dep] ||
+    (map.imports || {})[dep];
+  if (!mapped) return dep;
+  if (typeof mapped === 'string' && mapped.startsWith('cce:/internal/x/cc-fu')) return 'cc';
+  if (SKIP.has(mapped) || mapped === (map.imports || {})['cce:/internal/x/cc']) return 'cc';
+  if (isChunkUrl(mapped)) return nameOf(normalizeChunkUrl(mapped));
+  return mapped;
+}
+
+function rewriteChunk(source, name, chunkUrl, map, nameOf, anonymous) {
+  const stripped = source.replace(/\n\/\/# sourceMappingURL=.*$/m, '');
+  const match = stripped.match(REGISTER_RE);
+  if (!match) {
+    throw new Error(`no System.register in ${chunkUrl}`);
+  }
+  const deps = JSON.parse(match[1]).map((dep) => rewriteDep(dep, chunkUrl, map, nameOf));
+  const head = anonymous
+    ? `System.register(${JSON.stringify(deps)}, function`
+    : `System.register(${JSON.stringify(name)}, ${JSON.stringify(deps)}, function`;
+  return `${head}${stripped.slice(match[0].length)}`;
+}
+
+/**
  * Fold QuickPack's per-file chunks into one named-register bundle and
  * point prerequisite-imports at it. Original chunks stay on disk for
  * incremental compile; import-map.quickpack.json keeps the pre-rewrite map.
- */function concatPreviewScripts(projectRoot){const dir=previewDir(projectRoot);const map=loadSourceImportMap(dir);if(!map)return null;const imports=map.imports||{};const chunkToSpecifier=new Map;for(const[spec,url]of Object.entries(imports)){if(SKIP.has(spec)||!isChunkUrl(url))continue;chunkToSpecifier.set(normalizeChunkUrl(url),spec)}const entryChunk=imports[ENTRY]&&isChunkUrl(imports[ENTRY])?normalizeChunkUrl(imports[ENTRY]):null;const nameOf=chunkUrl=>{if(entryChunk&&chunkUrl===entryChunk)return ENTRY;return chunkToSpecifier.get(chunkUrl)||packChunkName(chunkUrl)};const chunkUrls=[...collectChunkUrls(map)];if(!chunkUrls.length)return null;// Named modules first; anonymous entry last so script-tag onload getRegister()
-// binds prerequisite-imports (named-register's firstNamedDefine is cleared
-// before the load event).
-const ordered=[];for(const url of chunkUrls){if(url!==entryChunk)ordered.push(url)}if(entryChunk&&chunkUrls.includes(entryChunk))ordered.push(entryChunk);const parts=[];for(const chunkUrl of ordered){const abs=path.join(dir,chunkUrl.replace(/^\.\//,""));if(!fs.existsSync(abs)){throw new Error(`missing chunk ${chunkUrl}`)}parts.push(rewriteChunk(fs.readFileSync(abs,"utf8"),nameOf(chunkUrl),chunkUrl,map,nameOf,chunkUrl===entryChunk))}const bundle=`${parts.join("\n")}\n`;const bundleAbs=path.join(dir,"chunks",BUNDLE_FILE);fs.mkdirSync(path.dirname(bundleAbs),{recursive:true});fs.writeFileSync(bundleAbs,bundle);const hashedUrl=`${BUNDLE_URL}?h=${shortHash(bundle)}`;const bundledMap={imports:{[ENTRY]:hashedUrl}};const tmp=path.join(dir,"import-map.json.tmp");fs.writeFileSync(tmp,`${JSON.stringify(bundledMap)}\n`);fs.renameSync(tmp,path.join(dir,"import-map.json"));return{modules:ordered.length,bytes:Buffer.byteLength(bundle),bundle:hashedUrl}}module.exports={concatPreviewScripts,ENTRY,BUNDLE_URL,BUNDLE_FILE,isBundledImportMap};
+ */
+function concatPreviewScripts(projectRoot) {
+  const dir = previewDir(projectRoot);
+  const map = loadSourceImportMap(dir);
+  if (!map) return null;
+
+  const imports = map.imports || {};
+  const chunkToSpecifier = new Map();
+  for (const [spec, url] of Object.entries(imports)) {
+    if (SKIP.has(spec) || !isChunkUrl(url)) continue;
+    chunkToSpecifier.set(normalizeChunkUrl(url), spec);
+  }
+
+  const entryChunk = imports[ENTRY] && isChunkUrl(imports[ENTRY])
+    ? normalizeChunkUrl(imports[ENTRY])
+    : null;
+  const nameOf = (chunkUrl) => {
+    if (entryChunk && chunkUrl === entryChunk) return ENTRY;
+    return chunkToSpecifier.get(chunkUrl) || packChunkName(chunkUrl);
+  };
+  const chunkUrls = [...collectChunkUrls(map)];
+  if (!chunkUrls.length) return null;
+  // Named modules first; anonymous entry last so script-tag onload getRegister()
+  // binds prerequisite-imports (named-register's firstNamedDefine is cleared
+  // before the load event).
+  const ordered = [];
+  for (const url of chunkUrls) {
+    if (url !== entryChunk) ordered.push(url);
+  }
+  if (entryChunk && chunkUrls.includes(entryChunk)) ordered.push(entryChunk);
+
+  const parts = [];
+  for (const chunkUrl of ordered) {
+    const abs = path.join(dir, chunkUrl.replace(/^\.\//, ''));
+    if (!fs.existsSync(abs)) {
+      throw new Error(`missing chunk ${chunkUrl}`);
+    }
+    parts.push(
+      rewriteChunk(
+        fs.readFileSync(abs, 'utf8'),
+        nameOf(chunkUrl),
+        chunkUrl,
+        map,
+        nameOf,
+        chunkUrl === entryChunk,
+      ),
+    );
+  }
+
+  const bundle = `${parts.join('\n')}\n`;
+  const bundleAbs = path.join(dir, 'chunks', BUNDLE_FILE);
+  fs.mkdirSync(path.dirname(bundleAbs), { recursive: true });
+  fs.writeFileSync(bundleAbs, bundle);
+
+  const hashedUrl = `${BUNDLE_URL}?h=${shortHash(bundle)}`;
+  const bundledMap = { imports: { [ENTRY]: hashedUrl } };
+  const tmp = path.join(dir, 'import-map.json.tmp');
+  fs.writeFileSync(tmp, `${JSON.stringify(bundledMap)}\n`);
+  fs.renameSync(tmp, path.join(dir, 'import-map.json'));
+
+  return {
+    modules: ordered.length,
+    bytes: Buffer.byteLength(bundle),
+    bundle: hashedUrl,
+  };
+}
+
+module.exports = {
+  concatPreviewScripts,
+  ENTRY,
+  BUNDLE_URL,
+  BUNDLE_FILE,
+  isBundledImportMap,
+};

package/core/engines/cocos/preview-concat.test.js

@@ -1 +1,73 @@
-"use strict";const{describe,it,before,after}=require("node:test");const assert=require("node:assert/strict");const fs=require("fs");const os=require("os");const path=require("path");const{concatPreviewScripts,ENTRY}=require("./preview-concat.js");describe("concatPreviewScripts",()=>{let root;let preview;before(()=>{root=fs.mkdtempSync(path.join(os.tmpdir(),"preview-concat-"));preview=path.join(root,"temp/programming/packer-driver/targets/preview");fs.mkdirSync(path.join(preview,"chunks/aa"),{recursive:true});fs.mkdirSync(path.join(preview,"chunks/bb"),{recursive:true});fs.writeFileSync(path.join(preview,"chunks/aa/aaa111.js"),"System.register([\"__unresolved_0\", \"cc\", \"@playcraft/adsdk/cjs\"], function (_export, _context) {\n  return { setters: [], execute() {} };\n});\n//# sourceMappingURL=aaa111.js.map\n");fs.writeFileSync(path.join(preview,"chunks/bb/bbb222.js"),"System.register([], function (_export, _context) {\n  return { setters: [], execute() {} };\n});\n");fs.writeFileSync(path.join(preview,"import-map.json"),JSON.stringify({imports:{[ENTRY]:"./chunks/aa/aaa111.js","cce:/internal/x/cc":"./chunks/cc/skip-me.js"},scopes:{"./chunks/aa/aaa111.js":{__unresolved_0:"./chunks/bb/bbb222.js","@playcraft/adsdk/cjs":"./chunks/bb/bbb222.js",cc:"./chunks/cc/skip-me.js"}}}))});after(()=>{fs.rmSync(root,{recursive:true,force:true})});it("writes one named-register bundle and a single import-map entry",()=>{const result=concatPreviewScripts(root);assert.equal(result.modules,2);const map=JSON.parse(fs.readFileSync(path.join(preview,"import-map.json"),"utf8"));assert.match(map.imports[ENTRY],/^\.\/chunks\/playcraft-bundle\.js\?h=[a-f0-9]+$/);assert.equal(result.bundle,map.imports[ENTRY]);const bundle=fs.readFileSync(path.join(preview,"chunks/playcraft-bundle.js"),"utf8");assert.equal(bundle.includes("sourceMappingURL"),false);assert.equal(bundle.includes(`System.register("${ENTRY}"`),false);assert.match(bundle,/System\.register\("pack-chunk:bbb222"/);assert.match(bundle,/System\.register\(\["pack-chunk:bbb222","cc","pack-chunk:bbb222"\], function \(_export/);assert.equal(bundle.includes("\"@playcraft/adsdk/cjs\""),false);const last=bundle.trim().split("System.register").pop();assert.match(last,/^\(\[/);assert.equal(bundle.includes("functionfunction"),false);assert.equal(bundle.includes("cce:/internal/x/cc"),false)});it("is idempotent using the quickpack backup",()=>{const again=concatPreviewScripts(root);assert.equal(again.modules,2)})});
+'use strict';
+
+const { describe, it, before, after } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { concatPreviewScripts, ENTRY } = require('./preview-concat.js');
+
+describe('concatPreviewScripts', () => {
+  let root;
+  let preview;
+
+  before(() => {
+    root = fs.mkdtempSync(path.join(os.tmpdir(), 'preview-concat-'));
+    preview = path.join(root, 'temp/programming/packer-driver/targets/preview');
+    fs.mkdirSync(path.join(preview, 'chunks/aa'), { recursive: true });
+    fs.mkdirSync(path.join(preview, 'chunks/bb'), { recursive: true });
+    fs.writeFileSync(
+      path.join(preview, 'chunks/aa/aaa111.js'),
+      'System.register(["__unresolved_0", "cc", "@playcraft/adsdk/cjs"], function (_export, _context) {\n  return { setters: [], execute() {} };\n});\n//# sourceMappingURL=aaa111.js.map\n',
+    );
+    fs.writeFileSync(
+      path.join(preview, 'chunks/bb/bbb222.js'),
+      'System.register([], function (_export, _context) {\n  return { setters: [], execute() {} };\n});\n',
+    );
+    fs.writeFileSync(
+      path.join(preview, 'import-map.json'),
+      JSON.stringify({
+        imports: {
+          [ENTRY]: './chunks/aa/aaa111.js',
+          'cce:/internal/x/cc': './chunks/cc/skip-me.js',
+        },
+        scopes: {
+          './chunks/aa/aaa111.js': {
+            __unresolved_0: './chunks/bb/bbb222.js',
+            '@playcraft/adsdk/cjs': './chunks/bb/bbb222.js',
+            cc: './chunks/cc/skip-me.js',
+          },
+        },
+      }),
+    );
+  });
+
+  after(() => {
+    fs.rmSync(root, { recursive: true, force: true });
+  });
+
+  it('writes one named-register bundle and a single import-map entry', () => {
+    const result = concatPreviewScripts(root);
+    assert.equal(result.modules, 2);
+
+    const map = JSON.parse(fs.readFileSync(path.join(preview, 'import-map.json'), 'utf8'));
+    assert.match(map.imports[ENTRY], /^\.\/chunks\/playcraft-bundle\.js\?h=[a-f0-9]+$/);
+    assert.equal(result.bundle, map.imports[ENTRY]);
+
+    const bundle = fs.readFileSync(path.join(preview, 'chunks/playcraft-bundle.js'), 'utf8');
+    assert.equal(bundle.includes('sourceMappingURL'), false);
+    assert.equal(bundle.includes(`System.register("${ENTRY}"`), false);
+    assert.match(bundle, /System\.register\("pack-chunk:bbb222"/);
+    assert.match(bundle, /System\.register\(\["pack-chunk:bbb222","cc","pack-chunk:bbb222"\], function \(_export/);
+    assert.equal(bundle.includes('"@playcraft/adsdk/cjs"'), false);
+    const last = bundle.trim().split('System.register').pop();
+    assert.match(last, /^\(\[/);
+    assert.equal(bundle.includes('functionfunction'), false);
+    assert.equal(bundle.includes('cce:/internal/x/cc'), false);
+  });
+
+  it('is idempotent using the quickpack backup', () => {
+    const again = concatPreviewScripts(root);
+    assert.equal(again.modules, 2);
+  });
+});