@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/visualQa/avatarPreview.js

@@ -0,0 +1,167 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PREVIEW_ASSERT_IDS = exports.PREVIEW_PHASES = void 0;
+exports.decodeRest = decodeRest;
+exports.previewAsserts = previewAsserts;
+exports.runPreviewStage = runPreviewStage;
+// Avatar route, stage 2 (avatar@3): the MARKETPLACE PREVIEW WALK. The production item page (`/items/<id>`) is where a
+// buyer first meets an avatar: it retargets the shared walk clip onto the avatar and runs the platform DynamicsLayer.
+// "Cream Hoodie Anime Girl" 1.0.6 passed avatar@2 (the Try Now jog, frozen once) while this walk, seen from the side,
+// showed its forearms inside the hoodie, the hoodie tearing open as an arm swung back and the back hair standing off as
+// a slab. This stage reads that walk:
+//
+//   1. the page's own AnimationMixer is held at 16 phases of one clip cycle (the viewer's PAUSE, at chosen times) and
+//      the posed vertices the page draws are read at each, plus the rest mesh, topology, skin and bind pose;
+//   2. avatarPreviewMath judges them (arms inside the body, holes opening, silhouette, stray strands, bind pose, posture);
+//   3. the walk is held where each arm swings furthest back (phase a = left arm back, b = right arm back) and
+//      photographed from the avatar's true left side, true right side and back for the vision critic.
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_zlib_1 = __importDefault(require("node:zlib"));
+const node_path_1 = __importDefault(require("node:path"));
+const avatarPreviewMath_1 = require("./avatarPreviewMath");
+const avatarPreviewProbe_1 = require("./avatarPreviewProbe");
+const commonAsserts_1 = require("./commonAsserts");
+const vehicleProbe_1 = require("./vehicleProbe");
+const vehicleMath_1 = require("./vehicleMath");
+/* eslint-disable @typescript-eslint/no-explicit-any */
+exports.PREVIEW_PHASES = 16;
+exports.PREVIEW_ASSERT_IDS = ['avatar.preview.arms_clear', 'avatar.preview.surface_closed', 'avatar.preview.silhouette', 'avatar.preview.posture', 'avatar.mesh.no_strands', 'avatar.bind_pose'];
+const VIEWS = [
+    ['left', "its left side", [1, 0.06, 0]],
+    ['right', "its right side", [-1, 0.06, 0]],
+    ['back', 'behind', [0, 0.12, -1]],
+];
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const f32 = (b64) => { const b = Buffer.from(b64, 'base64'); return new Float32Array(b.buffer, b.byteOffset, b.length / 4).slice(); };
+const u32 = (b64) => { const b = Buffer.from(b64, 'base64'); return new Uint32Array(b.buffer.slice(b.byteOffset, b.byteOffset + b.length)); };
+const u16 = (b64) => { const b = Buffer.from(b64, 'base64'); return new Uint16Array(b.buffer.slice(b.byteOffset, b.byteOffset + b.length)); };
+function decodeRest(raw) {
+    return { nv: raw.nv, boneNames: raw.boneNames, parents: raw.parents, bind: raw.bind, rest: f32(raw.rest), index: u32(raw.index), skinIndex: u16(raw.skinIndex), skinWeight: f32(raw.skinWeight) };
+}
+/** Every avatar@3 preview assert, judged from what the stage read (null = never read: each is "not measured"). */
+function previewAsserts(rest, poses, subject, why) {
+    const ok = rest && poses.length ? rest : null;
+    const measures = {
+        arms: ok ? (0, avatarPreviewMath_1.measureArmsClear)(ok, poses) : null,
+        holes: ok ? (0, avatarPreviewMath_1.measureSurfaceClosed)(ok, poses) : null,
+        silhouette: ok ? (0, avatarPreviewMath_1.measureSilhouette)(ok, poses) : null,
+        strands: rest ? (0, avatarPreviewMath_1.measureStrands)(rest, poses) : null,
+        bind: rest ? (0, avatarPreviewMath_1.measureBindPose)(rest) : null,
+        posture: ok ? (0, avatarPreviewMath_1.measurePosture)(ok, poses) : null,
+    };
+    const j = {
+        'avatar.preview.arms_clear': (0, avatarPreviewMath_1.judgeArmsClear)(measures.arms),
+        'avatar.preview.surface_closed': (0, avatarPreviewMath_1.judgeSurfaceClosed)(measures.holes),
+        'avatar.preview.silhouette': (0, avatarPreviewMath_1.judgeSilhouette)(measures.silhouette),
+        'avatar.preview.posture': (0, avatarPreviewMath_1.judgePosture)(measures.posture),
+        'avatar.mesh.no_strands': (0, avatarPreviewMath_1.judgeStrands)(measures.strands),
+        'avatar.bind_pose': (0, avatarPreviewMath_1.judgeBindPose)(measures.bind),
+    };
+    const asserts = exports.PREVIEW_ASSERT_IDS.map((id) => {
+        const r = j[id];
+        const detail = why && /^not measured/.test(r.detail) ? `not measured: ${why}` : r.detail;
+        return { id, pass: r.pass, severity: 'block', subject, detail, measured: r.measured };
+    });
+    return { asserts, measures };
+}
+/** Load the item page and wait until the avatar is drawn and the page's mixer plays a clip on it. */
+async function waitWalking(page, timeoutMs) {
+    const t0 = Date.now();
+    let last = null;
+    while (Date.now() - t0 < timeoutMs) {
+        await page.evaluate(avatarPreviewProbe_1.INSTALL_AVATAR_PREVIEW_PROBE).catch(() => undefined);
+        last = await page.evaluate('globalThis.__vqaAp ? globalThis.__vqaAp.state() : null').catch(() => null);
+        if (last?.found && last.mixers > 0 && last.duration > 0) {
+            const f0 = last.frames;
+            await sleep(600);
+            const f1 = await page.evaluate('(globalThis.__vqa && globalThis.__vqa.frames) || 0').catch(() => 0);
+            if (f1 > f0)
+                return last;
+        }
+        await sleep(1000);
+    }
+    throw new Error(`the Marketplace preview never walked the avatar within ${Math.round(timeoutMs / 1000)} s (last state ${JSON.stringify(last).slice(0, 300)})`);
+}
+async function runPreviewStage(o) {
+    const { page, itemId, outDir } = o;
+    const frames = [];
+    const errors = [];
+    const images = [];
+    const facts = { url: `${o.webBase.replace(/\/$/, '')}/items/${encodeURIComponent(itemId)}`, phases: exports.PREVIEW_PHASES, thresholds: avatarPreviewMath_1.AVATAR_PREVIEW_THRESHOLDS };
+    let rest = null;
+    const poses = [];
+    let why = null;
+    const t0 = Date.now();
+    try {
+        await page.addInitScript(avatarPreviewProbe_1.MIXER_HOOK);
+        await page.goto(facts.url, { waitUntil: 'domcontentloaded', timeout: 90_000 });
+        const state = await waitWalking(page, 120_000);
+        facts.state = state;
+        await page.waitForTimeout(1500);
+        for (const f of page.frames())
+            await f.evaluate(vehicleProbe_1.HIDE_OVERLAYS).catch(() => undefined);
+        facts.canvas = await page.evaluate('globalThis.__vqaAp.markCanvas()');
+        const rawRest = await page.evaluate('globalThis.__vqaAp.rest()');
+        rest = decodeRest(rawRest);
+        const rawPoses = [];
+        facts.mesh = { nv: rest.nv, triangles: rest.index.length / 3, bones: rest.boneNames.length };
+        const D = state.duration;
+        for (let k = 0; k < exports.PREVIEW_PHASES; k++) {
+            const t = (k / exports.PREVIEW_PHASES) * D;
+            await page.evaluate(`globalThis.__vqaAp.hold(${t})`);
+            await page.evaluate('globalThis.__vqaAp.frames(20)');
+            const p = await page.evaluate('globalThis.__vqaAp.posed()');
+            poses.push({ t: +t.toFixed(3), positions: f32(p.positions), bones: p.bones });
+            rawPoses.push({ t, ...p });
+        }
+        // Calibration only: keep what was read, so thresholds can be re-judged offline without re-rendering.
+        if (process.env.HELIX_VQA_PREVIEW_DUMP)
+            node_fs_1.default.writeFileSync(node_path_1.default.join(outDir, 'preview-dump.json.gz'), node_zlib_1.default.gzipSync(JSON.stringify({ rest: rawRest, poses: rawPoses })));
+        facts.readMs = Date.now() - t0;
+        // ---------------------------------------------------------------------------------------------- critic frames
+        const ph = (0, avatarPreviewMath_1.backswingPhases)(rest, poses);
+        facts.backswing = ph;
+        const bounds = (0, avatarPreviewMath_1.posedBounds)(poses);
+        if (bounds) {
+            const cam = await page.evaluate('globalThis.__vqaAp.aspect()');
+            const aspect = cam?.aspect ?? 1;
+            const fov = 30;
+            const canvas = page.locator('[data-vqa-preview-canvas]').first();
+            for (const [key, phase, arm] of [['a', ph.left, 'left'], ['b', ph.right, 'right']]) {
+                if (phase === null)
+                    continue;
+                await page.evaluate(`globalThis.__vqaAp.hold(${poses[phase].t})`);
+                await page.evaluate('globalThis.__vqaAp.frames(30)');
+                for (const [view, where, dir] of VIEWS) {
+                    await page.evaluate((c) => globalThis.__vqaAp.setCam(c), (0, vehicleMath_1.camFit)(bounds.min, bounds.max, dir, fov, aspect, 0.86));
+                    await page.evaluate('globalThis.__vqaAp.frames(4)');
+                    const id = `motion.preview.${view}.${key}`;
+                    const file = node_path_1.default.join('frames', `${id}.jpg`);
+                    node_fs_1.default.mkdirSync(node_path_1.default.join(outDir, 'frames'), { recursive: true });
+                    const buf = await canvas.screenshot({ type: 'jpeg', quality: 85 });
+                    node_fs_1.default.writeFileSync(node_path_1.default.join(outDir, file), buf);
+                    const box = await canvas.boundingBox();
+                    frames.push({ id, label: `Marketplace walk preview (paused), seen from ${where}, ${arm} arm swung fully back`, group: 'motion', file, width: Math.round(box?.width ?? 0), height: Math.round(box?.height ?? 0), subject: itemId });
+                    images.push(await (0, commonAsserts_1.imageStats)(node_path_1.default.join(outDir, file)).catch(() => ({ file, lumaStdev: 0, meanLuma: 0 })));
+                }
+            }
+        }
+        await page.evaluate('globalThis.__vqaAp.resume()').catch(() => undefined);
+    }
+    catch (e) {
+        why = `the Marketplace preview walk could not be read: ${String(e?.message ?? e).slice(0, 300)}`;
+        errors.push(why);
+        await page.screenshot({ path: node_path_1.default.join(outDir, 'frames', 'error.preview.jpg'), type: 'jpeg', quality: 70 }).catch(() => undefined);
+    }
+    if (rest && poses.length < exports.PREVIEW_PHASES && !why)
+        why = `only ${poses.length} of ${exports.PREVIEW_PHASES} phases were read`;
+    const { asserts, measures } = previewAsserts(rest, poses, itemId, why);
+    facts.measures = measures;
+    facts.ms = Date.now() - t0;
+    o.log('avatar.preview', { ms: facts.ms, phases: poses.length, frames: frames.length });
+    return { frames, asserts, errors, facts, images };
+}
+//# sourceMappingURL=avatarPreview.js.map

package/dist/visualQa/avatarPreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatarPreview.js","sourceRoot":"","sources":["../../src/visualQa/avatarPreview.ts"],"names":[],"mappings":";;;;;;AA0CA,gCAEC;AAGD,wCAwBC;AAkBD,0CAiEC;AA1JD,sHAAsH;AACtH,sHAAsH;AACtH,sHAAsH;AACtH,wHAAwH;AACxH,sCAAsC;AACtC,EAAE;AACF,sHAAsH;AACtH,6GAA6G;AAC7G,2HAA2H;AAC3H,8GAA8G;AAC9G,sGAAsG;AACtG,sDAAyB;AACzB,0DAA6B;AAC7B,0DAA6B;AAE7B,2DAI6B;AAC7B,6DAAgF;AAChF,mDAA8D;AAE9D,iDAA+C;AAC/C,+CAAkD;AAElD,uDAAuD;AAC1C,QAAA,cAAc,GAAG,EAAE,CAAC;AACpB,QAAA,kBAAkB,GAAG,CAAC,2BAA2B,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,kBAAkB,CAAU,CAAC;AAC/M,MAAM,KAAK,GAAkC;IAC3C,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;CAClC,CAAC;AACF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAIpE,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9I,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtJ,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtJ,SAAgB,UAAU,CAAC,GAAQ;IACjC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;AACpM,CAAC;AAED,kHAAkH;AAClH,SAAgB,cAAc,CAAC,IAAwB,EAAE,KAAoB,EAAE,OAAe,EAAE,GAAkB;IAChH,MAAM,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAA,oCAAgB,EAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QAC7C,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAA,wCAAoB,EAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QAClD,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,IAAA,qCAAiB,EAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QACpD,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAA,kCAAc,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QAClD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAA,mCAAe,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACzC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAA,kCAAc,EAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;KAC/C,CAAC;IACF,MAAM,CAAC,GAAmF;QACxF,2BAA2B,EAAE,IAAA,kCAAc,EAAC,QAAQ,CAAC,IAAI,CAAC;QAC1D,+BAA+B,EAAE,IAAA,sCAAkB,EAAC,QAAQ,CAAC,KAAK,CAAC;QACnE,2BAA2B,EAAE,IAAA,mCAAe,EAAC,QAAQ,CAAC,UAAU,CAAC;QACjE,wBAAwB,EAAE,IAAA,gCAAY,EAAC,QAAQ,CAAC,OAAO,CAAC;QACxD,wBAAwB,EAAE,IAAA,gCAAY,EAAC,QAAQ,CAAC,OAAO,CAAC;QACxD,kBAAkB,EAAE,IAAA,iCAAa,EAAC,QAAQ,CAAC,IAAI,CAAC;KACjD,CAAC;IACF,MAAM,OAAO,GAAG,0BAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACzF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACjG,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,qGAAqG;AACrG,KAAK,UAAU,WAAW,CAAC,IAAU,EAAE,SAAiB;IACtD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAAC,IAAI,IAAI,GAAQ,IAAI,CAAC;IAC5C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,CAAC,QAAQ,CAAC,iDAA4B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzE,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,wDAAwD,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACvG,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;YAAC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,oDAAoD,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YACpG,IAAK,EAAa,GAAG,EAAE;gBAAE,OAAO,IAAI,CAAC;QACvC,CAAC;QACD,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AACjK,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,CAAwG;IAC5I,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,MAAM,GAAoB,EAAE,CAAC;IAAC,MAAM,MAAM,GAAa,EAAE,CAAC;IAAC,MAAM,MAAM,GAAiB,EAAE,CAAC;IACjG,MAAM,KAAK,GAA4B,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,sBAAc,EAAE,UAAU,EAAE,6CAAyB,EAAE,CAAC;IACrL,IAAI,IAAI,GAAuB,IAAI,CAAC;IAAC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAAC,IAAI,GAAG,GAAkB,IAAI,CAAC;IACpG,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,CAAC,+BAAU,CAAC,CAAC;QACrC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAa,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACzF,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,4BAAa,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACtF,KAAK,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAQ,CAAC;QACxE,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC7F,MAAM,CAAC,GAAG,KAAK,CAAC,QAAkB,CAAC;QACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,sBAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,sBAAc,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC;YACrD,MAAM,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;YACrD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAA6C,CAAC;YACxG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,qGAAqG;QACrG,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB;YAAE,iBAAE,CAAC,aAAa,CAAC,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,mBAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;QACvK,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QAC/B,+GAA+G;QAC/G,MAAM,EAAE,GAAG,IAAA,mCAAe,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAA,+BAAW,EAAC,KAAK,CAAC,CAAC;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,6BAA6B,CAAyD,CAAC;YACvH,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,CAAC,CAAC;YAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,KAAK,EAAE,CAAC;YACjE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAU,EAAE,CAAC;gBAC5F,IAAI,KAAK,KAAK,IAAI;oBAAE,SAAS;gBAC7B,MAAM,IAAI,CAAC,QAAQ,CAAC,2BAA2B,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAClE,MAAM,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;gBACrD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;oBACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,UAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAA,oBAAM,EAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAQ,CAAC,CAAC;oBACjI,MAAM,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;oBACpD,MAAM,EAAE,GAAG,kBAAkB,IAAI,IAAI,GAAG,EAAE,CAAC;oBAAC,MAAM,IAAI,GAAG,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;oBAC1F,iBAAE,CAAC,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC/D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;oBACnE,iBAAE,CAAC,aAAa,CAAC,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;oBAC/C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;oBACvC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,gDAAgD,KAAK,KAAK,GAAG,uBAAuB,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;oBACnO,MAAM,CAAC,IAAI,CAAC,MAAM,IAAA,0BAAU,EAAC,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC5G,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,GAAG,mDAAmD,MAAM,CAAE,CAAW,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC5G,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACtI,CAAC;IACD,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,sBAAc,IAAI,CAAC,GAAG;QAAE,GAAG,GAAG,QAAQ,KAAK,CAAC,MAAM,OAAO,sBAAc,mBAAmB,CAAC;IACtH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACvE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IACtD,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACvF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACpD,CAAC"}

package/dist/visualQa/avatarPreviewMath.d.ts

@@ -0,0 +1,189 @@
+import type { Vec3 } from './vehicleMath';
+export interface PreviewRest {
+    nv: number;
+    boneNames: string[];
+    parents: number[];
+    /** Bind-pose world matrix per bone (column-major 4x4), null for a bone no skin uses. */
+    bind: Array<number[] | null>;
+    /** Bind-pose vertex positions, flat xyz. */
+    rest: Float32Array;
+    /** Triangles, flat (merged over every drawn skinned mesh). */
+    index: Uint32Array;
+    /** 4 bone ids (into boneNames) and 4 weights per vertex. */
+    skinIndex: Uint16Array;
+    skinWeight: Float32Array;
+}
+export interface PreviewPose {
+    /** Clip time (s). */
+    t: number;
+    /** Posed vertex positions in the BODY frame (+Y up, +Z forward, +X the character's left), flat xyz. */
+    positions: Float32Array;
+    /** World matrix (body frame, column-major) of each bone, in boneNames order. */
+    bones: number[][];
+}
+export declare const AVATAR_PREVIEW_THRESHOLDS: {
+    /** Forearm + hand surface (>= 0.6 weight on lowerarm/hand/fingers) lying more than `armDepthM` behind the nearest
+     *  torso/hip surface (>= 0.6 on pelvis/spine/thigh, within `armNearM`), as an area share AVERAGED over the walk cycle
+     *  (a hand brushing the hip at one phase is fine; arms that walk inside the body are inside most of the cycle).
+     *  Measured on the production page: good Base Male/Female 0, worst Pastel Cyberpunk 0.085 (arms bound at 20 deg,
+     *  pressed to the hips; peak 0.218), Brass 0.059; Cream Hoodie 1.0.6 0.180 (peak 0.259), Base Male arms-low fixture
+     *  0.240, Cream Hoodie 1.0.8 0.000. */
+    armDepthM: number;
+    armNearM: number;
+    armInsideShareMax: number;
+    /** Two sides of a hole: boundary vertices of the same connected surface, within 2 cm of each other at rest but at
+     *  least 7 edges apart along the surface. How far they separate in the walk (cm). Good max 0.8 (Iron Man);
+     *  Cream Hoodie 1.0.6 20.1 (the cut sleeve-to-torso bridge opening as the arm swings back). */
+    holePairRestM: number;
+    holeMinHops: number;
+    holeOpenMaxM: number;
+    /** Geometry that is neither torso nor limb, between spine_01 and neck_01 height, standing behind / beside the torso's
+     *  own outline (cm, scaled to a 1.70 m body), in two classes: hung from the head (hair, ears) and everything else on
+     *  its own bones (capes, coat tails, accessories). Measured on the production page (held poses, dynamics settled):
+     *  good max Kemonomimi 28.1 (hair) / 21.8 (cape); Cream Hoodie 1.0.6 22.3 (its back hair rides on spine bones, so it
+     *  reads as the second class) — inside the good envelope, so 1.0.6's slab is the vision critic's to judge on the
+     *  motion.preview side frames; this catches gross outliers (the slab fixture: a plate 45 cm off the back). */
+    silhouetteHairMaxM: number;
+    silhouetteClothMaxM: number;
+    /** A detached rest-mesh fragment longer than this, thin (area / extent^2 below `strandThinness`) and small (< 2 % of
+     *  the surface), is a stray strand. None in the good set. A triangle the walk stretches into a sliver (longest edge
+     *  > 4 cm and > 3x its rest length, < 4 mm tall) is recorded as evidence, not judged (good avatars reach 3). */
+    strandMinExtentM: number;
+    strandThinness: number;
+    strandMaxShare: number;
+    /** ... and no vertex of it within this distance of any other surface (it floats). */
+    strandFloatM: number;
+    /** Upper arm bound at least this far from straight down (deg). Base Female 36, worst good Pastel 19.6, Kemonomimi
+     *  (T-pose) 90; Cream Hoodie 1.0.6 13-15: the walk adducts ~24 deg from the clip's A-pose, so an arm bound that
+     *  close walks inside the body. */
+    upperarmAbductionMinDeg: number;
+    /** Any other canonical bone's bind direction vs Base Female (deg). Good max: lowerarm 60 (T-pose), thigh/calf 36
+     *  (Brass), foot 38 (Cream Hoodie), neck 14 (T-800). */
+    bindDeltaMaxDeg: Record<string, number>;
+    /** Neck lean (neck_01 -> head from vertical, sagittal, deg) and torso lean (pelvis -> spine_03) through the walk vs
+     *  Base Female (neck 18.9..23.1, torso 5.2..9.6). Good range: neck 6.8 (Ninja) .. 34.8 (T-800). */
+    neckLeanDeltaMaxDeg: number;
+    torsoLeanDeltaMaxDeg: number;
+};
+export declare const BASE_FEMALE_POSTURE: {
+    neckLeanDeg: [number, number];
+    torsoLeanDeg: [number, number];
+};
+/** Base Female 1.3.1 bind directions (unit, model frame) of the canonical bone pairs. */
+export declare const STANDARD_BIND_DIRECTIONS: Record<string, Vec3>;
+/** Per-vertex weight on bones whose name matches `re`. */
+export declare function weightOn(rest: PreviewRest, re: RegExp): Float32Array;
+/** Name of each vertex's dominant bone. */
+export declare function dominantBone(rest: PreviewRest): string[];
+export declare function vertexAreas(P: Float32Array, I: Uint32Array, nv: number): Float64Array;
+export declare function vertexNormals(P: Float32Array, I: Uint32Array, nv: number): Float32Array;
+/** Uniform-grid nearest-neighbour index over a subset of points. */
+export declare class PointGrid {
+    private P;
+    private cell;
+    private cells;
+    constructor(P: Float32Array, ids: ArrayLike<number>, cell?: number);
+    private key;
+    /** Nearest indexed point within `radius` of (x,y,z): [index, distance] or [-1, Infinity]. */
+    nearest(x: number, y: number, z: number, radius: number): [number, number];
+    within(x: number, y: number, z: number, radius: number): number[];
+}
+/** Weld vertices that share a rest position (UV/normal seams split them in glTF) into one topological vertex. */
+export interface Welded {
+    of: Int32Array;
+    count: number;
+    rep: Int32Array;
+    tris: Int32Array;
+}
+export declare function weld(rest: Float32Array, index: Uint32Array, nv: number, tol?: number): Welded;
+export interface ArmsMeasure {
+    measured: boolean;
+    why?: string;
+    insideShare: number;
+    peakShare: number;
+    phase: number | null;
+    depthCm: number;
+    forearmVerts: number;
+}
+/** Forearms/hands buried inside the torso/hips while walking (#3). */
+export declare function measureArmsClear(rest: PreviewRest, poses: PreviewPose[]): ArmsMeasure;
+export interface HoleMeasure {
+    measured: boolean;
+    why?: string;
+    openCm: number;
+    boundaryEdges: number;
+    pairs: number;
+    phase: number | null;
+    at: Vec3 | null;
+}
+/** Holes in the surface that open as the limbs swing (#5): the two sides of a hole sit together at rest and part. */
+export declare function measureSurfaceClosed(rest: PreviewRest, poses: PreviewPose[]): HoleMeasure;
+export interface SilhouetteMeasure {
+    measured: boolean;
+    why?: string;
+    /** Worst over both classes (cm at 1.70 m). */
+    backCm: number;
+    sideCm: number;
+    /** Geometry hung from the head (hair, ears, hood strings: dominant bone `head`/`neck_*` or a non-skeleton bone below them). */
+    hairBackCm: number;
+    hairSideCm: number;
+    /** Everything else that is neither torso nor limb (capes, coat tails, tails, accessories on their own bones). */
+    clothBackCm: number;
+    clothSideCm: number;
+    phase: number | null;
+    heightM: number;
+}
+/** Per bone: is it hung from the head (the head, the neck, or a non-skeleton bone whose nearest skeleton ancestor is one)? */
+export declare function headHungBones(rest: PreviewRest): boolean[];
+/** Hair / cloth / accessories standing out of the torso's outline between the hips and the neck (#2). */
+export declare function measureSilhouette(rest: PreviewRest, poses: PreviewPose[]): SilhouetteMeasure;
+export interface StrandMeasure {
+    strands: Array<{
+        extentCm: number;
+        areaCm2: number;
+        at: Vec3;
+    }>;
+    components: number;
+    posedSlivers: number;
+    posedSliverMaxCm: number;
+    posedSliverAt: Vec3 | null;
+}
+/** Stray strands on the rest mesh (#4), plus (evidence only) triangles the walk stretches into slivers. */
+export declare function measureStrands(rest: PreviewRest, poses: PreviewPose[]): StrandMeasure;
+export interface BindMeasure {
+    measured: boolean;
+    why?: string;
+    upperarmAbductionDeg: Record<string, number>;
+    deltaDeg: Record<string, number>;
+}
+/** Each canonical bone's bind direction vs the standard skeleton (#6). */
+export declare function measureBindPose(rest: PreviewRest): BindMeasure;
+export interface PostureMeasure {
+    measured: boolean;
+    why?: string;
+    neckLeanDeg: [number, number] | null;
+    torsoLeanDeg: [number, number] | null;
+}
+/** Head and torso lean through the walk (#7), read from the posed skeleton. */
+export declare function measurePosture(rest: PreviewRest, poses: PreviewPose[]): PostureMeasure;
+export interface Judged {
+    pass: boolean;
+    detail: string;
+    measured: Record<string, unknown>;
+}
+export declare function judgeArmsClear(m: ArmsMeasure | null): Judged;
+export declare function judgeSurfaceClosed(m: HoleMeasure | null): Judged;
+export declare function judgeSilhouette(m: SilhouetteMeasure | null): Judged;
+export declare function judgeStrands(m: StrandMeasure | null): Judged;
+export declare function judgeBindPose(m: BindMeasure | null): Judged;
+export declare function judgePosture(m: PostureMeasure | null): Judged;
+/** Phases at which each arm swings furthest back (hand furthest behind the pelvis), for the critic's frames. */
+export declare function backswingPhases(rest: PreviewRest, poses: PreviewPose[]): {
+    left: number | null;
+    right: number | null;
+};
+/** Body-frame bounds of every posed vertex over the given poses. */
+export declare function posedBounds(poses: PreviewPose[]): {
+    min: Vec3;
+    max: Vec3;
+} | null;