@taboo-avalanche/andesite-compiler 1.0.0

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@taboo-avalanche/andesite-compiler",
+  "version": "1.0.0",
+  "description": "Rasterize Andesite React pages to Bedrock chest UI zip",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/compile.d.ts",
+      "import": "./dist/compile.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "files": [
+      "dist"
+    ]
+  },
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "puppeteer": "^23.0.0",
+    "@taboo-avalanche/andesite": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.2",
+    "tsup": "^8.0.0"
+  },
+  "scripts": {
+    "build": "tsup"
+  }
+}

package/src/compile.ts

@@ -0,0 +1,142 @@
+import * as fs from 'fs'
+import * as path from 'path'
+import { createHash } from 'node:crypto'
+import archiver from 'archiver'
+import type { Browser } from 'puppeteer'
+import { rasterizeAll, rasterizeAllInBrowser } from './rasterize/puppeteer'
+import type { AndesiteMenuPageDefinition, AndesiteHudPageDefinition, AndesitePageDefinition } from '@taboo-avalanche/andesite'
+
+export { launchRasterBrowser } from './rasterize/puppeteer'
+
+export interface CompilePageOptions {
+  /** 传入则复用浏览器，多页 build-all 时显著提速 */
+  browser?: Browser
+  verbose?: boolean
+}
+
+/**
+ * 编译 React 页面为 andesite.zip。
+ * 先栅格化所有 APanel 和 AButton 产出 PNG，再从 DOM 读取 ALabel 声明信息，
+ * 最后组装 andesite.json 并打包成 zip。
+ *
+ * @param pageUrl Vite dev server 或静态构建产物的 URL。
+ * @param pageId 安山岩页面 id。
+ * @param outputZipPath 输出 zip 文件路径。
+ */
+export async function compilePage(
+  pageUrl: string,
+  pageId: string,
+  outputZipPath: string,
+  options?: CompilePageOptions,
+): Promise<void> {
+  const tempDir = path.join(path.dirname(outputZipPath), `.andesite-temp-${pageId.replace(/[^a-zA-Z0-9_-]/g, '_')}`)
+  fs.mkdirSync(tempDir, { recursive: true })
+  const rasterOpts = { verbose: options?.verbose }
+  const rasterResult = options?.browser
+    ? await rasterizeAllInBrowser(options.browser, pageUrl, tempDir, rasterOpts)
+    : await rasterizeAll(pageUrl, tempDir, rasterOpts)
+  // 从 DOM 读取 ALabel 信息由栅格化器在浏览器内收集，这里用 page.$$ 收集
+  // 但由于 rasterizeAll 关闭了浏览器，需要在栅格化阶段收集 label 信息
+  // 修正：让 rasterizeAll 同时返回 labels
+  const pageControls = {
+    viewStacks: rasterResult.viewStacks,
+    panels: rasterResult.panels.map(p => ({
+      id: p.id,
+      mountId: p.mountId,
+      texture: p.texturePath,
+      x: p.x,
+      y: p.y,
+      width: p.width,
+      height: p.height,
+       ...(p.overflow == null ? {} : { overflow: p.overflow }),
+       ...(p.defaultVisible == null ? {} : { defaultVisible: p.defaultVisible }),
+    })),
+    buttons: rasterResult.buttons.map(b => ({
+      id: b.id,
+      mountId: b.mountId,
+      defaultTexture: b.defaultTexturePath,
+      pressedTexture: b.pressedTexturePath,
+      x: b.x,
+      y: b.y,
+      width: b.width,
+      height: b.height,
+      pressDuration: b.pressDuration,
+      clickable: b.clickable,
+      ...(b.layer == null ? {} : { layer: b.layer }),
+       ...(b.defaultVisible == null ? {} : { defaultVisible: b.defaultVisible }),
+      labels: b.labels,
+      states: b.states,
+    })),
+    labels: rasterResult.labels,
+    inputs: rasterResult.inputs,
+  }
+  const definition: AndesitePageDefinition = rasterResult.kind === 'hud'
+    ? ({
+      id: pageId,
+      kind: 'hud',
+      width: rasterResult.width,
+      height: rasterResult.height,
+      mounts: rasterResult.mounts,
+      ...pageControls,
+      slots: [],
+      progresses: rasterResult.progresses,
+      sprites: rasterResult.sprites,
+      scrollViews: rasterResult.scrollViews,
+    } satisfies AndesiteHudPageDefinition)
+    : ({
+      id: pageId,
+      rows: 6,
+      // 页面整体尺寸与锚点：anchor=center 时运行时按屏幕把整体包围盒居中，解决左上锚定导致的偏移
+      width: rasterResult.width,
+      height: rasterResult.height,
+      anchor: 'center',
+      ...pageControls,
+      slots: rasterResult.slots,
+      progresses: rasterResult.progresses,
+      sprites: rasterResult.sprites,
+      scrollViews: rasterResult.scrollViews,
+    } satisfies AndesiteMenuPageDefinition)
+  // 只合并逐字节相同的 PNG，保留控件与帧索引；嵌套滚动区使用同一纹理映射。
+  const textures = new Map<string, string>()
+  const hashes = new Map<string, string>()
+  const pending: object[] = [definition]
+  const textureFields = new Set(['texture', 'defaultTexture', 'pressedTexture', 'backgroundTexture'])
+  while (pending.length) {
+    const item = pending.pop() as Record<string, unknown>
+    for (const [key, value] of Object.entries(item)) {
+      if (typeof value === 'string' && textureFields.has(key)) {
+        let canonical = textures.get(value)
+        if (!canonical) {
+          const bytes = fs.readFileSync(path.join(tempDir, value))
+          const digest = createHash('sha256').update(bytes).digest('hex')
+          canonical = hashes.get(digest) ?? value
+          hashes.set(digest, canonical)
+          textures.set(value, canonical)
+        }
+        item[key] = canonical
+      } else if (value && typeof value === 'object') {
+        pending.push(value)
+      }
+    }
+  }
+  const jsonPath = path.join(tempDir, 'andesite.json')
+  fs.writeFileSync(jsonPath, JSON.stringify(definition, null, 2))
+  await packZip(tempDir, outputZipPath, [...hashes.values()])
+  fs.rmSync(tempDir, { recursive: true, force: true })
+}
+
+async function packZip(sourceDir: string, outputZipPath: string, textures: string[]): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const output = fs.createWriteStream(outputZipPath)
+    const archive = archiver('zip', { zlib: { level: 6 } })
+    output.on('close', () => resolve())
+    output.on('error', reject)
+    archive.on('error', reject)
+    archive.pipe(output)
+    // 只打包清单引用的唯一纹理，不把临时目录内重复图片带进产物。
+    for (const name of ['andesite.json', ...textures]) {
+      archive.file(path.join(sourceDir, name), { name })
+    }
+    archive.finalize()
+  })
+}