@usenavii/core 0.5.0 → 0.6.0

package/dist/parts.d.cts

@@ -1,4 +1,4 @@
-import { P as Palette, d as BodyShapeId, E as EyeStyleId, M as MouthStyleId, a as AntennaStyleId, A as AccessoryId, B as BackgroundId, T as TopperId, O as OutfitId } from './types-CF0rfKly.cjs';
+import { P as Palette, d as BodyShapeId, E as EyeStyleId, e as MouthStyleId, a as AntennaStyleId, A as AccessoryId, B as BackgroundId, T as TopperId, O as OutfitId } from './types-BtX6LIyn.cjs';
 
 /**
  * Palette set seeded from the Comms360 "Pulse" mascot DNA, extended to provide

package/dist/parts.d.ts

@@ -1,4 +1,4 @@
-import { P as Palette, d as BodyShapeId, E as EyeStyleId, M as MouthStyleId, a as AntennaStyleId, A as AccessoryId, B as BackgroundId, T as TopperId, O as OutfitId } from './types-CF0rfKly.js';
+import { P as Palette, d as BodyShapeId, E as EyeStyleId, e as MouthStyleId, a as AntennaStyleId, A as AccessoryId, B as BackgroundId, T as TopperId, O as OutfitId } from './types-BtX6LIyn.js';
 
 /**
  * Palette set seeded from the Comms360 "Pulse" mascot DNA, extended to provide

package/dist/{types-CF0rfKly.d.cts → types-BtX6LIyn.d.cts}

@@ -30,6 +30,18 @@ type OutfitId = 'none' | 'collar' | 'scarf' | 'bowtie' | 'sunflower' | 'necklace
  * Packs that don't declare styleHints simply ignore this option.
  */
 type StyleHint = 'masc' | 'femme' | 'neutral';
+/**
+ * Expression overlay for the seed flow. Overrides the seed-derived `eyes` +
+ * `mouth` selections with a curated pair that conveys a specific mood.
+ *
+ * Same seed + same mood = same avatar. Different mood = same body, different
+ * face. Pack pick constraints on eyes/mouth are bypassed by design — the
+ * mood IS the override, so Office + `happy` legitimately produces wide eyes
+ * even though Office normally restricts to dot/sleepy/squint.
+ *
+ * `neutral` (or undefined) leaves picks seed-derived (current behavior).
+ */
+type MoodId = 'neutral' | 'happy' | 'serious' | 'sleepy' | 'wink';
 interface AvatarSpec {
     seed: string;
     palette: Palette;
@@ -105,6 +117,13 @@ interface AvatarOptions {
      * Determinism preserved: same seed + same style = same output.
      */
     style?: StyleHint;
+    /**
+     * Expression overlay. Overrides seed-derived eyes + mouth with a curated
+     * pair conveying a specific mood (happy / serious / sleepy / wink). Same
+     * seed + mood = same avatar; different moods on the same seed share body,
+     * palette, topper, etc. Bypasses pack pick constraints on eyes/mouth.
+     */
+    mood?: MoodId;
     /** Add `role="img"` and `aria-label`. */
     title?: string;
     /** Emit idle animations (float, blink, antenna pulse, sparkle twinkle). Default false. */
@@ -117,4 +136,4 @@ interface AvatarOptions {
     tileBg?: string;
 }
 
-export type { AccessoryId as A, BackgroundId as B, EyeStyleId as E, MouthStyleId as M, OutfitId as O, Palette as P, StyleHint as S, TopperId as T, AntennaStyleId as a, AvatarOptions as b, AvatarSpec as c, BodyShapeId as d };
+export type { AccessoryId as A, BackgroundId as B, EyeStyleId as E, MoodId as M, OutfitId as O, Palette as P, StyleHint as S, TopperId as T, AntennaStyleId as a, AvatarOptions as b, AvatarSpec as c, BodyShapeId as d, MouthStyleId as e };

package/dist/{types-CF0rfKly.d.ts → types-BtX6LIyn.d.ts}

@@ -30,6 +30,18 @@ type OutfitId = 'none' | 'collar' | 'scarf' | 'bowtie' | 'sunflower' | 'necklace
  * Packs that don't declare styleHints simply ignore this option.
  */
 type StyleHint = 'masc' | 'femme' | 'neutral';
+/**
+ * Expression overlay for the seed flow. Overrides the seed-derived `eyes` +
+ * `mouth` selections with a curated pair that conveys a specific mood.
+ *
+ * Same seed + same mood = same avatar. Different mood = same body, different
+ * face. Pack pick constraints on eyes/mouth are bypassed by design — the
+ * mood IS the override, so Office + `happy` legitimately produces wide eyes
+ * even though Office normally restricts to dot/sleepy/squint.
+ *
+ * `neutral` (or undefined) leaves picks seed-derived (current behavior).
+ */
+type MoodId = 'neutral' | 'happy' | 'serious' | 'sleepy' | 'wink';
 interface AvatarSpec {
     seed: string;
     palette: Palette;
@@ -105,6 +117,13 @@ interface AvatarOptions {
      * Determinism preserved: same seed + same style = same output.
      */
     style?: StyleHint;
+    /**
+     * Expression overlay. Overrides seed-derived eyes + mouth with a curated
+     * pair conveying a specific mood (happy / serious / sleepy / wink). Same
+     * seed + mood = same avatar; different moods on the same seed share body,
+     * palette, topper, etc. Bypasses pack pick constraints on eyes/mouth.
+     */
+    mood?: MoodId;
     /** Add `role="img"` and `aria-label`. */
     title?: string;
     /** Emit idle animations (float, blink, antenna pulse, sparkle twinkle). Default false. */
@@ -117,4 +136,4 @@ interface AvatarOptions {
     tileBg?: string;
 }
 
-export type { AccessoryId as A, BackgroundId as B, EyeStyleId as E, MouthStyleId as M, OutfitId as O, Palette as P, StyleHint as S, TopperId as T, AntennaStyleId as a, AvatarOptions as b, AvatarSpec as c, BodyShapeId as d };
+export type { AccessoryId as A, BackgroundId as B, EyeStyleId as E, MoodId as M, OutfitId as O, Palette as P, StyleHint as S, TopperId as T, AntennaStyleId as a, AvatarOptions as b, AvatarSpec as c, BodyShapeId as d, MouthStyleId as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usenavii/core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Deterministic mascot avatar engine. Pass any seed, get back a clean, designed SVG that's the same every time.",
   "type": "module",
   "main": "./dist/index.cjs",