@playcraft/skills 0.0.2

package/skills/playable_scripts_build.aicomponent/ref/builds.config.js

@@ -0,0 +1,257 @@
+/**
+ * Arrow Puzzle 批量构建配置文件
+ * 
+ * 使用 playable-scripts 的批量构建功能
+ * 
+ * 使用方法：
+ * 1. 构建所有主题所有渠道：npm run builds
+ * 2. 构建指定主题：npm run builds -- -t "H-0001-Challenge Mode"
+ * 3. 构建指定渠道：npm run builds -- -c google,facebook
+ * 4. 指定并发数：npm run builds -- -p 4
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 项目配置
+const PROJECT_CONFIG = {
+  name: 'Arrow Puzzle',         // 项目名称
+  googlePlayUrl: 'https://play.google.com/store/apps/details?id=com.ecffri.arrows&hl=en_US',
+  appStoreUrl: 'https://apps.apple.com/us/app/arrows-puzzle-escape/id6748397500',
+};
+
+// 文件命名配置
+const NAMING_CONFIG = {
+  language: 'EN',      // 语言
+  format: 'NA',        // 格式
+  supplier: 'AIX',     // 供应商
+  follower: 'WZN'      // 跟进人
+};
+
+// 主题黑名单（这些主题不会被打包）
+const THEME_BLACKLIST = [
+  'dev',           // 开发模式主题，仅用于本地开发
+  'current.ts',    // 主题配置文件，非主题目录
+];
+
+/**
+ * 从 theme 目录自动读取所有主题变体
+ */
+function getThemeVariants() {
+  const THEME_DIR = path.join(__dirname, 'src', 'theme');
+  
+  try {
+    const items = fs.readdirSync(THEME_DIR, { withFileTypes: true });
+    const themes = items
+      .filter(item => item.isDirectory())  // 只保留目录
+      .map(item => item.name)
+      .filter(name => !THEME_BLACKLIST.includes(name));  // 过滤黑名单
+    
+    return themes;
+  } catch (error) {
+    console.error(`读取主题目录失败: ${error.message}`);
+    return [];
+  }
+}
+
+// 获取当前月份（两位数）
+function getCurrentMonth() {
+  return String(new Date().getMonth() + 1).padStart(2, '0');
+}
+
+// 获取当前日期（YYYYMMDD格式）
+function getCurrentDate() {
+  const date = new Date();
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, '0');
+  const day = String(date.getDate()).padStart(2, '0');
+  return `${year}${month}${day}`;
+}
+
+/**
+ * 自定义文件名生成器
+ * 规则: {主题名}-EN-NA-{月}-{日期}-AIX-ZQL-{渠道}
+ * 
+ * @param {string} themeName - 主题名称
+ * @param {string} channel - 渠道名称
+ * @param {string} date - 日期（YYYYMMDD格式）
+ * @param {string} month - 月份（中文格式，如：3月）
+ * @returns {string} 文件名（不含扩展名）
+ */
+function generateFileName(themeName, channel, date, month) {
+  // 从中文月份提取数字（如：3月 → 03）
+  const monthNumber = getCurrentMonth();
+  
+  const parts = [
+    themeName,                      // 主题名（如：H-0001-Challenge Mode）
+    NAMING_CONFIG.language,         // EN
+    NAMING_CONFIG.format,           // NA
+    monthNumber,                    // 03（两位数字）
+    date,                           // 20260302
+    NAMING_CONFIG.supplier,         // AIX
+    NAMING_CONFIG.follower,         // ZQL
+    channel.toLowerCase()           // facebook
+  ];
+  
+  return parts.join('-');
+}
+
+module.exports = {
+  // ==================== 项目配置 ====================
+  
+  projectName: PROJECT_CONFIG.name,
+  
+  // 商店链接配置
+  googlePlayUrl: PROJECT_CONFIG.googlePlayUrl,
+  appStoreUrl: PROJECT_CONFIG.appStoreUrl,
+  
+  // ==================== 主题配置 ====================
+  
+  themes: {
+    enabled: true,
+    
+    // 主题列表（自动从 src/theme 目录读取）
+    list: getThemeVariants(),
+    
+    // 主题切换配置
+    switching: {
+      // 入口文件路径（相对于项目根目录）
+      entryFile: 'src/theme/current.ts',
+      
+      // 入口文件生成函数
+      generateEntryFile: (themeName) => {
+        return `/**
+ * 当前激活的主题变体
+ * 
+ * 注意: 这个文件会在构建时被 builds 脚本自动修改
+ * 请不要手动修改这个值，除非你在本地开发测试
+ */
+
+import type { ThemeVariantConfig } from '../client/game/config/ThemeVariants';
+
+// 构建脚本会修改这一行
+import config, { levels } from './${themeName}';
+
+const currentConfig: ThemeVariantConfig = config;
+export default currentConfig;
+
+// 同时导出关卡数据
+export { levels };
+`;
+      },
+      
+      // 关卡数据文件切换（可选）
+      additionalFiles: [
+        {
+          path: 'src/client/game/level-data/index.ts',
+          generate: (themeName) => {
+            return `// 构建脚本自动生成 - 当前主题: ${themeName}
+import { levels } from "../../../theme/${themeName}";
+export default levels;
+`;
+          }
+        }
+      ]
+    },
+    
+    // 默认主题（构建完成后恢复）
+    defaultTheme: 'dev',
+  },
+  
+  // ==================== 渠道配置 ====================
+  
+  channels: [
+    'mintegral',
+    'unity',
+    'ironSource',
+    'facebook',
+    'tiktok',
+    'google',
+    'applovin',
+    'snapchat',
+    'moloco',
+    'liftoff',
+    'adikteev',
+    'inmobi'
+  ],
+  
+  // ==================== 文件命名配置 ====================
+  
+  naming: {
+    // 自定义文件名生成器
+    generator: generateFileName,
+  },
+  
+  // ==================== 构建配置 ====================
+  
+  build: {
+    // 输出目录
+    // outputDir: 'dist-all',
+    
+    // // 临时目录前缀
+    // tempDirPrefix: 'dist-temp',
+    
+    // // 构建错误时是否继续
+    // continueOnError: true,
+    
+    // // 构建完成后清理临时目录
+    // cleanTemp: true,
+    
+    // // 并发数（根据 CPU 核心数自动调整：CPU核心数-1，最小2，最大8）
+    // // 可以通过命令行参数 -p 覆盖
+    // parallel: (() => {
+    //   const cpuCount = require('os').cpus().length;
+    //   const calculated = Math.max(2, cpuCount - 1);
+    //   return Math.min(8, calculated);
+    // })(),
+  },
+  
+  // ==================== 钩子函数（可选）====================
+  
+  hooks: {
+    /**
+     * 构建前钩子
+     * @param {string} themeName - 主题名称
+     * @param {string} channel - 渠道名称
+     */
+    beforeBuild: (themeName, channel) => {
+      // console.log(`准备构建: ${themeName}/${channel}`);
+    },
+    
+    /**
+     * 构建后钩子
+     * @param {string} themeName - 主题名称
+     * @param {string} channel - 渠道名称
+     * @param {boolean} success - 是否成功
+     */
+    afterBuild: (themeName, channel, success) => {
+      // if (success) {
+      //   console.log(`构建成功: ${themeName}/${channel}`);
+      // }
+    },
+    
+    /**
+     * 主题切换前钩子
+     * @param {string} themeName - 主题名称
+     */
+    beforeThemeSwitch: (themeName) => {
+      // 可以在这里清理 webpack 缓存等
+      const cacheDir = path.join(__dirname, 'node_modules', '.cache');
+      if (fs.existsSync(cacheDir)) {
+        try {
+          fs.rmSync(cacheDir, { recursive: true, force: true });
+        } catch (err) {
+          // 忽略清理失败
+        }
+      }
+    },
+    
+    /**
+     * 主题切换后钩子
+     * @param {string} themeName - 主题名称
+     */
+    afterThemeSwitch: (themeName) => {
+      // console.log(`已切换主题: ${themeName}`);
+    },
+  }
+};

package/skills/playcraft-3d-flip-sprite/SKILL.md

@@ -0,0 +1,336 @@
+---
+name: playcraft-3d-flip-sprite
+description: 基于 3D GLB 模型生成翻牌/翻转精灵图（sprite sheet）。使用纯 JS 软件光栅化渲染器（无需 Puppeteer / headless-gl），输出可直接用于 Canvas 动画的 PNG 精灵图。适用于麻将翻牌、卡牌翻转、硬币翻转等场景。
+compatibility: agent,opencode
+---
+
+# 3D 翻转精灵图生成 Skill
+
+## 我做什么
+
+1. 调用 `playcraft tools generate-3d` 生成 GLB 3D 模型（可选，也可直接使用现有 GLB）
+2. 运行纯 JS 软件光栅化渲染器，将 GLB 模型渲染成多帧翻转动画
+3. 合并输出一张 PNG 精灵图，可直接在 Canvas / WebGL / PlayCanvas 中播放
+
+渲染器特性：
+- 透视投影 + Z-buffer 深度测试
+- 从 GLB UV atlas 双线性采样贴图
+- Phong 光照（环境光 + 漫反射 + 镜面高光）
+- 逐顶点法线插值（平滑着色）
+- 2× 超采样抗锯齿（SSAA）
+- **零原生依赖**：只用 `@gltf-transform/core` + `sharp`，无 Puppeteer、无 `headless-gl`
+
+---
+
+## 核心流程
+
+```
+参考图 → generate-3d(GLB) → 分析法线方向 → 计算对齐角 → 逐帧渲染 → 合并精灵图
+```
+
+### 步骤 1：生成 GLB（可选）
+
+```bash
+playcraft tools generate-3d \
+  --input <参考图.png>     \
+  --output <输出目录>       \
+  --name <模型名>
+```
+
+生成的 GLB 保存在输出目录下，同时输出预览图。
+
+### 步骤 2：分析 GLB 面法线，求精确对齐角
+
+这是最容易踩坑的一步。HunyuanTo3D 等模型生成服务产出的 GLB **不一定** 以标准姿态朝向摄像机，必须从法线数据反推对齐旋转角。
+
+```javascript
+// 分析主面（Y 方向三角形最多）的平均法线
+const doc  = await (new NodeIO()).read(glbPath);
+let sumN = {x:0, y:0, z:0, n:0};
+for (const mesh of doc.getRoot().listMeshes()) {
+  for (const prim of mesh.listPrimitives()) {
+    const normA = prim.getAttribute('NORMAL');
+    const idxA  = prim.getIndices();
+    if (!normA) continue;
+    const norms = normA.getArray();
+    const idx   = idxA?.getArray();
+    const count = idx ? idx.length/3 : norms.length/9;
+    for (let t=0; t<count; t++) {
+      const i0 = idx ? idx[t*3] : t*3;
+      const ny = norms[i0*3+1];
+      // 找朝向相机的那一面（Y 方向分量最显著）
+      if (ny < -0.5) { sumN.x+=norms[i0*3]; sumN.y+=ny; sumN.z+=norms[i0*3+2]; sumN.n++; }
+    }
+  }
+}
+const avgN = normalize(sumN);   // 例如 (0, -0.944, 0.330)
+```
+
+得到主面平均法线 `avgN = (nx, ny, nz)` 后，求让该法线精确指向相机 (+Z) 的 RX 角：
+
+```
+// 目标：rotX(avgN, RX) = (0, 0, 1)
+// 方程组：ny*cos(RX) - nz*sin(RX) = 0
+//         ny*sin(RX) + nz*cos(RX) = 1  ← 只有一个解在正确象限
+// 解：tan(RX) = ny/nz  （取 z'=1 的那个解）
+const RX_ALIGN = Math.atan2(-avgN.z, avgN.y);   // ≈ -1.234 rad for (0,-0.944,0.330)
+```
+
+### 步骤 3：确定 RX_INIT 和翻转方向
+
+GLB 模型有两个关键对齐角：
+
+| 情况 | RX_INIT | ry 范围 | 帧 0 显示 |
+|------|---------|---------|----------|
+| 绿背面（或背面）先出现，翻到正面 | `RX_ALIGN + π` | `π → 0` | 背面 |
+| 正面先出现（不需要翻转揭示效果） | `RX_ALIGN` | `0 → π` | 正面 |
+
+> **关键**：用 `RX_ALIGN + π` 时，正面在 ry=0 处正对摄像机，且字符**上下方向正确**。  
+> 反之 `RX_ALIGN` 会让背面先出现，字符上下颠倒。
+
+翻转方向代码：
+
+```javascript
+// 翻转：背面 → 正面（推荐）
+const ry = Math.PI - (i / (FRAMES-1)) * Math.PI;  // π → 0
+
+// 翻转：正面 → 背面
+const ry = (i / (FRAMES-1)) * Math.PI;             // 0 → π
+```
+
+### 步骤 4：渲染循环与 UV 镜像修正
+
+**最重要的坑**：GLB 正面在屏幕空间的三角形绕序（Winding）会变成顺时针（CW），必须在 UV 采样时做 U 轴镜像修正，否则贴图中的文字/图案会水平镜像。
+
+```javascript
+// 屏幕空间有向面积（正=CCW，负=CW）
+const area2 = (p1.sx-p0.sx)*(p0.sy-p2.sy) - (p0.sx-p2.sx)*(p1.sy-p0.sy);
+const isMirrored = area2 < 0;
+
+// U 轴镜像：翻转后的面需要翻 U，保证文字方向正确
+const uSample = isMirrored ? 1 - uI : uI;
+const vSample = vI;                // V 不动，全局不翻转
+
+// 重心坐标符号同步翻转
+const sign = isMirrored ? -1 : 1;
+const w0 = sign * (...) * invArea;
+```
+
+**坑：不要全局翻转 V**。GLB UV 图集的 V=0 在图像顶部，与图像坐标一致，全局翻 V 会破坏图集中所有面片的纹理。
+
+### 步骤 5：Phong 光照参数参考
+
+```javascript
+const LIGHT    = normalize(v3(0.3, 0.8, 1.0));  // 右上前方光源
+const VIEW_DIR = v3(0, 0, 1);
+const AMBIENT  = 0.32;
+const DIFFUSE  = 0.60;
+const SPECULAR = 0.18;
+const SHININESS = 48;
+
+// 着色
+const NdL = Math.max(0, dot(nN, LIGHT));
+const half = normalize(add(LIGHT, VIEW_DIR));
+const NdH  = Math.max(0, dot(nN, half));
+const light = AMBIENT + DIFFUSE * NdL;
+const spec  = SPECULAR * Math.pow(NdH, SHININESS);
+```
+
+---
+
+## 完整渲染器模板
+
+完整可运行的渲染器参见项目内：
+
+```
+/tmp/mahjong-tile/  ← 示例输出
+packages/cli/tmp/glb-render/render.mjs   ← 完整实现（可复制复用）
+```
+
+主要参数一览：
+
+```javascript
+const GLB_PATH  = 'your_model.glb';
+const OUT_PATH  = 'tile_flip_sprite.png';
+const FRAMES    = 16;       // 精灵图总帧数
+const COLS      = 8;        // 每行列数（ROWS = FRAMES/COLS）
+const W = 280, H = 280;     // 每帧像素尺寸
+const SS = 2;               // 超采样倍数（2 = 4× SSAA）
+const FOCAL     = 2.8;      // 透视焦距（越大越"长焦"）
+const CAMERA_Z  = 3.2;      // 相机 Z 距离
+```
+
+---
+
+## 常见问题与解法
+
+### 1. 牌/模型倾斜歪了
+
+**原因**：直接用 RX=-π/2 是经验值，GLB 主面法线往往带有额外倾斜（如 14.9°）。  
+**解法**：按步骤 2 从法线数据解析精确 `RX_INIT`，不要猜。
+
+### 2. 字符水平镜像（字反了）
+
+**原因**：Y 轴 180° 旋转后，三角形在屏幕空间变成 CW 绕序，UV 的 U 方向随之镜像。  
+**解法**：检测 `area2 < 0`，对这类三角形令 `uSample = 1 - uI`（见步骤 4）。
+
+### 3. 字符上下颠倒（一在下，万在上）
+
+**原因**：错误的 `RX_INIT` 导致模型 -Z 端（字符"上"端）被映射到世界 -Y（屏幕下方）。  
+**解法**：使用 `RX_INIT = RX_ALIGN + π`，并将翻转方向改为 `ry: π → 0`（见步骤 3）。
+
+### 4. 全局翻 V 导致纹理全部乱掉
+
+**原因**：HunyuanTo3D 输出的是 UV Atlas，不同面片共享同一纹理坐标空间，全局翻 V 会同时破坏所有面片。  
+**解法**：V 坐标不做任何修改，只修正 U（见步骤 4）。
+
+### 5. Puppeteer / headless-gl 编译失败
+
+**原因**：`headless-gl` 依赖 C++ 原生编译，macOS / Node 22 环境下经常遭遇 C++20 或 `std::auto_ptr` 废弃错误。  
+**解法**：使用本 skill 的纯 JS 软件光栅化方案，不引入任何原生依赖。
+
+---
+
+## 整副麻将批量生成：白模 + 贴图分离架构
+
+### 问题
+
+HunyuanTo3D 生成的 GLB **把字符形状烘焙进了 3D 几何体**（实际的浮雕顶点），不只是贴图。  
+如果直接用这个 GLB 替换贴图，会看到原始 3D 字符几何体"透底"——新贴图和旧几何体叠加。
+
+### 正确架构
+
+```
+白模 GLB（平面牌面，无字符几何）
+  + 牌面图 × N（一萬/二萬/.../九條/中/發/白...）
+  = N 套精灵图
+```
+
+### 步骤：制作白模 GLB（两种方案）
+
+#### 方案 A（推荐）：刮平现有 GLB（快，零成本）
+
+HunyuanTo3D 生成的 GLB 把字符形状烘焙进了正面顶点（浮雕几何）。
+只需用 `flatten_glb.mjs` 把正面顶点统一到同一 Y 值即可：
+
+```bash
+# 把 一萬.glb 的正面浮雕刮平 → 白模
+node renderer/flatten_glb.mjs \
+  tile_1wan.glb \
+  tile_base_flat.glb \
+  0.7    # 法线 Y 阈值，正面顶点 normalY > 0.7 才被刮平
+```
+
+原理：找所有 `normalY > threshold` 的顶点（即正面），强制将 Y 坐标统一设为最大值。
+时间：< 1 秒，零 API 消耗。
+
+#### 方案 B：用空白图重新生成 GLB
+
+当现有 GLB 的侧面/边缘纹理也需要替换时（如更换主题风格），
+用空白参考图重新调用 HunyuanTo3D：
+
+```bash
+# 先生成纯白底参考图（可程序化生成，不消耗 image credits）
+node -e "
+  require('sharp')({
+    create:{width:512,height:640,channels:4,background:{r:245,g:240,b:228,alpha:255}}
+  }).composite([{
+    input: Buffer.from('<svg xmlns=\"http://www.w3.org/2000/svg\"><rect width=\"512\" height=\"640\" rx=\"40\" fill=\"none\" stroke=\"#3a6b48\" stroke-width=\"12\"/></svg>'),
+  }]).png().toFile('blank_tile_ref.png');
+"
+
+# 生成白模 GLB
+playcraft tools generate-3d \
+  --input blank_tile_ref.png \
+  --output ./base \
+  --name tile_base
+```
+
+### 步骤：生成各牌面图
+
+```bash
+# 一萬 到 九萬
+for n in 一 二 三 四 五 六 七 八 九; do
+  playcraft image generate \
+    --prompt "${n}万 mahjong tile face, flat illustration, red characters on white" \
+    --output /tmp/faces/${n}wan.png
+done
+
+# 或用 SVG 程序化生成（推荐，精度高且不消耗 AI credits）
+```
+
+### 步骤：批量渲染
+
+```bash
+# 同一白模 GLB + 不同牌面图 → 不同精灵图
+for n in 一 二 三 四 五 六 七 八 九; do
+  node render.mjs \
+    /tmp/mahjong-base/tile_base.glb \
+    /tmp/sprites/${n}wan_sprite.png \
+    /tmp/faces/${n}wan.png
+done
+```
+
+> ⚡ 3 张牌并行约 2.5 秒，全套 34 种牌型理论 < 30 秒（8 并发时）
+
+### 面贴图的 UV 映射说明
+
+render.mjs 自动从法线检测正面三角形（`normalY > 0.7`），用模型空间 XZ 坐标生成 UV：
+
+```
+faceU = (x - faceXMin) / faceXRange    →  牌面左边=0, 右边=1
+faceV = (z - faceZMin) / faceZRange    →  一端(顶)=0, 万端(底)=1
+```
+
+牌面图只需保证：**字符上边 = 图像顶部，字符下边 = 图像底部**，直接映射，无需调 UV。
+
+### 渲染器 CLI
+
+```bash
+node render.mjs <glb> <output.png> [face-texture.png]
+#
+# 不传第三个参数 → 使用 GLB 原始 UV Atlas（调试/单张使用）
+# 传入第三个参数 → 正面使用该贴图，侧面/背面仍用 GLB Atlas
+```
+
+---
+
+## 生成的精灵图如何在前端使用
+
+```javascript
+// Canvas 播放示例
+const SHEET   = './tile_flip_sprite.png';
+const FRAMES  = 16, COLS = 8;
+const FW = 280, FH = 280;        // 原始每帧尺寸
+const DW = 120, DH = 120;        // 显示尺寸
+
+const img = new Image();
+img.src = SHEET;
+
+function drawFrame(ctx, frame) {
+  const col = frame % COLS;
+  const row = Math.floor(frame / COLS);
+  ctx.drawImage(img, col*FW, row*FH, FW, FH, 0, 0, DW, DH);
+}
+
+// 翻牌动画：
+let progress = 0;
+function flip() {
+  requestAnimationFrame(() => {
+    drawFrame(ctx, Math.round(progress));
+    progress += speed;
+    if (progress < FRAMES - 1) flip();
+  });
+}
+```
+
+---
+
+## 与其他 Skill 的关系
+
+| Skill | 关系 |
+|-------|------|
+| `playcraft-sprite-sheet` | 多张平面图合并为精灵图；本 skill 专注 3D 模型渲染 |
+| `sprite-animation-2d` | PlayCanvas 中播放精灵图动画的代码模板 |
+| `sound-effects` | 翻牌时配合 `card_flip.mp3` 音效 |
+| `playcraft-image-generation` | 生成牌面贴图后，再走 generate-3d → 本 skill |

package/skills/playcraft-3d-flip-sprite/renderer/flatten_glb.mjs

@@ -0,0 +1,62 @@
+/**
+ * GLB 正面刮平工具
+ *
+ * 作用：把 HunyuanTo3D 生成的字符 GLB 的正面几何体"刮平"，
+ *       消除烘焙在顶点中的浮雕字符，得到适合贴图替换的白模。
+ *
+ * Usage:
+ *   node flatten_glb.mjs <input.glb> <output_flat.glb> [threshold=0.7]
+ *
+ * 原理：
+ *   找所有法线 Y > threshold 的顶点（正面顶点），
+ *   强制将它们的 Y 坐标统一设为正面最大 Y 值（最高点 = 完全平坦）。
+ */
+import { NodeIO } from '@gltf-transform/core';
+
+const INPUT      = process.argv[2];
+const OUTPUT     = process.argv[3];
+const THRESHOLD  = parseFloat(process.argv[4] ?? '0.7');
+
+if (!INPUT || !OUTPUT) {
+  console.error('Usage: node flatten_glb.mjs <input.glb> <output.glb> [threshold=0.7]');
+  process.exit(1);
+}
+
+const io  = new NodeIO();
+const doc = await io.read(INPUT);
+
+// Pass 1: find max Y of face vertices (highest point of the front face)
+let maxFaceY = -Infinity;
+for (const mesh of doc.getRoot().listMeshes()) {
+  for (const prim of mesh.listPrimitives()) {
+    const posA  = prim.getAttribute('POSITION');
+    const normA = prim.getAttribute('NORMAL');
+    if (!posA || !normA) continue;
+    const pos   = posA.getArray();
+    const norms = normA.getArray();
+    for (let i = 0; i < pos.length / 3; i++) {
+      if (norms[i * 3 + 1] > THRESHOLD) maxFaceY = Math.max(maxFaceY, pos[i * 3 + 1]);
+    }
+  }
+}
+console.log(`Face normal threshold: ${THRESHOLD}  |  max face Y: ${maxFaceY.toFixed(5)}`);
+
+// Pass 2: flatten all face vertices to maxFaceY
+let count = 0;
+for (const mesh of doc.getRoot().listMeshes()) {
+  for (const prim of mesh.listPrimitives()) {
+    const posA  = prim.getAttribute('POSITION');
+    const normA = prim.getAttribute('NORMAL');
+    if (!posA || !normA) continue;
+    const pos   = posA.getArray();
+    const norms = normA.getArray();
+    for (let i = 0; i < pos.length / 3; i++) {
+      if (norms[i * 3 + 1] > THRESHOLD) { pos[i * 3 + 1] = maxFaceY; count++; }
+    }
+    posA.setArray(new Float32Array(pos));
+  }
+}
+console.log(`Flattened ${count.toLocaleString()} face vertices`);
+
+await io.write(OUTPUT, doc);
+console.log(`Saved → ${OUTPUT}`);