lecodes-sdk 1.2.0 → 2.0.1

package/src/gl/animation/Locomotion.ts

@@ -206,7 +206,7 @@ export type StopCandidate = {
 
 const STOP_ROW = 9
 const STOP_ROWS = 8
-const IN = { DIR_X: 0, DIR_Z: 1, MAG: 2, FACE_X: 3, FACE_Z: 4, GAIT: 5, ACT_SEQ: 6, ACT_SLOT: 7, ACT_DIR_X: 8, ACT_DIR_Z: 9, ACT_ANGLE: 10, ACT_TURN: 11, ACT_AT: 12, ACT_EXIT: 13, ACT_FADE: 14, ACT_RATE: 15, ACT_OUT: 16, ACT_TRAVEL: 17, ACT_TRAVEL_AT: 18, ACT_TRAVEL_AFTER: 19, STRAFE: 20, COUNT: 21 }
+const IN = { DIR_X: 0, DIR_Z: 1, MAG: 2, FACE_X: 3, FACE_Z: 4, GAIT: 5, ACT_SEQ: 6, ACT_SLOT: 7, ACT_DIR_X: 8, ACT_DIR_Z: 9, ACT_ANGLE: 10, ACT_TURN: 11, ACT_AT: 12, ACT_EXIT: 13, ACT_FADE: 14, ACT_RATE: 15, ACT_OUT: 16, ACT_TRAVEL: 17, ACT_TRAVEL_AT: 18, ACT_TRAVEL_AFTER: 19, STRAFE: 20, ACT_DASH: 21, ACT_DASH_TIME: 22, COUNT: 23 }
 const OUT = { STATE: 0, SPEED: 1, VEL_X: 2, VEL_Y: 3, VEL_Z: 4, YAW: 5, YAW_RATE: 6, PHASE: 7, SEQ: 8, PRED: 9, YAW_LEFT: 21, CLIP_TIME: 22, EXIT_AT: 23, STOP_OFF: 24, STOP_STEPS: 25, STOP_WAIT: 26, COUNT: 27 }
 const P = {
   HALFLIFE_WALK: 0, HALFLIFE_RUN: 1, HALFLIFE_FACING: 2, SPEED_WALK: 3, SPEED_RUN: 4, SPEED_SPRINT: 5,
@@ -423,7 +423,10 @@ export class Locomotion extends Aspect<"loco", Node, LocomotionEvents> {
    *  stay, the time changes), `travel` takes only that share of its recorded travel (an attack aimed at a target:
    *  0.3 to stop at the blade's length from one that is close, 1.3 to reach one a step too far — the pose is
    *  untouched, so keep it to a fast step; `{ share, at, after }` takes another share from clip time `at` on: a
-   *  swing's take travels on after its cut, into a body that stands at the blade's length), `fade` is the transition into it and `out` the one out of it (default: the tuning's
+   *  swing's take travels on after its cut, into a body that stands at the blade's length), `dash` THROWS the body
+   *  `distance` metres along the action's direction on top of that, inside `time` seconds (default 0.12) from its first
+   *  step, eased out — the gap to a target closed in the wind-up, the blow struck from where it lands (scaling a take's
+   *  own step is a slide stretched over the whole swing), `fade` is the transition into it and `out` the one out of it (default: the tuning's
    *  `blend`; an action ends in ITS stance, not the idle's, and a longer way out is what hides that), and `exit` is the
    *  clip time from which a MOVE intent may take over — the cancel window: along the way the body faces at once, a
    *  heading that needs a turn as soon as the body has slowed to where a start can answer; with nothing asked for it plays out, to
@@ -431,7 +434,7 @@ export class Locomotion extends Aspect<"loco", Node, LocomotionEvents> {
    *  the facing intent that outlives a released key is not a demand after an action — no turn on the spot.
    *  WHEN an action may be asked for (out of another one, out of a start) is the caller's rule: this cuts into
    *  whatever shows. `state` reads `'action'` while it does. False = no such clip. */
-  act(clip: string, options: { direction?: Vec3Like | number, angle?: number, turn?: number, at?: number, exit?: number, fade?: number, out?: number, rate?: number, travel?: number | { share: number, at: number, after: number } } = {}): boolean {
+  act(clip: string, options: { direction?: Vec3Like | number, angle?: number, turn?: number, at?: number, exit?: number, fade?: number, out?: number, rate?: number, travel?: number | { share: number, at: number, after: number }, dash?: { distance: number, time?: number } } = {}): boolean {
     const anim = this.anim
     if (!anim || !this._loco) return false
     const slot = anim._slot(clip)
@@ -455,6 +458,8 @@ export class Locomotion extends Aspect<"loco", Node, LocomotionEvents> {
     i[IN.ACT_TRAVEL] = typeof tr === "number" ? tr : tr?.share ?? 0
     i[IN.ACT_TRAVEL_AT] = typeof tr === "object" ? tr.at : 0
     i[IN.ACT_TRAVEL_AFTER] = typeof tr === "object" ? tr.after : 0
+    i[IN.ACT_DASH] = options.dash?.distance ?? 0
+    i[IN.ACT_DASH_TIME] = options.dash?.time ?? 0.12
     return true
   }
 

package/src/gl/nav/NavMesh.ts

@@ -185,8 +185,7 @@ export class NavMesh {
     try {
       const resp = await fetch(opts.data, { useOnce: true })
       if (resp.status >= 400) { console.warn(`NavMesh: no navmesh at ${opts.data} (HTTP ${resp.status}) — run \`lecodes navmesh bake\``); return null }
-      id = _creatorNav.load((resp as unknown as { _id: number })._id)
-      resp.dispose()
+      id = _creatorNav.load((resp as unknown as { _h: Handle })._h.id)
     } catch (e) {
       console.warn(`NavMesh: could not read ${opts.data}: ${String(e)}`)
       return null
@@ -275,7 +274,7 @@ export class NavMesh {
     const e = opts?.extents
     const max = Math.min(opts?.maxCorners ?? 256, 256)
     const n = _creatorNav.findPath(this.id, cx(from), cy(from), cz(from), cx(to), cy(to), cz(to),
-      e ? cx(e) : 0, e ? cy(e) : 0, e ? cz(e) : 0, inc, exc, max, pathScratch)
+      e ? cx(e) : 0, e ? cy(e) : 0, e ? cz(e) : 0, inc, exc, max < 256 ? pathScratch.subarray(0, max * 3) : pathScratch)
     const count = Math.abs(n)
     for (let i = 0; i < count; i++) path.push(new Vec3(pathScratch[i * 3]!, pathScratch[i * 3 + 1]!, pathScratch[i * 3 + 2]!))
     path.partial = n < 0
@@ -370,7 +369,7 @@ export class NavMesh {
     if (NavMesh.baked) { console.log("[navmesh] a second NavMesh.load — skipped (one bake per run; use --entry per scene)"); return }
     NavMesh.baked = true
     if (!_creator.physicsStaticGeometry) {
-      console.error("[navmesh] error: this host cannot dump collision geometry (build the desktop host from packages/desktop, or update: lecodes desktop update)")
+      console.error("[navmesh] error: this host cannot dump collision geometry (build the desktop host from hosts/desktop, or update: lecodes desktop update)")
       return
     }
     const areaIds = NavMesh.areaIds(opts.areas)

package/src/gl/physics/Physics.ts

@@ -15,7 +15,7 @@ import { Aspect } from "../../core/Aspect"
 import type { FieldMeta } from "../../core/fields"
 import type { CompAxis, CompWriter } from "../../core/compWrite"
 import { Vec3, cx, cy, cz, type Vec3Like } from "../../math/vec"
-import { nodeRegistry, type Node } from "../Node"
+import { nodes, type Node } from "../Node"
 import { Shape } from "./Shape"
 
 export type MotionType = "static" | "dynamic" | "kinematic"
@@ -220,7 +220,7 @@ export class Physics extends Aspect<"physics", Node> implements CompWriter {
     const id = _creator.physicsRaycast(cx(origin), cy(origin), cz(origin), cx(dir), cy(dir), cz(dir), maxDist, out)
     if (!id) return null
     return {
-      node: nodeRegistry.get(id) ?? null,
+      node: nodes.get(id) ?? null,
       point: new Vec3(out[0], out[1], out[2]),
       normal: new Vec3(out[3], out[4], out[5]),
       fraction: out[6],

package/src/gl/physics/physicsEvents.ts

@@ -2,7 +2,7 @@
 // is delivered to BOTH nodes with the other as the argument. type: 0 = enter (contact/overlap began),
 // 1 = exit (ended). Registered lazily on the first trigger/physics body or 'enter'/'exit' listener.
 
-import { nodeRegistry } from "../Node"
+import { nodes } from "../Node"
 
 let registered = false
 export const ensurePhysicsEvents = (): void => {
@@ -10,8 +10,8 @@ export const ensurePhysicsEvents = (): void => {
   if (!_creator.setOnPhysicsEvent) return // physics-less build / bridge without the hook
   registered = true
   _creator.setOnPhysicsEvent((a, b, type) => {
-    const na = nodeRegistry.get(a)
-    const nb = nodeRegistry.get(b)
+    const na = nodes.get(a)
+    const nb = nodes.get(b)
     if (!na || !nb) return
     const channel = type === 1 ? "exit" : "enter"
     na._emitCollision(channel, nb)