@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/character/addonPushOut.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushGarmentOutOfBody = pushGarmentOutOfBody;
+const mat4_1 = require("./mat4");
+/** Cell size for the uniform grid that buckets host triangles for approximate-nearest lookup. */
+function gridKey(p, cell) {
+    return `${Math.floor(p[0] / cell)},${Math.floor(p[1] / cell)},${Math.floor(p[2] / cell)}`;
+}
+function collectHostTriangles(hostBody) {
+    const triangles = [];
+    for (const mesh of hostBody.getRoot().listMeshes()) {
+        for (const prim of mesh.listPrimitives()) {
+            const pos = prim.getAttribute('POSITION');
+            const indices = prim.getIndices();
+            if (!pos)
+                continue;
+            const posArray = pos.getArray();
+            if (!posArray)
+                continue;
+            const vertexAt = (i) => [posArray[i * 3], posArray[i * 3 + 1], posArray[i * 3 + 2]];
+            const idxArray = indices?.getArray();
+            const triCount = idxArray ? idxArray.length / 3 : pos.getCount() / 3;
+            for (let t = 0; t < triCount; t++) {
+                const [ia, ib, ic] = idxArray
+                    ? [idxArray[t * 3], idxArray[t * 3 + 1], idxArray[t * 3 + 2]]
+                    : [t * 3, t * 3 + 1, t * 3 + 2];
+                const a = vertexAt(ia);
+                const b = vertexAt(ib);
+                const c = vertexAt(ic);
+                const normal = (0, mat4_1.normalize3)((0, mat4_1.cross3)((0, mat4_1.sub3)(b, a), (0, mat4_1.sub3)(c, a)));
+                if (!Number.isFinite(normal[0]))
+                    continue; // degenerate triangle
+                const centroid = [(a[0] + b[0] + c[0]) / 3, (a[1] + b[1] + c[1]) / 3, (a[2] + b[2] + c[2]) / 3];
+                triangles.push({ a, b, c, normal, centroid });
+            }
+        }
+    }
+    // A cell of ~5cm keeps the neighbour search (27 cells) small on a canonical-scale humanoid body while
+    // still bucketing enough triangles per cell to be worth indexing.
+    const cell = 0.05;
+    return { triangles, cell };
+}
+/**
+ * Buckets every triangle into EVERY cell its axis-aligned bounding box overlaps, not just its centroid's
+ * cell. A character-scale body/garment mesh at platform LOD triangle counts has edge lengths far under one
+ * grid cell, so this is normally one cell per triangle in practice — but bucketing by centroid alone is
+ * silently wrong for any triangle bigger than the cell (its centroid's neighbourhood search would never
+ * see it even though its surface passes right by the query point), and getting that wrong produces a
+ * push-out step that quietly does nothing rather than a visible error. The `+ 1` cap on cells-per-axis
+ * guards the pathological case (a huge single triangle) from indexing an unbounded number of cells.
+ */
+function indexTriangles(triangles, cell) {
+    const grid = new Map();
+    const MAX_CELLS_PER_AXIS = 64;
+    for (const tri of triangles) {
+        const min = [
+            Math.min(tri.a[0], tri.b[0], tri.c[0]),
+            Math.min(tri.a[1], tri.b[1], tri.c[1]),
+            Math.min(tri.a[2], tri.b[2], tri.c[2]),
+        ];
+        const max = [
+            Math.max(tri.a[0], tri.b[0], tri.c[0]),
+            Math.max(tri.a[1], tri.b[1], tri.c[1]),
+            Math.max(tri.a[2], tri.b[2], tri.c[2]),
+        ];
+        const cellMin = min.map((v) => Math.floor(v / cell));
+        const cellMax = max.map((v) => Math.floor(v / cell));
+        const span = (i) => Math.min(cellMax[i] - cellMin[i], MAX_CELLS_PER_AXIS);
+        for (let x = 0; x <= span(0); x++) {
+            for (let y = 0; y <= span(1); y++) {
+                for (let z = 0; z <= span(2); z++) {
+                    const key = `${cellMin[0] + x},${cellMin[1] + y},${cellMin[2] + z}`;
+                    const bucket = grid.get(key);
+                    if (bucket)
+                        bucket.push(tri);
+                    else
+                        grid.set(key, [tri]);
+                }
+            }
+        }
+    }
+    return grid;
+}
+/** Closest point on triangle `tri` to `p`, via the standard barycentric clamp (Ericson, RTCD 5.1.5). */
+function closestPointOnTriangle(p, tri) {
+    const { a, b, c } = tri;
+    const ab = (0, mat4_1.sub3)(b, a);
+    const ac = (0, mat4_1.sub3)(c, a);
+    const ap = (0, mat4_1.sub3)(p, a);
+    const d1 = (0, mat4_1.dot3)(ab, ap);
+    const d2 = (0, mat4_1.dot3)(ac, ap);
+    if (d1 <= 0 && d2 <= 0)
+        return a;
+    const bp = (0, mat4_1.sub3)(p, b);
+    const d3 = (0, mat4_1.dot3)(ab, bp);
+    const d4 = (0, mat4_1.dot3)(ac, bp);
+    if (d3 >= 0 && d4 <= d3)
+        return b;
+    const vc = d1 * d4 - d3 * d2;
+    if (vc <= 0 && d1 >= 0 && d3 <= 0) {
+        const v = d1 / (d1 - d3);
+        return [a[0] + v * ab[0], a[1] + v * ab[1], a[2] + v * ab[2]];
+    }
+    const cp = (0, mat4_1.sub3)(p, c);
+    const d5 = (0, mat4_1.dot3)(ab, cp);
+    const d6 = (0, mat4_1.dot3)(ac, cp);
+    if (d6 >= 0 && d5 <= d6)
+        return c;
+    const vb = d5 * d2 - d1 * d6;
+    if (vb <= 0 && d2 >= 0 && d6 <= 0) {
+        const w = d2 / (d2 - d6);
+        return [a[0] + w * ac[0], a[1] + w * ac[1], a[2] + w * ac[2]];
+    }
+    const va = d3 * d6 - d5 * d4;
+    if (va <= 0 && d4 - d3 >= 0 && d5 - d6 >= 0) {
+        const w = (d4 - d3) / (d4 - d3 + (d5 - d6));
+        return [b[0] + w * (c[0] - b[0]), b[1] + w * (c[1] - b[1]), b[2] + w * (c[2] - b[2])];
+    }
+    const denom = 1 / (va + vb + vc);
+    const v = vb * denom;
+    const w = vc * denom;
+    return [a[0] + ab[0] * v + ac[0] * w, a[1] + ab[1] * v + ac[1] * w, a[2] + ab[2] * v + ac[2] * w];
+}
+function nearestSurfacePoint(p, grid, cell) {
+    const [cx, cy, cz] = [Math.floor(p[0] / cell), Math.floor(p[1] / cell), Math.floor(p[2] / cell)];
+    let best = null;
+    // Search the 3x3x3 neighbourhood first; if nothing is found (a sparse region, or the garment vertex sits
+    // further than one cell from any body geometry), widen the ring until a triangle is found or we give up.
+    for (let radius = 1; radius <= 4 && best === null; radius++) {
+        for (let dx = -radius; dx <= radius; dx++) {
+            for (let dy = -radius; dy <= radius; dy++) {
+                for (let dz = -radius; dz <= radius; dz++) {
+                    const bucket = grid.get(`${cx + dx},${cy + dy},${cz + dz}`);
+                    if (!bucket)
+                        continue;
+                    for (const tri of bucket) {
+                        const cp = closestPointOnTriangle(p, tri);
+                        const d = Math.hypot(p[0] - cp[0], p[1] - cp[1], p[2] - cp[2]);
+                        if (best === null || d < best.distance)
+                            best = { point: cp, normal: tri.normal, distance: d };
+                    }
+                }
+            }
+        }
+    }
+    return best;
+}
+/**
+ * Push garment vertices out of the host body surface where they are closer than `thresholdMeters`. Mutates
+ * `garment`'s POSITION accessors in place (NORMAL is left untouched — the push distances are small enough
+ * that re-lighting is not worth the extra pass, and a shading seam from a hairline offset is not visible at
+ * platform LOD triangle counts).
+ */
+function pushGarmentOutOfBody(garment, hostBody, options = {}) {
+    const threshold = options.thresholdMeters ?? 0.004;
+    const offset = options.offsetMeters ?? 0.002;
+    const maxPushOut = options.maxPushOutMeters ?? 0.015;
+    if (offset > threshold) {
+        throw new Error(`addonPushOut: offsetMeters (${offset}) must not exceed thresholdMeters (${threshold}) — otherwise every push-out would immediately re-trigger the risk test.`);
+    }
+    const { triangles, cell } = collectHostTriangles(hostBody);
+    const report = {
+        verticesExamined: 0,
+        verticesAtRisk: 0,
+        verticesPushed: 0,
+        verticesClamped: 0,
+        maxCorrectionMeters: 0,
+    };
+    if (triangles.length === 0)
+        return report; // nothing to push away from — leave the garment untouched.
+    const grid = indexTriangles(triangles, cell);
+    for (const mesh of garment.getRoot().listMeshes()) {
+        for (const prim of mesh.listPrimitives()) {
+            const pos = prim.getAttribute('POSITION');
+            if (!pos)
+                continue;
+            const array = pos.getArray();
+            if (!array)
+                continue;
+            const mutable = Float32Array.from(array);
+            const count = pos.getCount();
+            for (let i = 0; i < count; i++) {
+                report.verticesExamined++;
+                const v = [mutable[i * 3], mutable[i * 3 + 1], mutable[i * 3 + 2]];
+                const nearest = nearestSurfacePoint(v, grid, cell);
+                if (!nearest)
+                    continue;
+                // Signed distance along the BODY's own outward normal: positive means the garment vertex is
+                // already outside the body along that normal, negative means it has sunk past the surface.
+                const signedDistance = (0, mat4_1.dot3)((0, mat4_1.sub3)(v, nearest.point), nearest.normal);
+                if (signedDistance >= threshold)
+                    continue; // already clear — leave it exactly where conform put it.
+                report.verticesAtRisk++;
+                const rawPush = offset - signedDistance;
+                const push = Math.min(rawPush, maxPushOut);
+                if (push < rawPush)
+                    report.verticesClamped++;
+                if (push <= 0)
+                    continue;
+                mutable[i * 3] = v[0] + nearest.normal[0] * push;
+                mutable[i * 3 + 1] = v[1] + nearest.normal[1] * push;
+                mutable[i * 3 + 2] = v[2] + nearest.normal[2] * push;
+                report.verticesPushed++;
+                report.maxCorrectionMeters = Math.max(report.maxCorrectionMeters, push);
+            }
+            pos.setArray(mutable);
+        }
+    }
+    return report;
+}
+//# sourceMappingURL=addonPushOut.js.map

package/dist/character/addonPushOut.js.map

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

package/dist/character/avatarPreflight.d.ts

@@ -0,0 +1,92 @@
+import { type GlbSummary } from "../glb";
+/**
+ * WHAT THE PLATFORM WILL SAY ABOUT THIS AVATAR, SAID HERE INSTEAD.
+ *
+ * Package publication uploads the GLB byte-for-byte and the backend verifies it on arrival. That is the correct
+ * division of labour — the server must never trust a client's word about the file — but it means every
+ * rejection costs an upload, and the creator learns their character is a material over the cap after the round
+ * trip rather than before it. The failures are all statically checkable from the file, so this checks them.
+ *
+ * The numbers are the BACKEND's own defaults (`AVATAR_MAX_*` in its config), duplicated deliberately and
+ * labelled as such: a client-side preflight that guesses looser limits than the server is worse than no
+ * preflight, because it produces confident green output for a file that will be refused. When the server's
+ * numbers move, these move with them — and being wrong here costs a round trip, exactly what it costs today.
+ *
+ * The manifest checks are the other half, and they have no server counterpart at all. A character can pass
+ * every numeric limit and still arrive with no physics, no face and no first-person head declaration, which is
+ * a silently diminished avatar rather than a rejected one — the worst failure mode this pipeline has, and the
+ * one it has already shipped twice.
+ */
+/** The backend's `AVATAR_MAX_*` defaults. Mirrored, not derived: this process cannot see that config. */
+export declare const AVATAR_LIMITS: {
+    readonly maxTriangles: 60000;
+    readonly maxTextureEdge: 2048;
+    readonly maxFileBytes: number;
+    readonly maxMaterials: 8;
+};
+/** The wearable ceilings, roughly a third of an avatar's, because several are worn at once. */
+export declare const WEARABLE_LIMITS: {
+    readonly maxTriangles: 20000;
+    readonly maxTextureEdge: 2048;
+    readonly maxFileBytes: number;
+    readonly maxMaterials: 4;
+};
+/** The backend's `VEHICLE_MAX_*` defaults. A vehicle is not furniture and is not judged as such. */
+export declare const VEHICLE_LIMITS: {
+    readonly maxTriangles: 90000;
+    readonly maxTextureEdge: 2048;
+    readonly maxFileBytes: number;
+    readonly maxMaterials: 48;
+};
+/** The backend's `WEAPON_MAX_*` defaults. Held at arm's length in first person; not furniture either. */
+export declare const WEAPON_LIMITS: {
+    readonly maxTriangles: 30000;
+    readonly maxTextureEdge: 2048;
+    readonly maxFileBytes: number;
+    readonly maxMaterials: 12;
+};
+/** The backend's `HOME_ITEM_MAX_*` defaults. */
+export declare const HOME_ITEM_LIMITS: {
+    readonly maxTriangles: 15000;
+    readonly maxTextureEdge: 2048;
+    readonly maxFileBytes: number;
+    readonly maxMaterials: 6;
+};
+/** Kinds this preflight can judge. A kind absent here is left entirely to the server. */
+export type PreflightKind = 'avatar' | 'wearable' | 'add_on' | 'home_item' | 'vehicle' | 'weapon';
+/**
+ * THE DRAW-CALL WALL, PER KIND — the backend's `*_MAX_DRAW_CALLS` defaults.
+ *
+ * A draw call is one glTF mesh primitive, counted once per node that places it.
+ * It is NOT the material count, which is only a lower bound: the published
+ * reference vehicle bound 43 materials across 188 primitives and so cleared a
+ * 48-material ceiling by 11 while submitting 188 batches.
+ *
+ * Design targets, which this does not enforce but the report prints, are half
+ * of each: character 6, wearable 2, add-on 4, item 8, vehicle 12, weapon 4.
+ */
+export declare const DRAW_CALL_LIMITS: Record<PreflightKind, number>;
+export type PreflightSeverity = 'error' | 'warning';
+export interface PreflightFinding {
+    severity: PreflightSeverity;
+    /** Stable code so a caller can filter without matching prose. */
+    code: string;
+    message: string;
+}
+export interface AvatarPreflightResult {
+    ok: boolean;
+    findings: PreflightFinding[];
+    summary: GlbSummary;
+    /** What the character declares beyond geometry, for the report. */
+    manifests: {
+        dynamics: number | null;
+        faceChannels: number | null;
+        firstPersonHide: number | null;
+    };
+}
+export declare function preflightAvatar(buffer: Buffer, kind?: PreflightKind, 
+/** A NEW character add-on's slot type: narrows the add-on ceiling to that slot's server-side tier
+ *  (`slotBudgets.ts`, generated from the backend's own table). */
+characterSlotType?: string): AvatarPreflightResult;
+/** One line per finding, plus the capability line, for the CLI's own output. */
+export declare function formatPreflight(result: AvatarPreflightResult): string;

package/dist/character/avatarPreflight.js

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DRAW_CALL_LIMITS = exports.HOME_ITEM_LIMITS = exports.WEAPON_LIMITS = exports.VEHICLE_LIMITS = exports.WEARABLE_LIMITS = exports.AVATAR_LIMITS = void 0;
+exports.preflightAvatar = preflightAvatar;
+exports.formatPreflight = formatPreflight;
+const glb_1 = require("../glb");
+const slotBudgets_1 = require("./slotBudgets");
+/**
+ * WHAT THE PLATFORM WILL SAY ABOUT THIS AVATAR, SAID HERE INSTEAD.
+ *
+ * Package publication uploads the GLB byte-for-byte and the backend verifies it on arrival. That is the correct
+ * division of labour — the server must never trust a client's word about the file — but it means every
+ * rejection costs an upload, and the creator learns their character is a material over the cap after the round
+ * trip rather than before it. The failures are all statically checkable from the file, so this checks them.
+ *
+ * The numbers are the BACKEND's own defaults (`AVATAR_MAX_*` in its config), duplicated deliberately and
+ * labelled as such: a client-side preflight that guesses looser limits than the server is worse than no
+ * preflight, because it produces confident green output for a file that will be refused. When the server's
+ * numbers move, these move with them — and being wrong here costs a round trip, exactly what it costs today.
+ *
+ * The manifest checks are the other half, and they have no server counterpart at all. A character can pass
+ * every numeric limit and still arrive with no physics, no face and no first-person head declaration, which is
+ * a silently diminished avatar rather than a rejected one — the worst failure mode this pipeline has, and the
+ * one it has already shipped twice.
+ */
+/** The backend's `AVATAR_MAX_*` defaults. Mirrored, not derived: this process cannot see that config. */
+exports.AVATAR_LIMITS = {
+    maxTriangles: 60_000,
+    maxTextureEdge: 2048,
+    maxFileBytes: 10 * 1024 * 1024,
+    maxMaterials: 8,
+};
+/** The wearable ceilings, roughly a third of an avatar's, because several are worn at once. */
+exports.WEARABLE_LIMITS = {
+    maxTriangles: 20_000,
+    maxTextureEdge: 2048,
+    maxFileBytes: 6 * 1024 * 1024,
+    maxMaterials: 4,
+};
+/** The backend's `VEHICLE_MAX_*` defaults. A vehicle is not furniture and is not judged as such. */
+exports.VEHICLE_LIMITS = {
+    maxTriangles: 90_000,
+    maxTextureEdge: 2048,
+    maxFileBytes: 16 * 1024 * 1024,
+    maxMaterials: 48,
+};
+/** The backend's `WEAPON_MAX_*` defaults. Held at arm's length in first person; not furniture either. */
+exports.WEAPON_LIMITS = {
+    maxTriangles: 30_000,
+    maxTextureEdge: 2048,
+    maxFileBytes: 8 * 1024 * 1024,
+    maxMaterials: 12,
+};
+/** The backend's `HOME_ITEM_MAX_*` defaults. */
+exports.HOME_ITEM_LIMITS = {
+    maxTriangles: 15_000,
+    maxTextureEdge: 2048,
+    maxFileBytes: 8 * 1024 * 1024,
+    maxMaterials: 6,
+};
+const LIMITS_BY_KIND = {
+    avatar: exports.AVATAR_LIMITS,
+    wearable: exports.WEARABLE_LIMITS,
+    // An add-on is judged against the wearable ceilings server-side: several are
+    // mounted at once onto a host already paying its own budget.
+    add_on: exports.WEARABLE_LIMITS,
+    home_item: exports.HOME_ITEM_LIMITS,
+    vehicle: exports.VEHICLE_LIMITS,
+    weapon: exports.WEAPON_LIMITS,
+};
+/**
+ * THE DRAW-CALL WALL, PER KIND — the backend's `*_MAX_DRAW_CALLS` defaults.
+ *
+ * A draw call is one glTF mesh primitive, counted once per node that places it.
+ * It is NOT the material count, which is only a lower bound: the published
+ * reference vehicle bound 43 materials across 188 primitives and so cleared a
+ * 48-material ceiling by 11 while submitting 188 batches.
+ *
+ * Design targets, which this does not enforce but the report prints, are half
+ * of each: character 6, wearable 2, add-on 4, item 8, vehicle 12, weapon 4.
+ */
+exports.DRAW_CALL_LIMITS = {
+    avatar: 12,
+    wearable: 4,
+    add_on: 8,
+    home_item: 16,
+    vehicle: 24,
+    weapon: 8,
+};
+/**
+ * Core joints the runtime needs to embed a body at all.
+ *
+ * Deliberately the SHORT list — the handful whose absence means the avatar cannot be driven — rather than all
+ * 68. A preflight that reimplements the server's full skeleton check will drift from it; this one catches the
+ * case where the file is not a HELIX character at all.
+ */
+const REQUIRED_JOINTS = ['root', 'pelvis', 'spine_01', 'head', 'hand_l', 'hand_r', 'foot_l', 'foot_r'];
+/**
+ * Read the scene extras straight out of the GLB's JSON chunk.
+ *
+ * Parsed here rather than through `@gltf-transform` because a preflight must not fail on a file the reader
+ * cannot fully load: an unknown extension, a Draco stream without its decoder, a KTX2 texture. The one thing
+ * this needs is the JSON chunk, and every valid GLB has one.
+ */
+function readSceneExtras(buffer) {
+    if (buffer.byteLength < 20)
+        return {};
+    const jsonLength = buffer.readUInt32LE(12);
+    if (jsonLength <= 0 || 20 + jsonLength > buffer.byteLength)
+        return {};
+    try {
+        const json = JSON.parse(buffer.subarray(20, 20 + jsonLength).toString('utf8'));
+        return json.scenes?.[0]?.extras ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Check a character GLB against the publish gate without touching the network.
+ *
+ * `kind` picks the ceiling set: an avatar and a wearable are the same file format with different budgets,
+ * because several wearables are worn on top of one avatar.
+ */
+/**
+ * Which parts must stay separate primitives, per kind.
+ *
+ * "Merge your meshes" is correct advice right up until it destroys the thing
+ * that made the item interactive. The runtime resolves articulated parts BY
+ * NODE NAME — `getObjectByName` for a vehicle's articulators and lamps, socket
+ * source names for its wheels — so joining them does not just merge geometry,
+ * it deletes the handle the runtime steers by. Naming the specific parts per
+ * kind is the difference between advice a creator can follow safely and advice
+ * that breaks their car the first time someone opens a door.
+ */
+const ARTICULATED_PARTS = {
+    avatar: 'the head, hands and anything a face or IK target drives',
+    wearable: 'anything a bone or blendshape drives',
+    add_on: 'anything mounted on a socket or driven by the host',
+    home_item: 'lids, drawers, doors and anything an interaction opens',
+    vehicle: 'wheels, doors, hood, boot, steering wheel and lamps',
+    weapon: 'the magazine, bolt, trigger and optic',
+};
+/**
+ * The local rejection text — the same facts the server will state, minus the round trip.
+ *
+ * It has to carry more than "too many draw calls" because the creator cannot see draw calls in any tool they
+ * own. So: what the number is, what a draw call IS, which materials are responsible by name, how much of the
+ * overage is free to fix, and which of the two fixes each part needs. The split matters — telling someone to
+ * atlas textures when their problem is unmerged geometry sends them down a much harder road than they need.
+ */
+function describeDrawCallOverage(breakdown, limit, kind) {
+    const lines = [
+        `${breakdown.drawCalls.toLocaleString()} draw calls exceeds the ${limit} ${kind.replace('_', ' ')} cap `
+            + '(one draw call = one glTF mesh primitive, counted once per node that places it — not one per material, '
+            + 'and not one per object in your DCC)',
+    ];
+    if (breakdown.offenders.length > 0) {
+        lines.push('  heaviest materials: '
+            + breakdown.offenders.map((o) => `${o.material} x${o.drawCalls}`).join(', '));
+    }
+    if (breakdown.mergeable > 0) {
+        lines.push(`  ${breakdown.mergeable.toLocaleString()} of these are FREE to remove: the geometry binds only `
+            + `${breakdown.boundMaterials} distinct material(s), so parts sharing one can be joined into a single `
+            + 'primitive with no visual change (Blender: select them, Ctrl+J, then Merge by Distance). Do NOT join '
+            + `parts the runtime moves separately — ${ARTICULATED_PARTS[kind]} — they are resolved by node name.`);
+    }
+    if (breakdown.boundMaterials > limit) {
+        lines.push(`  merging alone cannot reach the cap: ${breakdown.boundMaterials} distinct materials is a floor of `
+            + `${breakdown.boundMaterials} draws. Atlas the set down to ${limit} or fewer first.`);
+    }
+    lines.push('  if this item is already published, the server allows a grace window for updates — pass --allow-oversize '
+        + 'to send it and let the server decide.');
+    return lines.join('\n');
+}
+function preflightAvatar(buffer, kind = 'avatar', 
+/** A NEW character add-on's slot type: narrows the add-on ceiling to that slot's server-side tier
+ *  (`slotBudgets.ts`, generated from the backend's own table). */
+characterSlotType) {
+    const base = LIMITS_BY_KIND[kind] ?? exports.HOME_ITEM_LIMITS;
+    const tier = kind === 'add_on' && characterSlotType ? (0, slotBudgets_1.characterAddOnBudget)(characterSlotType) : null;
+    const limits = tier === null ? base : {
+        ...base,
+        maxTriangles: Math.min(base.maxTriangles, tier.maxTriangles),
+        maxMaterials: Math.min(base.maxMaterials, tier.maxMaterials),
+        maxTextureEdge: Math.min(base.maxTextureEdge, tier.maxTextureEdge),
+    };
+    const summary = (0, glb_1.summarizeGlb)(buffer);
+    const extras = readSceneExtras(buffer);
+    const findings = [];
+    const fail = (code, message) => { findings.push({ severity: 'error', code, message }); };
+    const warn = (code, message) => { findings.push({ severity: 'warning', code, message }); };
+    if (summary.triangleCount > limits.maxTriangles) {
+        fail('triangles', `${summary.triangleCount.toLocaleString()} triangles exceeds the ${limits.maxTriangles.toLocaleString()} ${kind} cap`);
+    }
+    if (summary.materialCount > limits.maxMaterials) {
+        fail('materials', `${summary.materialCount} materials exceeds the ${limits.maxMaterials}-material ${kind} cap — `
+            + 'atlas them at import (this is the limit a converted VRM fails first, and by the widest margin)');
+    }
+    if (summary.maxTextureEdge > limits.maxTextureEdge) {
+        fail('texture-edge', `largest texture edge ${summary.maxTextureEdge}px exceeds the ${limits.maxTextureEdge}px cap`);
+    }
+    const drawCalls = (0, glb_1.measureDrawCalls)(buffer);
+    const drawCallLimit = exports.DRAW_CALL_LIMITS[kind] ?? exports.DRAW_CALL_LIMITS.home_item;
+    if (!drawCalls.unreadable && drawCalls.drawCalls > drawCallLimit) {
+        fail('draw-calls', describeDrawCallOverage(drawCalls, drawCallLimit, kind));
+    }
+    if (summary.sizeBytes > limits.maxFileBytes) {
+        const mb = (n) => `${(n / 1024 / 1024).toFixed(1)} MB`;
+        fail('file-size', `${mb(summary.sizeBytes)} exceeds the ${mb(limits.maxFileBytes)} ${kind} cap`);
+    }
+    if (kind === 'avatar') {
+        if (summary.skinCount === 0) {
+            fail('no-skin', 'an avatar must carry a skinned mesh; this file has none');
+        }
+        const joints = new Set(summary.boneNames);
+        const missing = REQUIRED_JOINTS.filter((joint) => !joints.has(joint));
+        if (missing.length > 0) {
+            fail('skeleton', `missing core helix-humanoid joints: ${missing.join(', ')} — the runtime cannot drive this body`);
+        }
+        // A cm-scale rig binds pristinely and renders correctly at rest, then explodes the moment a clip plays.
+        if (summary.skeletonSpanY !== null && summary.skeletonSpanY > 10) {
+            fail('rig-scale', `skeleton spans ${summary.skeletonSpanY.toFixed(1)}m — the rig is not in metres`);
+        }
+    }
+    const dynamics = Array.isArray(extras.helixDynamics?.chains) ? extras.helixDynamics.chains.length : null;
+    const faceChannels = extras.helixFace?.channels ? Object.keys(extras.helixFace.channels).length : null;
+    const firstPersonHide = Array.isArray(extras.helixAvatar?.firstPersonHide)
+        ? extras.helixAvatar.firstPersonHide.length
+        : null;
+    if (kind === 'avatar') {
+        // Warnings, not errors: a character with no hair does not need physics, and a stylised avatar may have no
+        // visemes. Each one is a capability the platform WILL look for at runtime, so silence about them is how an
+        // avatar ships diminished and nobody notices until someone speaks to it.
+        if (dynamics === null)
+            warn('no-dynamics', 'no helixDynamics — hair, tails and cloth will not move');
+        if (faceChannels === null)
+            warn('no-face', 'no helixFace — this character cannot lip-sync or blink');
+        if (firstPersonHide === null) {
+            warn('no-first-person-hide', 'no helixAvatar.firstPersonHide — first person will render this head across the camera unless a mesh '
+                + 'happens to be named FaceMesh');
+        }
+    }
+    return {
+        ok: findings.every((finding) => finding.severity !== 'error'),
+        findings,
+        summary,
+        manifests: { dynamics, faceChannels, firstPersonHide },
+    };
+}
+/** One line per finding, plus the capability line, for the CLI's own output. */
+function formatPreflight(result) {
+    const lines = result.findings.map((f) => `${f.severity === 'error' ? '✗' : '⚠'} ${f.message}`);
+    const { dynamics, faceChannels, firstPersonHide } = result.manifests;
+    lines.push(`  ${result.summary.triangleCount.toLocaleString()} tris · ${result.summary.materialCount} materials · `
+        + `${result.summary.maxTextureEdge}px · ${(result.summary.sizeBytes / 1024 / 1024).toFixed(1)} MB · `
+        + `${result.summary.boneNames.length} joints`);
+    lines.push(`  physics ${dynamics ?? 0} chains · face ${faceChannels ?? 0} channels · first-person ${firstPersonHide ?? 0} surfaces`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=avatarPreflight.js.map

package/dist/character/avatarPreflight.js.map

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