@playcraft/devkit 1.0.16 → 1.0.18

package/core/plugins/ZipPlugin.js

@@ -1,19 +1,138 @@
-"use strict";const path=require("path");const fs=require("fs");const ModuleFilenameHelpers=require("webpack/lib/ModuleFilenameHelpers");const webpack=require("webpack");const webpackSources=webpack.sources||require("webpack-sources");const yazl=require("yazl");function ZipPlugin(options){this.options=options||{}}ZipPlugin.prototype.apply=function(compiler){const options=this.options;const isWebpack4=webpack.version.startsWith("4.");// Prefer `compiler.webpack` instead of webpack or webpack-sources import (rspack compatibility hack)
-const{RawSource}=compiler.webpack&&compiler.webpack.sources||webpackSources;if(options.pathPrefix&&path.isAbsolute(options.pathPrefix)){throw new Error("\"pathPrefix\" must be a relative path")}// 保存临时文件夹路径，用于后续删除
-let tempFolderToClean=null;const process=function(compilation,callback){// assets from child compilers will be included in the parent
-// so we should not run in child compilers
-if(compilation.compiler.isChild()){callback();return}const zipFile=new yazl.ZipFile;const pathPrefix=options.pathPrefix||"";const pathMapper=options.pathMapper||function(x){return x};// populate the zip file with each asset
-for(const nameAndPath of Object.keys(compilation.assets)){// match against include and exclude, which may be strings, regexes, arrays of the previous or omitted
-if(!ModuleFilenameHelpers.matchObject({include:options.include,exclude:options.exclude},nameAndPath))continue;const source=compilation.assets[nameAndPath].source();zipFile.addBuffer(Buffer.isBuffer(source)?source:Buffer.from?Buffer.from(source):new Buffer(source),path.join(pathPrefix,pathMapper(nameAndPath)),options.fileOptions)}zipFile.end(options.zipOptions);// accumulate each buffer containing a part of the zip file
-const bufs=[];zipFile.outputStream.on("data",function(buf){bufs.push(buf)});zipFile.outputStream.on("end",function(){// default to webpack's root output path if no path provided
-const outputPath=options.path||compilation.options.output.path;// default to webpack root filename if no filename provided, else the basename of the output path
-let outputFilename=options.filename||compilation.options.output.filename||path.basename(outputPath);const fullHash=compilation.fullHash||compilation.hash;outputFilename=outputFilename.replace("[fullhash:6]",fullHash.slice(0,6));const extension="."+(options.extension||"zip");// combine the output path and filename
-const outputPathAndFilename=path.resolve(compilation.options.output.path,// ...supporting both absolute and relative paths
-outputPath,path.basename(outputFilename,".zip")+extension// ...and filenames with and without a .zip extension
-);// resolve a relative output path with respect to webpack's root output path
-// since only relative paths are permitted for keys in `compilation.assets`
-const relativeOutputPath=path.relative(compilation.options.output.path,outputPathAndFilename);// add our zip file to the assets
-const zipFileSource=new RawSource(Buffer.concat(bufs));if(isWebpack4){compilation.assets[relativeOutputPath]=zipFileSource}else{compilation.emitAsset(relativeOutputPath,zipFileSource)}// 🗑️ 保存临时文件夹路径，用于后续删除
-if(options.cleanTempFolder!==false){const tempFolder=compilation.options.output.path;const zipOutputPath=options.path||compilation.options.output.path;// 确保临时文件夹存在且不是 zip 输出目录
-if(tempFolder&&tempFolder!==zipOutputPath){tempFolderToClean=tempFolder}}callback()})};if(isWebpack4){compiler.hooks.emit.tapAsync(ZipPlugin.name,process)}else{compiler.hooks.thisCompilation.tap(ZipPlugin.name,compilation=>{compilation.hooks.processAssets.tapPromise({name:ZipPlugin.name,stage:webpack.Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE_TRANSFER},()=>new Promise(resolve=>process(compilation,resolve)))})}// 🗑️ 在所有文件写入完成后删除临时文件夹
-compiler.hooks.done.tap(ZipPlugin.name,()=>{if(tempFolderToClean&&fs.existsSync(tempFolderToClean)){try{fs.rmSync(tempFolderToClean,{recursive:true,force:true});console.log(`✅ 已删除临时文件夹: ${tempFolderToClean}`)}catch(err){console.warn(`⚠️ 删除临时文件夹失败: ${tempFolderToClean}`,err.message)}}})};exports.ZipPlugin=ZipPlugin;
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const ModuleFilenameHelpers = require('webpack/lib/ModuleFilenameHelpers');
+const webpack = require('webpack');
+const webpackSources = webpack.sources || require('webpack-sources');
+const yazl = require('yazl');
+
+function ZipPlugin(options) {
+  this.options = options || {};
+}
+
+ZipPlugin.prototype.apply = function (compiler) {
+  const options = this.options;
+  const isWebpack4 = webpack.version.startsWith('4.');
+  // Prefer `compiler.webpack` instead of webpack or webpack-sources import (rspack compatibility hack)
+  const { RawSource } = (compiler.webpack && compiler.webpack.sources) || webpackSources;
+
+  if (options.pathPrefix && path.isAbsolute(options.pathPrefix)) {
+    throw new Error('"pathPrefix" must be a relative path');
+  }
+
+  // 保存临时文件夹路径，用于后续删除
+  let tempFolderToClean = null;
+
+  const process = function (compilation, callback) {
+    // assets from child compilers will be included in the parent
+    // so we should not run in child compilers
+    if (compilation.compiler.isChild()) {
+      callback();
+      return;
+    }
+
+    const zipFile = new yazl.ZipFile();
+
+    const pathPrefix = options.pathPrefix || '';
+    const pathMapper =
+      options.pathMapper ||
+      function (x) {
+        return x;
+      };
+
+    // populate the zip file with each asset
+    for (const nameAndPath of Object.keys(compilation.assets)) {
+      // match against include and exclude, which may be strings, regexes, arrays of the previous or omitted
+      if (!ModuleFilenameHelpers.matchObject({ include: options.include, exclude: options.exclude }, nameAndPath)) continue;
+
+      const source = compilation.assets[nameAndPath].source();
+
+      zipFile.addBuffer(
+        Buffer.isBuffer(source) ? source : Buffer.from ? Buffer.from(source) : new Buffer(source),
+        path.join(pathPrefix, pathMapper(nameAndPath)),
+        options.fileOptions
+      );
+    }
+
+    zipFile.end(options.zipOptions);
+
+    // accumulate each buffer containing a part of the zip file
+    const bufs = [];
+
+    zipFile.outputStream.on('data', function (buf) {
+      bufs.push(buf);
+    });
+
+    zipFile.outputStream.on('end', function () {
+      // default to webpack's root output path if no path provided
+      const outputPath = options.path || compilation.options.output.path;
+      // default to webpack root filename if no filename provided, else the basename of the output path
+      let outputFilename = options.filename || compilation.options.output.filename || path.basename(outputPath);
+
+      const fullHash = compilation.fullHash || compilation.hash;
+      outputFilename = outputFilename.replace('[fullhash:6]', fullHash.slice(0, 6));
+
+      const extension = '.' + (options.extension || 'zip');
+
+      // combine the output path and filename
+      const outputPathAndFilename = path.resolve(
+        compilation.options.output.path, // ...supporting both absolute and relative paths
+        outputPath,
+        path.basename(outputFilename, '.zip') + extension // ...and filenames with and without a .zip extension
+      );
+
+      // resolve a relative output path with respect to webpack's root output path
+      // since only relative paths are permitted for keys in `compilation.assets`
+      const relativeOutputPath = path.relative(compilation.options.output.path, outputPathAndFilename);
+
+      // add our zip file to the assets
+      const zipFileSource = new RawSource(Buffer.concat(bufs));
+      if (isWebpack4) {
+        compilation.assets[relativeOutputPath] = zipFileSource;
+      } else {
+        compilation.emitAsset(relativeOutputPath, zipFileSource);
+      }
+
+      // 🗑️ 保存临时文件夹路径，用于后续删除
+      if (options.cleanTempFolder !== false) {
+        const tempFolder = compilation.options.output.path;
+        const zipOutputPath = options.path || compilation.options.output.path;
+        // 确保临时文件夹存在且不是 zip 输出目录
+        if (tempFolder && tempFolder !== zipOutputPath) {
+          tempFolderToClean = tempFolder;
+        }
+      }
+
+      callback();
+    });
+  };
+
+  if (isWebpack4) {
+    compiler.hooks.emit.tapAsync(ZipPlugin.name, process);
+  } else {
+    compiler.hooks.thisCompilation.tap(ZipPlugin.name, (compilation) => {
+      compilation.hooks.processAssets.tapPromise(
+        {
+          name: ZipPlugin.name,
+          stage: webpack.Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE_TRANSFER
+        },
+        () => new Promise((resolve) => process(compilation, resolve))
+      );
+    });
+  }
+
+  // 🗑️ 在所有文件写入完成后删除临时文件夹
+  compiler.hooks.done.tap(ZipPlugin.name, () => {
+    if (tempFolderToClean && fs.existsSync(tempFolderToClean)) {
+      try {
+        fs.rmSync(tempFolderToClean, { recursive: true, force: true });
+        console.log(`✅ 已删除临时文件夹: ${tempFolderToClean}`);
+      } catch (err) {
+        console.warn(`⚠️ 删除临时文件夹失败: ${tempFolderToClean}`, err.message);
+      }
+    }
+  });
+};
+
+exports.ZipPlugin = ZipPlugin;

package/core/resources/fonts/README.md

@@ -0,0 +1,31 @@
+# 平台预置字体资源
+
+本目录存放可玩广告使用的字体内置资源文件（woff2 格式）。
+
+## 字体列表
+
+| key | 文件名 | 说明 | 下载来源 |
+|-----|--------|------|----------|
+| `poppins` | `poppins-regular.woff2` | 英文字体 Poppins Regular | [Google Fonts](https://fonts.google.com/specimen/Poppins) |
+| `noto-sans-sc` | `noto-sans-sc-regular.woff2` | 简体中文 Noto Sans SC | [Google Fonts](https://fonts.google.com/noto/specimen/Noto+Sans+SC) |
+| `pangmen` | `pangmen-regular.woff2` | 庞门正道标题体 | 字体网站下载后 subset |
+| `maoken` | `maoken-regular.woff2` | 猫啃珠圆体 | 字体网站下载后 subset |
+
+## 下载字体
+
+```bash
+# 在 playable-scripts 目录下运行
+node scripts/download-fonts.js
+```
+
+该脚本会自动下载 Google Fonts 中的开源字体（poppins、noto-sans-sc），
+并转换为 woff2 格式存入本目录。
+
+对于 pangmen / maoken 等非 Google Fonts 字体，需手动下载后放入本目录。
+
+## 字体文件要求
+
+- 格式：woff2
+- 文件名：与上表中的 key 对应
+- 中文字体需做 subset（仅保留常用字符），建议控制在 100KB 以内
+- 会被内联为 base64 写入 HTML 产物，请控制体积

package/core/resources/fonts/maoken-regular.woff2.chars

@@ -0,0 +1 @@
+5434fbcb2072e4a7760465dd0f37cffa

package/core/resources/fonts/pangmen-regular.woff2.chars

@@ -0,0 +1 @@
+5434fbcb2072e4a7760465dd0f37cffa

package/core/utils/buildDefines.js

@@ -1,3 +1,30 @@
-"use strict";const{options}=require("../options");/**
+const { options } = require('../options');
+
+/**
  * Build's default defines list for dev & prod builds
- */exports.buildDefines=function buildDefines(){const defines={__DEV__:JSON.stringify(options["dev"]===undefined?false:options["dev"]),GOOGLE_PLAY_URL:JSON.stringify(options.googlePlayUrl),APP_STORE_URL:JSON.stringify(options.appStoreUrl),AD_NETWORK:JSON.stringify(options["network"]),AD_PROTOCOL:JSON.stringify(options["protocol"]),APP:JSON.stringify(options.app),NAME:JSON.stringify(options.name),VERSION:JSON.stringify(options.version),BUILD_HASH:JSON.stringify((+new Date).toString(36)),LANGUAGE:JSON.stringify(options.language),ORIENTATION:JSON.stringify(options.orientation)};/** @type {AD_NETWORK} */let adNetworkDefine=options["network"];if(adNetworkDefine==="pangle")adNetworkDefine="tiktok";if(adNetworkDefine==="mytarget"||adNetworkDefine==="moloco")adNetworkDefine="facebook";defines["AD_NETWORK"]=JSON.stringify(adNetworkDefine);return defines};
+ */
+exports.buildDefines = function buildDefines() {
+  const defines = {
+    __DEV__: JSON.stringify(options['dev'] === undefined ? false : options['dev']),
+    GOOGLE_PLAY_URL: JSON.stringify(options.googlePlayUrl),
+    APP_STORE_URL: JSON.stringify(options.appStoreUrl),
+    AD_NETWORK: JSON.stringify(options['network']),
+    AD_PROTOCOL: JSON.stringify(options['protocol']),
+    APP: JSON.stringify(options.app),
+    NAME: JSON.stringify(options.name),
+    VERSION: JSON.stringify(options.version),
+    BUILD_HASH: JSON.stringify((+new Date()).toString(36)),
+    LANGUAGE: JSON.stringify(options.language),
+    ORIENTATION: JSON.stringify(options.orientation)
+  };
+
+  /** @type {AD_NETWORK} */
+  let adNetworkDefine = options['network'];
+
+  if (adNetworkDefine === 'pangle') adNetworkDefine = 'tiktok';
+  if (adNetworkDefine === 'mytarget' || adNetworkDefine === 'moloco') adNetworkDefine = 'facebook';
+
+  defines['AD_NETWORK'] = JSON.stringify(adNetworkDefine);
+
+  return defines;
+};

package/core/utils/buildTemplateString.js

@@ -1,6 +1,41 @@
-"use strict";const{options}=require("../options");const{getCurrentDateFormatted}=require("./date");const path=require("path");/** @type {Record<string, string>} Mapping of ad network identifiers to their display names in filenames */const adNetworkFileNameMap={preview:"Preview",bigoads:"bigo"};/**
+const { options } = require('../options');
+const { getCurrentDateFormatted } = require('./date');
+const path = require('path');
+
+/** @type {Record<string, string>} Mapping of ad network identifiers to their display names in filenames */
+const adNetworkFileNameMap = {
+  preview: 'Preview',
+  bigoads: 'bigo'
+};
+
+/**
  * Build's result string from template. Used for outDir or filename
- */exports.buildTemplateString=function buildTemplateString(template,customOptions){customOptions=customOptions||options;/** @type {AD_NETWORK} */const adNetwork=customOptions["network"];/** @type {AD_PROTOCOL} */// const adProtocol = customOptions['protocol'];
-let networkName=customOptions.adNetworkNames[adNetwork]||adNetworkFileNameMap[adNetwork]||adNetwork;// if (adProtocol === 'dapi') networkName += '_DAPI';
-// 如果是绝对路径，直接返回，不做模板替换
-if(path.isAbsolute(template)){return template}template=template.replaceAll("{app}",customOptions.app);template=template.replaceAll("{name}",customOptions.name);template=template.replaceAll("{version}",customOptions.version);template=template.replaceAll("{date}",getCurrentDateFormatted());template=template.replaceAll("{language}",customOptions.language);template=template.replaceAll("{orientation}",customOptions.orientation);template=template.replaceAll("{network}",networkName.toLowerCase());template=template.replaceAll("{hash}","[fullhash:6]");return template};
+ */
+exports.buildTemplateString = function buildTemplateString(template, customOptions) {
+  customOptions = customOptions || options;
+
+  /** @type {AD_NETWORK} */
+  const adNetwork = customOptions['network'];
+
+  /** @type {AD_PROTOCOL} */
+  // const adProtocol = customOptions['protocol'];
+
+  let networkName = customOptions.adNetworkNames[adNetwork] || adNetworkFileNameMap[adNetwork] || adNetwork;
+  // if (adProtocol === 'dapi') networkName += '_DAPI';
+
+  // 如果是绝对路径，直接返回，不做模板替换
+  if (path.isAbsolute(template)) {
+    return template;
+  }
+
+  template = template.replaceAll('{app}', customOptions.app);
+  template = template.replaceAll('{name}', customOptions.name);
+  template = template.replaceAll('{version}', customOptions.version);
+  template = template.replaceAll('{date}', getCurrentDateFormatted());
+  template = template.replaceAll('{language}', customOptions.language);
+  template = template.replaceAll('{orientation}', customOptions.orientation);
+  template = template.replaceAll('{network}', networkName.toLowerCase());
+  template = template.replaceAll('{hash}', '[fullhash:6]');
+
+  return template;
+};

package/core/utils/date.js

@@ -1 +1,16 @@
-"use strict";exports.getCurrentDateFormatted=function getCurrentDateFormatted(includeTime){const date=new Date;const year=date.getFullYear();const month=(date.getMonth()+1).toString().padStart(2,"0");const day=date.getDate().toString().padStart(2,"0");if(includeTime){const hour=date.getHours().toString().padStart(2,"0");const minute=date.getMinutes().toString().padStart(2,"0");const second=date.getSeconds().toString().padStart(2,"0");return`${year}${month}${day}-${hour}${minute}${second}`}return`${year}${month}${day}`};
+exports.getCurrentDateFormatted = function getCurrentDateFormatted(includeTime) {
+  const date = new Date();
+  const year = date.getFullYear();
+  const month = (date.getMonth() + 1).toString().padStart(2, '0');
+  const day = date.getDate().toString().padStart(2, '0');
+
+  if (includeTime) {
+    const hour = date.getHours().toString().padStart(2, '0');
+    const minute = date.getMinutes().toString().padStart(2, '0');
+    const second = date.getSeconds().toString().padStart(2, '0');
+
+    return `${year}${month}${day}-${hour}${minute}${second}`;
+  }
+
+  return `${year}${month}${day}`;
+};

package/core/utils/fontRegistry.js

@@ -0,0 +1,97 @@
+'use strict';
+
+/**
+ * 平台预置字体字典。
+ *
+ * 所有字体文件内置于 playable-scripts/core/resources/fonts/ 目录下。
+ * 首次使用前需运行 `node scripts/download-fonts.js` 下载字体文件。
+ *
+ * 分类：
+ *   - builtin=true: 系统自带字体，无需注入文件，运行时走 CSS fallback 链
+ *   - builtin=false: 需要从本地字体文件读取并 base64 内联到产物中
+ *
+ * key 命名规范：与 theme.schema.json5 中 fontFamily 的 enum 值一一对应。
+ */
+
+const path = require('path');
+
+/** 字体资源目录（随 npm 包发布） */
+const FONTS_DIR = path.join(__dirname, '..', 'resources', 'fonts');
+
+const FONT_REGISTRY = {
+  // ===== 系统自带字体（无需注入） =====
+  system: {
+    builtin: true,
+    fallback: 'system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',
+  },
+  Arial: {
+    builtin: true,
+    fallback: 'Arial, Helvetica, sans-serif',
+  },
+  monaco: {
+    builtin: true,
+    fallback: 'Monaco, "Courier New", monospace',
+  },
+
+  // ===== 平台内置字体（base64 内联注入） =====
+  // key 必须与 theme.schema.json5 fontFamily.enum 值完全一致
+
+  // Google Fonts 字体：单文件 woff2
+  Poppins: {
+    builtin: false,
+    fontFileName: 'poppins-regular.woff2',
+    cssFamily: 'Poppins, sans-serif',
+  },
+  'Noto Sans SC': {
+    builtin: false,
+    fontFileName: 'noto-sans-sc-regular.woff2',
+    cssFamily: '"Noto Sans SC", sans-serif',
+  },
+
+  // 本地 ttf 种子字体（单文件 woff2，由 download-fonts.js 用 pyftsubset 生成）
+  'Pangmen Zhengdao': {
+    builtin: false,
+    fontFileName: 'pangmen-regular.woff2', // 由 pangmen-biaoti.ttf subset 生成
+    cssFamily: '"Pangmen Zhengdao", sans-serif',
+  },
+
+  // ZeoSeven 字体：unicode-range 子集（build 时按需筛选）
+  'Maoken Zhuyuan Ti': {
+    builtin: false,
+    subsetsDir: 'maoken',
+    fontFileName: 'maoken-regular.woff2',
+    cssFamily: '"Maoken Zhuyuan Ti", sans-serif',
+  },
+};
+
+/**
+ * @returns {string[]} 所有已注册的字体 key 列表
+ */
+function getRegisteredFontKeys() {
+  return Object.keys(FONT_REGISTRY);
+}
+
+/**
+ * @param {string} key - 字体 key
+ * @returns {boolean} 是否为系统自带字体
+ */
+function isBuiltin(key) {
+  return !!(FONT_REGISTRY[key] && FONT_REGISTRY[key].builtin);
+}
+
+/**
+ * @param {string} key - 字体 key
+ * @returns {object|null} 字体配置对象，未注册返回 null
+ */
+function getFontEntry(key) {
+  return FONT_REGISTRY[key] || null;
+}
+
+/**
+ * @returns {string} 字体资源目录绝对路径
+ */
+function getFontsDir() {
+  return FONTS_DIR;
+}
+
+module.exports = { FONT_REGISTRY, getRegisteredFontKeys, isBuiltin, getFontEntry, getFontsDir };