@nadicodeai/ui 6.0.0 → 6.0.2

package/dist/internal/forma/geometry.js

@@ -0,0 +1,235 @@
+export const TAU = Math.PI * 2;
+const CAMERA_DISTANCE = 5.2;
+export const clamp = (value, low, high) => Math.max(low, Math.min(high, value));
+export const mix = (a, b, t) => a + (b - a) * t;
+export const smooth = (t) => {
+    const u = clamp(t, 0, 1);
+    return u * u * (3 - 2 * u);
+};
+const signedPow = (value, power) => Math.sign(value) * Math.pow(Math.abs(value), power);
+export const f3 = (value) => (Math.round(value * 1000) / 1000).toString();
+function lut(pts) {
+    const table = pts
+        .filter((p) => p[0] >= -0.001)
+        .map((p) => [Math.abs(p[0]), p[1]])
+        .sort((a, b) => a[1] - b[1]);
+    const height = Math.max(...pts.map((p) => Math.abs(p[1])));
+    const width = Math.max(...pts.map((p) => Math.abs(p[0])));
+    const first = table[0];
+    const last = table[table.length - 1];
+    const hw = (y) => {
+        if (!first || !last || y <= first[1] || y >= last[1])
+            return 0.02;
+        let best = 0.02;
+        for (let i = 1; i < table.length; i++) {
+            const b = table[i];
+            const a = table[i - 1];
+            if (b && a && b[1] >= y) {
+                const u = (y - a[1]) / Math.max(1e-6, b[1] - a[1]);
+                best = Math.max(best, mix(a[0], b[0], u));
+                break;
+            }
+        }
+        return best;
+    };
+    return { height, width, hw, outline: pts };
+}
+function superBody(spec) {
+    const { power, width, height, taper = 0 } = spec;
+    const radial = (y) => Math.sqrt(Math.max(0.03, 1 - (taper * y) / height));
+    const hw = (y) => {
+        const v = clamp(Math.abs(y / height), 0, 1);
+        return width * radial(y) * Math.pow(Math.max(0, 1 - Math.pow(v, power)), 1 / power);
+    };
+    const outline = [];
+    for (let i = 0; i < 96; i++) {
+        const t = (i / 96) * TAU;
+        const y = height * signedPow(Math.sin(t), 2 / power);
+        outline.push([width * radial(y) * signedPow(Math.cos(t), 2 / power), y]);
+    }
+    return { height, width, hw, outline };
+}
+function polyBody(vertices, rounds, cut) {
+    let pts = [...vertices];
+    for (let r = 0; r < rounds; r++) {
+        const next = [];
+        for (let i = 0; i < pts.length; i++) {
+            const a = pts[i];
+            const b = pts[(i + 1) % pts.length];
+            next.push([mix(a[0], b[0], cut), mix(a[1], b[1], cut)], [mix(a[0], b[0], 1 - cut), mix(a[1], b[1], 1 - cut)]);
+        }
+        pts = next;
+    }
+    return lut(pts);
+}
+function cloudBody(circles, bottom = -Infinity) {
+    const pts = [];
+    for (let i = 0; i < 144; i++) {
+        const a = (i / 144) * TAU;
+        const dx = Math.cos(a);
+        const dy = Math.sin(a);
+        let r = 0;
+        for (const [cx, cy, cr] of circles) {
+            const b = -2 * (dx * cx + dy * cy);
+            const c = cx * cx + cy * cy - cr * cr;
+            const disc = b * b - 4 * c;
+            if (disc >= 0)
+                r = Math.max(r, (-b + Math.sqrt(disc)) / 2);
+        }
+        if (dy < 0 && bottom > -Infinity)
+            r = Math.min(r, bottom / dy);
+        pts.push([dx * r, dy * r]);
+    }
+    return lut(pts);
+}
+function stadiumBody(halfLength, r) {
+    const pts = [];
+    for (let i = 0; i <= 40; i++) {
+        const a = -Math.PI / 2 + (i / 40) * Math.PI;
+        pts.push([halfLength + r * Math.cos(a), r * Math.sin(a)]);
+    }
+    for (let i = 0; i <= 40; i++) {
+        const a = Math.PI / 2 + (i / 40) * Math.PI;
+        pts.push([-halfLength + r * Math.cos(a), r * Math.sin(a)]);
+    }
+    return lut(pts);
+}
+const withCore = (body, core) => ({ ...body, core });
+export const bodies = {
+    nadia: withCore(superBody({ power: 2.3, width: 1, height: 0.965 }), { cy: 0, r: 1 }),
+    goccia: withCore(superBody({ power: 2, width: 1, height: 1.16, taper: 0.94 }), {
+        cy: -0.18,
+        r: 0.92,
+    }),
+    nuvola: withCore(cloudBody([
+        [0, -0.08, 0.8],
+        [-0.46, 0.34, 0.5],
+        [0.4, 0.42, 0.56],
+        [-0.72, -0.1, 0.42],
+        [0.74, -0.14, 0.4],
+    ], -0.86), { cy: -0.06, r: 0.84 }),
+    triangolo: withCore(polyBody([
+        [0, 1.42],
+        [1.28, -0.86],
+        [-1.28, -0.86],
+    ], 4, 0.22), { cy: -0.26, r: 0.8 }),
+    esagono: withCore(polyBody([0, 1, 2, 3, 4, 5].map((k) => {
+        const a = Math.PI / 2 + (k * Math.PI) / 3;
+        return [Math.cos(a) * 1.02, Math.sin(a) * 1.12];
+    }), 3, 0.16), { cy: 0, r: 0.84 }),
+    quadrato: withCore(superBody({ power: 3.6, width: 0.92, height: 0.97 }), { cy: 0, r: 0.9 }),
+    pillola: withCore(stadiumBody(0.4, 0.68), { cy: 0, r: 0.68 }),
+    uovo: withCore(superBody({ power: 2.2, width: 0.84, height: 1.06, taper: 0.5 }), {
+        cy: -0.16,
+        r: 0.84,
+    }),
+};
+const visorMask = { width: 0.86, height: 0.505, y: 0.055, power: 4.6 };
+export const eyeProfiles = {
+    nadia: { power: 2, width: 0.065, height: 0.151, spacing: 0.247, y: 0.069, signature: true },
+    goccia: { power: 4, width: 0.108, height: 0.054, spacing: 0.23, y: 0.015 },
+    nuvola: { power: 2, width: 0.108, height: 0.108, spacing: 0.23, y: 0.068 },
+    triangolo: { power: 3.8, width: 0.069, height: 0.12, spacing: 0.247, y: 0.054 },
+    esagono: { power: 2.6, width: 0.077, height: 0.116, spacing: 0.22, y: 0.068 },
+    quadrato: { power: 1.6, width: 0.095, height: 0.135, spacing: 0.245, y: 0.08 },
+    pillola: { power: 2, width: 0.108, height: 0.108, spacing: 0.23, y: 0.068 },
+    uovo: { power: 3.8, width: 0.069, height: 0.12, spacing: 0.247, y: 0.054 },
+};
+export function superellipse(hw, hh, power, n) {
+    const pts = [];
+    for (let i = 0; i < n; i++) {
+        const t = (i / n) * TAU;
+        pts.push([hw * signedPow(Math.cos(t), 2 / power), hh * signedPow(Math.sin(t), 2 / power)]);
+    }
+    return pts;
+}
+export const visorPoints = superellipse(visorMask.width, visorMask.height, visorMask.power, 48).map(([x, y]) => [x, y + visorMask.y]);
+export function closedPath(pts) {
+    const n = pts.length;
+    let d = "";
+    for (let i = 0; i < n; i++) {
+        const p0 = pts[(i + n - 1) % n];
+        const p1 = pts[i];
+        const p2 = pts[(i + 1) % n];
+        const p3 = pts[(i + 2) % n];
+        if (i === 0)
+            d += `M${f3(p1[0])} ${f3(p1[1])}`;
+        d += `C${f3(p1[0] + (p2[0] - p0[0]) / 6)} ${f3(p1[1] + (p2[1] - p0[1]) / 6)} ${f3(p2[0] - (p3[0] - p1[0]) / 6)} ${f3(p2[1] - (p3[1] - p1[1]) / 6)} ${f3(p2[0])} ${f3(p2[1])}`;
+    }
+    return `${d}Z`;
+}
+export function project(body, xs, ys, yaw, pitch) {
+    const { core } = body;
+    let lon = Math.asin(clamp(xs, -1, 1)) + yaw;
+    let lat = Math.asin(clamp(ys, -1, 1)) - pitch;
+    lon = Math.atan2(Math.sin(lon), Math.cos(lon)); // a full turn brings the face home
+    const front = Math.cos(lon) > 0 && Math.cos(lat) > 0;
+    lon = clamp(lon, -Math.PI / 2, Math.PI / 2);
+    lat = clamp(lat, -Math.PI / 2, Math.PI / 2);
+    const depth = Math.cos(lon) * Math.cos(lat) * core.r;
+    const perspective = CAMERA_DISTANCE / (CAMERA_DISTANCE - depth);
+    const foreshorten = Math.sqrt(perspective);
+    return {
+        x: Math.sin(lon) * Math.cos(lat) * core.r * perspective,
+        y: core.cy + Math.sin(lat) * core.r * 0.965 * perspective,
+        sx: Math.max(0.02, Math.cos(lon)) * core.r * foreshorten,
+        sy: Math.max(0.02, Math.cos(lat)) * core.r * foreshorten,
+        front,
+    };
+}
+const RING_OUTER = 1;
+const RING_INNER = 0.64;
+const RING_SAMPLES = 96;
+const radialProfiles = new WeakMap();
+function radialProfile(body) {
+    let profile = radialProfiles.get(body);
+    if (profile)
+        return profile;
+    const polar = body.outline
+        .map(([x, y]) => ({ angle: Math.atan2(y, x), radius: Math.hypot(x, y) }))
+        .sort((a, b) => a.angle - b.angle);
+    profile = [];
+    for (let i = 0; i < RING_SAMPLES; i++) {
+        let angle = (i / RING_SAMPLES) * TAU;
+        if (angle > Math.PI)
+            angle -= TAU;
+        let next = polar.findIndex((p) => p.angle >= angle);
+        if (next === -1)
+            next = 0;
+        const b = polar[next];
+        const a = polar[(next + polar.length - 1) % polar.length];
+        let span = b.angle - a.angle;
+        let offset = angle - a.angle;
+        if (span <= 0)
+            span += TAU;
+        if (offset < 0)
+            offset += TAU;
+        profile.push(mix(a.radius, b.radius, span > 0 ? offset / span : 0));
+    }
+    radialProfiles.set(body, profile);
+    return profile;
+}
+export function shellPath(body, morph) {
+    if (morph <= 0)
+        return closedPath(body.outline);
+    const profile = radialProfile(body);
+    const outer = profile.map((radius, i) => {
+        const angle = (i / RING_SAMPLES) * TAU;
+        const r = mix(radius, RING_OUTER, morph);
+        return [Math.cos(angle) * r, Math.sin(angle) * r];
+    });
+    const inner = outer.map(([x, y]) => [x * RING_INNER * morph, y * RING_INNER * morph]);
+    return closedPath(outer) + closedPath(inner);
+}
+export function stripePath(body, yaw, a, b) {
+    let d = "";
+    const base = Math.atan2(Math.sin(a + yaw), Math.cos(a + yaw));
+    const length = b - a;
+    for (const k of [-1, 0, 1]) {
+        const low = Math.max(base + k * TAU, -Math.PI / 2);
+        const high = Math.min(base + k * TAU + length, Math.PI / 2);
+        if (high > low)
+            d += `M${f3(Math.sin(low) * body.width)} -1.3H${f3(Math.sin(high) * body.width)}V1.3H${f3(Math.sin(low) * body.width)}Z`;
+    }
+    return d || "M0 0";
+}

package/dist/internal/forma/hallmark.d.ts

@@ -0,0 +1,5 @@
+export declare const ITALY_PATH = "M188.4,46.1L207.3,52.6L210.9,43.9L241.6,36L248.6,51.8L293.1,63.5L289.7,85.7L297.1,104.7L272.4,98.2L247.1,114L248.8,135.9L245,148.4L255.2,170.5L284.4,192.2L300,227.5L334.6,261.4L359,261.1L366.6,270.4L357.8,278.7L385.7,293.6L408.5,306.1L435.2,327.5L438.4,335.1L432.6,349.6L415.4,330.7L388.3,324L375.2,350.3L397.7,365.2L394,386.2L381,388.5L364.4,422.6L351.5,425.6L351.6,413.5L357.9,392.2L364.7,383.7L352.5,360.4L343,340L330.1,334.9L321,317.3L301,309.9L287.5,293.3L264.5,290.6L240.2,271.9L211.7,244.6L190.6,220.2L180.9,177.9L165.4,172.9L140.1,158.6L125.8,164.4L107.8,184.5L94.9,187.7L98.4,168.9L81.6,163.4L73.6,129.6L84.3,116.1L75.2,99.5L76.5,86.9L89.9,96.4L104.9,94.3L122.3,79.1L127.7,86.2L142.5,84.8L149.2,66.7L172.3,72.3L186,64.7ZM322.8,416.3L346.4,412.9L335.2,443.9L339.8,456L333.3,476L309.5,461.4L293.7,457.2L250.3,437.3L254.6,417L291,420.6ZM134.5,305.2L150.1,292.4L168.7,321.6L164.4,375.2L150.2,372.6L137.5,386L125.8,375.4L124.5,326.6L117.4,303.1Z";
+export declare const ITALY_BOX = 512;
+export declare const HALLMARK_SIZE = 0.39;
+export declare const HALLMARK_LONGITUDE = 1.24;
+//# sourceMappingURL=hallmark.d.ts.map

package/dist/internal/forma/hallmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hallmark.d.ts","sourceRoot":"","sources":["../../../src/internal/forma/hallmark.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,07BACk6B,CAAC;AAE17B,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,eAAO,MAAM,kBAAkB,OAAO,CAAC"}

package/dist/internal/forma/hallmark.js

@@ -0,0 +1,4 @@
+export const ITALY_PATH = "M188.4,46.1L207.3,52.6L210.9,43.9L241.6,36L248.6,51.8L293.1,63.5L289.7,85.7L297.1,104.7L272.4,98.2L247.1,114L248.8,135.9L245,148.4L255.2,170.5L284.4,192.2L300,227.5L334.6,261.4L359,261.1L366.6,270.4L357.8,278.7L385.7,293.6L408.5,306.1L435.2,327.5L438.4,335.1L432.6,349.6L415.4,330.7L388.3,324L375.2,350.3L397.7,365.2L394,386.2L381,388.5L364.4,422.6L351.5,425.6L351.6,413.5L357.9,392.2L364.7,383.7L352.5,360.4L343,340L330.1,334.9L321,317.3L301,309.9L287.5,293.3L264.5,290.6L240.2,271.9L211.7,244.6L190.6,220.2L180.9,177.9L165.4,172.9L140.1,158.6L125.8,164.4L107.8,184.5L94.9,187.7L98.4,168.9L81.6,163.4L73.6,129.6L84.3,116.1L75.2,99.5L76.5,86.9L89.9,96.4L104.9,94.3L122.3,79.1L127.7,86.2L142.5,84.8L149.2,66.7L172.3,72.3L186,64.7ZM322.8,416.3L346.4,412.9L335.2,443.9L339.8,456L333.3,476L309.5,461.4L293.7,457.2L250.3,437.3L254.6,417L291,420.6ZM134.5,305.2L150.1,292.4L168.7,321.6L164.4,375.2L150.2,372.6L137.5,386L125.8,375.4L124.5,326.6L117.4,303.1Z";
+export const ITALY_BOX = 512;
+export const HALLMARK_SIZE = 0.39;
+export const HALLMARK_LONGITUDE = 1.24;

package/dist/internal/forma/model.d.ts

@@ -0,0 +1,53 @@
+export declare const formaForms: readonly ["nadia", "goccia", "nuvola", "triangolo", "esagono", "quadrato", "pillola", "uovo"];
+export type FormaForm = (typeof formaForms)[number];
+/** The forms a customer may choose; Nadia's is reserved for the root Agent. */
+export declare const formaChoices: ("goccia" | "nuvola" | "triangolo" | "esagono" | "quadrato" | "pillola" | "uovo")[];
+export type FormaChoice = (typeof formaChoices)[number];
+export declare const formaStates: readonly ["idle", "working", "thinking", "waiting", "blocked", "done"];
+export type FormaState = (typeof formaStates)[number];
+export type FormaView = "front" | "side";
+export declare const formaColors: readonly ["verde", "cobalto", "rosso", "arancio", "giallo", "avorio"];
+export type FormaColor = (typeof formaColors)[number];
+/** The CSS custom property that carries each shell colour. */
+export declare const formaColorVariable: Record<FormaColor, string>;
+/** The three pigments that sweep a completion, the shell's own leading. */
+export declare const celebrationColors: Record<FormaColor, readonly [FormaColor, FormaColor, FormaColor]>;
+export type FormaVisor = "black" | "ivory";
+export type FormaEyeTone = "light" | "ink";
+export interface FormDetail {
+    name: string;
+    /** The shell colour a form wears until the customer picks one. */
+    pigment: FormaColor;
+    /** The visor fill, and the tone the eyes take against it. */
+    visor: FormaVisor;
+    eyes: FormaEyeTone;
+}
+export declare const formDetails: Record<FormaForm, FormDetail>;
+/** The form an Agent wears until a customer chooses one. */
+export declare const defaultForm: FormaChoice;
+export interface FormaOptions {
+    form: FormaForm;
+    /** Shell colour. Nadia always keeps her tricolour. */
+    color?: FormaColor;
+    state?: FormaState;
+    /** CSS pixels, 12 through 512. Default 32. */
+    size?: number;
+    /** Hold a deterministic still. Default false. */
+    paused?: boolean;
+    /** Turn to show the flank. Waiting and blocked always face forward. */
+    view?: FormaView;
+    /** Changing this key replays a gesture even if the state is unchanged. */
+    motionKey?: string | number;
+}
+export interface ResolvedFormaOptions {
+    form: FormaForm;
+    color?: FormaColor;
+    state: FormaState;
+    size: number;
+    paused: boolean;
+    view: FormaView;
+    motionKey?: string | number;
+}
+export declare function resolveFormaOptions(options: FormaOptions): ResolvedFormaOptions;
+export declare function shellColor(options: Pick<ResolvedFormaOptions, "form" | "color">): FormaColor;
+//# sourceMappingURL=model.d.ts.map

package/dist/internal/forma/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/internal/forma/model.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,+FASb,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD,+EAA+E;AAC/E,eAAO,MAAM,YAAY,qFAExB,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,WAAW,wEAAyE,CAAC;AAClG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,eAAO,MAAM,WAAW,uEAAwE,CAAC;AACjG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAOzD,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAQ7F,CAAC;AAEJ,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAC3C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,UAAU,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,CASrD,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,WAAW,EAAE,WAAoB,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,oBAAoB,CAoB/E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,UAAU,CAE5F"}

package/dist/internal/forma/model.js

@@ -0,0 +1,70 @@
+export const formaForms = [
+    "nadia",
+    "goccia",
+    "nuvola",
+    "triangolo",
+    "esagono",
+    "quadrato",
+    "pillola",
+    "uovo",
+];
+/** The forms a customer may choose; Nadia's is reserved for the root Agent. */
+export const formaChoices = formaForms.filter((form) => form !== "nadia");
+export const formaStates = ["idle", "working", "thinking", "waiting", "blocked", "done"];
+export const formaColors = ["verde", "cobalto", "rosso", "arancio", "giallo", "avorio"];
+/** The CSS custom property that carries each shell colour. */
+export const formaColorVariable = {
+    verde: "--nc-identity-verde",
+    cobalto: "--nc-identity-cobalto",
+    rosso: "--nc-identity-rosso",
+    arancio: "--nc-identity-arancio",
+    giallo: "--nc-identity-giallo",
+    avorio: "--nc-forma-avorio",
+};
+/** The three pigments that sweep a completion, the shell's own leading. */
+export const celebrationColors = {
+    verde: ["verde", "cobalto", "giallo"],
+    cobalto: ["cobalto", "verde", "giallo"],
+    rosso: ["rosso", "arancio", "giallo"],
+    arancio: ["arancio", "rosso", "giallo"],
+    giallo: ["giallo", "verde", "cobalto"],
+    avorio: ["avorio", "cobalto", "verde"],
+};
+export const formDetails = {
+    nadia: { name: "Nadia", pigment: "verde", visor: "black", eyes: "light" },
+    goccia: { name: "Goccia", pigment: "rosso", visor: "black", eyes: "light" },
+    nuvola: { name: "Nuvola", pigment: "cobalto", visor: "ivory", eyes: "ink" },
+    triangolo: { name: "Triangolo", pigment: "verde", visor: "ivory", eyes: "ink" },
+    esagono: { name: "Esagono", pigment: "giallo", visor: "black", eyes: "light" },
+    quadrato: { name: "Quadrato", pigment: "arancio", visor: "ivory", eyes: "ink" },
+    pillola: { name: "Pillola", pigment: "verde", visor: "black", eyes: "light" },
+    uovo: { name: "Uovo", pigment: "cobalto", visor: "black", eyes: "light" },
+};
+/** The form an Agent wears until a customer chooses one. */
+export const defaultForm = "uovo";
+export function resolveFormaOptions(options) {
+    if (!formaForms.includes(options.form))
+        throw new TypeError("Unknown Forma avatar form");
+    if (options.color !== undefined && !formaColors.includes(options.color))
+        throw new TypeError("Unknown Forma avatar colour");
+    const state = options.state ?? "idle";
+    if (!formaStates.includes(state))
+        throw new TypeError("Unknown Forma avatar state");
+    const size = options.size ?? 32;
+    if (!Number.isFinite(size) || size < 12 || size > 512)
+        throw new RangeError("Forma avatar size must be 12–512 CSS pixels");
+    if (options.view !== undefined && options.view !== "front" && options.view !== "side")
+        throw new TypeError("Unknown Forma avatar view");
+    return {
+        form: options.form,
+        color: options.form === "nadia" ? undefined : options.color,
+        state,
+        size,
+        paused: options.paused ?? false,
+        view: state === "waiting" || state === "blocked" ? "front" : (options.view ?? "front"),
+        motionKey: options.motionKey,
+    };
+}
+export function shellColor(options) {
+    return options.form === "nadia" ? "verde" : (options.color ?? formDetails[options.form].pigment);
+}

package/dist/internal/forma/motion.d.ts

@@ -0,0 +1,42 @@
+import type { ResolvedFormaOptions } from "./model.js";
+export declare const easeOut: (x: number) => number;
+export declare const easeInOut: (x: number) => number;
+declare function makePose(): {
+    yaw: number;
+    pitch: number;
+    roll: number;
+    lift: number;
+    stretch: number;
+    open: number;
+    gazeX: number;
+    gazeY: number;
+    morph: number;
+    working: number;
+    waiting: number;
+    thinking: number;
+    done: number;
+};
+export type Pose = ReturnType<typeof makePose>;
+type SpringChannel = "pitch" | "roll" | "lift" | "stretch";
+export interface FormaMotion extends ResolvedFormaOptions {
+    pose: Pose;
+    velocity: Record<SpringChannel, number>;
+    pointer: {
+        x: number;
+        y: number;
+    };
+    started: number;
+    entered: number;
+    lastTime: number;
+    celebratedAt: number;
+    skipEntry: boolean;
+    snap: boolean;
+    still: boolean;
+}
+export declare function createMotion(options: ResolvedFormaOptions, now: number): FormaMotion;
+export declare function updateMotion(motion: FormaMotion, options: ResolvedFormaOptions, now: number): void;
+export declare function needsMotion(motion: FormaMotion, now: number): boolean;
+export declare function settled(motion: FormaMotion, now: number): boolean;
+export declare function stepPose(motion: FormaMotion, now: number, dt: number): Pose;
+export {};
+//# sourceMappingURL=motion.d.ts.map

package/dist/internal/forma/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../../src/internal/forma/motion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAqBpD,eAAO,MAAM,OAAO,MAhBP,MAAM,KAAG,MAgByB,CAAC;AAChD,eAAO,MAAM,SAAS,MAjBT,MAAM,KAAG,MAiB4B,CAAC;AAEnD,iBAAS,QAAQ;;;;;;;;;;;;;;EAgBhB;AACD,MAAM,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC/C,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,WAAY,SAAQ,oBAAoB;IACvD,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAcpF;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,MAAM,GACV,IAAI,CAYN;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAOrE;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQjE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAsG3E"}

package/dist/internal/forma/motion.js

@@ -0,0 +1,194 @@
+import { TAU, clamp, mix } from "./geometry.js";
+function bezier(x1, y1, x2, y2) {
+    const coordinate = (t, a, b) => 3 * (1 - t) * (1 - t) * t * a + 3 * (1 - t) * t * t * b + t * t * t;
+    return (x) => {
+        const target = clamp(x, 0, 1);
+        let low = 0;
+        let high = 1;
+        let t = target;
+        for (let i = 0; i < 12; i++) {
+            if (coordinate(t, x1, x2) < target)
+                low = t;
+            else
+                high = t;
+            t = (low + high) / 2;
+        }
+        return coordinate(t, y1, y2);
+    };
+}
+const SPRING_STIFFNESS = 100;
+const SPRING_DAMPING = 10;
+export const easeOut = bezier(0.23, 1, 0.32, 1);
+export const easeInOut = bezier(0.77, 0, 0.175, 1);
+function makePose() {
+    return {
+        yaw: -0.16,
+        pitch: 0.02,
+        roll: 0,
+        lift: 0,
+        stretch: 1,
+        open: 1,
+        gazeX: 0,
+        gazeY: 0,
+        morph: 0,
+        working: 0,
+        waiting: 0,
+        thinking: 0,
+        done: 0,
+    };
+}
+export function createMotion(options, now) {
+    return {
+        ...options,
+        pose: makePose(),
+        velocity: { pitch: 0, roll: 0, lift: 0, stretch: 0 },
+        pointer: { x: 0, y: 0 },
+        started: now,
+        entered: now,
+        lastTime: now,
+        celebratedAt: -Infinity,
+        skipEntry: true,
+        snap: true,
+        still: options.paused,
+    };
+}
+export function updateMotion(motion, options, now) {
+    const formChanged = options.form !== motion.form;
+    const event = options.state !== motion.state || options.motionKey !== motion.motionKey;
+    if (formChanged)
+        Object.assign(motion, createMotion(options, now));
+    else if (event) {
+        motion.entered = now;
+        motion.skipEntry = options.paused;
+        motion.celebratedAt = options.state === "done" && !options.paused ? now : -Infinity;
+    }
+    if (options.paused !== motion.paused || options.view !== motion.view)
+        motion.snap = options.paused;
+    Object.assign(motion, options);
+}
+export function needsMotion(motion, now) {
+    if (motion.still)
+        return false;
+    const age = now - motion.entered;
+    if (motion.state === "waiting")
+        return age < 900;
+    if (motion.state === "blocked")
+        return age < 1000;
+    if (motion.state === "done")
+        return !motion.skipEntry && age < 2500;
+    return true;
+}
+export function settled(motion, now) {
+    const t = (now - motion.entered) / 1000;
+    return (motion.still ||
+        (motion.state === "done" && (motion.skipEntry || t >= 2.45)) ||
+        (motion.state === "waiting" && t >= 0.85) ||
+        (motion.state === "blocked" && t >= 1));
+}
+export function stepPose(motion, now, dt) {
+    const { pose, velocity, state: current, still } = motion;
+    const t = (now - motion.entered) / 1000;
+    const clock = (now - motion.started) / 1000;
+    const point = motion.pointer;
+    const instant = still ||
+        motion.snap ||
+        (current === "waiting" && t > 0.85) ||
+        (current === "blocked" && t >= 1) ||
+        (current === "done" && t >= 2.45);
+    const blend = instant ? 1 : 1 - Math.exp(-12 * dt);
+    motion.snap = false;
+    const target = makePose();
+    if (current === "working")
+        Object.assign(target, { yaw: 0, pitch: 0.16, open: 0.76, gazeY: -0.04, working: 1 });
+    if (current === "waiting")
+        Object.assign(target, { yaw: 0, pitch: -0.025, open: 1.1, gazeY: 0, waiting: 1 });
+    if (current === "thinking")
+        Object.assign(target, {
+            yaw: 0.15,
+            pitch: -0.17,
+            roll: -0.09,
+            lift: 0.025,
+            open: 0.96,
+            gazeX: 0.065,
+            gazeY: 0.075,
+            thinking: 1,
+        });
+    if (current === "done")
+        Object.assign(target, { yaw: 0, pitch: -0.015, open: 0.24, gazeY: 0.018, done: 1 });
+    if (current === "blocked")
+        Object.assign(target, { yaw: 0, pitch: 0, morph: 1, open: 0.4 });
+    if (!still) {
+        if (current === "idle") {
+            target.yaw += Math.sin(t * 0.7) * 0.018 + point.x * 0.9;
+            target.pitch += point.y * 0.5;
+            target.gazeX = point.x * 0.11;
+            target.gazeY = -point.y * 0.07;
+            target.lift = Math.sin(t * 1.1) * 0.009;
+        }
+        if (current === "working") {
+            const scan = Math.sin((clock * TAU) / 3.2);
+            const beat = Math.sin((clock * TAU) / 1.05);
+            target.gazeX = scan * 0.085;
+            target.yaw = scan * 0.15;
+            target.roll = -scan * 0.036;
+            target.pitch += beat * 0.033;
+            target.lift = 0.015 * beat;
+            target.open += beat * 0.08;
+            if (!motion.skipEntry && t < 0.5) {
+                const acknowledge = Math.sin((t / 0.5) * Math.PI);
+                target.pitch += 0.17 * acknowledge;
+                target.lift -= 0.065 * acknowledge;
+            }
+        }
+        if (current === "thinking") {
+            const consider = Math.sin((clock * TAU) / 4.6);
+            target.yaw += consider * 0.07;
+            target.roll += consider * 0.035;
+            target.gazeX += consider * 0.019;
+            target.lift += consider * 0.015;
+        }
+        if (current === "done" && !motion.skipEntry && t < 1.65) {
+            const windup = 1 - easeOut((t - 0.2) / 0.16);
+            target.yaw = -0.16 * windup + TAU * easeInOut((t - 0.2) / 0.78);
+            target.pitch = 0.13 * windup - 0.07 * Math.sin(clamp((t - 0.2) / 0.78, 0, 1) * Math.PI);
+            target.roll = -0.11 * windup + 0.12 * Math.sin(clamp((t - 0.2) / 0.88, 0, 1) * TAU);
+            if (t < 0.2)
+                target.lift = -0.07 * easeOut(t / 0.2);
+            else if (t < 0.53)
+                target.lift = mix(-0.07, 0.24, easeOut((t - 0.2) / 0.33));
+            else if (t < 0.98)
+                target.lift = 0.24 * (1 - easeInOut((t - 0.53) / 0.45));
+            else
+                target.lift = 0.042 * Math.sin(clamp((t - 0.98) / 0.4, 0, 1) * Math.PI);
+            target.stretch =
+                1 - 0.032 * windup + 0.024 * Math.sin(clamp((t - 0.2) / 0.78, 0, 1) * Math.PI);
+        }
+        if (current === "working" || current === "thinking") {
+            target.yaw += point.x * 0.45;
+            target.pitch += point.y * 0.2;
+        }
+    }
+    if (motion.view === "side")
+        Object.assign(target, { yaw: -1.2, pitch: 0.02, roll: 0, gazeX: 0, gazeY: 0 });
+    target.yaw =
+        pose.yaw + Math.atan2(Math.sin(target.yaw - pose.yaw), Math.cos(target.yaw - pose.yaw));
+    for (const key of Object.keys(pose)) {
+        if (key in velocity && !instant) {
+            const channel = key;
+            const steps = Math.max(1, Math.ceil(dt * 120));
+            const step = dt / steps;
+            for (let i = 0; i < steps; i++) {
+                velocity[channel] +=
+                    (SPRING_STIFFNESS * (target[key] - pose[key]) - SPRING_DAMPING * velocity[channel]) *
+                        step;
+                pose[key] += velocity[channel] * step;
+            }
+        }
+        else {
+            pose[key] = mix(pose[key], target[key], blend);
+            if (key in velocity)
+                velocity[key] = 0;
+        }
+    }
+    return pose;
+}

package/dist/internal/forma/rig.d.ts

@@ -0,0 +1,10 @@
+import type { ResolvedFormaOptions } from "./model.js";
+export interface FormaHandle {
+    update(options: ResolvedFormaOptions): void;
+    dispose(): void;
+}
+export interface FormaMountCallbacks {
+    onModeChange?: (mode: "live" | "still") => void;
+}
+export declare function mountForma(svg: SVGSVGElement, options: ResolvedFormaOptions, callbacks?: FormaMountCallbacks): FormaHandle;
+//# sourceMappingURL=rig.d.ts.map

package/dist/internal/forma/rig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rig.d.ts","sourceRoot":"","sources":["../../../src/internal/forma/rig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAUpD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,IAAI,CAAC;CACjB;AACD,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC;CACjD;AAyLD,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,oBAAoB,EAC7B,SAAS,GAAE,mBAAwB,GAClC,WAAW,CAwCb"}