ldr 0.33.15 → 0.34.1

package/NOTICE.md

@@ -0,0 +1,21 @@
+# Notices and third-party attribution
+
+`ldr` source code is MIT-licensed (see [LICENSE](LICENSE)). This repository and the artifacts it builds also include or fetch
+third-party material under its own terms:
+
+| Material | Where | License / terms | What we do |
+|---|---|---|---|
+| **LDraw.org Parts Library** | Small frozen subsets committed as test fixtures (`packages/ldr/test/fixtures/ldraw-mini`, `packages/ldr-eval/test/fixtures/ldraw-mini`, a few files in `packages/ldr/test/fixtures`). The full library is **not** committed; it is downloaded from <https://library.ldraw.org/library/updates/complete.zip> by CI and by developers (`LDRAW_DIR`). Parts packs / the demo parts CDN contain geometry compiled from it. | CC BY 2.0 (older files, "Redistributable under CCAL version 2.0") / CC BY 4.0 (newer files); each file keeps its `0 !LICENSE` and `0 Author:` header lines. See <https://www.ldraw.org/legal-info>. | Credit: "LDraw.org Parts Library (CC BY 2.0 / CC BY 4.0)". Apps that ship packs should carry the same credit. |
+| **LDraw Official Model Repository (OMR)** | `models/sources/omr.json` and `models/catalog.json` hold metadata only (set number, name, author, license, source URL). Model files are **not** committed; the demo build downloads them from LDraw.org. | CC BY 2.0 / CC BY 4.0 per file; author named per model. | Author, license and source are shown wherever a model is shown. |
+| **Rebrickable** set and inventory data | Fetched at build time by the demo / MCP server (not committed). | Rebrickable's downloads page permits use of the CSV files for any purpose; credit Rebrickable. | Credited in the demo and MCP output. |
+| **OpenStreetMap / OpenFreeMap / OpenMapTiles / Overture Maps** | City mode fetches data at runtime (not committed). | ODbL 1.0 (OSM, Overture buildings); OpenMapTiles schema attribution. | Attribution embedded in generated models and shown in the demo. |
+| **Poly Haven** models (MCP `sculpt_model`) | Fetched at runtime. | CC0. | — |
+
+## Trademarks
+
+LEGO® is a trademark of the LEGO Group of companies, which does not sponsor, authorize or endorse this project. `ldr` is an
+independent, unofficial project and is not affiliated with the LEGO Group. Set numbers and names are used only to identify the sets
+that community-made LDraw models replicate. LDraw™ is a trademark of the Estate of James Jessiman.
+
+No LEGO building instructions, box art, product photography or other LEGO Group copyrighted material is distributed in this
+repository. Screenshots in `docs/` are renders made with `ldr` of community LDraw models (credited above).

package/README.md

@@ -161,6 +161,18 @@ parts added underneath), preferring front three-quarter views and small turns (t
 `isolate` is set while a sub-assembly is being built: show it on its own with `setStep(step, isolateMask(instances, view.isolate))`.
 Visibility is measured on part bounding boxes, so it needs no GPU and also runs in Node.
 
+**AR Quick Look (USDZ).** `toUSDZ(instances, pack, { maxTriangles?, yUp?, scale? })` → `{ data, triangles, meshes, level }` builds a
+USDZ in the browser (no three.js, no network): one mesh + `UsdPreviewSurface` per colour (LEGO colours in linear RGB, transparent
+colours with `opacity`, chrome / metal as metallic), studs and undersides hidden by neighbours dropped, real size (1 LDU = 0.4 mm,
+Y up, standing on y = 0, centred). It takes the finest pack LOD level (then square studs, then no studs) that fits `maxTriangles`
+(default 200 000). Open it on iOS / iPadOS Safari (feature-detect with `document.createElement("a").relList.supports("ar")`):
+
+```js
+const { data } = toUSDZ(model.instances, model.pack);
+const a = document.createElement("a"); a.rel = "ar"; a.href = URL.createObjectURL(new Blob([data], { type: "model/vnd.usdz+zip" }));
+a.append(document.createElement("img")); a.click(); // Quick Look needs the <img> child
+```
+
 ### `ldr/node` (Node / Bun only)
 
 Everything above, plus:
@@ -182,7 +194,7 @@ All numbers below were measured with the harness in [`bench/`](https://github.co
 - **Baseline:** three.js geometry from `LDrawLoader` merged per part and drawn with `InstancedMesh`, which is the fastest stock approach. Stock `LDrawLoader` scenes crash the tab (OOM) at 50k bricks and above.
 - **ldr settings:** the defaults: LOD pack, distance LOD, low-detail studs, stud and underside culling, single-sided faces, no edges.
 
-Sources: `bench/results/2026-10-18T18-10-46-518Z-falcon-vs-stock.md` (the Falcon rows), `bench/results/latest-perf.md` (the regression gate, `bench/baselines/darwin-apple-m4-pro.json`), `latest-mac-ablation.md`, and `research.md` §7 and Round 19.
+Sources: `bench/results/2026-10-18T18-10-46-518Z-falcon-vs-stock.md` (the Falcon rows), `bench/results/latest-perf.md` (the regression gate, `bench/baselines/darwin-apple-m4-pro.json`), `latest-mac-ablation.md`.
 
 | model | bricks | baseline frame | **ldr frame** | baseline load | **ldr load** |
 |---|---|---|---|---|---|

package/dist/cli.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/cli.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/cli.ts
 import fs4 from "node:fs";
 import zlib from "node:zlib";
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/node/build-pack.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/node/build-pack.ts
 import fs3 from "node:fs";
 import path3 from "node:path";
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/node/resolver.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/node/resolver.ts
 import fs from "node:fs";
 import path from "node:path";
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/spec.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/spec.ts
 var norm = (s) => s.trim().toLowerCase().replace(/\\/g, "/").replace(/\/+/g, "/");
 var COLOUR_ID_RE = /^[A-Za-z][A-Za-z0-9_]*$/;
 var namedCodes = new Map;
@@ -848,7 +848,7 @@ function fileStepViews(f) {
   return out;
 }
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/model.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/model.ts
 class ModelLimitError extends Error {
   limit;
   code = "ldr-model-limit";
@@ -1290,7 +1290,7 @@ function blendedColourHex(code) {
   return "#" + [0, 1, 2].map((k) => (a[k] + b[k] >> 1).toString(16).padStart(2, "0")).join("").toUpperCase();
 }
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/node/resolver.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/node/resolver.ts
 var TOP_STUD_RE = /^(stud|studa|stud2|stud2a|stud6|stud6a|stud10|stud15|stud2s|stud2s2|stud-logo\d*|stud2-logo\d*)\.dat$/i;
 var UNDER_STUD_RE = /^(stud3|stud3a|stud4.*|stud12|stud16.*|stud18a)\.dat$/i;
 var norm2 = (ref) => ref.trim().replace(/\\/g, "/").toLowerCase();
@@ -1617,11 +1617,11 @@ function collectDeps(lib, refs) {
   return out;
 }
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/node/compile.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/node/compile.ts
 import fs2 from "node:fs";
 import path2 from "node:path";
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/node/lod.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/node/lod.ts
 import { MeshoptSimplifier, MeshoptEncoder } from "meshoptimizer";
 await Promise.all([MeshoptSimplifier.ready, MeshoptEncoder.ready]);
 function reorderMesh(P, N, C, I) {
@@ -1927,7 +1927,7 @@ function levelLines(P, I, E, err, always, tol = 0.01) {
   return out;
 }
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/node/compile.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/node/compile.ts
 class BfcState {
   accum;
   ccw = true;
@@ -2871,7 +2871,7 @@ function encodePack(parts, studKinds, weld, extra, options = {}) {
   return Buffer.concat([head, ...chunks.map((c) => new Uint8Array(c.buffer, c.byteOffset, c.byteLength))]);
 }
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/node/build-pack.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/node/build-pack.ts
 function packCompilerOpts(o) {
   return { studs: o.studs ?? "low", prims: o.primitives ?? "full", weld: o.weld ?? true, separateStuds: true, cond: !!o.cond, tex: !!o.textures, ...o.partWorkLimit ? { workLimit: o.partWorkLimit } : {} };
 }
@@ -2944,7 +2944,7 @@ function buildPack(o) {
   return { data: encodePack(parts, kinds, comp.opts.weld, extra, { texture, lod: o.lod !== false, reorder: !!o.reorder }), parts: parts.size, studKinds: kinds.size, missing: [...missing], ...warnings.length ? { warnings } : {} };
 }
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/cli.ts
+// ../../../../../../../tmp/ldr-build-yF6ijm/src/cli.ts
 var HELP = `ldr pack — build a parts pack for the ldr three.js renderer
 
 Usage:

package/dist/index.d.ts

@@ -13,3 +13,4 @@ export { decompressPack, decodeModelText, modelFileName } from "./pack-io.js";
 export { loadModel, loadParts, loadPartsIndex, mergePacks, prepareModel, bodyTriangles, estimateBudgetFromIndex, BudgetError, DEFAULT_PARTS_CDN } from "./cdn.js";
 export type { LoadModelOptions, LoadedModel, LoadPartsOptions, PartsCdnIndex, PrepareOptions, PreparedModel } from "./cdn.js";
 export { embeddedKeys } from "./embedded.js";
+export { toUSDZ, zipStored, type UsdzOptions, type UsdzResult } from "./usdz.js";