@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/character/slotBudgets.generated.d.ts

@@ -0,0 +1,15 @@
+export interface CharacterAddOnBudget {
+    readonly maxTriangles: number;
+    readonly maxMaterials: number;
+    readonly maxTextureEdge: number;
+}
+export declare const SLOT_BUDGETS_SOURCE: {
+    readonly repo: "hypersonic-laboratories/helix-backend-api";
+    readonly ref: "helix3";
+    readonly commit: "08a647b3d3fec2ad12685e257a1f90589eda9a6e";
+    readonly paths: readonly ["src/universal-items/verification/asset-verification.ts", "src/config.ts"];
+};
+/** Per-slot ceilings for a NEW character add-on (the server applies them to items with no publish history). */
+export declare const CHARACTER_ADD_ON_SLOT_TIERS: Readonly<Record<string, CharacterAddOnBudget>>;
+/** The flat character add-on ceiling every untiered slot (outfit, look, …) is judged against. */
+export declare const CHARACTER_ADD_ON_FLAT_BUDGET: CharacterAddOnBudget;

package/dist/character/slotBudgets.generated.js

@@ -0,0 +1,110 @@
+"use strict";
+// GENERATED by scripts/sync-slot-budgets.mjs — do not edit by hand. Regenerate with
+//   node scripts/sync-slot-budgets.mjs
+// Source of truth: hypersonic-laboratories/helix-backend-api @ 08a647b3d3fec2ad12685e257a1f90589eda9a6e (helix3)
+//   src/universal-items/verification/asset-verification.ts  CHARACTER_ADD_ON_SLOT_TIERS  — the per-slot narrowing the server applies at publish/seal
+//   src/config.ts                               — WEARABLE_MAX_* defaults, the flat add-on ceiling it narrows
+// The server counts triangles COMBINED across every LOD scene of the GLB, and materials across the document.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHARACTER_ADD_ON_FLAT_BUDGET = exports.CHARACTER_ADD_ON_SLOT_TIERS = exports.SLOT_BUDGETS_SOURCE = void 0;
+exports.SLOT_BUDGETS_SOURCE = { "repo": "hypersonic-laboratories/helix-backend-api", "ref": "helix3", "commit": "08a647b3d3fec2ad12685e257a1f90589eda9a6e", "paths": ["src/universal-items/verification/asset-verification.ts", "src/config.ts"] };
+/** Per-slot ceilings for a NEW character add-on (the server applies them to items with no publish history). */
+exports.CHARACTER_ADD_ON_SLOT_TIERS = {
+    "character.back@1": {
+        "maxTriangles": 5000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    },
+    "character.bottom@1": {
+        "maxTriangles": 12000,
+        "maxMaterials": 3,
+        "maxTextureEdge": 1024
+    },
+    "character.brows@1": {
+        "maxTriangles": 1500,
+        "maxMaterials": 1,
+        "maxTextureEdge": 1024
+    },
+    "character.earrings@1": {
+        "maxTriangles": 2000,
+        "maxMaterials": 1,
+        "maxTextureEdge": 1024
+    },
+    "character.eyewear@1": {
+        "maxTriangles": 5000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    },
+    "character.facial_hair@1": {
+        "maxTriangles": 4000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    },
+    "character.footwear@1": {
+        "maxTriangles": 8000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    },
+    "character.gloves@1": {
+        "maxTriangles": 5000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    },
+    "character.hair@1": {
+        "maxTriangles": 15000,
+        "maxMaterials": 3,
+        "maxTextureEdge": 1024
+    },
+    "character.headwear@1": {
+        "maxTriangles": 5000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    },
+    "character.lashes@1": {
+        "maxTriangles": 1000,
+        "maxMaterials": 1,
+        "maxTextureEdge": 1024
+    },
+    "character.mask@1": {
+        "maxTriangles": 6000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    },
+    "character.nails@1": {
+        "maxTriangles": 2000,
+        "maxMaterials": 1,
+        "maxTextureEdge": 1024
+    },
+    "character.neck@1": {
+        "maxTriangles": 5000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    },
+    "character.shoulder@1": {
+        "maxTriangles": 4000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    },
+    "character.socks@1": {
+        "maxTriangles": 3000,
+        "maxMaterials": 1,
+        "maxTextureEdge": 1024
+    },
+    "character.top@1": {
+        "maxTriangles": 12000,
+        "maxMaterials": 3,
+        "maxTextureEdge": 1024
+    },
+    "character.underwear@1": {
+        "maxTriangles": 5000,
+        "maxMaterials": 2,
+        "maxTextureEdge": 1024
+    }
+};
+/** The flat character add-on ceiling every untiered slot (outfit, look, …) is judged against. */
+exports.CHARACTER_ADD_ON_FLAT_BUDGET = {
+    "maxTriangles": 20000,
+    "maxMaterials": 4,
+    "maxTextureEdge": 2048
+};
+//# sourceMappingURL=slotBudgets.generated.js.map

package/dist/character/slotBudgets.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotBudgets.generated.js","sourceRoot":"","sources":["../../src/character/slotBudgets.generated.ts"],"names":[],"mappings":";AAAA,oFAAoF;AACpF,uCAAuC;AACvC,iHAAiH;AACjH,qJAAqJ;AACrJ,8GAA8G;AAC9G,6GAA6G;;;AAQhG,QAAA,mBAAmB,GAAG,EAAC,MAAM,EAAC,2CAA2C,EAAC,KAAK,EAAC,QAAQ,EAAC,QAAQ,EAAC,0CAA0C,EAAC,OAAO,EAAC,CAAC,wDAAwD,EAAC,eAAe,CAAC,EAAU,CAAC;AAEvP,+GAA+G;AAClG,QAAA,2BAA2B,GAAmD;IACzF,kBAAkB,EAAE;QAClB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,oBAAoB,EAAE;QACpB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,mBAAmB,EAAE;QACnB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,sBAAsB,EAAE;QACtB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,qBAAqB,EAAE;QACrB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,yBAAyB,EAAE;QACzB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,sBAAsB,EAAE;QACtB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,oBAAoB,EAAE;QACpB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,kBAAkB,EAAE;QAClB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,sBAAsB,EAAE;QACtB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,oBAAoB,EAAE;QACpB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,kBAAkB,EAAE;QAClB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,mBAAmB,EAAE;QACnB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,kBAAkB,EAAE;QAClB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,sBAAsB,EAAE;QACtB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,mBAAmB,EAAE;QACnB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,iBAAiB,EAAE;QACjB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;IACD,uBAAuB,EAAE;QACvB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,CAAC;QACjB,gBAAgB,EAAE,IAAI;KACvB;CACF,CAAC;AAEF,iGAAiG;AACpF,QAAA,4BAA4B,GAAyB;IAChE,cAAc,EAAE,KAAK;IACrB,cAAc,EAAE,CAAC;IACjB,gBAAgB,EAAE,IAAI;CACvB,CAAC"}

package/dist/character/slotBudgets.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOD_BUDGET_HEADROOM = exports.DEFAULT_LOD_TRIS = exports.SLOT_BUDGETS_SOURCE = void 0;
+exports.characterAddOnBudget = characterAddOnBudget;
+exports.slotAwareLodTris = slotAwareLodTris;
+const slotBudgets_generated_1 = require("./slotBudgets.generated");
+Object.defineProperty(exports, "SLOT_BUDGETS_SOURCE", { enumerable: true, get: function () { return slotBudgets_generated_1.SLOT_BUDGETS_SOURCE; } });
+/** The generic ladder's shape: LOD1 is half of LOD0, LOD2 is 15% of it. Slot ladders keep this shape. */
+exports.DEFAULT_LOD_TRIS = [10_000, 5000, 1500];
+/**
+ * Fraction of the slot's combined triangle ceiling the ladder aims at. Decimation lands near, not exactly
+ * on, its target (meshopt stops when the next collapse would exceed the error budget), so aiming at the cap
+ * itself would fail the gate by a handful of triangles; 5% headroom absorbs that. If a result still lands
+ * over, `importCharacter` rescales the ladder and re-runs rather than shipping it.
+ */
+exports.LOD_BUDGET_HEADROOM = 0.95;
+/** The ceiling the server applies to a NEW character add-on in `slotType`. */
+function characterAddOnBudget(slotType) {
+    const tier = slotBudgets_generated_1.CHARACTER_ADD_ON_SLOT_TIERS[slotType];
+    // Math.min mirrors the server's own narrowing: a tier only ever narrows the flat ceiling.
+    const base = slotBudgets_generated_1.CHARACTER_ADD_ON_FLAT_BUDGET;
+    if (!tier)
+        return { slotType, tiered: false, ...base };
+    return {
+        slotType,
+        tiered: true,
+        maxTriangles: Math.min(base.maxTriangles, tier.maxTriangles),
+        maxMaterials: Math.min(base.maxMaterials, tier.maxMaterials),
+        maxTextureEdge: Math.min(base.maxTextureEdge, tier.maxTextureEdge),
+    };
+}
+/**
+ * Per-LOD triangle targets for `slotType`: the generic ladder's shape, scaled so the levels together land
+ * inside `LOD_BUDGET_HEADROOM` of the slot's combined ceiling — and never ABOVE the generic ladder, so an
+ * untiered slot with a looser ceiling than the generic ladder (the flat 20,000) keeps today's targets.
+ */
+function slotAwareLodTris(slotType, shape = exports.DEFAULT_LOD_TRIS) {
+    if (shape.length === 0)
+        throw new Error('slotAwareLodTris: the ladder needs at least one level');
+    const budget = characterAddOnBudget(slotType);
+    const total = shape.reduce((sum, tris) => sum + tris, 0);
+    const scale = Math.min(1, (budget.maxTriangles * exports.LOD_BUDGET_HEADROOM) / total);
+    return shape.map((tris) => Math.max(1, Math.floor(tris * scale)));
+}
+//# sourceMappingURL=slotBudgets.js.map

package/dist/character/slotBudgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotBudgets.js","sourceRoot":"","sources":["../../src/character/slotBudgets.ts"],"names":[],"mappings":";;;AAyCA,oDAYC;AAOD,4CAMC;AAlED,mEAKiC;AAgBxB,oGAlBP,2CAAmB,OAkBO;AAE5B,yGAAyG;AAC5F,QAAA,gBAAgB,GAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAExE;;;;;GAKG;AACU,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAQxC,8EAA8E;AAC9E,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,MAAM,IAAI,GAAG,mDAA2B,CAAC,QAAQ,CAAC,CAAC;IACnD,0FAA0F;IAC1F,MAAM,IAAI,GAAG,oDAA4B,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;IACvD,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC;QAC5D,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC;QAC5D,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC;KACnE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,QAAgB,EAAE,QAA2B,wBAAgB;IAC5F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,GAAG,2BAAmB,CAAC,GAAG,KAAK,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/character/stages/atlasMaterials.d.ts

@@ -0,0 +1,53 @@
+import type { Document } from '@gltf-transform/core';
+/**
+ * COLLAPSING AN IMPORTED AVATAR'S MATERIALS INTO A PUBLISHABLE FEW.
+ *
+ * A VRoid export is one material per surface: eyes, brows, lashes, eight hair instances, ears, tail, every
+ * garment piece. The reference avatar arrives with 28, each with its own base-colour texture, and every one is
+ * a distinct draw call. HELIX publishes avatars at **8 materials maximum** — the same ceiling the backend's
+ * asset verification enforces — because a runaway material count is what tanks a crowded room's frame time on
+ * the devices this platform is trying to reach.
+ *
+ * The reduction is a texture atlas, and it is the only reduction that keeps the avatar looking like itself:
+ *
+ *   1. Primitives group by the two properties a merged material CANNOT reconcile — alpha mode and sidedness.
+ *      A cutout hair card and an opaque skin patch drawn under one material would either lose the cutout or
+ *      punch holes in the skin. This avatar sorts into four such groups, which is already under the cap.
+ *   2. Each group's base-colour textures pack into one atlas, and every primitive's UVs are rescaled into its
+ *      own tile. Tiles are square and uniform because a shelf-packer that also has to solve rectangle packing
+ *      is a much larger problem for a few percent of texel efficiency.
+ *   3. UVs OUTSIDE [0,1] are the interesting case, and ignoring them is how naive atlasers ruin hair. Eight of
+ *      this avatar's primitives run to v = 1.76: the hair texture is tiled along the strand. So the source is
+ *      repeated into its tile as many times as the range needs, and the UVs are divided by that repeat —
+ *      sampling the same pixels the original did.
+ *
+ * Base colour only. Every one of this avatar's 28 materials also carries an emissive map, which for MToon is
+ * the shade colour rather than light emission, and carrying those through would double the atlas work to
+ * reproduce a lighting model this renderer does not run. The import contract already states that a converted
+ * avatar carries a single baked base-colour atlas; this stage is what finally makes that true.
+ */
+export interface AtlasOptions {
+    /** Hard ceiling on materials in the output. The publish gate's number, not a preference. */
+    readonly maxMaterials: number;
+    /** Longest edge of a generated atlas. Textures are never allowed to grow past the platform's cap. */
+    readonly maxEdge: number;
+}
+export interface AtlasResult {
+    materialsBefore: number;
+    materialsAfter: number;
+    /** One entry per generated atlas: its group key, tile grid and pixel size. */
+    atlases: Array<{
+        key: string;
+        tiles: number;
+        size: number;
+    }>;
+    /** Primitives whose UVs were divided by a repeat factor because the source tiled. */
+    tiledPrimitives: number;
+}
+/**
+ * Pack every group's textures into one atlas each and rewrite the primitives onto the merged materials.
+ *
+ * Returns without touching the document when it is already inside the cap — an avatar that does not need this
+ * should not pay a resample for it.
+ */
+export declare function atlasMaterials(document: Document, options: AtlasOptions): Promise<AtlasResult>;

package/dist/character/stages/atlasMaterials.js

@@ -0,0 +1,246 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.atlasMaterials = atlasMaterials;
+/** What a merged material cannot reconcile. Everything else is a texture difference, which an atlas absorbs. */
+function groupKey(primitive) {
+    const material = primitive.getMaterial();
+    if (material === null)
+        return 'none';
+    const mode = material.getAlphaMode();
+    return `${mode}|${material.getDoubleSided() ? 'ds' : 'ss'}`;
+}
+/** Highest UV in each axis, so a tiling source can be repeated enough to cover what the mesh samples. */
+function uvExtent(primitive) {
+    const uv = primitive.getAttribute('TEXCOORD_0');
+    if (uv === null)
+        return { u: 1, v: 1 };
+    const array = uv.getArray();
+    let maxU = 1;
+    let maxV = 1;
+    for (let i = 0; i + 1 < array.length; i += 2) {
+        maxU = Math.max(maxU, array[i]);
+        maxV = Math.max(maxV, array[i + 1]);
+    }
+    return { u: maxU, v: maxV };
+}
+async function decode(texture) {
+    const image = texture.getImage();
+    if (image === null)
+        return null;
+    const sharp = (await Promise.resolve().then(() => __importStar(require('sharp')))).default;
+    const raw = await sharp(Buffer.from(image)).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+    return { data: raw.data, width: raw.info.width, height: raw.info.height };
+}
+/**
+ * Pack every group's textures into one atlas each and rewrite the primitives onto the merged materials.
+ *
+ * Returns without touching the document when it is already inside the cap — an avatar that does not need this
+ * should not pay a resample for it.
+ */
+async function atlasMaterials(document, options) {
+    const sharp = (await Promise.resolve().then(() => __importStar(require('sharp')))).default;
+    const root = document.getRoot();
+    const before = root.listMaterials().length;
+    const result = { materialsBefore: before, materialsAfter: before, atlases: [], tiledPrimitives: 0 };
+    if (before <= options.maxMaterials)
+        return result;
+    const groups = new Map();
+    for (const mesh of root.listMeshes()) {
+        for (const primitive of mesh.listPrimitives()) {
+            const key = groupKey(primitive);
+            const list = groups.get(key) ?? [];
+            list.push(primitive);
+            groups.set(key, list);
+        }
+    }
+    if (groups.size > options.maxMaterials) {
+        throw new Error(`atlas: ${groups.size} incompatible material groups exceed the ${options.maxMaterials}-material cap; `
+            + 'alpha mode and sidedness cannot be merged away');
+    }
+    for (const [key, primitives] of groups) {
+        // One tile per distinct source texture, shared by every primitive that samples it.
+        const tileOf = new Map();
+        const untextured = [];
+        for (const primitive of primitives) {
+            const texture = primitive.getMaterial()?.getBaseColorTexture() ?? null;
+            if (texture === null) {
+                untextured.push(primitive);
+                continue;
+            }
+            if (!tileOf.has(texture))
+                tileOf.set(texture, tileOf.size);
+        }
+        const tiles = Math.max(1, tileOf.size + (untextured.length > 0 ? 1 : 0));
+        const columns = Math.ceil(Math.sqrt(tiles));
+        const rows = Math.ceil(tiles / columns);
+        // Tiles are a power of two so mip generation stays clean, as large as the cap allows — but NEVER larger
+        // than the biggest source they hold. Upscaling invents no detail and costs real bytes: a one-texture group
+        // was producing a 2048² atlas for a 512² image, quadrupling the file for nothing.
+        let sourceEdge = 16;
+        for (const texture of tileOf.keys()) {
+            const size = texture.getSize();
+            if (size !== null)
+                sourceEdge = Math.max(sourceEdge, size[0], size[1]);
+        }
+        const tileSize = Math.max(16, Math.min(2 ** Math.floor(Math.log2(options.maxEdge / Math.max(columns, rows))), 2 ** Math.ceil(Math.log2(sourceEdge))));
+        const atlasWidth = tileSize * columns;
+        const atlasHeight = tileSize * rows;
+        const canvas = Buffer.alloc(atlasWidth * atlasHeight * 4);
+        // Repeat counts are per PRIMITIVE, but a tile is per TEXTURE, so a tile repeats as much as its most
+        // demanding primitive needs. Anything sampling it less simply sees a smaller slice of the same pixels.
+        const repeatOf = new Map();
+        for (const primitive of primitives) {
+            const texture = primitive.getMaterial()?.getBaseColorTexture() ?? null;
+            const tile = texture === null ? tileOf.size : tileOf.get(texture);
+            const extent = uvExtent(primitive);
+            const current = repeatOf.get(tile) ?? { u: 1, v: 1 };
+            repeatOf.set(tile, {
+                u: Math.max(current.u, Math.ceil(extent.u - 1e-4)),
+                v: Math.max(current.v, Math.ceil(extent.v - 1e-4)),
+            });
+        }
+        for (const [texture, tile] of tileOf) {
+            const decoded = await decode(texture);
+            if (decoded === null)
+                continue;
+            const repeat = repeatOf.get(tile) ?? { u: 1, v: 1 };
+            // The source is squeezed to 1/repeat of the tile and then stamped repeat times, so a mesh that walked
+            // off the edge of the original texture walks onto the same pixels again inside its tile.
+            const cellW = Math.max(1, Math.floor(tileSize / repeat.u));
+            const cellH = Math.max(1, Math.floor(tileSize / repeat.v));
+            const cell = await sharp(decoded.data, {
+                raw: { width: decoded.width, height: decoded.height, channels: 4 },
+            }).resize(cellW, cellH, { fit: 'fill' }).raw().toBuffer();
+            const originX = (tile % columns) * tileSize;
+            const originY = Math.floor(tile / columns) * tileSize;
+            for (let ry = 0; ry < repeat.v; ry++) {
+                for (let rx = 0; rx < repeat.u; rx++) {
+                    for (let y = 0; y < cellH; y++) {
+                        const destY = originY + ry * cellH + y;
+                        if (destY >= atlasHeight)
+                            break;
+                        for (let x = 0; x < cellW; x++) {
+                            const destX = originX + rx * cellW + x;
+                            if (destX >= atlasWidth)
+                                break;
+                            const from = (y * cellW + x) * 4;
+                            const to = (destY * atlasWidth + destX) * 4;
+                            canvas[to] = cell[from];
+                            canvas[to + 1] = cell[from + 1];
+                            canvas[to + 2] = cell[from + 2];
+                            canvas[to + 3] = cell[from + 3];
+                        }
+                    }
+                }
+            }
+        }
+        // An untextured primitive gets a tile of its own material's flat base colour, so merging never tints it.
+        if (untextured.length > 0) {
+            const tile = tileOf.size;
+            const factor = untextured[0].getMaterial()?.getBaseColorFactor() ?? [1, 1, 1, 1];
+            const originX = (tile % columns) * tileSize;
+            const originY = Math.floor(tile / columns) * tileSize;
+            for (let y = 0; y < tileSize; y++) {
+                for (let x = 0; x < tileSize; x++) {
+                    const to = ((originY + y) * atlasWidth + originX + x) * 4;
+                    canvas[to] = Math.round(factor[0] * 255);
+                    canvas[to + 1] = Math.round(factor[1] * 255);
+                    canvas[to + 2] = Math.round(factor[2] * 255);
+                    canvas[to + 3] = Math.round(factor[3] * 255);
+                }
+            }
+        }
+        const png = await sharp(canvas, { raw: { width: atlasWidth, height: atlasHeight, channels: 4 } })
+            .png().toBuffer();
+        const atlasTexture = document.createTexture(`atlas_${key.replace(/\|/g, '_')}`)
+            .setImage(new Uint8Array(png))
+            .setMimeType('image/png');
+        const sample = primitives[0].getMaterial();
+        const merged = document.createMaterial(`atlas_${key.replace(/\|/g, '_')}`)
+            .setBaseColorTexture(atlasTexture)
+            .setBaseColorFactor([1, 1, 1, 1])
+            .setRoughnessFactor(sample?.getRoughnessFactor() ?? 1)
+            .setMetallicFactor(sample?.getMetallicFactor() ?? 0)
+            .setAlphaMode(sample?.getAlphaMode() ?? 'OPAQUE')
+            .setDoubleSided(sample?.getDoubleSided() ?? false);
+        if (merged.getAlphaMode() === 'MASK') {
+            // The LOWEST cutoff in the group: raising a primitive's cutoff erodes its silhouette, and eroded hair is
+            // the artefact this whole avatar has already been through once.
+            let cutoff = 1;
+            for (const primitive of primitives)
+                cutoff = Math.min(cutoff, primitive.getMaterial()?.getAlphaCutoff() ?? 0.5);
+            merged.setAlphaCutoff(cutoff);
+        }
+        for (const primitive of primitives) {
+            const texture = primitive.getMaterial()?.getBaseColorTexture() ?? null;
+            const tile = texture === null ? tileOf.size : tileOf.get(texture);
+            const repeat = repeatOf.get(tile) ?? { u: 1, v: 1 };
+            if (repeat.u > 1 || repeat.v > 1)
+                result.tiledPrimitives++;
+            const originU = (tile % columns) / columns;
+            const originV = Math.floor(tile / columns) / rows;
+            const uv = primitive.getAttribute('TEXCOORD_0');
+            if (uv !== null) {
+                const source = uv.getArray();
+                const mapped = new Float32Array(source.length);
+                for (let i = 0; i + 1 < source.length; i += 2) {
+                    mapped[i] = originU + (source[i] / repeat.u) / columns;
+                    mapped[i + 1] = originV + (source[i + 1] / repeat.v) / rows;
+                }
+                // A fresh accessor rather than an in-place write: VRoid shares one UV accessor across primitives that
+                // now land in DIFFERENT tiles, and rewriting it would move every one of them to the last tile written.
+                // The same shared-accessor trap that corrupted this avatar's skin indices once already.
+                primitive.setAttribute('TEXCOORD_0', document.createAccessor()
+                    .setType('VEC2')
+                    .setArray(mapped)
+                    .setBuffer(root.listBuffers()[0] ?? document.createBuffer()));
+            }
+            primitive.setMaterial(merged);
+        }
+        result.atlases.push({ key, tiles, size: Math.max(atlasWidth, atlasHeight) });
+    }
+    for (const material of root.listMaterials()) {
+        if (!material.getName().startsWith('atlas_'))
+            material.dispose();
+    }
+    for (const texture of root.listTextures()) {
+        if (!texture.getName().startsWith('atlas_'))
+            texture.dispose();
+    }
+    result.materialsAfter = root.listMaterials().length;
+    return result;
+}
+//# sourceMappingURL=atlasMaterials.js.map

package/dist/character/stages/atlasMaterials.js.map

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

package/dist/character/stages/bakeTexture.d.ts

@@ -7,14 +7,35 @@ export interface BakeResult {
     dilated: number;
     /** Sampled texels whose closest source point was suspiciously far (> 2% of the bbox diagonal). */
     far: number;
+    /** Which atlases were baked; each target material binds only the slots its source material had. */
+    slots: BakedSlot[];
 }
+export type BakedSlot = 'baseColor' | 'emissive' | 'orm' | 'normal';
 /**
- * Re-bakes the SOURCE document's base-color texture onto the (decimated, freshly unwrapped) target
+ * Re-bakes the SOURCE document's material textures onto the (decimated, freshly unwrapped) target
  * document. For every texel of every target triangle: barycentric -> 3D point -> closest point on the
- * SOURCE mesh (BVH) -> source UV -> bilinear sample of the source texture. Layered surfaces (hair shell
- * over scalp) are disambiguated by preferring source triangles whose facing agrees with the target
- * triangle when their distances are comparable. Unwritten texels are dilated outward into gutters so
- * bilinear/mip filtering never bleeds background into charts. Base color only — imports carry a single
- * baked atlas by contract (the conform pipeline drops other maps).
+ * SOURCE triangles of the SAME material (BVH per material) -> that material's own UVs -> bilinear
+ * sample of that material's own textures.
+ *
+ * Up to four atlases share the new layout: base colour (sRGB), an emissive map (sRGB, only when a source
+ * material has a genuine one), a packed ORM (R = occlusion, G/B = metallic-roughness, linear), and a
+ * tangent-space normal map. Normals are transferred through object
+ * space: decoded in the source triangle's UV-derived tangent frame and re-encoded in the target
+ * triangle's, so detail survives the new UV layout. Each target material binds only the slots its
+ * source material had; every other texture binding is cleared, because the old images no longer match
+ * the new UVs.
+ *
+ * EMISSIVE: an emissiveFactor must never outlive its map. A genuine (non-black) emissive map is rebaked with its
+ * factor multiplied in and the target factor becomes [1,1,1]; a black map (Meshy ships one beside factor [1,1,1])
+ * or a zero factor contributes nothing, so the texture is dropped and the factor zeroed. Clearing the map and
+ * keeping the factor rendered the whole avatar flat white.
+ *
+ * Layered surfaces (hair shell over scalp) are disambiguated by preferring source triangles whose
+ * facing agrees with the target triangle when their distances are comparable. Unwritten texels are
+ * dilated outward into gutters so bilinear/mip filtering never bleeds background into charts.
  */
-export declare function bakeBaseColor(target: Document, source: Document, outSize: number): Promise<BakeResult>;
+export declare function bakeMaterials(target: Document, source: Document, outSize: number): Promise<BakeResult>;
+/** @deprecated Kept for callers of the original base-colour-only bake; bakes every material slot. */
+export declare const bakeBaseColor: typeof bakeMaterials;
+/** True only when the rebake stage has actual embedded pixels to sample. */
+export declare function hasBakeableBaseColorTexture(document: Document): boolean;