@synopackageland/cli 0.7.0 → 0.7.2

package/dist/build-spk/dsm-icons.js

@@ -1,67 +1,146 @@
-import { deflateSync } from "node:zlib";
-import { chmodSync, mkdirSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-const ICON_SIZES = [16, 24, 32, 48, 64, 72, 256];
-const ICON_RGB = [0x1a, 0x73, 0xe8];
-function crc32(data) {
-    let crc = 0xffffffff;
-    for (const byte of data) {
-        crc ^= byte;
-        for (let i = 0; i < 8; i++) {
-            crc = (crc >>> 1) ^ (crc & 1 ? 0xedb88320 : 0);
-        }
+import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { decodePng, encodePng } from "./png.js";
+/** Sizes DSM loads for `images/app_{0}.png` (main menu, desktop, window, taskbar). */
+export const WINDOW_ICON_SIZES = [16, 24, 32, 48, 64, 72, 256];
+/** The package source drops a release whose PACKAGE_ICON is larger than this. */
+export const MAX_ICON_BYTES = 256 * 1024;
+const ICON_FILE = /^icon_(\d+)\.png$/;
+/** Ships next to dist/ and src/ alike: <package>/assets/default-icon. */
+export const DEFAULT_ICON_DIR = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "assets", "default-icon");
+function readPng(path, name) {
+    try {
+        return decodePng(readFileSync(path));
+    }
+    catch (error) {
+        throw new Error(`${name}：${error.message}`);
     }
-    return (crc ^ 0xffffffff) >>> 0;
-}
-function pngChunk(type, data) {
-    const length = Buffer.alloc(4);
-    length.writeUInt32BE(data.length);
-    const typeBuf = Buffer.from(type, "ascii");
-    const crc = Buffer.alloc(4);
-    crc.writeUInt32BE(crc32(Buffer.concat([typeBuf, data])));
-    return Buffer.concat([length, typeBuf, data, crc]);
 }
-function solidPng(size) {
-    const stride = size * 3 + 1;
-    const raw = Buffer.alloc(stride * size);
+/** Area-average downscale in premultiplied alpha, so transparent edges stay clean. */
+function scale(image, size) {
+    if (image.width === size && image.height === size)
+        return image;
+    const { width, height, rgba } = image;
+    const premultiplied = new Float64Array(width * height * 4);
+    for (let i = 0; i < width * height; i++) {
+        const alpha = rgba[i * 4 + 3] / 255;
+        for (let c = 0; c < 3; c++)
+            premultiplied[i * 4 + c] = rgba[i * 4 + c] * alpha;
+        premultiplied[i * 4 + 3] = rgba[i * 4 + 3];
+    }
+    const spans = (from) => Array.from({ length: size }, (_, d) => {
+        const start = (d * from) / size, end = ((d + 1) * from) / size;
+        const weights = [];
+        for (let s = Math.floor(start); s < end; s++)
+            weights.push([s, Math.min(end, s + 1) - Math.max(start, s)]);
+        return weights.map(([s, w]) => [s, w / (end - start)]);
+    });
+    const columns = spans(width), rows = spans(height);
+    const across = new Float64Array(size * height * 4);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < size; x++) {
+            for (const [s, w] of columns[x]) {
+                for (let c = 0; c < 4; c++)
+                    across[(y * size + x) * 4 + c] += premultiplied[(y * width + s) * 4 + c] * w;
+            }
+        }
+    }
+    const out = Buffer.alloc(size * size * 4);
     for (let y = 0; y < size; y++) {
-        const row = y * stride;
-        raw[row] = 0;
         for (let x = 0; x < size; x++) {
-            const i = row + 1 + x * 3;
-            raw[i] = ICON_RGB[0];
-            raw[i + 1] = ICON_RGB[1];
-            raw[i + 2] = ICON_RGB[2];
+            const pixel = [0, 0, 0, 0];
+            for (const [s, w] of rows[y])
+                for (let c = 0; c < 4; c++)
+                    pixel[c] += across[(s * size + x) * 4 + c] * w;
+            const alpha = Math.round(pixel[3]);
+            const at = (y * size + x) * 4;
+            for (let c = 0; c < 3; c++)
+                out[at + c] = alpha ? Math.min(255, Math.round((pixel[c] * 255) / pixel[3])) : 0;
+            out[at + 3] = alpha;
         }
     }
-    const ihdr = Buffer.alloc(13);
-    ihdr.writeUInt32BE(size, 0);
-    ihdr.writeUInt32BE(size, 4);
-    ihdr[8] = 8;
-    ihdr[9] = 2;
-    return Buffer.concat([
-        Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]),
-        pngChunk("IHDR", ihdr),
-        pngChunk("IDAT", deflateSync(raw, { level: 9 })),
-        pngChunk("IEND", Buffer.alloc(0)),
-    ]);
+    return { width: size, height: size, rgba: out };
 }
-export function writeDsmWindowIcons(uiDir) {
-    const imagesDir = join(uiDir, "images");
-    mkdirSync(imagesDir, { recursive: true });
-    for (const size of ICON_SIZES) {
-        const path = join(imagesDir, `app_${size}.png`);
-        writeFileSync(path, solidPng(size));
-        chmodSync(path, 0o644);
+function isSolid(image) {
+    const first = image.rgba.readUInt32BE(0);
+    for (let i = 4; i < image.rgba.length; i += 4)
+        if (image.rgba.readUInt32BE(i) !== first)
+            return false;
+    return true;
+}
+/** `icon_<size>.png` drawn per size; icon_256.png is required and scaled for the rest. */
+function readIconDirectory(dir) {
+    const drawn = new Map();
+    for (const name of readdirSync(dir).sort()) {
+        const match = ICON_FILE.exec(name);
+        if (!match)
+            continue;
+        const size = Number(match[1]);
+        if (!WINDOW_ICON_SIZES.includes(size)) {
+            throw new Error(`${name}：不支援的尺寸；只接受 ${WINDOW_ICON_SIZES.map((s) => `icon_${s}.png`).join("、")}。`);
+        }
+        const image = readPng(join(dir, name), name);
+        if (image.width !== size || image.height !== size) {
+            throw new Error(`${name}：尺寸是 ${image.width}×${image.height}，應為 ${size}×${size}。`);
+        }
+        drawn.set(size, image);
     }
+    if (!drawn.has(256))
+        throw new Error(`圖示目錄 ${basename(dir)}/ 缺少 icon_256.png（256×256 PNG，其他尺寸可省略，由它縮小產生）。`);
+    return drawn;
 }
-export function writePackageCenterIcons(spkRoot) {
-    for (const [name, size] of [
-        ["PACKAGE_ICON.PNG", 64],
-        ["PACKAGE_ICON_256.PNG", 256],
-    ]) {
-        const path = join(spkRoot, name);
-        writeFileSync(path, solidPng(size));
-        chmodSync(path, 0o644);
+function readIconFile(path) {
+    const image = readPng(path, basename(path));
+    if (image.width !== image.height)
+        throw new Error(`${basename(path)}：尺寸 ${image.width}×${image.height} 不是正方形。`);
+    if (image.width < 256)
+        throw new Error(`${basename(path)}：尺寸 ${image.width}×${image.height}，至少 256×256。`);
+    return new Map([[256, scale(image, 256)]]);
+}
+function render(drawn, source) {
+    const big = drawn.get(256);
+    const window = new Map();
+    for (const size of WINDOW_ICON_SIZES) {
+        const png = encodePng(size, size, scale(drawn.get(size) ?? big, size).rgba);
+        if (png.length > MAX_ICON_BYTES) {
+            throw new Error(`${size}×${size} 圖示編碼後 ${png.length} bytes，超過 package source 的 256 KiB 上限；請減少雜訊或細節。`);
+        }
+        window.set(size, png);
     }
+    return { source, window, packageIcon: window.get(64), packageIcon256: window.get(256), solid: isSolid(big) };
+}
+/** A project icon: one square PNG of at least 256 px, or a directory of icon_<size>.png. */
+export function renderPackageIcons(path) {
+    if (!existsSync(path))
+        throw new Error(`找不到圖示 ${basename(path)}。`);
+    return render(statSync(path).isDirectory() ? readIconDirectory(path) : readIconFile(path), "custom");
+}
+let defaults;
+/** The SDK default icon, for projects that set no `icon`. */
+export function defaultPackageIcons() {
+    defaults ??= render(readIconDirectory(DEFAULT_ICON_DIR), "default");
+    return defaults;
+}
+/** The project's icon when it sets one, otherwise the SDK default. */
+export function packageIcons(icon) {
+    return icon ? renderPackageIcons(icon) : defaultPackageIcons();
+}
+export function iconReport(root, icon) {
+    const icons = packageIcons(icon);
+    return { source: icons.source, ...(icon ? { path: relative(root, icon) } : {}), solid: icons.solid };
+}
+function writeIcon(path, png) {
+    writeFileSync(path, png);
+    chmodSync(path, 0o644);
+}
+export function writeDsmWindowIcons(uiDir, icons) {
+    const imagesDir = join(uiDir, "images");
+    mkdirSync(imagesDir, { recursive: true });
+    for (const [size, png] of icons.window)
+        writeIcon(join(imagesDir, `app_${size}.png`), png);
+}
+export function writePackageCenterIcons(spkRoot, icons) {
+    writeIcon(join(spkRoot, "PACKAGE_ICON.PNG"), icons.packageIcon);
+    writeIcon(join(spkRoot, "PACKAGE_ICON_256.PNG"), icons.packageIcon256);
 }

package/dist/build-spk/dsm-platforms.json

@@ -7,9 +7,11 @@
             "broadwell",
             "broadwellnk",
             "broadwellnkv2",
+            "broadwellntb",
             "broadwellntbap",
             "bromolow",
             "cedarview",
+            "coffeelake",
             "denverton",
             "epyc7002",
             "epyc7003",
@@ -23,13 +25,14 @@
             "purley",
             "r1000",
             "r1000nk",
+            "skylaked",
             "v1000",
             "v1000nk"
         ],
         "platformOnly": []
     },
     "aarch64": {
-        "members": ["armada37xx", "rtd1296", "rtd1619b"],
+        "members": ["armada37xx", "rtd1296", "rtd1619", "rtd1619b"],
         "platformOnly": []
     },
     "armv7": {

package/dist/build-spk/gateway.d.ts

@@ -1,6 +1,6 @@
 import { type CommandRunner } from "../standalone/build.js";
 import type { AppContract } from "../types.js";
-import { type NativeArchFamily } from "./dsm-arch.js";
+import type { NativeArchFamily } from "./dsm-arch.js";
 export { gatewayEntryPath } from "../contract/web-launch.js";
 /** Where the gateway CGI sits in the package payload; DSM serves `ui/` under /webman/3rdparty/<package>/. */
 export declare const GATEWAY_CGI_PAYLOAD = "ui/cgi/gateway.cgi";

package/dist/build-spk/gateway.js

@@ -4,7 +4,7 @@ import { checkCgiBinary } from "../standalone/binary.js";
 import { runCommand } from "../standalone/build.js";
 import { resolvedWebAccess } from "../contract/web-launch.js";
 import { templatesRoot } from "../template-paths.js";
-import { goBuildEnv } from "./dsm-arch.js";
+import { PINNED_GO_HINT, pinnedGoBuildEnv, pinnedGoProblem } from "./go-toolchain.js";
 export { gatewayEntryPath } from "../contract/web-launch.js";
 /** Where the gateway CGI sits in the package payload; DSM serves `ui/` under /webman/3rdparty/<package>/. */
 export const GATEWAY_CGI_PAYLOAD = "ui/cgi/gateway.cgi";
@@ -29,18 +29,22 @@ export function buildGatewayBinary(input) {
     const ldflags = ["-s", "-w", "-buildid=", `-X main.packageID=${input.packageId}`, `-X 'main.configJSON=${JSON.stringify(input.config)}'`].join(" ");
     const result = (input.run ?? runCommand)("go", ["build", "-trimpath", "-buildvcs=false", "-ldflags", ldflags, "-o", out, "."], {
         cwd: join(templatesRoot(), "_gateway"),
-        env: { ...process.env, ...goBuildEnv(input.arch) },
+        env: { ...process.env, ...pinnedGoBuildEnv(input.arch) },
     });
     if (result.missing) {
-        return { error: "GATEWAY_GO_MISSING", detail: "找不到 go 指令。DSM 驗證閘道需要 Go 1.24 以上版本（https://go.dev/dl/）才能建置。" };
+        return { error: "GATEWAY_GO_MISSING", detail: `找不到 go 指令。DSM 驗證閘道需要 Go 1.21 以上版本（https://go.dev/dl/）才能建置。${PINNED_GO_HINT}` };
     }
     if (result.status !== 0) {
-        return { error: "GATEWAY_BUILD_FAILED", detail: `go build（${input.arch}）失敗。\n${result.stderr}` };
+        return { error: "GATEWAY_BUILD_FAILED", detail: `go build（${input.arch}）失敗。${PINNED_GO_HINT}\n${result.stderr}` };
     }
     const problem = checkCgiBinary(input.work, out, input.arch);
     if (problem) {
         return { error: "GATEWAY_BUILD_FAILED", detail: problem.message };
     }
+    const toolchainProblem = pinnedGoProblem(out);
+    if (toolchainProblem) {
+        return { error: "GATEWAY_BUILD_FAILED", detail: toolchainProblem };
+    }
     return { binary: out };
 }
 /** Puts the CGI (mode 0755) and its readable configuration into the package payload. */

package/dist/build-spk/generator.js

@@ -11,7 +11,8 @@ import { buildGatewayBinary, gatewayConfig, writeGatewayPayload } from "./gatewa
 import { classifyComposeRoute, loadCompose } from "../compose/analyze.js";
 import { scanComposePrivilege } from "../compose/privilege.js";
 import { validateProject } from "../validate.js";
-import { writeDsmWindowIcons, writePackageCenterIcons } from "./dsm-icons.js";
+import { packageIcons, writeDsmWindowIcons, writePackageCenterIcons } from "./dsm-icons.js";
+import { contractIconPath } from "../contract/icon.js";
 import { infoArchValue, isContainerArchFamily } from "./dsm-arch.js";
 import { assertContainerMinDsm, assertPortalMinDsm, resolveMinDsm } from "./dsm-version.js";
 import { createReproducibleTar } from "./reproducible-archive.js";
@@ -22,6 +23,9 @@ import { renderInstallWizardFiles } from "./install-wizard.js";
 import { contractPortal, PORTAL_JSON_RELPATH, PORTAL_MUSTACHE_RELPATH, renderPortalJson, renderPortalLifecycle, renderPortalMustache, renderPortalWizardStep } from "../portal/package.js";
 import { renderWizardFiles, writeWizardUiFiles } from "./wizard-i18n.js";
 import { sharedFolderCombobox } from "./share-combobox.js";
+import { writeUiTexts } from "./ui-texts.js";
+import { DSM_LANGS, LOCALES } from "../standalone/i18n.js";
+import { contractAppTitle } from "../contract/i18n.js";
 import { renderHeadlessResourceMarker, renderResourceConfig, renderResourceWorkerStartStopStatus, } from "./resource-worker.js";
 const FILE_MODE = 0o644;
 const SCRIPT_MODE = 0o755;
@@ -89,6 +93,7 @@ export async function buildSpk(options) {
     const isDynamicRoute = route?.route === "dynamic";
     const isResourceWorkerRoute = route?.route === "static-zero-config" ||
         isDynamicRoute;
+    const icons = packageIcons(contractIconPath(contract, options.project.root));
     const staging = mkdtempSync(join(tmpdir(), "syno-spk-"));
     const gatewayWork = mkdtempSync(join(tmpdir(), "syno-gateway-"));
     try {
@@ -108,7 +113,7 @@ export async function buildSpk(options) {
             gatewayBinary = built.binary;
         }
         writeFileSync(join(staging, "INFO"), renderInfo(contract, options.archFamily, isResourceWorkerRoute), "utf8");
-        writePackageCenterIcons(staging);
+        writePackageCenterIcons(staging, icons);
         mkdirSync(join(staging, "conf"), { recursive: true });
         writeFileSync(join(staging, "conf", "privilege"), renderPrivilege(), "utf8");
         writeFileSync(join(staging, "privilege"), renderPrivilege(), "utf8");
@@ -177,7 +182,8 @@ export async function buildSpk(options) {
             const uiDir = join(staging, "package", "ui");
             mkdirSync(uiDir, { recursive: true });
             writeFileSync(join(uiDir, "config"), renderDsmWindowConfig(contract), "utf8");
-            writeDsmWindowIcons(uiDir);
+            writeDsmWindowIcons(uiDir, icons);
+            writeUiTexts(uiDir, contractAppTitle(contract));
         }
         const portal = contractPortal(contract);
         if (portal) {
@@ -223,6 +229,14 @@ function renderInfo(contract, archFamily, isResourceWorker = false) {
     add("displayname", String(contract.displayname));
     add("description", String(contract.description));
     add("maintainer", String(contract.maintainer));
+    const info = contractAppTitle(contract).info;
+    for (const locale of LOCALES) {
+        const text = info?.[locale];
+        if (text?.displayname)
+            add(`displayname_${DSM_LANGS[locale]}`, text.displayname);
+        if (text?.description)
+            add(`description_${DSM_LANGS[locale]}`, text.description);
+    }
     for (const [key, value] of metadataInfoFields(contract.metadata))
         add(key, value);
     add("arch", archFamily === undefined ? "noarch" : infoArchValue(archFamily));

package/dist/build-spk/go-toolchain.d.ts

@@ -0,0 +1,20 @@
+import { type NativeArchFamily } from "./dsm-arch.js";
+/**
+ * The Go release that compiles every binary the CLI ships from its own
+ * templates, so their digests do not depend on the builder's Go. Each
+ * template go.mod names it in its `toolchain` line.
+ */
+export declare const PINNED_GO_TOOLCHAIN = "go1.26.9";
+/**
+ * The `go build` environment for a binary the CLI ships from its own templates
+ * (executor, lifecycle helper, daemon controller, gateway). GOTOOLCHAIN names
+ * the exact release, overriding `local` or `auto`: Go 1.21+ runs it from PATH
+ * or the module cache, or downloads it, and fails when it cannot.
+ */
+export declare function pinnedGoBuildEnv(family: NativeArchFamily): Record<string, string>;
+/** The Go release recorded in a binary's build info (Go 1.18+ layout), or undefined. */
+export declare function goBinaryVersion(file: string): string | undefined;
+/** Why a CLI-owned binary cannot ship: it was not built by the pinned Go release. */
+export declare function pinnedGoProblem(file: string): string | undefined;
+/** Appended to a failed CLI-owned `go build`: what the build needs. */
+export declare const PINNED_GO_HINT = "These binaries need go1.26.9: Go 1.21 or later downloads it automatically; offline, install go1.26.9 on PATH or allow GOPROXY to serve golang.org/toolchain.";

package/dist/build-spk/go-toolchain.js

@@ -0,0 +1,44 @@
+import { readFileSync } from "node:fs";
+import { goBuildEnv } from "./dsm-arch.js";
+/**
+ * The Go release that compiles every binary the CLI ships from its own
+ * templates, so their digests do not depend on the builder's Go. Each
+ * template go.mod names it in its `toolchain` line.
+ */
+export const PINNED_GO_TOOLCHAIN = "go1.26.9";
+/**
+ * The `go build` environment for a binary the CLI ships from its own templates
+ * (executor, lifecycle helper, daemon controller, gateway). GOTOOLCHAIN names
+ * the exact release, overriding `local` or `auto`: Go 1.21+ runs it from PATH
+ * or the module cache, or downloads it, and fails when it cannot.
+ */
+export function pinnedGoBuildEnv(family) {
+    return { ...goBuildEnv(family), GOTOOLCHAIN: PINNED_GO_TOOLCHAIN, GOFLAGS: "", GOEXPERIMENT: "", GOWORK: "off", GOAMD64: "v1", GOARM64: "v8.0" };
+}
+const BUILD_INFO_MAGIC = Buffer.from("\xff Go buildinf:", "latin1");
+const BUILD_INFO_INLINE_STRINGS = 0x2;
+/** The Go release recorded in a binary's build info (Go 1.18+ layout), or undefined. */
+export function goBinaryVersion(file) {
+    const bytes = readFileSync(file);
+    const start = bytes.indexOf(BUILD_INFO_MAGIC);
+    if (start < 0 || !(bytes[start + 15] & BUILD_INFO_INLINE_STRINGS))
+        return undefined;
+    let length = 0, shift = 0, at = start + 32;
+    for (;;) {
+        const byte = bytes[at++];
+        if (byte === undefined || shift > 28)
+            return undefined;
+        length |= (byte & 0x7f) << shift;
+        shift += 7;
+        if (byte < 0x80)
+            break;
+    }
+    return bytes.subarray(at, at + length).toString("latin1") || undefined;
+}
+/** Why a CLI-owned binary cannot ship: it was not built by the pinned Go release. */
+export function pinnedGoProblem(file) {
+    const version = goBinaryVersion(file);
+    return version === PINNED_GO_TOOLCHAIN ? undefined : `${file} was built by ${version ?? "an unknown Go release"}, not ${PINNED_GO_TOOLCHAIN}.`;
+}
+/** Appended to a failed CLI-owned `go build`: what the build needs. */
+export const PINNED_GO_HINT = `These binaries need ${PINNED_GO_TOOLCHAIN}: Go 1.21 or later downloads it automatically; offline, install ${PINNED_GO_TOOLCHAIN} on PATH or allow GOPROXY to serve golang.org/toolchain.`;

package/dist/build-spk/png.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Just enough PNG for package icons, without an image dependency: decode any
+ * non-interlaced PNG to 8-bit RGBA, and encode 8-bit RGBA deterministically
+ * with only the critical chunks.
+ */
+export interface RgbaImage {
+    width: number;
+    height: number;
+    /** Row-major, straight (not premultiplied) alpha. */
+    rgba: Buffer;
+}
+export declare function decodePng(bytes: Buffer): RgbaImage;
+/** 8-bit RGBA, adaptive per-row filters, no ancillary chunks: same pixels, same bytes. */
+export declare function encodePng(width: number, height: number, rgba: Buffer): Buffer;

package/dist/build-spk/png.js

@@ -0,0 +1,161 @@
+import { crc32, deflateSync, inflateSync } from "node:zlib";
+const SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
+const MAX_SIDE = 4096;
+const CHANNELS = { 0: 1, 2: 3, 3: 1, 4: 2, 6: 4 };
+const DEPTHS = { 0: [1, 2, 4, 8, 16], 2: [8, 16], 3: [1, 2, 4, 8], 4: [8, 16], 6: [8, 16] };
+function corrupt(why) {
+    throw new Error(`PNG 損壞：${why}`);
+}
+function chunk(type, data) {
+    const head = Buffer.alloc(8);
+    head.writeUInt32BE(data.length);
+    head.write(type, 4, "ascii");
+    const crc = Buffer.alloc(4);
+    crc.writeUInt32BE(crc32(data, crc32(head.subarray(4))));
+    return Buffer.concat([head, data, crc]);
+}
+function paeth(a, b, c) {
+    const p = a + b - c;
+    const pa = Math.abs(p - a), pb = Math.abs(p - b), pc = Math.abs(p - c);
+    return pa <= pb && pa <= pc ? a : pb <= pc ? b : c;
+}
+export function decodePng(bytes) {
+    if (bytes.length < 8 || !bytes.subarray(0, 8).equals(SIGNATURE))
+        throw new Error("不是 PNG 檔（檔頭簽章不符）。");
+    let offset = 8;
+    let header;
+    let palette, alpha, ended = false;
+    const data = [];
+    while (!ended) {
+        if (offset + 12 > bytes.length)
+            corrupt("檔案被截斷");
+        const length = bytes.readUInt32BE(offset);
+        const type = bytes.toString("latin1", offset + 4, offset + 8);
+        const end = offset + 12 + length;
+        if (end > bytes.length)
+            corrupt("檔案被截斷");
+        const body = bytes.subarray(offset + 8, offset + 8 + length);
+        if (crc32(body, crc32(bytes.subarray(offset + 4, offset + 8))) !== bytes.readUInt32BE(end - 4))
+            corrupt(`${type} CRC 不符`);
+        if (!header && type !== "IHDR")
+            corrupt("第一個 chunk 必須是 IHDR");
+        if (type === "IHDR") {
+            if (header || length !== 13)
+                corrupt("IHDR 無效");
+            header = { width: body.readUInt32BE(0), height: body.readUInt32BE(4), depth: body[8], type: body[9] };
+            if (!DEPTHS[header.type]?.includes(header.depth) || body[10] !== 0 || body[11] !== 0)
+                corrupt("不支援的色彩型態或位元深度");
+            if (body[12] !== 0)
+                throw new Error("不支援交錯（interlaced）PNG；請另存為非交錯 PNG。");
+            if (header.width < 1 || header.height < 1 || header.width > MAX_SIDE || header.height > MAX_SIDE) {
+                throw new Error(`PNG 尺寸 ${header.width}×${header.height} 超出範圍（每邊 1–${MAX_SIDE} px）。`);
+            }
+        }
+        else if (type === "PLTE")
+            palette = body;
+        else if (type === "tRNS")
+            alpha = body;
+        else if (type === "IDAT")
+            data.push(body);
+        else if (type === "IEND")
+            ended = true;
+        offset = end;
+    }
+    if (!header || !data.length)
+        corrupt("缺少影像資料");
+    const { width, height, depth, type } = header;
+    if (type === 3 && (!palette || palette.length % 3 !== 0))
+        corrupt("調色盤影像缺少 PLTE");
+    const bits = CHANNELS[type] * depth;
+    const bpp = Math.max(1, bits >> 3);
+    const stride = Math.ceil((width * bits) / 8);
+    let raw;
+    try {
+        raw = inflateSync(Buffer.concat(data), { maxOutputLength: (stride + 1) * height + 1 });
+    }
+    catch {
+        corrupt("影像資料無法解壓縮");
+    }
+    if (raw.length !== (stride + 1) * height)
+        corrupt("影像資料長度不符");
+    const prev = Buffer.alloc(stride), line = Buffer.alloc(stride);
+    const rgba = Buffer.alloc(width * height * 4);
+    const sample = (x, channel) => {
+        if (depth === 16)
+            return line[(x * CHANNELS[type] + channel) * 2];
+        if (depth === 8)
+            return line[x * CHANNELS[type] + channel];
+        const bit = x * depth;
+        return (line[bit >> 3] >> (8 - depth - (bit & 7))) & ((1 << depth) - 1);
+    };
+    const scale = depth < 8 ? 255 / ((1 << depth) - 1) : 1;
+    for (let y = 0; y < height; y++) {
+        const row = raw.subarray(y * (stride + 1) + 1, (y + 1) * (stride + 1));
+        const filter = raw[y * (stride + 1)];
+        for (let i = 0; i < stride; i++) {
+            const a = i >= bpp ? line[i - bpp] : 0, b = prev[i], c = i >= bpp ? prev[i - bpp] : 0;
+            const predictor = filter === 0 ? 0 : filter === 1 ? a : filter === 2 ? b : filter === 3 ? (a + b) >> 1 : filter === 4 ? paeth(a, b, c) : corrupt("未知的列濾波");
+            line[i] = (row[i] + predictor) & 0xff;
+        }
+        for (let x = 0; x < width; x++) {
+            const out = (y * width + x) * 4;
+            if (type === 3) {
+                const index = sample(x, 0);
+                if (index * 3 + 2 >= palette.length)
+                    corrupt("調色盤索引超出範圍");
+                palette.copy(rgba, out, index * 3, index * 3 + 3);
+                rgba[out + 3] = alpha && index < alpha.length ? alpha[index] : 255;
+            }
+            else if (type === 0 || type === 4) {
+                const grey = Math.round(sample(x, 0) * scale);
+                rgba.fill(grey, out, out + 3);
+                rgba[out + 3] = type === 4 ? sample(x, 1) : 255;
+            }
+            else {
+                for (let channel = 0; channel < 3; channel++)
+                    rgba[out + channel] = sample(x, channel);
+                rgba[out + 3] = type === 6 ? sample(x, 3) : 255;
+            }
+        }
+        line.copy(prev);
+    }
+    return { width, height, rgba };
+}
+/** 8-bit RGBA, adaptive per-row filters, no ancillary chunks: same pixels, same bytes. */
+export function encodePng(width, height, rgba) {
+    const stride = width * 4;
+    const out = Buffer.alloc((stride + 1) * height);
+    const zero = Buffer.alloc(stride);
+    const candidate = Buffer.alloc(stride);
+    for (let y = 0; y < height; y++) {
+        const line = rgba.subarray(y * stride, (y + 1) * stride);
+        const prev = y ? rgba.subarray((y - 1) * stride, y * stride) : zero;
+        let bestScore = Infinity;
+        for (let filter = 0; filter <= 4; filter++) {
+            let score = 0;
+            for (let i = 0; i < stride; i++) {
+                const a = i >= 4 ? line[i - 4] : 0, b = prev[i], c = i >= 4 ? prev[i - 4] : 0;
+                const predictor = filter === 0 ? 0 : filter === 1 ? a : filter === 2 ? b : filter === 3 ? (a + b) >> 1 : paeth(a, b, c);
+                const value = (line[i] - predictor) & 0xff;
+                candidate[i] = value;
+                score += value < 128 ? value : 256 - value;
+            }
+            if (score < bestScore) {
+                bestScore = score;
+                out[y * (stride + 1)] = filter;
+                candidate.copy(out, y * (stride + 1) + 1);
+            }
+        }
+    }
+    const ihdr = Buffer.alloc(13);
+    ihdr.writeUInt32BE(width, 0);
+    ihdr.writeUInt32BE(height, 4);
+    ihdr[8] = 8;
+    ihdr[9] = 6;
+    return Buffer.concat([
+        SIGNATURE,
+        chunk("IHDR", ihdr),
+        chunk("IDAT", deflateSync(out, { level: 9 })),
+        chunk("IEND", Buffer.alloc(0)),
+    ]);
+}

package/dist/build-spk/ui-texts.d.ts

@@ -0,0 +1,20 @@
+import { type InfoTranslations } from "../standalone/i18n.js";
+/** The English INFO text and its translations, which also name the app in DSM. */
+export interface AppTitle {
+    displayname: string;
+    description: string;
+    info?: InfoTranslations;
+}
+/**
+ * `ui/config` title fields. With translations they are `section:key`
+ * references DSM resolves from `ui/texts/<lang>/strings` for the main menu
+ * and the window title; without, the literal English text as before.
+ */
+export declare function uiTitleFields(app: AppTitle): {
+    title: string;
+    desc: string;
+    preloadTexts?: string[];
+};
+/** `ui/texts/<dsm lang>/strings` for English and every translated language; none without translations. */
+export declare function renderUiTexts(app: AppTitle): Map<string, string>;
+export declare function writeUiTexts(uiRoot: string, app: AppTitle): void;

package/dist/build-spk/ui-texts.js

@@ -0,0 +1,42 @@
+import { chmodSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { DSM_LANGS, LOCALES } from "../standalone/i18n.js";
+const SECTION = "synopkgland";
+const TITLE = `${SECTION}:app_title`;
+const DESC = `${SECTION}:app_desc`;
+function translated(app) {
+    return Object.values(app.info ?? {}).some((text) => text?.displayname || text?.description);
+}
+/**
+ * `ui/config` title fields. With translations they are `section:key`
+ * references DSM resolves from `ui/texts/<lang>/strings` for the main menu
+ * and the window title; without, the literal English text as before.
+ */
+export function uiTitleFields(app) {
+    return translated(app)
+        ? { title: TITLE, desc: DESC, preloadTexts: [TITLE, DESC] }
+        : { title: app.displayname, desc: app.description };
+}
+/** `ui/texts/<dsm lang>/strings` for English and every translated language; none without translations. */
+export function renderUiTexts(app) {
+    const files = new Map();
+    if (!translated(app))
+        return files;
+    for (const locale of LOCALES) {
+        const text = locale === "en" ? undefined : app.info?.[locale];
+        if (locale !== "en" && !text)
+            continue;
+        const title = text?.displayname ?? app.displayname;
+        const desc = text?.description ?? app.description;
+        files.set(DSM_LANGS[locale], `[${SECTION}]\napp_title="${title}"\napp_desc="${desc}"\n`);
+    }
+    return files;
+}
+export function writeUiTexts(uiRoot, app) {
+    for (const [lang, strings] of renderUiTexts(app)) {
+        mkdirSync(join(uiRoot, "texts", lang), { recursive: true });
+        const path = join(uiRoot, "texts", lang, "strings");
+        writeFileSync(path, strings, "utf8");
+        chmodSync(path, 0o644);
+    }
+}