@developerz.ai/ts23d 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `@developerz.ai/ts23d`. Format: [Keep a Changelog](https:
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-11-07
+
+### Added
+- Package published as `@developerz.ai/ts23d` (the npm organisation's scope).
+- Material library v2: 16 new PBR strips on a 2048² trim sheet (oak, pine, weathered and painted wood; rusty, cast, painted and galvanised iron/steel; brass, copper, aluminium, chrome; rubber, canvas, leather, plastic) with their own roughness and metalness. `defineMaterial()` registers project materials; opt-in CC0 photo strips (Poly Haven) via `bun run textures` — sha256-pinned, offline compile, credited in the GLB. The beauty renderer reflects metals. `t3d` paints the sheet at 2048² by default.
+- Orc and goblin busts re-sculpted (anatomy, faces, mouths, gear, collectible plinth, painted tone pass); `head` gains `bust.mass`, `wrinkles`, `'vest'` bust style.
+- Boxcar reads as painted planks, weathered roof walk, cast and rusty iron.
+- Gallery: per-category studio lighting, PBR Neutral tone mapping, contact shadows, GTAO + MSAA on a high-quality tier with a phone fallback.
+- Research docs: sculpting, material authoring, Blender bridge design, pro asset pipeline and CC0 libraries.
+- One GLB with all three LODs: `t3d build` also writes `<out>/<asset>/<asset>.glb` — LOD0 in the scene, LOD1/LOD2 as `MSFT_lod` alternates outside it (listed in `extensionsUsed`, never required, so viewers without the extension show LOD0 only), `MSFT_screencoverage` view-distance hints, one shared material/texture set, motion channels on every LOD. `--lods split|single|both` (default `both`); the manifest records `files.single` and `lodCoverage`. API: `toLodGlb` / `exportLodGlb`; recipes may set `lodCoverage: [lod0→1, lod1→2, cull]`, otherwise it is derived from triangle density and size. tiger_1: one 7.07 MB file vs 7.09 MB for three split files (shared sheet); with `--sheet embed`, 10.7 MB vs 17.9 MB.
+
 ## [0.1.0] - 2026-11-07
 
 ### Added

package/CLAUDE.md

@@ -35,7 +35,7 @@ project that installed the package.
 |---|---|
 | Fresh clone → ready | `bun run setup` |
 | Gate (≡ CI) | `bun run verify` · one step: `bun run verify --only <step>` · `--json` |
-| Compile + QA recipe | `bun run t3d build recipes/t34/t34.ts --out out` |
+| Compile + QA recipe | `bun run t3d build recipes/t34/t34.ts --out out` (lod0/1/2.glb + one `<asset>.glb` with all LODs via MSFT_lod; `--lods split\|single\|both`) |
 | Contact sheet (READ the PNG) | `bun run t3d shot recipes/t34/t34.ts --out renders` |
 | Beauty render (3/4, textured, shadowed) | `bun run t3d hero recipes/t34/t34.ts --out renders` |
 | AI review pack (READ `review/*.png`, follow `review.md`) | `bun run t3d review recipes/t34/t34.ts --out review` |

package/README.md

@@ -97,7 +97,7 @@ The agent looks up real dimensions and photos into `recipes/<name>/README.md`, w
 
 ### 3. Use the GLB in your engine
 
-`out/<asset>/lod0.glb` (and `lod1`, `lod2`) are plain glTF 2.0, core extensions only. The hooks your engine code can use:
+`out/<asset>/lod0.glb` (and `lod1`, `lod2`) are plain glTF 2.0; `out/<asset>/<asset>.glb` holds all three in one file (LOD0 in the scene, LOD1/2 as `MSFT_lod` alternates with screen-coverage switch hints; viewers without the extension show LOD0 only; `--lods split|single|both`, default both). The hooks your engine code can use:
 
 | Hook | In the GLB |
 |---|---|
@@ -126,7 +126,7 @@ Each ts23d row names how it's verified. The image-to-3D column cites only what v
 | Property | ts23d | How it's verified | Typical image-to-3D output (per vendor docs) |
 |---|---|---|---|
 | Draw calls per asset | Static assets: 1. Vehicles: one per movable part (one shared material; static geometry batched into its pivot) | `toGlb` merges static parts by default (`mergeToPivots`); counts measured by `bun run bench` | One PBR material per generated model (e.g. Meshy: albedo / normal / metal / rough) |
-| LODs | 3 from the same source | `t3d build` writes `lod0/1/2`, each under its own triangle budget | One mesh per generation; polycount presets or a low-poly mode (Rodin, Meshy) |
+| LODs | 3 from the same source | `t3d build` writes `lod0/1/2` plus one `MSFT_lod` file holding all three, each under its own triangle budget | One mesh per generation; polycount presets or a low-poly mode (Rodin, Meshy) |
 | Named, pivoted, animatable parts | Yes | `part-names` gate; `clashes` gate sweeps every moving part | Usually one mesh; part-based output reported for CSM (3rd-party source) |
 | Deterministic rebuild | Byte-identical | `scripts/recipes.ts` builds every recipe twice and compares hashes, in CI | Not stated |
 | Real-world dimensions | Gated: ±5% overall, ±2% per measure | `proportions` and `measures` gates | Not stated |
@@ -220,11 +220,16 @@ Row 2: top, 3/4 rear, LOD2 at distance. Layout: [docs/idea/05-agent-loop.md](doc
 `t3d hero` adds the beauty shot, and `t3d review` packs hero, sheet, close-ups, an LOD strip and a
 checklist prompt into `out/<asset>/review/` for a second, fresh-eyes vision pass.
 
-## The quality bar
+## Materials
 
-![4-4-0 locomotive: reference photo, procedural model, overlay](https://raw.githubusercontent.com/developerz-ai/ts23d/main/docs/reference/loco-photo-match.png)
+![The material library: woods, metals, rubber, canvas, leather on one trim sheet](docs/media/materials.png)
 
-**Not output of this library yet.** This is from the in-house predecessor (a JSON recipe compiler for railroads): a 4-4-0 with tender. Top: reference photo. Middle: the procedural model. Bottom: overlay. That GLB is ~16k triangles, 17 named nodes (axles, side and main rods, crossheads, tender axles, track), one `trim_sheet` material with embedded albedo / normal / ORM textures, and a baked `run` animation. ts23d now has its own [`loco_440`](recipes/loco_440/loco_440.ts) (the Jupiter, drivers 1.626 m sourced) and the trim-sheet painter; photo match is next (M2, [roadmap](docs/plans/roadmap.md)).
+One shared 2048² trim sheet holds 24 physically based materials: oak, pine, weathered and painted
+wood; rusty, cast, painted and galvanised iron and steel; brass, copper, aluminium, chrome; rubber,
+canvas, leather, plastic; plus brick, stone, slate, concrete and glass. Each has its own roughness and
+metalness, so chrome mirrors and wood stays matte. Projects add their own with `defineMaterial`, or
+pull a CC0 photo set from Poly Haven with `bun run textures` (hash-pinned, credited in the GLB). See
+[materials.md](docs/architecture/materials.md).
 
 ## Quickstart
 

package/dist/{chunk-a8fxakcj.js → chunk-6b05mnmx.js}

@@ -1,6 +1,6 @@
 import {
   notImplemented2
-} from "./chunk-4ddzsqtc.js";
+} from "./chunk-hg7pf34j.js";
 
 // src/neural/generator.ts
 function localGenerator2(_o) {
@@ -16,4 +16,4 @@ function kubeezImages2(_o) {
 export { localGenerator2, importGlb2, kubeezImages2 };
 
 //# debugId=FD2490AA59A2DB1D64756E2164756E21
-//# sourceMappingURL=chunk-a8fxakcj.js.map
+//# sourceMappingURL=chunk-6b05mnmx.js.map

package/dist/{chunk-kgvbpqqw.js → chunk-7rtfjh9f.js}

@@ -1,13 +1,13 @@
 import {
   mergeToPivots2
-} from "./chunk-gcyp9b4d.js";
+} from "./chunk-dbq4qf52.js";
 import {
   measure2
-} from "./chunk-w1zyhj40.js";
+} from "./chunk-jq4e17tj.js";
 
 // src/cli/manifest.ts
 var tris = (a) => a.parts.reduce((s, p) => s + (p.mesh ? p.mesh.indices.length / 3 : 0), 0);
-function manifestOf2(asset, lods, files, findings) {
+function manifestOf2(asset, lods, files, findings, lodCoverage) {
   const top = lods[0];
   const merged = top ? mergeToPivots2(top) : null;
   return {
@@ -17,6 +17,7 @@ function manifestOf2(asset, lods, files, findings) {
     tags: asset.tags ?? [],
     files,
     triangles: lods.map(tris),
+    ...lodCoverage?.length ? { lodCoverage } : {},
     drawCalls: lods.map((l) => mergeToPivots2(l, (l.glow ?? []).map((g) => g.parts)).parts.filter((p) => p.mesh).length),
     pivots: (merged?.parts ?? []).filter((p) => !p.emitter && !p.socket).map((p) => ({
       name: p.name,
@@ -40,5 +41,5 @@ function manifestOf2(asset, lods, files, findings) {
 
 export { manifestOf2 };
 
-//# debugId=E9A05EE7585826EF64756E2164756E21
-//# sourceMappingURL=chunk-kgvbpqqw.js.map
+//# debugId=DCAF218A5B7D9F6B64756E2164756E21
+//# sourceMappingURL=chunk-7rtfjh9f.js.map

package/dist/chunk-7rtfjh9f.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/manifest.ts"],
+  "sourcesContent": [
+    "// manifest.json per asset: what an engine pipeline or an agent needs without opening a GLB —\n// files, triangles per LOD, pivots (the names game code binds to), emitters, surfaces, QA,\n// measures with their measured values, sources.\n\nimport type { Asset, CompiledAsset } from '../core/index.ts';\nimport { mergeToPivots } from '../export/index.ts';\nimport { type Finding, measure } from '../qa/index.ts';\n\nexport interface AssetManifest {\n  readonly name: string;\n  readonly kind: string;\n  readonly description?: string;\n  readonly tags: readonly string[];\n  readonly files: {\n    readonly lods: readonly string[];\n    /** All built LODs in one GLB (MSFT_lod), when `--lods single|both`. */\n    readonly single?: string;\n    readonly hero?: string;\n    readonly sheet?: string;\n    readonly thumb?: string;\n  };\n  readonly triangles: readonly number[];\n  /** MSFT_screencoverage written into `files.single`: where each LOD hands over (last = cull). */\n  readonly lodCoverage?: readonly number[];\n  readonly drawCalls: readonly number[];\n  readonly pivots: readonly { name: string; parent: string | null; motion?: string }[];\n  readonly emitters: readonly { name: string; kind: string; when: string }[];\n  readonly sockets: readonly { name: string; kind: string; parent: string | null }[];\n  readonly surfaces: readonly string[];\n  readonly real?: { length: number; width: number; height: number };\n  readonly measures: readonly {\n    label: string;\n    spec: number;\n    measured: number | null;\n    source?: string;\n  }[];\n  readonly sources: readonly string[];\n  readonly qa: { readonly pass: boolean; readonly findings: readonly Finding[] };\n}\n\nconst tris = (a: CompiledAsset): number =>\n  a.parts.reduce((s, p) => s + (p.mesh ? p.mesh.indices.length / 3 : 0), 0);\n\nexport function manifestOf(\n  asset: Asset,\n  lods: readonly CompiledAsset[],\n  files: AssetManifest['files'],\n  findings: readonly Finding[],\n  lodCoverage?: readonly number[],\n): AssetManifest {\n  const top = lods[0];\n  const merged = top ? mergeToPivots(top) : null;\n  return {\n    name: asset.name,\n    kind: asset.kind,\n    ...(asset.description ? { description: asset.description } : {}),\n    tags: asset.tags ?? [],\n    files,\n    triangles: lods.map(tris),\n    ...(lodCoverage?.length ? { lodCoverage } : {}),\n    // One draw per merged mesh, glowing parts in their own emissive layer (as the GLB writes them).\n    drawCalls: lods.map(\n      (l) =>\n        mergeToPivots(\n          l,\n          (l.glow ?? []).map((g) => g.parts),\n        ).parts.filter((p) => p.mesh).length,\n    ),\n    pivots: (merged?.parts ?? [])\n      .filter((p) => !p.emitter && !p.socket)\n      .map((p) => ({\n        name: p.name,\n        parent: p.parent,\n        ...(p.motion ? { motion: p.motion.kind } : {}),\n      })),\n    emitters: (top?.parts ?? []).flatMap((p) =>\n      p.emitter ? [{ name: p.name, kind: p.emitter.kind, when: p.emitter.when ?? 'always' }] : [],\n    ),\n    sockets: (top?.parts ?? []).flatMap((p) =>\n      p.socket ? [{ name: p.name, kind: p.socket.kind, parent: p.parent }] : [],\n    ),\n    surfaces: [...new Set((top?.parts ?? []).map((p) => p.surface ?? 'opaque'))].sort(),\n    ...(asset.real\n      ? { real: { length: asset.real.length, width: asset.real.width, height: asset.real.height } }\n      : {}),\n    measures: (asset.real?.measures ?? []).map((m) => ({\n      label: m.label,\n      spec: m.value,\n      measured: top ? measure(top, m) : null,\n      ...(m.source ? { source: m.source } : {}),\n    })),\n    sources: asset.sources ?? [],\n    qa: { pass: findings.length === 0, findings },\n  };\n}\n"
+  ],
+  "mappings": ";;;;;;;;AAwCA,IAAM,OAAO,CAAC,MACZ,EAAE,MAAM,OAAO,CAAC,GAAG,MAAM,KAAK,EAAE,OAAO,EAAE,KAAK,QAAQ,SAAS,IAAI,IAAI,CAAC;AAEnE,SAAS,WAAU,CACxB,OACA,MACA,OACA,UACA,aACe;AAAA,EACf,MAAM,MAAM,KAAK;AAAA,EACjB,MAAM,SAAS,MAAM,eAAc,GAAG,IAAI;AAAA,EAC1C,OAAO;AAAA,IACL,MAAM,MAAM;AAAA,IACZ,MAAM,MAAM;AAAA,OACR,MAAM,cAAc,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;AAAA,IAC9D,MAAM,MAAM,QAAQ,CAAC;AAAA,IACrB;AAAA,IACA,WAAW,KAAK,IAAI,IAAI;AAAA,OACpB,aAAa,SAAS,EAAE,YAAY,IAAI,CAAC;AAAA,IAE7C,WAAW,KAAK,IACd,CAAC,MACC,eACE,IACC,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CACnC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,MAClC;AAAA,IACA,SAAS,QAAQ,SAAS,CAAC,GACxB,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,EACrC,IAAI,CAAC,OAAO;AAAA,MACX,MAAM,EAAE;AAAA,MACR,QAAQ,EAAE;AAAA,SACN,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;AAAA,IAC9C,EAAE;AAAA,IACJ,WAAW,KAAK,SAAS,CAAC,GAAG,QAAQ,CAAC,MACpC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,QAAQ,MAAM,MAAM,EAAE,QAAQ,QAAQ,SAAS,CAAC,IAAI,CAAC,CAC5F;AAAA,IACA,UAAU,KAAK,SAAS,CAAC,GAAG,QAAQ,CAAC,MACnC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,OAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAC1E;AAAA,IACA,UAAU,CAAC,GAAG,IAAI,KAAK,KAAK,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,QAAQ,CAAC,CAAC,EAAE,KAAK;AAAA,OAC9E,MAAM,OACN,EAAE,MAAM,EAAE,QAAQ,MAAM,KAAK,QAAQ,OAAO,MAAM,KAAK,OAAO,QAAQ,MAAM,KAAK,OAAO,EAAE,IAC1F,CAAC;AAAA,IACL,WAAW,MAAM,MAAM,YAAY,CAAC,GAAG,IAAI,CAAC,OAAO;AAAA,MACjD,OAAO,EAAE;AAAA,MACT,MAAM,EAAE;AAAA,MACR,UAAU,MAAM,SAAQ,KAAK,CAAC,IAAI;AAAA,SAC9B,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,IAAI,CAAC;AAAA,IACzC,EAAE;AAAA,IACF,SAAS,MAAM,WAAW,CAAC;AAAA,IAC3B,IAAI,EAAE,MAAM,SAAS,WAAW,GAAG,SAAS;AAAA,EAC9C;AAAA;",
+  "debugId": "DCAF218A5B7D9F6B64756E2164756E21",
+  "names": []
+}