@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/cliplab/gaze.js

@@ -0,0 +1,57 @@
+export const centeredGaze = () => ({ x: 0, y: 0 });
+export const inactivePointer = () => ({ x: 0, y: 0, weight: 0 });
+/** Geometric canvas coordinates retain the target's position, even outside the canvas. */
+export function pointerLook(pointer, bounds) {
+    return { x: (pointer.clientX - bounds.left) / Math.max(1, bounds.width) * 2 - 1, y: 1 - (pointer.clientY - bounds.top) / Math.max(1, bounds.height) * 2, weight: 1 };
+}
+export function easePointer(current, target, seconds, immediate = false) {
+    return { ...easeGaze(current, target, seconds, immediate), weight: easeGaze({ x: current.weight, y: 0 }, { x: target.weight, y: 0 }, seconds, immediate).x };
+}
+/** Solve in the projected eye's own axes, then gently saturate travel with distance. */
+export function gazeAtPoint(pointer, center, right, up) {
+    const rx = right.x - center.x, ry = right.y - center.y, ux = up.x - center.x, uy = up.y - center.y;
+    const determinant = rx * uy - ry * ux;
+    if (Math.abs(determinant) < 1e-10)
+        return centeredGaze();
+    const dx = pointer.x - center.x, dy = pointer.y - center.y;
+    const x = (dx * uy - dy * ux) / determinant, y = (rx * dy - ry * dx) / determinant;
+    const distance = Math.hypot(x, y, 1.15);
+    return { x: x / distance, y: y / distance };
+}
+export function localGaze(gaze, rotation) {
+    const angle = rotation * Math.PI / 180;
+    return clampGaze({ x: gaze.x * Math.cos(angle) - gaze.y * Math.sin(angle), y: gaze.x * Math.sin(angle) + gaze.y * Math.cos(angle) });
+}
+export function clampGaze({ x, y }) {
+    x = Number.isFinite(x) ? x : 0;
+    y = Number.isFinite(y) ? y : 0;
+    const length = Math.max(1, Math.hypot(x, y));
+    return { x: x / length, y: y / length };
+}
+export function pointerGaze(pointer, bounds) {
+    return clampGaze({
+        x: (pointer.clientX - bounds.left - bounds.width / 2) / Math.max(80, bounds.width / 2),
+        y: -(pointer.clientY - bounds.top - bounds.height / 2) / Math.max(80, bounds.height / 2)
+    });
+}
+/** Time-based easing, shared by the studio and paused or playing app characters. */
+export function easeGaze(current, target, seconds, immediate = false) {
+    const amount = immediate ? 1 : 1 - Math.exp(-Math.max(0, seconds) * 16);
+    const next = { x: current.x + (target.x - current.x) * amount, y: current.y + (target.y - current.y) * amount };
+    return Math.hypot(next.x - target.x, next.y - target.y) < .0005 ? { ...target } : next;
+}
+/** Keep the complete white dot inside the eye, with a small margin at every angle. */
+export function irisOffset(radius, gaze, eyeRotation = 0, cheeks = false) {
+    const look = clampGaze(gaze), angle = eyeRotation * Math.PI / 180;
+    const x = look.x * radius * .62, y = -look.y * radius * .62;
+    const dot = { x: x * Math.cos(angle) + y * Math.sin(angle), y: -x * Math.sin(angle) + y * Math.cos(angle) };
+    // Stay above the cheek's circular cutout, including the dot radius and a small gap.
+    if (cheeks) {
+        const amount = typeof cheeks === 'number' ? Math.max(0, Math.min(1, cheeks)) : 1;
+        const clearance = radius * (.82 * Math.sqrt(amount) + .305);
+        if (Math.abs(dot.x) < clearance)
+            dot.y = Math.min(dot.y, radius * 1.13 - Math.sqrt(clearance ** 2 - dot.x ** 2));
+    }
+    return dot;
+}
+//# sourceMappingURL=gaze.js.map

package/dist/cliplab/gaze.js.map

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

package/dist/cliplab/model.d.ts

@@ -0,0 +1,176 @@
+export type Shape = 'capsule' | 'cap' | 'sphere';
+export type Eye = 'dot' | 'soft' | 'closed' | 'wink' | 'star' | 'heart' | 'squint' | 'wide' | 'arc-up' | 'arc-down' | 'half-lidded' | 'pupil';
+export type Mouth = 'smile' | 'open' | 'line' | 'frown' | 'oh' | 'wave' | 'sleep' | 'grin' | 'cry' | 'u-smile' | 'kiss' | 'tongue-out';
+export type Prop = 'none' | 'zzz' | 'sparkle' | 'heart' | 'question' | 'sweat' | 'crown';
+export type Detail = 'body' | 'eyes' | 'full';
+export interface Pose {
+    eye: Eye;
+    mouth: Mouth;
+    prop: Prop;
+    propSize: number;
+    propCount: number;
+    propOutward: number;
+    faceSet: 'set-1' | 'set-2';
+    brows: 'none' | 'raised' | 'worried' | 'angry';
+    browStroke: number;
+    browLength: number;
+    blush: number;
+    eyeSize: number;
+    eyeHeight: number;
+    spacing: number;
+    eyeTilt: number;
+    leftScale: number;
+    rightScale: number;
+    gazeX: number;
+    gazeY: number;
+    leftX: number;
+    rightX: number;
+    leftY: number;
+    rightY: number;
+    leftRotation: number;
+    rightRotation: number;
+    mouthWidth: number;
+    mouthOpen: number;
+    faceScale: number;
+    faceY: number;
+    rotationX: number;
+    rotationY: number;
+    rotationZ: number;
+    squash: number;
+    tongue: boolean;
+    teeth: boolean;
+    drool: boolean;
+    cheeks: boolean;
+    tears: boolean;
+    mouthStroke: number;
+}
+export interface Beat {
+    id: string;
+    name: string;
+    duration: number;
+    pose: Pose;
+    gradientAction?: 'rotate' | 'hold';
+    gradientTurns?: number;
+}
+export interface FavoriteBeat {
+    id: string;
+    sourceBeatId: string;
+    beat: Beat;
+}
+export interface Expression {
+    id: string;
+    name: string;
+    description: string;
+    beats: Beat[];
+    poseExpressionId?: string;
+}
+export interface Step {
+    id: string;
+    expressionId: string;
+    duration: number;
+}
+export interface Animation {
+    id: string;
+    name: string;
+    steps: Step[];
+    loop: boolean;
+}
+export interface Character {
+    id: string;
+    name: string;
+    shape: Shape;
+    color: string;
+    color2: string;
+    gradient: boolean;
+    gradientAngle: number;
+    toon: boolean;
+    trueFront: boolean;
+    lockPosition: boolean;
+    eyeColor: string;
+    iris: boolean;
+    elevated: boolean;
+    elevation: number;
+    shadow: boolean;
+    motion: number;
+    speed: number;
+    blink: boolean;
+    blinkInterval: number;
+    followCursor: boolean;
+    followRotation: boolean;
+}
+export interface Definition {
+    version: 1;
+    character: Character;
+    expressions: Expression[];
+    animations: Animation[];
+}
+export interface Project {
+    version: 1;
+    name: string;
+    characters: Character[];
+    expressions: Expression[];
+    animations: Animation[];
+    defaultsRevision?: number;
+    favoriteBeats?: FavoriteBeat[];
+}
+/** Remove references too, keeping every animation playable and the project importable. */
+export declare function removeExpression(project: Project, id: string): boolean;
+export type FaceTraits = Pick<Pose, 'eye' | 'mouth' | 'faceSet' | 'brows' | 'cheeks' | 'tongue' | 'teeth' | 'drool'>;
+export interface FaceLayer {
+    traits: FaceTraits;
+    weight: number;
+}
+export interface Sample {
+    pose: Pose;
+    blink: number;
+    bob: number;
+    breathe: number;
+    expressionId: string;
+    beatIndex: number;
+    stepIndex: number;
+    effectPhase?: number;
+    propAmount?: number;
+    tearAmount?: number;
+    gradientRotation?: number;
+    gradientMix?: number;
+    faceLayers?: FaceLayer[];
+}
+export declare const EYES: Eye[];
+export declare const MOUTHS: Mouth[];
+export declare const PROPS: Prop[];
+export declare const SHAPES: {
+    id: Shape;
+    name: string;
+    ratio: string;
+}[];
+export declare const PALETTES: string[][];
+export declare function detailAt(size: number): Detail;
+export declare function uid(prefix?: string): string;
+export declare function clone<T>(value: T): T;
+export declare const BASE_POSE: Pose;
+export declare function defaultExpressions(): Expression[];
+export declare function defaultProject(): Project;
+export declare function expressionDuration(expression: Expression): number;
+export declare function animationDuration(animation: Animation): number;
+export declare function isGradientExpression(expression: Expression): boolean;
+export declare function addLoadingAnimation(project: Project): Animation;
+export declare function definitionOf(project: Project, character: Character, animationIds?: string[]): Definition;
+export declare function faceLayers(pose: Pose): FaceLayer[];
+export declare function mixFaceLayers(a: FaceLayer[], b: FaceLayer[], t: number): FaceLayer[];
+export declare function mixPose(a: Pose, b: Pose, t: number): Pose;
+export declare const gradientTurns: (beat: Beat) => number;
+export declare function sampleExpression(expression: Expression, time: number, expressions?: Expression[], visited?: Set<string>): {
+    pose: Pose;
+    beatIndex: number;
+    propAmount: number;
+    tearAmount: number;
+    gradientRotation?: number;
+    gradientMix?: number;
+    faceLayers: FaceLayer[];
+};
+export declare function sampleDefinition(def: Definition, animationId: string, time: number, expressionId?: string): Sample;
+export declare function parseCharacter(value: unknown): Character;
+export declare function parseProject(value: unknown): Project;
+/** Upgrade only untouched studio defaults, once; portable definitions stay literal. */
+export declare function upgradeStudioDefaults(project: Project): Project;
+//# sourceMappingURL=model.d.ts.map

package/dist/cliplab/model.d.ts.map

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

package/dist/cliplab/model.js

@@ -0,0 +1,337 @@
+/** Remove references too, keeping every animation playable and the project importable. */
+export function removeExpression(project, id) {
+    if (project.expressions.length <= 1 || !project.expressions.some(e => e.id === id))
+        return false;
+    project.expressions = project.expressions.filter(e => e.id !== id);
+    const fallback = project.expressions[0];
+    for (const expression of project.expressions)
+        if (expression.poseExpressionId === id)
+            delete expression.poseExpressionId;
+    for (const animation of project.animations) {
+        animation.steps = animation.steps.filter(step => step.expressionId !== id);
+        if (!animation.steps.length)
+            animation.steps.push({ id: uid('step'), expressionId: fallback.id, duration: expressionDuration(fallback) });
+    }
+    return true;
+}
+export const EYES = ['dot', 'soft', 'closed', 'wink', 'star', 'heart', 'squint', 'wide', 'arc-up', 'arc-down', 'half-lidded', 'pupil'];
+export const MOUTHS = ['smile', 'open', 'line', 'frown', 'oh', 'wave', 'sleep', 'grin', 'cry', 'u-smile', 'kiss', 'tongue-out'];
+export const PROPS = ['none', 'zzz', 'sparkle', 'heart', 'question', 'sweat', 'crown'];
+export const SHAPES = [
+    { id: 'capsule', name: 'Capsule', ratio: '1:2' }, { id: 'cap', name: 'End cap', ratio: '1:1' }, { id: 'sphere', name: 'Circle', ratio: '1:1' }
+];
+export const PALETTES = [
+    ['#ff986d', '#ffd092'], ['#81d4c1', '#c6efd2'], ['#a79ce8', '#d8cafa'],
+    ['#f0ce58', '#fff1a5'], ['#ee98b2', '#ffd2da'], ['#72b6de', '#b9e4f5']
+];
+export function detailAt(size) { return size <= 12 ? 'body' : 'full'; }
+export function uid(prefix = 'item') { return `${prefix}-${crypto.randomUUID().slice(0, 8)}`; }
+export function clone(value) { return JSON.parse(JSON.stringify(value)); }
+export const BASE_POSE = {
+    eye: 'dot', mouth: 'smile', prop: 'none', propSize: 1, propCount: 0, propOutward: 1, faceSet: 'set-1', brows: 'none', browStroke: 1, browLength: 1, blush: 0, eyeSize: 1, eyeHeight: 1, spacing: 1, eyeTilt: 0,
+    leftScale: 1, rightScale: 1, gazeX: 0, gazeY: 0, mouthWidth: 1, mouthOpen: .5,
+    leftX: 0, rightX: 0, leftY: 0, rightY: 0, leftRotation: 0, rightRotation: 0,
+    faceScale: .75, faceY: 0, rotationX: 0, rotationY: 0, rotationZ: 0, squash: 1,
+    tongue: false, teeth: false, drool: false, cheeks: false, tears: false, mouthStroke: 1
+};
+const p = (v = {}) => ({ ...BASE_POSE, ...v });
+const b = (id, name, duration, pose) => ({ id, name, duration, pose: p(pose) });
+export function defaultExpressions() {
+    return [
+        { id: 'idle', name: 'Idle', description: 'A little breath. A quiet smile.', beats: [
+                b('idle-1', 'Settle', 1.8, {}), b('idle-2', 'Look around', 1.4, { gazeX: .22, rotationZ: -3, rotationY: 5 }), b('idle-3', 'Return', 1.8, {})
+            ] },
+        { id: 'listening', name: 'Listening', description: 'Present, curious, and all ears.', beats: [
+                b('listen-1', 'Notice', 1.2, { eye: 'wide', mouth: 'line', eyeSize: 1.06, rotationX: -4 }), b('listen-2', 'Lean in', 1.5, { mouth: 'smile', eyeHeight: 1.13, rotationZ: 6, rotationX: -7 }), b('listen-3', 'Nod', 1.1, { mouth: 'smile', rotationX: 5, rotationZ: 3 })
+            ] },
+        { id: 'thinking', name: 'Thinking', description: 'A glance up. Something is taking shape.', beats: [
+                b('think-1', 'Wonder', 1.5, { mouth: 'oh', mouthOpen: .23, mouthWidth: .6, gazeX: .6, gazeY: .55, rotationZ: -7, prop: 'question' }), b('think-2', 'Consider', 1.6, { eye: 'soft', mouth: 'wave', gazeX: -.35, gazeY: .2, rotationY: -8, rotationZ: 4 }), b('think-3', 'Almost', 1.2, { mouth: 'smile', gazeY: .25, rotationZ: -3 })
+            ] },
+        { id: 'working', name: 'Working', description: 'Small, focused, steady movements.', beats: [
+                b('work-1', 'Focus left', 1.0, { eye: 'soft', mouth: 'line', mouthWidth: .65, gazeX: -.5, gazeY: -.3, rotationY: -7, rotationX: 4 }), b('work-2', 'Focus right', 1.0, { eye: 'soft', mouth: 'line', mouthWidth: .65, gazeX: .5, gazeY: -.3, rotationY: 7, rotationX: 4 }), b('work-3', 'Check', 1.4, { mouth: 'smile', rotationX: -3 })
+            ] },
+        { id: 'happy', name: 'Happy', description: 'A small open smile says it all.', beats: [
+                b('happy-1', 'Light up', .9, { mouth: 'open', mouthOpen: .62, rotationZ: -5, squash: 1.025 }), b('happy-2', 'Delight', 1.3, { eye: 'arc-up', mouth: 'grin', mouthOpen: .8, prop: 'sparkle', rotationZ: 5, squash: .97 }), b('happy-3', 'Glow', 1.5, { mouth: 'open', mouthOpen: .5, rotationZ: -2 })
+            ] },
+        { id: 'confused', name: 'Confused', description: 'A little uneven. A second look.', beats: [
+                b('confused-1', 'Wait', 1.2, { eye: 'soft', leftScale: .7, rightScale: 1.1, mouth: 'wave', rotationZ: 10, prop: 'question' }), b('confused-2', 'Really?', 1.4, { leftScale: 1.1, rightScale: .7, mouth: 'oh', mouthOpen: .25, rotationZ: -9, gazeX: -.2 }), b('confused-3', 'Hmm', 1.3, { eye: 'soft', mouth: 'frown', mouthWidth: .75, rotationZ: 4 })
+            ] },
+        { id: 'sleepy', name: 'Sleepy', description: 'Slow breathing, drifting sleep marks.', beats: [
+                b('sleep-1', 'Doze', 2, { eye: 'arc-down', mouth: 'sleep', prop: 'zzz', drool: true, rotationZ: -6, rotationX: 4, squash: .97 }), b('sleep-2', 'Breathe in', 2, { eye: 'arc-down', mouth: 'oh', mouthOpen: .25, mouthWidth: .65, prop: 'zzz', drool: true, rotationZ: -3, squash: 1.025 }), b('sleep-3', 'Breathe out', 2, { eye: 'arc-down', mouth: 'sleep', prop: 'zzz', drool: true, rotationZ: -7, squash: .98 })
+            ] },
+        { id: 'sad', name: 'Sad', description: 'A round frown, a little lower.', beats: [
+                b('sad-1', 'Low', 1.6, { mouth: 'frown', rotationZ: -3 }), b('sad-2', 'Sigh', 1.8, { eye: 'arc-down', mouth: 'frown', rotationX: 4 }), b('sad-3', 'Look up', 1.6, { mouth: 'frown', gazeY: .2 })
+            ] },
+        { id: 'tearful', name: 'Tearful', description: 'A trembling mouth and falling tears.', beats: [
+                b('tear-1', 'Well up', 1.5, { mouth: 'cry', tears: true, mouthOpen: .6, rotationZ: -3 }), b('tear-2', 'Let go', 1.8, { mouth: 'cry', tears: true, mouthOpen: .85, eye: 'arc-down', rotationZ: 3 }), b('tear-3', 'Breathe', 1.8, { mouth: 'cry', tears: true, mouthOpen: .5 })
+            ] },
+        { id: 'playful', name: 'Playful', description: 'A wink, a grin, a little mischief.', beats: [
+                b('play-1', 'Peek', 1.1, { mouth: 'open', tongue: true, rotationY: -10, rotationZ: -8 }), b('play-2', 'Wink', 1.2, { eye: 'squint', mouth: 'u-smile', tongue: true, mouthOpen: .7, rotationZ: 9, prop: 'sparkle' }), b('play-3', 'Grin', 1.3, { mouth: 'grin', cheeks: true, teeth: true, mouthOpen: .45, rotationZ: -3 })
+            ] },
+        { id: 'loading', name: 'Loading', description: 'Focused Working gestures with a gently eased gradient turn.', poseExpressionId: 'working', beats: [
+                { ...b('loading-rotate', 'Rotate', 2, {}), gradientAction: 'rotate' },
+                { ...b('loading-hold', 'Hold', .5, {}), gradientAction: 'hold' }
+            ] }
+    ];
+}
+export function defaultProject() {
+    const base = {
+        id: 'milo', name: 'Milo', shape: 'capsule', color: '#ff986d', color2: '#ffd092', gradient: true,
+        gradientAngle: -24, toon: true, trueFront: false, lockPosition: false, eyeColor: '#080909', iris: false, elevated: false, elevation: .065,
+        shadow: true, motion: .45, speed: 1, blink: true, blinkInterval: 4.2, followCursor: false, followRotation: false
+    };
+    const expressions = defaultExpressions();
+    const sequences = {
+        listening: [['listening', 3.8], ['idle', 1.6]],
+        thinking: [['thinking', 4.3], ['working', 1.8]],
+        working: [['working', 6.8], ['thinking', 2.2]],
+        happy: [['happy', 3.7], ['playful', 2.4], ['idle', 1.8]],
+        confused: [['confused', 3.9], ['thinking', 2.1]],
+        playful: [['playful', 3.6], ['happy', 2.2]]
+    };
+    return {
+        version: 1, name: 'My character studio', defaultsRevision: 2,
+        characters: [base, { ...base, id: 'pip', name: 'Pip', shape: 'cap', color: '#81d4c1', color2: '#c6efd2' }, { ...base, id: 'lumi', name: 'Lumi', shape: 'sphere', color: '#a79ce8', color2: '#d8cafa' }],
+        expressions,
+        animations: expressions.map((e) => ({
+            id: e.id, name: e.id === 'happy' ? 'Success' : e.name, loop: true,
+            steps: (sequences[e.id] ?? [[e.id, expressionDuration(e)]]).map(([expressionId, duration], i) => ({ id: `${e.id}-step-${i + 1}`, expressionId, duration }))
+        }))
+    };
+}
+const safeDuration = (value) => Number.isFinite(value) ? Math.max(.2, value) : 1;
+export function expressionDuration(expression) { return expression.beats.reduce((n, beat) => n + safeDuration(beat.duration), 0); }
+export function animationDuration(animation) { return animation.steps.reduce((n, step) => n + safeDuration(step.duration), 0); }
+export function isGradientExpression(expression) { return expression.beats.some(beat => beat.gradientAction !== undefined); }
+export function addLoadingAnimation(project) {
+    let expression = project.expressions.find(e => e.id === 'loading' && isGradientExpression(e)) ?? project.expressions.find(isGradientExpression);
+    const existing = expression && project.animations.find(a => a.steps.length === 1 && a.steps[0].expressionId === expression.id);
+    if (existing)
+        return existing;
+    const needsWorking = (!expression || expression.poseExpressionId === 'working') && !project.expressions.some(e => e.id === 'working');
+    if (project.animations.length >= 100 || project.expressions.length + (expression ? 0 : 1) + (needsWorking ? 1 : 0) > 100)
+        throw new Error('Make room in the library before adding Loading. Projects support up to 100 expressions and animations.');
+    if (!expression) {
+        expression = defaultExpressions().find(e => e.id === 'loading');
+        if (project.expressions.some(e => e.id === expression.id))
+            expression.id = uid('loading');
+        project.expressions.push(expression);
+    }
+    if (expression.poseExpressionId === 'working' && !project.expressions.some(e => e.id === 'working')) {
+        project.expressions.push(defaultExpressions().find(e => e.id === 'working'));
+    }
+    const animation = { id: project.animations.some(a => a.id === 'loading') ? uid('loading') : 'loading', name: 'Loading', loop: true, steps: [{ id: uid('step'), expressionId: expression.id, duration: expressionDuration(expression) }] };
+    project.animations.push(animation);
+    return animation;
+}
+export function definitionOf(project, character, animationIds) {
+    const animations = project.animations.filter(a => !animationIds || animationIds.includes(a.id));
+    const used = new Set(animations.flatMap(a => a.steps.map(s => s.expressionId)));
+    // A selected Loading export also carries the expression playing alongside it.
+    for (const id of used) {
+        const source = project.expressions.find(e => e.id === id)?.poseExpressionId;
+        if (source)
+            used.add(source);
+    }
+    return clone({ version: 1, character, expressions: animationIds ? project.expressions.filter(e => used.has(e.id)) : project.expressions, animations });
+}
+const numericKeys = Object.keys(BASE_POSE).filter(k => typeof BASE_POSE[k] === 'number');
+const faceKeys = ['eye', 'mouth', 'faceSet', 'brows', 'cheeks', 'tongue', 'teeth', 'drool'];
+export function faceLayers(pose) {
+    return [{ traits: Object.fromEntries(faceKeys.map(key => [key, pose[key]])), weight: 1 }];
+}
+export function mixFaceLayers(a, b, t) {
+    const combined = new Map();
+    for (const [layers, amount] of [[a, 1 - t], [b, t]])
+        for (const layer of layers) {
+            const weight = layer.weight * amount;
+            if (weight <= 0)
+                continue;
+            const key = JSON.stringify(layer.traits), prior = combined.get(key);
+            if (prior)
+                prior.weight += weight;
+            else
+                combined.set(key, { traits: layer.traits, weight });
+        }
+    return [...combined.values()];
+}
+export function mixPose(a, b, t) {
+    const result = { ...(t < .5 ? a : b) };
+    for (const key of numericKeys) {
+        let delta = b[key] - a[key];
+        if (key.startsWith('rotation'))
+            delta = ((delta + 180) % 360 + 360) % 360 - 180;
+        result[key] = a[key] + delta * t;
+    }
+    return result;
+}
+const smooth = (t) => { const v = Math.max(0, Math.min(1, t)); return v * v * (3 - 2 * v); };
+function featureAmount(a, b, blend) { return a === b ? 1 : blend < .5 ? 1 - smooth(blend * 2) : smooth((blend - .5) * 2); }
+const mod = (t, d) => ((t % d) + d) % d;
+export const gradientTurns = (beat) => Number.isFinite(beat.gradientTurns) ? Math.max(1, Math.min(8, Math.round(beat.gradientTurns))) : 1;
+export function sampleExpression(expression, time, expressions = [], visited = new Set()) {
+    const duration = expressionDuration(expression);
+    let t = mod(time, duration);
+    const gradient = isGradientExpression(expression);
+    let gradientStart = 0;
+    for (let i = 0; i < expression.beats.length; i++) {
+        const beat = expression.beats[i];
+        const beatDuration = safeDuration(beat.duration);
+        if (t < beatDuration || i === expression.beats.length - 1) {
+            const previous = expression.beats[(i - 1 + expression.beats.length) % expression.beats.length];
+            const transition = Math.min(.45, beatDuration * .4);
+            const progress = Math.min(t / transition, 1);
+            const eased = progress * progress * (3 - 2 * progress);
+            const turn = Math.min(1, t / beatDuration);
+            const turnEased = (1 - Math.cos(Math.PI * turn)) / 2;
+            const source = expressions.find(e => e.id === expression.poseExpressionId && !visited.has(e.id) && e.id !== expression.id);
+            const face = source ? sampleExpression(source, mod(time, duration) / duration * expressionDuration(source), expressions, new Set([...visited, expression.id])) : undefined;
+            return { pose: face?.pose ?? mixPose(previous.pose, beat.pose, eased), faceLayers: face?.faceLayers ?? mixFaceLayers(faceLayers(previous.pose), faceLayers(beat.pose), eased), beatIndex: i, propAmount: face?.propAmount ?? featureAmount(previous.pose.prop, beat.pose.prop, eased), tearAmount: face?.tearAmount ?? featureAmount(previous.pose.tears, beat.pose.tears, eased), ...(gradient ? { gradientRotation: gradientStart + (beat.gradientAction === 'rotate' ? 360 * gradientTurns(beat) * turnEased : 0), gradientMix: 1 } : {}) };
+        }
+        if (beat.gradientAction === 'rotate')
+            gradientStart += 360 * gradientTurns(beat);
+        t -= beatDuration;
+    }
+    return { pose: p(), faceLayers: faceLayers(p()), beatIndex: 0, propAmount: 1, tearAmount: 1 };
+}
+export function sampleDefinition(def, animationId, time, expressionId) {
+    const speedTime = Math.max(0, time) * def.character.speed;
+    const animation = def.animations.find(a => a.id === animationId) ?? def.animations[0];
+    let expression = def.expressions.find(e => e.id === expressionId) ?? def.expressions[0];
+    let local = speedTime, stepIndex = 0;
+    let previousExpression;
+    let blend = 1;
+    if (!expressionId && animation?.steps.length) {
+        const total = animationDuration(animation);
+        local = animation.loop ? mod(speedTime, total) : Math.min(speedTime, total - .00001);
+        for (let i = 0; i < animation.steps.length; i++) {
+            const step = animation.steps[i];
+            const stepDuration = safeDuration(step.duration);
+            if (local < stepDuration || i === animation.steps.length - 1) {
+                expression = def.expressions.find(e => e.id === step.expressionId) ?? expression;
+                stepIndex = i;
+                if (animation.steps.length > 1 && (i > 0 || animation.loop)) {
+                    const prev = animation.steps[(i - 1 + animation.steps.length) % animation.steps.length];
+                    previousExpression = def.expressions.find(e => e.id === prev.expressionId);
+                    blend = Math.min(1, local / Math.min(.35, stepDuration * .2));
+                }
+                local = local / stepDuration * expressionDuration(expression);
+                break;
+            }
+            local -= stepDuration;
+        }
+    }
+    const sample = sampleExpression(expression, local, def.expressions);
+    if (previousExpression && blend < 1) {
+        const previous = sampleExpression(previousExpression, expressionDuration(previousExpression) - .00001, def.expressions);
+        const eased = smooth(blend);
+        const oldProp = previous.pose.prop, oldTears = previous.pose.tears;
+        sample.propAmount *= featureAmount(oldProp, sample.pose.prop, eased);
+        sample.tearAmount *= featureAmount(oldTears, sample.pose.tears, eased);
+        sample.pose = mixPose(previous.pose, sample.pose, eased);
+        sample.faceLayers = mixFaceLayers(previous.faceLayers, sample.faceLayers, eased);
+        if (previous.gradientRotation !== undefined || sample.gradientRotation !== undefined) {
+            const from = previous.gradientRotation ?? 0, to = sample.gradientRotation ?? 0;
+            // Align the previous completed turn to the next expression's starting angle.
+            // Keep the incoming turn unwrapped so crossing 180 degrees cannot flip it.
+            const alignedFrom = from - Math.round(from / 360) * 360;
+            sample.gradientRotation = alignedFrom + (to - alignedFrom) * eased;
+            const fromMix = previous.gradientMix ?? 0;
+            sample.gradientMix = fromMix + ((sample.gradientMix ?? 0) - fromMix) * eased;
+        }
+    }
+    // All secondary motion uses the cycle period, so exported loops close exactly.
+    const period = expressionId ? expressionDuration(expression) : animation ? animationDuration(animation) : expressionDuration(expression);
+    const phase = 2 * Math.PI * mod(speedTime, period) / period;
+    const blinkCount = Math.max(1, Math.round(period / def.character.blinkInterval));
+    const blinkPhase = mod(speedTime + period * .17, period / blinkCount);
+    const gradientOnly = isGradientExpression(expression) && !expression.poseExpressionId;
+    const blink = !gradientOnly && def.character.blink && blinkPhase < .19 ? Math.sin(blinkPhase / .19 * Math.PI) ** 2 : 0;
+    return { ...sample, expressionId: expression.id, stepIndex, blink, effectPhase: mod(speedTime, period) / period * Math.max(1, Math.round(period / 2.4)), bob: gradientOnly ? 0 : Math.sin(phase) * def.character.motion, breathe: gradientOnly ? 0 : Math.cos(phase) * def.character.motion };
+}
+function obj(v) { if (!v || typeof v !== 'object' || Array.isArray(v))
+    throw new Error('This file is not a ClipLab project.'); return v; }
+function num(v, fallback, low, high) { return typeof v === 'number' && Number.isFinite(v) ? Math.min(high, Math.max(low, v)) : fallback; }
+function str(v, fallback, max = 80) { return typeof v === 'string' && v.trim() ? v.trim().slice(0, max) : fallback; }
+function color(v, fallback) { return typeof v === 'string' && /^#[0-9a-f]{6}$/i.test(v) ? v : fallback; }
+function choice(v, options, fallback) { return options.includes(v) ? v : fallback; }
+function boolean(v, fallback) { return typeof v === 'boolean' ? v : fallback; }
+function parsePose(value) {
+    const v = obj(value), pose = { ...BASE_POSE };
+    const ranges = { propSize: [.5, 2], propCount: [0, 6], propOutward: [0, 3], browStroke: [.3, 2.5], browLength: [.5, 2], blush: [0, 1], mouthStroke: [.5, 2.2], leftX: [-60, 60], rightX: [-60, 60], leftY: [-60, 60], rightY: [-60, 60], leftRotation: [-90, 90], rightRotation: [-90, 90], eyeSize: [.35, 2], eyeHeight: [.15, 2], spacing: [.5, 1.6], eyeTilt: [-45, 45], leftScale: [.3, 1.8], rightScale: [.3, 1.8], gazeX: [-1, 1], gazeY: [-1, 1], mouthWidth: [.3, 1.7], mouthOpen: [.1, 1], faceScale: [.6, 1.4], faceY: [-.3, .3], rotationX: [-180, 180], rotationY: [-180, 180], rotationZ: [-180, 180], squash: [.8, 1.2] };
+    for (const key of numericKeys) {
+        const [lo, hi] = ranges[key];
+        pose[key] = num(v[key], BASE_POSE[key], lo, hi);
+    }
+    return { ...pose, faceSet: choice(v.faceSet, ['set-1', 'set-2'], 'set-1'), brows: choice(v.brows, ['none', 'raised', 'worried', 'angry'], 'none'), eye: choice(v.eye, EYES, 'dot'), mouth: choice(v.mouth, MOUTHS, 'smile'), prop: choice(v.prop, PROPS, 'none'), tongue: boolean(v.tongue, false), teeth: boolean(v.teeth, false), drool: boolean(v.drool, false), cheeks: boolean(v.cheeks, false), tears: boolean(v.tears, false) };
+}
+export function parseCharacter(value) {
+    const v = obj(value), d = defaultProject().characters[0];
+    return { ...d, id: str(v.id, uid('character')), name: str(v.name, 'Character'), shape: choice(v.shape, ['capsule', 'cap', 'sphere'], 'capsule'), color: color(v.color, d.color), color2: color(v.color2, d.color2), gradient: boolean(v.gradient, true), gradientAngle: num(v.gradientAngle, -24, -180, 180), toon: boolean(v.toon, d.toon), trueFront: boolean(v.trueFront, false), lockPosition: boolean(v.lockPosition, false), eyeColor: color(v.eyeColor, d.eyeColor), iris: boolean(v.iris, false), elevated: boolean(v.elevated, false), elevation: num(v.elevation, .065, .005, .2), shadow: boolean(v.shadow, true), motion: num(v.motion, .45, 0, 1), speed: num(v.speed, 1, .25, 3), blink: boolean(v.blink, true), blinkInterval: num(v.blinkInterval, 4.2, 1, 12), followCursor: boolean(v.followCursor, false), followRotation: boolean(v.followRotation, false) };
+}
+function parseBeat(item, index) {
+    const b = obj(item);
+    return { id: str(b.id, `beat-${index}`), name: str(b.name, `Beat ${index + 1}`), duration: num(b.duration, 1.5, .2, 15), pose: parsePose(b.pose), ...(b.gradientAction === 'rotate' || b.gradientAction === 'hold' ? { gradientAction: b.gradientAction, ...(b.gradientTurns !== undefined ? { gradientTurns: Math.round(num(b.gradientTurns, 1, 1, 8)) } : {}) } : {}) };
+}
+export function parseProject(value) {
+    const v = obj(value);
+    if (v.version !== 1 || !Array.isArray(v.expressions) || !Array.isArray(v.animations))
+        throw new Error('Choose a ClipLab version 1 project or character definition.');
+    const charactersRaw = Array.isArray(v.characters) ? v.characters : v.character ? [v.character] : [];
+    if (!charactersRaw.length || charactersRaw.length > 30 || !v.expressions.length || v.expressions.length > 100 || !v.animations.length || v.animations.length > 100)
+        throw new Error('The project has an unsupported number of characters or sequences.');
+    const expressions = v.expressions.map((item, index) => {
+        const e = obj(item);
+        if (!Array.isArray(e.beats) || !e.beats.length || e.beats.length > 32)
+            throw new Error('Each expression needs 1–32 beats.');
+        return { id: str(e.id, `expression-${index}`), name: str(e.name, 'Expression'), description: str(e.description, '', 160), ...(typeof e.poseExpressionId === 'string' && e.poseExpressionId ? { poseExpressionId: e.poseExpressionId } : {}), beats: e.beats.map(parseBeat) };
+    });
+    if (new Set(expressions.map(e => e.id)).size !== expressions.length)
+        throw new Error('Expression names in the file must have unique IDs.');
+    for (const expression of expressions) {
+        const seen = new Set([expression.id]);
+        let sourceId = expression.poseExpressionId;
+        while (sourceId) {
+            const source = expressions.find(e => e.id === sourceId);
+            if (!source)
+                throw new Error('An expression refers to missing face motion.');
+            if (seen.has(sourceId))
+                throw new Error('Face motion expressions cannot refer back to themselves.');
+            seen.add(sourceId);
+            sourceId = source.poseExpressionId;
+        }
+    }
+    const animations = v.animations.map((item, index) => {
+        const a = obj(item);
+        if (!Array.isArray(a.steps) || !a.steps.length || a.steps.length > 64)
+            throw new Error('Each animation needs 1–64 steps.');
+        return { id: str(a.id, `animation-${index}`), name: str(a.name, 'Animation'), loop: boolean(a.loop, true), steps: a.steps.map((item, i) => { const s = obj(item); if (!expressions.some(e => e.id === s.expressionId))
+                throw new Error('An animation refers to a missing expression.'); return { id: str(s.id, `step-${i}`), expressionId: s.expressionId, duration: num(s.duration, 3, .2, 30) }; }) };
+    });
+    const characters = charactersRaw.map(parseCharacter);
+    if (new Set(characters.map(c => c.id)).size !== characters.length || new Set(animations.map(a => a.id)).size !== animations.length)
+        throw new Error('Characters and animations need unique IDs.');
+    return { version: 1, name: str(v.name, 'My character studio'), characters, expressions, animations, ...(Array.isArray(v.favoriteBeats) ? { favoriteBeats: v.favoriteBeats.slice(0, 200).map((item, i) => { const f = obj(item); return { id: str(f.id, `favorite-${i}`), sourceBeatId: str(f.sourceBeatId, ''), beat: parseBeat(f.beat, i) }; }) } : {}), ...(typeof v.defaultsRevision === 'number' ? { defaultsRevision: num(v.defaultsRevision, 2, 0, 1000) } : {}) };
+}
+/** Upgrade only untouched studio defaults, once; portable definitions stay literal. */
+export function upgradeStudioDefaults(project) {
+    if ((project.defaultsRevision ?? 0) >= 2)
+        return project;
+    const defaults = defaultExpressions();
+    for (const expression of project.expressions) {
+        const preset = defaults.find(e => e.id === expression.id);
+        if (!preset)
+            continue;
+        for (const beat of expression.beats)
+            if (beat.pose.faceScale === 1 && preset.beats.some(b => b.id === beat.id))
+                beat.pose.faceScale = .75;
+        if (expression.id === 'loading' && !expression.poseExpressionId && expression.beats.length === 2 && expression.beats.every(beat => {
+            const original = preset.beats.find(b => b.id === beat.id);
+            return original && original.gradientAction === beat.gradientAction && Object.keys(BASE_POSE).every(key => beat.pose[key] === BASE_POSE[key]);
+        }) && project.expressions.some(e => e.id === 'working'))
+            expression.poseExpressionId = 'working';
+    }
+    project.defaultsRevision = 2;
+    return project;
+}
+//# sourceMappingURL=model.js.map