@brookesia/pipeline 0.1.0

package/dist/steps/bundle-js.js

@@ -0,0 +1,49 @@
+import { loadManifestFromDir, logStep } from '@brookesia/shared-utils';
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'node:path';
+import { assertBundlePaths, bundlerCliArgs, resolveBundlerBin, writeDefaultBundleConfig, } from '../bundle-config.js';
+export async function runBundleJs(ctx) {
+    const bundle = ctx.config.js?.bundle;
+    if (!bundle) {
+        return;
+    }
+    const manifest = loadManifestFromDir(ctx.sourceRoot);
+    const outputRel = bundle.output ?? manifest.runtime.entry;
+    assertBundlePaths(bundle.entry, outputRel);
+    const entryAbs = path.join(ctx.sourceRoot, bundle.entry);
+    if (!fs.existsSync(entryAbs)) {
+        throw new Error(`bundle-js: entry not found: ${bundle.entry} (expected at ${entryAbs})`);
+    }
+    const outputAbs = path.join(ctx.sourceRoot, outputRel);
+    await fs.ensureDir(path.dirname(outputAbs));
+    let configPath;
+    if (bundle.configFile) {
+        configPath = path.join(ctx.projectRoot, bundle.configFile);
+        if (!fs.existsSync(configPath)) {
+            throw new Error(`bundle-js: configFile not found: ${bundle.configFile}`);
+        }
+    }
+    else {
+        configPath = await writeDefaultBundleConfig({
+            projectRoot: ctx.projectRoot,
+            tool: bundle.tool,
+            mode: ctx.mode,
+            entryAbs,
+            outputDirAbs: path.dirname(outputAbs),
+            outputFilename: path.basename(outputRel),
+        });
+    }
+    const bin = resolveBundlerBin(ctx.projectRoot, bundle.tool);
+    const args = bundlerCliArgs(bundle.tool, configPath, bundle.args);
+    logStep(`bundle-js (${bundle.tool}): ${bundle.entry} → ${outputRel}`);
+    await execa(bin, args, {
+        cwd: ctx.projectRoot,
+        stdio: 'inherit',
+        env: { ...process.env, NODE_ENV: ctx.mode },
+    });
+    if (!fs.existsSync(outputAbs)) {
+        throw new Error(`bundle-js: output missing: ${outputRel} (expected at ${outputAbs})`);
+    }
+}
+//# sourceMappingURL=bundle-js.js.map

package/dist/steps/bundle-js.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-js.js","sourceRoot":"","sources":["../../src/steps/bundle-js.ts"],"names":[],"mappings":"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"}

package/dist/steps/compile-wasm.d.ts

@@ -0,0 +1,3 @@
+import type { PipelineContext } from '../context.js';
+export declare function runCompileWasm(ctx: PipelineContext): Promise<void>;
+//# sourceMappingURL=compile-wasm.d.ts.map

package/dist/steps/compile-wasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-wasm.d.ts","sourceRoot":"","sources":["../../src/steps/compile-wasm.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,wBAAsB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCxE"}

package/dist/steps/compile-wasm.js

@@ -0,0 +1,37 @@
+import { loadManifestFromDir, logStep, wasiClangPath, } from '@brookesia/shared-utils';
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'node:path';
+export async function runCompileWasm(ctx) {
+    const wasm = ctx.config.wasm;
+    if (!wasm?.sources?.length) {
+        return;
+    }
+    const packageRoot = ctx.config.pack?.skipBuildMirror ? ctx.sourceRoot : ctx.buildDir;
+    await fs.ensureDir(packageRoot);
+    const manifest = loadManifestFromDir(ctx.sourceRoot);
+    const outputRel = wasm.output ?? manifest.runtime.entry;
+    const outputPath = path.join(packageRoot, outputRel);
+    await fs.ensureDir(path.dirname(outputPath));
+    const clang = wasiClangPath(ctx.config);
+    const sourcePaths = wasm.sources.map((rel) => {
+        const p = path.join(packageRoot, rel);
+        if (!fs.existsSync(p)) {
+            throw new Error(`wasm source not found: ${rel} (expected at ${p})`);
+        }
+        return p;
+    });
+    const args = [
+        '--target=wasm32-wasip1',
+        ...sourcePaths,
+        '-o',
+        outputPath,
+        ...(wasm.clangArgs ?? []),
+    ];
+    logStep(`compile-wasm: ${wasm.sources.join(', ')} → ${outputRel}`);
+    await execa(clang, args, { stdio: 'inherit' });
+    if (!fs.existsSync(outputPath)) {
+        throw new Error(`compile-wasm: output missing: ${outputPath}`);
+    }
+}
+//# sourceMappingURL=compile-wasm.js.map

package/dist/steps/compile-wasm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-wasm.js","sourceRoot":"","sources":["../../src/steps/compile-wasm.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,OAAO,EACP,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAoB;IACvD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrF,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAEhC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG;QACX,wBAAwB;QACxB,GAAG,WAAW;QACd,IAAI;QACJ,UAAU;QACV,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;KAC1B,CAAC;IAEF,OAAO,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC;IACnE,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAE/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,iCAAiC,UAAU,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/steps/compile-wasm.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compile-wasm.test.d.ts.map

package/dist/steps/compile-wasm.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-wasm.test.d.ts","sourceRoot":"","sources":["../../src/steps/compile-wasm.test.ts"],"names":[],"mappings":""}

package/dist/steps/compile-wasm.test.js

@@ -0,0 +1,33 @@
+import fs from 'fs-extra';
+import os from 'node:os';
+import path from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { runPipeline } from '../lane.js';
+describe('wasm pipeline', () => {
+    it('rejects native C/C++ to Wasm compilation config', async () => {
+        const projectRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'brookesia-wasm-'));
+        const sourceRoot = path.join(projectRoot, 'src');
+        await fs.ensureDir(path.join(sourceRoot, 'native'));
+        await fs.writeJson(path.join(sourceRoot, 'manifest.json'), {
+            package: {
+                id: 'com.example.wasm',
+                version: '1.0.0',
+            },
+            runtime: {
+                type: 'Wasm',
+                entry: 'app/main.wasm',
+            },
+        });
+        await fs.writeFile(path.join(sourceRoot, 'native', 'main.c'), 'int main(void) { return 0; }\n');
+        await expect(runPipeline({
+            projectRoot,
+            sourceRoot,
+            buildDir: path.join(projectRoot, 'build'),
+            distDir: path.join(projectRoot, 'dist'),
+            signDir: path.join(projectRoot, 'sign'),
+            config: { wasm: { sources: ['native/main.c'] } },
+            mode: 'development',
+        })).rejects.toThrow('wasm.sources is no longer supported');
+    });
+});
+//# sourceMappingURL=compile-wasm.test.js.map

package/dist/steps/compile-wasm.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-wasm.test.js","sourceRoot":"","sources":["../../src/steps/compile-wasm.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAChF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QACpD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,EAAE;YACzD,OAAO,EAAE;gBACP,EAAE,EAAE,kBAAkB;gBACtB,OAAO,EAAE,OAAO;aACjB;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,eAAe;aACvB;SACF,CAAC,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,gCAAgC,CAAC,CAAC;QAEhG,MAAM,MAAM,CAAC,WAAW,CAAC;YACvB,WAAW;YACX,UAAU;YACV,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;YACzC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;YACvC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;YACvC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,EAAS;YACvD,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/steps/mirror-to-build.d.ts

@@ -0,0 +1,3 @@
+import type { PipelineContext } from '../context.js';
+export declare function runMirrorToBuild(ctx: PipelineContext): Promise<void>;
+//# sourceMappingURL=mirror-to-build.d.ts.map

package/dist/steps/mirror-to-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror-to-build.d.ts","sourceRoot":"","sources":["../../src/steps/mirror-to-build.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC1E"}

package/dist/steps/mirror-to-build.js

@@ -0,0 +1,44 @@
+import { loadManifestFromDir, validateAppProjectForBuild } from '@brookesia/shared-utils';
+import fs from 'fs-extra';
+import path from 'node:path';
+import { shouldMirrorPath } from '../package-exclude.js';
+const SKIP_DIRS = new Set(['node_modules', 'dist', 'build', '.git']);
+export async function runMirrorToBuild(ctx) {
+    if (ctx.config.pack?.skipBuildMirror) {
+        return;
+    }
+    validateAppProjectForBuild(ctx.projectRoot, ctx.sourceRoot);
+    const bundle = ctx.config.js?.bundle;
+    let bundleOutputJs;
+    let omitSourceJs = false;
+    let excludePatterns = [];
+    if (bundle) {
+        const manifest = loadManifestFromDir(ctx.sourceRoot);
+        bundleOutputJs = bundle.output ?? manifest.runtime.entry;
+        omitSourceJs = bundle.omitSourceJs !== false;
+        excludePatterns = bundle.excludeFromPackage ?? [];
+    }
+    await fs.emptyDir(ctx.buildDir);
+    await fs.copy(ctx.sourceRoot, ctx.buildDir, {
+        filter: (src) => {
+            if (src.endsWith('.bpk')) {
+                return false;
+            }
+            const rel = path.relative(ctx.sourceRoot, src);
+            if (!rel || rel === '') {
+                return true;
+            }
+            const parts = rel.split(path.sep);
+            if (parts.some((part) => SKIP_DIRS.has(part))) {
+                return false;
+            }
+            return shouldMirrorPath({
+                rel,
+                bundleOutputJs,
+                omitSourceJs,
+                excludePatterns,
+            });
+        },
+    });
+}
+//# sourceMappingURL=mirror-to-build.js.map

package/dist/steps/mirror-to-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror-to-build.js","sourceRoot":"","sources":["../../src/steps/mirror-to-build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAoB;IACzD,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,0BAA0B,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC;IACrC,IAAI,cAAkC,CAAC;IACvC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,eAAe,GAAa,EAAE,CAAC;IACnC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrD,cAAc,GAAG,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;QACzD,YAAY,GAAG,MAAM,CAAC,YAAY,KAAK,KAAK,CAAC;QAC7C,eAAe,GAAG,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE;QAC1C,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACd,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC9C,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,gBAAgB,CAAC;gBACtB,GAAG;gBACH,cAAc;gBACd,YAAY;gBACZ,eAAe;aAChB,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/steps/pack-gui-images.d.ts

@@ -0,0 +1,7 @@
+import type { PipelineContext } from '../context.js';
+/**
+ * Pack GUI images from cli.sourceRoot (e.g. package/res/images) into build/res/images.
+ * Per image id: .bin (copy) > .c (Node) > .png (disabled by default).
+ */
+export declare function runPackGuiImages(ctx: PipelineContext): Promise<void>;
+//# sourceMappingURL=pack-gui-images.d.ts.map

package/dist/steps/pack-gui-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-gui-images.d.ts","sourceRoot":"","sources":["../../src/steps/pack-gui-images.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAwHrD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoG1E"}

package/dist/steps/pack-gui-images.js

@@ -0,0 +1,185 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { LVGL_IMAGE_DEPS_HINT, logStep, logWarn, pythonHasLvglImageDeps, } from '@brookesia/shared-utils';
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'node:path';
+import { imageDescriptorJson, lvglCSourceToBin, readLvglBinDimensions, } from '../lvgl-image-assets.js';
+function pngHintDisabled(sourceRoot, imageDir) {
+    const rel = path.relative(sourceRoot, imageDir) || 'res/images';
+    return [
+        `PNG conversion is disabled for ${rel}/.`,
+        'Provide a preconverted <id>.bin or <id>.c for each PNG asset.',
+        'Set images.pngConvert to "lvgl-python" only when you intentionally want to use LVGLImage.py.',
+    ].join('\n');
+}
+function resolveLvglImageTool(projectRoot, configured) {
+    const raw = configured?.trim();
+    if (!raw) {
+        throw new Error('PNG → bin via LVGLImage.py requires images.lvglImageTool in brookesia.config.js '
+            + '(absolute path or relative to project root)');
+    }
+    return path.isAbsolute(raw) ? raw : path.resolve(projectRoot, raw);
+}
+async function writeImageJson(outputDir, id, bin, jsonOverridePath) {
+    const jsonDest = path.join(outputDir, `${id}.json`);
+    if (jsonOverridePath && (await fs.pathExists(jsonOverridePath))) {
+        await fs.copy(jsonOverridePath, jsonDest);
+        return;
+    }
+    const { width, height } = readLvglBinDimensions(bin);
+    await fs.writeFile(jsonDest, imageDescriptorJson(id, width, height), 'utf8');
+}
+async function packBinFile(inputPath, outputDir, id, jsonOverridePath) {
+    const bin = await fs.readFile(inputPath);
+    await fs.writeFile(path.join(outputDir, `${id}.bin`), bin);
+    await writeImageJson(outputDir, id, bin, jsonOverridePath);
+}
+async function packCFile(inputPath, outputDir, id, jsonOverridePath) {
+    const source = await fs.readFile(inputPath, 'utf8');
+    const bin = lvglCSourceToBin(source);
+    await fs.writeFile(path.join(outputDir, `${id}.bin`), bin);
+    await writeImageJson(outputDir, id, bin, jsonOverridePath);
+}
+async function packPngWithLvglPython(ctx, pngPaths, jsonById, outputDir) {
+    const imageTool = resolveLvglImageTool(ctx.projectRoot, ctx.config.images?.lvglImageTool);
+    if (!(await fs.pathExists(imageTool))) {
+        throw new Error(`LVGLImage.py not found at ${imageTool}`);
+    }
+    if (!(await pythonHasLvglImageDeps())) {
+        throw new Error(`pack-gui-images (LVGLImage.py): missing Python deps. ${LVGL_IMAGE_DEPS_HINT}`);
+    }
+    const imgCfg = ctx.config.images ?? {};
+    const cf = imgCfg.colorFormat ?? 'ARGB8888';
+    const compress = imgCfg.compress ?? 'NONE';
+    const align = imgCfg.align ?? 1;
+    const background = imgCfg.background ?? '0x000000';
+    logStep(`pack-gui-images: ${pngPaths.size} PNG(s) → ${outputDir} via LVGLImage.py`);
+    let packed = 0;
+    for (const [id, pngPath] of pngPaths) {
+        await execa('python3', [
+            imageTool,
+            '--ofmt',
+            'BIN',
+            '--cf',
+            cf,
+            '--compress',
+            compress,
+            '--align',
+            String(align),
+            '--background',
+            background,
+            '-o',
+            outputDir,
+            pngPath,
+        ], { stdio: 'inherit' });
+        const binPath = path.join(outputDir, `${id}.bin`);
+        if (!(await fs.pathExists(binPath))) {
+            throw new Error(`LVGLImage.py did not produce ${binPath}`);
+        }
+        const bin = await fs.readFile(binPath);
+        await writeImageJson(outputDir, id, bin, jsonById.get(id));
+        packed += 1;
+    }
+    return packed;
+}
+/**
+ * Pack GUI images from cli.sourceRoot (e.g. package/res/images) into build/res/images.
+ * Per image id: .bin (copy) > .c (Node) > .png (disabled by default).
+ */
+export async function runPackGuiImages(ctx) {
+    const imgCfg = ctx.config.images ?? {};
+    const inputDir = path.join(ctx.sourceRoot, imgCfg.inputDir ?? 'res/images');
+    if (!(await fs.pathExists(inputDir))) {
+        return;
+    }
+    const legacyAssets = path.join(ctx.projectRoot, 'assets', 'images');
+    if (await fs.pathExists(legacyAssets)) {
+        const legacyFiles = await fs.readdir(legacyAssets);
+        if (legacyFiles.some((f) => /\.(png|bin|c)$/i.test(f))) {
+            logWarn(`pack-gui-images: ignoring project-root assets/images/ — use ${path.relative(ctx.projectRoot, inputDir)}/ under sourceRoot (${path.basename(ctx.sourceRoot)}/)`);
+        }
+    }
+    const entries = await fs.readdir(inputDir);
+    const byId = new Map();
+    for (const name of entries) {
+        const lower = name.toLowerCase();
+        const id = path.basename(name, path.extname(name));
+        const slot = byId.get(id) ?? {};
+        const full = path.join(inputDir, name);
+        if (lower.endsWith('.bin')) {
+            slot.bin = full;
+        }
+        else if (lower.endsWith('.c')) {
+            slot.c = full;
+        }
+        else if (lower.endsWith('.json')) {
+            slot.json = full;
+        }
+        else if (lower.endsWith('.png')) {
+            slot.png = full;
+        }
+        byId.set(id, slot);
+    }
+    if (byId.size === 0) {
+        return;
+    }
+    const outputDir = path.join(ctx.buildDir, 'res', 'images');
+    await fs.ensureDir(outputDir);
+    const pngConvert = imgCfg.pngConvert ?? 'off';
+    const pngToConvert = new Map();
+    const jsonById = new Map();
+    let packed = 0;
+    for (const [id, slot] of byId) {
+        // 1. .bin — copy
+        if (slot.bin) {
+            if (slot.c) {
+                logWarn(`pack-gui-images: ignoring ${id}.c (${id}.bin takes precedence)`);
+            }
+            if (slot.png) {
+                logWarn(`pack-gui-images: ignoring ${id}.png (${id}.bin takes precedence)`);
+            }
+            await packBinFile(slot.bin, outputDir, id, slot.json);
+            packed += 1;
+            continue;
+        }
+        // 2. .c — Node → bin
+        if (slot.c) {
+            if (slot.png) {
+                logWarn(`pack-gui-images: ignoring ${id}.png (${id}.c takes precedence)`);
+            }
+            await packCFile(slot.c, outputDir, id, slot.json);
+            packed += 1;
+            continue;
+        }
+        // 3. .png only — rejected by default, or converted when explicitly enabled
+        if (slot.png) {
+            const mirroredBin = path.join(outputDir, `${id}.bin`);
+            if (await fs.pathExists(mirroredBin)) {
+                const bin = await fs.readFile(mirroredBin);
+                await writeImageJson(outputDir, id, bin, slot.json);
+                logWarn(`pack-gui-images: ${id}.png skipped (${id}.bin already in build/res/images)`);
+                continue;
+            }
+            pngToConvert.set(id, slot.png);
+            jsonById.set(id, slot.json);
+        }
+    }
+    if (pngToConvert.size > 0) {
+        if (pngConvert === 'lvgl-python') {
+            packed += await packPngWithLvglPython(ctx, pngToConvert, jsonById, outputDir);
+        }
+        else {
+            const names = [...pngToConvert.keys()].map((id) => `${id}.png`).join(', ');
+            throw new Error(`pack-gui-images: ${names}\n${pngHintDisabled(ctx.sourceRoot, inputDir)}`);
+        }
+    }
+    if (packed > 0) {
+        const relIn = path.relative(ctx.projectRoot, inputDir);
+        logStep(`pack-gui-images: ${packed} image(s) from ${relIn} → build/res/images`);
+    }
+}
+//# sourceMappingURL=pack-gui-images.js.map

package/dist/steps/pack-gui-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-gui-images.js","sourceRoot":"","sources":["../../src/steps/pack-gui-images.ts"],"names":[],"mappings":"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"}

package/dist/steps/pack-gui-images.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pack-gui-images.test.d.ts.map

package/dist/steps/pack-gui-images.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-gui-images.test.d.ts","sourceRoot":"","sources":["../../src/steps/pack-gui-images.test.ts"],"names":[],"mappings":""}

package/dist/steps/pack-gui-images.test.js

@@ -0,0 +1,29 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'fs-extra';
+import os from 'node:os';
+import path from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { runPackGuiImages } from './pack-gui-images.js';
+describe('runPackGuiImages', () => {
+    it('does not invoke LVGLImage.py for PNG-only assets by default', async () => {
+        const projectRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'brookesia-png-'));
+        const sourceRoot = path.join(projectRoot, 'src');
+        const buildDir = path.join(projectRoot, 'build');
+        await fs.ensureDir(path.join(sourceRoot, 'res', 'images'));
+        await fs.writeFile(path.join(sourceRoot, 'res', 'images', 'icon.png'), Buffer.from([0x89, 0x50, 0x4e, 0x47]));
+        await expect(runPackGuiImages({
+            projectRoot,
+            sourceRoot,
+            buildDir,
+            distDir: path.join(projectRoot, 'dist'),
+            signDir: path.join(projectRoot, 'sign'),
+            config: {},
+            mode: 'development',
+        })).rejects.toThrow('PNG conversion is disabled');
+    });
+});
+//# sourceMappingURL=pack-gui-images.test.js.map

package/dist/steps/pack-gui-images.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-gui-images.test.js","sourceRoot":"","sources":["../../src/steps/pack-gui-images.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAE9G,MAAM,MAAM,CAAC,gBAAgB,CAAC;YAC5B,WAAW;YACX,UAAU;YACV,QAAQ;YACR,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;YACvC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;YACvC,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/steps/pack.d.ts

@@ -0,0 +1,3 @@
+import type { PipelineContext } from '../context.js';
+export declare function runPack(ctx: PipelineContext): Promise<void>;
+//# sourceMappingURL=pack.d.ts.map

package/dist/steps/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/steps/pack.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,wBAAsB,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjE"}

package/dist/steps/pack.js

@@ -0,0 +1,19 @@
+import { outputBpkName, packAppPackage } from '@brookesia/packager';
+import { loadManifestFromDir } from '@brookesia/shared-utils';
+import fs from 'node:fs';
+import path from 'node:path';
+export async function runPack(ctx) {
+    const sourceDir = ctx.config.pack?.skipBuildMirror ? ctx.sourceRoot : ctx.buildDir;
+    const manifest = loadManifestFromDir(sourceDir);
+    const fileName = outputBpkName(manifest, ctx.mode);
+    await fs.promises.mkdir(ctx.distDir, { recursive: true });
+    const outputPath = path.join(ctx.distDir, fileName);
+    await packAppPackage({
+        sourceDir,
+        outputPath,
+        mode: ctx.mode,
+        signDir: ctx.signDir,
+        compression: ctx.config.pack?.compression ?? 'deflate',
+    });
+}
+//# sourceMappingURL=pack.js.map

package/dist/steps/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/steps/pack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAoB;IAChD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IACnF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEpD,MAAM,cAAc,CAAC;QACnB,SAAS;QACT,UAAU;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,SAAS;KACvD,CAAC,CAAC;AACL,CAAC"}

package/dist/steps/sync-settings-assets.d.ts

@@ -0,0 +1,6 @@
+import type { PipelineContext } from '../context.js';
+/**
+ * Copy Settings demo JSON UI into package/res/ (documents/ + shared/).
+ */
+export declare function runSyncSettingsAssets(ctx: PipelineContext): Promise<void>;
+//# sourceMappingURL=sync-settings-assets.d.ts.map

package/dist/steps/sync-settings-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-settings-assets.d.ts","sourceRoot":"","sources":["../../src/steps/sync-settings-assets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B/E"}

package/dist/steps/sync-settings-assets.js

@@ -0,0 +1,31 @@
+import { logStep } from '@brookesia/shared-utils';
+import fs from 'fs-extra';
+import path from 'node:path';
+/**
+ * Copy Settings demo JSON UI into package/res/ (documents/ + shared/).
+ */
+export async function runSyncSettingsAssets(ctx) {
+    if (!ctx.config.settings) {
+        return;
+    }
+    const raw = ctx.config.settings.assetSource?.trim();
+    if (!raw) {
+        throw new Error('settings.assetSource is required when settings is enabled '
+            + '(absolute path or relative to project root)');
+    }
+    const assetSource = path.isAbsolute(raw)
+        ? raw
+        : path.join(ctx.projectRoot, raw);
+    const resRoot = path.join(ctx.sourceRoot, 'res');
+    for (const sub of ['documents', 'shared']) {
+        const from = path.join(assetSource, sub);
+        const to = path.join(resRoot, sub);
+        if (!(await fs.pathExists(from))) {
+            throw new Error(`Settings asset source missing: ${from}`);
+        }
+        await fs.ensureDir(path.dirname(to));
+        await fs.copy(from, to, { overwrite: true });
+    }
+    logStep(`sync-settings-assets: ${assetSource} → ${resRoot}`);
+}
+//# sourceMappingURL=sync-settings-assets.js.map

package/dist/steps/sync-settings-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-settings-assets.js","sourceRoot":"","sources":["../../src/steps/sync-settings-assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAoB;IAC9D,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACpD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,4DAA4D;cAC1D,6CAA6C,CAChD,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACtC,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAEjD,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAU,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,yBAAyB,WAAW,MAAM,OAAO,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/steps/validate.d.ts

@@ -0,0 +1,3 @@
+import type { PipelineContext } from '../context.js';
+export declare function runValidate(ctx: PipelineContext): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/steps/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/steps/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,wBAAsB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrE"}

package/dist/steps/validate.js

@@ -0,0 +1,12 @@
+import { validateManifest, validateNoMetaInfInSource, } from '@brookesia/config-schema';
+import { loadManifestFromDir } from '@brookesia/shared-utils';
+export async function runValidate(ctx) {
+    // After mirror, validate the tree that will be packed.
+    const sourceDir = ctx.config.pack?.skipBuildMirror ? ctx.sourceRoot : ctx.buildDir;
+    if (ctx.config.validate?.forbidSourceMetaInf !== false) {
+        validateNoMetaInfInSource(sourceDir);
+    }
+    const manifest = loadManifestFromDir(sourceDir);
+    validateManifest(manifest, sourceDir);
+}
+//# sourceMappingURL=validate.js.map

package/dist/steps/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/steps/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAoB;IACpD,uDAAuD;IACvD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IACnF,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,mBAAmB,KAAK,KAAK,EAAE,CAAC;QACvD,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAChD,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@brookesia/pipeline",
+  "version": "0.1.0",
+  "description": "Build and release pipeline for ESP-Brookesia app projects",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/espressif/esp-brookesia-toolkit.git",
+    "directory": "packages/pipeline"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@brookesia/config-schema": "0.1.0",
+    "@brookesia/packager": "0.1.0",
+    "@brookesia/shared-utils": "0.1.0",
+    "execa": "^9.5.2",
+    "fs-extra": "^11.3.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "typescript": "^5.7.3"
+  }
+}