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

package/dist/visualQa/resolve.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpStatusError = exports.hexOf = void 0;
+exports.categoryFor = categoryFor;
+exports.getPackageVersion = getPackageVersion;
+exports.getPackageObject = getPackageObject;
+exports.validateCandidateVersion = validateCandidateVersion;
+exports.modelCidFor = modelCidFor;
+exports.resolveItem = resolveItem;
+// Resolve an item id to EXACTLY what the harness must render: the pinned Continuum package version, its root
+// document (vehicle package / add-on descriptor / prop GLB), the canonical model CID, and the hosts or bases it fits.
+//
+// Never take `item.assets[0]`: for most wearables the first `rendition: web` row is a pipeline intermediate whose
+// bytes are NOT the pinned ones. The package root is the only source of truth for "this version".
+const candidate_1 = require("./candidate");
+const moveUx_1 = require("./moveUx");
+const WEARABLE_SLOTS = new Set(['top', 'bottom', 'outfit', 'footwear', 'headwear', 'gloves', 'eyewear', 'mask', 'full_body']);
+function categoryFor(item) {
+    const itemType = String(item.itemType ?? '');
+    const hostKind = String(item.hostKind ?? '');
+    if (itemType === 'vehicle')
+        return 'vehicle';
+    if (itemType === 'add_on') {
+        if (hostKind === 'vehicle')
+            return 'vehicle-addon';
+        const slot = /^character\.([a-z_]+)@\d+$/.exec(String(item.slotType ?? ''))?.[1];
+        return slot && WEARABLE_SLOTS.has(slot) ? 'wearable' : 'character-addon';
+    }
+    if (itemType === 'character' || item.kind === 'avatar')
+        return 'avatar';
+    if (itemType === 'animation')
+        return 'animation';
+    if (itemType === 'scene')
+        return 'scene';
+    return 'prop';
+}
+const hexOf = (cid) => (cid ? (/([0-9a-f]{64})$/.exec(cid)?.[1] ?? null) : null);
+exports.hexOf = hexOf;
+class HttpStatusError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+exports.HttpStatusError = HttpStatusError;
+async function getJson(url, token) {
+    // The public API rate-limits bursts (429); back off rather than reporting a harness error.
+    for (let attempt = 0;; attempt++) {
+        const res = await fetch(url, { headers: { accept: 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) } });
+        if (res.ok)
+            return (await res.json());
+        if ((res.status === 429 || res.status >= 500) && attempt < 5) {
+            const retryAfter = Number(res.headers.get('retry-after'));
+            await new Promise((r) => setTimeout(r, Number.isFinite(retryAfter) && retryAfter > 0 ? retryAfter * 1000 : 1500 * 2 ** attempt));
+            continue;
+        }
+        throw new HttpStatusError(res.status, `GET ${url} → ${res.status}`);
+    }
+}
+/** A sealed Package Version. The public route serves only a PUBLIC Package (`assertCanResolvePackage` refuses even the
+ *  owner of a private one, 403), so on 403/404 with a login the owner/authenticated route is asked instead: a private
+ *  avatar held for visual QA must still be judgeable by its creator (and by an admin or the leased runner). */
+async function getPackageVersion(api, packageId, version, token, itemId) {
+    const tail = `packages/${packageId}/versions/${encodeURIComponent(version)}`;
+    const refusedOrMissing = (e) => !!token && e instanceof HttpStatusError && (e.status === 403 || e.status === 404);
+    try {
+        return await getJson(`${api}/api/v1/continuum/public/${tail}`, token);
+    }
+    catch (e) {
+        if (!refusedOrMissing(e))
+            throw e;
+    }
+    try {
+        return await getJson(`${api}/api/v1/continuum/${tail}`, token);
+    }
+    catch (e) {
+        // The hosted runner owns nothing: the item's judge route names the exact Version for its creator, an admin and the
+        // runner holding a live lease, whatever the Package's visibility (backend `GET …/visual-qa/package-version`).
+        if (!itemId || !refusedOrMissing(e))
+            throw e;
+        return getJson(`${api}/api/v1/universal-items/${itemId}/visual-qa/package-version?version=${encodeURIComponent(version)}`, token);
+    }
+}
+/** A Package Version's object (a JSON root definition), public first, then the authenticated version-scoped route. */
+async function getPackageObject(api, packageId, version, cid, token) {
+    try {
+        return await getJson(`${api}/api/v1/continuum/public/objects/${cid}`, token);
+    }
+    catch (e) {
+        if (!token || !(e instanceof HttpStatusError) || (e.status !== 403 && e.status !== 404))
+            throw e;
+        return getJson(`${api}/api/v1/continuum/packages/${packageId}/versions/${encodeURIComponent(version)}/objects/${cid}`, token);
+    }
+}
+/** What the BACKEND says about the item's current Package Version: `exempt` is set when the gate asks for no run at all
+ *  (nothing to render: a tune-only add-on, an OG pending-rendition deed such as Parallel City Land). The harness obeys
+ *  it instead of re-deriving it, because a private pending Package's pin is not in the public item detail, so the CLI
+ *  cannot read its manifest. Best effort: an older backend or a network blip returns null and the harness renders. */
+async function backendExemption(api, itemId) {
+    try {
+        const res = await fetch(`${api}/api/v1/universal-items/${itemId}/visual-qa`, { headers: { accept: 'application/json' } });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        return body.currentVersion?.exempt ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** A candidate must be a sealed revision of the item's own typed Package, with an exact manifest identity. */
+function validateCandidateVersion(itemType, packageId, version, body) {
+    if (body.packageId !== packageId || body.manifest?.package?.id !== packageId)
+        throw new Error(`--package-version ${version}: candidate belongs to a different Package`);
+    if (body.version !== version || body.manifest?.version !== version)
+        throw new Error(`--package-version ${version}: candidate Version identity disagrees with the request`);
+    if (body.lifecycle !== 'sealed' && body.lifecycle !== 'superseded')
+        throw new Error(`--package-version ${version}: that version is ${body.lifecycle ?? 'unknown'}, not sealed or superseded`);
+    if (!/^(?:cid:)?sha256:[0-9a-f]{64}$/i.test(body.manifestCid ?? ''))
+        throw new Error(`--package-version ${version}: candidate has no valid immutable manifest CID`);
+    const type = body.manifest?.package?.type;
+    // A `prop` item is backed by an `asset` Package (package-taxonomy `ITEM_TYPE_BY_PACKAGE_TYPE` maps package type
+    // `asset` → item type `prop`; a placeable static mesh is an `asset`, never a `prop` Package). A `device` item is
+    // backed by a `device` Package. Every other item type's package type is its own wire id.
+    const expectedPackageType = itemType === 'prop' ? 'asset' : itemType;
+    if ((itemType === 'device' || itemType === 'prop') && type !== expectedPackageType)
+        throw new Error(`--package-version ${version}: ${String(itemType)} Item cannot render a ${type ?? 'missing-type'} Package`);
+    if (itemType === 'device' && (body.manifest?.root?.role !== 'device-definition' || !body.manifest?.variants?.some((v) => v.object?.mediaType === 'model/gltf-binary' && /^device\.model\.web/.test(v.object?.role ?? ''))))
+        throw new Error(`--package-version ${version}: Device candidate needs a definition root and web GLB in its sealed Package`);
+}
+/** Pick the model GLB the runtime draws for this version, by root role. */
+function modelCidFor(rootRole, rootMedia, root, manifest) {
+    const variants = manifest.variants ?? [];
+    const byId = (id) => variants.find((v) => v.id === id)?.object?.cid ?? null;
+    const byRole = (re) => variants.find((v) => re.test(v.object?.role ?? ''))?.object?.cid ?? null;
+    if (rootMedia && /model\/gltf-binary/.test(rootMedia))
+        return manifest.root?.cid ?? null;
+    if (rootRole === 'vehicle-definition')
+        return byId('target-balanced') ?? byRole(/vehicle\.model\.web/) ?? null;
+    const rendition = root?.rendition?.cid;
+    if (rendition)
+        return rendition;
+    return byId('web-model') ?? byRole(/model|mesh|glb/i) ?? null;
+}
+/** `token` lets the hosted runner (a bot account with read-only rights) resolve an item that is not public yet.
+ *  `candidate.packageVersion` resolves THAT version of the item's pinned package instead of the pin (a version move
+ *  being judged before the pointer moves); the identity then describes the candidate, and its vehicle checksum and
+ *  version row id stay null until Try Now names them (`trial.candidate`). */
+async function resolveItem(apiBase, itemId, token, candidateReq) {
+    const api = apiBase.replace(/\/$/, '');
+    const { item } = await getJson(`${api}/api/v1/universal-items/${itemId}`, token);
+    let pin = item.continuumPackagePin;
+    let pinnedVersionId = item.continuumPackageVersionId ?? null;
+    // A published LEGACY avatar (no pin) may carry a PENDING first pin, applied by the backend when exactly that version
+    // passes visual QA. Its creator, an admin and the leased runner read it from the version history; it is rendered as a
+    // candidate (Try Now `trial.packageVersion`) because the item does not point at it yet.
+    let pendingVersion = null;
+    // The public item detail hides the pin of an item that is not Published (held for visual QA, delisted). Its creator
+    // (or the hosted runner) can still read the version history, which names the current pin.
+    if (!pin && token) {
+        const history = await getJson(`${api}/api/v1/universal-items/${itemId}/versions`, token).catch(() => null);
+        if (history?.currentPackagePin?.packageId) {
+            pin = history.currentPackagePin;
+            pinnedVersionId = pinnedVersionId ?? history.versions?.find((v) => v.current)?.continuumPackageVersionId ?? null;
+        }
+        else if (history?.pendingPackagePin?.packageId && history.pendingPackagePin.version) {
+            pin = { packageId: history.pendingPackagePin.packageId, version: null, manifestCid: null };
+            pendingVersion = history.pendingPackagePin.version;
+        }
+    }
+    if (pendingVersion && !candidateReq?.packageVersion)
+        candidateReq = { ...(candidateReq ?? {}), packageVersion: pendingVersion };
+    const category = categoryFor(item);
+    const refusal = (0, candidate_1.candidateRefusal)(category, pin, candidateReq ?? {});
+    if (refusal)
+        throw new Error(`--package-version ${candidateReq?.packageVersion}: ${refusal}`);
+    const wanted = candidateReq?.packageVersion && pin?.version !== candidateReq.packageVersion ? candidateReq.packageVersion : null;
+    const version = wanted ?? pin?.version ?? null;
+    let root = null;
+    let rootRole = null;
+    let rootCid = null;
+    let packageType = null;
+    let modelCid = null;
+    let modelVariants = [];
+    let manifestCid = wanted ? null : (pin?.manifestCid ?? null);
+    if (pin?.packageId && version) {
+        const ver = await getPackageVersion(api, pin.packageId, version, token, itemId).catch(async (e) => {
+            if (!wanted || !(e instanceof HttpStatusError) || e.status !== 404)
+                throw e;
+            // The owner's package listing is the only place that names every version; it needs the creator's login.
+            const listed = token
+                ? await getJson(`${api}/api/v1/continuum/packages/${pin.packageId}/versions?limit=100`, token).then(moveUx_1.sealedVersionsFrom, () => null)
+                : null;
+            throw new Error(`--package-version ${wanted}: ${(0, moveUx_1.versionNotFoundMessage)({ packageId: pin.packageId, version: wanted, sealed: listed })}`);
+        });
+        if (wanted)
+            validateCandidateVersion(item.itemType, pin.packageId, wanted, ver);
+        manifestCid = ver.manifestCid ?? manifestCid;
+        rootRole = ver.manifest.root?.role ?? null;
+        rootCid = ver.manifest.root?.cid ?? null;
+        packageType = ver.manifest.package?.type ?? null;
+        const rootMedia = ver.manifest.root?.mediaType ?? null;
+        const rootHex = (0, exports.hexOf)(ver.manifest.root?.cid);
+        if (rootHex && rootMedia && /json/.test(rootMedia)) {
+            root = await getPackageObject(api, pin.packageId, version, `sha256:${rootHex}`, token);
+        }
+        modelCid = modelCidFor(rootRole, rootMedia, root, ver.manifest);
+        if (wanted && item.itemType === 'device' && (!root || root.version !== wanted || !modelCid))
+            throw new Error(`--package-version ${wanted}: Device definition or web model does not match the sealed Version`);
+        modelVariants = (ver.manifest.variants ?? [])
+            .filter((v) => v.id && v.object?.cid && /^vehicle\.model\.web(\.|$)/.test(v.object.role ?? ''))
+            .map((v) => ({ id: String(v.id), role: String(v.object.role), cid: String(v.object.cid) }));
+    }
+    const exemptByBackend = wanted ? null : await backendExemption(api, itemId);
+    const exemptLook = exemptByBackend === 'look';
+    const addOn = item.addOn;
+    const hostIds = addOn?.baseItemIds ?? [];
+    const vpi = item.properties?.vehiclePackageIdentity;
+    return {
+        identity: {
+            itemId,
+            title: String(item.title ?? itemId),
+            category,
+            itemType: item.itemType ?? null,
+            // A candidate's version row id and vehicle checksum are only known once Try Now has served it.
+            packageVersionId: wanted ? null : pinnedVersionId,
+            manifestCid,
+            packageId: pin?.packageId ?? null,
+            packageVersion: version,
+            vehicleChecksum: wanted ? null : (vpi?.checksumSha256 ?? null),
+        },
+        item,
+        root,
+        rootRole,
+        rootCid,
+        packageType,
+        modelCid,
+        modelVariants,
+        hostIds,
+        exempt: exemptByBackend,
+        meshless: exemptByBackend === 'meshless' || exemptLook || (category === 'vehicle-addon' || category === 'character-addon' || category === 'wearable') && !modelCid,
+        candidate: wanted
+            ? { currentVersion: pin?.version ?? null, currentManifestCid: pin?.manifestCid ?? null, vehiclePackage: category === 'vehicle' ? (candidateReq?.vehiclePackage ?? null) : null }
+            : null,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/visualQa/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/visualQa/resolve.ts"],"names":[],"mappings":";;;AAqCA,kCAaC;AAyBD,8CAgBC;AAGD,4CAOC;AAyBD,4DAuBC;AAGD,kCASC;AAMD,kCAmGC;AA1QD,6GAA6G;AAC7G,sHAAsH;AACtH,EAAE;AACF,kHAAkH;AAClH,kGAAkG;AAClG,2CAAsE;AACtE,qCAAsE;AA6BtE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAE9H,SAAgB,WAAW,CAAC,IAAoF;IAC9G,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,eAAe,CAAC;QACnD,MAAM,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAC3E,CAAC;IACD,IAAI,QAAQ,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACxE,IAAI,QAAQ,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IACjD,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,MAAM,KAAK,GAAG,CAAC,GAA8B,EAAiB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAArH,QAAA,KAAK,SAAgH;AAElI,MAAa,eAAgB,SAAQ,KAAK;IACnB;IAArB,YAAqB,MAAc,EAAE,OAAe;QAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAAlD,WAAM,GAAN,MAAM,CAAQ;IAAqC,CAAC;CAC1E;AAFD,0CAEC;AAED,KAAK,UAAU,OAAO,CAAI,GAAW,EAAE,KAAqB;IAC1D,2FAA2F;IAC3F,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAClI,IAAI,GAAG,CAAC,EAAE;YAAE,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;YAC1D,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;YACjI,SAAS;QACX,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;+GAE+G;AACxG,KAAK,UAAU,iBAAiB,CAAI,GAAW,EAAE,SAAiB,EAAE,OAAe,EAAE,KAAqB,EAAE,MAAe;IAChI,MAAM,IAAI,GAAG,YAAY,SAAS,aAAa,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7E,MAAM,gBAAgB,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;IAC3H,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAI,GAAG,GAAG,4BAA4B,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAI,GAAG,GAAG,qBAAqB,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,mHAAmH;QACnH,8GAA8G;QAC9G,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,OAAO,CAAI,GAAG,GAAG,2BAA2B,MAAM,sCAAsC,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACvI,CAAC;AACH,CAAC;AAED,sHAAsH;AAC/G,KAAK,UAAU,gBAAgB,CAAI,GAAW,EAAE,SAAiB,EAAE,OAAe,EAAE,GAAW,EAAE,KAAqB;IAC3H,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAI,GAAG,GAAG,oCAAoC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC;YAAE,MAAM,CAAC,CAAC;QACjG,OAAO,OAAO,CAAI,GAAG,GAAG,8BAA8B,SAAS,aAAa,kBAAkB,CAAC,OAAO,CAAC,YAAY,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IACnI,CAAC;AACH,CAAC;AAED;;;sHAGsH;AACtH,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAc;IACzD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,2BAA2B,MAAM,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAC1H,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2D,CAAC;QAC1F,OAAO,IAAI,CAAC,cAAc,EAAE,MAAM,IAAI,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AASD,8GAA8G;AAC9G,SAAgB,wBAAwB,CACtC,QAAiB,EACjB,SAAiB,EACjB,OAAe,EACf,IAA6G;IAE7G,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,SAAS;QAC1E,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,4CAA4C,CAAC,CAAC;IAC5F,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO;QAChE,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,yDAAyD,CAAC,CAAC;IACzG,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,KAAK,YAAY;QAChE,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,qBAAqB,IAAI,CAAC,SAAS,IAAI,SAAS,4BAA4B,CAAC,CAAC;IAC5H,IAAI,CAAC,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,iDAAiD,CAAC,CAAC;IACjG,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC;IAC1C,gHAAgH;IAChH,iHAAiH;IACjH,yFAAyF;IACzF,MAAM,mBAAmB,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrE,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,CAAC,IAAI,IAAI,KAAK,mBAAmB;QAChF,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,KAAK,MAAM,CAAC,QAAQ,CAAC,yBAAyB,IAAI,IAAI,cAAc,UAAU,CAAC,CAAC;IAC9H,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,KAAK,mBAAmB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,KAAK,mBAAmB,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QACxN,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,8EAA8E,CAAC,CAAC;AAChI,CAAC;AAED,2EAA2E;AAC3E,SAAgB,WAAW,CAAC,QAAuB,EAAE,SAAwB,EAAE,IAAoC,EAAE,QAAkB;IACrI,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC;IACpF,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC;IACxG,IAAI,SAAS,IAAI,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;IACzF,IAAI,QAAQ,KAAK,oBAAoB;QAAE,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,qBAAqB,CAAC,IAAI,IAAI,CAAC;IAC/G,MAAM,SAAS,GAAI,IAAI,EAAE,SAA0C,EAAE,GAAG,CAAC;IACzE,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC;AAChE,CAAC;AAED;;;6EAG6E;AACtE,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,MAAc,EAAE,KAAqB,EAAE,YAA+B;IACvH,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAoC,GAAG,GAAG,2BAA2B,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;IACpH,IAAI,GAAG,GAAG,IAAI,CAAC,mBAAiH,CAAC;IACjI,IAAI,eAAe,GAAI,IAAI,CAAC,yBAAoC,IAAI,IAAI,CAAC;IACzE,qHAAqH;IACrH,sHAAsH;IACtH,wFAAwF;IACxF,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,oHAAoH;IACpH,0FAA0F;IAC1F,IAAI,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,MAAM,OAAO,CAK3B,GAAG,GAAG,2BAA2B,MAAM,WAAW,EAAE,KAAK,CAC1D,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;YAC1C,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAChC,eAAe,GAAG,eAAe,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,yBAAyB,IAAI,IAAI,CAAC;QACnH,CAAC;aAAM,IAAI,OAAO,EAAE,iBAAiB,EAAE,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;YACtF,GAAG,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC3F,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC;QACrD,CAAC;IACH,CAAC;IACD,IAAI,cAAc,IAAI,CAAC,YAAY,EAAE,cAAc;QAAE,YAAY,GAAG,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;IAChI,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAa,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAA,4BAAgB,EAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC;IACpE,IAAI,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,YAAY,EAAE,cAAc,KAAK,OAAO,EAAE,CAAC,CAAC;IAC9F,MAAM,MAAM,GAAG,YAAY,EAAE,cAAc,IAAI,GAAG,EAAE,OAAO,KAAK,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;IACjI,MAAM,OAAO,GAAG,MAAM,IAAI,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;IAC/C,IAAI,IAAI,GAAmC,IAAI,CAAC;IAChD,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,aAAa,GAAqD,EAAE,CAAC;IACzE,IAAI,WAAW,GAAkB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,IAAI,IAAI,CAAC,CAAC;IAC5E,IAAI,GAAG,EAAE,SAAS,IAAI,OAAO,EAAE,CAAC;QAE9B,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAc,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAU,EAAE,EAAE;YACtH,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,YAAY,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG;gBAAE,MAAM,CAAC,CAAC;YAC5E,wGAAwG;YACxG,MAAM,MAAM,GAAG,KAAK;gBAClB,CAAC,CAAC,MAAM,OAAO,CAAU,GAAG,GAAG,8BAA8B,GAAG,CAAC,SAAS,qBAAqB,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,2BAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC;gBAC5I,CAAC,CAAC,IAAI,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,KAAK,IAAA,+BAAsB,EAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5I,CAAC,CAAC,CAAC;QACH,IAAI,MAAM;YAAE,wBAAwB,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAChF,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,WAAW,CAAC;QAC7C,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;QAC3C,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;QACzC,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC;QACjD,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC;QACvD,MAAM,OAAO,GAAG,IAAA,aAAK,EAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9C,IAAI,OAAO,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACnD,IAAI,GAAG,MAAM,gBAAgB,CAA0B,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QAClH,CAAC;QACD,QAAQ,GAAG,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,MAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,QAAQ,CAAC;YACzF,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,oEAAoE,CAAC,CAAC;QACnH,aAAa,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;aAC1C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;aAC9F,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,MAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,eAAe,KAAK,MAAM,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAA0C,CAAC;IAC9D,MAAM,OAAO,GAAG,KAAK,EAAE,WAAW,IAAI,EAAE,CAAC;IACzC,MAAM,GAAG,GAAI,IAAI,CAAC,UAA8E,EAAE,sBAAsB,CAAC;IACzH,OAAO;QACL,QAAQ,EAAE;YACR,MAAM;YACN,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC;YACnC,QAAQ;YACR,QAAQ,EAAG,IAAI,CAAC,QAAmB,IAAI,IAAI;YAC3C,+FAA+F;YAC/F,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe;YACjD,WAAW;YACX,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,IAAI;YACjC,cAAc,EAAE,OAAO;YACvB,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,cAAc,IAAI,IAAI,CAAC;SAC/D;QACD,IAAI;QACJ,IAAI;QACJ,QAAQ;QACR,OAAO;QACP,WAAW;QACX,QAAQ;QACR,aAAa;QACb,OAAO;QACP,MAAM,EAAE,eAAe;QACvB,QAAQ,EAAE,eAAe,KAAK,UAAU,IAAI,UAAU,IAAI,CAAC,QAAQ,KAAK,eAAe,IAAI,QAAQ,KAAK,iBAAiB,IAAI,QAAQ,KAAK,UAAU,CAAC,IAAI,CAAC,QAAQ;QAClK,SAAS,EAAE,MAAM;YACf,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,IAAI,IAAI,EAAE,kBAAkB,EAAE,GAAG,EAAE,WAAW,IAAI,IAAI,EAAE,cAAc,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YAChL,CAAC,CAAC,IAAI;KACT,CAAC;AACJ,CAAC"}

package/dist/visualQa/scene.d.ts

@@ -0,0 +1,14 @@
+import type { RenderRoute } from './harness';
+/** The player must stand within this of the document's spawn point (horizontal), and settle within this vertically. */
+export declare const SPAWN_XZ_TOLERANCE_M = 2.5;
+export declare const SPAWN_Y_TOLERANCE_M = 3;
+/** After a teleport the player may differ this much from the probed floor height and still count as standing on it. */
+export declare const STAND_Y_TOLERANCE_M = 1.2;
+/** The player y may change at most this between two reads a second apart for "standing still on something". */
+export declare const SETTLED_DY_M = 0.08;
+/** Meshes whose world bounding radius exceeds this are sky / horizon domes, not part of the scene's measured extent. */
+export declare const SKY_RADIUS_M = 1500;
+/** The scene's measured extent must be at least this large (largest dimension). */
+export declare const MIN_SCENE_EXTENT_M = 3;
+export declare const MIN_STANDPOINTS = 2;
+export declare const renderScene: RenderRoute;