lecodes-cli 0.19.0 → 0.20.0

package/runtime/sdk/g2/SpriteSheet.ts

@@ -1,166 +0,0 @@
-// Sprite sheets as data: one `.sprite.ts` file per image, `export default defineSpriteSheet({...})`.
-// ONE model: every named entry is a region of the image (a rect), optionally SLICED into an
-// animation grid, optionally carrying named clips over that grid — so game code (and the scene
-// editor) reference frames by NAME and never hardcode rects:
-//
-//   import props from './props.sprite'
-//   import hero from './hero.sprite'
-//   scene.add(props.make('tree_orange', { position: [80, 144], layer: 1 }))
-//   scene.add(props.make('water', { position: [0, 0] }))            // sliced, loops on its own
-//   const player = hero.make('hero', { clip: 'idle', layer: 1 })
-//   player.anim.play('walk', inputVector)
-//
-// A sheet describes ART only — rects, slices, clips, anchors. World semantics (colliders, bodies)
-// are the SCENE's job: attach Shape2D / Physics2D / Trigger2D aspects to the placed node (a
-// `.scene2d.ts` `aspects:` list, or `.aspect(...)` in code). Each tool owns its own part.
-//
-// The texture loads lazily on the first make()/load(); sprites created before it resolves get their
-// texture/frame applied on arrival (the world size is known up front from the rect / slice cell, so
-// layout doesn't wait). The sprite editor reads and writes these files — hand edits are preserved
-// (see packages/scene-doc).
-
-import { type Vec2Like } from "../math/vec"
-import { Sprite } from "./Sprite"
-import { SpriteAnimation, type Clip } from "./SpriteAnimation"
-import { Texture2D } from "./Texture2D"
-
-/**
- * A named region of the image. Just a rect is a static sprite; `slice` subdivides the rect into an
- * animation grid ([cols, rows] — the cell is rect size / counts); `clips` names frame runs over
- * that grid (local, row-major). A sliced entry with NO clips loops all of its cells in order.
- */
-export type SheetSprite = {
-  /** Pixel rect [x, y, w, h] in the image. */
-  rect?: [number, number, number, number]
-  /** Subdivide the rect into an animation grid: [cols, rows]. */
-  slice?: [number, number]
-  /** Playback fps for this sprite's animation (defaults to the sheet fps, then 12). */
-  fps?: number
-  /** Named clips over the local grid (see SpriteAnimation). Omit to loop every cell. */
-  clips?: Record<string, Clip>
-  /** Facing names in local-row order for `perDirection` clips (compass tokens: S/SE/E/…). */
-  directions?: string[]
-  /** Overrides the sheet anchor. */
-  anchor?: Vec2Like
-}
-
-export type SpriteSheetDef = {
-  /** The image URL — write `asset('./sheet.png')`. */
-  image: string
-  /** Default pivot for every sprite made from this sheet ([0.5, 1] = feet, for Y-sorted worlds). */
-  anchor?: Vec2Like
-  /** Default fps for sliced sprites / clips that don't override it. */
-  fps?: number
-  /** The named sprites. */
-  sprites?: Record<string, SheetSprite>
-}
-
-export type SpriteMakeOptions = {
-  position?: Vec2Like
-  layer?: number
-  /** Overrides the sheet/sprite anchor. */
-  anchor?: Vec2Like
-  /** Start this clip immediately (sliced sprites with clips). */
-  clip?: string
-  /** Initial facing for `perDirection` clips. */
-  direction?: string
-}
-
-/** The name a sliced-but-clipless sprite's implicit everything-loop plays under. */
-const LOOP_ALL = "all"
-
-export class SpriteSheet {
-  private _def: SpriteSheetDef
-  private _tex: Texture2D | null = null
-  private _loading: Promise<Texture2D> | null = null
-
-  constructor(def: SpriteSheetDef) {
-    this._def = def
-  }
-
-  /** The sheet definition (read-only by convention — the editor owns the file). */
-  get def(): SpriteSheetDef { return this._def }
-
-  /** The loaded texture, or null before load() resolves. */
-  get texture(): Texture2D | null { return this._tex }
-
-  /** Load the sheet's texture (idempotent). make() starts this automatically. */
-  load(): Promise<Texture2D> {
-    if (!this._loading) {
-      this._loading = Texture2D.load(this._def.image).then((tex) => { this._tex = tex; return tex })
-    }
-    return this._loading
-  }
-
-  /** Names of the sheet's sprites. */
-  get spriteNames(): string[] { return Object.keys(this._def.sprites ?? {}) }
-
-  /** Build a named sprite; starting a clip hands back the animation handle. */
-  make(name: string, opts: SpriteMakeOptions & { clip: string }): Sprite & { anim: SpriteAnimation }
-  make(name: string, opts?: SpriteMakeOptions): Sprite
-  make(name: string, opts: SpriteMakeOptions = {}): Sprite {
-    const def = this._def
-    const named = def.sprites?.[name]
-    if (!named) {
-      throw new Error(`SpriteSheet.make(): unknown sprite "${name}" (have: ${this.spriteNames.join(", ") || "none"})`)
-    }
-    const rect = named.rect
-    const slice = named.slice
-
-    const sprite = new Sprite({
-      anchor: opts.anchor ?? named.anchor ?? def.anchor,
-      layer: opts.layer,
-      position: opts.position,
-    })
-
-    // The world size is known without the texture (the rect, or its slice cell) — set it up front
-    // so layout, Y-sort and colliders are correct even while the image is still loading.
-    if (rect) sprite.size = slice ? [ rect[2] / slice[0], rect[3] / slice[1] ] : [ rect[2], rect[3] ]
-
-    // sliced sprite: all animation flows through SpriteAnimation, anchored at the rect's origin.
-    // No clips declared = one implicit clip looping every cell (animated tiles).
-    if (rect && slice) {
-      const [ cols, rows ] = slice
-      const clips = named.clips && Object.keys(named.clips).length > 0
-        ? named.clips
-        : { [LOOP_ALL]: Array.from({ length: cols * rows }, (_, i) => i) }
-      const animOpts: Partial<SpriteAnimation> = {
-        size: [ rect[2] / cols, rect[3] / rows ],
-        cols,
-        origin: [ rect[0], rect[1] ],
-        clips,
-      }
-      const fps = named.fps ?? def.fps
-      if (fps !== undefined) animOpts.fps = fps
-      if (named.directions) animOpts.directions = named.directions
-      sprite.aspect(SpriteAnimation, animOpts)
-      const start = opts.clip ?? (named.clips ? undefined : LOOP_ALL)
-      if (start) (sprite as Sprite & { anim: SpriteAnimation }).anim.play(start, opts.direction)
-    }
-
-    // texture + frame: now if loaded, else on arrival
-    if (this._tex) this._applyTexture(sprite, named, this._tex)
-    else this.load().then((tex) => this._applyTexture(sprite, named, tex))
-    return sprite
-  }
-
-  /** The pixel rect [x, y, w, h] of a named sprite's REGION (the whole rect, sliced or not). */
-  rectOf(name: string): [number, number, number, number] | null {
-    const rect = this._def.sprites?.[name]?.rect
-    return rect ? [ ...rect ] : null
-  }
-
-  private _applyTexture(sprite: Sprite, named: SheetSprite, tex: Texture2D): void {
-    sprite.texture = tex // native resets UV/size; the Sprite setter re-applies our explicit size
-    const rect = named.rect
-    if (rect) {
-      const [ cw, ch ] = named.slice ? [ rect[2] / named.slice[0], rect[3] / named.slice[1] ] : [ rect[2], rect[3] ]
-      sprite.setFramePx(rect[0], rect[1], cw, ch) // cell 0 (or the whole static rect)
-    }
-    const anim = (sprite as Partial<{ anim: SpriteAnimation }>).anim
-    if (anim) anim.define()
-  }
-}
-
-/** Declare a sprite sheet (the default export of a `.sprite.ts` file). */
-export const defineSpriteSheet = (def: SpriteSheetDef): SpriteSheet => new SpriteSheet(def)

package/runtime/sdk/g2/Texture2D.ts

@@ -1,47 +0,0 @@
-// A GPU texture decoded natively by creator-2d (stb_image). Load from a URL (or an already-fetched
-// response); the raw file bytes are handed to the engine, which decodes + uploads them.
-
-// Internal SDK code imports injected globals explicitly (the bare-global inject is only for USER
-// code; here `fetch` would otherwise resolve to the node/bun ambient one).
-import { fetch, type FetchResponse, type File } from "../runtime/fetch"
-
-export class Texture2D {
-  /** Native texture handle. */
-  readonly id: number
-  readonly width: number
-  readonly height: number
-
-  constructor(id: number, width: number, height: number) {
-    this.id = id
-    this.width = width
-    this.height = height
-  }
-
-  // Wrap a Canvas's baked surface as a texture (RGBA8, already rasterized → synchronous, no decode).
-  // Structural type avoids a Canvas import cycle (Canvas imports Texture2D).
-  static fromCanvas(canvas: { _bakeSurface(): number, width: number, height: number, pixelRatio: number }): Texture2D {
-    const surfaceId = canvas._bakeSurface()
-    const texId = _creator2d.createTextureFromCanvas(surfaceId)
-    return new Texture2D(texId, Math.round(canvas.width * canvas.pixelRatio), Math.round(canvas.height * canvas.pixelRatio))
-  }
-
-  // Accepts a URL, an already-fetched response, or a File (e.g. from Canvas.toFile() / openFilePicker) —
-  // anything backed by a host buffer. The buffer's encoded bytes are decoded + uploaded by the engine.
-  static load(source: string | FetchResponse | File): Promise<Texture2D> {
-    if (typeof source === "string") {
-      return fetch(source, { useOnce: true }).then((resp) => {
-        if (resp.status >= 400) {
-          return Promise.reject(new Error(`Failed to fetch texture from ${source}. HTTP ${resp.status}`))
-        }
-        return Texture2D.load(resp)
-      })
-    }
-    return new Promise<Texture2D>((resolve, reject) => {
-      _creator2d.createTexture((source as any)._id, (id, w, h) => resolve(new Texture2D(id, w, h)), reject)
-    })
-  }
-
-  destroy(): void {
-    _creator2d.destroyTexture(this.id)
-  }
-}

package/runtime/sdk/g2/Tilemap.ts

@@ -1,41 +0,0 @@
-// A tilemap node. The grid is uploaded once and rendered natively with per-frame view culling; the
-// node's position is the bottom-left of the map. Edit cells with setTile.
-
-import { Node2D } from "./Node2D"
-import type { Texture2D } from "./Texture2D"
-
-export type TilemapOptions = {
-  texture: Texture2D
-  /** Map grid size (in tiles). */
-  cols: number
-  rows: number
-  /** On-screen cell size in world units — a single number (square) or [w, h]. */
-  tile: number | [number, number]
-  /** Atlas grid: how the texture is sliced into tiles, [atlasCols, atlasRows]. */
-  atlas: [number, number]
-  /** Row-major tile indices into the atlas (-1 = empty), length cols*rows. Row 0 is the top row. */
-  data: number[] | Int32Array
-}
-
-export class Tilemap extends Node2D {
-  readonly cols: number
-  readonly rows: number
-
-  constructor(options: TilemapOptions) {
-    const data = options.data instanceof Int32Array ? options.data : Int32Array.from(options.data)
-    const tileW = typeof options.tile === "number" ? options.tile : options.tile[0]
-    const tileH = typeof options.tile === "number" ? options.tile : options.tile[1]
-    const [ atlasCols, atlasRows ] = options.atlas
-    const id = _creator2d.createTilemap(
-      options.texture.id, options.cols, options.rows, tileW, tileH, atlasCols, atlasRows, data,
-    )
-    super(id) // wrap the native tilemap entity
-    this.cols = options.cols
-    this.rows = options.rows
-  }
-
-  setTile(x: number, y: number, index: number): this {
-    _creator2d.setTile(this.id, x, y, index)
-    return this
-  }
-}

package/runtime/sdk/g2/Tileset.ts

@@ -1,71 +0,0 @@
-// Tilesets as data: one `.tiles.ts` file per atlas, `export default defineTileset({...})` — the
-// material vocabulary (autotile rules) for maps painted by material id. The pure model + deriver
-// live in ./autotile.ts; this file is the runtime handle plus the `Autotile2D` aspect that binds a
-// tilemap node to its tileset:
-//
-//   // world.tiles.ts
-//   export default defineTileset({
-//     image: asset('./TileSet.png'),
-//     tile: 32,
-//     materials: {
-//       grass: { id: 1, kind: 'patch', color: '#4a7c3a', fill: [261, [262, 0.1]],
-//                over: { '*': { edges: [197, 262, 325, 260], outer: [198, 326, 324, 196],
-//                               inner: [199, 327, 391, 263] } } },
-//       road:  { id: 2, kind: 'path', color: '#8a8578', straights: [520, 521], corners: [522, 523, 524, 525] },
-//     },
-//   })
-//
-//   // meadow.scene2d.ts
-//   import world from './world.tiles'
-//   ground: { tilemap: { texture: asset('./TileSet.png'), tile: 32, atlas: [64, 64],
-//                        cells: cells('…') },              // cells hold MATERIAL ids here
-//             aspects: [use(Autotile2D, { tileset: world, seed: 3 })] }
-//
-// The aspect flips the meaning of the same `cells('…')` payload from raw atlas indices to material
-// ids; the scene2d loader runs the deriver BEFORE the Tilemap is constructed (aspects are data on
-// the node def), so no post-construction data path exists and derived indices are never persisted.
-
-import { Aspect } from "../core/Aspect"
-import type { Node2D } from "./Node2D"
-import { deriveCells, type TilesetDef, type TileMaterial } from "./autotile"
-
-export class Tileset {
-  private _def: TilesetDef
-
-  constructor(def: TilesetDef) { this._def = def }
-
-  /** The tileset definition (read-only by convention — the editor owns the file). */
-  get def(): TilesetDef { return this._def }
-
-  /** Names of the declared materials, in file order. */
-  get materialNames(): string[] { return Object.keys(this._def.materials ?? {}) }
-
-  /** A material by name. */
-  material(name: string): TileMaterial | undefined { return this._def.materials?.[name] }
-
-  /** The cell value maps store for a named material (what you paint / pass in `data`). */
-  id(name: string): number | undefined { return this._def.materials?.[name]?.id }
-
-  /** Derive display atlas indices from a material-id grid (what Autotile2D does at load). */
-  derive(cols: number, rows: number, data: ArrayLike<number>, seed = 0): Int32Array {
-    return deriveCells(this._def, cols, rows, data, seed)
-  }
-}
-
-/** Declare a tileset (the default export of a `.tiles.ts` file). */
-export const defineTileset = (def: TilesetDef): Tileset => new Tileset(def)
-
-/**
- * Marks a tilemap node's `cells` as MATERIAL ids of a tileset instead of raw atlas indices:
- * `aspects: [use(Autotile2D, { tileset: world })]`. The scene2d loader derives the display
- * indices (neighbor-mask autotile + seeded scatter, deterministic) before building the tilemap;
- * the aspect itself holds no behavior. Change `seed` to reshuffle scatter variants.
- */
-export class Autotile2D extends Aspect<"autotile", Node2D> {
-  static readonly aspect = "autotile"
-
-  /** The imported `.tiles.ts` handle. */
-  tileset: Tileset | null = null
-  /** Scatter seed — same seed, same map, same result on every platform. */
-  seed = 0
-}

package/runtime/sdk/g2/Trigger2D.ts

@@ -1,77 +0,0 @@
-// A trigger zone, as an aspect on a Node2D. Requires a Shape2D (its geometry); creates a SENSOR body
-// from it, so a physics body overlapping the zone fires the node's 'enter' / 'exit' events instead of
-// colliding. A trigger does not block movement.
-//
-//   const goal = new Node2D()
-//     .aspect(Shape2D, { box: [32, 64] })
-//     .aspect(Trigger2D)
-//   goal.addEventListener('enter', other => win(other))
-//   goal.position = [x, y]        // the zone follows — it is kinematic, not static
-//   goal.trigger.enabled = false  // switch it off instead of parking it off-screen
-//
-// (A trigger is still pointer-pickable — clicks hit sensor shapes too.)
-//
-// Keep triggers on ROOT nodes: a sensor parented to a moving node does not follow it (see
-// docs/2d-physics-plan.md §6).
-
-import { Aspect } from "../core/Aspect"
-import { ensurePhysicsEvents } from "./loop"
-import { Shape2D } from "./Shape2D"
-import { PhysicsGroup2D, _watchGroupChanges, _unwatchGroupChanges, categoryOf, sensorMask } from "./groups2d"
-import type { Node2D } from "./Node2D"
-
-export class Trigger2D extends Aspect<"trigger", Node2D> {
-  static readonly aspect = "trigger"
-
-  private _h = 0
-  private _enabled = true
-  private _group: PhysicsGroup2D | undefined
-  private _repush = (): void => {
-    if (this._h) _creator2d.physicsSetFilter(this._h, categoryOf(this._group), sensorMask(this._group))
-  }
-
-  /** Which collision group this zone belongs to. Live. */
-  get group(): PhysicsGroup2D | undefined { return this._group }
-  set group(g: PhysicsGroup2D | undefined) {
-    this._group = g
-    this.node.get(Shape2D)?._setFilter(categoryOf(g), sensorMask(g))
-    this._repush()
-  }
-
-  /** Native physics body id (0 if no physics support). Mirrors 3D `Trigger.id`. */
-  get id(): number { return this._h }
-
-  onAttach(): void {
-    if (!_creator2d.physicsHasSupport || !_creator2d.physicsHasSupport()) return
-    const shape = this.node.get(Shape2D)
-    if (!shape) {
-      throw new Error("Trigger2D requires a Shape2D aspect — add it first: node.aspect(Shape2D, {…}).aspect(Trigger2D)")
-    }
-    // KINEMATIC, not static: a zone has to be able to ride an elevator, a patrolling enemy or a
-    // fighter's fist. It used to be static, which is why games parked spent triggers at [-9999,-9999].
-    this._h = _creator2d.physicsCreateBody(this.node.id, 1 /* kinematic */)
-    if (!this._h) return
-    // sensorMask always keeps the character bit: a kinematic mover is not a Box2D body, so its shadow
-    // body is what triggers actually see, and no game should have to know that.
-    shape._addTo(this._h, { sensor: true, friction: 0, bounce: 0, category: categoryOf(this.group), mask: sensorMask(this.group) })
-    if (this._group) _watchGroupChanges(this._repush)
-    this.node._xf = this._h        // node.position moves the zone
-    this.node._xfKind = 2
-    if (!this.enabled) _creator2d.physicsSetEnabled(this._h, false)   // via the accessor on purpose — see Physics2D.onAttach
-    ensurePhysicsEvents()   // routes contact/sensor events → the node's 'enter' / 'exit'
-  }
-
-  onDetach(): void {
-    _unwatchGroupChanges(this._repush)
-    if (this._h) { _creator2d.physicsRemoveBody(this._h); this._h = 0 }
-    this.node._xf = 0
-    this.node._xfKind = 0
-  }
-
-  /** Switch the zone off and on — a spent pickup, a hitbox that is only live during a swing. */
-  get enabled(): boolean { return this._enabled }
-  set enabled(v: boolean) {
-    this._enabled = v
-    if (this._h) _creator2d.physicsSetEnabled(this._h, v)
-  }
-}