zcw-shared 2.26.0 → 2.27.0

package/dist/functions/ai/agentAvatar3dFacePresets.d.ts

@@ -0,0 +1,13 @@
+import type { AiAgentAvatar3dFace } from '../../../types/ai-agent';
+export interface Avatar3dFacePreset {
+    id: string;
+    label: string;
+    face: Partial<AiAgentAvatar3dFace>;
+}
+export declare const AGENT_AVATAR3D_FACE_PRESETS: Avatar3dFacePreset[];
+export declare function applyAvatar3dFacePreset(presetId: string, presets?: Avatar3dFacePreset[]): {
+    morphWeights: Record<string, number>;
+    skinColor?: string;
+    hairColor?: string;
+    eyeColor?: string;
+};

package/dist/functions/ai/agentAvatar3dFacePresets.js

@@ -0,0 +1,79 @@
+import { createEmptyAvatar3dMorphWeights } from './agentAvatar3dMorphCatalog.js';
+export const AGENT_AVATAR3D_FACE_PRESETS = [
+    {
+        id: 'neutral',
+        label: '标准',
+        face: {},
+    },
+    {
+        id: 'youth',
+        label: '稚嫩',
+        face: {
+            morphWeights: {
+                face_round: 0.35,
+                eye_size: 0.3,
+                face_width: -0.2,
+                cheek_height: 0.15,
+            },
+            skinColor: '#ffe8d1',
+        },
+    },
+    {
+        id: 'mature',
+        label: '成熟',
+        face: {
+            morphWeights: {
+                jaw_width: 0.25,
+                chin_length: 0.15,
+                nose_bridge: 0.2,
+                brow_thickness: 0.1,
+            },
+            skinColor: '#e8c4a0',
+            hairColor: '#2a1a0a',
+        },
+    },
+    {
+        id: 'sharp',
+        label: '凌厉',
+        face: {
+            morphWeights: {
+                face_width: -0.35,
+                chin_length: -0.2,
+                nose_bridge: 0.25,
+                eye_corner: 0.2,
+                jaw_width: 0.15,
+            },
+            eyeColor: '#3d5c45',
+        },
+    },
+    {
+        id: 'soft',
+        label: '柔和',
+        face: {
+            morphWeights: {
+                face_round: 0.3,
+                mouth_corner: 0.25,
+                lip_thickness: 0.15,
+                eye_size: 0.1,
+            },
+            skinColor: '#ffdfc8',
+            hairColor: '#5c4033',
+        },
+    },
+];
+export function applyAvatar3dFacePreset(presetId, presets = AGENT_AVATAR3D_FACE_PRESETS) {
+    const preset = presets.find((p) => p.id === presetId) ?? presets[0];
+    const morphWeights = createEmptyAvatar3dMorphWeights();
+    const pw = preset?.face?.morphWeights ?? {};
+    for (const [k, v] of Object.entries(pw)) {
+        if (typeof v === 'number' && Number.isFinite(v))
+            morphWeights[k] = v;
+    }
+    return {
+        morphWeights,
+        skinColor: preset?.face?.skinColor,
+        hairColor: preset?.face?.hairColor,
+        eyeColor: preset?.face?.eyeColor,
+    };
+}
+//# sourceMappingURL=agentAvatar3dFacePresets.js.map

package/dist/functions/ai/agentAvatar3dFacePresets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAvatar3dFacePresets.js","sourceRoot":"","sources":["../../../src/functions/ai/agentAvatar3dFacePresets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAA;AAS7E,MAAM,CAAC,MAAM,2BAA2B,GAAyB;IAC/D;QACE,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,EAAE;KACT;IACD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ,YAAY,EAAE;gBACZ,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,GAAG;gBACb,UAAU,EAAE,CAAC,GAAG;gBAChB,YAAY,EAAE,IAAI;aACnB;YACD,SAAS,EAAE,SAAS;SACrB;KACF;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ,YAAY,EAAE;gBACZ,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,IAAI;gBACjB,WAAW,EAAE,GAAG;gBAChB,cAAc,EAAE,GAAG;aACpB;YACD,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,SAAS;SACrB;KACF;IACD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ,YAAY,EAAE;gBACZ,UAAU,EAAE,CAAC,IAAI;gBACjB,WAAW,EAAE,CAAC,GAAG;gBACjB,WAAW,EAAE,IAAI;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,IAAI;aAChB;YACD,QAAQ,EAAE,SAAS;SACpB;KACF;IACD;QACE,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ,YAAY,EAAE;gBACZ,UAAU,EAAE,GAAG;gBACf,YAAY,EAAE,IAAI;gBAClB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,GAAG;aACd;YACD,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,SAAS;SACrB;KACF;CACF,CAAA;AAED,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,OAAO,GAAG,2BAA2B;IAOrC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;IACnE,MAAM,YAAY,GAAG,+BAA+B,EAAE,CAAA;IACtD,MAAM,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,CAAA;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACtE,CAAC;IACD,OAAO;QACL,YAAY;QACZ,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;QAClC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;QAClC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ;KACjC,CAAA;AACH,CAAC"}

package/dist/functions/ai/agentAvatar3dMaterialTint.d.ts

@@ -0,0 +1,7 @@
+export type Avatar3dMaterialTintTarget = 'skin' | 'hair' | 'eye';
+export declare function resolveAvatar3dMaterialTintTarget(meshName: string, matName: string, options?: {
+    monolithic?: boolean;
+}): Avatar3dMaterialTintTarget | null;
+export declare function canTintAvatar3dMaterial(_mat: {
+    map?: unknown;
+}): boolean;

package/dist/functions/ai/agentAvatar3dMaterialTint.js

@@ -0,0 +1,45 @@
+const OUTFIT_HINTS = ['outfit', 'cloth', 'shirt', 'pants', 'shoes', 'garment', 'top', 'bottom', 'jacket'];
+const SKIN_HINTS = ['skin', 'flesh', 'body', 'face_mesh', 'skinmesh'];
+const HAIR_HINTS = ['hair', 'scalp'];
+const EYE_HINTS = ['iris', 'pupil', 'eye_color', 'eyeball', 'wolf3d_eye'];
+const EYE_SKIP = ['eyelash', 'eyebrow', 'white', 'sclera', 'lash', 'teeth'];
+function matchesHints(text, hints, skip) {
+    if (skip?.some((s) => text.includes(s)))
+        return false;
+    return hints.some((h) => text.includes(h));
+}
+function matchesAny(text, hints) {
+    return hints.some((h) => text.includes(h));
+}
+export function resolveAvatar3dMaterialTintTarget(meshName, matName, options) {
+    if (options?.monolithic)
+        return null;
+    const mesh = meshName.toLowerCase();
+    const mat = matName.toLowerCase();
+    const label = `${mesh} ${mat}`;
+    if (mesh.includes('teeth') || mat.includes('teeth'))
+        return null;
+    if (matchesAny(label, OUTFIT_HINTS))
+        return null;
+    if (mesh === 'wolf3d_avatar' || mat === 'wolf3d_avatar')
+        return null;
+    if (mesh.includes('transparent') ||
+        mat.includes('transparent') ||
+        matchesHints(label, HAIR_HINTS)) {
+        return 'hair';
+    }
+    if (matchesHints(label, EYE_HINTS, EYE_SKIP) &&
+        !matchesHints(label, HAIR_HINTS)) {
+        return 'eye';
+    }
+    if (matchesHints(label, SKIN_HINTS) &&
+        !matchesHints(label, HAIR_HINTS) &&
+        !matchesHints(label, EYE_HINTS, EYE_SKIP)) {
+        return 'skin';
+    }
+    return null;
+}
+export function canTintAvatar3dMaterial(_mat) {
+    return true;
+}
+//# sourceMappingURL=agentAvatar3dMaterialTint.js.map

package/dist/functions/ai/agentAvatar3dMaterialTint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAvatar3dMaterialTint.js","sourceRoot":"","sources":["../../../src/functions/ai/agentAvatar3dMaterialTint.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;AACzG,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAA;AACrE,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AACpC,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,CAAA;AACzE,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AAI3E,SAAS,YAAY,CAAC,IAAY,EAAE,KAAe,EAAE,IAAe;IAClE,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACrD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,KAAe;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC;AAMD,MAAM,UAAU,iCAAiC,CAC/C,QAAgB,EAChB,OAAe,EACf,OAAkC;IAElC,IAAI,OAAO,EAAE,UAAU;QAAE,OAAO,IAAI,CAAA;IAEpC,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAA;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAA;IACjC,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE,CAAA;IAE9B,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAChE,IAAI,UAAU,CAAC,KAAK,EAAE,YAAY,CAAC;QAAE,OAAO,IAAI,CAAA;IAGhD,IAAI,IAAI,KAAK,eAAe,IAAI,GAAG,KAAK,eAAe;QAAE,OAAO,IAAI,CAAA;IAEpE,IACE,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC5B,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC3B,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,EAC/B,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IACE,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC;QACxC,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,EAChC,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IACE,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC;QAC/B,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC;QAChC,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EACzC,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAuB;IAC7D,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/functions/ai/agentAvatar3dMorphCatalog.d.ts

@@ -0,0 +1,18 @@
+export interface Avatar3dMorphDef {
+    id: string;
+    label: string;
+    aliases: string[];
+}
+export interface Avatar3dMorphCategory {
+    id: string;
+    label: string;
+    morphs: Avatar3dMorphDef[];
+}
+export declare const AGENT_AVATAR3D_MORPH_CATALOG: Avatar3dMorphCategory[];
+export declare const AVATAR3D_LEGACY_FACE_TO_CATALOG: Record<string, string>;
+export declare function listAvatar3dMorphCatalogIds(catalog?: Avatar3dMorphCategory[]): string[];
+export declare function createEmptyAvatar3dMorphWeights(catalog?: Avatar3dMorphCategory[]): Record<string, number>;
+export declare function createRandomAvatar3dMorphWeights(catalog?: Avatar3dMorphCategory[]): Record<string, number>;
+export declare function resolveAvatar3dMorphBindings(modelMorphNames: string[], catalog?: Avatar3dMorphCategory[]): Record<string, string>;
+export declare function countAvatar3dMorphBindings(modelMorphNames: string[], catalog?: Avatar3dMorphCategory[]): number;
+export declare function isAvatar3dMorphCatalogIdBound(catalogId: string, modelMorphNames: string[]): boolean;

package/dist/functions/ai/agentAvatar3dMorphCatalog.js

@@ -0,0 +1,222 @@
+import { isArkitBlendshapeModel, isArkitMorphCatalogIdBound, } from './agentAvatar3dArkitMorph.js';
+export const AGENT_AVATAR3D_MORPH_CATALOG = [
+    {
+        id: 'face',
+        label: '脸型',
+        morphs: [
+            {
+                id: 'face_width',
+                label: '脸宽',
+                aliases: ['face_width', 'facewidth', 'head_width', 'headwidth', 'mouthstretch', 'cheekpuff'],
+            },
+            {
+                id: 'face_round',
+                label: '脸颊圆润',
+                aliases: ['face_round', 'faceround', 'cheek_puff', 'face_fat', 'cheekpuff'],
+            },
+            {
+                id: 'jaw_width',
+                label: '下颌宽度',
+                aliases: ['jaw_width', 'jawwidth', 'chin_width', 'jawleft', 'jawright'],
+            },
+            {
+                id: 'chin_length',
+                label: '下巴长短',
+                aliases: ['chin_length', 'chinlength', 'jaw_length', 'jawforward'],
+            },
+            {
+                id: 'cheek_height',
+                label: '颧骨高低',
+                aliases: ['cheek_height', 'cheekheight', 'cheeksquint', 'cheekpuff'],
+            },
+            {
+                id: 'face_height',
+                label: '脸型长短',
+                aliases: ['face_height', 'faceheight', 'head_height', 'jawopen'],
+            },
+        ],
+    },
+    {
+        id: 'brow',
+        label: '眉部',
+        morphs: [
+            {
+                id: 'brow_thickness',
+                label: '眉毛粗细',
+                aliases: ['brow_thickness', 'eyebrow_thickness', 'browdown'],
+            },
+            {
+                id: 'brow_height',
+                label: '眉位高低',
+                aliases: ['brow_height', 'eyebrow_height', 'brow_up', 'browinnerup', 'browouterup'],
+            },
+            {
+                id: 'brow_spacing',
+                label: '眉距',
+                aliases: ['brow_spacing', 'eyebrow_spacing', 'brow_distance', 'browdown'],
+            },
+        ],
+    },
+    {
+        id: 'eye',
+        label: '眼部',
+        morphs: [
+            {
+                id: 'eye_size',
+                label: '眼睛大小',
+                aliases: ['eye_size', 'eyesize', 'eyes_scale', 'eye_scale', 'eyewide', 'eyesquint'],
+            },
+            {
+                id: 'eye_spacing',
+                label: '眼距',
+                aliases: ['eye_spacing', 'eyes_spacing', 'eye_distance', 'eyelookout', 'eyelookin'],
+            },
+            {
+                id: 'eye_height',
+                label: '眼位高低',
+                aliases: ['eye_height', 'eye_position', 'eyes_height', 'eyelookup', 'eyelookdown'],
+            },
+            {
+                id: 'eye_corner',
+                label: '眼角',
+                aliases: ['eye_corner', 'eye_angle', 'eyes_corner', 'eyesquint'],
+            },
+            {
+                id: 'eye_depth',
+                label: '眼眶深浅',
+                aliases: ['eye_depth', 'eye_socket', 'eyes_depth', 'eyesquint'],
+            },
+        ],
+    },
+    {
+        id: 'nose',
+        label: '鼻部',
+        morphs: [
+            {
+                id: 'nose_size',
+                label: '鼻子大小',
+                aliases: ['nose_size', 'nosesize', 'nose_scale', 'nosesneer'],
+            },
+            {
+                id: 'nose_width',
+                label: '鼻翼宽度',
+                aliases: ['nose_width', 'nostril', 'nose_wing', 'mouthfunnel'],
+            },
+            {
+                id: 'nose_height',
+                label: '鼻头高低',
+                aliases: ['nose_height', 'nose_tip', 'nose_position', 'nosesneer'],
+            },
+            {
+                id: 'nose_bridge',
+                label: '鼻梁',
+                aliases: ['nose_bridge', 'bridge', 'nose_length', 'jawforward'],
+            },
+        ],
+    },
+    {
+        id: 'mouth',
+        label: '嘴部',
+        morphs: [
+            {
+                id: 'mouth_width',
+                label: '嘴宽',
+                aliases: ['mouth_width', 'mouthwidth', 'lip_width', 'mouthstretch'],
+            },
+            {
+                id: 'mouth_size',
+                label: '嘴巴大小',
+                aliases: ['mouth_size', 'mouthsize', 'mouth_scale', 'mouthpucker', 'mouthfunnel'],
+            },
+            {
+                id: 'lip_thickness',
+                label: '嘴唇厚度',
+                aliases: ['lip_thickness', 'lips_thickness', 'lip', 'lips', 'mouthpucker', 'mouthroll'],
+            },
+            {
+                id: 'mouth_corner',
+                label: '嘴角',
+                aliases: ['mouth_corner', 'lip_corner', 'smile', 'mouthsmile', 'mouthfrown'],
+            },
+        ],
+    },
+    {
+        id: 'ear',
+        label: '耳朵',
+        morphs: [
+            { id: 'ear_size', label: '耳朵大小', aliases: ['ear_size', 'earsize', 'ears'] },
+            { id: 'ear_angle', label: '耳朵角度', aliases: ['ear_angle', 'ear_rotation'] },
+        ],
+    },
+];
+export const AVATAR3D_LEGACY_FACE_TO_CATALOG = {
+    faceWidth: 'face_width',
+    faceRound: 'face_round',
+    eyeSize: 'eye_size',
+    noseSize: 'nose_size',
+    mouthSize: 'mouth_size',
+};
+export function listAvatar3dMorphCatalogIds(catalog = AGENT_AVATAR3D_MORPH_CATALOG) {
+    const ids = [];
+    for (const cat of catalog) {
+        for (const m of cat.morphs)
+            ids.push(m.id);
+    }
+    return ids;
+}
+export function createEmptyAvatar3dMorphWeights(catalog = AGENT_AVATAR3D_MORPH_CATALOG) {
+    const out = {};
+    for (const id of listAvatar3dMorphCatalogIds(catalog))
+        out[id] = 0;
+    return out;
+}
+export function createRandomAvatar3dMorphWeights(catalog = AGENT_AVATAR3D_MORPH_CATALOG) {
+    const out = createEmptyAvatar3dMorphWeights(catalog);
+    for (const id of Object.keys(out)) {
+        out[id] = Math.round((Math.random() * 2 - 1) * 100) / 100;
+    }
+    return out;
+}
+export function resolveAvatar3dMorphBindings(modelMorphNames, catalog = AGENT_AVATAR3D_MORPH_CATALOG) {
+    const bindings = {};
+    const entries = modelMorphNames.map((name) => ({
+        original: name,
+        lower: name.toLowerCase(),
+    }));
+    for (const cat of catalog) {
+        for (const morph of cat.morphs) {
+            if (bindings[morph.id])
+                continue;
+            for (const alias of morph.aliases) {
+                const needle = alias.toLowerCase();
+                const hit = entries.find((e) => e.lower === needle) ??
+                    entries.find((e) => e.lower.includes(needle));
+                if (hit) {
+                    bindings[morph.id] = hit.original;
+                    break;
+                }
+            }
+        }
+    }
+    return bindings;
+}
+export function countAvatar3dMorphBindings(modelMorphNames, catalog = AGENT_AVATAR3D_MORPH_CATALOG) {
+    const unique = [...new Set(modelMorphNames)];
+    const arkit = isArkitBlendshapeModel(unique);
+    let count = 0;
+    for (const id of listAvatar3dMorphCatalogIds(catalog)) {
+        if (arkit && isArkitMorphCatalogIdBound(id, unique))
+            count += 1;
+        else if (id in resolveAvatar3dMorphBindings(unique, catalog))
+            count += 1;
+    }
+    return count;
+}
+export function isAvatar3dMorphCatalogIdBound(catalogId, modelMorphNames) {
+    const unique = [...new Set(modelMorphNames)];
+    if (isArkitBlendshapeModel(unique) && isArkitMorphCatalogIdBound(catalogId, unique)) {
+        return true;
+    }
+    return catalogId in resolveAvatar3dMorphBindings(unique);
+}
+//# sourceMappingURL=agentAvatar3dMorphCatalog.js.map

package/dist/functions/ai/agentAvatar3dMorphCatalog.js.map

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

package/dist/functions/ai/applyAiAgentAvatar3dFace.d.ts

@@ -0,0 +1,23 @@
+import type { AiAgentAvatar3d, AiAgentAvatar3dFace } from '../../../types/ai-agent';
+type ThreeLikeColor = {
+    set: (hex: string) => void;
+};
+type ThreeLikeMaterial = {
+    name?: string;
+    color?: ThreeLikeColor;
+    map?: unknown;
+};
+type ThreeLikeMesh = {
+    isMesh?: boolean;
+    name?: string;
+    visible?: boolean;
+    material?: ThreeLikeMaterial | ThreeLikeMaterial[];
+    morphTargetDictionary?: Record<string, number>;
+    morphTargetInfluences?: number[];
+};
+type ThreeLikeObject = {
+    traverse: (fn: (obj: ThreeLikeMesh) => void) => void;
+};
+export declare function applyAiAgentAvatar3dFace(root: ThreeLikeObject | null | undefined, cfg: AiAgentAvatar3d | AiAgentAvatar3dFace | null | undefined): void;
+export declare function listAvatar3dMorphNames(root: ThreeLikeObject | null | undefined): string[];
+export {};

package/dist/functions/ai/applyAiAgentAvatar3dFace.js

@@ -0,0 +1,140 @@
+import { deriveAvatar3dCapabilities, isMonolithicTextureAvatar, listAvatar3dMeshInventory, } from './agentAvatar3dCapabilities.js';
+import { isArkitBlendshapeModel, isArkitMorphCatalogIdBound, morphSliderToArkitInfluence, morphSliderToSymmetricInfluence, resolveArkitCatalogMorphNames, } from './agentAvatar3dArkitMorph.js';
+import { canTintAvatar3dMaterial, resolveAvatar3dMaterialTintTarget, } from './agentAvatar3dMaterialTint.js';
+import { resolveAvatar3dMorphBindings } from './agentAvatar3dMorphCatalog.js';
+import { getEffectiveAvatar3dMorphWeights } from './getEffectiveAvatar3dMorphWeights.js';
+import { mergeAvatar3dFaceWithDefaults, normalizeAiAgentAvatar3dFace, } from './normalizeAiAgentAvatar3dFace.js';
+function applyMaterialColor(mat, hex) {
+    if (!mat?.color?.set)
+        return;
+    try {
+        mat.color.set(hex);
+    }
+    catch {
+    }
+}
+function resetMorphInfluences(influences) {
+    for (let i = 0; i < influences.length; i++)
+        influences[i] = 0;
+}
+function setMorphInfluenceAt(influences, idx, amount) {
+    if (idx < 0 || idx >= influences.length)
+        return;
+    influences[idx] = amount;
+}
+function applyMorphAtNames(dict, influences, morphNames, amount) {
+    for (const morphName of morphNames) {
+        const idx = dict[morphName];
+        if (idx === undefined)
+            continue;
+        setMorphInfluenceAt(influences, idx, amount);
+    }
+}
+function applyLegacyMorphInfluence(dict, influences, morphName, sliderValue, arkit) {
+    const amount = arkit
+        ? morphSliderToArkitInfluence(sliderValue)
+        : morphSliderToSymmetricInfluence(sliderValue);
+    applyMorphAtNames(dict, influences, [morphName], amount);
+}
+export function applyAiAgentAvatar3dFace(root, cfg) {
+    if (!root?.traverse)
+        return;
+    const faceRaw = cfg && 'face' in cfg
+        ? cfg.face
+        : cfg;
+    const face = mergeAvatar3dFaceWithDefaults(normalizeAiAgentAvatar3dFace(faceRaw));
+    const morphWeights = getEffectiveAvatar3dMorphWeights(face);
+    const inventory = listAvatar3dMeshInventory(root);
+    const monolithic = isMonolithicTextureAvatar(inventory);
+    const capabilities = deriveAvatar3dCapabilities({
+        useProcedural: false,
+        inventory,
+        morphNames: listAvatar3dMorphNames(root),
+    });
+    const modelMorphNames = [];
+    root.traverse((child) => {
+        if (!child?.isMesh)
+            return;
+        const dict = child.morphTargetDictionary;
+        if (!dict)
+            return;
+        for (const name of Object.keys(dict))
+            modelMorphNames.push(name);
+    });
+    const uniqueMorphNames = [...new Set(modelMorphNames)];
+    const arkit = isArkitBlendshapeModel(uniqueMorphNames);
+    const bindings = resolveAvatar3dMorphBindings(uniqueMorphNames);
+    root.traverse((child) => {
+        if (!child?.isMesh)
+            return;
+        const mesh = child;
+        const meshName = String(mesh.name ?? '');
+        const materials = Array.isArray(mesh.material)
+            ? mesh.material
+            : mesh.material
+                ? [mesh.material]
+                : [];
+        for (const mat of materials) {
+            if (!canTintAvatar3dMaterial(mat))
+                continue;
+            const matName = String(mat?.name ?? '');
+            const tintTarget = resolveAvatar3dMaterialTintTarget(meshName, matName, {
+                monolithic,
+            });
+            if (tintTarget === 'hair' &&
+                capabilities.colors.hair &&
+                face.hairColor) {
+                applyMaterialColor(mat, face.hairColor);
+            }
+            else if (tintTarget === 'eye' &&
+                capabilities.colors.eye &&
+                face.eyeColor) {
+                applyMaterialColor(mat, face.eyeColor);
+            }
+            else if (tintTarget === 'skin' &&
+                capabilities.colors.skin &&
+                face.skinColor) {
+                applyMaterialColor(mat, face.skinColor);
+            }
+        }
+        const dict = mesh.morphTargetDictionary;
+        const influences = mesh.morphTargetInfluences;
+        if (!dict || !influences?.length)
+            return;
+        resetMorphInfluences(influences);
+        for (const [catalogId, sliderValue] of Object.entries(morphWeights)) {
+            if (sliderValue === undefined || sliderValue === 0)
+                continue;
+            if (arkit && isArkitMorphCatalogIdBound(catalogId, uniqueMorphNames)) {
+                const { positive, negative } = resolveArkitCatalogMorphNames(catalogId, uniqueMorphNames);
+                if (sliderValue > 0 && positive.length) {
+                    applyMorphAtNames(dict, influences, positive, morphSliderToArkitInfluence(sliderValue));
+                }
+                else if (sliderValue < 0 && negative.length) {
+                    applyMorphAtNames(dict, influences, negative, morphSliderToArkitInfluence(-sliderValue));
+                }
+                continue;
+            }
+            const morphName = bindings[catalogId];
+            if (!morphName)
+                continue;
+            applyLegacyMorphInfluence(dict, influences, morphName, sliderValue, arkit);
+        }
+    });
+}
+export function listAvatar3dMorphNames(root) {
+    const names = new Set();
+    if (!root?.traverse)
+        return [];
+    root.traverse((child) => {
+        if (!child?.isMesh)
+            return;
+        const dict = child.morphTargetDictionary;
+        if (!dict)
+            return;
+        for (const name of Object.keys(dict))
+            names.add(name);
+    });
+    return [...names].sort();
+}
+//# sourceMappingURL=applyAiAgentAvatar3dFace.js.map

package/dist/functions/ai/applyAiAgentAvatar3dFace.js.map

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

package/dist/functions/ai/getEffectiveAvatar3dMorphWeights.d.ts

@@ -0,0 +1,3 @@
+import type { AiAgentAvatar3dFace } from '../../../types/ai-agent';
+export declare function mergeLegacyFaceFieldsToMorphWeights(face: AiAgentAvatar3dFace): Record<string, number>;
+export declare function getEffectiveAvatar3dMorphWeights(face?: AiAgentAvatar3dFace | null): Record<string, number>;

package/dist/functions/ai/getEffectiveAvatar3dMorphWeights.js

@@ -0,0 +1,28 @@
+import { AVATAR3D_LEGACY_FACE_TO_CATALOG, createEmptyAvatar3dMorphWeights, listAvatar3dMorphCatalogIds, } from './agentAvatar3dMorphCatalog.js';
+export function mergeLegacyFaceFieldsToMorphWeights(face) {
+    const base = { ...(face.morphWeights ?? {}) };
+    for (const [legacyKey, catalogId] of Object.entries(AVATAR3D_LEGACY_FACE_TO_CATALOG)) {
+        const v = face[legacyKey];
+        if (typeof v !== 'number' || !Number.isFinite(v))
+            continue;
+        if (base[catalogId] === undefined || base[catalogId] === 0) {
+            base[catalogId] = Math.max(-1, Math.min(1, v));
+        }
+    }
+    return base;
+}
+export function getEffectiveAvatar3dMorphWeights(face) {
+    const empty = createEmptyAvatar3dMorphWeights();
+    if (!face)
+        return empty;
+    const merged = mergeLegacyFaceFieldsToMorphWeights(face);
+    const out = { ...empty };
+    for (const id of listAvatar3dMorphCatalogIds()) {
+        const v = merged[id];
+        if (v !== undefined && Number.isFinite(v)) {
+            out[id] = Math.max(-1, Math.min(1, v));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=getEffectiveAvatar3dMorphWeights.js.map

package/dist/functions/ai/getEffectiveAvatar3dMorphWeights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEffectiveAvatar3dMorphWeights.js","sourceRoot":"","sources":["../../../src/functions/ai/getEffectiveAvatar3dMorphWeights.ts"],"names":[],"mappings":"AACA,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,6BAA6B,CAAA;AAGpC,MAAM,UAAU,mCAAmC,CACjD,IAAyB;IAEzB,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAA;IAC7C,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,+BAA+B,CAAC,EAAE,CAAC;QACrF,MAAM,CAAC,GAAI,IAAgC,CAAC,SAAS,CAAC,CAAA;QACtD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,SAAQ;QAC1D,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAGD,MAAM,UAAU,gCAAgC,CAC9C,IAAiC;IAEjC,MAAM,KAAK,GAAG,+BAA+B,EAAE,CAAA;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IACvB,MAAM,MAAM,GAAG,mCAAmC,CAAC,IAAI,CAAC,CAAA;IACxD,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;IACxB,KAAK,MAAM,EAAE,IAAI,2BAA2B,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;QACpB,IAAI,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACxC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/functions/ai/normalizeAiAgentAvatar3d.d.ts

@@ -0,0 +1,4 @@
+import type { AiAgentAvatar3d } from '../../../types/ai-agent';
+export declare function normalizeAiAgentAvatar3d(raw: unknown): AiAgentAvatar3d;
+export declare function isEmptyAiAgentAvatar3d(cfg: AiAgentAvatar3d): boolean;
+export declare function finalizeAiAgentAvatar3dForStorage(cfg: AiAgentAvatar3d): AiAgentAvatar3d;