From fc7f6b2bf0e97237396a5ea123ddb5ccf9fc7aa7 Mon Sep 17 00:00:00 2001 From: Jonathan Bingham Date: Tue, 17 Nov 2026 01:52:34 +0000 Subject: [PATCH] docs(changelog,ci): restore 1.4.0 boundary, backfill Unreleased, and extract per-tag release notes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Restore the `## [1.4.0] - 2026-11-09 (Beta)` section boundary in `CHANGELOG.md` and backfill all post-`1.4.0` changes, features, and fixes under `## [Unreleased]` (5 parametric domain kits, CAD `SweepGeometry`/`HelixGeometry`/`LoftGeometry`/`PatternInstancer`, ``, per-vertex `COLOR_0`, closed-loop `--visual-turns` visual refinement, `TL601`–`TL606` accessibility linter, `extras.tsl` payload migration, static musl Linux CLI, shadow-caster normal bias fix, and iOS `outline` session rendering). - Add `scripts/extract_release_notes.js` + `three-live/tests/release_notes_test.ts` and update `.github/workflows/release.yml` so GitHub Releases publish only the tagged version's section (falling back to `[Unreleased]` if unstamped) rather than the entire `CHANGELOG.md` history. --- .github/workflows/release.yml | 7 +- CHANGELOG.md | 134 ++++++++++++++++++++--- scripts/extract_release_notes.js | 141 +++++++++++++++++++++++++ three-live/tests/release_notes_test.ts | 141 +++++++++++++++++++++++++ 4 files changed, 409 insertions(+), 14 deletions(-) create mode 100644 scripts/extract_release_notes.js create mode 100644 three-live/tests/release_notes_test.ts diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 0143927..82a3fb9 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -420,11 +420,16 @@ jobs: cp xr-live/dist/xr-live.min.js xr-live/dist/xr-live-viewer.min.js xr-live/dist/xr-live-sensors.min.js xr-live/dist/xr-live-spatial.min.js xr-live/dist/xr-live-sim.min.js xr-live/dist/xr-live-webgpu.min.js xr-live/dist/xr-live-full.min.js dist-release/ ls -la dist-release + - name: Extract current version release notes from CHANGELOG.md + env: + TAG: ${{ github.ref_name }} + run: node scripts/extract_release_notes.js CHANGELOG.md "${TAG}" release-notes.md + - name: Publish GitHub Release uses: softprops/action-gh-release@3bb12739c298aeb8a4eeaf626c5b8d85266b0e65 # v2 with: files: dist-release/* - body_path: CHANGELOG.md + body_path: release-notes.md env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/CHANGELOG.md b/CHANGELOG.md index fdaa647..9715973 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -58,13 +58,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `TL403` warnings whenever HTML attributes or inline `userData.xr.*` traits use capabilities omitted from the host element. -- **Self-contained Apple framework:** `ThreeLiveCompiler.xcframework` exports - only the C ABI (`three_live_*`). Rust's standard library, compiler-rt and - the compiler's crates are hidden (`scripts/build_ios_xcframework.sh` - pre-links each slice with `mobile/ios/exported_symbols.txt`; - `scripts/verify_xcframework.sh` rejects any other exported symbol), so the - framework links into apps that already carry another Rust library without - duplicate symbols. +- **TSL node-graph glTF payload moved to `gltf.materials[i].extras.tsl`:** + Replaces the `1.4.0` `extensions.GOOGLE_material_tsl` wrapper across Web, + Rust, Android, and iOS so procedural `THREE.TSL` shader graphs serialize as + standard glTF material `extras` without custom `extensionsUsed` entries. + +- **Self-contained Apple XCFrameworks & static musl Linux CLI binaries:** + `ThreeLiveCompiler.xcframework` and `ThreeLiveKernels.xcframework` pre-link + every slice with explicit exported C ABI symbol lists + (`scripts/verify_xcframework.sh`), hiding Rust stdlib, `compiler-rt`, and + crate symbols so host apps that already link another Rust library never hit + duplicate symbols. Prebuilt Linux `three-live-cli` binaries now link + statically against musl for zero-GLIBC compatibility on minimal Debian + (`bookworm-slim` / `trixie-slim`), Alpine, and Docker MCP containers. ### Added @@ -97,13 +103,115 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). - **Boa-Free Native Kernels C ABI (`compiler/include/three_live_kernels.h`):** Cargo feature split (`kernels`, `boa`, `cli`, `wasm`, `jni`) exposing 24 self-describing - geometry, CSG, procedural PBR texture, PNG/DEFLATE, UTF-8, and USDZ - kernels via `three_live_kernels_table(&count)` + - `three_live_kernel_free`, with GLB serialization unified on - `three-convert.ts::sceneToGLB`. + geometry, CSG, procedural PBR texture, PNG/JPEG decode, and USDZ kernels + via `three_live_kernels_table(&count)` + `three_live_kernel_free`, with + GLB serialization unified on `three-convert.ts::sceneToGLB`. + +- **Five A-la-Carte Parametric Domain Kits (`three-live-kit-*` & + `three-live-kits.min.js`, 57 2-manifold constructors):** Opt-in domain kits + (intentionally excluded from `three-live-full.min.js`) available + individually (`12 to 30 KB gz` each) or combined in `three-live-kits.min.js` + (`< 82 KB gz`), built into the native compiler, and showcased in the + 153-variant Domain Kits Visual Catalog (`examples/kits/`, + `docs/kits-gallery.md`): + + - **`THREE.Mechanical` (`three-live-kit-mechanical.min.js`, 15 parts):** + `SpurGearGeometry`, `BevelGearGeometry`, `InternalRingGearGeometry`, + `RackGeometry`, `PulleyGeometry`, `BoltGeometry`, `NutGeometry`, + `WasherGeometry`, `ShaftGeometry`, `ShaftCouplerGeometry`, + `BearingGeometry`, `PillowBlockGeometry`, `HelicalSpringGeometry`, + `FlangePlateGeometry`, `ProfileExtrusionGeometry`, `metricFastener`, and + `gearMeshDistance`. + - **`THREE.Architecture` (`three-live-kit-architecture.min.js`, 9 + parts):** `WallGeometry`, `SlabGeometry`, `StaircaseGeometry`, + `RoofGeometry`, `DoorGeometry`, `WindowGeometry`, `RailingGeometry`, + `ColumnGeometry`, `ArchwayGeometry`, and IBC `codeStairSpec`. + - **`THREE.Industrial` (`three-live-kit-industrial.min.js`, 10 parts):** + `PipeRunGeometry`, `PipeFittingGeometry`, `ValveGeometry`, + `CentrifugalPumpGeometry`, `PalletRackGeometry`, `ConveyorGeometry`, + `IndustrialLadderGeometry`, `CatwalkPlatformGeometry`, + `SafetyBarrierGeometry`, `StorageTankGeometry`, and ASME + `nominalPipeSpec`. + - **`THREE.Science` (`three-live-kit-science.min.js`, 14 parts):** + `MoleculeGeometry`, `RibbonGeometry` + `ribbonColorMap`, + `CrystalLatticeGeometry`, `AtomicOrbitalGeometry`, + `OpticalElementGeometry`, `SurfacePlotGeometry`, + `ParametricSurfaceGeometry`, `VectorFieldGeometry`, + `IsoSurfaceGeometry`, `StreamlineGeometry`, `Axes3DGeometry`, + `DoubleHelixGeometry`, `DashedLineGeometry`, `AngleArcGeometry`, + `sampleColormap` / `colormapTexture` / `applyVertexColormap`, and + 44-element IUPAC `elementSpec`. + - **`THREE.Electronics` (`three-live-kit-electronics.min.js`, 9 parts):** + `PcbBoardGeometry`, `EnclosureGeometry`, `HeatsinkGeometry`, + `DinRailGeometry`, `IcPackageGeometry`, `PinHeaderGeometry`, + `ConnectorGeometry`, `StandoffSpacerGeometry`, + `DiscreteComponentGeometry`, and `jedecPackageSpec`. + +- **3D CAD Sweeps, Helices, Multi-Profile Lofts & `PatternInstancer` + (`three-live-cad`):** Added Bishop-frame `SweepGeometry`, `HelixGeometry` + (`HelixCurve3`), 3D `extrudePath` support on `ExtrudeGeometry`, + multi-profile `LoftGeometry` (including hollow-vessel `wallThickness`, + crease-aware normals, and closed-loop seam welding), and declarative + `PatternInstancer` (`linear`, `grid`, `circular`, `alongCurve`, + `toGeometry`, plus `InstancedMesh` operands in `CSG`). + +- **Core `` CAD Cutaways:** + `` (`el.sectionPlane`, `"-z:0.5"`, + `"none"`) clips WebGL2 color, WebGPU, and shadow-depth passes directly on + `` without requiring ``. + +- **End-to-End Per-Vertex Colors (`COLOR_0` & USDZ `primvars:displayColor`):** + Preserves `geometry.setAttribute('color', ...)` across `.glb` (`COLOR_0`), + WebGL2, WebGPU, the native software rasterizer, and `.usdz` + (`primvars:displayColor`). + +- **Closed-Loop Visual AI Refinement (`--visual-turns N` / `visualTurns`) & + Live Playground AI Editing:** Multi-turn multimodal render-critique-repair + loop across `three-live-cli from-image --visual-turns N`, MCP + `three_live_from_image`, and Web + `el.compileFromImage(..., { visualTurns })`, plus BYOA live AI editing, 6 + curated studio presets with instant Sample AI Edit chips across Web, Android + Compose, and iOS SwiftUI examples, and `docs/why-three-live.md`. + +- **Built-In 3D/XR Accessibility Linter (`TL601`–`TL606`):** Static WCAG + 2.1/2.2 & W3C XAUR accessibility diagnostics in `three-live-cli validate` / + `compile` and MCP tools covering non-text luminance contrast (`>= 3.0:1`), + vestibular motion / reduced-motion safety, interactive target sizing, and + spatial accessibility metadata, alongside contrast-verified kit catalog + palettes. + +### Fixed + +- **Opaque-Origin Static HTML Hosting (`file://` & Sandboxed `