@threenative/assets 0.3.7 → 0.3.9

package/dist/apply-worker.js

@@ -15563,9 +15563,9 @@ function readTextureQuality(value) {
   const row = value;
   const positive = (v) => typeof v === "number" && Number.isSafeInteger(v) && v > 0;
   const bounded = (v, min2, max2) => typeof v === "number" && Number.isFinite(v) && v >= min2 && v <= max2;
-  if (row.version !== IMAGE_QUALITY_VERSION || ![row.width, row.height, row.sourceWidth, row.sourceHeight].every(positive) || !bounded(row.ssim, -1, 1) || row.meanDeltaE00 !== null && !bounded(row.meanDeltaE00, 0, Number.POSITIVE_INFINITY) || !["pass", "below-floor", "unvalidated-slots"].includes(row.status) || !Array.isArray(row.slots) || !row.slots.every((slot) => typeof slot === "string") || !["uastc", "etc1s", "none"].includes(row.codec) || row.compressionSkipped !== void 0 && !["block-size", "not-smaller", "below-floor"].includes(row.compressionSkipped) || !bounded(row.floor?.ssim, 0, 1) || !bounded(row.floor?.meanDeltaE00, 0, Number.POSITIVE_INFINITY) || row.rung !== void 0 && !["etc1s@150", "uastc+rdo \u03BB3 +zstd", "uastc+rdo \u03BB1 +zstd", "uastc", "none"].includes(
+  if (row.version !== IMAGE_QUALITY_VERSION || ![row.width, row.height, row.sourceWidth, row.sourceHeight].every(positive) || !bounded(row.ssim, -1, 1) || row.meanDeltaE00 !== null && !bounded(row.meanDeltaE00, 0, Number.POSITIVE_INFINITY) || !["pass", "below-floor", "unvalidated-slots"].includes(row.status) || !Array.isArray(row.slots) || !row.slots.every((slot) => typeof slot === "string") || !["uastc", "etc1s", "jpeg", "none"].includes(row.codec) || row.compressionSkipped !== void 0 && !["block-size", "not-smaller", "below-floor"].includes(row.compressionSkipped) || !bounded(row.floor?.ssim, 0, 1) || !bounded(row.floor?.meanDeltaE00, 0, Number.POSITIVE_INFINITY) || row.rung !== void 0 && !["etc1s@150", "uastc+rdo \u03BB3 +zstd", "uastc+rdo \u03BB1 +zstd", "uastc", "none"].includes(
     row.rung
-  ) && !/^etc1s@\d+$/u.test(row.rung) || !bounded(row.alpha?.ssim, -1, 1) || !bounded(row.alpha?.meanAbsoluteError, 0, 1) || !Array.isArray(row.alpha?.coverage) || !row.alpha.coverage.every(
+  ) && !/^etc1s@\d+$/u.test(row.rung) && !/^jpeg@\d+$/u.test(row.rung) || !bounded(row.alpha?.ssim, -1, 1) || !bounded(row.alpha?.meanAbsoluteError, 0, 1) || !Array.isArray(row.alpha?.coverage) || !row.alpha.coverage.every(
     (c) => c !== null && typeof c === "object" && bounded(c.threshold, 0, 1) && [c.source, c.decoded, c.changedPixels].every(
       (v) => Number.isSafeInteger(v) && v >= 0 && v <= row.width * row.height
     )
@@ -20110,7 +20110,7 @@ function scriptsDirectory() {
     // Built: `dist/index.js` sits beside `dist/blender-gpl/`.
     path2.join(here, "blender-gpl"),
     // Source: `src/passes/` -> the workspace sibling.
-    path2.resolve(here, "..", "..", "..", "blender-mcp", "gpl")
+    path2.resolve(here, "..", "..", "..", "blender-bridge", "gpl")
   ];
   const found = candidates.find((candidate) => existsSync(path2.join(candidate, "convert.py")));
   if (found === void 0) {
@@ -20531,6 +20531,7 @@ function bakeStaticLightmap(document, width, height, padding) {
     width
   };
 }
+var BASIS_TRANSCODER_BYTES = 600 * 1024;
 var DEFAULT_MAX_SIZE = 2048;
 var DEFAULT_ETC1S_QUALITY = 150;
 var BLOCK_SIZE = 4;
@@ -20825,6 +20826,29 @@ async function encodeTextureLadder(data, width, height, options) {
   if (smallest !== void 0) return smallest;
   throw new Error("TN_ASSETS_TEXTURE_FLOOR: forced codec fails its configured floor.");
 }
+var JPEG_QUALITY_RUNGS = [75, 80, 85, 90];
+async function encodeJpegCandidate(data, width, height, options) {
+  const sharp = (await import('sharp')).default;
+  for (const quality of JPEG_QUALITY_RUNGS) {
+    const buffer = await sharp(Buffer.from(data), {
+      raw: { channels: 4, height, width }
+    }).jpeg({ mozjpeg: true, quality }).toBuffer();
+    const decoded = await decodeImageBytes(buffer, "jpeg-candidate");
+    const score = imageQuality(data, decoded.data, width, height, options);
+    if (score.status !== "pass" || score.alpha.meanAbsoluteError !== 0) continue;
+    return {
+      buffer,
+      quality: {
+        ...score,
+        codec: "jpeg",
+        rung: `jpeg@${String(quality)}`,
+        sourceHeight: height,
+        sourceWidth: width
+      }
+    };
+  }
+  return void 0;
+}
 function gpuBytes(width, height, codec) {
   return Math.round(width * height * (GPU_BYTES_PER_PIXEL[codec] ?? 4) * MIP_FACTOR);
 }
@@ -20836,6 +20860,7 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
   const textures = root.listTextures();
   if (textures.length === 0) return void 0;
   const decoderFree = options.decoderFree === true;
+  const transcoderBytes = Math.max(0, options.transcoderBytes ?? BASIS_TRANSCODER_BYTES);
   const quality = Math.min(255, Math.max(1, Math.round(options.quality ?? DEFAULT_ETC1S_QUALITY)));
   const keys = textureKeys(root);
   const formats = {};
@@ -20847,6 +20872,9 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
   let gpuBytesAfter = 0;
   let resized = 0;
   let compressed = 0;
+  let transcoderSavings = 0;
+  let transcoderRequired = false;
+  const transcoderByImage = {};
   for (const [index, texture] of textures.entries()) {
     const key = keys[index] ?? `texture#${String(index)}`;
     const image = texture.getImage();
@@ -20875,6 +20903,15 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
         if (shape.width !== score.sourceWidth || shape.height !== score.sourceHeight) resized += 1;
       }
       if (fromStore.codec !== "none") compressed += 1;
+      if (fromStore.transcoderSavings !== void 0)
+        transcoderSavings += fromStore.transcoderSavings;
+      if (fromStore.transcoderRequired === true) transcoderRequired = true;
+      if (fromStore.transcoderSavings !== void 0 || fromStore.transcoderRequired === true) {
+        transcoderByImage[key] = {
+          ...fromStore.transcoderSavings === void 0 ? {} : { savings: fromStore.transcoderSavings },
+          ...fromStore.transcoderRequired === true ? { required: true } : {}
+        };
+      }
       continue;
     }
     const slots = listTextureSlots(texture);
@@ -20890,6 +20927,10 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
       }
     }
     if (texture.getMimeType() === "image/ktx2" && !authoredBasis) {
+      if (!isRawAstc(texture)) {
+        transcoderRequired = true;
+        transcoderByImage[key] = { ...transcoderByImage[key], required: true };
+      }
       const shape = imageShape(image, "image/ktx2");
       bytesBefore += image.byteLength;
       bytesAfter += image.byteLength;
@@ -21006,6 +21047,14 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
         };
       continue;
     }
+    const authoredContainer = !explicit && !authoredBasis && options.jpeg !== false && options.astc !== true && target.width === decoded.width && target.height === decoded.height && UNIVERSAL_IMAGE_CONTAINERS.has(texture.getMimeType()) && slots.some((slot) => COLOUR_SLOTS.has(slot));
+    const jpeg = authoredContainer ? await encodeJpegCandidate(data, target.width, target.height, {
+      ...textureQualitySemantics(texture),
+      floor: options.floor
+    }) : void 0;
+    const jpegLimit = jpeg !== void 0 && jpeg.buffer.byteLength < image.byteLength ? jpeg.buffer.byteLength : image.byteLength;
+    const automatic = !explicit && target.width === decoded.width && target.height === decoded.height && UNIVERSAL_IMAGE_CONTAINERS.has(texture.getMimeType());
+    const charged = automatic && options.astc !== true;
     let selected;
     try {
       if (authoredBasis && target.width === decoded.width && target.height === decoded.height) {
@@ -21035,7 +21084,7 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
           srgb,
           quality,
           ...options.astc === true ? { astc: true, gltfColorPrimaries: srgb ? 1 : 0 } : {},
-          ...!explicit && target.width === decoded.width && target.height === decoded.height && UNIVERSAL_IMAGE_CONTAINERS.has(texture.getMimeType()) ? { maxBytes: image.byteLength } : {},
+          ...automatic ? { maxBytes: jpegLimit } : {},
           ...forced === void 0 ? {} : { forced }
         });
       }
@@ -21047,7 +21096,21 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
       if (!authoredBasis) throw error;
       throw new Error(`TN_ASSETS_MODEL_BASIS_ASTC: '${logicalPath}#${key}': ${messageOf2(error)}`);
     }
-    const encoded = selected.encoded;
+    let encoded = selected.encoded;
+    if (charged && encoded !== void 0) {
+      const savings = jpegLimit - encoded.byteLength;
+      transcoderSavings += savings;
+      if (savings > 0) transcoderByImage[key] = { ...transcoderByImage[key], savings };
+      if (encoded.byteLength >= jpegLimit - transcoderBytes) encoded = void 0;
+    }
+    if (encoded === void 0 && jpeg !== void 0 && jpeg.buffer.byteLength < image.byteLength) {
+      texture.setImage(jpeg.buffer).setMimeType("image/jpeg");
+      bytesAfter += jpeg.buffer.byteLength;
+      gpuBytesAfter += gpuBytes(target.width, target.height, "none");
+      formats[key] = "none";
+      if (options.measureQuality !== false) scores[key] = jpeg.quality;
+      continue;
+    }
     if (encoded === void 0 || encoded.byteLength >= image.byteLength && target.width === decoded.width && target.height === decoded.height && !explicit && UNIVERSAL_IMAGE_CONTAINERS.has(texture.getMimeType())) {
       const downsampled = target.width !== decoded.width || target.height !== decoded.height;
       let retained = image;
@@ -21090,6 +21153,10 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
       };
     }
     texture.setImage(encoded).setMimeType("image/ktx2");
+    if (!charged && options.astc !== true) {
+      transcoderRequired = true;
+      transcoderByImage[key] = { ...transcoderByImage[key], required: true };
+    }
     formats[key] = options.astc === true ? "astc4x4" : selected.codec;
     bytesAfter += encoded.byteLength;
     gpuBytesAfter += gpuBytes(target.width, target.height, formats[key] ?? selected.codec);
@@ -21117,7 +21184,10 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
     gpuBytesAfter,
     gpuBytesBefore,
     resized,
-    skippedCompression
+    skippedCompression,
+    ...transcoderSavings > 0 ? { transcoderSavings } : {},
+    ...transcoderRequired ? { transcoderRequired: true } : {},
+    ...Object.keys(transcoderByImage).length === 0 ? {} : { transcoderByImage }
   };
 }
 function textureQualitySemantics(texture) {
@@ -21175,12 +21245,6 @@ function texturePass(options = {}) {
     },
     apply: async (input, logicalPath) => {
       if (classify2(logicalPath) !== "texture") return input;
-      const stats = textureStats(input);
-      if (stats.width <= 0 || stats.height <= 0) {
-        throw new Error(
-          `TN_ASSETS_TEXTURE_UNREADABLE: '${logicalPath}' has no readable PNG/JPEG header; the KTX2 pass cannot encode it.`
-        );
-      }
       const decoded = await decodeImageBytes(input, logicalPath);
       const choice = texturePolicy(logicalPath, options);
       if (choice.codec === "none")
@@ -22609,6 +22673,90 @@ function resolveCompactOptions(options) {
   };
 }
 
+// src/passes/glb-spec-defaults.ts
+var JSON_CHUNK = 1313821514;
+var HEADER = 12;
+function withoutSpecDefaults(glb) {
+  if (glb.readUInt32LE(16) !== JSON_CHUNK) return glb;
+  const jsonLength = glb.readUInt32LE(12);
+  const json = JSON.parse(glb.subarray(20, 20 + jsonLength).toString("utf8"));
+  for (const accessor of json.accessors ?? []) {
+    if (accessor.normalized === false) accessor.normalized = void 0;
+    if (accessor.byteOffset === 0) accessor.byteOffset = void 0;
+  }
+  for (const view of json.bufferViews ?? []) if (view.byteOffset === 0) view.byteOffset = void 0;
+  for (const animation of json.animations ?? [])
+    for (const sampler of animation.samplers)
+      if (sampler.interpolation === "LINEAR") sampler.interpolation = void 0;
+  const text = Buffer.from(JSON.stringify(json), "utf8");
+  const padded2 = Buffer.alloc(Math.ceil(text.length / 4) * 4, 32);
+  text.copy(padded2);
+  const rest = glb.subarray(HEADER + 8 + jsonLength);
+  const head = Buffer.alloc(HEADER + 8);
+  glb.copy(head, 0, 0, HEADER);
+  head.writeUInt32LE(HEADER + 8 + padded2.length + rest.length, 8);
+  head.writeUInt32LE(padded2.length, 12);
+  head.writeUInt32LE(JSON_CHUNK, 16);
+  return Buffer.concat([head, padded2, rest]);
+}
+
+// src/passes/prune-rest-tracks.ts
+var COMPONENTS = { rotation: 4, scale: 3, translation: 3 };
+var REST_TOLERANCE = 1e-6;
+function restOf(node, path7) {
+  if (path7 === "rotation") return node.getRotation();
+  return path7 === "translation" ? node.getTranslation() : node.getScale();
+}
+function holdsRest(channel) {
+  const path7 = channel.getTargetPath();
+  const node = channel.getTargetNode();
+  const output = channel.getSampler()?.getOutput();
+  if (path7 === null || !(path7 in COMPONENTS) || node === null || !output) return false;
+  const rest = restOf(node, path7);
+  const element = new Array(COMPONENTS[path7]).fill(0);
+  for (let key = 0; key < output.getCount(); key += 1) {
+    output.getElement(key, element);
+    if (element.some((value, c) => Math.abs(value - (rest[c] ?? 0)) > REST_TOLERANCE)) return false;
+  }
+  return output.getCount() > 0;
+}
+var lastKey = (channel) => {
+  const input = channel.getSampler()?.getInput();
+  return input === null || input === void 0 ? 0 : input.getMax([0])[0] ?? 0;
+};
+function dropChannel(animation, channel) {
+  const sampler = channel.getSampler();
+  animation.removeChannel(channel);
+  channel.dispose();
+  const shared = sampler?.listParents().some((parent) => parent !== animation && parent.propertyType === "AnimationChannel");
+  if (sampler === null || sampler === void 0 || shared === true) return;
+  animation.removeSampler(sampler);
+  sampler.dispose();
+}
+function pruneRestPoseTracks(document, logicalPath) {
+  let dropped = 0;
+  let total = 0;
+  for (const animation of document.getRoot().listAnimations()) {
+    const kept = new Set(animation.listChannels());
+    total += kept.size;
+    const duration = Math.max(0, ...[...kept].map(lastKey));
+    for (const channel of animation.listChannels()) {
+      if (kept.size === 1 || !holdsRest(channel)) continue;
+      kept.delete(channel);
+      if (Math.max(0, ...[...kept].map(lastKey)) < duration) kept.add(channel);
+      else {
+        dropChannel(animation, channel);
+        dropped += 1;
+      }
+    }
+  }
+  if (dropped > 0 && logicalPath !== void 0)
+    console.log(
+      `animation ${logicalPath}: dropped ${String(dropped)} of ${String(total)} tracks that hold the rest pose`
+    );
+  return { dropped, total };
+}
+
 // src/passes/quantize-static.ts
 async function quantizeStaticGeometry(document, quantize2) {
   const held = holdDeformingMeshes(document);
@@ -22773,6 +22921,14 @@ function parseFileName(name) {
   if (key === void 0 || codec === void 0 || mimeType === void 0) return void 0;
   return { codec, key, mimeType };
 }
+function readTranscoderRecord(value) {
+  if (typeof value !== "object" || value === null) return {};
+  const record = value;
+  return {
+    ...typeof record.savings === "number" && Number.isFinite(record.savings) && record.savings > 0 ? { transcoderSavings: record.savings } : {},
+    ...record.required === true ? { transcoderRequired: true } : {}
+  };
+}
 function sharedImageKey(source, settings) {
   return createHash("sha256").update(source).update(JSON.stringify(settings), "utf8").digest("hex").slice(0, KEY_LENGTH);
 }
@@ -22849,6 +23005,17 @@ function createSharedImageStore(outputRoot, options = {}) {
               return {};
             throw error;
           }
+        })(),
+        ...await (async () => {
+          try {
+            return readTranscoderRecord(
+              JSON.parse(await readFile(path2.join(directory, `${name}.transcoder.json`), "utf8"))
+            );
+          } catch (error) {
+            if (error.code === "ENOENT" || error instanceof SyntaxError)
+              return {};
+            throw error;
+          }
         })()
       };
       memory.set(key, image);
@@ -22860,7 +23027,8 @@ function createSharedImageStore(outputRoot, options = {}) {
       if (directory === void 0 || options.writeThrough === false) return;
       const name = fileNameFor(key, image);
       const known = await onDisk();
-      if (known.has(key) && image.quality === void 0) return;
+      if (known.has(key) && image.quality === void 0 && image.transcoderSavings === void 0 && image.transcoderRequired !== true)
+        return;
       await mkdir(directory, { recursive: true });
       const target = path2.join(directory, name);
       const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;
@@ -22881,6 +23049,23 @@ function createSharedImageStore(outputRoot, options = {}) {
           await rm(qualityTemporary, { force: true }).catch(() => void 0);
         }
       }
+      if (image.transcoderSavings !== void 0 || image.transcoderRequired === true) {
+        const transcoderTarget = `${target}.transcoder.json`;
+        const transcoderTemporary = `${transcoderTarget}.${process.pid}.${randomUUID()}.tmp`;
+        try {
+          await writeFile(
+            transcoderTemporary,
+            `${JSON.stringify({
+              ...image.transcoderSavings === void 0 ? {} : { savings: image.transcoderSavings },
+              ...image.transcoderRequired === true ? { required: true } : {}
+            })}
+`
+          );
+          await rename(transcoderTemporary, transcoderTarget);
+        } finally {
+          await rm(transcoderTemporary, { force: true }).catch(() => void 0);
+        }
+      }
       known.set(key, name);
     }
   };
@@ -23003,6 +23188,7 @@ async function readSharedGlb(io, buffer, resolve2) {
 var DRACO_EXTENSION2 = "KHR_draco_mesh_compression";
 var EXT_MESHOPT_EXTENSION = "EXT_meshopt_compression";
 var MATERIAL_MERGE_VERSION = 1;
+var SHARED_TRANSCODER_ACCOUNTING_VERSION = 1;
 var MODEL_DEDUPE_VERSION = 1;
 var MODEL_REORDER_VERSION = 1;
 var MODEL_QUANTIZE_VERSION = 1;
@@ -23032,7 +23218,7 @@ async function writeDocument(document, logicalPath, vertexLayout = "interleaved"
   await MeshoptEncoder.ready;
   const io = new NodeIO().setVertexLayout(vertexLayout === "separate" ? VertexLayout.SEPARATE : VertexLayout.INTERLEAVED).registerExtensions([...ALL_EXTENSIONS, EXTTextureAstc, TNVirtualGeometry, TNDiscreteLod]).registerDependencies({ "meshopt.encoder": MeshoptEncoder });
   try {
-    const buffer = Buffer.from(await io.writeBinary(document));
+    const buffer = withoutSpecDefaults(Buffer.from(await io.writeBinary(document)));
     return { buffer, extensions: jsonOfGlb(buffer).extensionsUsed ?? [] };
   } catch (error) {
     const detail = error instanceof Error ? error.message : String(error);
@@ -23406,7 +23592,8 @@ function modelPass(options = {}) {
         meshopt: options.passes?.meshopt ?? true,
         prune: options.passes?.prune ?? true,
         quantize: options.passes?.quantize ?? true,
-        reorder: options.passes?.reorder ?? true
+        reorder: options.passes?.reorder ?? true,
+        restTracks: options.passes?.restTracks ?? true
       },
       ...options.vertexLayout === void 0 ? {} : { vertexLayout: options.vertexLayout },
       quantize: {
@@ -23441,13 +23628,17 @@ function modelPass(options = {}) {
         bakeVersion: VIRTUAL_BAKE_VERSION
       },
       sharedImages: options.sharedImages !== void 0,
+      ...options.sharedImages === void 0 ? {} : { sharedTranscoderAccounting: SHARED_TRANSCODER_ACCOUNTING_VERSION },
       textures: options.textures === "none" ? "none" : {
         ...options.textures?.astc === true ? { astc: "raw4x4-gltf-authored-basis-v2" } : {},
         decoderFree: options.textures?.decoderFree ?? false,
         encoder: KTX2_ENCODER_VERSION,
         instrument: IMAGE_QUALITY_IDENTITY,
+        jpeg: options.textures?.jpeg ?? null,
+        jpegLadder: "colour-opaque-q75-90-v1",
         floor: resolveImageQualityFloor(options.textures?.floor),
         maxSize: options.textures?.maxSize ?? null,
+        transcoderBytes: options.textures?.transcoderBytes ?? null,
         // Retention is now conditioned on the container, so it is spelled out rather than
         // named by a boolean: a warm cache keyed on the old rule would keep shipping the
         // WebP-requiring models this replaced.
@@ -23468,7 +23659,8 @@ function modelPass(options = {}) {
         meshopt: passes2.meshopt ?? true,
         prune: passes2.prune ?? true,
         quantize: passes2.quantize ?? true,
-        reorder: passes2.reorder ?? true
+        reorder: passes2.reorder ?? true,
+        restTracks: passes2.restTracks ?? true
       };
       const textureOptions = options.textures === "none" ? void 0 : options.textures ?? {};
       const virtualOptions = options.virtual === "none" ? void 0 : options.virtual ?? {};
@@ -23486,6 +23678,7 @@ function modelPass(options = {}) {
       if (enabled.dedup) await dedup()(document);
       const namesBeforeCompact = compactRequested(options.compact) ? sceneNodeNames(document) : void 0;
       let compact = compactRequested(options.compact) ? await compactModel(document, resolveCompactOptions(options.compact)) : void 0;
+      if (enabled.restTracks) pruneRestPoseTracks(document, logicalPath);
       if (enabled.prune) {
         await prune({ keepAttributes: options.preserveLightmapUv === true })(document);
         if (compact !== void 0 && namesBeforeCompact !== void 0) {
@@ -23543,7 +23736,8 @@ function modelPass(options = {}) {
           store,
           shared,
           embeddedTextures?.formats,
-          embeddedTextures?.quality
+          embeddedTextures?.quality,
+          embeddedTextures?.transcoderByImage
         );
       if (enabled.meshopt) {
         document.createExtension(EXTMeshoptCompression).setRequired(true).setEncoderOptions({ method: EXTMeshoptCompression.EncoderMethod.QUANTIZE });
@@ -23616,11 +23810,14 @@ function sharedSettings(texture, textureOptions) {
       decoderFree: textureOptions.decoderFree ?? false,
       encoder: KTX2_ENCODER_VERSION,
       instrument: IMAGE_QUALITY_IDENTITY,
+      jpeg: textureOptions.jpeg ?? null,
+      jpegLadder: "colour-opaque-q75-90-v1",
       floor: resolveImageQualityFloor(textureOptions.floor),
       keepSmallerSource: "universal-containers",
       maxSize: resolveTextureMaxSize(textureOptions.maxSize, listTextureSlots(texture)),
       overrides: textureOptions.overrides ?? [],
-      quality: textureOptions.quality ?? null
+      quality: textureOptions.quality ?? null,
+      transcoderBytes: textureOptions.transcoderBytes ?? null
     }
   };
 }
@@ -23644,7 +23841,9 @@ async function recallSharedImages(document, store, textureOptions) {
     recalled.set(index, {
       codec: stored.codec,
       sourceBytes: image.byteLength,
-      quality: stored.quality
+      quality: stored.quality,
+      ...stored.transcoderSavings === void 0 ? {} : { transcoderSavings: stored.transcoderSavings },
+      ...stored.transcoderRequired === true ? { transcoderRequired: true } : {}
     });
   }
   return { keys, recalled };
@@ -23653,7 +23852,7 @@ function codecOf(mimeType, formats, name) {
   if (mimeType !== "image/ktx2") return "none";
   return formats?.[name] ?? "uastc";
 }
-async function rememberSharedImages(document, store, plan, formats, quality) {
+async function rememberSharedImages(document, store, plan, formats, quality, transcoder) {
   const textures = document.getRoot().listTextures();
   const names = textureKeys(document.getRoot());
   for (const [index, texture] of textures.entries()) {
@@ -23661,11 +23860,15 @@ async function rememberSharedImages(document, store, plan, formats, quality) {
     const key = plan.keys[index];
     const image = texture.getImage();
     if (key === void 0 || key === "" || image === null) continue;
+    const name = names[index] ?? "";
+    const contribution = transcoder?.[name];
     await store.put(key, {
       buffer: Buffer.from(image.buffer, image.byteOffset, image.byteLength),
-      codec: codecOf(texture.getMimeType(), formats, names[index] ?? ""),
+      codec: codecOf(texture.getMimeType(), formats, name),
       mimeType: texture.getMimeType(),
-      ...quality?.[names[index] ?? ""] === void 0 ? {} : { quality: quality?.[names[index] ?? ""] }
+      ...quality?.[name] === void 0 ? {} : { quality: quality?.[name] },
+      ...contribution?.savings === void 0 ? {} : { transcoderSavings: contribution.savings },
+      ...contribution?.required === true ? { transcoderRequired: true } : {}
     });
   }
 }
@@ -23678,6 +23881,8 @@ function declareSharedImage(store, logicalPath, auxiliaryOutputs, candidate) {
     metadata: {
       codec: candidate.image.codec,
       key: candidate.key,
+      transcoderRequired: candidate.image.transcoderRequired === true,
+      transcoderSavings: candidate.image.transcoderSavings ?? 0,
       ...candidate.image.quality === void 0 ? {} : { quality: candidate.image.quality }
     },
     outputPath,

package/dist/index.d.ts

@@ -32,25 +32,6 @@ interface ITextureQuality extends IImageQuality {
     readonly codec: string;
 }
 
-/**
- * Compresses the images embedded *inside* a `.glb` — the half of a model the geometry passes
- * never touched. A prop carrying three 2048x2048 JPEGs is a small file and 67 MB of VRAM once
- * the driver decodes it; meshopt shrinks the other, cheaper half. This stage transcodes each
- * embedded image to KTX2/Basis and declares `KHR_texture_basisu`, so the GPU stores blocks
- * instead of RGBA, and caps the resolution so a 4K texture an image model produced cannot
- * silently eat a phone's whole budget.
- *
- * Slot constraints feed one measured ladder: normal/data slots retain UASTC/none, while
- * colour escalates from ETC1S through RDO and plain UASTC. Alpha coverage is checked separately;
- * a forced codec must still meet the floor. Colour space comes from the slot too — `getTextureColorSpace`
- * knows base colour and emissive are sRGB and that metallic-roughness and normals are data —
- * so a linear map is never encoded through a perceptual metric.
- *
- * The encoder is the same in-process Basis WASM the standalone texture pass uses, so no new
- * dependency and nothing extra to install. Everything fails closed: an image no decoder reads,
- * an image whose dimensions are not a whole number of 4x4 blocks, and a texture whose binding
- * did not survive the round trip all throw naming the model and the image.
- */
 interface IModelTextureOverride {
     readonly codec: TextureCodec;
     /** glTF slot the override applies to, e.g. `normalTexture` or `baseColorTexture`. */
@@ -70,6 +51,20 @@ interface IModelTexturesOptions {
      * per-image deduplication, colour space — is unchanged.
      */
     readonly decoderFree?: boolean;
+    /**
+     * Bytes the runtime pays once for the Basis transcoder (`basis_transcoder.js` plus
+     * `basis_transcoder.wasm`) when any model publishes KTX2. An image is encoded only when its
+     * KTX2 output saves at least this many bytes against the authored container, so one small
+     * texture can never make every game download a transcoder larger than the saving. Defaults to
+     * {@link BASIS_TRANSCODER_BYTES}. `compileAssets` passes 0 when the whole build repays it
+     * (see {@link IEmbeddedTextureSummary.transcoderSavings}).
+     */
+    readonly transcoderBytes?: number;
+    /**
+     * Internal switch for the authored-container JPEG rung (default on). A caller that needs the
+     * KTX2 ladder alone, such as a test of rung selection, turns it off.
+     */
+    readonly jpeg?: boolean;
     /**
      * Longest edge an embedded image may keep, default 2048. Larger images are box-resampled
      * down preserving aspect ratio; smaller ones are never upscaled.
@@ -93,6 +88,22 @@ interface IEmbeddedTextureSummary {
     readonly resized: number;
     /** Images retained at their authored bytes, by name, with the reason each one was not cooked. */
     readonly skippedCompression: Readonly<Record<string, TextureSkipReason>>;
+    /**
+     * Bytes KTX2 saves over the decoder-free container across this model's automatic images,
+     * whether or not the transcoder charge let it ship. The build sums it over every model to
+     * decide once whether the shared transcoder pays for itself. Absent when zero.
+     */
+    readonly transcoderSavings?: number;
+    /** Some image ships Basis KTX2 whatever the charge (a codec override, a resize, authored KTX2). */
+    readonly transcoderRequired?: true;
+    /**
+     * What each image contributed to the two fields above, keyed like `formats`. Internal: the
+     * shared-image store replays it so a warm cook reports the same summary as a cold one.
+     */
+    readonly transcoderByImage?: Readonly<Record<string, {
+        readonly savings?: number;
+        readonly required?: true;
+    }>>;
 }
 /** One embedded image as the verification compares it, source against re-read output. */
 interface IModelTextureBinding {
@@ -544,6 +555,10 @@ interface ISharedImage {
     /** `uastc`, `etc1s` or `none`, spelled into the filename so a cache hit knows what it found. */
     readonly codec: string;
     readonly mimeType: string;
+    /** Bytes KTX2 saved against the decoder-free container here, so a recall reports it too. */
+    readonly transcoderSavings?: number;
+    /** This image ships Basis KTX2 whatever the transcoder charge; replayed on a recall. */
+    readonly transcoderRequired?: true;
 }
 interface ISharedImageStore {
     /** The image encoded from this key, from memory or from a previous build's output. */
@@ -583,6 +598,8 @@ interface IModelPassesOptions {
     readonly prune?: boolean;
     readonly quantize?: boolean;
     readonly reorder?: boolean;
+    /** Drop animation tracks that only hold the pose their node already has. Default true. */
+    readonly restTracks?: boolean;
 }
 interface IModelQuantizeOptions {
     /** Normal precision in bits, default 8. */
@@ -690,6 +707,10 @@ interface IEmbeddedTextureRow {
     readonly gpuBytesAfter: number;
     readonly gpuBytesBefore: number;
     readonly resized: number;
+    /** Bytes KTX2 saves over the decoder-free container here; the build sums it once per bake. */
+    readonly transcoderSavings?: number;
+    /** Some image ships Basis KTX2 whatever the transcoder charge. */
+    readonly transcoderRequired?: true;
 }
 /** What the cluster-DAG bake produced for one model. */
 interface IVirtualRow {
@@ -1117,6 +1138,12 @@ interface IAssetCompileOptions {
     readonly source?: string;
     /** Overrides resolution of three's Basis transcoder for the copy into the output root. */
     readonly transcoder?: IBasisTranscoder;
+    /**
+     * Internal: the bytes an embedded model image must save before KTX2 pays for the shared Basis
+     * transcoder. Absent charges the measured default; a caller that already ships the transcoder
+     * passes 0.
+     */
+    readonly modelTranscoderBytes?: number;
 }
 interface IBasisTranscoder {
     readonly javascriptPath: string;

package/dist/index.js

@@ -531,7 +531,8 @@ var MODEL_PASS_KEYS = [
   "meshopt",
   "prune",
   "quantize",
-  "reorder"
+  "reorder",
+  "restTracks"
 ];
 var MODEL_QUANTIZE_KEYS = ["normalBits", "positionBits", "uvBits"];
 var MODEL_VIRTUAL_COUNT_KEYS = [
@@ -16008,9 +16009,9 @@ function readTextureQuality(value) {
   const row = value;
   const positive = (v) => typeof v === "number" && Number.isSafeInteger(v) && v > 0;
   const bounded = (v, min2, max2) => typeof v === "number" && Number.isFinite(v) && v >= min2 && v <= max2;
-  if (row.version !== IMAGE_QUALITY_VERSION || ![row.width, row.height, row.sourceWidth, row.sourceHeight].every(positive) || !bounded(row.ssim, -1, 1) || row.meanDeltaE00 !== null && !bounded(row.meanDeltaE00, 0, Number.POSITIVE_INFINITY) || !["pass", "below-floor", "unvalidated-slots"].includes(row.status) || !Array.isArray(row.slots) || !row.slots.every((slot) => typeof slot === "string") || !["uastc", "etc1s", "none"].includes(row.codec) || row.compressionSkipped !== void 0 && !["block-size", "not-smaller", "below-floor"].includes(row.compressionSkipped) || !bounded(row.floor?.ssim, 0, 1) || !bounded(row.floor?.meanDeltaE00, 0, Number.POSITIVE_INFINITY) || row.rung !== void 0 && !["etc1s@150", "uastc+rdo \u03BB3 +zstd", "uastc+rdo \u03BB1 +zstd", "uastc", "none"].includes(
+  if (row.version !== IMAGE_QUALITY_VERSION || ![row.width, row.height, row.sourceWidth, row.sourceHeight].every(positive) || !bounded(row.ssim, -1, 1) || row.meanDeltaE00 !== null && !bounded(row.meanDeltaE00, 0, Number.POSITIVE_INFINITY) || !["pass", "below-floor", "unvalidated-slots"].includes(row.status) || !Array.isArray(row.slots) || !row.slots.every((slot) => typeof slot === "string") || !["uastc", "etc1s", "jpeg", "none"].includes(row.codec) || row.compressionSkipped !== void 0 && !["block-size", "not-smaller", "below-floor"].includes(row.compressionSkipped) || !bounded(row.floor?.ssim, 0, 1) || !bounded(row.floor?.meanDeltaE00, 0, Number.POSITIVE_INFINITY) || row.rung !== void 0 && !["etc1s@150", "uastc+rdo \u03BB3 +zstd", "uastc+rdo \u03BB1 +zstd", "uastc", "none"].includes(
     row.rung
-  ) && !/^etc1s@\d+$/u.test(row.rung) || !bounded(row.alpha?.ssim, -1, 1) || !bounded(row.alpha?.meanAbsoluteError, 0, 1) || !Array.isArray(row.alpha?.coverage) || !row.alpha.coverage.every(
+  ) && !/^etc1s@\d+$/u.test(row.rung) && !/^jpeg@\d+$/u.test(row.rung) || !bounded(row.alpha?.ssim, -1, 1) || !bounded(row.alpha?.meanAbsoluteError, 0, 1) || !Array.isArray(row.alpha?.coverage) || !row.alpha.coverage.every(
     (c) => c !== null && typeof c === "object" && bounded(c.threshold, 0, 1) && [c.source, c.decoded, c.changedPixels].every(
       (v) => Number.isSafeInteger(v) && v >= 0 && v <= row.width * row.height
     )
@@ -21682,7 +21683,7 @@ function scriptsDirectory() {
     // Built: `dist/index.js` sits beside `dist/blender-gpl/`.
     path8.join(here, "blender-gpl"),
     // Source: `src/passes/` -> the workspace sibling.
-    path8.resolve(here, "..", "..", "..", "blender-mcp", "gpl")
+    path8.resolve(here, "..", "..", "..", "blender-bridge", "gpl")
   ];
   const found = candidates.find((candidate) => existsSync(path8.join(candidate, "convert.py")));
   if (found === void 0) {
@@ -22065,6 +22066,7 @@ function bakeStaticLightmap(document, width, height, padding) {
     width
   };
 }
+var BASIS_TRANSCODER_BYTES = 600 * 1024;
 var DEFAULT_MAX_SIZE = 2048;
 var DEFAULT_ETC1S_QUALITY = 150;
 var BLOCK_SIZE = 4;
@@ -22359,6 +22361,29 @@ async function encodeTextureLadder(data, width, height, options) {
   if (smallest !== void 0) return smallest;
   throw new Error("TN_ASSETS_TEXTURE_FLOOR: forced codec fails its configured floor.");
 }
+var JPEG_QUALITY_RUNGS = [75, 80, 85, 90];
+async function encodeJpegCandidate(data, width, height, options) {
+  const sharp = (await import('sharp')).default;
+  for (const quality2 of JPEG_QUALITY_RUNGS) {
+    const buffer = await sharp(Buffer.from(data), {
+      raw: { channels: 4, height, width }
+    }).jpeg({ mozjpeg: true, quality: quality2 }).toBuffer();
+    const decoded = await decodeImageBytes(buffer, "jpeg-candidate");
+    const score = imageQuality(data, decoded.data, width, height, options);
+    if (score.status !== "pass" || score.alpha.meanAbsoluteError !== 0) continue;
+    return {
+      buffer,
+      quality: {
+        ...score,
+        codec: "jpeg",
+        rung: `jpeg@${String(quality2)}`,
+        sourceHeight: height,
+        sourceWidth: width
+      }
+    };
+  }
+  return void 0;
+}
 function gpuBytes(width, height, codec) {
   return Math.round(width * height * (GPU_BYTES_PER_PIXEL[codec] ?? 4) * MIP_FACTOR);
 }
@@ -22370,6 +22395,7 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
   const textures = root.listTextures();
   if (textures.length === 0) return void 0;
   const decoderFree = options.decoderFree === true;
+  const transcoderBytes = Math.max(0, options.transcoderBytes ?? BASIS_TRANSCODER_BYTES);
   const quality2 = Math.min(255, Math.max(1, Math.round(options.quality ?? DEFAULT_ETC1S_QUALITY)));
   const keys = textureKeys(root);
   const formats = {};
@@ -22381,6 +22407,9 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
   let gpuBytesAfter = 0;
   let resized = 0;
   let compressed = 0;
+  let transcoderSavings = 0;
+  let transcoderRequired = false;
+  const transcoderByImage = {};
   for (const [index, texture] of textures.entries()) {
     const key = keys[index] ?? `texture#${String(index)}`;
     const image = texture.getImage();
@@ -22409,6 +22438,15 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
         if (shape.width !== score.sourceWidth || shape.height !== score.sourceHeight) resized += 1;
       }
       if (fromStore.codec !== "none") compressed += 1;
+      if (fromStore.transcoderSavings !== void 0)
+        transcoderSavings += fromStore.transcoderSavings;
+      if (fromStore.transcoderRequired === true) transcoderRequired = true;
+      if (fromStore.transcoderSavings !== void 0 || fromStore.transcoderRequired === true) {
+        transcoderByImage[key] = {
+          ...fromStore.transcoderSavings === void 0 ? {} : { savings: fromStore.transcoderSavings },
+          ...fromStore.transcoderRequired === true ? { required: true } : {}
+        };
+      }
       continue;
     }
     const slots = listTextureSlots(texture);
@@ -22424,6 +22462,10 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
       }
     }
     if (texture.getMimeType() === "image/ktx2" && !authoredBasis) {
+      if (!isRawAstc(texture)) {
+        transcoderRequired = true;
+        transcoderByImage[key] = { ...transcoderByImage[key], required: true };
+      }
       const shape = imageShape(image, "image/ktx2");
       bytesBefore += image.byteLength;
       bytesAfter += image.byteLength;
@@ -22540,6 +22582,14 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
         };
       continue;
     }
+    const authoredContainer = !explicit && !authoredBasis && options.jpeg !== false && options.astc !== true && target.width === decoded.width && target.height === decoded.height && UNIVERSAL_IMAGE_CONTAINERS.has(texture.getMimeType()) && slots.some((slot) => COLOUR_SLOTS.has(slot));
+    const jpeg = authoredContainer ? await encodeJpegCandidate(data, target.width, target.height, {
+      ...textureQualitySemantics(texture),
+      floor: options.floor
+    }) : void 0;
+    const jpegLimit = jpeg !== void 0 && jpeg.buffer.byteLength < image.byteLength ? jpeg.buffer.byteLength : image.byteLength;
+    const automatic = !explicit && target.width === decoded.width && target.height === decoded.height && UNIVERSAL_IMAGE_CONTAINERS.has(texture.getMimeType());
+    const charged = automatic && options.astc !== true;
     let selected;
     try {
       if (authoredBasis && target.width === decoded.width && target.height === decoded.height) {
@@ -22569,7 +22619,7 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
           srgb,
           quality: quality2,
           ...options.astc === true ? { astc: true, gltfColorPrimaries: srgb ? 1 : 0 } : {},
-          ...!explicit && target.width === decoded.width && target.height === decoded.height && UNIVERSAL_IMAGE_CONTAINERS.has(texture.getMimeType()) ? { maxBytes: image.byteLength } : {},
+          ...automatic ? { maxBytes: jpegLimit } : {},
           ...forced === void 0 ? {} : { forced }
         });
       }
@@ -22581,7 +22631,21 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
       if (!authoredBasis) throw error;
       throw new Error(`TN_ASSETS_MODEL_BASIS_ASTC: '${logicalPath}#${key}': ${messageOf3(error)}`);
     }
-    const encoded = selected.encoded;
+    let encoded = selected.encoded;
+    if (charged && encoded !== void 0) {
+      const savings = jpegLimit - encoded.byteLength;
+      transcoderSavings += savings;
+      if (savings > 0) transcoderByImage[key] = { ...transcoderByImage[key], savings };
+      if (encoded.byteLength >= jpegLimit - transcoderBytes) encoded = void 0;
+    }
+    if (encoded === void 0 && jpeg !== void 0 && jpeg.buffer.byteLength < image.byteLength) {
+      texture.setImage(jpeg.buffer).setMimeType("image/jpeg");
+      bytesAfter += jpeg.buffer.byteLength;
+      gpuBytesAfter += gpuBytes(target.width, target.height, "none");
+      formats[key] = "none";
+      if (options.measureQuality !== false) scores[key] = jpeg.quality;
+      continue;
+    }
     if (encoded === void 0 || encoded.byteLength >= image.byteLength && target.width === decoded.width && target.height === decoded.height && !explicit && UNIVERSAL_IMAGE_CONTAINERS.has(texture.getMimeType())) {
       const downsampled = target.width !== decoded.width || target.height !== decoded.height;
       let retained = image;
@@ -22624,6 +22688,10 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
       };
     }
     texture.setImage(encoded).setMimeType("image/ktx2");
+    if (!charged && options.astc !== true) {
+      transcoderRequired = true;
+      transcoderByImage[key] = { ...transcoderByImage[key], required: true };
+    }
     formats[key] = options.astc === true ? "astc4x4" : selected.codec;
     bytesAfter += encoded.byteLength;
     gpuBytesAfter += gpuBytes(target.width, target.height, formats[key] ?? selected.codec);
@@ -22651,7 +22719,10 @@ async function compressEmbeddedTextures(document, logicalPath, options = {}, rec
     gpuBytesAfter,
     gpuBytesBefore,
     resized,
-    skippedCompression
+    skippedCompression,
+    ...transcoderSavings > 0 ? { transcoderSavings } : {},
+    ...transcoderRequired ? { transcoderRequired: true } : {},
+    ...Object.keys(transcoderByImage).length === 0 ? {} : { transcoderByImage }
   };
 }
 function textureQualitySemantics(texture) {
@@ -22709,12 +22780,6 @@ function texturePass(options = {}) {
     },
     apply: async (input, logicalPath) => {
       if (classify(logicalPath) !== "texture") return input;
-      const stats = textureStats(input);
-      if (stats.width <= 0 || stats.height <= 0) {
-        throw new Error(
-          `TN_ASSETS_TEXTURE_UNREADABLE: '${logicalPath}' has no readable PNG/JPEG header; the KTX2 pass cannot encode it.`
-        );
-      }
       const decoded = await decodeImageBytes(input, logicalPath);
       const choice = texturePolicy(logicalPath, options);
       if (choice.codec === "none")
@@ -24146,6 +24211,90 @@ function resolveCompactOptions(options) {
   };
 }
 
+// src/passes/glb-spec-defaults.ts
+var JSON_CHUNK = 1313821514;
+var HEADER = 12;
+function withoutSpecDefaults(glb) {
+  if (glb.readUInt32LE(16) !== JSON_CHUNK) return glb;
+  const jsonLength = glb.readUInt32LE(12);
+  const json = JSON.parse(glb.subarray(20, 20 + jsonLength).toString("utf8"));
+  for (const accessor of json.accessors ?? []) {
+    if (accessor.normalized === false) accessor.normalized = void 0;
+    if (accessor.byteOffset === 0) accessor.byteOffset = void 0;
+  }
+  for (const view of json.bufferViews ?? []) if (view.byteOffset === 0) view.byteOffset = void 0;
+  for (const animation of json.animations ?? [])
+    for (const sampler of animation.samplers)
+      if (sampler.interpolation === "LINEAR") sampler.interpolation = void 0;
+  const text = Buffer.from(JSON.stringify(json), "utf8");
+  const padded2 = Buffer.alloc(Math.ceil(text.length / 4) * 4, 32);
+  text.copy(padded2);
+  const rest = glb.subarray(HEADER + 8 + jsonLength);
+  const head = Buffer.alloc(HEADER + 8);
+  glb.copy(head, 0, 0, HEADER);
+  head.writeUInt32LE(HEADER + 8 + padded2.length + rest.length, 8);
+  head.writeUInt32LE(padded2.length, 12);
+  head.writeUInt32LE(JSON_CHUNK, 16);
+  return Buffer.concat([head, padded2, rest]);
+}
+
+// src/passes/prune-rest-tracks.ts
+var COMPONENTS = { rotation: 4, scale: 3, translation: 3 };
+var REST_TOLERANCE = 1e-6;
+function restOf(node, path10) {
+  if (path10 === "rotation") return node.getRotation();
+  return path10 === "translation" ? node.getTranslation() : node.getScale();
+}
+function holdsRest(channel) {
+  const path10 = channel.getTargetPath();
+  const node = channel.getTargetNode();
+  const output = channel.getSampler()?.getOutput();
+  if (path10 === null || !(path10 in COMPONENTS) || node === null || !output) return false;
+  const rest = restOf(node, path10);
+  const element = new Array(COMPONENTS[path10]).fill(0);
+  for (let key = 0; key < output.getCount(); key += 1) {
+    output.getElement(key, element);
+    if (element.some((value, c) => Math.abs(value - (rest[c] ?? 0)) > REST_TOLERANCE)) return false;
+  }
+  return output.getCount() > 0;
+}
+var lastKey = (channel) => {
+  const input = channel.getSampler()?.getInput();
+  return input === null || input === void 0 ? 0 : input.getMax([0])[0] ?? 0;
+};
+function dropChannel(animation, channel) {
+  const sampler = channel.getSampler();
+  animation.removeChannel(channel);
+  channel.dispose();
+  const shared = sampler?.listParents().some((parent) => parent !== animation && parent.propertyType === "AnimationChannel");
+  if (sampler === null || sampler === void 0 || shared === true) return;
+  animation.removeSampler(sampler);
+  sampler.dispose();
+}
+function pruneRestPoseTracks(document, logicalPath) {
+  let dropped = 0;
+  let total = 0;
+  for (const animation of document.getRoot().listAnimations()) {
+    const kept = new Set(animation.listChannels());
+    total += kept.size;
+    const duration = Math.max(0, ...[...kept].map(lastKey));
+    for (const channel of animation.listChannels()) {
+      if (kept.size === 1 || !holdsRest(channel)) continue;
+      kept.delete(channel);
+      if (Math.max(0, ...[...kept].map(lastKey)) < duration) kept.add(channel);
+      else {
+        dropChannel(animation, channel);
+        dropped += 1;
+      }
+    }
+  }
+  if (dropped > 0 && logicalPath !== void 0)
+    console.log(
+      `animation ${logicalPath}: dropped ${String(dropped)} of ${String(total)} tracks that hold the rest pose`
+    );
+  return { dropped, total };
+}
+
 // src/passes/quantize-static.ts
 async function quantizeStaticGeometry(document, quantize2) {
   const held = holdDeformingMeshes(document);
@@ -24310,6 +24459,14 @@ function parseFileName(name) {
   if (key === void 0 || codec === void 0 || mimeType === void 0) return void 0;
   return { codec, key, mimeType };
 }
+function readTranscoderRecord(value) {
+  if (typeof value !== "object" || value === null) return {};
+  const record = value;
+  return {
+    ...typeof record.savings === "number" && Number.isFinite(record.savings) && record.savings > 0 ? { transcoderSavings: record.savings } : {},
+    ...record.required === true ? { transcoderRequired: true } : {}
+  };
+}
 function sharedImageKey(source, settings) {
   return createHash("sha256").update(source).update(JSON.stringify(settings), "utf8").digest("hex").slice(0, KEY_LENGTH);
 }
@@ -24386,6 +24543,17 @@ function createSharedImageStore(outputRoot, options = {}) {
               return {};
             throw error;
           }
+        })(),
+        ...await (async () => {
+          try {
+            return readTranscoderRecord(
+              JSON.parse(await readFile(path8.join(directory, `${name}.transcoder.json`), "utf8"))
+            );
+          } catch (error) {
+            if (error.code === "ENOENT" || error instanceof SyntaxError)
+              return {};
+            throw error;
+          }
         })()
       };
       memory.set(key, image);
@@ -24397,7 +24565,8 @@ function createSharedImageStore(outputRoot, options = {}) {
       if (directory === void 0 || options.writeThrough === false) return;
       const name = fileNameFor(key, image);
       const known = await onDisk();
-      if (known.has(key) && image.quality === void 0) return;
+      if (known.has(key) && image.quality === void 0 && image.transcoderSavings === void 0 && image.transcoderRequired !== true)
+        return;
       await mkdir(directory, { recursive: true });
       const target = path8.join(directory, name);
       const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;
@@ -24418,6 +24587,23 @@ function createSharedImageStore(outputRoot, options = {}) {
           await rm(qualityTemporary, { force: true }).catch(() => void 0);
         }
       }
+      if (image.transcoderSavings !== void 0 || image.transcoderRequired === true) {
+        const transcoderTarget = `${target}.transcoder.json`;
+        const transcoderTemporary = `${transcoderTarget}.${process.pid}.${randomUUID()}.tmp`;
+        try {
+          await writeFile(
+            transcoderTemporary,
+            `${JSON.stringify({
+              ...image.transcoderSavings === void 0 ? {} : { savings: image.transcoderSavings },
+              ...image.transcoderRequired === true ? { required: true } : {}
+            })}
+`
+          );
+          await rename(transcoderTemporary, transcoderTarget);
+        } finally {
+          await rm(transcoderTemporary, { force: true }).catch(() => void 0);
+        }
+      }
       known.set(key, name);
     }
   };
@@ -24540,6 +24726,7 @@ async function readSharedGlb(io, buffer, resolve2) {
 var DRACO_EXTENSION2 = "KHR_draco_mesh_compression";
 var EXT_MESHOPT_EXTENSION = "EXT_meshopt_compression";
 var MATERIAL_MERGE_VERSION = 1;
+var SHARED_TRANSCODER_ACCOUNTING_VERSION = 1;
 var MODEL_DEDUPE_VERSION = 1;
 var MODEL_REORDER_VERSION = 1;
 var MODEL_QUANTIZE_VERSION = 1;
@@ -24569,7 +24756,7 @@ async function writeDocument(document, logicalPath, vertexLayout = "interleaved"
   await MeshoptEncoder.ready;
   const io = new NodeIO().setVertexLayout(vertexLayout === "separate" ? VertexLayout.SEPARATE : VertexLayout.INTERLEAVED).registerExtensions([...ALL_EXTENSIONS, EXTTextureAstc, TNVirtualGeometry, TNDiscreteLod]).registerDependencies({ "meshopt.encoder": MeshoptEncoder });
   try {
-    const buffer = Buffer.from(await io.writeBinary(document));
+    const buffer = withoutSpecDefaults(Buffer.from(await io.writeBinary(document)));
     return { buffer, extensions: jsonOfGlb(buffer).extensionsUsed ?? [] };
   } catch (error) {
     const detail = error instanceof Error ? error.message : String(error);
@@ -24943,7 +25130,8 @@ function modelPass(options = {}) {
         meshopt: options.passes?.meshopt ?? true,
         prune: options.passes?.prune ?? true,
         quantize: options.passes?.quantize ?? true,
-        reorder: options.passes?.reorder ?? true
+        reorder: options.passes?.reorder ?? true,
+        restTracks: options.passes?.restTracks ?? true
       },
       ...options.vertexLayout === void 0 ? {} : { vertexLayout: options.vertexLayout },
       quantize: {
@@ -24978,13 +25166,17 @@ function modelPass(options = {}) {
         bakeVersion: VIRTUAL_BAKE_VERSION
       },
       sharedImages: options.sharedImages !== void 0,
+      ...options.sharedImages === void 0 ? {} : { sharedTranscoderAccounting: SHARED_TRANSCODER_ACCOUNTING_VERSION },
       textures: options.textures === "none" ? "none" : {
         ...options.textures?.astc === true ? { astc: "raw4x4-gltf-authored-basis-v2" } : {},
         decoderFree: options.textures?.decoderFree ?? false,
         encoder: KTX2_ENCODER_VERSION,
         instrument: IMAGE_QUALITY_IDENTITY,
+        jpeg: options.textures?.jpeg ?? null,
+        jpegLadder: "colour-opaque-q75-90-v1",
         floor: resolveImageQualityFloor(options.textures?.floor),
         maxSize: options.textures?.maxSize ?? null,
+        transcoderBytes: options.textures?.transcoderBytes ?? null,
         // Retention is now conditioned on the container, so it is spelled out rather than
         // named by a boolean: a warm cache keyed on the old rule would keep shipping the
         // WebP-requiring models this replaced.
@@ -25005,7 +25197,8 @@ function modelPass(options = {}) {
         meshopt: passes.meshopt ?? true,
         prune: passes.prune ?? true,
         quantize: passes.quantize ?? true,
-        reorder: passes.reorder ?? true
+        reorder: passes.reorder ?? true,
+        restTracks: passes.restTracks ?? true
       };
       const textureOptions = options.textures === "none" ? void 0 : options.textures ?? {};
       const virtualOptions = options.virtual === "none" ? void 0 : options.virtual ?? {};
@@ -25023,6 +25216,7 @@ function modelPass(options = {}) {
       if (enabled.dedup) await dedup()(document);
       const namesBeforeCompact = compactRequested(options.compact) ? sceneNodeNames(document) : void 0;
       let compact = compactRequested(options.compact) ? await compactModel(document, resolveCompactOptions(options.compact)) : void 0;
+      if (enabled.restTracks) pruneRestPoseTracks(document, logicalPath);
       if (enabled.prune) {
         await prune({ keepAttributes: options.preserveLightmapUv === true })(document);
         if (compact !== void 0 && namesBeforeCompact !== void 0) {
@@ -25080,7 +25274,8 @@ function modelPass(options = {}) {
           store,
           shared,
           embeddedTextures?.formats,
-          embeddedTextures?.quality
+          embeddedTextures?.quality,
+          embeddedTextures?.transcoderByImage
         );
       if (enabled.meshopt) {
         document.createExtension(EXTMeshoptCompression).setRequired(true).setEncoderOptions({ method: EXTMeshoptCompression.EncoderMethod.QUANTIZE });
@@ -25153,11 +25348,14 @@ function sharedSettings(texture, textureOptions) {
       decoderFree: textureOptions.decoderFree ?? false,
       encoder: KTX2_ENCODER_VERSION,
       instrument: IMAGE_QUALITY_IDENTITY,
+      jpeg: textureOptions.jpeg ?? null,
+      jpegLadder: "colour-opaque-q75-90-v1",
       floor: resolveImageQualityFloor(textureOptions.floor),
       keepSmallerSource: "universal-containers",
       maxSize: resolveTextureMaxSize(textureOptions.maxSize, listTextureSlots(texture)),
       overrides: textureOptions.overrides ?? [],
-      quality: textureOptions.quality ?? null
+      quality: textureOptions.quality ?? null,
+      transcoderBytes: textureOptions.transcoderBytes ?? null
     }
   };
 }
@@ -25181,7 +25379,9 @@ async function recallSharedImages(document, store, textureOptions) {
     recalled.set(index, {
       codec: stored.codec,
       sourceBytes: image.byteLength,
-      quality: stored.quality
+      quality: stored.quality,
+      ...stored.transcoderSavings === void 0 ? {} : { transcoderSavings: stored.transcoderSavings },
+      ...stored.transcoderRequired === true ? { transcoderRequired: true } : {}
     });
   }
   return { keys, recalled };
@@ -25190,7 +25390,7 @@ function codecOf(mimeType, formats, name) {
   if (mimeType !== "image/ktx2") return "none";
   return formats?.[name] ?? "uastc";
 }
-async function rememberSharedImages(document, store, plan, formats, quality2) {
+async function rememberSharedImages(document, store, plan, formats, quality2, transcoder) {
   const textures = document.getRoot().listTextures();
   const names = textureKeys(document.getRoot());
   for (const [index, texture] of textures.entries()) {
@@ -25198,11 +25398,15 @@ async function rememberSharedImages(document, store, plan, formats, quality2) {
     const key = plan.keys[index];
     const image = texture.getImage();
     if (key === void 0 || key === "" || image === null) continue;
+    const name = names[index] ?? "";
+    const contribution = transcoder?.[name];
     await store.put(key, {
       buffer: Buffer.from(image.buffer, image.byteOffset, image.byteLength),
-      codec: codecOf(texture.getMimeType(), formats, names[index] ?? ""),
+      codec: codecOf(texture.getMimeType(), formats, name),
       mimeType: texture.getMimeType(),
-      ...quality2?.[names[index] ?? ""] === void 0 ? {} : { quality: quality2?.[names[index] ?? ""] }
+      ...quality2?.[name] === void 0 ? {} : { quality: quality2?.[name] },
+      ...contribution?.savings === void 0 ? {} : { transcoderSavings: contribution.savings },
+      ...contribution?.required === true ? { transcoderRequired: true } : {}
     });
   }
 }
@@ -25215,6 +25419,8 @@ function declareSharedImage(store, logicalPath, auxiliaryOutputs, candidate) {
     metadata: {
       codec: candidate.image.codec,
       key: candidate.key,
+      transcoderRequired: candidate.image.transcoderRequired === true,
+      transcoderSavings: candidate.image.transcoderSavings ?? 0,
       ...candidate.image.quality === void 0 ? {} : { quality: candidate.image.quality }
     },
     outputPath,
@@ -26414,7 +26620,9 @@ function embeddedTextureRow(value) {
     } : {},
     gpuBytesAfter: value.gpuBytesAfter,
     gpuBytesBefore: value.gpuBytesBefore,
-    resized: value.resized
+    resized: value.resized,
+    ...typeof value.transcoderSavings === "number" && value.transcoderSavings > 0 ? { transcoderSavings: value.transcoderSavings } : {},
+    ...value.transcoderRequired === true ? { transcoderRequired: true } : {}
   };
 }
 function audioRow(value) {
@@ -27128,7 +27336,16 @@ function resolveLayout(cwd, options) {
     });
     if (models !== void 0) {
       const modelOptions = options.platform === void 0 || options.platform === "web" ? models : { ...models, vertexLayout: "separate" };
-      const modelOptionsWithLod = { ...modelOptions, lod: configuredLod };
+      const modelOptionsWithLod = {
+        ...modelOptions,
+        lod: configuredLod,
+        ...options.modelTranscoderBytes === void 0 || modelOptions.textures === "none" ? {} : {
+          textures: {
+            ...modelOptions.textures ?? {},
+            transcoderBytes: options.modelTranscoderBytes
+          }
+        }
+      };
       const pass = modelPass({
         ...modelOptionsWithLod,
         preserveLightmapUv: lightmap !== void 0,
@@ -27469,7 +27686,8 @@ async function writeOutput(outputRoot, entry, buffer) {
 }
 async function nativeTextureEntry(name, data) {
   const jpeg = data.length >= 3 && data[0] === 255 && data[1] === 216 && data[2] === 255;
-  if (!jpeg && parsePng(data) === void 0) return void 0;
+  const webp = data.length >= 12 && data.toString("ascii", 0, 4) === "RIFF" && data.toString("ascii", 8, 12) === "WEBP";
+  if (!jpeg && !webp && parsePng(data) === void 0) return void 0;
   const image = await decodeImageBytes(data, name);
   const header = Buffer.alloc(12);
   header.writeUInt32LE(image.width, 0);
@@ -27673,7 +27891,62 @@ async function copyBasisTranscoder(outputRoot, transcoder) {
     );
   }
 }
+function addTranscoderCharge(entry, state) {
+  if (entry.kind === "texture" && entry.format !== void 0) {
+    if (entry.format !== "none" && entry.format !== "astc4x4") state.paid = true;
+    return;
+  }
+  const row = entry.embeddedTextures;
+  if (row === void 0 || state.countedOutputs.has(entry.output)) return;
+  state.countedOutputs.add(entry.output);
+  state.paid ||= row.transcoderRequired === true;
+  const images = entry.sharedImages;
+  if (images === void 0 || images.length === 0) {
+    state.savings += row.transcoderSavings ?? 0;
+    return;
+  }
+  const detailed = images.filter(isAccountedSharedImage);
+  if (detailed.length !== images.length) {
+    state.needsSharedRecount ||= (row.transcoderSavings ?? 0) > 0;
+    return;
+  }
+  for (const image of detailed) {
+    if (state.countedImages.has(image.key)) continue;
+    state.countedImages.add(image.key);
+    state.paid ||= image.transcoderRequired;
+    state.savings += image.transcoderSavings;
+  }
+}
+function modelTranscoderCharge(entries) {
+  const state = {
+    countedImages: /* @__PURE__ */ new Set(),
+    countedOutputs: /* @__PURE__ */ new Set(),
+    needsSharedRecount: false,
+    paid: false,
+    savings: 0
+  };
+  for (const entry of Object.values(entries)) addTranscoderCharge(entry, state);
+  if (state.needsSharedRecount) return 0;
+  if (state.savings === 0) return "either";
+  return state.paid || state.savings >= BASIS_TRANSCODER_BYTES ? 0 : void 0;
+}
+function isAccountedSharedImage(value) {
+  return isRecord4(value) && typeof value.key === "string" && typeof value.transcoderRequired === "boolean" && typeof value.transcoderSavings === "number";
+}
 async function compileAssets(options = {}) {
+  if (options.modelTranscoderBytes !== void 0) return compileOnce(options);
+  const cwd = path8.resolve(options.cwd ?? process.cwd());
+  const manifestPath = path8.join(resolveLayout(cwd, options).outputRoot, MANIFEST_NAME);
+  const charge = async () => modelTranscoderCharge((await readExistingManifest(manifestPath)).entries);
+  const predicted = await charge();
+  const used = predicted === "either" ? void 0 : predicted;
+  const result = await compileOnce({ ...options, modelTranscoderBytes: used });
+  const decided = await charge();
+  if (decided === "either" || decided === used) return result;
+  const second = await compileOnce({ ...options, modelTranscoderBytes: decided });
+  return { ...second, written: result.written + second.written };
+}
+async function compileOnce(options) {
   const cwd = path8.resolve(options.cwd ?? process.cwd());
   const layout = resolveLayout(cwd, options);
   const receiptPath = path8.join(layout.outputRoot, RECEIPT_NAME);
@@ -27809,7 +28082,7 @@ async function compileAssets(options = {}) {
   let written = 0;
   let skipped = 0;
   let dedupeSavedBytes = 0;
-  let textureCount = 0;
+  let ktx2TextureCount = 0;
   let compressedModelCount = 0;
   if (logicals.length === 0) {
     for (const line of formatBudget(
@@ -27884,7 +28157,8 @@ async function compileAssets(options = {}) {
         format: entry.format,
         logicalPath: logical
       });
-      textureCount += 1;
+      if (entry.format !== void 0 && entry.format !== "none" && entry.format !== "astc4x4")
+        ktx2TextureCount += 1;
     }
   };
   const concurrency = resolveConcurrency(options.concurrency ?? layout.concurrency);
@@ -28040,7 +28314,7 @@ async function compileAssets(options = {}) {
   } finally {
     await pool?.dispose();
   }
-  if (layout.texturesActive && textureCount > 0 || compressedModelCount > 0) {
+  if (ktx2TextureCount > 0 || compressedModelCount > 0) {
     const basisJs = path8.join(layout.outputRoot, BASIS_DIRECTORY, "basis_transcoder.js");
     if (written > 0 || !await outputExists(basisJs)) {
       await recordPendingOutputs([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threenative/assets",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "license": "MIT",
   "description": "Content-addressed asset compile step for ThreeNative games.",
   "keywords": [
@@ -51,7 +51,7 @@
     "tsup": "8.5.1",
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "@typescript/native": "npm:typescript@7.0.2",
-    "threenative-blender-mcp": "0.1.6"
+    "@threenative/blender-bridge": "0.2.1"
   },
   "dependencies": {
     "@gltf-transform/core": "4.4.2",