agent-robot-avatar 0.5.2 → 0.6.0
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 +45 -6
- package/README.md +20 -8
- package/agent-robot-avatar.js +0 -1
- package/docs/README.de.md +7 -8
- package/docs/README.es.md +7 -8
- package/docs/README.fr.md +7 -8
- package/docs/README.ja.md +7 -8
- package/docs/README.ko.md +7 -8
- package/docs/README.pt.md +7 -8
- package/docs/README.ru.md +7 -8
- package/docs/README.zh-CN.md +20 -8
- package/docs/README.zh-TW.md +7 -8
- package/index.d.ts +30 -17
- package/package.json +4 -2
- package/src/agent-robot-avatar-actions.js +17 -14
- package/src/agent-robot-avatar-gestures.js +9 -0
- package/src/agent-robot-avatar-runtime.js +54 -11
- package/src/agent-robot-avatar-version.js +1 -1
- package/src/agent-robot-avatar-waiting.js +30 -6
- package/src/agent-robot-avatar-antenna-flash.js +0 -127
package/CHANGELOG.md
CHANGED
|
@@ -6,25 +6,60 @@ The project follows Semantic Versioning for public releases. Internal developmen
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
-
## [0.
|
|
9
|
+
## [0.6.0] - 2026-10-23
|
|
10
10
|
|
|
11
|
-
###
|
|
11
|
+
### Upgrading from 0.5.x
|
|
12
|
+
|
|
13
|
+
Several actions are renamed after what the avatar does on screen, instead of the situation they were first written for. The old names keep working in 0.6 and print a one-time notice in the browser console; they stop working in 1.0. To upgrade, replace the old names in `play()` calls and in `action-state` or `face-state` listeners:
|
|
14
|
+
|
|
15
|
+
| Old name | New name | What it looks like |
|
|
16
|
+
| --- | --- | --- |
|
|
17
|
+
| `send` | `affirm` | A nod |
|
|
18
|
+
| `warning` | `wary` | Head turned, one eye close, a guarded up-and-down look |
|
|
19
|
+
| `error`, `system-error`, `connection-error` | `refuse` | A head shake |
|
|
20
|
+
| `blocked`, `policy-blocked` | `angry` | Lowered, glaring eyes |
|
|
21
|
+
| `wait` | `waiting-spin` (or `waiting`) | The default waiting spin |
|
|
22
|
+
| `failed`, `fail` | `failure` | |
|
|
23
|
+
| `verify`, `review` | `inspect` | |
|
|
24
|
+
| `slot` | `random` | |
|
|
25
|
+
|
|
26
|
+
`action-state` now reports `affirm`, `wary`, `angry` and `refuse`, and `face-state` reports `wary` and `refuse`. A shake reads as "no", so use `refuse` when the Agent cannot or will not do something, and `failure` when a task or connection fails. Antenna blinking is removed: `setAntennaFlash()` now does nothing and prints a one-time notice, and it is deleted in 1.0. Packages that depend on `^0.5.x` do not pick up 0.6 automatically.
|
|
27
|
+
|
|
28
|
+
### Added
|
|
29
|
+
|
|
30
|
+
- Added the `waiting-wave` action: both eyes bob in staggered waves. `startWaiting({ variant: 'wave' })` loops it continuously.
|
|
31
|
+
- Added `waiting-spin` as the explicit name of the default waiting motion, and `startWaiting({ variant: 'spin' })`.
|
|
32
|
+
- Added brand-inspired color palettes to the demo. Colors apply to a stage card around the avatar; hovering a swatch previews it, a dice button picks a random palette, a swap button exchanges the background and head colors, and a reset button appears on the stage while the colors differ from the default. The page opens by rolling the stage through the palettes in step with the eyes' reel spin, ending with a faint rainbow ripple.
|
|
33
|
+
|
|
34
|
+
### Changed
|
|
35
|
+
|
|
36
|
+
- Renamed actions as listed above.
|
|
37
|
+
- Demo labels now describe the expression: Waiting · Spin, Waiting · Scroll, Affirm, Wary, Angry and Refuse. The toolbar row is one card as wide as the actions, with Head shape and a random-colors button.
|
|
38
|
+
- Refined the wary expression with independently tilted eyes, adjusted eye proportions and eyelids.
|
|
12
39
|
|
|
13
|
-
|
|
40
|
+
### Also in this release
|
|
14
41
|
|
|
15
|
-
|
|
42
|
+
- The embedded eyes engine for robot and dev-board screens is still in development. It will get its own version number and release; progress is tracked in [embedded/CHANGELOG.md](embedded/CHANGELOG.md).
|
|
43
|
+
|
|
44
|
+
### Removed
|
|
45
|
+
|
|
46
|
+
- Removed antenna blinking (`setAntennaFlash()`), which added little and is no longer shown in the demo.
|
|
16
47
|
|
|
17
48
|
### Fixed
|
|
18
49
|
|
|
19
|
-
-
|
|
50
|
+
- The demo no longer shows intermediate layouts while loading, keeps its action rows even and stable on phones and under browser page translators, and keeps an open panel on screen.
|
|
20
51
|
|
|
21
|
-
## [0.5.
|
|
52
|
+
## [0.5.2] - 2026-10-06
|
|
22
53
|
|
|
23
54
|
### Added
|
|
24
55
|
|
|
25
56
|
- Added the `love` action: the eyes lean together into a heart, beat three times, then return.
|
|
26
57
|
- Added the `random` action (alias `slot`): the eyes roll like slot-machine reels, then settle with a bounce.
|
|
27
58
|
|
|
59
|
+
### Fixed
|
|
60
|
+
|
|
61
|
+
- `love` now shows the full heart under reduced motion, and `love` and `random` follow motion preference changes while they play.
|
|
62
|
+
|
|
28
63
|
## [0.4.3] - 2026-09-22
|
|
29
64
|
|
|
30
65
|
### Fixed
|
|
@@ -160,6 +195,8 @@ First public release.
|
|
|
160
195
|
- npm-compatible package metadata for later package publication
|
|
161
196
|
- Contribution guide, issue templates, pull request template, MIT License, and Ko-fi funding metadata
|
|
162
197
|
|
|
198
|
+
[0.6.0]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.6.0
|
|
199
|
+
[0.5.2]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.5.2
|
|
163
200
|
[0.4.3]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.4.3
|
|
164
201
|
[0.4.2]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.4.2
|
|
165
202
|
[0.3.2]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.3.2
|
|
@@ -168,3 +205,5 @@ First public release.
|
|
|
168
205
|
[0.2.1]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.2.1
|
|
169
206
|
[0.2.0]: https://github.com/CX-ARTLab/agent-robot-avatar/releases/tag/v0.2.0
|
|
170
207
|
[0.1.0]: https://github.com/CX-ARTLab/agent-robot-avatar/releases/tag/v0.1.0
|
|
208
|
+
|
|
209
|
+
|
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) | [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)
|
|
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
|
|
|
@@ -45,6 +45,12 @@ Built with SVG and vanilla JavaScript, it works as a native custom element with
|
|
|
45
45
|
- Optional antenna status flashing
|
|
46
46
|
- TypeScript declarations included
|
|
47
47
|
|
|
48
|
+
## Embedded eyes (experimental)
|
|
49
|
+
|
|
50
|
+
An independent, allocation-free C++11 eyes-only engine draws the same 18 expressions on robot and dev-board screens. Firmware examples cover 26 board and screen configurations across ESP32, ESP32-S3 and RP2040 — ST7789, ST7735, GC9A01 round, ILI9341/9342/9488, CO5300 AMOLED, ST7701S RGB panels and SSD1306/SH1106 OLEDs, including LilyGO, M5Stack, Waveshare, Seeed and Espressif boards. Every example compiles in CI; none is verified on real hardware yet, so please send a hardware report if you try one.
|
|
51
|
+
|
|
52
|
+
See the [embedded guide](https://github.com/CX-ArtLab/agent-robot-avatar/tree/main/embedded) and [中文说明](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/embedded/README.zh-CN.md). The Web component's installation and behavior are unchanged.
|
|
53
|
+
|
|
48
54
|
## Install
|
|
49
55
|
|
|
50
56
|
```bash
|
|
@@ -75,17 +81,19 @@ No initialization code is required. The avatar enters its default idle behavior
|
|
|
75
81
|
const avatar = document.querySelector('#avatar');
|
|
76
82
|
|
|
77
83
|
avatar.play('success');
|
|
78
|
-
avatar.play('
|
|
79
|
-
avatar.play('
|
|
84
|
+
avatar.play('wary');
|
|
85
|
+
avatar.play('refuse');
|
|
80
86
|
|
|
81
87
|
avatar.reset();
|
|
82
88
|
```
|
|
83
89
|
|
|
84
90
|
Available actions:
|
|
85
91
|
|
|
86
|
-
`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `
|
|
92
|
+
`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
|
|
93
|
+
|
|
94
|
+
`waiting-wave` plays three 1.1-second waves: the eyes bob vertically with a staggered rhythm and amplitude of 10 SVG units, then settle. Use `startWaiting({ variant: 'wave' })` for seamless continuous waiting, and `stopWaiting()` to stop. It honors the component's reduced-motion setting and reports the canonical `waiting` action lifecycle.
|
|
87
95
|
|
|
88
|
-
`failure` is
|
|
96
|
+
Action names describe what the avatar does. `refuse` shakes the head, for a request the Agent cannot or will not carry out; `failure` is for a task or connection that did not succeed; `wary` turns the head and gives a guarded up-and-down look, for an action that needs confirmation. Names from 0.5 (`send`, `warning`, `error`, `blocked` and others) still work with a console notice until 1.0; see the [upgrade table](CHANGELOG.md#upgrading-from-05x).
|
|
89
97
|
|
|
90
98
|
`love` expresses affection or thanks: the two eyes lean together into a single heart, beat three times, then return.
|
|
91
99
|
|
|
@@ -99,11 +107,14 @@ avatar.startWaiting();
|
|
|
99
107
|
// Alternative waiting motion: eyes turn out through one side and return through the other.
|
|
100
108
|
avatar.startWaiting({ variant: 'wrap' });
|
|
101
109
|
|
|
110
|
+
// Alternative waiting motion: staggered vertical eye waves.
|
|
111
|
+
avatar.startWaiting({ variant: 'wave' });
|
|
112
|
+
|
|
102
113
|
try {
|
|
103
114
|
const result = await runAgentRequest();
|
|
104
115
|
await avatar.play(result.ok ? 'success' : 'failure');
|
|
105
116
|
} catch (error) {
|
|
106
|
-
await avatar.play('
|
|
117
|
+
await avatar.play('failure');
|
|
107
118
|
}
|
|
108
119
|
```
|
|
109
120
|
|
|
@@ -134,7 +145,6 @@ Common runtime controls:
|
|
|
134
145
|
```js
|
|
135
146
|
avatar.setPointerFollow(false);
|
|
136
147
|
avatar.setHeadRoundness(75);
|
|
137
|
-
avatar.setAntennaFlash(true);
|
|
138
148
|
avatar.setPressSqueeze(true);
|
|
139
149
|
avatar.setAntennaDrag(true);
|
|
140
150
|
```
|
|
@@ -161,7 +171,7 @@ Issues and pull requests are welcome. See [`CONTRIBUTING.md`](./CONTRIBUTING.md)
|
|
|
161
171
|
|
|
162
172
|
## Project status
|
|
163
173
|
|
|
164
|
-
**Current public version: v0.
|
|
174
|
+
**Current public version: v0.6.0**
|
|
165
175
|
|
|
166
176
|
The public API is intentionally kept compact while the project evolves toward a future `1.0.0` stability commitment.
|
|
167
177
|
|
|
@@ -184,3 +194,5 @@ MIT License. See [`LICENSE`](./LICENSE).
|
|
|
184
194
|
If this project is useful to you, you can buy me a coffee.
|
|
185
195
|
|
|
186
196
|
<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>
|
|
197
|
+
|
|
198
|
+
|
package/agent-robot-avatar.js
CHANGED
|
@@ -2,7 +2,6 @@ import AgentRobotAvatar from './src/agent-robot-avatar-extension-host.js';
|
|
|
2
2
|
import './src/agent-robot-avatar-actions.js';
|
|
3
3
|
import './src/agent-robot-avatar-antenna.js';
|
|
4
4
|
import './src/agent-robot-avatar-waiting.js';
|
|
5
|
-
import './src/agent-robot-avatar-antenna-flash.js';
|
|
6
5
|
import './src/agent-robot-avatar-inspect.js';
|
|
7
6
|
import './src/agent-robot-avatar-failure.js';
|
|
8
7
|
import './src/agent-robot-avatar-love.js';
|
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) | [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)
|
|
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
|
|
|
@@ -75,17 +75,17 @@ Es ist kein Initialisierungscode nötig. Der Avatar wechselt automatisch in sein
|
|
|
75
75
|
const avatar = document.querySelector('#avatar');
|
|
76
76
|
|
|
77
77
|
avatar.play('success');
|
|
78
|
-
avatar.play('
|
|
79
|
-
avatar.play('
|
|
78
|
+
avatar.play('wary');
|
|
79
|
+
avatar.play('refuse');
|
|
80
80
|
|
|
81
81
|
avatar.reset();
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
Verfügbare Aktionen:
|
|
85
85
|
|
|
86
|
-
`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `
|
|
86
|
+
`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
|
|
87
87
|
|
|
88
|
-
`failure` steht für eine Aufgabe, die
|
|
88
|
+
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).
|
|
89
89
|
|
|
90
90
|
`love` drückt Zuneigung oder Dank aus: Die beiden Augen neigen sich zu einem einzigen Herz zusammen, schlagen dreimal und kehren dann zurück.
|
|
91
91
|
|
|
@@ -103,7 +103,7 @@ try {
|
|
|
103
103
|
const result = await runAgentRequest();
|
|
104
104
|
await avatar.play(result.ok ? 'success' : 'failure');
|
|
105
105
|
} catch (error) {
|
|
106
|
-
await avatar.play('
|
|
106
|
+
await avatar.play('failure');
|
|
107
107
|
}
|
|
108
108
|
```
|
|
109
109
|
|
|
@@ -134,7 +134,6 @@ Häufige Runtime-Steuerungen:
|
|
|
134
134
|
```js
|
|
135
135
|
avatar.setPointerFollow(false);
|
|
136
136
|
avatar.setHeadRoundness(75);
|
|
137
|
-
avatar.setAntennaFlash(true);
|
|
138
137
|
avatar.setPressSqueeze(true);
|
|
139
138
|
avatar.setAntennaDrag(true);
|
|
140
139
|
```
|
|
@@ -161,7 +160,7 @@ Issues und Pull Requests sind willkommen. Bitte vor Änderungen [`CONTRIBUTING.m
|
|
|
161
160
|
|
|
162
161
|
## Projektstatus
|
|
163
162
|
|
|
164
|
-
**Aktuelle öffentliche Version: v0.
|
|
163
|
+
**Aktuelle öffentliche Version: v0.6.0**
|
|
165
164
|
|
|
166
165
|
Die öffentliche API bleibt bewusst kompakt, während sich das Projekt in Richtung einer zukünftigen Stabilitätszusage mit `1.0.0` entwickelt.
|
|
167
166
|
|
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) | [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)
|
|
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
|
|
|
@@ -75,17 +75,17 @@ No hace falta código de inicialización. El avatar entra automáticamente en su
|
|
|
75
75
|
const avatar = document.querySelector('#avatar');
|
|
76
76
|
|
|
77
77
|
avatar.play('success');
|
|
78
|
-
avatar.play('
|
|
79
|
-
avatar.play('
|
|
78
|
+
avatar.play('wary');
|
|
79
|
+
avatar.play('refuse');
|
|
80
80
|
|
|
81
81
|
avatar.reset();
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
Acciones disponibles:
|
|
85
85
|
|
|
86
|
-
`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `
|
|
86
|
+
`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
|
|
87
87
|
|
|
88
|
-
`failure`
|
|
88
|
+
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).
|
|
89
89
|
|
|
90
90
|
`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.
|
|
91
91
|
|
|
@@ -103,7 +103,7 @@ try {
|
|
|
103
103
|
const result = await runAgentRequest();
|
|
104
104
|
await avatar.play(result.ok ? 'success' : 'failure');
|
|
105
105
|
} catch (error) {
|
|
106
|
-
await avatar.play('
|
|
106
|
+
await avatar.play('failure');
|
|
107
107
|
}
|
|
108
108
|
```
|
|
109
109
|
|
|
@@ -134,7 +134,6 @@ Controles habituales en tiempo de ejecución:
|
|
|
134
134
|
```js
|
|
135
135
|
avatar.setPointerFollow(false);
|
|
136
136
|
avatar.setHeadRoundness(75);
|
|
137
|
-
avatar.setAntennaFlash(true);
|
|
138
137
|
avatar.setPressSqueeze(true);
|
|
139
138
|
avatar.setAntennaDrag(true);
|
|
140
139
|
```
|
|
@@ -161,7 +160,7 @@ Se aceptan Issues y Pull Requests. Consulta [`CONTRIBUTING.md`](../CONTRIBUTING.
|
|
|
161
160
|
|
|
162
161
|
## Estado del proyecto
|
|
163
162
|
|
|
164
|
-
**Versión pública actual: v0.
|
|
163
|
+
**Versión pública actual: v0.6.0**
|
|
165
164
|
|
|
166
165
|
La API pública se mantiene deliberadamente compacta mientras el proyecto evoluciona hacia un futuro compromiso de estabilidad `1.0.0`.
|
|
167
166
|
|
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) | [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)
|
|
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
|
|
|
@@ -75,17 +75,17 @@ Aucun code d’initialisation n’est nécessaire. L’avatar entre automatiquem
|
|
|
75
75
|
const avatar = document.querySelector('#avatar');
|
|
76
76
|
|
|
77
77
|
avatar.play('success');
|
|
78
|
-
avatar.play('
|
|
79
|
-
avatar.play('
|
|
78
|
+
avatar.play('wary');
|
|
79
|
+
avatar.play('refuse');
|
|
80
80
|
|
|
81
81
|
avatar.reset();
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
Actions disponibles :
|
|
85
85
|
|
|
86
|
-
`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `
|
|
86
|
+
`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
|
|
87
87
|
|
|
88
|
-
`failure`
|
|
88
|
+
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).
|
|
89
89
|
|
|
90
90
|
`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.
|
|
91
91
|
|
|
@@ -103,7 +103,7 @@ try {
|
|
|
103
103
|
const result = await runAgentRequest();
|
|
104
104
|
await avatar.play(result.ok ? 'success' : 'failure');
|
|
105
105
|
} catch (error) {
|
|
106
|
-
await avatar.play('
|
|
106
|
+
await avatar.play('failure');
|
|
107
107
|
}
|
|
108
108
|
```
|
|
109
109
|
|
|
@@ -134,7 +134,6 @@ Contrôles courants à l’exécution :
|
|
|
134
134
|
```js
|
|
135
135
|
avatar.setPointerFollow(false);
|
|
136
136
|
avatar.setHeadRoundness(75);
|
|
137
|
-
avatar.setAntennaFlash(true);
|
|
138
137
|
avatar.setPressSqueeze(true);
|
|
139
138
|
avatar.setAntennaDrag(true);
|
|
140
139
|
```
|
|
@@ -161,7 +160,7 @@ Issues et Pull Requests sont les bienvenus. Consultez [`CONTRIBUTING.md`](../CON
|
|
|
161
160
|
|
|
162
161
|
## État du projet
|
|
163
162
|
|
|
164
|
-
**Version publique actuelle : v0.
|
|
163
|
+
**Version publique actuelle : v0.6.0**
|
|
165
164
|
|
|
166
165
|
L’API publique reste volontairement compacte pendant l’évolution du projet vers un futur engagement de stabilité `1.0.0`.
|
|
167
166
|
|
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) | [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)
|
|
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
|
|
|
@@ -75,17 +75,17 @@ import 'agent-robot-avatar';
|
|
|
75
75
|
const avatar = document.querySelector('#avatar');
|
|
76
76
|
|
|
77
77
|
avatar.play('success');
|
|
78
|
-
avatar.play('
|
|
79
|
-
avatar.play('
|
|
78
|
+
avatar.play('wary');
|
|
79
|
+
avatar.play('refuse');
|
|
80
80
|
|
|
81
81
|
avatar.reset();
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
利用可能なアクション：
|
|
85
85
|
|
|
86
|
-
`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `
|
|
86
|
+
`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
|
|
87
87
|
|
|
88
|
-
`failure`
|
|
88
|
+
アクション名はアバターの見た目を表します。`refuse` は首を横に振る動きで、Agent が実行できない・しない依頼に使います。`failure` はタスクや接続がうまくいかなかった場合、`wary` は首をかしげて上下に見定める警戒の目つきで、確認が必要な操作に使います。0.5 の旧名（`send`、`warning`、`error`、`blocked` など）は 1.0 まで使えますが、コンソールに改名の通知が出ます。[移行表](../CHANGELOG.md#upgrading-from-05x)を参照してください。
|
|
89
89
|
|
|
90
90
|
`love` は好意や感謝を表します。両目が寄り合って一つのハートになり、3 回脈打ってから元に戻ります。
|
|
91
91
|
|
|
@@ -103,7 +103,7 @@ try {
|
|
|
103
103
|
const result = await runAgentRequest();
|
|
104
104
|
await avatar.play(result.ok ? 'success' : 'failure');
|
|
105
105
|
} catch (error) {
|
|
106
|
-
await avatar.play('
|
|
106
|
+
await avatar.play('failure');
|
|
107
107
|
}
|
|
108
108
|
```
|
|
109
109
|
|
|
@@ -134,7 +134,6 @@ try {
|
|
|
134
134
|
```js
|
|
135
135
|
avatar.setPointerFollow(false);
|
|
136
136
|
avatar.setHeadRoundness(75);
|
|
137
|
-
avatar.setAntennaFlash(true);
|
|
138
137
|
avatar.setPressSqueeze(true);
|
|
139
138
|
avatar.setAntennaDrag(true);
|
|
140
139
|
```
|
|
@@ -161,7 +160,7 @@ Issue と Pull Request を歓迎します。変更を送る前に [`CONTRIBUTING
|
|
|
161
160
|
|
|
162
161
|
## プロジェクト状況
|
|
163
162
|
|
|
164
|
-
**現在の公開バージョン：v0.
|
|
163
|
+
**現在の公開バージョン：v0.6.0**
|
|
165
164
|
|
|
166
165
|
公開 API は、将来の `1.0.0` における安定性コミットメントに向けて、意図的にコンパクトなまま慎重に進化させています。
|
|
167
166
|
|
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) | [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)
|
|
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
|
|
|
@@ -75,17 +75,17 @@ import 'agent-robot-avatar';
|
|
|
75
75
|
const avatar = document.querySelector('#avatar');
|
|
76
76
|
|
|
77
77
|
avatar.play('success');
|
|
78
|
-
avatar.play('
|
|
79
|
-
avatar.play('
|
|
78
|
+
avatar.play('wary');
|
|
79
|
+
avatar.play('refuse');
|
|
80
80
|
|
|
81
81
|
avatar.reset();
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
사용 가능한 액션:
|
|
85
85
|
|
|
86
|
-
`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `
|
|
86
|
+
`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
|
|
87
87
|
|
|
88
|
-
`
|
|
88
|
+
액션 이름은 아바타의 모습을 나타냅니다. `refuse`는 고개를 젓는 동작으로 Agent가 수행할 수 없거나 하지 않을 요청에 사용하고, `failure`는 작업이나 연결이 성공하지 못한 경우, `wary`는 고개를 돌려 위아래로 살피는 경계의 눈빛으로 확인이 필요한 작업에 사용합니다. 0.5의 이전 이름(`send`, `warning`, `error`, `blocked` 등)은 1.0까지 동작하지만 콘솔에 이름 변경 안내가 표시됩니다. [업그레이드 표](../CHANGELOG.md#upgrading-from-05x)를 참고하세요.
|
|
89
89
|
|
|
90
90
|
`love`는 호감이나 감사를 표현합니다. 두 눈이 서로 기울어 하나의 하트가 되고, 세 번 뛴 뒤 원래대로 돌아옵니다.
|
|
91
91
|
|
|
@@ -103,7 +103,7 @@ try {
|
|
|
103
103
|
const result = await runAgentRequest();
|
|
104
104
|
await avatar.play(result.ok ? 'success' : 'failure');
|
|
105
105
|
} catch (error) {
|
|
106
|
-
await avatar.play('
|
|
106
|
+
await avatar.play('failure');
|
|
107
107
|
}
|
|
108
108
|
```
|
|
109
109
|
|
|
@@ -134,7 +134,6 @@ try {
|
|
|
134
134
|
```js
|
|
135
135
|
avatar.setPointerFollow(false);
|
|
136
136
|
avatar.setHeadRoundness(75);
|
|
137
|
-
avatar.setAntennaFlash(true);
|
|
138
137
|
avatar.setPressSqueeze(true);
|
|
139
138
|
avatar.setAntennaDrag(true);
|
|
140
139
|
```
|
|
@@ -161,7 +160,7 @@ Issue와 Pull Request를 환영합니다. 변경 사항을 제출하기 전에 [
|
|
|
161
160
|
|
|
162
161
|
## 프로젝트 상태
|
|
163
162
|
|
|
164
|
-
**현재 공개 버전: v0.
|
|
163
|
+
**현재 공개 버전: v0.6.0**
|
|
165
164
|
|
|
166
165
|
공개 API는 향후 `1.0.0` 안정성 약속을 향해 발전하는 동안 의도적으로 간결하게 유지합니다.
|
|
167
166
|
|
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) | [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)
|
|
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
|
|
|
@@ -75,17 +75,17 @@ Nenhum código de inicialização é necessário. O avatar entra automaticamente
|
|
|
75
75
|
const avatar = document.querySelector('#avatar');
|
|
76
76
|
|
|
77
77
|
avatar.play('success');
|
|
78
|
-
avatar.play('
|
|
79
|
-
avatar.play('
|
|
78
|
+
avatar.play('wary');
|
|
79
|
+
avatar.play('refuse');
|
|
80
80
|
|
|
81
81
|
avatar.reset();
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
Ações disponíveis:
|
|
85
85
|
|
|
86
|
-
`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `
|
|
86
|
+
`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
|
|
87
87
|
|
|
88
|
-
`failure`
|
|
88
|
+
Os nomes das ações descrevem o que o avatar faz. `refuse` balança a cabeça, para um pedido que o Agent não pode ou não vai realizar; `failure` é para uma tarefa ou conexão que não deu certo; `wary` vira a cabeça e olha de cima a baixo com desconfiança, para uma ação que exige confirmação. Os nomes da 0.5 (`send`, `warning`, `error`, `blocked` e outros) continuam funcionando com um aviso no console até a 1.0; veja a [tabela de atualização](../CHANGELOG.md#upgrading-from-05x).
|
|
89
89
|
|
|
90
90
|
`love` expressa carinho ou gratidão: os dois olhos se inclinam até formar um único coração, batem três vezes e depois voltam ao normal.
|
|
91
91
|
|
|
@@ -103,7 +103,7 @@ try {
|
|
|
103
103
|
const result = await runAgentRequest();
|
|
104
104
|
await avatar.play(result.ok ? 'success' : 'failure');
|
|
105
105
|
} catch (error) {
|
|
106
|
-
await avatar.play('
|
|
106
|
+
await avatar.play('failure');
|
|
107
107
|
}
|
|
108
108
|
```
|
|
109
109
|
|
|
@@ -134,7 +134,6 @@ Controles comuns em tempo de execução:
|
|
|
134
134
|
```js
|
|
135
135
|
avatar.setPointerFollow(false);
|
|
136
136
|
avatar.setHeadRoundness(75);
|
|
137
|
-
avatar.setAntennaFlash(true);
|
|
138
137
|
avatar.setPressSqueeze(true);
|
|
139
138
|
avatar.setAntennaDrag(true);
|
|
140
139
|
```
|
|
@@ -161,7 +160,7 @@ Issues e Pull Requests são bem-vindos. Consulte [`CONTRIBUTING.md`](../CONTRIBU
|
|
|
161
160
|
|
|
162
161
|
## Status do projeto
|
|
163
162
|
|
|
164
|
-
**Versão pública atual: v0.
|
|
163
|
+
**Versão pública atual: v0.6.0**
|
|
165
164
|
|
|
166
165
|
A API pública é mantida deliberadamente compacta enquanto o projeto evolui em direção a um futuro compromisso de estabilidade `1.0.0`.
|
|
167
166
|
|
package/docs/README.ru.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) | [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)
|
|
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
|
|
|
@@ -75,17 +75,17 @@ import 'agent-robot-avatar';
|
|
|
75
75
|
const avatar = document.querySelector('#avatar');
|
|
76
76
|
|
|
77
77
|
avatar.play('success');
|
|
78
|
-
avatar.play('
|
|
79
|
-
avatar.play('
|
|
78
|
+
avatar.play('wary');
|
|
79
|
+
avatar.play('refuse');
|
|
80
80
|
|
|
81
81
|
avatar.reset();
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
Доступные действия:
|
|
85
85
|
|
|
86
|
-
`idle` · `bored` · `waiting` · `waiting-wrap` · `input` · `
|
|
86
|
+
`idle` · `bored` · `waiting-spin` · `waiting-wrap` · `waiting-wave` · `input` · `affirm` · `success` · `failure` · `wary` · `inspect` · `angry` · `refuse` · `surprise` · `love` · `random` · `sleep` · `wake`
|
|
87
87
|
|
|
88
|
-
`
|
|
88
|
+
Названия действий описывают, что делает аватар. `refuse` качает головой — для запроса, который Agent не может или не будет выполнять; `failure` — для задачи или соединения, которые не удались; `wary` поворачивает голову и настороженно оглядывает сверху вниз — для действия, требующего подтверждения. Названия из 0.5 (`send`, `warning`, `error`, `blocked` и другие) работают до 1.0 с уведомлением в консоли; см. [таблицу обновления](../CHANGELOG.md#upgrading-from-05x).
|
|
89
89
|
|
|
90
90
|
`love` выражает симпатию или благодарность: два глаза наклоняются друг к другу и образуют одно сердце, трижды бьются и возвращаются в исходное состояние.
|
|
91
91
|
|
|
@@ -103,7 +103,7 @@ try {
|
|
|
103
103
|
const result = await runAgentRequest();
|
|
104
104
|
await avatar.play(result.ok ? 'success' : 'failure');
|
|
105
105
|
} catch (error) {
|
|
106
|
-
await avatar.play('
|
|
106
|
+
await avatar.play('failure');
|
|
107
107
|
}
|
|
108
108
|
```
|
|
109
109
|
|
|
@@ -134,7 +134,6 @@ try {
|
|
|
134
134
|
```js
|
|
135
135
|
avatar.setPointerFollow(false);
|
|
136
136
|
avatar.setHeadRoundness(75);
|
|
137
|
-
avatar.setAntennaFlash(true);
|
|
138
137
|
avatar.setPressSqueeze(true);
|
|
139
138
|
avatar.setAntennaDrag(true);
|
|
140
139
|
```
|
|
@@ -161,7 +160,7 @@ Issues и Pull Requests приветствуются. Перед отправк
|
|
|
161
160
|
|
|
162
161
|
## Статус проекта
|
|
163
162
|
|
|
164
|
-
**Текущая публичная версия: v0.
|
|
163
|
+
**Текущая публичная версия: v0.6.0**
|
|
165
164
|
|
|
166
165
|
Публичный API намеренно остаётся компактным, пока проект развивается к будущему обязательству стабильности `1.0.0`.
|
|
167
166
|
|