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

package/dist/character/fbx.js

@@ -0,0 +1,396 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withInertDomForFbxParse = withInertDomForFbxParse;
+exports.normalizeFbxHumanoidSpace = normalizeFbxHumanoidSpace;
+exports.normalizeRepeatedMorphTargets = normalizeRepeatedMorphTargets;
+exports.convertFbxUvsToGltf = convertFbxUvsToGltf;
+exports.sanitizeInvalidMaterialTextures = sanitizeInvalidMaterialTextures;
+exports.convertFbxToGlb = convertFbxToGlb;
+const promises_1 = require("node:fs/promises");
+const node_buffer_1 = require("node:buffer");
+const esm_1 = require("./esm");
+class NodeFileReader {
+    result = null;
+    onloadend = null;
+    readAsArrayBuffer(blob) {
+        void blob.arrayBuffer().then((value) => {
+            this.result = value;
+            this.onloadend?.();
+        });
+    }
+    readAsDataURL(blob) {
+        void blob.arrayBuffer().then((value) => {
+            this.result = `data:${blob.type};base64,${node_buffer_1.Buffer.from(value).toString('base64')}`;
+            this.onloadend?.();
+        });
+    }
+}
+function ensureFileReader() {
+    const host = globalThis;
+    host.FileReader ??= NodeFileReader;
+}
+/**
+ * FBXLoader decodes embedded images with `window.URL.createObjectURL` and `ImageLoader`'s
+ * `document.createElementNS('img')`, neither of which exists in Node, so any FBX that embeds a texture
+ * (Meshy text-to-motion clips ship a textured preview body) died with "window is not defined" before
+ * a single bone was read. Texture pixels are never part of the retarget input, so provide inert
+ * stand-ins for the duration of the parse: the images never load, and sanitizeInvalidMaterialTextures
+ * then drops every texture slot that has no exportable image.
+ */
+function withInertDomForFbxParse(run) {
+    const host = globalThis;
+    const installed = [];
+    if (host.window === undefined) {
+        host.window = { URL, innerWidth: 1, innerHeight: 1 };
+        installed.push('window');
+    }
+    if (host.document === undefined) {
+        host.document = {
+            createElementNS: () => ({
+                addEventListener: () => undefined,
+                removeEventListener: () => undefined,
+                set src(_value) {
+                    /* never loads */
+                },
+            }),
+        };
+        installed.push('document');
+    }
+    try {
+        return run();
+    }
+    finally {
+        for (const key of installed)
+            delete host[key];
+    }
+}
+function hasExportableImage(texture) {
+    const image = texture.image;
+    if (!image || typeof image !== 'object')
+        return false;
+    const dataImage = image;
+    if (dataImage.data !== undefined) {
+        const data = dataImage.data;
+        const length = ArrayBuffer.isView(data)
+            ? data.byteLength
+            : Array.isArray(data)
+                ? data.length
+                : 0;
+        return length > 0
+            && Number.isFinite(dataImage.width)
+            && Number(dataImage.width) > 0
+            && Number.isFinite(dataImage.height)
+            && Number(dataImage.height) > 0;
+    }
+    const host = globalThis;
+    return ['HTMLImageElement', 'HTMLCanvasElement', 'ImageBitmap', 'OffscreenCanvas']
+        .some((name) => {
+        const constructor = host[name];
+        return typeof constructor === 'function'
+            && image instanceof constructor;
+    });
+}
+function sameAttribute(left, right) {
+    if (left.itemSize !== right.itemSize
+        || left.count !== right.count
+        || left.normalized !== right.normalized
+        || left.name !== right.name
+        || left.array.constructor !== right.array.constructor
+        || left.array.byteLength !== right.array.byteLength) {
+        return false;
+    }
+    return node_buffer_1.Buffer.compare(node_buffer_1.Buffer.from(left.array.buffer, left.array.byteOffset, left.array.byteLength), node_buffer_1.Buffer.from(right.array.buffer, right.array.byteOffset, right.array.byteLength)) === 0;
+}
+function semanticBoneName(name) {
+    return name.toLowerCase().replace(/^mixamorig[:_]?/, '').replace(/[^a-z0-9]/g, '');
+}
+/**
+ * FBXLoader preserves Unreal's Z-up centimeter scene coordinates, while glTF
+ * consumers require Y-up meters. Infer the conversion only from a recognized
+ * humanoid chain so ordinary Y-up FBX characters remain unchanged. The
+ * transform is kept on the exported scene root; conformToHelixRest bakes each
+ * skinned mesh's world transform before replacing the source rig.
+ */
+function normalizeFbxHumanoidSpace(root) {
+    root.updateWorldMatrix(true, true);
+    const bones = new Map();
+    root.traverse((node) => {
+        if (node.isBone !== true)
+            return;
+        const name = semanticBoneName(node.name);
+        if (!bones.has(name))
+            bones.set(name, node);
+    });
+    const pelvis = bones.get('pelvis') ?? bones.get('hips');
+    const head = bones.get('head') ?? bones.get('neck01') ?? bones.get('neck');
+    const skeletonRoot = bones.get('root');
+    const lower = pelvis ?? skeletonRoot;
+    const upper = head ?? (pelvis !== undefined ? pelvis : undefined);
+    const referenceLower = head !== undefined && pelvis !== undefined ? pelvis : skeletonRoot;
+    if (lower === undefined || upper === undefined || referenceLower === undefined || upper === referenceLower) {
+        throw new Error('FBX conversion: cannot determine humanoid coordinates; expected a root/pelvis and pelvis/head bone span.');
+    }
+    const a = referenceLower.matrixWorld.elements;
+    const b = upper.matrixWorld.elements;
+    const delta = [b[12] - a[12], b[13] - a[13], b[14] - a[14]];
+    const referenceSpan = Math.hypot(...delta);
+    if (!Number.isFinite(referenceSpan) || referenceSpan <= 1e-6) {
+        throw new Error('FBX conversion: humanoid coordinate reference span is degenerate.');
+    }
+    const dominant = delta
+        .map((value, index) => [Math.abs(value), index])
+        .sort((left, right) => right[0] - left[0])[0][1];
+    const sourceUpAxis = ['x', 'y', 'z'][dominant];
+    if (sourceUpAxis === 'x') {
+        throw new Error('FBX conversion: X-up humanoid coordinates are not supported; export as Y-up or Unreal Z-up.');
+    }
+    const unitScale = referenceSpan > 10 ? 0.01 : 1;
+    const rotationXDegrees = sourceUpAxis === 'z' ? -90 : 0;
+    if (rotationXDegrees !== 0)
+        root.rotateX(-Math.PI / 2);
+    if (unitScale !== 1)
+        root.scale.multiplyScalar(unitScale);
+    root.updateWorldMatrix(true, true);
+    return { sourceUpAxis, rotationXDegrees, unitScale, referenceSpan };
+}
+/**
+ * FBXLoader can attach the same named blend shapes repeatedly when one Unreal
+ * skeletal mesh contains several material sections. Collapse only proven,
+ * byte-identical repetitions; ambiguous FBX morph data is rejected intact.
+ */
+function normalizeRepeatedMorphTargets(root) {
+    const normalized = [];
+    const trackRemaps = new Map();
+    let meshIndex = 0;
+    root.traverse((node) => {
+        if (node.isMesh !== true)
+            return;
+        const mesh = node;
+        const meshLabel = mesh.name || `Mesh#${meshIndex}`;
+        meshIndex += 1;
+        const morphAttributes = mesh.geometry.morphAttributes;
+        const semantics = Object.entries(morphAttributes)
+            .filter((entry) => Array.isArray(entry[1]) && entry[1].length > 0)
+            .sort(([left], [right]) => left.localeCompare(right));
+        if (semantics.length === 0)
+            return;
+        for (const [semantic, attributes] of semantics) {
+            if (attributes.some((attribute) => attribute.isBufferAttribute !== true)) {
+                throw new Error(`FBX conversion: ${meshLabel} morph ${semantic} uses unsupported interleaved arrays.`);
+            }
+        }
+        const primary = morphAttributes.position ?? semantics[0][1];
+        const dictionary = Object.entries(mesh.morphTargetDictionary ?? {});
+        if (primary.length === dictionary.length)
+            return;
+        if (primary.length < dictionary.length) {
+            throw new Error(`FBX conversion: ${meshLabel} has ${primary.length} morph arrays but ${dictionary.length} dictionary entries.`);
+        }
+        if (dictionary.length === 0 || primary.length % dictionary.length !== 0) {
+            throw new Error(`FBX conversion: ${meshLabel} has ${primary.length} morph arrays but ${dictionary.length} dictionary entries.`);
+        }
+        const repetitions = primary.length / dictionary.length;
+        const indicesByName = new Map();
+        primary.forEach((attribute, index) => {
+            const indices = indicesByName.get(attribute.name) ?? [];
+            indices.push(index);
+            indicesByName.set(attribute.name, indices);
+        });
+        const canonicalIndices = new Set();
+        for (const [name, index] of dictionary) {
+            if (!Number.isSafeInteger(index) || index < 0 || index >= primary.length) {
+                throw new Error(`FBX conversion: ${meshLabel} morph target ${name} has an invalid dictionary index.`);
+            }
+            if (canonicalIndices.has(index) || primary[index].name !== name) {
+                throw new Error(`FBX conversion: ${meshLabel} morph target dictionary is inconsistent at ${name}.`);
+            }
+            canonicalIndices.add(index);
+            if (indicesByName.get(name)?.length !== repetitions) {
+                throw new Error(`FBX conversion: ${meshLabel} morph target ${name} is not repeated uniformly.`);
+            }
+        }
+        if (indicesByName.size !== dictionary.length) {
+            throw new Error(`FBX conversion: ${meshLabel} morph arrays contain names absent from its dictionary.`);
+        }
+        for (const [semantic, attributes] of semantics) {
+            if (attributes.length !== primary.length) {
+                throw new Error(`FBX conversion: ${meshLabel} morph ${semantic} arrays do not align with position arrays.`);
+            }
+            for (const [name, canonicalIndex] of dictionary) {
+                const canonical = attributes[canonicalIndex];
+                for (const duplicateIndex of indicesByName.get(name)) {
+                    if (!sameAttribute(canonical, attributes[duplicateIndex])) {
+                        throw new Error(`FBX conversion: ${meshLabel} morph target ${name} has differing repeated ${semantic} arrays.`);
+                    }
+                }
+            }
+        }
+        const influences = mesh.morphTargetInfluences;
+        if (!influences || influences.length !== primary.length) {
+            throw new Error(`FBX conversion: ${meshLabel} morph influences do not align with its arrays.`);
+        }
+        for (const [name, canonicalIndex] of dictionary) {
+            for (const duplicateIndex of indicesByName.get(name)) {
+                if (!Object.is(influences[canonicalIndex], influences[duplicateIndex])) {
+                    throw new Error(`FBX conversion: ${meshLabel} morph target ${name} has differing repeated influences.`);
+                }
+            }
+        }
+        for (const [semantic, attributes] of semantics) {
+            morphAttributes[semantic] = dictionary.map(([, index]) => attributes[index]);
+        }
+        mesh.morphTargetDictionary = Object.fromEntries(dictionary.map(([name], index) => [name, index]));
+        mesh.morphTargetInfluences = dictionary.map(([, index]) => influences[index]);
+        if (trackRemaps.has(meshLabel)) {
+            throw new Error(`FBX conversion: repeated normalized mesh name ${meshLabel} makes morph animation tracks ambiguous.`);
+        }
+        const trackRemap = new Map();
+        dictionary.forEach(([name], index) => {
+            for (const oldIndex of indicesByName.get(name))
+                trackRemap.set(oldIndex, index);
+        });
+        trackRemaps.set(meshLabel, trackRemap);
+        const result = {
+            mesh: meshLabel,
+            before: primary.length,
+            after: dictionary.length,
+            repetitions,
+        };
+        normalized.push(result);
+        console.warn(`FBX conversion: normalized ${meshLabel} morph targets from ${result.before} repeated arrays to ${result.after} named targets.`);
+    });
+    for (const clip of root.animations) {
+        for (const track of clip.tracks) {
+            const match = /^(.*)\.morphTargetInfluences\[(\d+)]$/.exec(track.name);
+            if (!match)
+                continue;
+            const remap = trackRemaps.get(match[1]);
+            if (!remap)
+                continue;
+            const oldIndex = Number(match[2]);
+            const newIndex = remap.get(oldIndex);
+            if (newIndex === undefined) {
+                throw new Error(`FBX conversion: ${track.name} does not address a known repeated morph target.`);
+            }
+            track.name = `${match[1]}.morphTargetInfluences[${newIndex}]`;
+        }
+    }
+    return normalized;
+}
+/**
+ * Converts FBXLoader's texture coordinates to glTF's convention.
+ *
+ * FBX (like OpenGL) puts the UV origin at the bottom-left, and FBXLoader passes those values through
+ * untouched, relying on Three's `texture.flipY` to sample images correctly. glTF puts the origin at the
+ * top-left and has no flipY: GLTFExporter compensates by writing a vertically flipped copy of every
+ * flipY image, which is only correct for the images it exports itself. Images bound later — the Unreal
+ * material sidecar's top-down PNGs, or anything a later stage attaches — would sample a vertically
+ * mirrored spot, so a cap's crown panels land on the brim's gutter. Converting the coordinates here
+ * (v' = 1 - v) makes the converted GLB a normal glTF; inverting flipY on the textures GLTFExporter still
+ * exports keeps their sampling byte-for-byte what it was.
+ */
+function convertFbxUvsToGltf(root) {
+    const geometries = new Set();
+    const textures = new Set();
+    let attributes = 0;
+    root.traverse((node) => {
+        const mesh = node;
+        const geometry = mesh.geometry;
+        if (geometry !== undefined && geometry !== null && !geometries.has(geometry)) {
+            geometries.add(geometry);
+            for (const name of Object.keys(geometry.attributes).sort()) {
+                if (!/^uv\d*$/.test(name))
+                    continue;
+                const attribute = geometry.getAttribute(name);
+                if (attribute.itemSize < 2)
+                    continue;
+                for (let index = 0; index < attribute.count; index += 1) {
+                    attribute.setY(index, 1 - attribute.getY(index));
+                }
+                attribute.needsUpdate = true;
+                attributes += 1;
+            }
+        }
+        const candidate = node.material;
+        const materials = candidate ? (Array.isArray(candidate) ? candidate : [candidate]) : [];
+        for (const material of materials) {
+            const properties = material;
+            for (const slot of Object.keys(properties)) {
+                const value = properties[slot];
+                if (value?.isTexture !== true || textures.has(value))
+                    continue;
+                textures.add(value);
+                value.flipY = !value.flipY;
+            }
+        }
+    });
+    return { geometries: geometries.size, attributes, textures: textures.size };
+}
+/** Removes only texture slots that Three's GLTFExporter cannot encode. */
+function sanitizeInvalidMaterialTextures(root) {
+    const dropped = [];
+    const visited = new Set();
+    let materialIndex = 0;
+    root.traverse((node) => {
+        const candidate = node.material;
+        const materials = candidate ? (Array.isArray(candidate) ? candidate : [candidate]) : [];
+        for (const material of materials) {
+            if (visited.has(material))
+                continue;
+            visited.add(material);
+            const materialLabel = material.name || `${material.type}#${materialIndex}`;
+            materialIndex += 1;
+            const properties = material;
+            for (const slot of Object.keys(properties).sort()) {
+                const value = properties[slot];
+                if (value?.isTexture !== true || hasExportableImage(value))
+                    continue;
+                properties[slot] = null;
+                material.needsUpdate = true;
+                const binding = {
+                    material: materialLabel,
+                    slot,
+                    texture: value.name || '<unnamed>',
+                };
+                dropped.push(binding);
+                console.warn(`FBX conversion: dropped invalid texture ${binding.material}.${binding.slot} (${binding.texture}).`);
+            }
+        }
+    });
+    return dropped;
+}
+/**
+ * Deterministically converts an FBX into the same binary glTF input consumed by
+ * the character retarget stages. Keeping this inside the published CLI closes
+ * the previous hidden dependency on a DCC export before `character import`.
+ */
+async function convertFbxToGlb(path) {
+    const [{ FBXLoader }, { GLTFExporter }] = await Promise.all([
+        (0, esm_1.importEsm)('three/examples/jsm/loaders/FBXLoader.js'),
+        (0, esm_1.importEsm)('three/examples/jsm/exporters/GLTFExporter.js'),
+    ]);
+    const bytes = await (0, promises_1.readFile)(path);
+    const arrayBuffer = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+    const root = withInertDomForFbxParse(() => new FBXLoader().parse(arrayBuffer, ''));
+    const space = normalizeFbxHumanoidSpace(root);
+    if (space.rotationXDegrees !== 0 || space.unitScale !== 1) {
+        console.warn(`FBX conversion: normalized ${space.sourceUpAxis.toUpperCase()}-up humanoid coordinates ` +
+            `by X ${space.rotationXDegrees}° and scale ${space.unitScale}.`);
+    }
+    normalizeRepeatedMorphTargets(root);
+    sanitizeInvalidMaterialTextures(root);
+    convertFbxUvsToGltf(root);
+    const animations = root.animations.filter((clip) => clip.tracks.length > 0);
+    ensureFileReader();
+    const exported = await new GLTFExporter().parseAsync(root, {
+        animations,
+        binary: true,
+        onlyVisible: false,
+        trs: true,
+    });
+    if (!(exported instanceof ArrayBuffer)) {
+        throw new Error('FBX conversion did not produce a binary glTF');
+    }
+    return new Uint8Array(exported);
+}
+//# sourceMappingURL=fbx.js.map

package/dist/character/fbx.js.map

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

package/dist/character/fitGarmentFile.d.ts

@@ -0,0 +1,39 @@
+import { type EarClearanceOptions, type EarClearanceReport } from './stages/earClearance';
+import { type PoseAwareFitOptions, type PoseAwareFitReport } from './stages/poseAwareFit';
+/**
+ * File-level entry point for the pose-aware fit stage used by `helix character fit`
+ * on an already-packaged add-on GLB (every LOD level).
+ *
+ * Output contract, so a batch driver never has to guess:
+ *   - outcome 'improved': `output` holds the fitted GLB (only POSITION data differs from the input).
+ *   - any other outcome: `output` is a BYTE-IDENTICAL copy of the input — the gate kept the original.
+ *
+ * Head-zone slots (headwear, mask, hair, eyewear) get a second stage after the pose-aware fit: ear clearance
+ * (`stages/earClearance.ts`) — the pose-aware fit cannot work on a thin head shell, and the ears poking through
+ * it is what the visual-QA gate fails them for. It runs automatically for those slot types, or on demand with
+ * `earClearance: true`; `earClearance: false` turns it off. `fitted` is true when EITHER stage improved the mesh.
+ */
+export interface FitGarmentFileOptions extends Omit<PoseAwareFitOptions, 'hiddenRegions'> {
+    garment: string;
+    body: string;
+    output: string;
+    /** Region scope. Exactly one of `slotType` / `hiddenRegions` should be given; `hiddenRegions: []` is an
+     *  explicit, deliberate unscoped fit. */
+    slotType?: string;
+    hiddenRegions?: readonly string[];
+    /** Also write the report JSON here. */
+    reportPath?: string;
+    /** Ear-clearance stage: undefined = on for head-zone slot types only; true = always; false = never. */
+    earClearance?: boolean;
+    earClearanceOptions?: EarClearanceOptions;
+}
+export interface FitGarmentFileResult {
+    report: PoseAwareFitReport;
+    /** The ear-clearance stage's report; null when the stage did not run. */
+    ears: EarClearanceReport | null;
+    output: string;
+    /** True when `output` is the fitted geometry; false when it is a byte-identical copy of the input. */
+    fitted: boolean;
+}
+export declare function resolveFitScope(slotType: string | undefined, hiddenRegions: readonly string[] | undefined): string[];
+export declare function fitGarmentFile(opts: FitGarmentFileOptions): Promise<FitGarmentFileResult>;

package/dist/character/fitGarmentFile.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFitScope = resolveFitScope;
+exports.fitGarmentFile = fitGarmentFile;
+const core_1 = require("@gltf-transform/core");
+const extensions_1 = require("@gltf-transform/extensions");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const meshoptimizer_1 = require("meshoptimizer");
+const bodyRegionHide_1 = require("./bodyRegionHide");
+const earClearance_1 = require("./stages/earClearance");
+const poseAwareFit_1 = require("./stages/poseAwareFit");
+function resolveFitScope(slotType, hiddenRegions) {
+    if (hiddenRegions !== undefined)
+        return [...hiddenRegions];
+    if (slotType !== undefined) {
+        if (!/^character\.[a-z][a-z0-9-]*@1$/.test(slotType))
+            throw new Error(`fit: --slot-type must be a character.<slot>@1 slot type (got '${slotType}')`);
+        return [...(0, bodyRegionHide_1.defaultHideRegionsForSlotType)(slotType)];
+    }
+    throw new Error('fit: pass --slot-type <character.x@1> or --hidden-regions <globs|none> — the fit and its gate must be scoped exactly like the poke-through check they are judged by');
+}
+async function fitGarmentFile(opts) {
+    for (const [flag, path] of [['garment', opts.garment], ['body', opts.body]]) {
+        if (!(0, node_fs_1.existsSync)(path))
+            throw new Error(`fit: ${flag} GLB not found: ${path}`);
+    }
+    const hiddenRegions = resolveFitScope(opts.slotType, opts.hiddenRegions);
+    await Promise.all([meshoptimizer_1.MeshoptDecoder.ready, meshoptimizer_1.MeshoptEncoder.ready]);
+    const io = new core_1.NodeIO()
+        .registerExtensions(extensions_1.ALL_EXTENSIONS)
+        .registerDependencies({ 'meshopt.decoder': meshoptimizer_1.MeshoptDecoder, 'meshopt.encoder': meshoptimizer_1.MeshoptEncoder });
+    const garmentBytes = (0, node_fs_1.readFileSync)(opts.garment);
+    const garment = await io.readBinary(garmentBytes);
+    const body = await io.read(opts.body);
+    const { garment: _g, body: _b, output: _o, slotType: _s, reportPath: _r, earClearance: _e, earClearanceOptions: _eo, ...stageOptions } = opts;
+    const report = (0, poseAwareFit_1.poseAwareFit)(garment, body, { ...stageOptions, hiddenRegions });
+    const runEars = opts.earClearance ?? (opts.slotType !== undefined && (0, earClearance_1.isEarRelevantSlotType)(opts.slotType));
+    const ears = runEars ? (0, earClearance_1.clearEars)(garment, body, { onProgress: opts.onProgress, ...opts.earClearanceOptions }) : null;
+    const output = (0, node_path_1.resolve)(opts.output);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(output), { recursive: true });
+    const fitted = report.outcome === 'improved' || ears?.outcome === 'improved';
+    if (fitted)
+        (0, node_fs_1.writeFileSync)(output, await io.writeBinary(garment));
+    else if ((0, node_path_1.resolve)(opts.garment) !== output)
+        (0, node_fs_1.copyFileSync)(opts.garment, output);
+    if (opts.reportPath !== undefined) {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)((0, node_path_1.resolve)(opts.reportPath)), { recursive: true });
+        (0, node_fs_1.writeFileSync)(opts.reportPath, `${JSON.stringify({ garment: opts.garment, body: opts.body, output, fitted, ...report, ears }, null, 2)}\n`);
+    }
+    return { report, ears, output, fitted };
+}
+//# sourceMappingURL=fitGarmentFile.js.map

package/dist/character/fitGarmentFile.js.map

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

package/dist/character/helixPalette.d.ts

@@ -0,0 +1,68 @@
+import type { Document } from '@gltf-transform/core';
+export declare const HELIX_PALETTE_CONTRACT: "helix-palette/3";
+export declare const HELIX_MATERIAL_BINDING_CONTRACT: "helix-material-binding/1";
+export interface HelixPaletteSelection {
+    action: 'forceFamilyId';
+    familyId: string;
+    familyVersion: string;
+    presetId: string | null;
+    overrides: {
+        tint?: string;
+        roughness?: number;
+        metallic?: number;
+    };
+}
+export interface HelixMaterialBinding {
+    contract: typeof HELIX_MATERIAL_BINDING_CONTRACT;
+    familyId: string;
+    familyVersion: string;
+    presetId: string | null;
+    overrides: HelixPaletteSelection['overrides'];
+    uv: {
+        uvSet: number;
+        offset: [number, number];
+        scale: [number, number];
+        rotationRadians: number;
+        physicalSizeMeters: [number, number] | null;
+    };
+    preserved: {
+        identityBearingDetails: boolean;
+        sourceMaterialId: string | null;
+        maskBindings: [];
+        decals: [];
+    };
+    renderState: {
+        alphaMode: 'opaque' | 'mask' | 'blend';
+        alphaCutoff: number;
+        doubleSided: boolean;
+        depthWrite: boolean;
+        depthTest: boolean;
+        blendMode: 'normal';
+    };
+}
+export interface ResolvedHelixPaletteSelection {
+    selection: HelixPaletteSelection;
+    familyName: string;
+    assetsState: string;
+    physicalSizeMeters: [number, number] | null;
+    roughness: number;
+    metallic: number;
+}
+export interface HelixPaletteApplyResult {
+    contract: typeof HELIX_MATERIAL_BINDING_CONTRACT;
+    action: 'forceFamilyId';
+    familyId: string;
+    familyVersion: string;
+    familyName: string;
+    assetsState: string;
+    appliedMaterialCount: number;
+    preservedAuthoredTextures: boolean;
+    materials: Array<{
+        name: string;
+        roughness: number;
+        metallic: number;
+    }>;
+}
+export declare function validateHelixPaletteSelection(value: unknown): HelixPaletteSelection;
+export declare function resolveHelixPaletteSelection(path: string, input: HelixPaletteSelection): ResolvedHelixPaletteSelection;
+export declare function applyHelixPaletteSelection(document: Document, resolved: ResolvedHelixPaletteSelection): HelixPaletteApplyResult;