@brookesia/pipeline 0.1.0

package/dist/bundle-config.d.ts

@@ -0,0 +1,13 @@
+export type BundleTool = 'rspack' | 'webpack';
+export declare function resolveBundlerBin(projectRoot: string, tool: BundleTool): string;
+export declare function assertBundlePaths(entry: string, output: string): void;
+export declare function writeDefaultBundleConfig(options: {
+    projectRoot: string;
+    tool: BundleTool;
+    mode: 'development' | 'production';
+    entryAbs: string;
+    outputDirAbs: string;
+    outputFilename: string;
+}): Promise<string>;
+export declare function bundlerCliArgs(tool: BundleTool, configPath: string, extra?: string[]): string[];
+//# sourceMappingURL=bundle-config.d.ts.map

package/dist/bundle-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-config.d.ts","sourceRoot":"","sources":["../src/bundle-config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9C,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAkB/E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOrE;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAM/F"}

package/dist/bundle-config.js

@@ -0,0 +1,70 @@
+import { isSafeRelativePath } from '@brookesia/config-schema';
+import fs from 'fs-extra';
+import path from 'node:path';
+export function resolveBundlerBin(projectRoot, tool) {
+    const binName = tool === 'rspack' ? 'rspack' : 'webpack';
+    let dir = path.resolve(projectRoot);
+    while (true) {
+        const candidate = path.join(dir, 'node_modules', '.bin', binName);
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    const pkg = tool === 'rspack' ? '@rspack/cli' : 'webpack webpack-cli';
+    throw new Error(`bundle-js: "${binName}" not found in ${projectRoot} or ancestor node_modules/.bin — install ${pkg} in the app or esp-brookesia-toolkit root`);
+}
+export function assertBundlePaths(entry, output) {
+    if (!isSafeRelativePath(entry)) {
+        throw new Error(`js.bundle.entry must be a safe relative path: ${entry}`);
+    }
+    if (!isSafeRelativePath(output)) {
+        throw new Error(`js.bundle.output must be a safe relative path: ${output}`);
+    }
+}
+export async function writeDefaultBundleConfig(options) {
+    const cacheDir = path.join(options.projectRoot, '.brookesia');
+    await fs.ensureDir(cacheDir);
+    const configPath = path.join(cacheDir, `bundle.${options.tool}.mjs`);
+    const body = `/** Generated by @brookesia/pipeline — do not edit; set js.bundle.configFile in brookesia.config.js instead. */
+const entry = ${JSON.stringify(options.entryAbs)};
+const outputPath = ${JSON.stringify(options.outputDirAbs)};
+const outputFilename = ${JSON.stringify(options.outputFilename)};
+
+export default {
+  mode: ${JSON.stringify(options.mode)},
+  entry,
+  output: {
+    path: outputPath,
+    filename: outputFilename,
+    library: {
+      name: 'brookesia_app',
+      type: 'assign',
+      export: 'default',
+    },
+  },
+  externals: {
+    brookesia: 'brookesia',
+  },
+  optimization: {
+    splitChunks: false,
+    runtimeChunk: false,
+  },
+  devtool: false,
+};
+`;
+    await fs.writeFile(configPath, body, 'utf8');
+    return configPath;
+}
+export function bundlerCliArgs(tool, configPath, extra) {
+    const tail = extra ?? [];
+    if (tool === 'rspack') {
+        return ['build', '-c', configPath, ...tail];
+    }
+    return ['--config', configPath, ...tail];
+}
+//# sourceMappingURL=bundle-config.js.map

package/dist/bundle-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-config.js","sourceRoot":"","sources":["../src/bundle-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,IAAgB;IACrE,MAAM,OAAO,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM;QACR,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACtE,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,kBAAkB,WAAW,4CAA4C,GAAG,2CAA2C,CAC9I,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,MAAc;IAC7D,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,iDAAiD,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,kDAAkD,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAO9C;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,OAAO,CAAC,IAAI,MAAM,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG;gBACC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;qBAC3B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC;yBAChC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC;;;UAGrD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;CAoBrC,CAAC;IACA,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,UAAkB,EAAE,KAAgB;IACnF,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;IACzB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/bundle-config.test.d.ts

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

package/dist/bundle-config.test.d.ts.map

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

package/dist/bundle-config.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 { assertBundlePaths, bundlerCliArgs, resolveBundlerBin } from './bundle-config.js';
+describe('bundle-config', () => {
+    it('bundlerCliArgs matches rspack vs webpack', () => {
+        expect(bundlerCliArgs('rspack', '/tmp/c.mjs')).toEqual(['build', '-c', '/tmp/c.mjs']);
+        expect(bundlerCliArgs('webpack', '/tmp/c.mjs', ['--stats', 'errors-only'])).toEqual([
+            '--config',
+            '/tmp/c.mjs',
+            '--stats',
+            'errors-only',
+        ]);
+    });
+    it('assertBundlePaths rejects traversal', () => {
+        expect(() => assertBundlePaths('../x.js', 'app/out.js')).toThrow();
+        expect(() => assertBundlePaths('src/main.js', '../out.js')).toThrow();
+    });
+    it('assertBundlePaths accepts normal paths', () => {
+        expect(() => assertBundlePaths('src/main.js', 'app/main.js')).not.toThrow();
+    });
+    it('resolves bundler from ancestor node_modules for toolkit-root installs', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'brookesia-bundler-'));
+        const app = path.join(root, 'my-bundle-app');
+        const bin = path.join(root, 'node_modules', '.bin', 'rspack');
+        await fs.ensureDir(app);
+        await fs.ensureDir(path.dirname(bin));
+        await fs.writeFile(bin, '#!/bin/sh\n');
+        expect(resolveBundlerBin(app, 'rspack')).toBe(bin);
+    });
+});
+//# sourceMappingURL=bundle-config.test.js.map

package/dist/bundle-config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-config.test.js","sourceRoot":"","sources":["../src/bundle-config.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,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1F,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;QACtF,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAClF,UAAU;YACV,YAAY;YACZ,SAAS;YACT,aAAa;SACd,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACnE,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9D,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAEvC,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectContext } from '@brookesia/shared-utils';
+import type { BuildMode } from './lane.js';
+export interface PipelineContext extends ProjectContext {
+    mode: BuildMode;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,IAAI,EAAE,SAAS,CAAC;CACjB"}

package/dist/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './context.js';
+export * from './lane.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './context.js';
+export * from './lane.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/lane.d.ts

@@ -0,0 +1,4 @@
+import type { PipelineContext } from './context.js';
+export type BuildMode = 'development' | 'production';
+export declare function runPipeline(ctx: PipelineContext): Promise<void>;
+//# sourceMappingURL=lane.d.ts.map

package/dist/lane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane.d.ts","sourceRoot":"","sources":["../src/lane.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAQpD,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,YAAY,CAAC;AAWrD,wBAAsB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBrE"}

package/dist/lane.js

@@ -0,0 +1,34 @@
+import { logStep, logSuccess, validateAppProjectForBuild } from '@brookesia/shared-utils';
+import { runBundleJs } from './steps/bundle-js.js';
+import { runMirrorToBuild } from './steps/mirror-to-build.js';
+import { runPackGuiImages } from './steps/pack-gui-images.js';
+import { runPack } from './steps/pack.js';
+import { runSyncSettingsAssets } from './steps/sync-settings-assets.js';
+import { runValidate } from './steps/validate.js';
+function rejectNativeWasmCompileConfig(ctx) {
+    const wasm = ctx.config.wasm;
+    if (wasm?.sources?.length) {
+        throw new Error('wasm.sources is no longer supported. Provide a prebuilt .wasm at manifest.runtime.entry instead.');
+    }
+}
+export async function runPipeline(ctx) {
+    if (!ctx.config.pack?.skipBuildMirror) {
+        validateAppProjectForBuild(ctx.projectRoot, ctx.sourceRoot);
+    }
+    rejectNativeWasmCompileConfig(ctx);
+    const started = Date.now();
+    const steps = [
+        { name: 'sync-settings-assets', run: () => runSyncSettingsAssets(ctx) },
+        { name: 'bundle-js', run: () => runBundleJs(ctx) },
+        { name: 'mirror-to-build', run: () => runMirrorToBuild(ctx) },
+        { name: 'validate', run: () => runValidate(ctx) },
+        { name: 'pack-gui-images', run: () => runPackGuiImages(ctx) },
+        { name: 'pack', run: () => runPack(ctx) },
+    ];
+    for (const step of steps) {
+        logStep(`pipeline: ${step.name}`);
+        await step.run();
+    }
+    logSuccess(`build success: ${Date.now() - started}ms`);
+}
+//# sourceMappingURL=lane.js.map

package/dist/lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane.js","sourceRoot":"","sources":["../src/lane.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAE1F,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIlD,SAAS,6BAA6B,CAAC,GAAoB;IACzD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAA0C,CAAC;IACnE,IAAI,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAoB;IACpD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC;QACtC,0BAA0B,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC;IACD,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG;QACZ,EAAE,IAAI,EAAE,sBAAsB,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE;QACvE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE;QAClD,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE;QAC7D,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE;QACjD,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE;QAC7D,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;KAC1C,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,aAAa,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,kBAAkB,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;AACzD,CAAC"}

package/dist/lvgl-image-assets.d.ts

@@ -0,0 +1,22 @@
+/** LVGL v9 on-disk image header (12 bytes), same layout as LVGLImage.py / brookesia_gui_lvgl. */
+export declare const LVGL_IMAGE_HEADER_MAGIC = 25;
+export interface LvglImageDimensions {
+    width: number;
+    height: number;
+}
+export declare function readLvglBinDimensions(bin: Buffer): LvglImageDimensions;
+export declare function buildLvglBinHeader(cf: number, flags: number, width: number, height: number, stride: number): Buffer;
+export declare function defaultStride(cf: number, width: number): number;
+export declare function imageDescriptorJson(id: string, width: number, height: number): string;
+export interface ParsedLvglCImage {
+    cf: number;
+    flags: number;
+    width: number;
+    height: number;
+    stride: number;
+    map: Buffer;
+}
+/** Parse LVGL v9 image C sources (LVGLImage.py or https://lvgl.io/tools/imageconverter). */
+export declare function parseLvglImageCSource(source: string): ParsedLvglCImage;
+export declare function lvglCSourceToBin(source: string): Buffer;
+//# sourceMappingURL=lvgl-image-assets.d.ts.map

package/dist/lvgl-image-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lvgl-image-assets.d.ts","sourceRoot":"","sources":["../src/lvgl-image-assets.ts"],"names":[],"mappings":"AAMA,iGAAiG;AACjG,eAAO,MAAM,uBAAuB,KAAO,CAAC;AA2C5C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAatE;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAUR;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQrF;AA2DD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAmBtE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUvD"}

package/dist/lvgl-image-assets.js

@@ -0,0 +1,165 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** LVGL v9 on-disk image header (12 bytes), same layout as LVGLImage.py / brookesia_gui_lvgl. */
+export const LVGL_IMAGE_HEADER_MAGIC = 0x19;
+/** Matches LVGLImage.py ColorFormat enum values used by the online converter. */
+const COLOR_FORMAT_BY_NAME = {
+    L8: 0x06,
+    I1: 0x07,
+    I2: 0x08,
+    I4: 0x09,
+    I8: 0x0a,
+    A1: 0x0b,
+    A2: 0x0c,
+    A4: 0x0d,
+    A8: 0x0e,
+    RGB888: 0x0f,
+    ARGB8888: 0x10,
+    XRGB8888: 0x11,
+    RGB565: 0x12,
+    ARGB8565: 0x13,
+    RGB565A8: 0x14,
+    RGB565_SWAPPED: 0x1b,
+    ARGB8888_PREMULTIPLIED: 0x1a,
+};
+const BPP_BY_CF = {
+    0x06: 8,
+    0x07: 1,
+    0x08: 2,
+    0x09: 4,
+    0x0a: 8,
+    0x0b: 1,
+    0x0c: 2,
+    0x0d: 4,
+    0x0e: 8,
+    0x0f: 24,
+    0x10: 32,
+    0x11: 32,
+    0x12: 16,
+    0x13: 24,
+    0x14: 16,
+    0x1a: 32,
+    0x1b: 16,
+};
+export function readLvglBinDimensions(bin) {
+    if (bin.length < 12) {
+        throw new Error('Invalid LVGL image bin: header too short');
+    }
+    if (bin[0] !== LVGL_IMAGE_HEADER_MAGIC) {
+        throw new Error(`Invalid LVGL image bin magic 0x${bin[0].toString(16)}`);
+    }
+    const width = bin.readUInt16LE(4);
+    const height = bin.readUInt16LE(6);
+    if (width <= 0 || height <= 0) {
+        throw new Error(`Invalid LVGL image bin size ${width}x${height}`);
+    }
+    return { width, height };
+}
+export function buildLvglBinHeader(cf, flags, width, height, stride) {
+    const header = Buffer.alloc(12);
+    header[0] = LVGL_IMAGE_HEADER_MAGIC;
+    header[1] = cf & 0x1f;
+    header.writeUInt16LE(flags & 0xffff, 2);
+    header.writeUInt16LE(width & 0xffff, 4);
+    header.writeUInt16LE(height & 0xffff, 6);
+    header.writeUInt16LE(stride & 0xffff, 8);
+    header.writeUInt16LE(0, 10);
+    return header;
+}
+export function defaultStride(cf, width) {
+    const bpp = BPP_BY_CF[cf];
+    if (!bpp) {
+        throw new Error(`Cannot infer stride for color format 0x${cf.toString(16)}; set .stride in the C descriptor`);
+    }
+    return Math.ceil((width * bpp) / 8);
+}
+export function imageDescriptorJson(id, width, height) {
+    return `${JSON.stringify({
+        type: 'image',
+        id,
+        src: `${id}.bin`,
+        width,
+        height,
+    }, null, 4)}\n`;
+}
+function parseColorFormat(source) {
+    const named = source.match(/LV_COLOR_FORMAT_([A-Z0-9_]+)/);
+    if (named) {
+        const cf = COLOR_FORMAT_BY_NAME[named[1]];
+        if (cf === undefined) {
+            throw new Error(`Unsupported LV_COLOR_FORMAT_${named[1]} in image C source`);
+        }
+        return cf;
+    }
+    const numeric = source.match(/\b(0x[0-9a-fA-F]+|\d+)\b/);
+    if (numeric) {
+        return Number(numeric[1]);
+    }
+    throw new Error('Could not parse color format from lv_image_dsc_t');
+}
+function parseFlags(source) {
+    const trimmed = source.trim();
+    if (trimmed === '0') {
+        return 0;
+    }
+    let flags = 0;
+    if (trimmed.includes('LV_IMAGE_FLAGS_COMPRESSED')) {
+        flags |= 0x08;
+    }
+    if (trimmed.includes('LV_IMAGE_FLAGS_PREMULTIPLIED')) {
+        flags |= 0x01;
+    }
+    if (flags === 0 && /^\d+$/.test(trimmed)) {
+        return Number(trimmed);
+    }
+    if (flags === 0 && /^0x[0-9a-f]+$/i.test(trimmed)) {
+        return Number(trimmed);
+    }
+    if (flags === 0 && trimmed !== '') {
+        throw new Error(`Unsupported image flags expression: ${trimmed}`);
+    }
+    return flags;
+}
+function parseMapBytes(source) {
+    const mapMatch = source.match(/uint8_t\s+\w+_map\s*\[\s*\]\s*=\s*\{([\s\S]*?)\};/);
+    if (!mapMatch) {
+        throw new Error('Could not find uint8_t *_map[] byte array in image C source');
+    }
+    const bytes = [];
+    const hexRe = /0x([0-9a-fA-F]{1,2})/g;
+    let m;
+    while ((m = hexRe.exec(mapMatch[1])) !== null) {
+        bytes.push(Number.parseInt(m[1], 16));
+    }
+    if (bytes.length === 0) {
+        throw new Error('Image map array is empty or not in 0xNN hex form');
+    }
+    return Buffer.from(bytes);
+}
+/** Parse LVGL v9 image C sources (LVGLImage.py or https://lvgl.io/tools/imageconverter). */
+export function parseLvglImageCSource(source) {
+    const cfMatch = source.match(/(?:\.header)?\.cf\s*=\s*([^,;\n]+)/);
+    const wMatch = source.match(/(?:\.header)?\.w\s*=\s*(\d+)/);
+    const hMatch = source.match(/(?:\.header)?\.h\s*=\s*(\d+)/);
+    const strideMatch = source.match(/(?:\.header)?\.stride\s*=\s*(\d+)/);
+    const flagsMatch = source.match(/(?:\.header)?\.flags\s*=\s*([^,;\n]+)/);
+    if (!cfMatch || !wMatch || !hMatch) {
+        throw new Error('lv_image_dsc_t must define .header.cf, .header.w, and .header.h');
+    }
+    const cf = parseColorFormat(cfMatch[1]);
+    const width = Number(wMatch[1]);
+    const height = Number(hMatch[1]);
+    const flags = flagsMatch ? parseFlags(flagsMatch[1]) : 0;
+    const stride = strideMatch ? Number(strideMatch[1]) : defaultStride(cf, width);
+    const map = parseMapBytes(source);
+    return { cf, flags, width, height, stride, map };
+}
+export function lvglCSourceToBin(source) {
+    const parsed = parseLvglImageCSource(source);
+    const header = buildLvglBinHeader(parsed.cf, parsed.flags, parsed.width, parsed.height, parsed.stride);
+    return Buffer.concat([header, parsed.map]);
+}
+//# sourceMappingURL=lvgl-image-assets.js.map

package/dist/lvgl-image-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lvgl-image-assets.js","sourceRoot":"","sources":["../src/lvgl-image-assets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iGAAiG;AACjG,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,iFAAiF;AACjF,MAAM,oBAAoB,GAA2B;IACnD,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,cAAc,EAAE,IAAI;IACpB,sBAAsB,EAAE,IAAI;CAC7B,CAAC;AAEF,MAAM,SAAS,GAAoC;IACjD,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;CACT,CAAC;AAOF,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,uBAAuB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,EAAU,EACV,KAAa,EACb,KAAa,EACb,MAAc,EACd,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChC,MAAM,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC;IACpC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,aAAa,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IACxC,MAAM,CAAC,aAAa,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IACxC,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IACzC,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IACzC,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,KAAa;IACrD,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0CAA0C,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,mCAAmC,CAAC,CAAC;IAChH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,KAAa,EAAE,MAAc;IAC3E,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QACvB,IAAI,EAAE,OAAO;QACb,EAAE;QACF,GAAG,EAAE,GAAG,EAAE,MAAM;QAChB,KAAK;QACL,MAAM;KACP,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC3D,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QAC3C,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACzD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,UAAU,CAAC,MAAc;IAChC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CAAC;QAClD,KAAK,IAAI,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;QACrD,KAAK,IAAI,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACnF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,uBAAuB,CAAC;IACtC,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAWD,4FAA4F;AAC5F,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAEzE,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAElC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,kBAAkB,CAC/B,MAAM,CAAC,EAAE,EACT,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,MAAM,CACd,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/lvgl-image-assets.test.d.ts

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

package/dist/lvgl-image-assets.test.d.ts.map

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

package/dist/lvgl-image-assets.test.js

@@ -0,0 +1,56 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'fs-extra';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { buildLvglBinHeader, lvglCSourceToBin, parseLvglImageCSource, readLvglBinDimensions, } from './lvgl-image-assets.js';
+const FIXTURE_C = `uint8_t icon_map[] = {
+    0x11, 0x22, 0x33, 0x44,
+};
+
+const lv_image_dsc_t icon = {
+  .header = {
+    .magic = LV_IMAGE_HEADER_MAGIC,
+    .cf = LV_COLOR_FORMAT_ARGB8888,
+    .flags = 0,
+    .w = 1,
+    .h = 1,
+    .stride = 4,
+    .reserved_2 = 0,
+  },
+  .data_size = sizeof(icon_map),
+  .data = icon_map,
+};
+`;
+describe('lvgl-image-assets', () => {
+    it('builds bin header and payload from C source', () => {
+        const bin = lvglCSourceToBin(FIXTURE_C);
+        expect(bin.length).toBe(16);
+        expect(bin[0]).toBe(0x19);
+        expect(bin[1]).toBe(0x10);
+        expect(readLvglBinDimensions(bin)).toEqual({ width: 1, height: 1 });
+        expect([...bin.subarray(12)]).toEqual([0x11, 0x22, 0x33, 0x44]);
+    });
+    it('reads dimensions from an existing flappybird bin', async () => {
+        const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../../../../esp-brookesia');
+        const binPath = path.join(repoRoot, 'simulator/gui/general_test/assets/apps/brookesia.app.flappybird.js/res/images/bird_img1.bin');
+        if (!(await fs.pathExists(binPath))) {
+            return;
+        }
+        const bin = await fs.readFile(binPath);
+        expect(readLvglBinDimensions(bin)).toEqual({ width: 57, height: 41 });
+    });
+    it('matches LVGLImage.py header layout', () => {
+        const header = buildLvglBinHeader(0x10, 0, 57, 41, 228);
+        expect(header.toString('hex')).toBe('1910000039002900e4000000');
+    });
+    it('rejects C sources without stride for indexed formats when needed', () => {
+        const parsed = parseLvglImageCSource(FIXTURE_C);
+        expect(parsed.stride).toBe(4);
+    });
+});
+//# sourceMappingURL=lvgl-image-assets.test.js.map

package/dist/lvgl-image-assets.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lvgl-image-assets.test.js","sourceRoot":"","sources":["../src/lvgl-image-assets.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;CAiBjB,CAAC;AAEF,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAC3B,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAC5C,8BAA8B,CAC/B,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,QAAQ,EACR,6FAA6F,CAC9F,CAAC;QACF,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/package-exclude.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Paths relative to sourceRoot excluded from mirror-to-build (not shipped in .bpk).
+ */
+export declare function matchExcludePattern(rel: string, pattern: string): boolean;
+export declare function matchesAnyExclude(rel: string, patterns: string[]): boolean;
+/**
+ * When JS bundle is enabled: omit every .js under sourceRoot except the bundle output,
+ * plus optional excludeFromPackage globs.
+ */
+export declare function shouldMirrorPath(opts: {
+    rel: string;
+    bundleOutputJs?: string;
+    omitSourceJs: boolean;
+    excludePatterns: string[];
+}): boolean;
+//# sourceMappingURL=package-exclude.d.ts.map

package/dist/package-exclude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-exclude.d.ts","sourceRoot":"","sources":["../src/package-exclude.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAqBzE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAG1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,OAAO,CAeV"}

package/dist/package-exclude.js

@@ -0,0 +1,42 @@
+/**
+ * Paths relative to sourceRoot excluded from mirror-to-build (not shipped in .bpk).
+ */
+export function matchExcludePattern(rel, pattern) {
+    const normalized = rel.replace(/\\/g, '/');
+    const pat = pattern.replace(/\\/g, '/');
+    if (pat.endsWith('/**')) {
+        const prefix = pat.slice(0, -3);
+        return normalized === prefix || normalized.startsWith(`${prefix}/`);
+    }
+    if (pat.includes('*')) {
+        const re = new RegExp(`^${pat
+            .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
+            .replace(/\*\*/g, '<<<GLOBSTAR>>>')
+            .replace(/\*/g, '[^/]*')
+            .replace(/<<<GLOBSTAR>>>/g, '.*')}$`);
+        return re.test(normalized);
+    }
+    return normalized === pat;
+}
+export function matchesAnyExclude(rel, patterns) {
+    const normalized = rel.replace(/\\/g, '/');
+    return patterns.some((p) => matchExcludePattern(normalized, p));
+}
+/**
+ * When JS bundle is enabled: omit every .js under sourceRoot except the bundle output,
+ * plus optional excludeFromPackage globs.
+ */
+export function shouldMirrorPath(opts) {
+    const rel = opts.rel.replace(/\\/g, '/');
+    if (opts.excludePatterns.length > 0 && matchesAnyExclude(rel, opts.excludePatterns)) {
+        return false;
+    }
+    if (opts.omitSourceJs && opts.bundleOutputJs && rel.endsWith('.js')) {
+        const out = opts.bundleOutputJs.replace(/\\/g, '/');
+        if (rel !== out) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=package-exclude.js.map

package/dist/package-exclude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-exclude.js","sourceRoot":"","sources":["../src/package-exclude.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,OAAe;IAC9D,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAExC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChC,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,IAAI,MAAM,CACnB,IAAI,GAAG;aACJ,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC;aACrC,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC;aAClC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;aACvB,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CACvC,CAAC;QACF,OAAO,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,UAAU,KAAK,GAAG,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,QAAkB;IAC/D,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAKhC;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEzC,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QACpF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,cAAc,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpD,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/package-exclude.test.d.ts

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

package/dist/package-exclude.test.d.ts.map

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

package/dist/package-exclude.test.js

@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest';
+import { matchExcludePattern, shouldMirrorPath } from './package-exclude.js';
+describe('package-exclude', () => {
+    it('matches ** globs', () => {
+        expect(matchExcludePattern('js/hello.entry.js', 'js/**')).toBe(true);
+        expect(matchExcludePattern('app/app.js', 'js/**')).toBe(false);
+    });
+    it('omits all .js except bundle output by default', () => {
+        const out = 'app/app.js';
+        expect(shouldMirrorPath({
+            rel: 'js/math.js',
+            bundleOutputJs: out,
+            omitSourceJs: true,
+            excludePatterns: [],
+        })).toBe(false);
+        expect(shouldMirrorPath({
+            rel: out,
+            bundleOutputJs: out,
+            omitSourceJs: true,
+            excludePatterns: [],
+        })).toBe(true);
+        expect(shouldMirrorPath({
+            rel: 'manifest.json',
+            bundleOutputJs: out,
+            omitSourceJs: true,
+            excludePatterns: [],
+        })).toBe(true);
+    });
+});
+//# sourceMappingURL=package-exclude.test.js.map

package/dist/package-exclude.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-exclude.test.js","sourceRoot":"","sources":["../src/package-exclude.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,mBAAmB,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG,YAAY,CAAC;QACzB,MAAM,CACJ,gBAAgB,CAAC;YACf,GAAG,EAAE,YAAY;YACjB,cAAc,EAAE,GAAG;YACnB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,EAAE;SACpB,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,MAAM,CACJ,gBAAgB,CAAC;YACf,GAAG,EAAE,GAAG;YACR,cAAc,EAAE,GAAG;YACnB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,EAAE;SACpB,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,CACJ,gBAAgB,CAAC;YACf,GAAG,EAAE,eAAe;YACpB,cAAc,EAAE,GAAG;YACnB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,EAAE;SACpB,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/steps/bundle-js.d.ts

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

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

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