agent-robot-avatar 0.3.1 → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +13 -0
- package/README.md +3 -3
- package/docs/README.de.md +3 -3
- package/docs/README.es.md +3 -3
- package/docs/README.fr.md +3 -3
- package/docs/README.ja.md +3 -3
- package/docs/README.ko.md +3 -3
- package/docs/README.pt.md +3 -3
- package/docs/README.zh-CN.md +3 -3
- package/docs/README.zh-TW.md +3 -3
- package/index.d.ts +3 -0
- package/package.json +1 -1
- package/src/agent-robot-avatar-core.js +18 -1
- package/src/agent-robot-avatar-runtime.js +2 -17
- package/src/agent-robot-avatar-version.js +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,18 @@ The project follows Semantic Versioning for public releases. Internal developmen
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
+
## [0.3.2] - 2026-09-10
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
|
|
13
|
+
- Unified synchronous `size` attribute parsing so numeric and `px` values use the same validation immediately, without a transient fallback before runtime observers run.
|
|
14
|
+
- Added the existing public `sleep()`, `wake()`, and `input()` convenience methods to the TypeScript declaration surface and type checks.
|
|
15
|
+
- Stabilized request-replacement race tests by ordering competing clicks in the same browser task instead of depending on an 80 ms wall-clock window.
|
|
16
|
+
- Expanded package integrity coverage to require the runtime and geometry modules explicitly.
|
|
17
|
+
|
|
18
|
+
- Prevented the accessible request lifecycle example's delayed replacement step from starting after cancellation, a newer user request, or a newer replacement flow has invalidated it.
|
|
19
|
+
- Made the example's business status the only automatic live region; the visible request debug log remains available for deliberate reading without `role="log"` live semantics or whole-log text rewrites.
|
|
20
|
+
|
|
9
21
|
## [0.3.1] - 2026-09-10
|
|
10
22
|
|
|
11
23
|
### Fixed
|
|
@@ -104,6 +116,7 @@ First public release.
|
|
|
104
116
|
- npm-compatible package metadata for later package publication
|
|
105
117
|
- Contribution guide, issue templates, pull request template, MIT License, and Ko-fi funding metadata
|
|
106
118
|
|
|
119
|
+
[0.3.2]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.3.2
|
|
107
120
|
[0.3.1]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.3.1
|
|
108
121
|
[0.3.0]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.3.0
|
|
109
122
|
[0.2.1]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.2.1
|
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
[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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.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) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](./LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Agent Robot Avatar can also be used as a visual feedback layer for AG-UI-style a
|
|
|
20
20
|
|
|
21
21
|
Agent Robot Avatar is built with SVG and vanilla JavaScript. It has no third-party animation framework dependency, works as a native custom element, and exposes a compact API for expressions, interaction states, pointer behavior, waiting feedback, and head-shape customization.
|
|
22
22
|
|
|
23
|
-
**Current public version: v0.3.
|
|
23
|
+
**Current public version: v0.3.2**
|
|
24
24
|
|
|
25
25
|
<p align="center">
|
|
26
26
|
<img src="./assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar interactive animation demo" width="560">
|
|
@@ -425,7 +425,7 @@ Issues and pull requests are welcome. See [`CONTRIBUTING.md`](./CONTRIBUTING.md)
|
|
|
425
425
|
|
|
426
426
|
## Project status
|
|
427
427
|
|
|
428
|
-
v0.3.
|
|
428
|
+
v0.3.2 is the current public release. v0.1.0 remains available as the first public version. The public API is intentionally small so it can evolve carefully before a future `1.0.0` stability commitment.
|
|
429
429
|
|
|
430
430
|
Agent Robot Avatar is independently developed and is not affiliated with, endorsed by, or representative of any AI platform or brand.
|
|
431
431
|
|
package/docs/README.de.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
[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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.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) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Agent Robot Avatar kann außerdem als visuelle Feedback-Ebene für Agent-Oberfl
|
|
|
20
20
|
|
|
21
21
|
Agent Robot Avatar basiert auf SVG und Vanilla JavaScript und benötigt kein externes Animationsframework. Die Komponente funktioniert als natives Custom Element und stellt eine kompakte API für Ausdrücke, Interaktionszustände, Pointer-Following, Wartefeedback und Kopfform bereit.
|
|
22
22
|
|
|
23
|
-
**Aktuelle öffentliche Version: v0.3.
|
|
23
|
+
**Aktuelle öffentliche Version: v0.3.2**
|
|
24
24
|
|
|
25
25
|
<p align="center">
|
|
26
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Interaktive animierte Demo von Agent Robot Avatar" width="560">
|
|
@@ -153,7 +153,7 @@ Issues und Pull Requests sind willkommen. Bitte vor Änderungen [`CONTRIBUTING.m
|
|
|
153
153
|
|
|
154
154
|
## Projektstatus
|
|
155
155
|
|
|
156
|
-
v0.3.
|
|
156
|
+
v0.3.2 ist die aktuelle öffentliche Version. v0.1.0 bleibt als erste öffentliche Version verfügbar. Die öffentliche API bleibt bewusst klein, damit sie vor einer späteren Stabilitätszusage mit `1.0.0` sorgfältig weiterentwickelt werden kann.
|
|
157
157
|
|
|
158
158
|
Agent Robot Avatar ist ein unabhängig entwickeltes Open-Source-Projekt und steht in keiner offiziellen Verbindung zu einer KI-Plattform oder Marke.
|
|
159
159
|
|
package/docs/README.es.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
[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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.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) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Agent Robot Avatar también puede funcionar como una capa de feedback visual par
|
|
|
20
20
|
|
|
21
21
|
Agent Robot Avatar está construido con SVG y JavaScript nativo, sin depender de frameworks de animación de terceros. Funciona como un Custom Element nativo y ofrece una API compacta para expresiones, estados de interacción, seguimiento del puntero, espera y forma de la cabeza.
|
|
22
22
|
|
|
23
|
-
**Versión pública actual: v0.3.
|
|
23
|
+
**Versión pública actual: v0.3.2**
|
|
24
24
|
|
|
25
25
|
<p align="center">
|
|
26
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Demostración animada interactiva de Agent Robot Avatar" width="560">
|
|
@@ -212,7 +212,7 @@ Se aceptan Issues y Pull Requests. Consulta [`CONTRIBUTING.md`](../CONTRIBUTING.
|
|
|
212
212
|
|
|
213
213
|
## Estado del proyecto
|
|
214
214
|
|
|
215
|
-
v0.3.
|
|
215
|
+
v0.3.2 es la versión pública actual. v0.1.0 continúa disponible como la primera versión pública. La API pública se mantiene deliberadamente pequeña para poder evolucionar con cuidado antes de un futuro compromiso de estabilidad `1.0.0`.
|
|
216
216
|
|
|
217
217
|
Agent Robot Avatar es un proyecto independiente de código abierto y no está afiliado, respaldado ni representa a ninguna plataforma o marca de IA.
|
|
218
218
|
|
package/docs/README.fr.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
[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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.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) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Agent Robot Avatar peut également servir de couche de retour visuel pour les in
|
|
|
20
20
|
|
|
21
21
|
Agent Robot Avatar est construit avec SVG et JavaScript natif, sans framework d’animation tiers. Il fonctionne comme un Custom Element natif et propose une API compacte pour les expressions, les états d’interaction, le suivi du pointeur, l’attente et la forme de la tête.
|
|
22
22
|
|
|
23
|
-
**Version publique actuelle : v0.3.
|
|
23
|
+
**Version publique actuelle : v0.3.2**
|
|
24
24
|
|
|
25
25
|
<p align="center">
|
|
26
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Démonstration animée interactive d’Agent Robot Avatar" width="560">
|
|
@@ -212,7 +212,7 @@ Issues et Pull Requests sont les bienvenus. Consultez [`CONTRIBUTING.md`](../CON
|
|
|
212
212
|
|
|
213
213
|
## État du projet
|
|
214
214
|
|
|
215
|
-
v0.3.
|
|
215
|
+
v0.3.2 est la version publique actuelle. v0.1.0 reste disponible comme première version publique. L’API publique reste volontairement limitée afin d’évoluer avec prudence avant un futur engagement de stabilité `1.0.0`.
|
|
216
216
|
|
|
217
217
|
Agent Robot Avatar est un projet open source développé indépendamment ; il n’est affilié, approuvé ni représentatif d’aucune plateforme ou marque d’IA.
|
|
218
218
|
|
package/docs/README.ja.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
[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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.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) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Agent Robot Avatar は、AG-UI スタイルの Agent インターフェースに
|
|
|
20
20
|
|
|
21
21
|
Agent Robot Avatar は SVG と Vanilla JavaScript だけで構築され、サードパーティー製アニメーションフレームワークに依存しません。ネイティブ Custom Element として動作し、表情、状態、ポインター追従、待機フィードバック、頭部形状をシンプルな API で制御できます。
|
|
22
22
|
|
|
23
|
-
**現在の公開バージョン：v0.3.
|
|
23
|
+
**現在の公開バージョン：v0.3.2**
|
|
24
24
|
|
|
25
25
|
<p align="center">
|
|
26
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar インタラクティブアニメーションデモ" width="560">
|
|
@@ -212,7 +212,7 @@ Issue と Pull Request を歓迎します。提出前に [`CONTRIBUTING.md`](../
|
|
|
212
212
|
|
|
213
213
|
## プロジェクトの状態
|
|
214
214
|
|
|
215
|
-
v0.3.
|
|
215
|
+
v0.3.2 は現在の公開バージョンです。v0.1.0 は最初の公開バージョンとして引き続き利用できます。将来の `1.0.0` に向けて慎重に進化できるよう、公開 API は意図的に小さく保っています。
|
|
216
216
|
|
|
217
217
|
Agent Robot Avatar は独立して開発されたオープンソースプロジェクトであり、特定の AI プラットフォームやブランドとは提携・公式承認関係にありません。
|
|
218
218
|
|
package/docs/README.ko.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
[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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.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) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Agent Robot Avatar는 AG-UI 스타일 Agent 인터페이스의 시각적 피드
|
|
|
20
20
|
|
|
21
21
|
Agent Robot Avatar는 SVG와 Vanilla JavaScript로만 구성되어 있으며 타사 애니메이션 프레임워크에 의존하지 않습니다. 네이티브 Custom Element로 동작하고 표정, 상호작용 상태, 포인터 추적, 대기 피드백, 머리 형태를 제어하는 간결한 API를 제공합니다.
|
|
22
22
|
|
|
23
|
-
**현재 공개 버전: v0.3.
|
|
23
|
+
**현재 공개 버전: v0.3.2**
|
|
24
24
|
|
|
25
25
|
<p align="center">
|
|
26
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar 인터랙티브 애니메이션 데모" width="560">
|
|
@@ -212,7 +212,7 @@ Issue와 Pull Request를 환영합니다. 제출 전 [`CONTRIBUTING.md`](../CONT
|
|
|
212
212
|
|
|
213
213
|
## 프로젝트 상태
|
|
214
214
|
|
|
215
|
-
v0.3.
|
|
215
|
+
v0.3.2은 현재 공개 버전입니다. v0.1.0은 첫 공개 버전으로 계속 제공됩니다. 향후 `1.0.0` 안정성 약속 이전에 신중하게 발전시킬 수 있도록 공개 API를 의도적으로 작게 유지하고 있습니다.
|
|
216
216
|
|
|
217
217
|
Agent Robot Avatar는 독립적으로 개발된 오픈 소스 프로젝트이며 특정 AI 플랫폼이나 브랜드와 제휴하거나 공식 승인을 받은 프로젝트가 아닙니다.
|
|
218
218
|
|
package/docs/README.pt.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
[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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.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) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Agent Robot Avatar também pode funcionar como uma camada de feedback visual par
|
|
|
20
20
|
|
|
21
21
|
Agent Robot Avatar é construído com SVG e JavaScript puro, sem dependência de frameworks de animação de terceiros. Funciona como um Custom Element nativo e oferece uma API compacta para expressões, estados de interação, seguimento do ponteiro, feedback de espera e formato da cabeça.
|
|
22
22
|
|
|
23
|
-
**Versão pública atual: v0.3.
|
|
23
|
+
**Versão pública atual: v0.3.2**
|
|
24
24
|
|
|
25
25
|
<p align="center">
|
|
26
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Demonstração animada interativa do Agent Robot Avatar" width="560">
|
|
@@ -212,7 +212,7 @@ Issues e Pull Requests são bem-vindos. Leia [`CONTRIBUTING.md`](../CONTRIBUTING
|
|
|
212
212
|
|
|
213
213
|
## Status do projeto
|
|
214
214
|
|
|
215
|
-
v0.3.
|
|
215
|
+
v0.3.2 é a versão pública atual. v0.1.0 continua disponível como a primeira versão pública. A API pública é mantida deliberadamente pequena para evoluir com cuidado antes de um futuro compromisso de estabilidade `1.0.0`.
|
|
216
216
|
|
|
217
217
|
Agent Robot Avatar é um projeto independente de código aberto e não é afiliado, endossado nem representa nenhuma plataforma ou marca de IA.
|
|
218
218
|
|
package/docs/README.zh-CN.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
[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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.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) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
|
|
17
17
|
Agent Robot Avatar 基于 SVG 与原生 JavaScript 构建，不依赖第三方动画框架，作为原生自定义元素工作，并提供尽量精简的公开 API。
|
|
18
18
|
|
|
19
|
-
**当前公开版本：v0.3.
|
|
19
|
+
**当前公开版本：v0.3.2**
|
|
20
20
|
|
|
21
21
|
<p align="center">
|
|
22
22
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar 交互动画演示" width="560">
|
|
@@ -379,7 +379,7 @@ LICENSE MIT License
|
|
|
379
379
|
|
|
380
380
|
## 项目状态
|
|
381
381
|
|
|
382
|
-
v0.3.
|
|
382
|
+
v0.3.2 是当前公开版本。当前刻意保持较小的公开 API，以便在未来 `1.0.0` 稳定性承诺之前继续谨慎演进。
|
|
383
383
|
|
|
384
384
|
Agent Robot Avatar 为独立开发的开源项目，不隶属于、代表或获得任何 AI 平台或品牌的官方背书。
|
|
385
385
|
|
package/docs/README.zh-TW.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
[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) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.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) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.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) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
|
|
8
8
|
|
|
9
|
-
 [](../LICENSE) [](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [](https://ko-fi.com/P0E625WIOI)
|
|
10
10
|
|
|
11
11
|
      
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Agent Robot Avatar 也可作為 AG-UI 類 Agent 介面的視覺回饋層。
|
|
|
20
20
|
|
|
21
21
|
Agent Robot Avatar 以 SVG 與原生 JavaScript 建構，不依賴第三方動畫框架。它作為原生自訂元素運作，並提供精簡 API 來控制表情、互動狀態、指標跟隨、等待回饋與頭部造型。
|
|
22
22
|
|
|
23
|
-
**目前公開版本：v0.3.
|
|
23
|
+
**目前公開版本：v0.3.2**
|
|
24
24
|
|
|
25
25
|
<p align="center">
|
|
26
26
|
<img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar 互動動畫展示" width="560">
|
|
@@ -214,7 +214,7 @@ LICENSE MIT License
|
|
|
214
214
|
|
|
215
215
|
## 專案狀態
|
|
216
216
|
|
|
217
|
-
v0.3.
|
|
217
|
+
v0.3.2 是目前的公開版本。v0.1.0 作為第一個公開版本繼續保留。公開 API 目前刻意保持精簡，讓專案能在未來 `1.0.0` 穩定性承諾前持續謹慎演進。
|
|
218
218
|
|
|
219
219
|
Agent Robot Avatar 是獨立開發的開源專案，不隸屬、代表或獲得任何 AI 平台或品牌的官方背書。
|
|
220
220
|
|
package/index.d.ts
CHANGED
|
@@ -76,6 +76,9 @@ export interface AgentRobotAvatarEventMap extends HTMLElementEventMap {
|
|
|
76
76
|
export declare class AgentRobotAvatar extends HTMLElement {
|
|
77
77
|
play(action: AgentRobotAvatarAction): this | Promise<void>;
|
|
78
78
|
reset(): this;
|
|
79
|
+
sleep(): this | Promise<void>;
|
|
80
|
+
wake(): this | Promise<void>;
|
|
81
|
+
input(active?: boolean): this | Promise<void>;
|
|
79
82
|
startWaiting(): Promise<this>;
|
|
80
83
|
stopWaiting(): this;
|
|
81
84
|
setPointerFollow(enabled?: boolean): this;
|
package/package.json
CHANGED
|
@@ -59,6 +59,13 @@ const AgentRobotAvatar = (() => {
|
|
|
59
59
|
const clamp = (v, a, b) => Math.max(a, Math.min(b, v));
|
|
60
60
|
const lerp = (a, b, t) => a + (b - a) * t;
|
|
61
61
|
const clonePose = p => ({...p});
|
|
62
|
+
const DEFAULT_SIZE = 112;
|
|
63
|
+
const parseSize = value => {
|
|
64
|
+
const text = String(value ?? '').trim();
|
|
65
|
+
if (!/^(?:\d+(?:\.\d+)?|\.\d+)(?:px)?$/i.test(text)) return DEFAULT_SIZE;
|
|
66
|
+
const numeric = Number.parseFloat(text);
|
|
67
|
+
return Number.isFinite(numeric) && numeric > 0 ? numeric : DEFAULT_SIZE;
|
|
68
|
+
};
|
|
62
69
|
const connectedFaces = new Set();
|
|
63
70
|
|
|
64
71
|
const forEachConnectedFace = callback => {
|
|
@@ -215,13 +222,23 @@ const AgentRobotAvatar = (() => {
|
|
|
215
222
|
attributeChangedCallback(name, oldV, newV) {
|
|
216
223
|
if (oldV === newV) return;
|
|
217
224
|
if (name === 'color') this._applyColor(newV);
|
|
218
|
-
if (name === 'size') this.
|
|
225
|
+
if (name === 'size') this._syncSizeAttribute();
|
|
219
226
|
if (name === 'auto-sleep') {
|
|
220
227
|
this._autoSleepMs = Number(newV) || 0;
|
|
221
228
|
this._scheduleAutoSleep?.();
|
|
222
229
|
}
|
|
223
230
|
}
|
|
224
231
|
|
|
232
|
+
_syncSizeAttribute() {
|
|
233
|
+
if (!this.hasAttribute('size')) {
|
|
234
|
+
this.style.removeProperty('--face-size');
|
|
235
|
+
return DEFAULT_SIZE;
|
|
236
|
+
}
|
|
237
|
+
const size = parseSize(this.getAttribute('size'));
|
|
238
|
+
this.style.setProperty('--face-size', `${size}px`);
|
|
239
|
+
return size;
|
|
240
|
+
}
|
|
241
|
+
|
|
225
242
|
_applyColor(value) {
|
|
226
243
|
const color = value || '#08090b';
|
|
227
244
|
for (const part of [this._head, this._leftTop, this._rightTop, this._leftBottom, this._rightBottom, this._antennaDot]) {
|
|
@@ -132,24 +132,9 @@ function trackFiniteAction(instance, record, result) {
|
|
|
132
132
|
}
|
|
133
133
|
}
|
|
134
134
|
|
|
135
|
-
function parseSize(value) {
|
|
136
|
-
const text = String(value ?? '').trim();
|
|
137
|
-
const match = text.match(/^(?:\d+(?:\.\d+)?|\.\d+)(?:px)?$/i);
|
|
138
|
-
if (!match) return DEFAULT_SIZE;
|
|
139
|
-
const numeric = Number.parseFloat(text);
|
|
140
|
-
if (!Number.isFinite(numeric) || numeric <= 0) return DEFAULT_SIZE;
|
|
141
|
-
return numeric;
|
|
142
|
-
}
|
|
143
|
-
|
|
144
135
|
function applySize(instance) {
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
instance._runtimeSizeApplied = false;
|
|
148
|
-
return;
|
|
149
|
-
}
|
|
150
|
-
const size = parseSize(instance.getAttribute('size'));
|
|
151
|
-
instance.style.setProperty('--face-size', `${size}px`);
|
|
152
|
-
instance._runtimeSizeApplied = true;
|
|
136
|
+
instance._syncSizeAttribute();
|
|
137
|
+
instance._runtimeSizeApplied = instance.hasAttribute('size');
|
|
153
138
|
}
|
|
154
139
|
|
|
155
140
|
function hasVisibleLayout(instance) {
|