ugly-game 0.4.0 → 0.5.1

package/dist/gpuShadow.js

@@ -70,7 +70,7 @@ const MAIN_WGSL = COMMON_WGSL + /* wgsl */ `
 @group(0) @binding(2) var shadowMap: texture_depth_2d;
 @group(0) @binding(3) var shadowSamp: sampler_comparison;
 
-struct VOut { @builtin(position) clip: vec4<f32>, @location(0) world: vec3<f32>, @location(1) nrm: vec3<f32>, @location(2) hue: f32, @location(3) emis: f32 };
+struct VOut { @builtin(position) clip: vec4<f32>, @location(0) world: vec3<f32>, @location(1) nrm: vec3<f32>, @location(2) hue: f32, @location(3) emis: f32, @location(4) blk: vec3<f32>, @location(5) objN: vec3<f32> };
 
 @vertex fn vs(@builtin(vertex_index) vi: u32, @builtin(instance_index) ii: u32) -> VOut {
   let inst = insts[ii];
@@ -81,6 +81,11 @@ struct VOut { @builtin(position) clip: vec4<f32>, @location(0) world: vec3<f32>,
   o.nrm = normalize(qrot(inst.rot, CUBE_NRM[vi] / inst.scl.xyz));   // normal under non-uniform scale + rotation
   o.hue = inst.pos.w;
   o.emis = inst.scl.w;
+  // OBJECT-space block coord (per-sub-block units, anchored to the model, NOT world) so per-block AO moves +
+  // rotates with the instance (ships/creatures/plants) instead of sliding over a world-anchored grid; scale
+  // by inst.scl so a merged LOD cube (scl>1) still shows its sub-blocks. objN = pre-rotation face normal.
+  o.blk = (CUBE_POS[vi] + vec3(0.5, 0.5, 0.5)) * inst.scl.xyz;
+  o.objN = CUBE_NRM[vi];
   return o;
 }
 
@@ -117,12 +122,13 @@ fn blockShade(fx: f32, fz: f32) -> f32 {
   let ndl = max(dot(N, -normalize(cam.sun.xyz)), 0.0);
   let base = select(mix(vec3(0.34), hsv(i.hue), 0.62), vec3(0.6, 0.62, 0.66), i.hue < 0.0);
   let sh = shadowFactor(i.world, ndl);
-  // in-block coords = the two world axes not along the (axis-aligned) face normal
-  let an = abs(N);
+  // in-block coords = the two OBJECT axes not along the (object-space, axis-aligned) face normal — so the AO
+  // pattern is anchored to the model's own block grid and translates/rotates with the instance.
+  let an = abs(i.objN);
   var fx: f32; var fz: f32;
-  if (an.y >= an.x && an.y >= an.z) { fx = fract(i.world.x); fz = fract(i.world.z); }
-  else if (an.x >= an.z) { fx = fract(i.world.y); fz = fract(i.world.z); }
-  else { fx = fract(i.world.x); fz = fract(i.world.y); }
+  if (an.y >= an.x && an.y >= an.z) { fx = fract(i.blk.x); fz = fract(i.blk.z); }
+  else if (an.x >= an.z) { fx = fract(i.blk.y); fz = fract(i.blk.z); }
+  else { fx = fract(i.blk.x); fz = fract(i.blk.y); }
   let ao = blockShade(fx, fz);
   let lit = base * (cam.sun.w + cam.sunCol.xyz * ndl * sh) * ao;
   return vec4(pow(clamp(lit, vec3(0.0), vec3(1.0)), vec3(0.4545)), 1.0);  // gamma

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './dmath';
 export * from './mat4';
 export * from './noise';
 export * from './moat';
+export * from './stateIR';
 export * from './gpuShadow';
 export * from './input/resolve';
 export * from './input/browserBackend';

package/dist/index.js

@@ -4,6 +4,7 @@ export * from './dmath';
 export * from './mat4';
 export * from './noise';
 export * from './moat';
+export * from './stateIR';
 export * from './gpuShadow';
 export * from './input/resolve';
 export * from './input/browserBackend';

package/dist/stateIR.d.ts

@@ -0,0 +1,30 @@
+/** A sim/scene that can explain itself to an agent from structured state (not pixels). */
+export interface AgentDebuggable<Snap> {
+    /** Typed, JSON-able structured snapshot of the current state (a pure read). */
+    snapshot(): Snap;
+    /** One-screen play-by-play of the current state, highlighting the actionable "why" (built with Narrator). */
+    describe(): string;
+}
+/** Accumulates a readable, sectioned report with FIRST-CLASS warnings — the "why isn't it working?" view.
+ *  Warnings are recorded both inline (so they appear in the narration) and separately (so an agent can
+ *  branch on `warnings` without re-parsing the text). Chainable. */
+export declare class Narrator {
+    private lines;
+    private warns;
+    /** Append a raw line. */
+    line(text: string): this;
+    /** A compact "label: k1 v1 · k2 v2 · …" status line. */
+    status(label: string, kv: Record<string, string | number>): this;
+    /** A ⚠ warning: shown inline AND collected in `warnings` so an agent can act on it programmatically. */
+    warn(text: string): this;
+    /** Warn only when `cond` holds. Returns this for chaining either way. */
+    warnIf(cond: boolean, text: string): this;
+    /** The bare warning strings (no ⚠ prefix), for agent branching. */
+    get warnings(): string[];
+    /** Was any warning raised? (a quick "is something wrong?" for an agent loop). */
+    get healthy(): boolean;
+    /** Render the whole report as one string. */
+    toString(): string;
+}
+/** Tally names into a "3 miner, 2 smelter" style histogram string, preserving first-seen order. */
+export declare function histogram(names: Iterable<string>): string;

package/dist/stateIR.js

@@ -0,0 +1,43 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// ugly-game STATE IR — "debug from state, not screenshots"
+//
+// A general helper for turning ANY deterministic sim's CURRENT state into (a) a typed, JSON-able
+// structured snapshot and (b) a one-screen, sectioned, WARNING-annotated narration that surfaces the
+// actionable "why isn't it working?" — the view an AI (or a human) reads to diagnose without a picture.
+//
+// Complements the replay IR (ir.ts): that reconstructs state over TIME by re-running the sim; this
+// explains a SINGLE state readably, right now. A game exposes `AgentDebuggable` (snapshot + describe);
+// `Narrator` + `histogram` are the tools its describe() is built from. Graduated from the Cogsworth
+// factory game, where it caught starved crafters, unpowered machines, and idle logistics at a glance.
+// ─────────────────────────────────────────────────────────────────────────────
+/** Accumulates a readable, sectioned report with FIRST-CLASS warnings — the "why isn't it working?" view.
+ *  Warnings are recorded both inline (so they appear in the narration) and separately (so an agent can
+ *  branch on `warnings` without re-parsing the text). Chainable. */
+export class Narrator {
+    lines = [];
+    warns = [];
+    /** Append a raw line. */
+    line(text) { this.lines.push(text); return this; }
+    /** A compact "label: k1 v1 · k2 v2 · …" status line. */
+    status(label, kv) {
+        this.lines.push(`${label}: ${Object.entries(kv).map(([k, v]) => `${k} ${v}`).join(' · ')}`);
+        return this;
+    }
+    /** A ⚠ warning: shown inline AND collected in `warnings` so an agent can act on it programmatically. */
+    warn(text) { this.warns.push(text); this.lines.push(`⚠ ${text}`); return this; }
+    /** Warn only when `cond` holds. Returns this for chaining either way. */
+    warnIf(cond, text) { return cond ? this.warn(text) : this; }
+    /** The bare warning strings (no ⚠ prefix), for agent branching. */
+    get warnings() { return this.warns.slice(); }
+    /** Was any warning raised? (a quick "is something wrong?" for an agent loop). */
+    get healthy() { return this.warns.length === 0; }
+    /** Render the whole report as one string. */
+    toString() { return this.lines.join('\n'); }
+}
+/** Tally names into a "3 miner, 2 smelter" style histogram string, preserving first-seen order. */
+export function histogram(names) {
+    const m = new Map();
+    for (const n of names)
+        m.set(n, (m.get(n) ?? 0) + 1);
+    return [...m].map(([k, v]) => `${v} ${k}`).join(', ');
+}

package/package.json

@@ -1,14 +1,34 @@
 {
   "name": "ugly-game",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "type": "module",
   "exports": {
-    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
-    "./*": { "types": "./dist/*.d.ts", "import": "./dist/*.js" }
-  },
-  "files": ["dist"],
-  "scripts": { "build": "tsc -p tsconfig.json", "prepublishOnly": "tsc -p tsconfig.json" },
-  "dependencies": { "meshoptimizer": "^1.2.0" },
-  "peerDependencies": { "react": ">=18" },
-  "devDependencies": { "typescript": "^5.6.0", "@types/react": "^19.0.0", "@webgpu/types": "^0.1.40" }
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "preinstall": "npx only-allow pnpm",
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "meshoptimizer": "^1.2.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/react": "^19.0.0",
+    "@webgpu/types": "^0.1.40"
+  }
 }