@dotcraft/avatar 0.6.3

package/dist/composer/styles/overdrive.css

@@ -0,0 +1,264 @@
+[data-mascot-context='max'] .composer-mascot-motion {
+  --mascot-max-edge: oklch(from var(--mascot-energy-accent)
+    clamp(0.28, calc(l + 0.065), 0.96) clamp(0, calc(c * 0.96), 0.3) calc(h + 4));
+  --mascot-max-shift: oklch(from var(--mascot-energy-accent)
+    clamp(0.28, calc(l + 0.1), 0.96) clamp(0, calc(c * 0.92), 0.3) calc(h + 40));
+  --mascot-max-bright: oklch(from var(--mascot-energy-accent)
+    clamp(0.28, calc(l + 0.18), 0.96) clamp(0, calc(c * 0.68), 0.3) calc(h + 18));
+  --mascot-max-edge-bold: rgb(from var(--mascot-max-edge) r g b / 1);
+  --mascot-max-edge-faint: rgb(from var(--mascot-max-edge) r g b / 0.24);
+  --mascot-max-shift-bold: rgb(from var(--mascot-max-shift) r g b / 1);
+  --mascot-max-shift-medium: rgb(from var(--mascot-max-shift) r g b / 0.88);
+  --mascot-max-shift-soft: rgb(from var(--mascot-max-shift) r g b / 0.44);
+  --mascot-max-bright-medium: rgb(from var(--mascot-max-bright) r g b / 0.88);
+  --mascot-max-blur-hair: 1.4px;
+  --mascot-max-blur-edge: 2.4px;
+  --mascot-max-blur-glow: 6.8px;
+}
+
+.composer-mascot-motion::after {
+  content: '';
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  z-index: 3;
+  width: 104px;
+  height: 90px;
+  border-radius: 48%;
+  opacity: 0;
+  pointer-events: none;
+  transform: translate(-50%, -50%);
+  transform-origin: center;
+}
+
+[data-mascot-context='max'] .composer-mascot-motion::after {
+  background:
+    radial-gradient(circle, var(--mascot-max-bright) 0 0.55px, transparent 1.1px) 13% 42% / 3px 3px no-repeat,
+    radial-gradient(circle, var(--mascot-max-edge) 0 0.45px, transparent 1px) 27% 74% / 3px 3px no-repeat,
+    radial-gradient(circle, var(--mascot-max-shift) 0 0.5px, transparent 1.05px) 42% 18% / 3px 3px no-repeat,
+    radial-gradient(circle, var(--mascot-max-bright) 0 0.45px, transparent 1px) 68% 80% / 3px 3px no-repeat,
+    radial-gradient(circle, var(--mascot-max-edge) 0 0.55px, transparent 1.1px) 82% 28% / 3px 3px no-repeat,
+    radial-gradient(circle, var(--mascot-max-shift) 0 0.4px, transparent 0.95px) 91% 62% / 3px 3px no-repeat;
+  filter: drop-shadow(0 0 1.6px color-mix(in srgb, var(--mascot-max-edge) 32%, transparent));
+  opacity: 0.18;
+  animation: composer-mascot-max-micrograin 6.2s ease-in-out infinite;
+}
+
+@keyframes composer-mascot-max-overdrive-edge {
+  0%, 100% {
+    filter:
+      drop-shadow(-0.6px 0 var(--mascot-max-blur-hair) var(--mascot-max-edge-bold))
+      drop-shadow(0.7px 0 var(--mascot-max-blur-edge) var(--mascot-max-shift-medium))
+      drop-shadow(0 0 var(--mascot-max-blur-glow) var(--mascot-max-edge-faint));
+  }
+  46% {
+    filter:
+      drop-shadow(0.2px -0.75px var(--mascot-max-blur-hair) var(--mascot-max-shift-bold))
+      drop-shadow(-0.2px 0.8px var(--mascot-max-blur-edge) var(--mascot-max-bright-medium))
+      drop-shadow(0 0 var(--mascot-max-blur-glow) var(--mascot-max-shift-soft));
+  }
+}
+
+@keyframes composer-mascot-max-coat-dark {
+  0%, 34%, 100% { stop-color: var(--mascot-body-dark); }
+  14% {
+    stop-color: oklch(from var(--mascot-body-dark)
+      clamp(0.28, calc(l + 0.09), 0.96) clamp(0, calc(c * 0.9), 0.3) calc(h + 14));
+  }
+}
+
+@keyframes composer-mascot-max-coat-mid {
+  0%, 24%, 68%, 100% { stop-color: var(--mascot-body-mid); }
+  44% {
+    stop-color: oklch(from var(--mascot-body-mid)
+      clamp(0.28, calc(l + 0.14), 0.96) clamp(0, calc(c * 0.76), 0.3) calc(h + 31));
+  }
+}
+
+@keyframes composer-mascot-max-coat-light {
+  0%, 50%, 94%, 100% { stop-color: var(--mascot-body-light); }
+  72% {
+    stop-color: oklch(from var(--mascot-body-light)
+      clamp(0.28, calc(l + 0.15), 0.96) clamp(0, calc(c * 0.58), 0.3) calc(h + 41));
+  }
+}
+
+@keyframes composer-mascot-max-coat-mark-dark {
+  0%, 44%, 100% { stop-color: var(--mascot-mark-dark); }
+  20% {
+    stop-color: oklch(from var(--mascot-mark-dark)
+      clamp(0.28, calc(l + 0.1), 0.96) clamp(0, calc(c * 0.82), 0.3) calc(h + 18));
+  }
+}
+
+@keyframes composer-mascot-max-coat-mark-light {
+  0%, 40%, 88%, 100% { stop-color: var(--mascot-mark-energy); }
+  64% {
+    stop-color: oklch(from var(--mascot-mark-energy)
+      clamp(0.28, calc(l + 0.15), 0.96) clamp(0, calc(c * 0.6), 0.3) calc(h + 38));
+  }
+}
+
+@keyframes composer-mascot-max-micrograin {
+  0%, 100% { opacity: 0.08; transform: translate(-51%, -49%) scale(0.98); }
+  38% { opacity: 0.28; transform: translate(-49%, -52%) scale(1.02); }
+  68% { opacity: 0.13; transform: translate(-48%, -54%) scale(1.04); }
+}
+
+[data-mascot-profile-transition='active'] .composer-mascot-character-stage {
+  transform-origin: 50% 52%;
+  animation: composer-mascot-profile-character 1.24s linear both;
+}
+
+[data-mascot-profile-transition='active'] .composer-mascot-motion::before {
+  content: '';
+  position: absolute;
+  top: 52%;
+  left: 50%;
+  z-index: 1;
+  width: 64px;
+  height: 64px;
+  box-sizing: border-box;
+  border: 1px solid transparent;
+  border-radius: 50%;
+  background: radial-gradient(
+    circle,
+    #010106 0 34%,
+    #05050c 38%,
+    rgba(232, 236, 255, 0.78) 42%,
+    rgba(135, 145, 180, 0.18) 48%,
+    transparent 66%
+  );
+  opacity: 0;
+  pointer-events: none;
+  transform: translate(-50%, -50%) scale(0.16);
+  transform-origin: center;
+  animation:
+    composer-mascot-profile-hole 1.24s linear both,
+    composer-mascot-profile-rim 1.24s linear both;
+}
+
+[data-mascot-profile-transition='active'] .composer-mascot-motion::after {
+  top: 52%;
+  left: 50%;
+  z-index: 1;
+  width: 86px;
+  height: 86px;
+  border-radius: 50%;
+  color: var(--mascot-profile-from-accent);
+  background:
+    radial-gradient(circle, currentColor 0 0.9px, transparent 1.55px) 50% 2% / 4px 4px no-repeat,
+    radial-gradient(circle, currentColor 0 0.76px, transparent 1.4px) 78% 12% / 4px 4px no-repeat,
+    radial-gradient(circle, rgba(255, 255, 255, 0.88) 0 0.65px, transparent 1.3px) 96% 42% / 4px 4px no-repeat,
+    radial-gradient(circle, currentColor 0 0.82px, transparent 1.48px) 88% 76% / 4px 4px no-repeat,
+    radial-gradient(circle, currentColor 0 0.9px, transparent 1.55px) 55% 98% / 4px 4px no-repeat,
+    radial-gradient(circle, rgba(255, 255, 255, 0.8) 0 0.65px, transparent 1.3px) 19% 86% / 4px 4px no-repeat,
+    radial-gradient(circle, currentColor 0 0.76px, transparent 1.4px) 3% 55% / 4px 4px no-repeat,
+    radial-gradient(circle, currentColor 0 0.82px, transparent 1.48px) 14% 20% / 4px 4px no-repeat;
+  filter: drop-shadow(0 0 3px currentColor);
+  opacity: 0;
+  animation:
+    composer-mascot-profile-particles 1.24s linear both,
+    composer-mascot-profile-particle-color 1.24s linear both;
+}
+
+[data-composer-root]:has([data-mascot-profile-transition='active']) .composer-mascot-contact-shadow {
+  animation: composer-mascot-profile-contact-shadow 1.24s linear both;
+}
+
+@keyframes composer-mascot-profile-character {
+  0%, 100% {
+    opacity: 1;
+    transform: translateY(0) rotate(0) scale(1);
+    filter: none;
+  }
+  18% {
+    opacity: 1;
+    transform: translateY(0) rotate(0) scale(1.015, 0.99);
+    filter: saturate(1.03);
+  }
+  34% {
+    opacity: 0.96;
+    transform: translateY(0) rotate(1.2deg) scale(0.76, 0.8);
+    filter: brightness(0.96) saturate(1.08);
+  }
+  46% {
+    opacity: 0.14;
+    transform: translateY(0) rotate(-4deg) scale(0.13);
+    filter: brightness(0.72) saturate(1.18) blur(0.7px);
+  }
+  48%, 52% {
+    opacity: 0;
+    transform: translateY(0) rotate(-6deg) scale(0.02);
+    filter: brightness(0.58) saturate(1.2) blur(1px);
+  }
+  64% {
+    opacity: 0.95;
+    transform: translateY(0) rotate(1.8deg) scale(1.1, 0.92);
+    filter: brightness(1.12);
+  }
+  76% {
+    opacity: 1;
+    transform: translateY(0) rotate(-0.8deg) scale(0.97, 1.035);
+    filter: none;
+  }
+  89% {
+    opacity: 1;
+    transform: translateY(0) rotate(0.3deg) scale(1.01, 0.995);
+    filter: none;
+  }
+}
+
+@keyframes composer-mascot-profile-hole {
+  0%, 12%, 100% { opacity: 0; transform: translate(-50%, -50%) scale(0.16); }
+  30% { opacity: 0.72; transform: translate(-50%, -50%) scale(0.72); }
+  46%, 54% { opacity: 1; transform: translate(-50%, -50%) scale(1); }
+  72% { opacity: 0.54; transform: translate(-50%, -50%) scale(0.66); }
+  88% { opacity: 0; transform: translate(-50%, -50%) scale(0.2); }
+}
+
+@keyframes composer-mascot-profile-particles {
+  0%, 14%, 100% { opacity: 0; transform: translate(-50%, -50%) rotate(0) scale(1); }
+  20% { opacity: 0.45; transform: translate(-50%, -50%) rotate(8deg) scale(1); }
+  34% { opacity: 0.92; transform: translate(-50%, -50%) rotate(38deg) scale(0.72); }
+  48% { opacity: 0.12; transform: translate(-50%, -50%) rotate(86deg) scale(0.16); }
+  49.5% { opacity: 0; transform: translate(-50%, -50%) rotate(96deg) scale(0.08); }
+  50.5% { opacity: 0; transform: translate(-50%, -50%) rotate(104deg) scale(1); }
+  64% { opacity: 0.82; transform: translate(-50%, -50%) rotate(146deg) scale(0.7); }
+  82% { opacity: 0.08; transform: translate(-50%, -50%) rotate(206deg) scale(0.14); }
+  86% { opacity: 0; transform: translate(-50%, -50%) rotate(218deg) scale(0.08); }
+}
+
+@keyframes composer-mascot-profile-particle-color {
+  0%, 42% { color: var(--mascot-profile-from-accent); }
+  49.5%, 50.5% { color: rgba(240, 244, 255, 0.96); }
+  58%, 100% { color: var(--mascot-profile-to-accent); }
+}
+
+@keyframes composer-mascot-profile-rim {
+  0%, 16% {
+    border-color: color-mix(in srgb, var(--mascot-profile-from-accent) 72%, transparent);
+    box-shadow: 0 0 12px color-mix(in srgb, var(--mascot-profile-from-accent) 42%, transparent);
+  }
+  34% {
+    border-color: color-mix(in srgb, var(--mascot-profile-from-accent) 84%, white);
+    box-shadow: 0 0 15px color-mix(in srgb, var(--mascot-profile-from-accent) 48%, transparent);
+  }
+  50% {
+    border-color: rgba(246, 248, 255, 0.92);
+    box-shadow: 0 0 17px rgba(220, 226, 255, 0.46);
+  }
+  66% {
+    border-color: color-mix(in srgb, var(--mascot-profile-to-accent) 84%, white);
+    box-shadow: 0 0 15px color-mix(in srgb, var(--mascot-profile-to-accent) 48%, transparent);
+  }
+  84%, 100% {
+    border-color: color-mix(in srgb, var(--mascot-profile-to-accent) 72%, transparent);
+    box-shadow: 0 0 12px color-mix(in srgb, var(--mascot-profile-to-accent) 36%, transparent);
+  }
+}
+
+@keyframes composer-mascot-profile-contact-shadow {
+  0%, 100% { opacity: 1; transform: translateX(50%) scaleX(1); }
+  46%, 54% { opacity: 0; transform: translateX(50%) scaleX(0.25); }
+}

package/dist/composer/styles/props.css

@@ -0,0 +1,21 @@
+@keyframes composer-mascot-land {
+  0%, 100% { transform: translateY(0) scale(1, 1); }
+  35% { transform: translateY(2px) scale(1.12, 0.86); }
+  70% { transform: translateY(-2px) scale(0.97, 1.03); }
+}
+
+.composer-mascot-land {
+  animation: composer-mascot-land 380ms ease-out;
+  transform-origin: bottom center;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .composer-mascot-motion,
+  .composer-mascot-motion * {
+    animation: none !important;
+    transition: none !important;
+  }
+}
+
+[data-composer-mascot-motion='off'],
+[data-composer-mascot-motion='off'] * { animation: none !important; transition: none !important; }

package/dist/composer/types.d.ts

@@ -0,0 +1,40 @@
+import type { ReactNode } from 'react';
+export type MascotExpression = 'neutral' | 'happy' | 'operator' | 'sleep';
+export type MascotLight = 'default' | 'error' | 'success';
+export interface ComposerMascotContext {
+    size: number;
+    activity: 'error' | 'success' | 'sleeping' | 'dragging' | 'decision' | 'working' | 'focused' | 'idle';
+    expression: MascotExpression;
+    light: MascotLight;
+    submitRevision: number;
+    reasoningEffort: 'off' | 'low' | 'medium' | 'high' | 'extraHigh';
+    speed: 'standard' | 'fast';
+    contextMax: boolean;
+    reducedMotion: boolean;
+}
+export interface ComposerMascotProps {
+    name?: string;
+    motion?: 'system' | 'on' | 'off';
+    focused?: boolean;
+    dragOver?: boolean;
+    bounceSignal?: number;
+    interaction?: {
+        expression?: MascotExpression;
+        light?: MascotLight;
+        hold?: 'sign';
+        bubble?: ReactNode;
+    };
+    reasoningEffort?: ComposerMascotContext['reasoningEffort'];
+    speed?: ComposerMascotContext['speed'];
+    contextMax?: boolean;
+    anchorOffset?: number;
+    anchorPushSignal?: number;
+    handoff?: boolean;
+    renderCharacter?: (character: ReactNode, context: ComposerMascotContext) => ReactNode;
+    renderMenu?: (position: {
+        x: number;
+        y: number;
+    }, close: () => void) => ReactNode;
+    onNameRendered?: (name: string | undefined) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/composer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/composer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;AACzE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;AACzD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;IACrG,UAAU,EAAE,gBAAgB,CAAA;IAC5B,KAAK,EAAE,WAAW,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;IAChE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAA;IAC1B,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,OAAO,CAAA;CACvB;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAA;IAChC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAAC,KAAK,CAAC,EAAE,WAAW,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE,CAAA;IACvG,eAAe,CAAC,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,CAAA;IAC1D,KAAK,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAA;IACtC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,qBAAqB,KAAK,SAAS,CAAA;IACrF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAA;IACjF,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;CACpD"}

package/dist/composer/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/composer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/composer/types.ts"],"names":[],"mappings":""}

package/dist/composer/useComposerAvatarBehavior.d.ts

@@ -0,0 +1,24 @@
+import type { AvatarPose } from '../index.js';
+import type { MascotExpression } from './types.js';
+export type ComposerAvatarGesture = 'blink' | 'look-left' | 'look-right' | 'antenna-bob';
+interface ComposerAvatarBehaviorOptions {
+    semanticPose: AvatarPose;
+    baseExpression: MascotExpression;
+    focused: boolean;
+    dragOver: boolean;
+    sleeping: boolean;
+    waving: boolean;
+    activeIdle: boolean;
+    bounceSignal: number;
+    reducedMotion: boolean;
+}
+export declare function useComposerAvatarBehavior(options: ComposerAvatarBehaviorOptions): {
+    pose: AvatarPose;
+    expression: 'base' | 'happy' | 'operator' | 'sleep' | undefined;
+    gesture: ComposerAvatarGesture | undefined;
+    gestureSequence: number;
+    clearGesture: () => void;
+    completeGesture: (sequence: number) => void;
+};
+export {};
+//# sourceMappingURL=useComposerAvatarBehavior.d.ts.map

package/dist/composer/useComposerAvatarBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComposerAvatarBehavior.d.ts","sourceRoot":"","sources":["../../src/composer/useComposerAvatarBehavior.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,CAAA;AAExF,UAAU,6BAA6B;IACrC,YAAY,EAAE,UAAU,CAAA;IACxB,cAAc,EAAE,gBAAgB,CAAA;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,6BAA6B,GAAG;IACjF,IAAI,EAAE,UAAU,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAA;IAC/D,OAAO,EAAE,qBAAqB,GAAG,SAAS,CAAA;IAC1C,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5C,CAuEA"}

package/dist/composer/useComposerAvatarBehavior.js

@@ -0,0 +1,72 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+export function useComposerAvatarBehavior(options) {
+    const [receiptAcknowledging, setReceiptAcknowledging] = useState(false);
+    const [gesture, setGesture] = useState();
+    const [gestureSequence, setGestureSequence] = useState(0);
+    const previousBounce = useRef(options.bounceSignal);
+    useEffect(() => {
+        if (options.reducedMotion || options.semanticPose !== 'idle') {
+            previousBounce.current = options.bounceSignal;
+            setReceiptAcknowledging(false);
+            return;
+        }
+        if (options.bounceSignal === previousBounce.current)
+            return;
+        previousBounce.current = options.bounceSignal;
+        setReceiptAcknowledging(true);
+        const timer = window.setTimeout(() => setReceiptAcknowledging(false), 350);
+        return () => window.clearTimeout(timer);
+    }, [options.bounceSignal, options.reducedMotion, options.semanticPose]);
+    useEffect(() => {
+        if (options.sleeping || options.activeIdle || options.reducedMotion) {
+            setGesture(undefined);
+            return;
+        }
+        if (options.baseExpression !== 'neutral' && options.baseExpression !== 'happy')
+            return;
+        let timer = 0;
+        const schedule = () => {
+            timer = window.setTimeout(() => {
+                if (!document.hidden) {
+                    const value = Math.random();
+                    const next = value < 0.5
+                        ? 'blink'
+                        : value < 0.72
+                            ? (Math.random() < 0.5 ? 'look-left' : 'look-right')
+                            : value < 0.86
+                                ? 'antenna-bob'
+                                : undefined;
+                    if (next) {
+                        setGesture(next);
+                        setGestureSequence((sequence) => sequence + 1);
+                    }
+                }
+                schedule();
+            }, 2600 + Math.random() * 3200);
+        };
+        schedule();
+        return () => { window.clearTimeout(timer); };
+    }, [options.sleeping, options.activeIdle, options.reducedMotion, options.baseExpression]);
+    const clearGesture = useCallback(() => setGesture(undefined), []);
+    const completeGesture = useCallback((sequence) => {
+        setGesture((current) => sequence === gestureSequence ? undefined : current);
+    }, [gestureSequence]);
+    const expression = options.semanticPose === 'idle'
+        ? options.waving || options.focused
+            ? 'happy'
+            : options.dragOver || options.baseExpression === 'operator'
+                ? 'operator'
+                : options.sleeping
+                    ? 'sleep'
+                    : 'base'
+        : undefined;
+    return {
+        pose: options.semanticPose === 'idle' && receiptAcknowledging ? 'acknowledge' : options.semanticPose,
+        expression,
+        gesture,
+        gestureSequence,
+        clearGesture,
+        completeGesture
+    };
+}
+//# sourceMappingURL=useComposerAvatarBehavior.js.map

package/dist/composer/useComposerAvatarBehavior.js.map

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

package/dist/composer/useComposerMotion.d.ts

@@ -0,0 +1,2 @@
+export declare function useComposerMotion(mode: 'system' | 'on' | 'off'): boolean;
+//# sourceMappingURL=useComposerMotion.d.ts.map

package/dist/composer/useComposerMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComposerMotion.d.ts","sourceRoot":"","sources":["../../src/composer/useComposerMotion.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,KAAK,WAY9D"}

package/dist/composer/useComposerMotion.js

@@ -0,0 +1,16 @@
+import { useEffect, useState } from 'react';
+import { prefersReducedMotion } from './constants.js';
+export function useComposerMotion(mode) {
+    const [reduced, setReduced] = useState(prefersReducedMotion);
+    useEffect(() => {
+        const update = () => setReduced(prefersReducedMotion());
+        const media = window.matchMedia?.('(prefers-reduced-motion: reduce)');
+        media?.addEventListener?.('change', update);
+        const observer = new MutationObserver(update);
+        observer.observe(document.documentElement, { attributes: true, attributeFilter: ['data-reduce-motion'] });
+        update();
+        return () => { media?.removeEventListener?.('change', update); observer.disconnect(); };
+    }, []);
+    return mode === 'on' || (mode === 'system' && !reduced);
+}
+//# sourceMappingURL=useComposerMotion.js.map

package/dist/composer/useComposerMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComposerMotion.js","sourceRoot":"","sources":["../../src/composer/useComposerMotion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACrD,MAAM,UAAU,iBAAiB,CAAC,IAA6B;IAC7D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IAC5D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,kCAAkC,CAAC,CAAA;QACrE,KAAK,EAAE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC3C,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAC7C,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAA;QACzG,MAAM,EAAE,CAAA;QACR,OAAO,GAAG,EAAE,GAAG,KAAK,EAAE,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAA,CAAC,CAAC,CAAA;IACxF,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,OAAO,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,CAAA;AACzD,CAAC"}

package/dist/composer/useComposerProfile.d.ts

@@ -0,0 +1,7 @@
+import { type MascotProfileTransition } from './constants.js';
+export declare function useComposerProfile(mascotName: string | undefined, reduced: boolean): {
+    avatar: string | undefined;
+    profileTransition: MascotProfileTransition | null;
+    profileTransitionRevision: number;
+};
+//# sourceMappingURL=useComposerProfile.d.ts.map

package/dist/composer/useComposerProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComposerProfile.d.ts","sourceRoot":"","sources":["../../src/composer/useComposerProfile.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2F,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACtJ,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO;;;;EA8ClF"}

package/dist/composer/useComposerProfile.js

@@ -0,0 +1,46 @@
+import { useLayoutEffect, useRef, useState } from 'react';
+import { deriveAppearance, mascotPaletteOf } from '../index.js';
+import { mascotNameKey, MASCOT_PROFILE_TRANSITION_SWAP_MS, MASCOT_PROFILE_TRANSITION_DURATION_MS } from './constants.js';
+export function useComposerProfile(mascotName, reduced) {
+    const [renderedMascotAvatar, setRenderedMascotAvatar] = useState(mascotName);
+    const [transitionState, setTransitionState] = useState({ revision: 0, transition: null });
+    const renderedMascotAvatarRef = useRef(renderedMascotAvatar);
+    const targetMascotAvatarRef = useRef(mascotName);
+    renderedMascotAvatarRef.current = renderedMascotAvatar;
+    targetMascotAvatarRef.current = mascotName;
+    const targetAvatarKey = mascotNameKey(mascotName);
+    useLayoutEffect(() => {
+        const currentAvatar = renderedMascotAvatarRef.current;
+        if (targetAvatarKey === mascotNameKey(currentAvatar)) {
+            setTransitionState(current => ({ ...current, transition: null }));
+            return undefined;
+        }
+        const nextAvatar = targetMascotAvatarRef.current;
+        if (reduced) {
+            renderedMascotAvatarRef.current = nextAvatar;
+            setRenderedMascotAvatar(nextAvatar);
+            setTransitionState(current => ({ ...current, transition: null }));
+            return undefined;
+        }
+        setTransitionState(current => ({
+            revision: current.revision + 1,
+            transition: {
+                fromAccent: mascotPaletteOf(deriveAppearance(currentAvatar ?? '')).accent,
+                toAccent: mascotPaletteOf(deriveAppearance(nextAvatar ?? '')).accent
+            }
+        }));
+        const swapTimer = window.setTimeout(() => {
+            renderedMascotAvatarRef.current = nextAvatar;
+            setRenderedMascotAvatar(nextAvatar);
+        }, MASCOT_PROFILE_TRANSITION_SWAP_MS);
+        const finishTimer = window.setTimeout(() => {
+            setTransitionState(current => ({ ...current, transition: null }));
+        }, MASCOT_PROFILE_TRANSITION_DURATION_MS);
+        return () => {
+            window.clearTimeout(swapTimer);
+            window.clearTimeout(finishTimer);
+        };
+    }, [targetAvatarKey, reduced]);
+    return { avatar: renderedMascotAvatar, profileTransition: transitionState.transition, profileTransitionRevision: transitionState.revision };
+}
+//# sourceMappingURL=useComposerProfile.js.map

package/dist/composer/useComposerProfile.js.map

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

package/dist/decorationCatalog.d.ts

@@ -0,0 +1,14 @@
+import { type DecorationId, type PrimaryId, type SecondaryId } from './appearanceModel.js';
+export interface Decoration {
+    id: DecorationId;
+    name: string;
+    category: 'Hats' | 'Novelty' | 'Accessories';
+    feature: string;
+    colors: readonly string[];
+    mount: string;
+}
+export declare const decorations: Decoration[];
+export declare const decorationOf: (id: DecorationId) => Decoration;
+export declare const decorationName: (id: PrimaryId | SecondaryId) => string;
+export declare function compatibleNames(item: Decoration): string;
+//# sourceMappingURL=decorationCatalog.d.ts.map

package/dist/decorationCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorationCatalog.d.ts","sourceRoot":"","sources":["../src/decorationCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAErH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,YAAY,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAA;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;CACd;AACD,eAAO,MAAM,WAAW,EAAE,UAAU,EA2BnC,CAAA;AACD,eAAO,MAAM,YAAY,GAAI,IAAI,YAAY,eAA8C,CAAA;AAC3F,eAAO,MAAM,cAAc,GAAI,IAAI,SAAS,GAAG,WAAW,WAAmD,CAAA;AAC7G,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,UAI/C"}

package/dist/decorationCatalog.js

@@ -0,0 +1,37 @@
+import { compatibility, primaryIds } from './appearanceModel.js';
+export const decorations = [
+    { id: 'baseball-cap', name: 'Baseball cap', category: 'Hats', feature: 'Rounded crown with a short right-facing brim', colors: ['#e87967', '#b94f50', '#f5a18c'], mount: 'Crown overlaps the top edge; the brim stays inside the body' },
+    { id: 'bucket-hat', name: 'Bucket hat', category: 'Hats', feature: 'Flat top with a continuous downward brim', colors: ['#94bda6', '#5b887a', '#bed8c1'], mount: 'Brim follows the top edge with a slight center overlap' },
+    { id: 'beret', name: 'Beret', category: 'Hats', feature: 'Soft left-leaning crown with a short stem', colors: ['#b17498', '#784c71', '#cf9db5'], mount: 'Narrow band rests on top; the crown leans left' },
+    { id: 'beanie', name: 'Beanie', category: 'Hats', feature: 'Rounded crown and wide folded cuff with minimal texture', colors: ['#e9a653', '#bc753d', '#f7c676'], mount: 'Folded cuff sits on the top edge; crown stays centered' },
+    { id: 'top-hat', name: 'Top hat', category: 'Hats', feature: 'Tall crown, narrow brim, and burgundy band', colors: ['#465069', '#293247', '#c96e85'], mount: 'Narrow brim rests flat on top; crown tapers at its base' },
+    { id: 'wizard-hat', name: 'Wizard hat', category: 'Hats', feature: 'Curved point, wide brim, and gold star', colors: ['#8773c1', '#594b93', '#f4cc75'], mount: 'Wide brim rests on top; point curves into the center safe area' },
+    { id: 'chef-hat', name: 'Chef hat', category: 'Hats', feature: 'Three-lobed puff with an upright band', colors: ['#f5eee3', '#d7caba', '#fffaf1'], mount: 'Band rests at the center of the top edge' },
+    { id: 'party-hat', name: 'Party hat', category: 'Hats', feature: 'Cone with two colored bands and a pom-pom', colors: ['#ea9baf', '#8075b7', '#f5d07b'], mount: 'Shallow curved base follows the top of the body' },
+    { id: 'crown', name: 'Crown', category: 'Hats', feature: 'Three rounded points with a central sapphire', colors: ['#efc65c', '#c99139', '#73b8cc'], mount: 'Curved gold band wraps the top edge; all points face up' },
+    { id: 'hard-hat', name: 'Hard hat', category: 'Hats', feature: 'Rounded shell, center ridge, and short front brim', colors: ['#f5bd48', '#d68d32', '#ffdc79'], mount: 'Short brim overlaps the top edge; ridge stays centered' },
+    { id: 'nightcap', name: 'Nightcap', category: 'Hats', feature: 'Soft drooping point with a pom-pom', colors: ['#789cc9', '#4c709f', '#dce8f4'], mount: 'Soft band follows the top edge; pom-pom stays upper right' },
+    { id: 'straw-hat', name: 'Straw hat', category: 'Hats', feature: 'Low round crown, wide oval brim, and red band', colors: ['#e8c78a', '#c49b5e', '#c57568'], mount: 'Wide brim rests flat without entering the arm areas' },
+    { id: 'poop', name: 'Poop', category: 'Novelty', feature: 'Three rounded layers with a playful curled tip', colors: ['#a97b5f', '#805840', '#c49976'], mount: 'Wide bottom layer rests directly on top; color separates each layer' },
+    { id: 'banana', name: 'Banana', category: 'Novelty', feature: 'Crescent fruit with stems and an inner color plane', colors: ['#f3cf62', '#dbaa40', '#89705a'], mount: 'Outer curve touches the top; both stems point up' },
+    { id: 'fried-egg', name: 'Fried egg', category: 'Novelty', feature: 'Irregular rounded white with a raised golden yolk', colors: ['#fff9e8', '#e6d9bb', '#f3be43'], mount: 'White spreads across the top; raised yolk defines the silhouette' },
+    { id: 'rubber-duck', name: 'Rubber duck', category: 'Novelty', feature: 'Round head, flat orange bill, and short raised tail', colors: ['#f6d05e', '#e4ae3e', '#e58b4b'], mount: 'Belly rests flat on top, with bill left and tail right' },
+    { id: 'paper-boat', name: 'Paper boat', category: 'Novelty', feature: 'Folded hull with a central triangular plane', colors: ['#d6e7eb', '#92b5c1', '#f1f7f5'], mount: 'Folded hull edge rests on top; main fold stays centered' },
+    { id: 'traffic-cone', name: 'Traffic cone', category: 'Novelty', feature: 'Orange cone with a white band and flat base', colors: ['#ed985f', '#c96c43', '#fff0dd'], mount: 'Flat base rests on top; cone tapers upward' },
+    { id: 'sprout', name: 'Sprout', category: 'Novelty', feature: 'Short stem with two leaves pointing in different directions', colors: ['#89b875', '#537f59', '#b5d38f'], mount: 'Stem grows directly from the top edge without a pot or base' },
+    { id: 'donut', name: 'Donut', category: 'Novelty', feature: 'Clear center hole, half-ring of icing, and a few sprinkles', colors: ['#dbab70', '#bf8456', '#e5a0b3'], mount: 'Lower curve touches the top; center remains an open cutout' },
+    { id: 'forehead-goggles', name: 'Forehead goggles', category: 'Accessories', feature: 'Two blue-gray lenses with a center bridge', colors: ['#8b7568', '#a2c5d1', '#dec8ae'], mount: 'Fits within the forehead band; bridge anchors above the screen' },
+    { "id": "task-board", "name": "Task board", "category": "Accessories", "feature": "White planning board with connected role-color markers and a yellow accent", "colors": ["#ffffff", "#3161f7", "#f6b500"], "mount": "Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores" },
+    { "id": "wrench", "name": "Wrench", "category": "Accessories", "feature": "White open-ended wrench with role-color outlines and a yellow handle inset", "colors": ["#ffffff", "#3161f7", "#f6b500"], "mount": "Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores" },
+    { "id": "shield", "name": "Shield", "category": "Accessories", "feature": "White shield with a role-color outline and upright check", "colors": ["#ffffff", "#3161f7", "#f6b500"], "mount": "Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores" },
+    { "id": "magnifier", "name": "Magnifier", "category": "Accessories", "feature": "Upright white lens frame with a role-color outline and a lower grip", "colors": ["#ffffff", "#3161f7", "#f6b500"], "mount": "Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores" },
+    { "id": "control-panel", "name": "Control panel", "category": "Accessories", "feature": "White control panel with dark rails and role-color and yellow knobs", "colors": ["#ffffff", "#3161f7", "#f6b500"], "mount": "Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores" },
+];
+export const decorationOf = (id) => decorations.find(item => item.id === id);
+export const decorationName = (id) => id === 'none' ? 'None' : decorationOf(id).name;
+export function compatibleNames(item) {
+    return item.category === 'Accessories'
+        ? primaryIds.filter(id => compatibility[id].includes(item.id)).map(decorationName).join(', ')
+        : compatibility[item.id].map(decorationName).join(', ');
+}
+//# sourceMappingURL=decorationCatalog.js.map

package/dist/decorationCatalog.js.map

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