@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/character/bakeBodyRegions.d.ts

@@ -0,0 +1,80 @@
+import { Document } from '@gltf-transform/core';
+import { type HelixBodyRegion } from './bodyRegionHide';
+/**
+ * Bakes a `_REGION` per-vertex glTF attribute into a HELIX canonical base body, so the platform's already-built
+ * `hide` grants (`character-slot-pack.ts` / `characterBase.ts`) can actually suppress the body region a garment
+ * covers — WITHOUT adding a single draw call.
+ *
+ * ── WHY BAKED DATA, NOT MORE PRIMITIVES ────────────────────────────────────────────────────────────────────────
+ * The obvious way to make "hide the thigh" real is to split the body mesh into a separate thigh primitive that
+ * can be toggled invisible. That is the wrong shape here: HELIX's own character draw-call budget is single
+ * digits per character (`docs/proposals/character-mesh-composition-optimization.md`, hero tier <= 6, target 4),
+ * multiplied by every character in a room, so turning ONE body draw into fifteen (one per `HELIX_BODY_REGIONS`
+ * entry) is a real, multiplied regression, not a style choice. Baking the region as VERTEX DATA and collapsing
+ * hidden triangles at runtime (`helix-web-engine-new`'s `applyComposition`) keeps the body at exactly the draw
+ * calls it already has — the same technique this codebase already uses for vehicle parts
+ * (`vehicleBatchedDraw.ts`'s "the part stays in the graph, it just stops being submitted").
+ *
+ * ── WHY THE COLLAPSE IS AN INDEX REWRITE, NOT A SHADER ────────────────────────────────────────────────────────
+ * A per-instance-uniform + `onBeforeCompile` shader patch was the first idea and the wrong one: this engine's
+ * own recent history is the reason why. `vehicleBatchedDraw.ts`'s emissive-colour patch relies on exactly that
+ * technique, and `WebGPURenderer` silently skips every `onBeforeCompile` patch — "every batched car rendered
+ * white" until the WebGPU renderer was detected and the batch gracefully degraded (helix-web-engine-new
+ * `11075018`, "car paint on WebGPU"). Collapsing a hidden triangle's three indices to a single shared vertex
+ * index, instead, needs no shader at all: it is the same index-buffer data on WebGL, WebGPU, or any future
+ * renderer, because a triangle whose three corners are the same point has zero area under ANY rasteriser by
+ * definition — there is no renderer-specific code path to keep in parity because there is no renderer-specific
+ * code at all.
+ *
+ * ── WHAT THIS TOOL DOES AND DOES NOT TOUCH ────────────────────────────────────────────────────────────────────
+ * Adds ONE custom glTF vertex attribute (`_REGION`, one unsigned byte per vertex — an index into
+ * `HELIX_BODY_REGIONS`, `255` for a vertex this classifier could not place). Every other accessor, node name,
+ * skin, material, and socket is byte-for-byte unchanged, which is the point: every add-on's `fits` already
+ * requires specific node/socket names from this exact body, and this must republish as a COMPATIBLE version,
+ * never a breaking one.
+ *
+ * ── THE HIP/TORSO SPLIT: A JOINT BOUNDARY, WIDENED BY THE BLEND ZONE THE RIG ITSELF PAINTED ──────────────────
+ * `body_hip` (pelvis-dominant: glutes, hip crest, lower abdomen, the ring a waistband sits on) is distinguished
+ * from `body_torso` (spine/clavicle-dominant: ribs, chest, upper stomach) using the rig's OWN skin weights, not
+ * an authored world-space height — a height threshold is population-specific (Base Male and Base Female differ
+ * in proportions) and would need re-tuning per body, where the rig's own weight painting needs none.
+ *
+ * A pure "which joint has the single highest weight" argmax is NOT enough on its own, though — MEASURED on the
+ * real Base Female against the real Sinth Ascetic Pants that motivated this file: the argmax boundary sits at
+ * world Y ~1.02 (of a ~1.67m-tall rest pose, i.e. ~61% up), but that pants' actual waistband reaches Y=1.057 —
+ * 3.5cm ABOVE where argmax alone would have drawn the line. Hiding only up to the argmax boundary would have
+ * left exactly the residual poke-through this file exists to close.
+ *
+ * The fix is still entirely rig-driven: any vertex where PELVIS carries at least `HIP_BLEND_WEIGHT_THRESHOLD`
+ * of its total skin weight is `body_hip`, even where spine_01 is nominally the single largest contributor — the
+ * blend zone between two joints is real geometry the rig already describes, and reading it (rather than only
+ * the winning joint) is what recovers the missing 3.5cm. Measured on the same body: vertices where pelvis
+ * weight >= 0.1 reach up to Y=1.068, comfortably (~1.1cm) above that pants' waistband, while >= 0.25 only
+ * reaches Y=1.044 (still short) and "any nonzero pelvis weight at all" reaches Y=1.093 (too far, starting to
+ * eat into unambiguous stomach/ribs territory) — 0.1 is the threshold with headroom on the one real garment
+ * measured against it. This is an empirical property of THIS rig's weight painting, not a universal constant:
+ * re-verify (the poke-through tool's own region breakdown, or a debug region-colour render) against a real
+ * high-rise or low-rise pants item before trusting it unchanged on a differently-proportioned future body.
+ */
+/** See "THE HIP/TORSO SPLIT" above — the empirically-chosen pelvis-weight blend threshold. */
+export declare const HIP_BLEND_WEIGHT_THRESHOLD = 0.1;
+/** `_REGION` encodes "no confident classification" as 255 (an unsigned byte, so this is the natural sentinel —
+ *  never a valid `HELIX_BODY_REGIONS` index, since the vocabulary has far fewer than 255 entries). */
+export declare const UNCLASSIFIED_REGION_INDEX = 255;
+/** The region for a canonical joint name, or `null` if this classifier cannot confidently place it. */
+export declare function regionForJoint(jointName: string): HelixBodyRegion | null;
+export interface BakeBodyRegionsReport {
+    /** Skinned mesh primitives that received a `_REGION` attribute. */
+    primitivesBaked: number;
+    /** Vertices across every baked primitive. */
+    verticesTotal: number;
+    /** Vertices whose dominant joint could not be classified into a region (baked as 255). */
+    verticesUnclassified: number;
+    /** Vertex count per region name, for a sanity check against the mesh's expected proportions. */
+    regionCounts: Readonly<Record<string, number>>;
+}
+/**
+ * Bakes `_REGION` onto every skinned primitive in `document`, mutating it in place. Returns a report for the
+ * caller to log/verify; throws only if a skinned mesh has no skin (never expected for a HELIX canonical body).
+ */
+export declare function bakeBodyRegions(document: Document): BakeBodyRegionsReport;

package/dist/character/bakeBodyRegions.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNCLASSIFIED_REGION_INDEX = exports.HIP_BLEND_WEIGHT_THRESHOLD = void 0;
+exports.regionForJoint = regionForJoint;
+exports.bakeBodyRegions = bakeBodyRegions;
+const bodyRegionHide_1 = require("./bodyRegionHide");
+/**
+ * Bakes a `_REGION` per-vertex glTF attribute into a HELIX canonical base body, so the platform's already-built
+ * `hide` grants (`character-slot-pack.ts` / `characterBase.ts`) can actually suppress the body region a garment
+ * covers — WITHOUT adding a single draw call.
+ *
+ * ── WHY BAKED DATA, NOT MORE PRIMITIVES ────────────────────────────────────────────────────────────────────────
+ * The obvious way to make "hide the thigh" real is to split the body mesh into a separate thigh primitive that
+ * can be toggled invisible. That is the wrong shape here: HELIX's own character draw-call budget is single
+ * digits per character (`docs/proposals/character-mesh-composition-optimization.md`, hero tier <= 6, target 4),
+ * multiplied by every character in a room, so turning ONE body draw into fifteen (one per `HELIX_BODY_REGIONS`
+ * entry) is a real, multiplied regression, not a style choice. Baking the region as VERTEX DATA and collapsing
+ * hidden triangles at runtime (`helix-web-engine-new`'s `applyComposition`) keeps the body at exactly the draw
+ * calls it already has — the same technique this codebase already uses for vehicle parts
+ * (`vehicleBatchedDraw.ts`'s "the part stays in the graph, it just stops being submitted").
+ *
+ * ── WHY THE COLLAPSE IS AN INDEX REWRITE, NOT A SHADER ────────────────────────────────────────────────────────
+ * A per-instance-uniform + `onBeforeCompile` shader patch was the first idea and the wrong one: this engine's
+ * own recent history is the reason why. `vehicleBatchedDraw.ts`'s emissive-colour patch relies on exactly that
+ * technique, and `WebGPURenderer` silently skips every `onBeforeCompile` patch — "every batched car rendered
+ * white" until the WebGPU renderer was detected and the batch gracefully degraded (helix-web-engine-new
+ * `11075018`, "car paint on WebGPU"). Collapsing a hidden triangle's three indices to a single shared vertex
+ * index, instead, needs no shader at all: it is the same index-buffer data on WebGL, WebGPU, or any future
+ * renderer, because a triangle whose three corners are the same point has zero area under ANY rasteriser by
+ * definition — there is no renderer-specific code path to keep in parity because there is no renderer-specific
+ * code at all.
+ *
+ * ── WHAT THIS TOOL DOES AND DOES NOT TOUCH ────────────────────────────────────────────────────────────────────
+ * Adds ONE custom glTF vertex attribute (`_REGION`, one unsigned byte per vertex — an index into
+ * `HELIX_BODY_REGIONS`, `255` for a vertex this classifier could not place). Every other accessor, node name,
+ * skin, material, and socket is byte-for-byte unchanged, which is the point: every add-on's `fits` already
+ * requires specific node/socket names from this exact body, and this must republish as a COMPATIBLE version,
+ * never a breaking one.
+ *
+ * ── THE HIP/TORSO SPLIT: A JOINT BOUNDARY, WIDENED BY THE BLEND ZONE THE RIG ITSELF PAINTED ──────────────────
+ * `body_hip` (pelvis-dominant: glutes, hip crest, lower abdomen, the ring a waistband sits on) is distinguished
+ * from `body_torso` (spine/clavicle-dominant: ribs, chest, upper stomach) using the rig's OWN skin weights, not
+ * an authored world-space height — a height threshold is population-specific (Base Male and Base Female differ
+ * in proportions) and would need re-tuning per body, where the rig's own weight painting needs none.
+ *
+ * A pure "which joint has the single highest weight" argmax is NOT enough on its own, though — MEASURED on the
+ * real Base Female against the real Sinth Ascetic Pants that motivated this file: the argmax boundary sits at
+ * world Y ~1.02 (of a ~1.67m-tall rest pose, i.e. ~61% up), but that pants' actual waistband reaches Y=1.057 —
+ * 3.5cm ABOVE where argmax alone would have drawn the line. Hiding only up to the argmax boundary would have
+ * left exactly the residual poke-through this file exists to close.
+ *
+ * The fix is still entirely rig-driven: any vertex where PELVIS carries at least `HIP_BLEND_WEIGHT_THRESHOLD`
+ * of its total skin weight is `body_hip`, even where spine_01 is nominally the single largest contributor — the
+ * blend zone between two joints is real geometry the rig already describes, and reading it (rather than only
+ * the winning joint) is what recovers the missing 3.5cm. Measured on the same body: vertices where pelvis
+ * weight >= 0.1 reach up to Y=1.068, comfortably (~1.1cm) above that pants' waistband, while >= 0.25 only
+ * reaches Y=1.044 (still short) and "any nonzero pelvis weight at all" reaches Y=1.093 (too far, starting to
+ * eat into unambiguous stomach/ribs territory) — 0.1 is the threshold with headroom on the one real garment
+ * measured against it. This is an empirical property of THIS rig's weight painting, not a universal constant:
+ * re-verify (the poke-through tool's own region breakdown, or a debug region-colour render) against a real
+ * high-rise or low-rise pants item before trusting it unchanged on a differently-proportioned future body.
+ */
+/** See "THE HIP/TORSO SPLIT" above — the empirically-chosen pelvis-weight blend threshold. */
+exports.HIP_BLEND_WEIGHT_THRESHOLD = 0.1;
+/** `_REGION` encodes "no confident classification" as 255 (an unsigned byte, so this is the natural sentinel —
+ *  never a valid `HELIX_BODY_REGIONS` index, since the vocabulary has far fewer than 255 entries). */
+exports.UNCLASSIFIED_REGION_INDEX = 255;
+const REGION_INDEX = new Map(bodyRegionHide_1.HELIX_BODY_REGIONS.map((region, index) => [region, index]));
+/**
+ * Canonical-skeleton joint name -> body region, for every joint whose skin-weight dominance should classify a
+ * vertex. A joint absent here (finger sub-segments beyond the metacarpal, twist helpers not listed, etc.)
+ * falls through to the regex fallback in `regionForJoint`, and failing that, `UNCLASSIFIED_REGION_INDEX`.
+ */
+const JOINT_TO_REGION = {
+    head: 'body_head',
+    neck_01: 'body_neck', neck_02: 'body_neck',
+    // Spine + clavicles: everything ABOVE the pelvis's own weight zone. See the file header for why this joint
+    // boundary, not an authored height, is the hip/torso split.
+    spine_01: 'body_torso', spine_02: 'body_torso', spine_03: 'body_torso', spine_04: 'body_torso', spine_05: 'body_torso',
+    clavicle_l: 'body_torso', clavicle_r: 'body_torso',
+    pelvis: 'body_hip',
+    upperarm_l: 'body_upperarm_l', upperarm_twist_01_l: 'body_upperarm_l', upperarm_twist_02_l: 'body_upperarm_l',
+    upperarm_r: 'body_upperarm_r', upperarm_twist_01_r: 'body_upperarm_r', upperarm_twist_02_r: 'body_upperarm_r',
+    lowerarm_l: 'body_forearm_l', lowerarm_twist_01_l: 'body_forearm_l', lowerarm_twist_02_l: 'body_forearm_l',
+    lowerarm_r: 'body_forearm_r', lowerarm_twist_01_r: 'body_forearm_r', lowerarm_twist_02_r: 'body_forearm_r',
+    thigh_l: 'body_thigh_l', thigh_twist_01_l: 'body_thigh_l',
+    thigh_r: 'body_thigh_r', thigh_twist_01_r: 'body_thigh_r',
+    calf_l: 'body_shin_l', calf_twist_01_l: 'body_shin_l',
+    calf_r: 'body_shin_r', calf_twist_01_r: 'body_shin_r',
+    foot_l: 'body_foot_l', ball_l: 'body_foot_l',
+    foot_r: 'body_foot_r', ball_r: 'body_foot_r',
+};
+/** The region for a canonical joint name, or `null` if this classifier cannot confidently place it. */
+function regionForJoint(jointName) {
+    const direct = JOINT_TO_REGION[jointName];
+    if (direct)
+        return direct;
+    if (/(pinky|ring|thumb|middle|index|hand)/.test(jointName)) {
+        if (jointName.endsWith('_l'))
+            return 'body_hand_l';
+        if (jointName.endsWith('_r'))
+            return 'body_hand_r';
+    }
+    return null;
+}
+/**
+ * Bakes `_REGION` onto every skinned primitive in `document`, mutating it in place. Returns a report for the
+ * caller to log/verify; throws only if a skinned mesh has no skin (never expected for a HELIX canonical body).
+ */
+function bakeBodyRegions(document) {
+    let primitivesBaked = 0;
+    let verticesTotal = 0;
+    let verticesUnclassified = 0;
+    const regionCounts = {};
+    for (const node of document.getRoot().listNodes()) {
+        const mesh = node.getMesh();
+        const skin = node.getSkin();
+        if (!mesh || !skin)
+            continue;
+        const joints = skin.listJoints();
+        const jointNames = joints.map((j) => j.getName());
+        const jointRegionIndex = jointNames.map((name) => {
+            const region = regionForJoint(name);
+            return region === null ? exports.UNCLASSIFIED_REGION_INDEX : REGION_INDEX.get(region);
+        });
+        const pelvisJointIndex = jointNames.indexOf('pelvis');
+        const hipRegionIndex = REGION_INDEX.get('body_hip');
+        const torsoRegionIndex = REGION_INDEX.get('body_torso');
+        for (const prim of mesh.listPrimitives()) {
+            const pos = prim.getAttribute('POSITION');
+            if (!pos)
+                continue;
+            const count = pos.getCount();
+            const region = new Uint8Array(count).fill(exports.UNCLASSIFIED_REGION_INDEX);
+            const sets = [];
+            for (const s of [0, 1]) {
+                const j = prim.getAttribute(`JOINTS_${s}`);
+                const w = prim.getAttribute(`WEIGHTS_${s}`);
+                if (j && w)
+                    sets.push({ j, w });
+            }
+            const jBuf = [0, 0, 0, 0];
+            const wBuf = [0, 0, 0, 0];
+            for (let i = 0; i < count; i++) {
+                let dominantWeight = -1;
+                let dominantJoint = -1;
+                let weightSum = 0;
+                let pelvisWeight = 0;
+                for (const { j, w } of sets) {
+                    j.getElement(i, jBuf);
+                    w.getElement(i, wBuf);
+                    for (let k = 0; k < 4; k++) {
+                        const weight = wBuf[k];
+                        weightSum += weight;
+                        if (pelvisJointIndex >= 0 && jBuf[k] === pelvisJointIndex)
+                            pelvisWeight += weight;
+                        if (weight > dominantWeight) {
+                            dominantWeight = weight;
+                            dominantJoint = jBuf[k];
+                        }
+                    }
+                }
+                let regionIndex = dominantJoint >= 0 ? jointRegionIndex[dominantJoint] : exports.UNCLASSIFIED_REGION_INDEX;
+                // The pelvis/spine blend-zone widening — see "THE HIP/TORSO SPLIT" above. Only ever pulls a vertex
+                // FROM torso INTO hip; every other region (thigh, arm, ...) is left exactly as the dominant joint says.
+                if (regionIndex === torsoRegionIndex && weightSum > 0 && pelvisWeight / weightSum >= exports.HIP_BLEND_WEIGHT_THRESHOLD) {
+                    regionIndex = hipRegionIndex;
+                }
+                region[i] = regionIndex;
+                verticesTotal++;
+                if (regionIndex === exports.UNCLASSIFIED_REGION_INDEX) {
+                    verticesUnclassified++;
+                }
+                else {
+                    const name = bodyRegionHide_1.HELIX_BODY_REGIONS[regionIndex];
+                    regionCounts[name] = (regionCounts[name] ?? 0) + 1;
+                }
+            }
+            const buffer = pos.getBuffer();
+            const regionAccessor = document.createAccessor()
+                .setType('SCALAR')
+                .setArray(region)
+                .setBuffer(buffer);
+            prim.setAttribute('_REGION', regionAccessor);
+            primitivesBaked++;
+        }
+    }
+    return { primitivesBaked, verticesTotal, verticesUnclassified, regionCounts };
+}
+//# sourceMappingURL=bakeBodyRegions.js.map

package/dist/character/bakeBodyRegions.js.map

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

package/dist/character/baseColorGuard.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Refuse a GLB whose `baseColorTexture` is a tangent-space NORMAL map.
+ *
+ * ── THE DEFECT (live 2026-09-29/30, 17 Cyberpunk add-ons) ───────────────────────────────────────────
+ * Cyberpunk 2077 garments carry no albedo image at all: their colour is the composite of a 20-layer
+ * "Multilayered" shader (mask atlas x per-layer tints x shared microblend textures). Blender's glTF exporter
+ * cannot evaluate that node group, so it walks the graph and binds the first image it can reach — a shared
+ * microblend NORMAL map (`dirt_stains`, `dust_fine`, `default`) — as `baseColorTexture`. Every garment that
+ * took that path rendered flat lavender (RGB ~128,128,255, a tangent normal map's "straight up") in the
+ * catalogue thumbnail, and near-black with specular speckle in the 3D preview where the same image also sat in
+ * `metallicRoughnessTexture`.
+ *
+ * ── WHY EVERY EXISTING GATE PASSED IT ───────────────────────────────────────────────────────────────
+ * `helix bridge validate`, the old Item-first publication dry run, the draw-call / triangle / material / texture-size
+ * budgets, the leftover-body-geometry guard, the pose-aware fit, the skeleton checks and the engine bind check
+ * are all structural or budget-based. None of them reads a pixel of the albedo, so "valid glTF, correct
+ * skeleton, under budget" was true of a model that could not possibly look right. The only one that samples
+ * the albedo (`bodyGeometryGuard`) does so to find untextured *islands*, not to ask whether the image is a colour.
+ *
+ * ── THE TESTS (any one refuses) ─────────────────────────────────────────────────────────────────────────
+ *   IDENTITY  the baseColor image bytes are identical to the same material's normal / metallicRoughness /
+ *             occlusion image. A colour map is never the same file as its own normal map. (Only fires on
+ *             un-packaged PNG/JPEG: KTX2 encoding writes a colour and a linear copy of one source with
+ *             different bytes, so on a bridge-packaged file CONTENT is the rule that carries the weight.)
+ *   CONTENT   the decoded pixels have a tangent normal map's signature: mean R,G within 14 of 128, mean B
+ *             above 215, and R/G spread under 22. Real normal maps cluster tightly around (128,128,255) because
+ *             most of a surface faces its own normal; a real albedo with that colour AND that flatness is a
+ *             solid periwinkle fill, which belongs in `baseColorFactor`, not in a texture.
+ * A texture that cannot be decoded is reported as UNCHECKED and does NOT refuse (a gap in this checker must not
+ * become a creator's dead end — same precedent as the mesh preflight), but it is surfaced to the caller.
+ *
+ * Escape hatch for a genuine periwinkle fill: `HELIX_ALLOW_NORMAL_MAP_BASE_COLOR=1`.
+ */
+import type { Document } from '@gltf-transform/core';
+export interface BaseColorFinding {
+    material: string;
+    texture: string;
+    reason: 'identity' | 'content';
+    detail: string;
+}
+export interface BaseColorReport {
+    findings: BaseColorFinding[];
+    /** Materials whose baseColor image could not be decoded, so no content verdict was possible. */
+    unchecked: string[];
+}
+export declare const NORMAL_MAP_MEAN_TOLERANCE = 14;
+export declare const NORMAL_MAP_MIN_BLUE_MEAN = 215;
+export declare const NORMAL_MAP_MAX_RG_STDEV = 22;
+export declare function inspectBaseColor(document: Document): Promise<BaseColorReport>;
+export declare function describeBaseColorFindings(findings: readonly BaseColorFinding[]): string;
+/** Throws with an itemized report when any material's baseColorTexture is a normal map. */
+export declare function assertBaseColorIsAlbedo(document: Document, label?: string): Promise<BaseColorReport>;
+/** Convenience for callers that hold GLB bytes rather than a Document. */
+export declare function assertGlbBaseColorIsAlbedo(glb: Uint8Array, label?: string): Promise<BaseColorReport>;
+/**
+ * Refuse (throw) when a character-surface GLB binds a tangent-space normal map as its base colour. Shared by the
+ * real publish and `--dry-run`, so the gate that is run before paying the fee is the same one that runs at it.
+ */
+export declare function assertPublishBaseColor(opts: {
+    kind: string;
+    mesh?: string;
+}, meshBytes: Uint8Array | null | undefined): Promise<void>;

package/dist/character/baseColorGuard.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NORMAL_MAP_MAX_RG_STDEV = exports.NORMAL_MAP_MIN_BLUE_MEAN = exports.NORMAL_MAP_MEAN_TOLERANCE = void 0;
+exports.inspectBaseColor = inspectBaseColor;
+exports.describeBaseColorFindings = describeBaseColorFindings;
+exports.assertBaseColorIsAlbedo = assertBaseColorIsAlbedo;
+exports.assertGlbBaseColorIsAlbedo = assertGlbBaseColorIsAlbedo;
+exports.assertPublishBaseColor = assertPublishBaseColor;
+const core_1 = require("@gltf-transform/core");
+const extensions_1 = require("@gltf-transform/extensions");
+const node_crypto_1 = require("node:crypto");
+const bodyGeometryGuard_1 = require("./bodyGeometryGuard");
+exports.NORMAL_MAP_MEAN_TOLERANCE = 14;
+exports.NORMAL_MAP_MIN_BLUE_MEAN = 215;
+exports.NORMAL_MAP_MAX_RG_STDEV = 22;
+const sha1 = (bytes) => (0, node_crypto_1.createHash)('sha1').update(bytes).digest('hex');
+function materialLabel(material, index) {
+    return material.getName() || `material[${index}]`;
+}
+async function inspectBaseColor(document) {
+    const findings = [];
+    const unchecked = [];
+    const materials = document.getRoot().listMaterials();
+    for (let index = 0; index < materials.length; index += 1) {
+        const material = materials[index];
+        const base = material.getBaseColorTexture();
+        if (!base)
+            continue;
+        const label = materialLabel(material, index);
+        const textureName = base.getName() || '(unnamed)';
+        const baseImage = base.getImage();
+        if (baseImage) {
+            const baseHash = sha1(baseImage);
+            for (const [slot, texture] of [
+                ['normal', material.getNormalTexture()],
+                ['metallicRoughness', material.getMetallicRoughnessTexture()],
+                ['occlusion', material.getOcclusionTexture()],
+            ]) {
+                const image = texture?.getImage();
+                if (image && sha1(image) === baseHash) {
+                    findings.push({
+                        material: label,
+                        texture: textureName,
+                        reason: 'identity',
+                        detail: `baseColor image is byte-identical to this material's ${slot} image (${texture?.getName() || 'unnamed'})`,
+                    });
+                }
+            }
+        }
+        let decoded = null;
+        try {
+            decoded = await (0, bodyGeometryGuard_1.decodeMaterialBaseColor)(material);
+        }
+        catch {
+            decoded = null;
+        }
+        if (!decoded) {
+            unchecked.push(label);
+            continue;
+        }
+        const { data, width, height } = decoded;
+        const n = width * height;
+        let used = 0;
+        const mean = [0, 0, 0];
+        for (let i = 0; i < n; i += 1) {
+            if (data[i * 4 + 3] < 8)
+                continue;
+            used += 1;
+            for (let c = 0; c < 3; c += 1)
+                mean[c] += data[i * 4 + c];
+        }
+        if (used === 0)
+            continue;
+        for (let c = 0; c < 3; c += 1)
+            mean[c] /= used;
+        let sumR = 0;
+        let sumG = 0;
+        for (let i = 0; i < n; i += 1) {
+            if (data[i * 4 + 3] < 8)
+                continue;
+            sumR += (data[i * 4] - mean[0]) ** 2;
+            sumG += (data[i * 4 + 1] - mean[1]) ** 2;
+        }
+        const stdR = Math.sqrt(sumR / used);
+        const stdG = Math.sqrt(sumG / used);
+        if (Math.abs(mean[0] - 128) < exports.NORMAL_MAP_MEAN_TOLERANCE &&
+            Math.abs(mean[1] - 128) < exports.NORMAL_MAP_MEAN_TOLERANCE &&
+            mean[2] > exports.NORMAL_MAP_MIN_BLUE_MEAN &&
+            stdR < exports.NORMAL_MAP_MAX_RG_STDEV &&
+            stdG < exports.NORMAL_MAP_MAX_RG_STDEV) {
+            findings.push({
+                material: label,
+                texture: textureName,
+                reason: 'content',
+                detail: `baseColor pixels are a tangent-space normal map (mean RGB ${mean.map((v) => v.toFixed(0)).join(',')}, ` +
+                    `R/G stdev ${stdR.toFixed(1)}/${stdG.toFixed(1)}; a normal map is ~128,128,255)`,
+            });
+        }
+    }
+    return { findings, unchecked };
+}
+function describeBaseColorFindings(findings) {
+    return findings.map((f) => `  - material "${f.material}", texture "${f.texture}": ${f.reason.toUpperCase()} — ${f.detail}`).join('\n');
+}
+/** Throws with an itemized report when any material's baseColorTexture is a normal map. */
+async function assertBaseColorIsAlbedo(document, label = 'this GLB') {
+    const report = await inspectBaseColor(document);
+    if (report.findings.length === 0 || process.env.HELIX_ALLOW_NORMAL_MAP_BASE_COLOR === '1')
+        return report;
+    throw new Error(`Refusing ${label}: ${report.findings.length} material(s) use a NORMAL MAP as their base colour, so the model will ` +
+        `render as flat lavender (RGB ~128,128,255) instead of its real colours.\n` +
+        `${describeBaseColorFindings(report.findings)}\n` +
+        `This is the exporter binding the wrong image: the albedo was never baked (e.g. a procedural / layered shader ` +
+        `that Blender cannot export). Bake the diffuse colour into a texture and bind THAT as baseColor. ` +
+        `If this really is a solid periwinkle fill, set HELIX_ALLOW_NORMAL_MAP_BASE_COLOR=1 (better: use baseColorFactor).`);
+}
+/** Convenience for callers that hold GLB bytes rather than a Document. */
+async function assertGlbBaseColorIsAlbedo(glb, label) {
+    let document;
+    try {
+        document = await new core_1.NodeIO().registerExtensions(extensions_1.ALL_EXTENSIONS).readBinary(glb);
+    }
+    catch {
+        // A container this reader cannot walk is the server's call to make (same precedent as the mesh preflight):
+        // report it as unchecked, never refuse on a gap in this checker.
+        return { findings: [], unchecked: ['(glTF could not be parsed locally)'] };
+    }
+    return assertBaseColorIsAlbedo(document, label);
+}
+/** Kinds whose GLB is a worn/avatar surface, where a normal map as albedo is always wrong and always visible. */
+const BASE_COLOR_GUARDED_KINDS = new Set(['add_on', 'wearable', 'avatar']);
+/**
+ * Refuse (throw) when a character-surface GLB binds a tangent-space normal map as its base colour. Shared by the
+ * real publish and `--dry-run`, so the gate that is run before paying the fee is the same one that runs at it.
+ */
+async function assertPublishBaseColor(opts, meshBytes) {
+    if (!meshBytes || !BASE_COLOR_GUARDED_KINDS.has(opts.kind))
+        return;
+    await assertGlbBaseColorIsAlbedo(meshBytes, opts.mesh ?? 'the mesh');
+}
+//# sourceMappingURL=baseColorGuard.js.map

package/dist/character/baseColorGuard.js.map

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