agent-robot-avatar 0.6.0 → 0.7.0

package/docs/README.de.md

@@ -1,185 +0,0 @@
-# Agent Robot Avatar
-
-<p align="center">
-  <img src="../assets/readme/agent-robot-avatar-header.jpg" alt="Agent Robot Avatar">
-</p>
-
-[English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Русский](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ru.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md)
-
-![Version](https://img.shields.io/badge/version-v0.6.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
-
-![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square)
-
-Eine leichtgewichtige, ausdrucksstarke Roboter-Avatar-Web-Component für KI-Agenten und interaktive Anwendungen.
-
-Sie kann in KI-Assistenten, Agent-Oberflächen, Desktop-Begleitern, virtuellen Haustieren, digitalen Maskottchen, Chatbot-Avataren und anderen interaktiven Charaktererlebnissen eingesetzt werden.
-
-Geeignet für KI-Assistenten- und Agent-Oberflächen, einschließlich Produkten und Erlebnissen ähnlich wie ChatGPT, Claude, Codex, Cursor, Grok Bot, Gemini CLI und OpenCode.
-
-Sie basiert auf SVG und Vanilla JavaScript, läuft als natives Custom Element und hat keine Runtime-Abhängigkeiten.
-
-Agent Robot Avatar kann außerdem als visuelle Feedback-Ebene für Agent-Oberflächen im AG-UI-Stil verwendet werden.
-
-<p align="center">
-  <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Interaktive Animationsdemo von Agent Robot Avatar" width="560">
-</p>
-
-## Live-Demo
-
-[Interaktive Demo öffnen](https://cx-artlab.github.io/agent-robot-avatar/?lang=de)
-
-## Besondere Merkmale
-
-- Native Web Component
-- SVG-Rendering + Vanilla JavaScript
-- Keine Runtime-Abhängigkeiten
-- Automatisches Blinzeln und dezentes Idle-Verhalten
-- Zeigerfolgende Augen und träge Kopfbewegung
-- Lokale Jelly-Drag-Verformung mit elastischer Rückkehr
-- Drücken-und-Halten-Stauchung und ziehbare Federantenne
-- Programmatisch steuerbare Agent-Zustände und Ausdrücke
-- Feedback für waiting, success, failure, warning, review, blocked und system error
-- Unterstützung für reduzierte Bewegung
-- Konfigurierbares Schlafverhalten
-- Einstellbare Kopfrundung
-- Optionales Statusblinken der Antenne
-- TypeScript-Deklarationen enthalten
-
-## Installation
-
-```bash
-npm install agent-robot-avatar
-```
-
-```js
-import 'agent-robot-avatar';
-```
-
-Alternativ kann der Repository-Quellcode direkt geladen werden:
-
-```html
-<script type="module" src="./agent-robot-avatar.js"></script>
-```
-
-Dann die Komponente hinzufügen:
-
-```html
-<agent-robot-avatar id="avatar"></agent-robot-avatar>
-```
-
-Es ist kein Initialisierungscode nötig. Der Avatar wechselt automatisch in seinen standardmäßigen Idle-Zustand.
-
-## Grundlegende Verwendung
-
-```js
-const avatar = document.querySelector('#avatar');
-
-avatar.play('success');
-avatar.play('wary');
-avatar.play('refuse');
-
-avatar.reset();
-```
-
-Verfügbare Aktionen:
-
-`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
-
-Aktionsnamen beschreiben, was der Avatar tut. `refuse` schüttelt den Kopf, für eine Anfrage, die der Agent nicht ausführen kann oder will; `failure` steht für eine Aufgabe oder Verbindung ohne Erfolg; `wary` dreht den Kopf und mustert misstrauisch von oben bis unten, für eine Aktion, die eine Bestätigung braucht. Namen aus 0.5 (`send`, `warning`, `error`, `blocked` und weitere) funktionieren bis 1.0 weiter, mit einem Hinweis in der Konsole; siehe die [Upgrade-Tabelle](../CHANGELOG.md#upgrading-from-05x).
-
-`love` drückt Zuneigung oder Dank aus: Die beiden Augen neigen sich zu einem einzigen Herz zusammen, schlagen dreimal und kehren dann zurück.
-
-`random` spielt einen Spielautomaten-Dreh ab: Jedes Auge rollt über eine Walze, dann bremst das linke Auge, federt nach und kommt zur Ruhe, danach das rechte. `slot` ist ein Alias.
-
-Ein typischer Agent-Anfrageablauf:
-
-```js
-avatar.startWaiting();
-
-// Zweite Wartebewegung: Die Augen drehen seitlich heraus und kommen von der anderen Seite zurück.
-avatar.startWaiting({ variant: 'wrap' });
-
-try {
-  const result = await runAgentRequest();
-  await avatar.play(result.ok ? 'success' : 'failure');
-} catch (error) {
-  await avatar.play('failure');
-}
-```
-
-## Häufige Optionen
-
-```html
-<agent-robot-avatar
-  size="160"
-  color="#08090b"
-  auto-sleep="30000"
-  wake-on="activity"
-  motion="auto">
-</agent-robot-avatar>
-```
-
-| Attribut | Zweck |
-| --- | --- |
-| `size` | Avatargröße in Pixeln |
-| `color` | Hauptfarbe des Avatars |
-| `auto-sleep` | Leerlaufzeit vor automatischem Schlaf; `0` deaktiviert ihn |
-| `wake-on` | Automatische Aufwachstrategie: `activity`, `interaction` oder `manual` |
-| `motion` | Bewegungsstrategie: `auto`, `reduce` oder `full` |
-| `press-squeeze` | Mitte gedrückt halten und stauchen; `false` deaktiviert die Geste |
-| `antenna-drag` | Antenne ziehen, federnd zurückkehren und wütend reagieren; `false` deaktiviert sie |
-
-Häufige Runtime-Steuerungen:
-
-```js
-avatar.setPointerFollow(false);
-avatar.setHeadRoundness(75);
-avatar.setPressSqueeze(true);
-avatar.setAntennaDrag(true);
-```
-
-Gedrückthalten in der Mitte startet die Stauchung. Nach mehr als 4 CSS-Pixeln Bewegung wechselt dieselbe Zeigergeste zum vorhandenen Kopfziehen. Die Antenne verwendet dessen Distanzlimit und endet mit der vorhandenen Wutreaktion.
-
-## Ereignisse und Integration
-
-Die Komponente sendet `face-state` für visuelle Zustandsänderungen und `action-state` für semantische Änderungen im Aktionslebenszyklus.
-
-Für Host-Integrationen und barrierefreie Statustexte sollte `action-state` bevorzugt werden. Ein ausführbares Anfrage-Lifecycle-Beispiel befindet sich in [`examples/accessibility.html`](../examples/accessibility.html).
-
-Ein minimales Integrationsbeispiel ist unter [`examples/basic.html`](../examples/basic.html) verfügbar.
-
-## Kompatibilität
-
-Für moderne Browser mit Unterstützung für ES Modules, Custom Elements, SVG, Pointer Events, Web Animations API, `IntersectionObserver`, `ResizeObserver` und `matchMedia`.
-
-Automatisierte Browsertests decken Chromium, Firefox und WebKit ab.
-
-## Mitwirken
-
-Issues und Pull Requests sind willkommen. Bitte vor Änderungen [`CONTRIBUTING.md`](../CONTRIBUTING.md) lesen.
-
-## Projektstatus
-
-**Aktuelle öffentliche Version: v0.6.0**
-
-Die öffentliche API bleibt bewusst kompakt, während sich das Projekt in Richtung einer zukünftigen Stabilitätszusage mit `1.0.0` entwickelt.
-
-Agent Robot Avatar wird unabhängig entwickelt und ist mit keiner KI-Plattform oder Marke verbunden, von ihr unterstützt oder deren offizieller Vertreter.
-
-## Charakterdesign und visuelle Identität
-
-Der Agent-Robot-Avatar-Charakter einschließlich seines Roboterdesigns und seiner visuellen Identität ist ein Originaldesign von CX ArtLab.
-
-Die MIT-Lizenz gilt für Software und Quellcode. Sie erlaubt die Nutzung, Änderung und Verteilung des Avatars als Teil von Anwendungen, überträgt jedoch nicht das Eigentum am Namen Agent Robot Avatar, an der Charakteridentität oder der visuellen Identität und gewährt nicht das Recht, diese als eigenen Originalcharakter oder eigenständige Marke eines Dritten darzustellen.
-
-In diesem Projekt genannte Produktnamen Dritter dienen nur zur Beschreibung möglicher Anwendungsfälle und bedeuten keine Verbindung oder Unterstützung.
-
-## Lizenz
-
-MIT License. Siehe [`LICENSE`](../LICENSE).
-
----
-
-Wenn dir dieses Projekt nützlich ist, kannst du mir einen Kaffee spendieren.
-
-<a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>

package/docs/README.es.md

@@ -1,185 +0,0 @@
-# Agent Robot Avatar
-
-<p align="center">
-  <img src="../assets/readme/agent-robot-avatar-header.jpg" alt="Agent Robot Avatar">
-</p>
-
-[English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Русский](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ru.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md)
-
-![Version](https://img.shields.io/badge/version-v0.6.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
-
-![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square)
-
-Un Web Component de avatar robótico ligero y expresivo para agentes de IA y aplicaciones interactivas.
-
-Puede usarse en asistentes de IA, interfaces de agentes, compañeros de escritorio, mascotas virtuales, mascotas digitales, avatares de chatbots y otras experiencias con personajes interactivos.
-
-Es adecuado para interfaces de asistentes de IA y agentes, incluidos productos y experiencias similares a ChatGPT, Claude, Codex, Cursor, Grok Bot, Gemini CLI y OpenCode.
-
-Está construido con SVG y JavaScript nativo, funciona como un Custom Element y no tiene dependencias en tiempo de ejecución.
-
-Agent Robot Avatar también puede utilizarse como capa de retroalimentación visual para interfaces de agentes de estilo AG-UI.
-
-<p align="center">
-  <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Demostración animada interactiva de Agent Robot Avatar" width="560">
-</p>
-
-## Demo en vivo
-
-[Abrir la demo interactiva](https://cx-artlab.github.io/agent-robot-avatar/?lang=es)
-
-## Características
-
-- Web Component nativo
-- Renderizado SVG + JavaScript nativo
-- Cero dependencias en tiempo de ejecución
-- Parpadeo automático y comportamiento idle sutil
-- Ojos que siguen el puntero y movimiento inercial de la cabeza
-- Deformación local tipo gelatina al arrastrar, con recuperación elástica
-- Compresión al mantener pulsado y antena elástica arrastrable
-- Estados y expresiones del Agent controlables por código
-- Feedback para waiting, success, failure, warning, review, blocked y system error
-- Compatibilidad con movimiento reducido
-- Comportamiento de sueño configurable
-- Redondez de la cabeza ajustable
-- Parpadeo opcional de estado en la antena
-- Declaraciones TypeScript incluidas
-
-## Instalación
-
-```bash
-npm install agent-robot-avatar
-```
-
-```js
-import 'agent-robot-avatar';
-```
-
-También puedes cargar directamente el código fuente del repositorio:
-
-```html
-<script type="module" src="./agent-robot-avatar.js"></script>
-```
-
-Después añade el componente:
-
-```html
-<agent-robot-avatar id="avatar"></agent-robot-avatar>
-```
-
-No hace falta código de inicialización. El avatar entra automáticamente en su estado idle predeterminado.
-
-## Uso básico
-
-```js
-const avatar = document.querySelector('#avatar');
-
-avatar.play('success');
-avatar.play('wary');
-avatar.play('refuse');
-
-avatar.reset();
-```
-
-Acciones disponibles:
-
-`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
-
-Los nombres de acción describen lo que hace el avatar. `refuse` niega con la cabeza, para una petición que el Agent no puede o no va a realizar; `failure` es para una tarea o conexión que no salió bien; `wary` gira la cabeza y mira de arriba abajo con recelo, para una acción que requiere confirmación. Los nombres de 0.5 (`send`, `warning`, `error`, `blocked` y otros) siguen funcionando con un aviso en la consola hasta 1.0; consulta la [tabla de actualización](../CHANGELOG.md#upgrading-from-05x).
-
-`love` expresa cariño o agradecimiento: los dos ojos se inclinan hasta formar un único corazón, laten tres veces y luego vuelven a la normalidad.
-
-`random` reproduce un giro de tragaperras: cada ojo rueda sobre un tambor; después el ojo izquierdo frena, rebota y se detiene, seguido del derecho. `slot` es un alias.
-
-Un flujo típico para una solicitud de Agent:
-
-```js
-avatar.startWaiting();
-
-// Segunda espera: los ojos salen por un lado y vuelven por el otro.
-avatar.startWaiting({ variant: 'wrap' });
-
-try {
-  const result = await runAgentRequest();
-  await avatar.play(result.ok ? 'success' : 'failure');
-} catch (error) {
-  await avatar.play('failure');
-}
-```
-
-## Opciones comunes
-
-```html
-<agent-robot-avatar
-  size="160"
-  color="#08090b"
-  auto-sleep="30000"
-  wake-on="activity"
-  motion="auto">
-</agent-robot-avatar>
-```
-
-| Atributo | Uso |
-| --- | --- |
-| `size` | Tamaño del avatar en píxeles |
-| `color` | Color principal del avatar |
-| `auto-sleep` | Tiempo de inactividad antes del sueño automático; `0` lo desactiva |
-| `wake-on` | Política de activación automática: `activity`, `interaction` o `manual` |
-| `motion` | Política de movimiento: `auto`, `reduce` o `full` |
-| `press-squeeze` | Mantener pulsado el centro para comprimir; `false` lo desactiva |
-| `antenna-drag` | Arrastre y rebote de antena con reacción de enfado; `false` lo desactiva |
-
-Controles habituales en tiempo de ejecución:
-
-```js
-avatar.setPointerFollow(false);
-avatar.setHeadRoundness(75);
-avatar.setPressSqueeze(true);
-avatar.setAntennaDrag(true);
-```
-
-Mantener pulsado el centro inicia la compresión. Al mover más de 4 píxeles CSS, el mismo gesto pasa al arrastre de cabeza existente. La antena usa el mismo límite de distancia y termina con la reacción de enfado existente.
-
-## Eventos e integración
-
-El componente emite `face-state` para cambios de estado visual y `action-state` para cambios semánticos del ciclo de vida de las acciones.
-
-Para integraciones con la aplicación anfitriona y texto de estado accesible, usa preferentemente `action-state`. Consulta [`examples/accessibility.html`](../examples/accessibility.html) para ver un ejemplo ejecutable del ciclo de vida de una solicitud.
-
-Hay un ejemplo mínimo de integración en [`examples/basic.html`](../examples/basic.html).
-
-## Compatibilidad
-
-Diseñado para navegadores modernos con soporte para ES Modules, Custom Elements, SVG, Pointer Events, Web Animations API, `IntersectionObserver`, `ResizeObserver` y `matchMedia`.
-
-Las pruebas automatizadas cubren Chromium, Firefox y WebKit.
-
-## Contribuir
-
-Se aceptan Issues y Pull Requests. Consulta [`CONTRIBUTING.md`](../CONTRIBUTING.md) antes de enviar cambios.
-
-## Estado del proyecto
-
-**Versión pública actual: v0.6.0**
-
-La API pública se mantiene deliberadamente compacta mientras el proyecto evoluciona hacia un futuro compromiso de estabilidad `1.0.0`.
-
-Agent Robot Avatar se desarrolla de forma independiente y no está afiliado, respaldado ni representa a ninguna plataforma o marca de IA.
-
-## Diseño del personaje e identidad visual
-
-El personaje Agent Robot Avatar, incluido su aspecto robótico y su identidad visual, es un diseño original de CX ArtLab.
-
-La licencia MIT se aplica al software y al código fuente. Permite usar, modificar y distribuir el avatar como parte de aplicaciones, pero no transfiere la propiedad del nombre Agent Robot Avatar, la identidad del personaje o su identidad visual, ni concede el derecho a presentarlos como personaje original o marca independiente de otra parte.
-
-Los nombres de productos de terceros mencionados en este proyecto se usan únicamente para describir posibles casos de uso y no implican afiliación ni respaldo.
-
-## Licencia
-
-MIT License. Consulta [`LICENSE`](../LICENSE).
-
----
-
-Si este proyecto te resulta útil, puedes invitarme a un café.
-
-<a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>

package/docs/README.fr.md

@@ -1,185 +0,0 @@
-# Agent Robot Avatar
-
-<p align="center">
-  <img src="../assets/readme/agent-robot-avatar-header.jpg" alt="Agent Robot Avatar">
-</p>
-
-[English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Русский](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ru.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md)
-
-![Version](https://img.shields.io/badge/version-v0.6.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
-
-![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square)
-
-Un Web Component d’avatar robot léger et expressif pour les agents IA et les applications interactives.
-
-Il peut être utilisé dans des assistants IA, des interfaces d’agents, des compagnons de bureau, des animaux virtuels, des mascottes numériques, des avatars de chatbot et d’autres expériences de personnages interactifs.
-
-Il convient aux interfaces d’assistants IA et d’agents, y compris aux produits et expériences similaires à ChatGPT, Claude, Codex, Cursor, Grok Bot, Gemini CLI et OpenCode.
-
-Construit avec SVG et JavaScript natif, il fonctionne comme un Custom Element sans dépendance d’exécution.
-
-Agent Robot Avatar peut également servir de couche de retour visuel pour les interfaces d’agents de style AG-UI.
-
-<p align="center">
-  <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Démo animée interactive de Agent Robot Avatar" width="560">
-</p>
-
-## Démo en ligne
-
-[Ouvrir la démo interactive](https://cx-artlab.github.io/agent-robot-avatar/?lang=fr)
-
-## Points forts
-
-- Web Component natif
-- Rendu SVG + JavaScript natif
-- Zéro dépendance d’exécution
-- Clignements automatiques et comportement idle discret
-- Yeux suivant le pointeur et mouvement inertiel de la tête
-- Déformation locale façon gelée lors du glisser, avec retour élastique
-- Compression par appui prolongé et antenne ressort déplaçable
-- États et expressions d’Agent contrôlables par code
-- Retours pour waiting, success, failure, warning, review, blocked et system error
-- Prise en charge du mouvement réduit
-- Comportement de sommeil configurable
-- Arrondi de la tête réglable
-- Clignotement d’état optionnel de l’antenne
-- Déclarations TypeScript incluses
-
-## Installation
-
-```bash
-npm install agent-robot-avatar
-```
-
-```js
-import 'agent-robot-avatar';
-```
-
-Vous pouvez aussi charger directement le code source du dépôt :
-
-```html
-<script type="module" src="./agent-robot-avatar.js"></script>
-```
-
-Puis ajouter le composant :
-
-```html
-<agent-robot-avatar id="avatar"></agent-robot-avatar>
-```
-
-Aucun code d’initialisation n’est nécessaire. L’avatar entre automatiquement dans son état idle par défaut.
-
-## Utilisation de base
-
-```js
-const avatar = document.querySelector('#avatar');
-
-avatar.play('success');
-avatar.play('wary');
-avatar.play('refuse');
-
-avatar.reset();
-```
-
-Actions disponibles :
-
-`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
-
-Les noms d’action décrivent ce que fait l’avatar. `refuse` secoue la tête, pour une demande que l’Agent ne peut pas ou ne veut pas exécuter ; `failure` correspond à une tâche ou une connexion qui n’a pas abouti ; `wary` tourne la tête et toise avec méfiance, pour une action qui demande une confirmation. Les noms de la 0.5 (`send`, `warning`, `error`, `blocked`, etc.) fonctionnent encore jusqu’à la 1.0 avec un avis dans la console ; voir le [tableau de mise à niveau](../CHANGELOG.md#upgrading-from-05x).
-
-`love` exprime l’affection ou la gratitude : les deux yeux s’inclinent l’un vers l’autre pour former un seul cœur, battent trois fois, puis reviennent à la normale.
-
-`random` joue un tour de machine à sous : chaque œil roule sur un tambour, puis l’œil gauche ralentit, rebondit et s’arrête, suivi du droit. `slot` est un alias.
-
-Exemple de cycle de requête Agent :
-
-```js
-avatar.startWaiting();
-
-// Deuxième attente : les yeux sortent d'un côté et reviennent par l'autre.
-avatar.startWaiting({ variant: 'wrap' });
-
-try {
-  const result = await runAgentRequest();
-  await avatar.play(result.ok ? 'success' : 'failure');
-} catch (error) {
-  await avatar.play('failure');
-}
-```
-
-## Options courantes
-
-```html
-<agent-robot-avatar
-  size="160"
-  color="#08090b"
-  auto-sleep="30000"
-  wake-on="activity"
-  motion="auto">
-</agent-robot-avatar>
-```
-
-| Attribut | Usage |
-| --- | --- |
-| `size` | Taille de l’avatar en pixels |
-| `color` | Couleur principale de l’avatar |
-| `auto-sleep` | Temps d’inactivité avant le sommeil automatique ; `0` le désactive |
-| `wake-on` | Politique de réveil automatique : `activity`, `interaction` ou `manual` |
-| `motion` | Politique d’animation : `auto`, `reduce` ou `full` |
-| `press-squeeze` | Maintenir le centre pour comprimer ; `false` désactive le geste |
-| `antenna-drag` | Glisser et faire rebondir l’antenne avec réaction de colère ; `false` désactive le geste |
-
-Contrôles courants à l’exécution :
-
-```js
-avatar.setPointerFollow(false);
-avatar.setHeadRoundness(75);
-avatar.setPressSqueeze(true);
-avatar.setAntennaDrag(true);
-```
-
-Maintenir le centre lance la compression. Après plus de 4 pixels CSS de déplacement, le même geste bascule vers le glisser de tête existant. L’antenne reprend sa limite de distance et se termine par la réaction de colère existante.
-
-## Événements et intégration
-
-Le composant émet `face-state` pour les changements d’état visuel et `action-state` pour les changements sémantiques du cycle de vie des actions.
-
-Pour les intégrations avec l’application hôte et les textes d’état accessibles, préférez `action-state`. Consultez [`examples/accessibility.html`](../examples/accessibility.html) pour un exemple exécutable de cycle de requête.
-
-Un exemple minimal d’intégration est disponible dans [`examples/basic.html`](../examples/basic.html).
-
-## Compatibilité
-
-Conçu pour les navigateurs modernes prenant en charge ES Modules, Custom Elements, SVG, Pointer Events, Web Animations API, `IntersectionObserver`, `ResizeObserver` et `matchMedia`.
-
-Les tests automatisés couvrent Chromium, Firefox et WebKit.
-
-## Contribution
-
-Issues et Pull Requests sont les bienvenus. Consultez [`CONTRIBUTING.md`](../CONTRIBUTING.md) avant de proposer des modifications.
-
-## État du projet
-
-**Version publique actuelle : v0.6.0**
-
-L’API publique reste volontairement compacte pendant l’évolution du projet vers un futur engagement de stabilité `1.0.0`.
-
-Agent Robot Avatar est développé indépendamment et n’est affilié, approuvé ou représentatif d’aucune plateforme ou marque d’IA.
-
-## Design du personnage et identité visuelle
-
-Le personnage Agent Robot Avatar, y compris son apparence robotique et son identité visuelle, est une création originale de CX ArtLab.
-
-La licence MIT s’applique au logiciel et au code source. Elle permet d’utiliser, modifier et distribuer l’avatar dans des applications, mais ne transfère pas la propriété du nom Agent Robot Avatar, de l’identité du personnage ou de son identité visuelle, et n’accorde pas le droit de les présenter comme le personnage original ou la marque autonome d’un tiers.
-
-Les noms de produits tiers mentionnés dans ce projet servent uniquement à décrire des cas d’usage possibles et n’impliquent aucune affiliation ni approbation.
-
-## Licence
-
-MIT License. Voir [`LICENSE`](../LICENSE).
-
----
-
-Si ce projet vous est utile, vous pouvez m’offrir un café.
-
-<a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>