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

package/dist/itemDef/gunConfigRules.js

@@ -0,0 +1,300 @@
+"use strict";
+// Vendored engine gun-config validator for `helix item-def` — the structural rules a weapon descriptor's
+// `configFor["gun-control"]` payload must satisfy to install.
+// SYNC OBLIGATION: mirrors helix-web-engine-new/systems/humanoid-character/src/items/installWeaponItem.ts
+// (and the descriptor slice in .../src/items/itemDescriptor.ts). Fix bugs there first, then mirror here;
+// do not diverge. Mirrored with the explosives line: the `fire.kind` branch (absent = hitscan; projectile
+// and thrown each require their bounded block) and the `sounds.explosion` slot. One deliberate widening:
+// the engine only ever sees PUBLISHED payloads, so its sound refs are `vault:<assetId>` or absolute http(s)
+// — this copy additionally accepts descriptor-relative paths (the pre-publish authoring form) and reports
+// them so validate/publish can existence-check and upload them. One deliberate NARROWING: a descriptor with
+// no `gun-control` payload is an ERROR here (the engine warns and installs it cosmetically) — see below.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELD_ITEM_PRESET_NAMES = exports.DENIED_GUN_CONFIG_KEYS = exports.VAULT_REF_PREFIX = void 0;
+exports.checkGunConfigRules = checkGunConfigRules;
+exports.VAULT_REF_PREFIX = 'vault:';
+/** Config keys an item payload must never set: the replica-mode switch and the world-global accuracy dial. */
+exports.DENIED_GUN_CONFIG_KEYS = ['remoteDriven', 'spreadScale'];
+const FIRE_MODES = new Set(['auto', 'semi']);
+const FIRE_KINDS = new Set(['hitscan', 'projectile', 'thrown']);
+const SHELL_CLASSES = new Set(['pistol', 'rifle', 'lmg', 'shotgun', 'sniper']);
+// SYNC OBLIGATION: the keys of HELD_ITEM_PRESETS in .../src/core/attachments/presets.ts — the closed
+// preset vocabulary `held.preset` may name.
+exports.HELD_ITEM_PRESET_NAMES = ['pistol', 'rifle', 'sword', 'mug', 'flashlight', 'torch', 'phone'];
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+function isVec3(value) {
+    return Array.isArray(value) && value.length === 3 && value.every(isFiniteNumber);
+}
+/** A [t, v] curve with at least `min` keys, every entry a finite pair. */
+function isCurve(value, min) {
+    return Array.isArray(value) && value.length >= min &&
+        value.every((p) => Array.isArray(p) && p.length === 2 && p.every(isFiniteNumber));
+}
+function isVaultRefObject(value) {
+    return isRecord(value) && typeof value.assetId === 'string' && typeof value.version === 'number' &&
+        typeof value.checksumSha256 === 'string';
+}
+const isHttpUrl = (ref) => /^https?:\/\//i.test(ref);
+const isWindowsAbsolute = (ref) => /^[A-Za-z]:[\\/]/.test(ref) || ref.startsWith('\\\\');
+/** Classify one sound ref. Relative paths are the pre-publish form; absolute paths never validate —
+ *  a descriptor must stay portable next to its files. */
+function checkSoundRef(where, ref, out) {
+    if (typeof ref !== 'string' || ref.length === 0) {
+        out.errors.push(`${where}: sound entry is not a string`);
+        return;
+    }
+    if (ref.startsWith(exports.VAULT_REF_PREFIX)) {
+        if (ref.length === exports.VAULT_REF_PREFIX.length)
+            out.errors.push(`${where}: '${ref}' names no asset id`);
+        return;
+    }
+    if (isHttpUrl(ref))
+        return;
+    if (isWindowsAbsolute(ref) || ref.startsWith('/')) {
+        out.errors.push(`${where}: '${ref}' is an absolute path — use a path relative to the descriptor (publish rewrites it to a vault: ref)`);
+        return;
+    }
+    if (!out.relativeSoundRefs.includes(ref))
+        out.relativeSoundRefs.push(ref);
+}
+function checkSounds(raw, out) {
+    if (!isRecord(raw)) {
+        out.errors.push('payload.sounds is missing');
+        return;
+    }
+    const shots = raw.shots;
+    if (!Array.isArray(shots) || shots.length === 0) {
+        out.errors.push('payload.sounds.shots must be a non-empty array');
+    }
+    else {
+        shots.forEach((s, i) => checkSoundRef(`payload.sounds.shots[${i}]`, s, out));
+    }
+    if (raw.dry !== undefined)
+        checkSoundRef('payload.sounds.dry', raw.dry, out);
+    if (raw.reload !== undefined) {
+        if (!isRecord(raw.reload)) {
+            out.errors.push('payload.sounds.reload is not an object');
+        }
+        else {
+            for (const stage of ['out', 'in', 'charge']) {
+                const cues = raw.reload[stage];
+                if (cues === undefined)
+                    continue;
+                if (!Array.isArray(cues) || cues.length === 0) {
+                    out.errors.push(`payload.sounds.reload.${stage} must be a non-empty array`);
+                    continue;
+                }
+                cues.forEach((s, i) => checkSoundRef(`payload.sounds.reload.${stage}[${i}]`, s, out));
+            }
+        }
+    }
+    if (raw.explosion !== undefined) {
+        if (!Array.isArray(raw.explosion) || raw.explosion.length === 0) {
+            out.errors.push('payload.sounds.explosion must be a non-empty array');
+        }
+        else {
+            raw.explosion.forEach((s, i) => checkSoundRef(`payload.sounds.explosion[${i}]`, s, out));
+        }
+    }
+}
+/** Ballistics for `fire.kind: 'projectile'` — mirrors the engine's requireProjectile, optional fields included. */
+function checkProjectile(raw, out) {
+    if (!isRecord(raw)) {
+        out.errors.push("payload.projectile is missing — fire.kind 'projectile' requires it");
+        return;
+    }
+    for (const key of ['speedMps', 'blastRadiusM', 'maxRangeM']) {
+        if (!isFiniteNumber(raw[key]) || raw[key] <= 0)
+            out.errors.push(`payload.projectile.${key} must be a finite number > 0`);
+    }
+    if (raw.gravityMps2 !== undefined && (!isFiniteNumber(raw.gravityMps2) || raw.gravityMps2 < 0)) {
+        out.errors.push('payload.projectile.gravityMps2 must be a finite number >= 0');
+    }
+    if (raw.radiusM !== undefined && (!isFiniteNumber(raw.radiusM) || raw.radiusM <= 0)) {
+        out.errors.push('payload.projectile.radiusM must be a finite number > 0');
+    }
+}
+/** Release for `fire.kind: 'thrown'` — mirrors the engine's requireThrown, `upBias` optional. */
+function checkThrown(raw, out) {
+    if (!isRecord(raw)) {
+        out.errors.push("payload.thrown is missing — fire.kind 'thrown' requires it");
+        return;
+    }
+    if (!isFiniteNumber(raw.releaseS) || raw.releaseS < 0)
+        out.errors.push('payload.thrown.releaseS must be a finite number >= 0');
+    if (!isFiniteNumber(raw.speedMps) || raw.speedMps <= 0)
+        out.errors.push('payload.thrown.speedMps must be a finite number > 0');
+    if (raw.upBias !== undefined && !isFiniteNumber(raw.upBias))
+        out.errors.push('payload.thrown.upBias must be a finite number');
+}
+/** The published payload is fully resolved, so spread must be complete — including >=2-key heat curves
+ *  (a single key silently pins heat to that key's x; the engine hard-fails on it). */
+function checkSpread(raw, out) {
+    if (!isRecord(raw)) {
+        out.errors.push('payload.spread is missing — published payloads are fully resolved and must carry it');
+        return;
+    }
+    for (const key of ['exponent', 'recoveryDelayS', 'adsMul', 'moveAddDeg', 'airAddDeg', 'landAddDeg', 'crouchMul']) {
+        if (!isFiniteNumber(raw[key]))
+            out.errors.push(`payload.spread.${key} must be a finite number`);
+    }
+    if (!isCurve(raw.heatToSpreadDeg, 2))
+        out.errors.push('payload.spread.heatToSpreadDeg must be a [t,v] curve with at least 2 keys');
+    if (!isCurve(raw.heatPerShot, 1) || !isCurve(raw.coolPerSecond, 1))
+        out.errors.push('payload.spread heat/cool curves must be [t,v] arrays');
+}
+function checkPayload(payload, out) {
+    const fire = payload.fire;
+    if (!isRecord(fire) || !isFiniteNumber(fire.rpm) || fire.rpm <= 0 || !FIRE_MODES.has(fire.mode)) {
+        out.errors.push("payload.fire must be { rpm > 0, mode: 'auto' | 'semi' }");
+    }
+    // Absent = hitscan, the shape every generated weapon carries; the other two kinds each require their block.
+    const kind = isRecord(fire) ? fire.kind ?? 'hitscan' : 'hitscan';
+    if (!FIRE_KINDS.has(kind)) {
+        out.errors.push(`payload.fire.kind '${String(kind)}' is not 'hitscan' | 'projectile' | 'thrown'`);
+    }
+    if (kind === 'projectile')
+        checkProjectile(payload.projectile, out);
+    if (kind === 'thrown')
+        checkThrown(payload.thrown, out);
+    const ammo = payload.ammo;
+    if (!isRecord(ammo) || !Number.isInteger(ammo.clip) || !Number.isInteger(ammo.reserve)) {
+        out.errors.push('payload.ammo must carry integer clip/reserve');
+    }
+    const damage = payload.damage;
+    if (!isRecord(damage) || !isFiniteNumber(damage.base))
+        out.errors.push('payload.damage.base must be a finite number');
+    if (typeof payload.category !== 'string' || payload.category.length === 0)
+        out.errors.push('payload.category is missing');
+    if (payload.grip !== undefined && payload.grip !== 'one-handed' && payload.grip !== 'two-handed') {
+        out.errors.push(`payload.grip '${String(payload.grip)}' is not a handedness`);
+    }
+    const fx = payload.fx;
+    if (!isRecord(fx)) {
+        out.errors.push('payload.fx is missing');
+    }
+    else {
+        if (fx.shell !== undefined && !SHELL_CLASSES.has(fx.shell)) {
+            out.errors.push(`payload.fx.shell '${String(fx.shell)}' is not a shell class (${[...SHELL_CLASSES].join(', ')})`);
+        }
+        for (const point of ['shellEjectM', 'muzzlePointM']) {
+            if (fx[point] !== undefined && !isVec3(fx[point]))
+                out.errors.push(`payload.fx.${point} must be a [x,y,z] triple`);
+        }
+    }
+    const hold = payload.hold;
+    if (hold !== undefined) {
+        if (!isRecord(hold)) {
+            out.errors.push('payload.hold is not an object');
+        }
+        else {
+            for (const key of ['positionM', 'rotationDeg']) {
+                if (hold[key] !== undefined && !isVec3(hold[key]))
+                    out.errors.push(`payload.hold.${key} must be a [x,y,z] triple`);
+            }
+        }
+    }
+    for (const section of ['ads', 'sway']) {
+        if (payload[section] !== undefined && !isRecord(payload[section]))
+            out.errors.push(`payload.${section} is not an object`);
+    }
+    const gunConfig = payload.gunConfig;
+    if (gunConfig !== undefined) {
+        if (!isRecord(gunConfig)) {
+            out.errors.push('payload.gunConfig is not an object');
+        }
+        else {
+            for (const denied of exports.DENIED_GUN_CONFIG_KEYS) {
+                if (denied in gunConfig)
+                    out.errors.push(`payload.gunConfig.${denied} is not an item's to set`);
+            }
+            for (const [key, value] of Object.entries(gunConfig)) {
+                const t = typeof value;
+                if (t !== 'number' && t !== 'string' && t !== 'boolean')
+                    out.errors.push(`payload.gunConfig.${key} must be a primitive`);
+            }
+        }
+    }
+    checkSpread(payload.spread, out);
+    checkSounds(payload.sounds, out);
+}
+/**
+ * Run the engine installer's structural rules over a parsed descriptor. Collects every violation instead of
+ * throwing on the first (the engine fails fast; a validator reports the full list). The manifest's own
+ * schema validation is a separate pass — this covers only what the engine enforces on top of it.
+ */
+function checkGunConfigRules(input) {
+    const out = { errors: [], warnings: [], relativeSoundRefs: [], meshRef: null };
+    if (!isRecord(input)) {
+        out.errors.push('descriptor is not an object');
+        return out;
+    }
+    if (input.schemaVersion !== 1)
+        out.errors.push(`unsupported schemaVersion ${String(input.schemaVersion)} — this system reads schemaVersion 1`);
+    const identity = input.identity;
+    if (!isRecord(identity) || typeof identity.id !== 'string' || identity.id.length === 0)
+        out.errors.push('identity.id is missing');
+    const compatibility = input.compatibility;
+    if (!isRecord(compatibility) || !isRecord(compatibility.system)) {
+        out.errors.push('compatibility.system is missing');
+    }
+    else {
+        const system = compatibility.system;
+        if (typeof system.id !== 'string' || system.id.length === 0 || typeof system.range !== 'string' || system.range.length === 0) {
+            out.errors.push('compatibility.system must carry { id, range }');
+        }
+    }
+    const held = input.held;
+    if (!isRecord(held)) {
+        out.errors.push('a weapon item must declare the held capability block');
+    }
+    else if (held.preset !== undefined && !exports.HELD_ITEM_PRESET_NAMES.includes(held.preset)) {
+        out.errors.push(`held.preset '${String(held.preset)}' is not a known preset (${exports.HELD_ITEM_PRESET_NAMES.join(', ')})`);
+    }
+    const assets = isRecord(input.assets) ? input.assets : undefined;
+    const meshes = assets && Array.isArray(assets.meshes) ? assets.meshes : [];
+    const mesh = meshes[0];
+    if (mesh === undefined) {
+        out.errors.push('assets.meshes[0] is missing — a weapon ships exactly one prop mesh');
+    }
+    else if (typeof mesh === 'string' && mesh.length > 0) {
+        if (isWindowsAbsolute(mesh) || mesh.startsWith('/')) {
+            out.errors.push(`assets.meshes[0] '${mesh}' is an absolute path — use a path relative to the descriptor`);
+        }
+        else {
+            out.meshRef = mesh;
+        }
+    }
+    else if (isVaultRefObject(mesh)) {
+        out.meshRef = mesh;
+    }
+    else {
+        out.errors.push('assets.meshes[0] must be a descriptor-relative path (pre-publish) or a pinned {assetId, version, checksumSha256} ref');
+    }
+    const configFor = input.configFor;
+    const payload = isRecord(configFor) ? configFor['gun-control'] : undefined;
+    if (payload === undefined) {
+        // The engine warns and installs such a descriptor cosmetically; this lane refuses it. Only the
+        // gun-control payload's sound paths are collected, so a payload under any other key publishes an
+        // immutable version whose refs were never uploaded — dead audio, discovered in-world.
+        out.errors.push('no configFor["gun-control"] payload — `item-def` is the weapon lane: put the profile under "gun-control" ' +
+            '(a payload under any other key has its sound refs silently dropped at publish)');
+        return out;
+    }
+    if (!isRecord(payload)) {
+        out.errors.push('configFor["gun-control"] is not an object');
+        return out;
+    }
+    const id = isRecord(identity) && typeof identity.id === 'string' ? identity.id : '';
+    if (typeof payload.weapon === 'string' && id !== '' && payload.weapon.toLowerCase() !== id.toLowerCase()) {
+        out.warnings.push(`payload.weapon '${payload.weapon}' is ignored at install — the registry key is identity.id`);
+    }
+    checkPayload(payload, out);
+    return out;
+}
+//# sourceMappingURL=gunConfigRules.js.map

package/dist/itemDef/gunConfigRules.js.map

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

package/dist/itemDef/inspect.d.ts

@@ -0,0 +1,19 @@
+export declare const VAULT_ASSETS_PATH = "/api/v1/vault/assets";
+/** The transport slice inspect needs; tests inject fakes for both. */
+export type ItemDefInspectApi = {
+    request<T>(method: string, path: string): Promise<T>;
+};
+export type FetchText = (url: string) => Promise<string>;
+export type ItemDefInspectResult = {
+    assetId: string;
+    version: number;
+    kind: string | undefined;
+    official?: boolean;
+    descriptor: Record<string, unknown>;
+};
+export declare function parseAssetRef(raw: string): {
+    assetId: string;
+    version: number | null;
+};
+export declare function inspectItemDef(api: ItemDefInspectApi, fetchText: FetchText, ref: string): Promise<ItemDefInspectResult>;
+export declare function formatItemDefInspect(result: ItemDefInspectResult): string;

package/dist/itemDef/inspect.js

@@ -0,0 +1,144 @@
+"use strict";
+// `helix item-def inspect` — the public resolve of a published interactive item definition (a weapon's
+// numbers, an emote's clip + playback), printed as what an author tunes against. Read-only; works logged
+// out (public assets resolve anonymously).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VAULT_ASSETS_PATH = void 0;
+exports.parseAssetRef = parseAssetRef;
+exports.inspectItemDef = inspectItemDef;
+exports.formatItemDefInspect = formatItemDefInspect;
+exports.VAULT_ASSETS_PATH = '/api/v1/vault/assets';
+function parseAssetRef(raw) {
+    const at = raw.lastIndexOf('@');
+    if (at <= 0)
+        return { assetId: raw, version: null };
+    const version = Number(raw.slice(at + 1));
+    if (!Number.isInteger(version) || version < 1) {
+        throw new Error(`'${raw.slice(at + 1)}' is not a version — use <assetId>@<integer >= 1>`);
+    }
+    return { assetId: raw.slice(0, at), version };
+}
+async function inspectItemDef(api, fetchText, ref) {
+    const { assetId, version } = parseAssetRef(ref);
+    const detail = await api.request('GET', `${exports.VAULT_ASSETS_PATH}/${encodeURIComponent(assetId)}`);
+    if (detail.kind !== undefined && detail.kind !== 'interactive_item') {
+        throw new Error(`asset ${assetId} is kind '${detail.kind}', not an interactive_item definition`);
+    }
+    let resolvedVersion = detail.artifact.version;
+    let url = detail.artifact.url;
+    if (version !== null && version !== detail.artifact.version) {
+        const versions = await api.request('GET', `${exports.VAULT_ASSETS_PATH}/${encodeURIComponent(assetId)}/versions`);
+        const match = versions.items.find((v) => v.version === version);
+        if (match === undefined)
+            throw new Error(`asset ${assetId} has no version ${version}`);
+        resolvedVersion = match.version;
+        url = match.url;
+    }
+    if (!url)
+        throw new Error(`asset ${assetId}@${resolvedVersion} has no downloadable artifact URL (is it public?)`);
+    let descriptor;
+    try {
+        descriptor = JSON.parse(await fetchText(url));
+    }
+    catch (err) {
+        throw new Error(`could not read the descriptor at ${url}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return { assetId, version: resolvedVersion, kind: detail.kind, official: detail.official, descriptor };
+}
+const get = (obj, ...path) => {
+    let cur = obj;
+    for (const key of path) {
+        if (typeof cur !== 'object' || cur === null)
+            return undefined;
+        cur = cur[key];
+    }
+    return cur;
+};
+/** A pinned asset ref as one line, in either form a descriptor can carry it. */
+const refSummary = (ref) => {
+    if (typeof ref === 'string')
+        return `${ref} (unpublished relative ref)`;
+    if (ref === undefined || ref === null)
+        return '(none)';
+    return `vault ${String(get(ref, 'assetId'))}@${String(get(ref, 'version'))}`;
+};
+const soundKindOf = (ref) => {
+    if (typeof ref !== 'string')
+        return '?';
+    if (ref.startsWith('vault:'))
+        return 'vault';
+    if (/^https?:\/\//i.test(ref))
+        return 'url';
+    return 'relative';
+};
+function formatItemDefInspect(result) {
+    const d = result.descriptor;
+    const lines = [];
+    const id = get(d, 'identity', 'id') ?? '?';
+    const semver = get(d, 'identity', 'version') ?? '?';
+    const title = get(d, 'identity', 'title') ?? '?';
+    lines.push(`${String(title)} — ${String(id)}@${String(semver)} (vault ${result.assetId}@${result.version})` +
+        (result.official === true ? ' · OFFICIAL' : ''));
+    const system = get(d, 'compatibility', 'system');
+    if (system !== undefined) {
+        lines.push(`  system: ${String(get(system, 'id'))} ${String(get(system, 'range'))}` +
+            (get(d, 'compatibility', 'skeleton') !== undefined ? ` · skeleton ${String(get(d, 'compatibility', 'skeleton'))}` : ''));
+    }
+    const emote = get(d, 'emote');
+    const payload = get(d, 'configFor', 'gun-control');
+    if (payload === undefined) {
+        if (emote === undefined)
+            lines.push('  no gun-control payload — a cosmetic held item (attaches, never shoots)');
+    }
+    else {
+        const grip = payload.grip ?? '(category default)';
+        lines.push(`  category: ${String(payload.category)} · preset ${String(get(d, 'held', 'preset') ?? '(none)')} · grip ${String(grip)}`);
+        lines.push(`  fire: ${String(get(payload, 'fire', 'rpm'))} rpm ${String(get(payload, 'fire', 'mode'))} · ammo ${String(get(payload, 'ammo', 'clip'))}/${String(get(payload, 'ammo', 'reserve'))}`);
+        const base = get(payload, 'damage', 'base');
+        const pellets = get(payload, 'damage', 'pellets');
+        const falloff = get(payload, 'damage', 'falloffM');
+        const falloffSummary = Array.isArray(falloff) && falloff.length > 0
+            ? `${falloff.length} falloff point(s), first at ${String(falloff[0][0])} m`
+            : 'no falloff (flat to max range)';
+        lines.push(`  damage: ${String(base)} × ${String(pellets)} pellet(s) · ${falloffSummary} · max range ${String(get(payload, 'damage', 'maxRangeM'))} m`);
+        const spread = payload.spread;
+        if (spread !== undefined) {
+            const curve = spread.heatToSpreadDeg;
+            const curveSummary = Array.isArray(curve) && curve.length > 0
+                ? `${String(curve[0][1])}°→${String(curve[curve.length - 1][1])}° over heat (${curve.length} keys)`
+                : 'no heat curve';
+            lines.push(`  spread: ${curveSummary} · ads ×${String(spread.adsMul)} · move +${String(spread.moveAddDeg)}° · crouch ×${String(spread.crouchMul)}` +
+                (spread.firstShotAccuracy === true ? ` · exact first shot${spread.firstShotNeedsAds === true ? ' (ADS)' : ''}` : ''));
+        }
+        const shots = get(payload, 'sounds', 'shots');
+        const reload = get(payload, 'sounds', 'reload');
+        const shotCount = Array.isArray(shots) ? shots.length : 0;
+        const stageCount = (stage) => {
+            const cues = get(reload, stage);
+            return Array.isArray(cues) ? cues.length : 0;
+        };
+        const form = Array.isArray(shots) && shots.length > 0 ? soundKindOf(shots[0]) : '?';
+        lines.push(`  sounds: ${shotCount} shot(s) · dry ${get(payload, 'sounds', 'dry') !== undefined ? 'yes' : 'no'} · reload ${stageCount('out')}/${stageCount('in')}/${stageCount('charge')} (out/in/charge) · refs ${form}`);
+    }
+    if (emote !== undefined) {
+        const audio = get(d, 'assets', 'audio');
+        const audioCount = Array.isArray(audio) ? audio.length : 0;
+        lines.push(`  emote: playback ${String(emote.playback ?? 'oneshot')}${audioCount > 0 ? ` · ${audioCount} audio ref(s)` : ''}`);
+        lines.push(`  clip: ${refSummary(emote.clip)}`);
+        const joiner = get(emote, 'roles', 'joiner');
+        if (joiner !== undefined) {
+            const offset = get(joiner, 'offset');
+            const offerAtS = get(emote, 'roles', 'offerAtS');
+            lines.push(`  joiner: ${refSummary(get(joiner, 'clip'))} @ x ${String(get(offset, 'x'))} m, z ${String(get(offset, 'z'))} m, ` +
+                `yaw ${String(get(offset, 'yawDeg'))}° · offer held at ${typeof offerAtS === 'number' ? offerAtS.toFixed(2) : '0.00'}s (paired emote)`);
+        }
+    }
+    const mesh = get(d, 'assets', 'meshes');
+    const meshRef = Array.isArray(mesh) ? mesh[0] : undefined;
+    if (typeof meshRef === 'string')
+        lines.push(`  mesh: ${meshRef} (unpublished relative ref)`);
+    else if (meshRef !== undefined)
+        lines.push(`  mesh: vault ${String(get(meshRef, 'assetId'))}@${String(get(meshRef, 'version'))}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=inspect.js.map

package/dist/itemDef/inspect.js.map

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

package/dist/itemDef/scaffold.d.ts

@@ -0,0 +1,41 @@
+export type MeshPrecheck = {
+    sizeBytes: number;
+    materialCount: number | null;
+    warnings: string[];
+};
+/**
+ * Cheap GLB sniff: header magic/version plus the JSON chunk's material count. WARN-only by design —
+ * the caps are the server's (env-overridable), so a wrong local verdict must never block.
+ */
+export declare function meshPrecheck(bytes: Buffer, label: string): MeshPrecheck;
+/** Slug an id out of a title / mesh basename the way the descriptor's id pattern demands. */
+export declare function deriveItemId(raw: string): string;
+/** The item types the lane scaffolds. The type decides which flags apply — a weapon has no clip, an emote no category. */
+export declare const ITEM_DEF_TYPES: readonly ["weapon", "emote"];
+export type ItemDefType = (typeof ITEM_DEF_TYPES)[number];
+export type ScaffoldInput = {
+    /** 'weapon' (the default) or 'emote'. */
+    type?: string;
+    /** WEAPON: the prop mesh + its archetype. */
+    mesh?: string;
+    category?: string;
+    sounds?: string;
+    /** EMOTE: the animation clip + how it plays, and optionally one .ogg the performance carries. */
+    clip?: string;
+    playback?: string;
+    audio?: string;
+    /** EMOTE: the optional enter/exit transition clips the body clip is chained between. */
+    introClip?: string;
+    outroClip?: string;
+    title?: string;
+    out?: string;
+};
+export type ScaffoldResult = {
+    descriptorPath: string;
+    descriptor: Record<string, unknown>;
+    /** Files copied into `<out>/sounds/`, descriptor-relative. */
+    copiedSounds: string[];
+    warnings: string[];
+    nextSteps: string[];
+};
+export declare function scaffoldItemDef(input: ScaffoldInput): ScaffoldResult;