diff --git a/CHANGELOG.md b/CHANGELOG.md index 6e65fe02..8c9e880d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 @@ -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//{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 diff --git a/docs/changelog/0.14.0.md b/docs/changelog/0.14.0.md index 04eb10e5..017f1410 100644 --- a/docs/changelog/0.14.0.md +++ b/docs/changelog/0.14.0.md @@ -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) diff --git a/docs/changelog/0.15.0.md b/docs/changelog/0.15.0.md new file mode 100644 index 00000000..756fabfe --- /dev/null +++ b/docs/changelog/0.15.0.md @@ -0,0 +1,46 @@ + + +# 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: `. 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) diff --git a/docs/changelog/README.md b/docs/changelog/README.md index 9f0b0d19..7d3b06dd 100644 --- a/docs/changelog/README.md +++ b/docs/changelog/README.md @@ -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. | diff --git a/package.json b/package.json index 37c9e9d8..966946a1 100644 --- a/package.json +++ b/package.json @@ -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", diff --git a/src/export/version.ts b/src/export/version.ts index aaaf0e40..c188fdbb 100644 --- a/src/export/version.ts +++ b/src/export/version.ts @@ -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}`;