wobnimo 0.0.0-stage → 0.1.0

package/AGENTS.md

@@ -0,0 +1,84 @@
+# Wobnimo — guide for AI agents
+
+Wobnimo renders animated mascots in a web app. One engine, ten characters, ten
+emotional states. Use this file to add or wire up a mascot correctly.
+
+## Install
+
+```bash
+npm i wobnimo
+```
+
+No build step? Add one tag instead:
+
+```html
+<script type="module" src="https://cdn.jsdelivr.net/npm/wobnimo@1/dist/wobnimo.js"></script>
+```
+
+## Render it
+
+React / Next.js (add `"use client"` in app-router files):
+
+```tsx
+import { Mascot } from 'wobnimo/react';
+<Mascot character="mochi" state="thinking" style={{ width: 160, height: 160 }} />
+```
+
+Anything else (Vue, Svelte, plain HTML):
+
+```html
+<wobnimo-mascot character="mochi" state="idle"></wobnimo-mascot>
+```
+
+Size it 96–160 px square. Put it where the assistant or chat lives.
+
+## Characters
+
+`volt` (robot), `pip` (songbird), `mochi` (jelly), `boo` (ghost), `inky` (octopus),
+`miso` (plush cat), `tad` (tree frog), `pebble` (penguin), `rex` (baby dino),
+`microduck` (robot duck). Import one to ship only its ~1.2 KB of data:
+`import { mochi } from 'wobnimo/characters/mochi'`.
+
+## States — the whole point
+
+Drive the state from what the app is doing. The ten states and when to use each:
+
+| State | Use it when |
+| --- | --- |
+| `idle` | waiting for the user |
+| `listening` | the user is typing or talking |
+| `thinking` | a request is sent, no reply yet |
+| `speaking` | a reply is streaming in |
+| `working` | running a tool, a build, a long task |
+| `error` | something failed |
+| `celebrating` | a task finished, tests passed |
+| `surprised` | an unexpected event |
+| `sad` | it could not help |
+| `sleeping` | idle for a couple of minutes |
+
+Set the state through the `state` prop/attribute, or `mascot.setState('thinking')`.
+
+## AI chat, one line
+
+Using the Vercel AI SDK? Pass `useChat`'s `status` straight in; the mascot thinks,
+speaks, celebrates and shows errors for you:
+
+```tsx
+const { status } = useChat();
+<Mascot character="mochi" status={status} />
+```
+
+Plain JS with the element: set the `status` attribute to `submitted`, `streaming`,
+`ready` or `error`.
+
+## Rules
+
+- Prefer the `status` prop for chat UIs; otherwise map the app's real events to the
+  states above. Don't leave a mascot stuck on `idle`.
+- Unknown character or state names throw at runtime and name the valid ones — read
+  the console if a mascot doesn't appear.
+- Recolour with `palette`, e.g. `palette={{ shell: '#e0457b' }}`; material names are
+  per character.
+- Verify: run the app and confirm the mascot renders and changes state during one chat turn.
+
+Full reference: https://pouryaak.github.io/wobnimo/llms.txt

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pourya Akhbari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/characters/boo.d.ts

@@ -0,0 +1,6 @@
+import { C as CharacterSpec } from '../types-PAZ6PnKv.js';
+
+/** A floating ghost with a rippling hem and little arms. */
+declare const boo: CharacterSpec;
+
+export { boo };

package/dist/characters/boo.js

@@ -0,0 +1 @@
+var r={id:"boo",name:"Boo",tagline:"Floats, glows from inside, trails motes, a hem that ripples",accent:"#8a6cf0",frame:{target:.78,radius:.92},bound:{y:.72,radius:.72},motion:{float:.22,hop:.12,squash:.8,snap:.8,talkSquash:.6},glowPool:.55,materials:{ghost:{color:"#eceaff",f0:.04,spec:.5,shininess:30,rim:1.4,sss:.4,sssColor:"#b9a4ff",emit:"#6f52d9",emitStrength:.06},bead:{color:"#1b1430",f0:.06,spec:2.2,shininess:400,rim:.2,gloss:1}},bones:[{name:"body",pivot:[0,0,0],drive:{rx:[["pitch",-0.5]],ry:[["yaw",.7]],rz:[["roll",.6]]},wave:{rz:[.03,.45,0]}},{name:"armL",parent:"body",pivot:[-0.36,.74,.04],drive:{rz:[["flap",-1.2]]},wave:{rz:[.08,.7,0]},jiggle:{axis:[-0.8,-0.6,0],length:.15,freq:2,damping:.2,maxAngle:.7}},{name:"armR",parent:"body",pivot:[.36,.74,.04],drive:{rz:[["flap",1.2]]},wave:{rz:[-0.08,.7,1.6]},jiggle:{axis:[.8,-0.6,0],length:.15,freq:2,damping:.2,maxAngle:.7}}],parts:[{bone:"body",shape:"sphere",at:[0,.88,0],radius:.4,material:"ghost"},{bone:"body",shape:"roundCone",from:[0,.88,0],to:[0,.4,0],r1:.4,r2:.47,material:"ghost"},{bone:"body",shape:"hem",y:.34,amplitude:.045,waves:6,speed:2.4,blend:.05,material:"ghost"},{bone:"armL",shape:"capsule",from:[0,0,0],to:[-0.12,-0.09,.02],radius:.07,blend:.08,material:"ghost"},{bone:"armR",shape:"capsule",from:[0,0,0],to:[.12,-0.09,.02],radius:.07,blend:.08,material:"ghost"}],paints:[{bone:"body",on:["ghost"],kind:"sphere",at:[-0.24,.78,.31],radius:.07,color:"#ffa3c4",soft:.6,opacity:.7},{bone:"body",on:["ghost"],kind:"sphere",at:[.24,.78,.31],radius:.07,color:"#ffa3c4",soft:.6,opacity:.7}],eyes:{kind:"bead",bone:"body",at:[[-0.135,.9,.375],[.135,.9,.375]],radii:[.048,.072,.03],material:"bead"},face:{kind:"mouth",bone:"body",on:["ghost"],at:[0,.77,.38],width:.075,color:"#2a1a4a",tongue:"#ff7fa6"},anchors:{top:{bone:"body",at:[.16,1.2,.1]},mouth:{bone:"body",at:[0,.77,.4]},ear:{bone:"body",at:[-0.42,.92,0]},center:{bone:"body",at:[0,.8,0]}},acting:{idle:{armL:{rz:[0,.1,.7,0]},armR:{rz:[0,.1,.7,1.3]}},thinking:{armR:{ry:-1.1,rz:.9},armL:{rz:.25}},listening:{armL:{rz:-1,rx:-0.35}},speaking:{armL:{rz:[-0.3,.3,1.2,0],rx:[-0.3,.2,.9,0]},armR:{rz:[.3,.3,1.2,1.7],rx:[-0.3,.2,.9,2.2]}},sleeping:{armL:{rz:.4},armR:{rz:-0.4},body:{rz:.08}},working:{armL:{rx:[-0.6,.15,6,0],rz:-0.3},armR:{rx:[-0.6,.15,6,Math.PI],rz:.3}},error:{armL:{rz:[-1,.25,10,0]},armR:{rz:[1,.25,10,1]}},surprised:{armL:{rz:-1.4,rx:-0.4},armR:{rz:1.4,rx:-0.4}},celebrating:{armL:{rz:[-1.6,.3,4,0]},armR:{rz:[1.6,.3,4,Math.PI]}},sad:{armL:{rz:.5},armR:{rz:-0.5},body:{rz:.05}},happy:{armL:{rz:[-1.3,.35,3,0]},armR:{rz:[1.3,.35,3,1.2]}}},fx:{ambient:[{glyph:"mote",anchor:"center",rate:1.3,spread:.5,velocity:[0,.07,0],jitter:.06,wobble:.09,life:[2.2,3.2],size:[.04,.02],color:"#b49cff",glow:true}],happy:[{glyph:"heart",anchor:"top",rate:1.2,spread:.2,velocity:[0,.22,.05],jitter:.12,wobble:.06,life:[1,1.3],size:[.04,.07],color:"#ff86b0"}]}};export{r as boo};

package/dist/characters/index.d.ts

@@ -0,0 +1,12 @@
+export { c as characters, d as defineWobnimoElement } from '../element-DRDEWSGV.js';
+export { boo } from './boo.js';
+export { inky } from './inky.js';
+export { microduck } from './microduck.js';
+export { miso } from './miso.js';
+export { mochi } from './mochi.js';
+export { pebble } from './pebble.js';
+export { pip } from './pip.js';
+export { rex } from './rex.js';
+export { tad } from './tad.js';
+export { volt } from './volt.js';
+import '../types-PAZ6PnKv.js';