@jgengine/assets 0.11.0 → 0.13.0

package/dist/indexGen.js

@@ -1,17 +1,20 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { readGlbDims } from "./dims.js";
+import { COLLISION_MESH_ASSET_IDS } from "./collisionMeshAssets.js";
+import { readGlbClips, readGlbCollisionMesh, readGlbDims } from "./dims.js";
 import { sourceById } from "./sources/index.js";
 export function keyFromFile(file) {
     return file.replace(/\.gltf\.glb$/i, "").replace(/\.glb$/i, "");
 }
-export function entryForFile(source, file, dims) {
+export function entryForFile(source, file, dims, collisionMesh, clips) {
     return {
         id: `${source.id}/${keyFromFile(file)}`,
         source: source.id,
         categories: source.categories,
         file,
         ...(dims === undefined ? {} : { dims }),
+        ...(collisionMesh === undefined ? {} : { collisionMesh }),
+        ...(clips === undefined ? {} : { clips }),
     };
 }
 function collectGlbFiles(dir) {
@@ -27,14 +30,42 @@ function collectGlbFiles(dir) {
     }
     return found;
 }
-function measureDims(full) {
+function measureDims(bytes) {
     try {
-        return readGlbDims(readFileSync(full)) ?? undefined;
+        return readGlbDims(bytes) ?? undefined;
     }
     catch {
         return undefined;
     }
 }
+function measureCollisionMesh(bytes) {
+    try {
+        return readGlbCollisionMesh(bytes) ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function measureClips(bytes) {
+    try {
+        return readGlbClips(bytes) ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function entryFromGlb(source, file, full) {
+    let bytes;
+    try {
+        bytes = readFileSync(full);
+    }
+    catch {
+        return entryForFile(source, file);
+    }
+    const id = `${source.id}/${keyFromFile(file)}`;
+    const collisionMesh = COLLISION_MESH_ASSET_IDS.has(id) ? measureCollisionMesh(bytes) : undefined;
+    return entryForFile(source, file, measureDims(bytes), collisionMesh, measureClips(bytes));
+}
 export function indexSourceDir(source, dir) {
     const seen = new Set();
     const entries = [];
@@ -42,7 +73,7 @@ export function indexSourceDir(source, dir) {
         if (seen.has(file))
             continue;
         seen.add(file);
-        entries.push(entryForFile(source, file, measureDims(full)));
+        entries.push(entryFromGlb(source, file, full));
     }
     return entries;
 }

package/dist/manifest.d.ts

@@ -1,7 +1,9 @@
 import type { ModelDims } from "@jgengine/core/scene/assetCatalog";
 import type { AssetSpace } from "@jgengine/core/scene/assetSpace";
+import type { CollisionMeshData } from "@jgengine/core/scene/collisionMesh";
 export type { ModelDims };
 export type { AssetSpace };
+export type { CollisionMeshData };
 export type AssetProvider = "quaternius" | "kaykit" | "polypizza" | "itch" | "ambientcg" | "gameicons" | "custom";
 /**
  * What a source's archive contains: GLB models (default), one PBR material's
@@ -38,6 +40,10 @@ export interface IndexEntry {
     file: string;
     /** Footprint/center/minY measured from the GLB at reindex; absent when the model could not be read. */
     dims?: ModelDims;
+    /** Opt-in compact triangle mesh extracted at reindex (see {@link "@jgengine/core/scene/collisionMesh".CollisionMeshData}); present only for ids in `COLLISION_MESH_ASSET_IDS` whose geometry extracted. */
+    collisionMesh?: CollisionMeshData;
+    /** Animation clip names read from the GLB at reindex; absent for unrigged/unreadable models. */
+    clips?: readonly string[];
     /** Authored asset-space metadata (canonical facing, unit scale, footprint, anchor, bounds, rotation policy); absent unless a curator overrides the measured defaults. */
     space?: AssetSpace;
 }

package/dist/registry-catalog.json

@@ -51,11 +51,6 @@
       "title": "Buff Tray",
       "description": "Row of chamfered buff/debuff chips with stack counts and a remaining-duration underline, driven by a plain chip array."
     },
-    {
-      "name": "cartridge-panels",
-      "title": "Cartridge Panels",
-      "description": "Standard panel bindings for @jgengine/shell/cartridge: vital/xp/timer/score/ability-bar HUD items, upgrade-draft modal, and win/lose screens composed from the jgengine UI kit."
-    },
     {
       "name": "cast-bar",
       "title": "Cast Bar",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jgengine/assets",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Self-generating, license-verified index of thousands of CC0 3D models for JGengine. Sources fetch from providers' own CDNs at pull time; the npm tarball ships only the typed index and CLI (no GLB bytes).",
   "license": "Apache-2.0",
   "type": "module",
@@ -35,7 +35,7 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@jgengine/core": "^0.11.0",
+    "@jgengine/core": "^0.13.0",
     "fflate": "^0.8.2"
   },
   "devDependencies": {

package/skills/jgengine/SKILL.md

@@ -9,16 +9,16 @@ Read the repository [README](../../../README.md) for package truth, commands, la
 
 ## 1. Establish the target
 
-Capture only decisions that change architecture:
+Treat the pitch as a unique composition of needs, not a genre to fill in — never reach for a genre kit, preset, archetype, or class template ("default sports car", "default RPG", "default FPS") in the SDK or skills (see [AGENTS.md](../../../AGENTS.md)). Use `game-design` to turn the pitch into a testable player promise, verbs, loops, progression, failure, and completion scenario. Use `level-design` when play depends on authored spaces, routes, encounters, exploration, or spatial pacing. Capture only decisions that change architecture:
 
 - player point of view and controls
 - world shape and authored content
 - core loop, interaction, combat, and progression
 - solo, local, hosted, or persistent multiplayer
-- HUD/menu states and art direction
+- HUD/menu states and **custom** UI art direction (every game owns its presentation — no stock drop-in face)
 - one observable completion scenario
 
-For a new in-repo game, scaffold with `bun run new:game <id> --name "Title"`. Outside this monorepo, start with `npx jgengine create`; never copy `Games/*`.
+For a new in-repo game, scaffold with `bun run new:game "<id-or-title>"` (thin script alias for `jgengine create`, auto-detects the in-repo variant). Outside this monorepo, start with `npx jgengine create`; never copy `Games/*`.
 
 ## 2. Select domains
 
@@ -26,6 +26,8 @@ Load only rows the target needs. Do not preload every domain.
 
 | Need | Skill | Owner |
 | --- | --- | --- |
+| player promise, pillars, verbs, loops, economy, progression, balance | `game-design` | experience and rule intent |
+| metrics, topology, encounters, navigation, spatial pacing | `level-design` | playable space intent |
 | scene placement, terrain painting, paths, asset authoring | `jgengine-editor` | editor document and authoring tools |
 | runtime world, movement, input, interaction, AI, navigation, audio | `jgengine-world` | spatial simulation and world runtime |
 | game state, systems, inventory, crafting, quests, economy, turns | `jgengine-gameplay` | non-combat rules and state |
@@ -34,15 +36,17 @@ Load only rows the target needs. Do not preload every domain.
 | models, sprites, materials, audio files, source licensing | `jgengine-assets` | asset discovery and catalogs |
 | authority, transport, replication, sessions, host persistence | `jgengine-multiplayer` | network topology and persistence adapters |
 
-Scenes normally require both `jgengine-editor` for authoring and `jgengine-world` for runtime consumption. Combat and multiplayer are opt-in, not default intake.
+World content routes editor-first: any request that adds, moves, restyles, or removes something visible in the world — however phrased ("design this world", "place the enemies", "make it look better") — starts in `jgengine-editor`; the other domains consume the authored document. Scenes normally require both `jgengine-editor` for authoring and `jgengine-world` for runtime consumption. Combat and multiplayer are opt-in, not default intake.
 
 ## 3. Discover before designing
 
 Within each selected domain:
 
+0. Fastest start for a common composition: `npx jgengine recipe <name>` prints a vetted, SDK-typechecked snippet (imports + wired code) for `combat-loop`, `boss-telegraph`, `loot`, `quest`, `coop-presence`, `third-person-camera`; `npx jgengine recipe` lists them. Copy that instead of reconning per-file.
 1. Search `capabilities.md` by intent; it maps needs to imports.
 2. Open `api.md` only when exact signatures or export inventory are needed.
 3. Open the linked reference only for a deeper recipe or trap.
+4. For how several primitives wire into a running loop, read the domain's `recipes/` — connected, genre-free walkthroughs organized by composition seam; this skill's own [recipes/minimal-game.md](recipes/minimal-game.md) is the default whole-game walkthrough. Prefer a recipe over reading a game's source; the games under `Games/*` are not templates or references, and a hybrid game is just a different composition of the same primitives.
 
 If no capability fits, identify the upstream package seam before writing game-local code. In this repository, implement a reusable primitive with its first adopter; if editor-owned content cannot be expressed, file the editor gap first.