Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ All notable changes to `@developerz.ai/ts23d`. Format: [Keep a Changelog](https:

## [Unreleased]

## [0.15.0] - 2026-11-19

Contact sheets show the hero's base colour, triangle budgets are checked against the playbook bands, custom materials are per asset, and every committed asset was reworked and independently re-judged: criteria below the pass mark of 8 fell from 416 to 352, and two assets now pass on all seven.

### Added
Expand Down Expand Up @@ -528,7 +530,8 @@ The first published version: the asset DSL with primitives, organic sculpting, t
- Animations: `toGlb()` exports none unless `{ animations: true }` (glTF has no autoplay flag; engines drive named pivots from code). `t3d build` bakes the `run` clip by default so viewers show play controls; `--no-animations` skips it.
- CLI output is one folder per asset: `out/<asset>/{lod0,lod1,lod2}.glb`, `sheet.png`, `manifest.json`, plus `out/index.json`. `t3d build` renders the sheet too (`--no-shot` to skip); `t3d shot` writes sheet + manifest only.

[Unreleased]: https://github.com/developerz-ai/ts23d/compare/v0.14.0...HEAD
[Unreleased]: https://github.com/developerz-ai/ts23d/compare/v0.15.0...HEAD
[0.15.0]: https://github.com/developerz-ai/ts23d/compare/v0.14.0...v0.15.0
[0.14.0]: https://github.com/developerz-ai/ts23d/compare/v0.13.0...v0.14.0
[0.13.0]: https://github.com/developerz-ai/ts23d/compare/v0.12.0...v0.13.0
[0.12.0]: https://github.com/developerz-ai/ts23d/compare/v0.11.0...v0.12.0
Expand Down
2 changes: 1 addition & 1 deletion docs/changelog/0.14.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,4 @@ Several agents can share one machine through a resource queue, the npm package s

---

Older: [0.13.0](0.13.0.md)
Older: [0.13.0](0.13.0.md) · Newer: [0.15.0](0.15.0.md)
46 changes: 46 additions & 0 deletions docs/changelog/0.15.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
<!-- Generated from CHANGELOG.md by `bun run changelog`. Edit CHANGELOG.md, never this file. -->

# ts23d 0.15.0

Released 2026-11-19 · [npm](https://www.npmjs.com/package/@developerz.ai/ts23d/v/0.15.0) · [diff v0.14.0...v0.15.0](https://github.com/developerz-ai/ts23d/compare/v0.14.0...v0.15.0) · [all releases](README.md) · [CHANGELOG](../../CHANGELOG.md)

Contact sheets show the hero's base colour, triangle budgets are checked against the playbook bands, custom materials are per asset, and every committed asset was reworked and independently re-judged: criteria below the pass mark of 8 fell from 416 to 352, and two assets now pass on all seven.

### Added
- `contactSheet(asset, { sheet })`, `thumbnail(asset, { sheet })` and `previewSheet()` (a 512² default sheet). Omitting `sheet` keeps the previous vertex-colour output pixel for pixel.
- `sheetFor(compiled, recipe)`, `sheetWith(ids, recipe)`, `materialsOf(compiled)`, `CompiledAsset.materials`, `paintTrimSheet(recipe, ids)`, `previewSheet(assets)`, `ReviewOptions.sheetRecipe`.
- Blender `isolate` step: optional `contact` (metres) for a chain generated fused to the body along its length (a tail lying on a thigh). Weights within that distance of an edge joining chain skin to body skin are blended. No default: committed programs keep their request keys.
- Per-asset hero view: `hero: { azDeg, elDeg, fovDeg }` or `hero: { eye, target, fovDeg }` on the definition; `t3d hero`, `bun run shots`, `review` and `critique` use it by default, `--az` / `--el` / `--fov` override.
- `glow` parts emit in the raster and path-traced hero, visible through glass and translucent shells; in the path tracer they light their neighbours.
- `modelChain`, `modelRig` and `modelBody` take `extra`: bone chains the creature plan lacks (wings, fins, a second tail), each declared by its joints along the mesh, the bone it hangs from, a limit per bone with a source, and an optional `motion` clip. Blender `bind` weights the skin to them; QA `deform` and `model` cover them. `tracePath(mesh, from, to, { cell })` finds a limb's centre line for placing the joints.
- `dragon_hybrid`: three bones a wing and a `flap` clip (0.9 Hz, design values); the wings settle in `idle` and are carried in the walk.
- Creature kind: `options.cells { body, head }` sets sculpt density directly; `spec.fur { density, guard }` sets fur card counts; `build.hock`, `build.heel`, `build.track` and `build.topline` give a shoulder hump, a plantigrade heel under the hip and a stance that holds its width; `CreatureInfo.rig` / `.bare` and `creatureHeadFur` let a recipe groom its own coat with the kind's skinning.
- Triangle bands per asset class: the `conventions` gate fails a committed asset whose triangles at any LOD exceed its class band from the playbooks (`T3D_BUDGET_BAND`, `scripts/lib/budget-bands.ts`), unless its README says `Budget why: <reason>`. The assets over band on 2026-11-19 are listed in `scripts/lib/budget-baseline.ts`; they warn until reduced or justified, new offenders fail now, and the list only shrinks.

### Fixed
- `king_cobra`: `idle_ground` is a resting loose coil instead of a straight stick, `rear` lifts the front from a body that stays planted, and the coil rests on the ground instead of floating 2–7 cm above it.
- Review of the quality wave: 58 of 60 findings fixed (D340–D396), among them open holes in `joint_demo`'s sword, scar discs painted at both ends of every creature scar, normals left stale after four deformations, river ribbons under flat terrain, a shared trim sheet repainted by a later build into the same folder, and nine tests that could not fail.
- Gallery: `bear_hybrid`'s page shows the model-built bear. It has no CPU asset named `bear` to pair with, so the page used to compile the code creature instead.
- Creature kind: far-LOD legs are 8-sided with a ring wherever the coat's colour turns, on rounded paws, so stockings and leg colour survive at LOD2; QA connections no longer flips on a 2–5 % change of chest width or limb thickness.
- `tree` kind: LOD2 is the tree's own LOD0 crown as card clumps over a visible trunk and main limbs (palms: one folded card per frond); silhouette IoU ≥ 0.8 for oak, pine and palm (was 0.55–0.72). `impostor` takes `'clumps' | 'fronds'` (`'blob' | 'cards'` still accepted).
- `cityBlock`: walls use `wallStrip` (default `brick`) at true scale; windows are LOD-gated (LOD1 about 0.2 × LOD0 triangles, LOD2 keeps window rows as dark bands); with `trim`, LOD0 gets a cornice, belt course and plinth.
- `terrainFromDEM`'s default ground no longer bands: welded mesh, classes blended per vertex, rock strata on cut sides. Default output changes; `strips: false` is unchanged.
- QA `skin` (`T3D_SKIN_CROSSED`) reads a paired limb that stands on its roots (raised wings) the right way up.
- A model body whose Blender skin has a bone that is neither the plan's nor a declared `extra` chain fails with `T3D_MODEL_SKELETON` naming the bones; it used to re-bind silently.
- Contact sheet and thumbnail alpha-test cutout cards against the trim sheet, so foliage and fur show their real silhouette.
- See-through parts no longer put what they hold in opaque shadow in the raster hero; they dim the sun instead.
- `rts_faction` builds again: far-LOD tool handles are six-sided, so a grip joint agrees at any heading.
- Shared recipe libraries: mud contrasts with the paint instead of being near-black, `reproject` handles project materials, and the parts kit's hose, ladder, crate and painted door read correctly.
- The gallery binds each asset's own trim sheet instead of one sheet per worker.
- `wolf_hybrid` passes QA `deform` with no declared tolerance: hip stretch ×5.7 → ×2.2 through `isolate`'s `contact: 0.04`; both `limitTolerances` are removed (D253, open since 0.13.0).

### Changed
- Recipes: a quality pass over all 76 committed assets (wear, materials, far-LOD identity, triangle counts). `roadster_v10` ships 155k / 23k / 3k triangles (was 909k / 78k / 5.5k), `hydra` 210k (was 348k), `weather_demo` 21k (was 95k); the over-band baseline went from 44 assets to 10. Every `critique.json` was re-judged by a reviewer other than the author; the typical overall score rose from about 6.3 to 7.0.
- The trim sheet's 14 custom rows are per asset. Define any number of materials; a conflict is two materials on one row in the same asset (`T3D_MATERIAL_CONFLICT` from `compile`), including assets composed with `ctx.use`. `T3D_SHEET_FULL` now means one asset maps onto more than 14.
- Breaking (0.x): `checkSheetFor(sheet, assets)` takes compiled assets, not UVs; `paintTrimSheet(recipe)` throws once two defined materials share a row (use `sheetFor`); `stripCredits` takes an optional material list.
- `t3d build --sheet external` writes an asset's own `trim_sheet_*.png` beside its GLBs when its materials cannot share the run's sheet; `--sheet embed` bytes no longer depend on what else the run loaded. A single-recipe build no longer paints rows of materials it defines but never maps onto.
- `sheet.png` and `thumb.png` show the hero's base colour (trim-sheet albedo × vertex colour, flat per triangle) and draw glass, ice and liquid parts see-through. Wood, bark, leather and terrain no longer read white or grey in the sheet (ADR 007 revisited). Every committed `sheet.png` and `thumb.png` changed. `blueprint.png` stays vertex colour.

---

Older: [0.14.0](0.14.0.md)
1 change: 1 addition & 0 deletions docs/changelog/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ Every published version of `@developerz.ai/ts23d`, newest first: one page each w

| Version | Date | Summary |
|---|---|---|
| [0.15.0](0.15.0.md) | 2026-11-19 | Contact sheets show the hero's base colour, triangle budgets are checked against the playbook bands, custom materials are per asset, and every committed asset was reworked and independently re-judged: criteria below the pass mark of 8 fell from 416 to 352, and two assets now pass on all seven. |
| [0.14.0](0.14.0.md) | 2026-11-19 | Several agents can share one machine through a resource queue, the npm package shrinks from 40 MB to 4 MB, CI runs in under five minutes, and the check that committed renders are fresh now works. |
| [0.13.0](0.13.0.md) | 2026-11-19 | A correctness sweep across the library, CLI, gates, gallery and recipes: over a hundred and fifty defects fixed, stricter input validation and QA gates, track belts that move in any glTF reader, and PNG bytes that no longer depend on the runtime. |
| [0.12.0](0.12.0.md) | 2026-11-18 | Swimming and many-limbed creatures with motion from published biomechanics, one open Blender session for chained work, and brushes for existing meshes. |
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@developerz.ai/ts23d",
"version": "0.14.0",
"version": "0.15.0",
"description": "TypeScript to 3D (ts23d): free, deterministic 3D asset generation in TypeScript — a DSL your coding agent writes, compiled to game-ready glTF. No GPU or credits needed; optional adapters add local GPU models, Blender and hosted services.",
"type": "module",
"license": "MIT",
Expand Down
2 changes: 1 addition & 1 deletion src/export/version.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,5 @@
// constant because the library may not import package.json (rootDir is src); version.test.ts
// fails the gate when the two disagree, and `bun run release` stamps both.

export const VERSION = '0.14.0';
export const VERSION = '0.15.0';
export const GENERATOR = `@developerz.ai/ts23d ${VERSION}`;