@aura3d/cli 3.0.1 → 4.0.0

package/dist/admission/texel.js

@@ -0,0 +1,177 @@
+const COMPONENT_BYTES = { 5120: 1, 5121: 1, 5122: 2, 5123: 2, 5125: 4, 5126: 4 };
+const TYPE_COUNT = { SCALAR: 1, VEC2: 2, VEC3: 3, VEC4: 4, MAT4: 16 };
+function accessorView(json, index) {
+    const accessor = json.accessors?.[index];
+    if (!accessor || accessor.count === undefined || accessor.type === undefined || accessor.componentType === undefined)
+        return undefined;
+    const view = json.bufferViews?.[accessor.bufferView ?? -1];
+    // EXT_meshopt_compression bufferViews address a virtual decoded buffer —
+    // byteOffset is not an offset into the file's BIN chunk. Treat those
+    // accessors as unmeasurable (skipped) rather than indexing out of range.
+    if (view?.extensions?.EXT_meshopt_compression !== undefined)
+        return undefined;
+    const componentBytes = COMPONENT_BYTES[accessor.componentType];
+    const count = TYPE_COUNT[accessor.type];
+    if (componentBytes === undefined || count === undefined)
+        return undefined;
+    const stride = view?.byteStride ?? componentBytes * count;
+    return { componentType: accessor.componentType, count: accessor.count, type: accessor.type, offset: (view?.byteOffset ?? 0) + (accessor.byteOffset ?? 0), stride };
+}
+function readIndex(bin, view, i) {
+    const at = view.offset + i * view.stride;
+    return view.componentType === 5123 ? bin.readUInt16LE(at) : view.componentType === 5125 ? bin.readUInt32LE(at) : bin.readUInt8(at);
+}
+function readVec2(bin, view, i) {
+    const at = view.offset + i * view.stride;
+    return [bin.readFloatLE(at), bin.readFloatLE(at + 4)];
+}
+function readVec3(bin, view, i) {
+    const at = view.offset + i * view.stride;
+    return [bin.readFloatLE(at), bin.readFloatLE(at + 4), bin.readFloatLE(at + 8)];
+}
+/** Image header sniff: PNG IHDR (BE u32 @16,20), JPEG SOF (BE u16 height/width), KTX2 (LE u32 @20,24). */
+export function sniffImageSize(bytes, mime) {
+    if (bytes.length >= 24 && bytes.readUInt32BE(0) === 0x89504e47) {
+        return [bytes.readUInt32BE(16), bytes.readUInt32BE(20)];
+    }
+    if (bytes.length >= 4 && bytes[0] === 0xff && bytes[1] === 0xd8) {
+        for (let at = 2; at + 9 < bytes.length;) {
+            if (bytes[at] !== 0xff) {
+                at += 1;
+                continue;
+            }
+            const marker = bytes[at + 1];
+            if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {
+                return [bytes.readUInt16BE(at + 7), bytes.readUInt16BE(at + 5)];
+            }
+            at += 2 + (bytes.readUInt16BE(at + 2) || 2);
+        }
+        return undefined;
+    }
+    // KTX2: \xABKTX 20\xBB\r\n\x1A\n magic, then LE u32 fields; pixelWidth @20, pixelHeight @24.
+    if (bytes.length >= 28 && bytes.readUInt32LE(0) === 0xbb3254ab) {
+        return [bytes.readUInt32LE(20), bytes.readUInt32LE(24)];
+    }
+    // KTX1 magic 0xAB 4B 54 58 20 31 31 BB: pixelWidth @36, pixelHeight @40.
+    if (bytes.length >= 44 && bytes.readUInt32LE(0) === 0xbb313554) {
+        return [bytes.readUInt32LE(36), bytes.readUInt32LE(40)];
+    }
+    void mime;
+    return undefined;
+}
+/** Resolves the base-colour texture's pixel size for a material index. */
+function materialTextureSize(json, bin, materialIndex) {
+    if (materialIndex === undefined)
+        return undefined;
+    const material = json.materials?.[materialIndex];
+    const info = material?.pbrMetallicRoughness?.baseColorTexture;
+    const textureIndex = info?.extensions?.KHR_texture_basisu?.index ?? info?.index;
+    if (textureIndex === undefined)
+        return undefined;
+    const sourceIndex = json.textures?.[textureIndex]?.extensions?.KHR_texture_basisu?.source ?? json.textures?.[textureIndex]?.source;
+    if (sourceIndex === undefined)
+        return undefined;
+    const image = json.images?.[sourceIndex];
+    if (image?.bufferView === undefined)
+        return undefined;
+    const view = json.bufferViews?.[image.bufferView];
+    if (!view)
+        return undefined;
+    const bytes = bin.subarray(view.byteOffset ?? 0, (view.byteOffset ?? 0) + view.byteLength);
+    return sniffImageSize(bytes, image.mimeType);
+}
+function metersPerPixel(camera) {
+    const fovRadians = (camera.fovDegrees * Math.PI) / 180;
+    return (2 * camera.distance * Math.tan(fovRadians / 2)) / camera.viewportHeight;
+}
+/**
+ * Measures the texel-density report for a GLB against `camera`. Returns a
+ * report with `trianglesMeasured: 0` when no primitive can be measured —
+ * the gate treats that as "no evidence" rather than a pass.
+ */
+export function measureTexelDensity(json, bin, camera) {
+    const full = json;
+    const skipped = { triangles: 0 };
+    if (!bin) {
+        return { trianglesMeasured: 0, trianglesSkipped: 0, camera };
+    }
+    /** Area-weighted samples per material texture size. */
+    const samples = [];
+    for (const mesh of full.meshes ?? []) {
+        for (const primitive of mesh.primitives ?? []) {
+            const mode = primitive.mode ?? 4;
+            const attrs = primitive.attributes ?? {};
+            if (mode !== 4 || attrs.POSITION === undefined || attrs.TEXCOORD_0 === undefined) {
+                const primTriangles = mode !== 4 ? 0 : Math.floor((full.accessors?.[attrs.POSITION]?.count ?? 0) / 3);
+                skipped.triangles += primTriangles;
+                continue;
+            }
+            const positions = accessorView(full, attrs.POSITION);
+            const uvs = accessorView(full, attrs.TEXCOORD_0);
+            const textureSize = materialTextureSize(full, bin, primitive.material);
+            const indexView = typeof primitive.indices === "number" ? accessorView(full, primitive.indices) : undefined;
+            // An indexed primitive whose index accessor is unreadable (e.g. an
+            // EXT_meshopt_compression bufferView) must be skipped, not read as
+            // non-indexed — that would pair the wrong vertices into triangles.
+            const indicesUnreadable = typeof primitive.indices === "number" && !indexView;
+            if (!positions || !uvs || indicesUnreadable || !textureSize || textureSize[0] <= 0 || textureSize[1] <= 0) {
+                const indexCountRaw = typeof primitive.indices === "number" ? full.accessors?.[primitive.indices]?.count : undefined;
+                const vertexCountRaw = full.accessors?.[attrs.POSITION]?.count;
+                skipped.triangles += Math.floor((indexCountRaw ?? vertexCountRaw ?? 0) / 3);
+                continue;
+            }
+            const indexCount = indexView?.count ?? positions.count;
+            for (let i = 0; i + 2 < indexCount; i += 3) {
+                const [a, b, c] = indexView
+                    ? [readIndex(bin, indexView, i), readIndex(bin, indexView, i + 1), readIndex(bin, indexView, i + 2)]
+                    : [i, i + 1, i + 2];
+                if (a >= positions.count || b >= positions.count || c >= positions.count)
+                    continue;
+                const [p0, p1, p2] = [readVec3(bin, positions, a), readVec3(bin, positions, b), readVec3(bin, positions, c)];
+                const [t0, t1, t2] = [readVec2(bin, uvs, a), readVec2(bin, uvs, b), readVec2(bin, uvs, c)];
+                const e1 = [p1[0] - p0[0], p1[1] - p0[1], p1[2] - p0[2]];
+                const e2 = [p2[0] - p0[0], p2[1] - p0[1], p2[2] - p0[2]];
+                const cross = [
+                    e1[1] * e2[2] - e1[2] * e2[1],
+                    e1[2] * e2[0] - e1[0] * e2[2],
+                    e1[0] * e2[1] - e1[1] * e2[0]
+                ];
+                const worldArea = 0.5 * Math.hypot(cross[0], cross[1], cross[2]);
+                const uvArea = 0.5 * Math.abs((t1[0] - t0[0]) * (t2[1] - t0[1]) - (t2[0] - t0[0]) * (t1[1] - t0[1]));
+                if (worldArea <= 0 || uvArea <= 0)
+                    continue;
+                // Texels spanned by the triangle's UV footprint (area-units → texels).
+                const uvTexels = Math.sqrt(uvArea * textureSize[0] * textureSize[1]);
+                samples.push({ texelsPerMeter: uvTexels / Math.sqrt(worldArea), worldArea, textureSize });
+            }
+        }
+    }
+    const measured = samples.length;
+    if (measured === 0)
+        return { trianglesMeasured: 0, trianglesSkipped: skipped.triangles, camera };
+    const sorted = [...samples].sort((x, y) => x.texelsPerMeter - y.texelsPerMeter);
+    const totalArea = samples.reduce((sum, s) => sum + s.worldArea, 0);
+    const quantile = (q) => {
+        let acc = 0;
+        for (const s of sorted) {
+            acc += s.worldArea;
+            if (acc >= q * totalArea)
+                return s.texelsPerMeter;
+        }
+        return sorted[sorted.length - 1].texelsPerMeter;
+    };
+    const median = quantile(0.5);
+    const mpp = metersPerPixel(camera);
+    const medianSize = sorted[Math.floor((sorted.length - 1) / 2)].textureSize;
+    return {
+        trianglesMeasured: measured,
+        trianglesSkipped: skipped.triangles,
+        p10: quantile(0.1) * mpp,
+        p50: median * mpp,
+        p90: quantile(0.9) * mpp,
+        texelsPerMeterP50: median,
+        camera,
+        textureSize: medianSize
+    };
+}
+//# sourceMappingURL=texel.js.map

package/dist/admission/texel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texel.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/texel.ts"],"names":[],"mappings":"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"}

package/dist/admission/textureStats.d.ts

@@ -0,0 +1,45 @@
+import type { AdmissionGltfJson } from "./glb.js";
+export interface TextureChannelStats {
+    readonly mean: number;
+    readonly stdDev: number;
+    /** Fraction of texels whose channel value sits in `inRange` (0–255). */
+    readonly inRange?: number;
+}
+export interface TextureSlotStats {
+    readonly materialIndex: number;
+    readonly materialName?: string;
+    readonly slot: "baseColor" | "normal" | "metallicRoughness" | "occlusion" | "emissive";
+    readonly width: number;
+    readonly height: number;
+    readonly mimeType?: string;
+    readonly powerOfTwo: boolean;
+    /** Decoded-channel stats (undefined when the image cannot be decoded). */
+    readonly channels?: readonly TextureChannelStats[];
+    /** Normal-map vector-length stats. */
+    readonly normalLength?: {
+        readonly mean: number;
+        readonly inUnitRange: number;
+        readonly meanBlue: number;
+    };
+    /** sRGB luminance histogram (base colour). */
+    readonly luminance?: {
+        readonly mean: number;
+        readonly inRange30to240: number;
+    };
+    /** ORM channels whose σ < 0.004 (constant → "replace with factor"). */
+    readonly constantChannels?: readonly string[];
+    readonly error?: string;
+}
+export interface TextureSanityReport {
+    readonly available: boolean;
+    /** Reason the decode could not run (sharp missing, no images, …). */
+    readonly unavailableReason?: string;
+    readonly textures: readonly TextureSlotStats[];
+}
+/**
+ * Measures G6 stats for every material texture slot in the glTF.
+ * `gltfDir` resolves external image URIs (gltf container); GLB images come
+ * from `bin`.
+ */
+export declare function measureTextureSanity(json: AdmissionGltfJson, bin: Buffer | undefined, gltfDir: string, repoRoot: string): Promise<TextureSanityReport>;
+//# sourceMappingURL=textureStats.d.ts.map

package/dist/admission/textureStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureStats.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/textureStats.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGlD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,mBAAmB,GAAG,WAAW,GAAG,UAAU,CAAC;IACvF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,sCAAsC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3G,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAmHD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyF5J"}

package/dist/admission/textureStats.js

@@ -0,0 +1,201 @@
+/**
+ * PRD-05 §6.4 G6 — texture sanity measurement on 256² decoded proxies.
+ *
+ * Pixel decode needs `sharp`, which is a `tools/asset-optimize` dependency
+ * (the CLI itself carries no image deps per §4.4). Resolution follows the
+ * established lane-05 bridge: `createRequire(<repo>/tools/asset-optimize/
+ * package.json)` + `import(resolve("sharp"))`. When the tool deps are not
+ * installed (plain `pnpm install` without `tools/asset-optimize` npm
+ * install), the report is `available: false` and G6 records a fail —
+ * release admission requires the measurement, never assumes it.
+ *
+ * Measured per §6.4 G6:
+ * - normal maps: decoded vector length within [0.9, 1.1] for ≥ 95 % texels,
+ *   mean B ≥ 0.7;
+ * - ORM/metallicRoughness: R/G/B not all constant; a channel with σ < 0.004
+ *   is flagged "replace texture with factor";
+ * - base colour: sRGB luminance (0.2126R+0.7152G+0.0722B on 0–255) within
+ *   [30, 240] on ≥ 95 % texels; metals (metallic ≥ 0.9 factor or ORM
+ *   median ≥ 0.9) require ≥ 140;
+ * - no texture above `profile.maxTextureDimension`; no non-power-of-two
+ *   dimensions (post-optimize rule; recorded as `npot` flags).
+ */
+import { createRequire } from "node:module";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, extname, resolve } from "node:path";
+import { sniffImageSize } from "./texel.js";
+function isPowerOfTwo(n) {
+    return n > 0 && (n & (n - 1)) === 0;
+}
+async function loadSharp(repoRoot) {
+    try {
+        const toolRequire = createRequire(resolve(repoRoot, "tools", "asset-optimize", "package.json"));
+        const mod = (await import(toolRequire.resolve("sharp")));
+        return (mod.default ?? mod);
+    }
+    catch {
+        return undefined;
+    }
+}
+const PROXY = 256;
+/** Extracts image bytes for a material slot's texture reference. */
+function imageBytesFor(json, bin, gltfDir, texInfo) {
+    const textureIndex = texInfo?.extensions?.KHR_texture_basisu?.index ?? texInfo?.index;
+    if (textureIndex === undefined)
+        return undefined;
+    const texture = json.textures?.[textureIndex];
+    const sourceIndex = texture?.extensions?.KHR_texture_basisu?.source ?? texture?.source;
+    const image = sourceIndex !== undefined ? json.images?.[sourceIndex] : undefined;
+    if (!image)
+        return undefined;
+    if (image.bufferView !== undefined && bin) {
+        const view = json.bufferViews?.[image.bufferView];
+        if (!view)
+            return undefined;
+        return { bytes: bin.subarray(view.byteOffset ?? 0, (view.byteOffset ?? 0) + view.byteLength), mimeType: image.mimeType };
+    }
+    if (image.uri && !image.uri.startsWith("data:")) {
+        const file = resolve(gltfDir, decodeURIComponent(image.uri));
+        if (!existsSync(file))
+            return undefined;
+        return { bytes: readFileSync(file), mimeType: image.mimeType ?? `image/${extname(file).slice(1)}` };
+    }
+    return undefined;
+}
+function channelStats(data, width, height, channels) {
+    const px = width * height;
+    const sums = [0, 0, 0, 0];
+    const sumsSq = [0, 0, 0, 0];
+    let normalInRange = 0;
+    let normalBlueSum = 0;
+    let luminanceInRange = 0;
+    let luminanceSum = 0;
+    for (let i = 0; i < px; i++) {
+        const at = i * channels;
+        const r = data[at] ?? 0;
+        const g = data[at + 1] ?? 0;
+        const b = data[at + 2] ?? 0;
+        sums[0] += r;
+        sums[1] += g;
+        sums[2] += b;
+        sumsSq[0] += r * r;
+        sumsSq[1] += g * g;
+        sumsSq[2] += b * b;
+        const nx = r / 127.5 - 1;
+        const ny = g / 127.5 - 1;
+        const nz = b / 127.5 - 1;
+        const len = Math.hypot(nx, ny, nz);
+        if (len >= 0.9 && len <= 1.1)
+            normalInRange += 1;
+        normalBlueSum += nz;
+        const lum = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+        luminanceSum += lum;
+        if (lum >= 30 && lum <= 240)
+            luminanceInRange += 1;
+    }
+    const channels_ = [];
+    const constantChannels = [];
+    const names = ["R", "G", "B", "A"];
+    for (let c = 0; c < Math.min(channels, 4); c++) {
+        const mean = (sums[c] ?? 0) / px;
+        const stdDev = Math.sqrt(Math.max(0, (sumsSq[c] ?? 0) / px - mean * mean));
+        channels_.push({ mean, stdDev });
+        if (stdDev / 255 < 0.004)
+            constantChannels.push(names[c]);
+    }
+    return {
+        channels: channels_,
+        normalLength: { mean: 0, inUnitRange: normalInRange / px, meanBlue: normalBlueSum / px },
+        luminance: { mean: luminanceSum / px, inRange30to240: luminanceInRange / px },
+        constantChannels
+    };
+}
+/**
+ * Measures G6 stats for every material texture slot in the glTF.
+ * `gltfDir` resolves external image URIs (gltf container); GLB images come
+ * from `bin`.
+ */
+export async function measureTextureSanity(json, bin, gltfDir, repoRoot) {
+    const full = json;
+    const sharp = await loadSharp(repoRoot);
+    const jobs = [];
+    const materials = (full.materials ?? []);
+    materials.forEach((material, materialIndex) => {
+        const slots = [
+            ["baseColor", material.pbrMetallicRoughness?.baseColorTexture],
+            ["normal", material.normalTexture],
+            ["metallicRoughness", material.pbrMetallicRoughness?.metallicRoughnessTexture],
+            ["occlusion", material.occlusionTexture],
+            ["emissive", material.emissiveTexture]
+        ];
+        for (const [slot, info] of slots) {
+            const image = imageBytesFor(full, bin, gltfDir, info);
+            if (image)
+                jobs.push({ slot, materialIndex, materialName: material.name, bytes: image.bytes, mimeType: image.mimeType });
+        }
+    });
+    if (jobs.length === 0) {
+        return { available: true, textures: [] };
+    }
+    if (!sharp) {
+        return {
+            available: false,
+            unavailableReason: "sharp is not installed — run `npm install` in tools/asset-optimize (G6 decode needs it).",
+            textures: jobs.map((job) => {
+                const size = sniffImageSize(job.bytes, job.mimeType);
+                return {
+                    slot: job.slot,
+                    materialIndex: job.materialIndex,
+                    ...(job.materialName ? { materialName: job.materialName } : {}),
+                    width: size?.[0] ?? 0,
+                    height: size?.[1] ?? 0,
+                    ...(job.mimeType ? { mimeType: job.mimeType } : {}),
+                    powerOfTwo: size ? isPowerOfTwo(size[0]) && isPowerOfTwo(size[1]) : false,
+                    error: "decode-unavailable"
+                };
+            })
+        };
+    }
+    const textures = [];
+    for (const job of jobs) {
+        const size = sniffImageSize(job.bytes, job.mimeType);
+        const base = {
+            slot: job.slot,
+            materialIndex: job.materialIndex,
+            ...(job.materialName ? { materialName: job.materialName } : {}),
+            width: size?.[0] ?? 0,
+            height: size?.[1] ?? 0,
+            ...(job.mimeType ? { mimeType: job.mimeType } : {}),
+            powerOfTwo: size ? isPowerOfTwo(size[0]) && isPowerOfTwo(size[1]) : false
+        };
+        try {
+            let pipeline = sharp(job.bytes);
+            const meta = await pipeline.metadata();
+            const srcW = size?.[0] ?? meta.width ?? 0;
+            const srcH = size?.[1] ?? meta.height ?? 0;
+            if (srcW > PROXY || srcH > PROXY) {
+                const scale = Math.min(1, PROXY / Math.max(srcW, srcH));
+                pipeline = pipeline.resize(Math.max(1, Math.round(srcW * scale)), Math.max(1, Math.round(srcH * scale)), { fit: "fill" });
+            }
+            const raw = await pipeline.raw().toBuffer({ resolveWithObject: true });
+            const stats = channelStats(raw.data, raw.info.width, raw.info.height, raw.info.channels);
+            const space = meta.space;
+            textures.push({
+                ...base,
+                width: raw.info.width || base.width,
+                height: raw.info.height || base.height,
+                channels: stats.channels,
+                ...(job.slot === "normal" ? { normalLength: { ...stats.normalLength, meanBlue: stats.normalLength.meanBlue } } : {}),
+                ...(job.slot === "baseColor" ? { luminance: stats.luminance } : {}),
+                ...(job.slot === "metallicRoughness" || job.slot === "occlusion" ? { constantChannels: stats.constantChannels } : {}),
+                ...(space && space !== "srgb" && job.slot === "baseColor" ? { error: `colorspace-${space}` } : {})
+            });
+        }
+        catch (error) {
+            // KTX2/basisu sources can't be decoded by sharp — sniffed dims still land.
+            textures.push({ ...base, error: `undecodable: ${error instanceof Error ? error.message.slice(0, 80) : String(error)}` });
+        }
+    }
+    return { available: true, textures };
+}
+//# sourceMappingURL=textureStats.js.map

package/dist/admission/textureStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureStats.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/textureStats.ts"],"names":[],"mappings":"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"}

package/dist/animation-asset-validator.d.ts

@@ -7,13 +7,57 @@ export interface AnimationAssetValidationOptions {
     readonly requiredActions?: readonly string[];
     /** Require the asset to declare at least one clip at all (proxy for "rigged/animated"). */
     readonly requireRig?: boolean;
+    /**
+     * T4.6 (PRD-06) — geometry + clip-duration inspection for hero profiles,
+     * filled by the lane's GLB reader (`commands/prd06/validateHero.ts`). Hero
+     * profile checks run only when this is present.
+     */
+    readonly inspection?: AnimationAssetInspection;
+    /**
+     * T4.6 — a named hero profile (`hero-character` floor; `template-hero` §6.9
+     * bar). Profiles add geometry/texture/duration checks and emit reason codes;
+     * they never suppress the clip-map messages above.
+     */
+    readonly profile?: AnimationAssetHeroProfile;
 }
+/** T4.6 — geometry/texture/duration facts the hero profiles evaluate. */
+export interface AnimationAssetInspection {
+    readonly triangleCount: number;
+    readonly skinCount: number;
+    /** Max joints across skins (glTF `skins[].joints.length`). */
+    readonly jointCount: number;
+    readonly clips: readonly {
+        readonly name: string;
+        readonly duration: number;
+    }[];
+    readonly hasBaseColorTexture: boolean;
+}
+export type AnimationAssetHeroProfile = "hero-character" | "template-hero";
+export declare const HERO_NOT_A_CHARACTER = "HERO_NOT_A_CHARACTER";
+export declare const HERO_NO_SKIN = "HERO_NO_SKIN";
+export declare const HERO_TOO_FEW_JOINTS = "HERO_TOO_FEW_JOINTS";
+export declare const HERO_MISSING_CLIP = "HERO_MISSING_CLIP";
+export declare const HERO_CLIP_TOO_SHORT = "HERO_CLIP_TOO_SHORT";
+export declare const HERO_UNTEXTURED = "HERO_UNTEXTURED";
+/** §6.9 clip set for `template-hero`; `hero-character` needs the locomotion subset. */
+export declare const HERO_CHARACTER_ACTIONS: readonly ["idle", "walk", "run", "jump-start", "jump-loop", "land"];
+export declare const TEMPLATE_HERO_ACTIONS: readonly ["idle", "walk", "run", "jump-start", "jump-loop", "land", "sprint", "turn-l", "turn-r", "interact", "hit-react", "attack"];
+export interface AnimationAssetHeroProfileDefinition {
+    readonly profile: AnimationAssetHeroProfile;
+    readonly minTriangles: number;
+    readonly minJoints: number;
+    readonly requiredActions: readonly string[];
+    readonly minClipDuration: number;
+}
+export declare const ANIMATION_ASSET_HERO_PROFILES: Record<AnimationAssetHeroProfile, AnimationAssetHeroProfileDefinition>;
 export interface AnimationAssetValidationReport {
     readonly ok: boolean;
     readonly messages: readonly string[];
     readonly failures: readonly string[];
     readonly missingActions: readonly string[];
     readonly missingClips: readonly string[];
+    /** T4.6 — reason codes for the hero profiles (`[]` on the legacy path). */
+    readonly reasonCodes: readonly string[];
 }
 export declare const DEFAULT_ANIMATION_ACTIONS: readonly ["idle", "walk", "run"];
 export declare function validateAnimationAssets(options: AnimationAssetValidationOptions): AnimationAssetValidationReport;

package/dist/animation-asset-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation-asset-validator.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/animation-asset-validator.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,+BAA+B;IAC9C,iFAAiF;IACjF,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,eAAO,MAAM,yBAAyB,kCAAmC,CAAC;AAE1E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,+BAA+B,GAAG,8BAA8B,CAkChH;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQrF"}
+{"version":3,"file":"animation-asset-validator.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/animation-asset-validator.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,+BAA+B;IAC9C,iFAAiF;IACjF,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,wBAAwB,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,CAAC;CAC9C;AAED,yEAAyE;AACzE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChF,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,MAAM,yBAAyB,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAE3E,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAEjD,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,qEAAsE,CAAC;AAC1G,eAAO,MAAM,qBAAqB,sIAGxB,CAAC;AAEX,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,yBAAyB,EAAE,mCAAmC,CAehH,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,eAAO,MAAM,yBAAyB,kCAAmC,CAAC;AAE1E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,+BAA+B,GAAG,8BAA8B,CAyFhH;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQrF"}

package/dist/animation-asset-validator.js

@@ -1,6 +1,34 @@
 // Self-contained `assets validate-animation` validator: checks that a character's required
 // locomotion/action clips are present in its available clip set (from --clips or the asset
 // manifest's animationClips metadata). No external dep so the CLI boundary stays standalone.
+export const HERO_NOT_A_CHARACTER = "HERO_NOT_A_CHARACTER";
+export const HERO_NO_SKIN = "HERO_NO_SKIN";
+export const HERO_TOO_FEW_JOINTS = "HERO_TOO_FEW_JOINTS";
+export const HERO_MISSING_CLIP = "HERO_MISSING_CLIP";
+export const HERO_CLIP_TOO_SHORT = "HERO_CLIP_TOO_SHORT";
+export const HERO_UNTEXTURED = "HERO_UNTEXTURED";
+/** §6.9 clip set for `template-hero`; `hero-character` needs the locomotion subset. */
+export const HERO_CHARACTER_ACTIONS = ["idle", "walk", "run", "jump-start", "jump-loop", "land"];
+export const TEMPLATE_HERO_ACTIONS = [
+    ...HERO_CHARACTER_ACTIONS,
+    "sprint", "turn-l", "turn-r", "interact", "hit-react", "attack"
+];
+export const ANIMATION_ASSET_HERO_PROFILES = {
+    "hero-character": {
+        profile: "hero-character",
+        minTriangles: 2_000,
+        minJoints: 30,
+        requiredActions: HERO_CHARACTER_ACTIONS,
+        minClipDuration: 0.2
+    },
+    "template-hero": {
+        profile: "template-hero",
+        minTriangles: 15_000,
+        minJoints: 50,
+        requiredActions: TEMPLATE_HERO_ACTIONS,
+        minClipDuration: 0.2
+    }
+};
 export const DEFAULT_ANIMATION_ACTIONS = ["idle", "walk", "run"];
 export function validateAnimationAssets(options) {
     const requiredActions = options.requiredActions ?? DEFAULT_ANIMATION_ACTIONS;
@@ -9,6 +37,7 @@ export function validateAnimationAssets(options) {
     const messages = [];
     const missingActions = [];
     const missingClips = [];
+    const reasonCodes = new Set();
     if (options.requireRig && available.size === 0) {
         failures.push("asset declares no animation clips (expected a rigged/animated character).");
     }
@@ -26,12 +55,62 @@ export function validateAnimationAssets(options) {
         }
         messages.push(`action "${action}" -> "${clip}" OK`);
     }
+    const profile = options.profile !== undefined ? ANIMATION_ASSET_HERO_PROFILES[options.profile] : undefined;
+    const inspection = options.inspection;
+    if (profile !== undefined && inspection !== undefined) {
+        // Geometry + texture bar — every code is reported, not just the first.
+        if (inspection.triangleCount < profile.minTriangles) {
+            reasonCodes.add(HERO_NOT_A_CHARACTER);
+            failures.push(`${profile.profile}: ${inspection.triangleCount} triangles < ${profile.minTriangles} (${HERO_NOT_A_CHARACTER}).`);
+        }
+        if (inspection.skinCount < 1) {
+            reasonCodes.add(HERO_NO_SKIN);
+            failures.push(`${profile.profile}: no skinned mesh (${HERO_NO_SKIN}).`);
+        }
+        if (inspection.jointCount < profile.minJoints) {
+            reasonCodes.add(HERO_TOO_FEW_JOINTS);
+            failures.push(`${profile.profile}: ${inspection.jointCount} joints < ${profile.minJoints} (${HERO_TOO_FEW_JOINTS}).`);
+        }
+        // Clip coverage against the profile's action set — unmapped actions and
+        // absent clips both land under HERO_MISSING_CLIP (the union, deduped).
+        const durations = new Map(inspection.clips.map((clip) => [clip.name, clip.duration]));
+        let missingClip = false;
+        for (const action of profile.requiredActions) {
+            const clip = options.clipMap[action];
+            if (clip === undefined || clip.trim().length === 0 || !durations.has(clip)) {
+                missingClip = true;
+                if (!missingActions.includes(action))
+                    missingActions.push(action);
+                if (clip !== undefined && clip.trim().length > 0 && !missingClips.includes(clip))
+                    missingClips.push(clip);
+            }
+        }
+        if (missingClip) {
+            reasonCodes.add(HERO_MISSING_CLIP);
+            failures.push(`${profile.profile}: required action(s) unmapped or clip absent (${HERO_MISSING_CLIP}).`);
+        }
+        for (const action of profile.requiredActions) {
+            const clip = options.clipMap[action];
+            if (clip === undefined)
+                continue;
+            const duration = durations.get(clip);
+            if (duration !== undefined && duration < profile.minClipDuration) {
+                reasonCodes.add(HERO_CLIP_TOO_SHORT);
+                failures.push(`${profile.profile}: clip "${clip}" is ${duration.toFixed(3)} s < ${profile.minClipDuration} s (${HERO_CLIP_TOO_SHORT}).`);
+            }
+        }
+        if (!inspection.hasBaseColorTexture) {
+            reasonCodes.add(HERO_UNTEXTURED);
+            failures.push(`${profile.profile}: no baseColor texture (${HERO_UNTEXTURED}).`);
+        }
+    }
     return {
         ok: failures.length === 0,
         messages,
         failures,
         missingActions,
-        missingClips
+        missingClips,
+        reasonCodes: [...reasonCodes]
     };
 }
 /** Parse a `--map idle=Idle_Loop,walk=Walk_Loop` style flag into a clip map. */