@bitmagic/world-forger 0.1.0

package/dist/terrain-height-grid.js

@@ -0,0 +1,50 @@
+/**
+ * World-space terrain height grid — the bridge that lets objects placed AFTER
+ * a forge (e.g. collectibles the coding/asset agent scatters via the voxel CLI)
+ * sit on the forged surface instead of the world floor.
+ *
+ * The forge knows each prop's exact ground height because it samples its own
+ * GLB-space `Heightfield` and maps the result to world space with the level
+ * transform (see `forge-world.ts`). Agent-driven placements happen later, in a
+ * separate process, with no access to that in-memory heightfield — and a
+ * placement raycast can't help because the freshly-forged terrain only loads
+ * after the session reload. So the forge persists THIS grid (a sidecar next to
+ * world.json); the CLI samples it to resolve `placeOnTerrain` Y the same way
+ * the forge resolved its props.
+ *
+ * The grid is the carved heightfield expressed in WORLD coordinates. Because the
+ * level transform is affine and axis-aligned (uniform scale + translate, no
+ * rotation — see `marker-transform.ts`), a GLB-regular grid maps to a
+ * world-regular grid, so the conversion is a per-vertex scale/translate.
+ *
+ * The GRID and its SAMPLER live on the publishable side, because the host that
+ * writes the sidecar and the tools that read it are CLIENTS of the forge, not
+ * part of it. The producer — `heightfieldToWorldGrid`, which needs the forge's
+ * own heightfield and level transform — stays with the geometry, in the private
+ * package's module of the same name.
+ */
+/** Sidecar filename written next to world.json. The CLI hardcodes the same name. */
+export const FORGED_HEIGHTFIELD_FILE = 'forged-heightfield.json';
+/**
+ * Bilinear height sample in world space, clamped to the grid edge. Mirrors
+ * `heightfield.ts` `heightAt` so the CLI's sampler and this one agree.
+ */
+export function sampleWorldHeight(g, x, z) {
+    const fx = (x - g.minX) / g.cellSize;
+    const fz = (z - g.minZ) / g.cellSize;
+    const cx = Math.min(Math.max(fx, 0), g.nx - 1e-9);
+    const cz = Math.min(Math.max(fz, 0), g.nz - 1e-9);
+    const i = Math.floor(cx);
+    const j = Math.floor(cz);
+    const tx = cx - i;
+    const tz = cz - j;
+    const stride = g.nx + 1;
+    const h00 = g.heights[j * stride + i];
+    const h10 = g.heights[j * stride + i + 1];
+    const h01 = g.heights[(j + 1) * stride + i];
+    const h11 = g.heights[(j + 1) * stride + i + 1];
+    const a = h00 + (h10 - h00) * tx;
+    const b = h01 + (h11 - h01) * tx;
+    return a + (b - a) * tz;
+}
+//# sourceMappingURL=terrain-height-grid.js.map

package/dist/terrain-height-grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-height-grid.js","sourceRoot":"","sources":["../src/terrain-height-grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAejE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAmB,EAAE,CAAS,EAAE,CAAS;IACzE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACrC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzB,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClB,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClB,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAE,CAAC;IACvC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,CAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,CAAE,CAAC;IACjD,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IACjC,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;AAC1B,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@bitmagic/world-forger",
+  "version": "0.1.0",
+  "description": "Client half of the Bitmagic world forger: the forged-level artifact schema, the host seams, and the browser pipeline steps that bake archetypes, bake a level and place its instances.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.38.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^24.9.1",
+    "@typescript-eslint/eslint-plugin": "^8.46.2",
+    "@typescript-eslint/parser": "^8.46.2",
+    "eslint": "^9.38.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.5",
+    "typescript": "^5.9.3"
+  },
+  "jest": {
+    "preset": "ts-jest/presets/default-esm",
+    "extensionsToTreatAsEsm": [
+      ".ts"
+    ],
+    "transform": {
+      "^.+\\.ts$": [
+        "ts-jest",
+        {
+          "useESM": true,
+          "tsconfig": {
+            "target": "ES2020",
+            "module": "ES2020",
+            "moduleResolution": "node",
+            "verbatimModuleSyntax": false,
+            "esModuleInterop": true
+          }
+        }
+      ]
+    },
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.js$": "$1"
+    },
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/__tests__/**/*.test.ts"
+    ],
+    "maxWorkers": "50%"
+  },
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "pnpm run clean && tsc",
+    "check": "pnpm run lint && pnpm run build",
+    "lint": "eslint src --cache",
+    "test": "jest"
+  }
+}