lecodes-cli 0.5.0 → 0.5.2

package/dist/index.js

@@ -854,7 +854,12 @@ var compileProject = async (opts) => {
   const files = {};
   for (const e of opts.entries) {
     if (e.type === "resource") {
-      files[e.path] = `export default "${opts.publicUrl}${e.fileSrc ?? ""}"`;
+      if (opts.localAssets) {
+        const name = e.path.split(/[\\/]/).pop() ?? e.path;
+        files[e.path] = `export default ("id:" + _creatorUtils.fetchLocal(${JSON.stringify(name)}))`;
+      } else {
+        files[e.path] = `export default "${opts.publicUrl}${e.fileSrc ?? ""}"`;
+      }
     } else if (e.type === "shader") {
       const shaders = e.shaders ?? [];
       if (shaders.length > 2) {
@@ -905,7 +910,8 @@ var compileProject2 = (opts) => compileProject({
   publicUrl: opts.publicUrl,
   entryOverride: opts.entryOverride,
   header: opts.header,
-  format: opts.format
+  format: opts.format,
+  localAssets: opts.localAssets
 });
 
 // src/compile/designCompile.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lecodes-cli",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Clone, edit and push LeCodes projects from your machine.",
   "type": "module",
   "license": "MIT",
@@ -21,17 +21,18 @@
   },
   "scripts": {
     "vendor-runtime": "bun scripts/vendor-runtime.ts",
+    "sync-peers": "bun scripts/sync-peer-versions.ts",
     "build": "bun scripts/vendor-runtime.ts && bun build src/index.ts --target=node --outfile dist/index.js --external @letary/chisel --external lecodes-renderer --external lecodes-design --banner=\"#!/usr/bin/env node\"",
     "typecheck": "tsc --noEmit",
     "dev": "bun run src/index.ts",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run sync-peers && bun run build"
   },
   "dependencies": {
     "@letary/chisel": "^0.2.0"
   },
   "peerDependencies": {
     "lecodes-design": "^0.1.0",
-    "lecodes-renderer": "^0.4.0"
+    "lecodes-renderer": "^0.4.1"
   },
   "peerDependenciesMeta": {
     "lecodes-design": {
@@ -43,7 +44,7 @@
   },
   "devDependencies": {
     "lecodes-design": "workspace:*",
-    "lecodes-renderer": "workspace:*",
+    "lecodes-renderer": "^0.4.1",
     "sdk": "workspace:*"
   }
 }

package/runtime/sdk/canvas/Canvas.ts

@@ -21,7 +21,8 @@
 //   new Sprite({ texture: c })          // Canvas is a valid texture source everywhere
 
 import { Texture2D } from "../g2/Texture2D"
-import { File } from "../runtime/fetch"
+import { File, type FetchResponse } from "../runtime/fetch"
+import type { SvgSourceValue } from "../runtime/misc"
 
 // Opcodes — MUST stay in sync with docs/canvas-contract.md.
 const OP = {
@@ -167,6 +168,24 @@ export class Canvas {
     return this
   }
 
+  /** Decode an image source into a standalone `Bitmap` you can blit with `drawImage()` — either an
+   *  `SvgSource(...)` (rasterized) or a `FetchResponse` holding already-fetched image bytes (decoded).
+   *  This is async because turning SVG markup / encoded bytes into pixels needs a decode step (on the
+   *  web, `createImageBitmap` / an `<img>` load); `await` it ONCE, then `drawImage(bitmap, …)` is
+   *  synchronous and the Bitmap is reusable. The returned Bitmap owns a native surface at the image's
+   *  natural pixel size (`pixelRatio` 1) — `destroy()` it when done. Typical use:
+   *    const logo = await canvas.loadImage(SvgSource(svg))   // or: await fetch(url) → the response
+   *    canvas.drawImage(logo, 0, 0)                          // sync, blit as often as you like */
+  loadImage(source: SvgSourceValue | FetchResponse): Promise<Bitmap> {
+    // Discriminate without touching FetchResponse internals: only an SvgSource carries `.svg`.
+    const isSvg = typeof (source as SvgSourceValue).svg === "string"
+    const svg = isSvg ? (source as SvgSourceValue).svg : ""
+    const bufferId = isSvg ? -1 : (source as any)._id   // <0 = the SVG path; else the host buffer id
+    return new Promise<Bitmap>((res, rej) => {
+      _creatorCanvas.loadImage(svg, bufferId, (surfaceId, w, h) => res(new Bitmap(surfaceId, w, h, 1)), rej)
+    })
+  }
+
   /** Measure `text` in the current font on THIS platform. The one synchronous round-trip. */
   measureText(text: string): CanvasTextMetrics {
     const o = _creatorCanvas.measureText(text, this._font)

package/runtime/sdk/compile/compileProject.ts

@@ -31,6 +31,11 @@ export type CompileOptions = {
   icon?: string
   /** "esm" (default, shipped) or "iife" (self-running, for the local renderer). */
   format?: "esm" | "iife"
+  /** Resolve `asset()` resources to a LOCAL host asset at runtime instead of a `publicUrl` URL: each
+   *  resource compiles to `"id:" + _creatorUtils.fetchLocal(<name>)` (the host reads the file by name
+   *  and returns its systemId). For hosts with no asset server (the desktop native host), where a URL
+   *  can't be fetched. Off by default — the shipped/web build keeps the URL form. */
+  localAssets?: boolean
 }
 
 /** The default entrypoint: the largest top-level .ts/.js file with no `export` (a script entry). */
@@ -55,7 +60,14 @@ export const compileProject = async (opts: CompileOptions): Promise<string> => {
   const files: Record<string, string> = {}
   for (const e of opts.entries) {
     if (e.type === "resource") {
-      files[e.path] = `export default "${opts.publicUrl}${e.fileSrc ?? ""}"`
+      if (opts.localAssets) {
+        // The host resolves the asset by name at runtime (reads the local file → systemId); the
+        // "id:" prefix is the host's local-resource URL scheme (parsed by the UI + 2D texture paths).
+        const name = e.path.split(/[\\/]/).pop() ?? e.path
+        files[e.path] = `export default ("id:" + _creatorUtils.fetchLocal(${JSON.stringify(name)}))`
+      } else {
+        files[e.path] = `export default "${opts.publicUrl}${e.fileSrc ?? ""}"`
+      }
     } else if (e.type === "shader") {
       const shaders = e.shaders ?? []
       if (shaders.length > 2) {