ldr 0.33.15 → 0.34.0

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:

package/dist/cli.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/cli.ts
+// ../../../../../../../tmp/ldr-build-UFH0qj/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-UFH0qj/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-UFH0qj/src/node/resolver.ts
 import fs from "node:fs";
 import path from "node:path";
 
-// ../../../../../../../tmp/ldr-build-uD3Q4M/src/spec.ts
+// ../../../../../../../tmp/ldr-build-UFH0qj/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-UFH0qj/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-UFH0qj/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-UFH0qj/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-UFH0qj/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-UFH0qj/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-UFH0qj/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-UFH0qj/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";