castle-web-cli 0.4.84 → 0.4.86

package/kits/physics-2d/engine/spriteGeometry.js

@@ -0,0 +1,32 @@
+// Shared sprite-to-Layout geometry. Lives in engine/ (not behaviors/) so both
+// Sprite.jsx (rendering) and the Collider rect logic (engine/collider.js) can
+// use the same math without behaviors/ <-> engine/ import cycles.
+
+// Destination rect for a draw mode: the Layout box for `stretch`/`tile`, or an
+// aspect-ratio-preserving centered rect for `fit` and `cover`:
+//   - `fit` (CSS object-fit: contain): the largest rect with the art's aspect
+//     ratio that fits INSIDE the box -- letterboxed sides just aren't drawn.
+//   - `cover` (CSS object-fit: cover): the smallest rect with the art's aspect
+//     ratio that fully COVERS the box -- the overflow is cropped by the caller
+//     clipping to the Layout box (see Sprite.draw).
+// `artSize` only needs `.width`/`.height` -- a rendered canvas or a sprite's
+// `.resolution` both work.
+export function spriteDestRect(mode, layout, artSize) {
+  if (mode !== 'fit' && mode !== 'cover') return layout;
+  const aspect = artSize.width / artSize.height;
+  let width = layout.width;
+  let height = width / aspect;
+  // `fit` shrinks until the art fits inside the box; `cover` grows until it
+  // fills the box. The comparison flips between the two.
+  const overflows = mode === 'fit' ? height > layout.height : height < layout.height;
+  if (overflows) {
+    height = layout.height;
+    width = height * aspect;
+  }
+  return {
+    x: layout.x + (layout.width - width) / 2,
+    y: layout.y + (layout.height - height) / 2,
+    width,
+    height,
+  };
+}

package/kits/physics-2d/engine/systemRegistry.js

@@ -0,0 +1,12 @@
+// Discover per-frame runtime systems from `systems/*.js`. Each such module
+// exports `installSystem(runtime)`, which is called once for every created
+// SceneRuntime (see engine/scene.js `makeScene`) to register itself via
+// `runtime.registerSystem(...)`. A system is a plain object with an optional
+// `afterBehaviors(scene, dt)` hook, run once per frame after all behavior
+// updates. Empty in a kit with no `systems/` dir (e.g. basic-2d); a kit adds a
+// system by dropping a file here -- no edits to the engine required. Symmetric
+// with editors/behaviorRegistry.js.
+const modules = import.meta.glob('../systems/*.js', { eager: true });
+export const systemInstallers = Object.values(modules)
+  .map((mod) => mod.installSystem)
+  .filter((fn) => typeof fn === 'function');