lecodes-sdk 1.2.0 → 2.0.1

package/package.json

@@ -8,12 +8,20 @@
     "./compile/detectEntry": "./src/compile/detectEntry.ts",
     "./compile/shaderSchema": "./src/compile/shaderSchema.ts",
     "./compile/liteMaterial": "./src/compile/liteMaterial.ts",
+    "./color": "./src/core/color.ts",
     "./inject": "./src/inject.ts",
+    "./plugin": "./src/plugin.ts",
     "./server": "./src/server/host.ts",
     "./prompts/select": "./prompts/select.ts",
     "./global.d.ts": "./dist/global.d.ts",
     "./host.d.ts": "./dist/host.d.ts",
-    "./types.json": "./dist/types.json"
+    "./editor.d.ts": "./dist/editor.d.ts",
+    "./types.json": "./dist/types.json",
+    "./bridges/*": "./src/bridges/*.d.ts",
+    "./ui/tree": "./src/ui/tree.ts",
+    "./testing": "./tests/helpers/index.ts",
+    "./testing/preload": "./tests/helpers/preload.ts",
+    "./version": "./src/version.ts"
   },
   "scripts": {
     "build": "bun run build-types.ts",
@@ -25,7 +33,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@letary/chisel": "^0.10.0"
+    "@letary/chisel": "^0.13.0"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",
@@ -33,11 +41,12 @@
     "typescript": "~5.8.3",
     "gl-matrix": "^3.4.4"
   },
-  "version": "1.2.0",
+  "version": "2.0.1",
   "files": [
     "src",
     "dist",
     "prompts",
+    "tests/helpers",
     "README.md"
   ],
   "publishConfig": {

package/prompts/2d.md

@@ -5,7 +5,7 @@ Scene2D + nodes (Sprite, Tilemap) + aspects (SpriteAnimation, Shape2D/Physics2D/
 // ===== SCENE & NODES =====
 
 new Scene2D(options?: {
-  background?: Color   // clear color (hex string or 0xRRGGBB); settable later via scene.background
+  background?: Color   // clear color (any CSS color or 0xRRGGBB); settable later via scene.background
   filter?: 'nearest' | 'linear'  // texture sampling; default nearest (crisp pixel art), 'linear' for hi-res
 })   // art. filter is GLOBAL (one sampler for all textures), re-applied on open()
 
@@ -63,7 +63,7 @@ new Sprite(options?: {
                       // [0.5, 1] = bottom-center = "feet" — use on Y-sorted layers
   size?: Vec2Like   // world size; default = texture pixel dims (1 texel = 1 world unit)
   frame?: [u0, v0, u1, v1]   // normalized UV sub-rect
-  color?: Color   // tint MULTIPLIED with the texture; hex/packed only (default white = untinted)
+  color?: Color   // tint MULTIPLIED with the texture (default white = untinted)
   opacity?: number   // 0..1
   layer?: number
   position?: Vec2Like
@@ -259,10 +259,6 @@ sprite.aspect(Shape2D, { box: [12, 20] })   // ✅ declare the extents you want
 setLoop(() => sprite.setFramePx(...))   // WRONG
 sprite.aspect(SpriteAnimation, { size: [32, 48], clips: { walk: [0,1,2,3] } })   // ✅ then anim.play('walk')
 
-// ❌ CSS color strings on sprites — engine colors are hex/packed only (Canvas fillStyle is the exception)
-sprite.color = 'rgba(255,0,0,0.5)'   // WRONG
-sprite.color = '#ff0000'; sprite.opacity = 0.5   // ✅
-
 // ❌ attaching SpriteAnimation before the sprite has a texture — throws (the grid slices from it)
 // ❌ attaching Physics2D before Shape2D on the same node — throws (attach the shape first)
 // ❌ setting spawn position AFTER attaching Physics2D — the body already seeded from [0,0]; position first

package/prompts/3d.md

@@ -86,7 +86,7 @@ material.map = tex                         // Texture | Canvas | null
 
 // Custom compiled shaders (.mat files) — load, then set uniforms by name (chainable):
 const mat = new Material(await fetch(asset('./hologram.mat'), { useOnce: true }))
-    .set('baseColor', '#ffa200')           // '#rrggbb' / '#rrggbbaa' hex STRINGS only
+    .set('baseColor', '#ffa200')           // color STRINGS only (any CSS color); a number is a float
     .set('roughness', 0.54)                // number → float, boolean → bool
     .set('glowMap', tex)                   // Texture → sampler
     .set('dir', [0, 1, 0])                 // number[] / Float32Array → vector. NOT a Vec3 — spread it: [...v]
@@ -294,10 +294,6 @@ mat.set('lightDir', dir)
 Light.point(...)
 // ✅ Light.sun() + scene IBL is the whole lighting model; fake glows with unlit/bloom/particles
 
-// ❌ rgba()/named colors in 3D APIs — silently black
-Material.lit({ color: 'rgba(255, 0, 0, 0.5)' })
-// ✅ hex string or packed int: '#ff0000' / '#ff000080' / 0xff0000
-
 // ❌ a fresh Material per frame (or per particle) to animate a look
 setLoop(() => { mesh.material = Material.lit({ color: next() }) })
 // ✅ mutate the one material: mesh.material.color = next()  /  mat.set('progress', t)

package/prompts/README.md

@@ -137,6 +137,6 @@ escalation directive (above) lets it swap in the right engine module instead of
   `docs/check.mjs`. When a global is added, update docs, then the module, then index.md.
 - Known corrections baked into these prompts (do not regress; see `docs/AUTHORING.md`):
   `onEndReached(thresholdPx, cb)` (threshold first), `bgSize: cover|contain|tile` (no `fill`),
-  track `deltaX/deltaY` are per-move, engine colors are hex/packed-int only, `animate` can't
+  track `deltaX/deltaY` are per-move, colors are CSS strings / 0xRRGGBB / [r,g,b(,a)] everywhere, `animate` can't
   tween strings/colors, `node.physics` (not `.body`), no `Camera2D.follow`, no
   `UIScrollable.scrollTo`, models can't be cloned.

package/prompts/canvas.md

@@ -8,20 +8,21 @@ const c = new Canvas(width, height, { pixelRatio: device.pixelRatio })
 // width/height are LOGICAL units — author all drawing logical; pixelRatio only multiplies baked
 // resolution (crispness), never the on-screen size.
 
-c.fillStyle = '#ff8800'   // CSS color STRINGS work here (the exception to engine hex-only colors);
-c.lineCap = 'round'       // also strokeStyle, lineWidth, lineJoin, globalAlpha,
+c.fillStyle = '#ff8800'   // any CSS color string, as everywhere in the SDK;
+c.lineCap = 'round'       // also strokeStyle, lineWidth, lineJoin, miterLimit, globalAlpha, letterSpacing,
+c.setLineDash([4, 2])     // dashes; a gradient: c.fillStyle = c.createLinearGradient(x0,y0,x1,y1).addColorStop(0,'#fff').addColorStop(1,'transparent')
 c.font = 'bold 16px sans-serif'   // textAlign ('left'|'center'|'right'), textBaseline
                                   // custom fonts: draw only AFTER await registerFont(...)
 c.fillRect(x, y, w, h) / c.strokeRect / c.clearRect
-c.beginPath().moveTo(x,y).lineTo(x,y).arc(x,y,r,a0,a1).rect(x,y,w,h).roundRect(x,y,w,h,r).closePath()  // all chain
-c.fill() / c.stroke() / c.fillText(text, x, y) / c.strokeText(text, x, y)
-c.measureText(text): { width, ascent, descent }   // in the CURRENT font, logical px
-c.drawImage(bmp: Bitmap, dx, dy [, dw, dh])   // blits a Bitmap only (from c.toBitmap()), nothing else
+c.beginPath().moveTo(x,y).lineTo(x,y).arc(x,y,r,a0,a1).arcTo(x1,y1,x2,y2,r).ellipse(x,y,rx,ry,rot,a0,a1).rect(x,y,w,h).roundRect(x,y,w,h,r).closePath()  // all chain
+c.fill('evenodd'?) / c.stroke() / c.clip() / c.fillText(text, x, y) / c.strokeText(text, x, y)
+c.measureText(text): { width, ascent, descent }   // in the CURRENT font and letterSpacing, logical px
+c.drawImage(bmp: Bitmap, dx, dy [, dw, dh])   // blits a Bitmap only (c.toBitmap(), await c.loadImage(SvgSource(svg) | fetchResponse))
 
 c.update(): this    // after redrawing, push new pixels to EVERY texture/image this canvas produced
 c.reset(): this     // discard the recorded drawing to start over
 c.resize(w, h): this   // new logical size (takes effect next bake; measure-then-resize works pre-bake)
 c.toBitmap(): Bitmap   // rasterized snapshot, usable with drawImage
-// GOTCHA: reset() clears the recorded STATE too — font/fillStyle/textAlign fall back to defaults on
-// the next bake (getters still report old values). Re-set font & friends after every reset().
+// GOTCHA: reset() clears the recorded STATE too — font/fillStyle/textAlign fall back to defaults
+// (the getters report the defaults again). Re-set font & friends after every reset().
 // Ever-growing drawings: flatten — const snap = c.toBitmap(); c.reset(); c.drawImage(snap, 0, 0)

package/prompts/compose.ts

@@ -1,4 +1,4 @@
-// Compose the prompt bundles from the modules. Run from packages/sdk:
+// Compose the prompt bundles from the modules. Run from sdk:
 //   bun run prompts/compose.ts
 // Writes prompts/dist/<bundle>.md and prints token-ish size stats.
 

package/prompts/core.md

@@ -202,9 +202,9 @@ Mathf.clamp(v, min, max) / .lerp(a, b, t) / .remap(v, inMin, inMax, outMin, outM
 Mathf.damp(a, b, lambda, dt) / .moveTowards(a, b, maxDelta)
 Mathf.random(min, max) / .randomInt(min, max)   // randomInt inclusive both ends
 
-// Colors: hex string "#e33" | "#ff3333" | "#ff3333cc" or packed int 0xff3333.
-// rgba(...) / named colors DON'T work in 2D/3D APIs (silently become black). UI styles are the
-// exception — they also accept rgb()/rgba() and basic names ("white", "black", "transparent", …).
+// Colors (every API, UI and engine alike): any CSS color string ("#e33", "#ff3333cc", "rgb(255 0 0 / 50%)",
+// "hsl(0 100% 50%)", "red" — the CSS names, green = #008000), packed int 0xff3333 (opaque 0xRRGGBB),
+// or [r, g, b(, a)] 0..1. A non-color throws. var(--x) only in UI styles.
 
 // ===== NETWORK =====
 

package/prompts/design.md

@@ -50,7 +50,7 @@ import { colors, spacing, radius } from "./tokens"
 export const PrimaryButton = (label: string, o: { name?: string, disabled?: boolean } = {}) =>
   UIButton(UIText(label).style({ fontSize: 16, fontWeight: 700, color: o.disabled ? colors.muted : colors.onAccent }))
     .style({ height: 52, borderRadius: radius.md, bgColor: o.disabled ? colors.accentDeep : colors.accent,
-             justifyContent: "center", alignItems: "center", name: o.name, onPressed: { bgColor: colors.accentPressed } })
+             justifyContent: "center", alignItems: "center", name: o.name, $pressed: { bgColor: colors.accentPressed } })
 
 export const SectionLabel = (t: string) =>
   UIText(t.toUpperCase()).style({ fontSize: 11, fontWeight: 600, letterSpacing: 2, color: colors.faint })