@aliens-syndicate/cli 0.1.7 → 0.1.9

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/README.es-ES.md CHANGED
@@ -34,6 +34,26 @@ aliens run
34
34
 
35
35
  El comentario al inicio de `.config` lista los mismos comandos, y la página **Instalación** del sitio (`#installation`) los explica paso a paso.
36
36
 
37
+ `.config` enumera el framework y cada paquete con su versión, agrupados como en `package.json`: `dependencies:` para lo que usa la app y `devDependencies:` para lo que solo usa el build. Cada sección tiene una línea, `<paquete>: <versión>`; la línea de los iconos añade el estilo predeterminado después del nombre.
38
+
39
+ ```text
40
+ dependencies:
41
+ framework:
42
+ @aliens-syndicate/framework: 0.0.0
43
+ icons:
44
+ @aliens-syndicate/icons/stroke-rounded: 0.1.0
45
+ elements:
46
+ @aliens-syndicate/elements: 0.1.0
47
+ reactive:
48
+ @aliens-syndicate/reactive: 0.1.0
49
+
50
+ devDependencies:
51
+ utilities:
52
+ @aliens-syndicate/utilities: 0.1.0
53
+ ```
54
+
55
+ El build se detiene cuando una versión difiere de la instalada y explica cómo corregirlo. `aliens update` instala las versiones más nuevas, las escribe en `package.json` y en `.config` y reescribe la forma antigua con `from:`, y `aliens doctor` señala cada diferencia.
56
+
37
57
  Para publicar una nueva versión, actualiza `version` en `package.json` y ejecuta `npm publish` en la raíz, con la cuenta `aliens-syndicate` conectada en npm.
38
58
 
39
59
  El generador crea la Home en `project/app/pages/home/`, los cuatro niveles de Elements y las carpetas de los tipos de archivo de la aplicación. Los ejemplos comentados del catálogo de héroes vienen de la base del motor en `tools/starter/`, independientemente de la aplicación que tengas abierta. El Element `hero-card` reúne `.markup`, `.logic`, `.style` y `.test` en `project/app/elements/molecules/hero-card/`. Las carpetas `agents/`, `rules/` y `skills/` están en `ai/`.
@@ -127,11 +147,11 @@ Style Counter
127
147
  bg-(--primary) text-(--primary-ink)
128
148
  ```
129
149
 
130
- Dentro de un selector, una línea escrita como `propiedad: valor` es una declaración CSS. Por defecto, `.style` acepta solo CSS normal. Las utilidades son opcionales y viven en su propio paquete: instala `@aliens-syndicate/utilities` y decláralo en `.config` bajo `utilities:` con `from: @aliens-syndicate/utilities`. Sin él, una línea de utilidades detiene el build y explica cómo añadir el paquete. Con él, cualquier otra línea enumera utilidades con los nombres popularizados por frameworks de CSS existentes: `flex`, `gap-4`, `rounded-lg`, `text-sm`. Variantes como `md:`, `max-lg:`, `hover:` y `dark:` escriben la regla `@media` o el selector, y utilidades como `backdrop-blur-md` y `bg-clip-text` añaden las declaraciones `-webkit-`. Los corchetes aceptan cualquier valor, como en `w-[1240px]`, y los paréntesis leen una propiedad personalizada, como en `text-(--muted)`. Cada `--color-<nombre>` de los estilos globales se convierte en un color, como en `bg-brand`. Una utilidad desconocida detiene el build con el archivo y la línea. La página **Styles** del sitio de documentación (`#style-docs`) enumera cada clase con su CSS; `node tools/style-docs.mjs` la vuelve a generar a partir del catálogo del paquete.
150
+ Dentro de un selector, una línea escrita como `propiedad: valor` es una declaración CSS. Por defecto, `.style` acepta solo CSS normal. Las utilidades son opcionales y viven en su propio paquete: instala `@aliens-syndicate/utilities` y decláralo en `.config` bajo `devDependencies:` → `utilities:` como `@aliens-syndicate/utilities: <versión>`. Sin él, una línea de utilidades detiene el build y explica cómo añadir el paquete. Con él, cualquier otra línea enumera utilidades con los nombres popularizados por frameworks de CSS existentes: `flex`, `gap-4`, `rounded-lg`, `text-sm`. Variantes como `md:`, `max-lg:`, `hover:` y `dark:` escriben la regla `@media` o el selector, y utilidades como `backdrop-blur-md` y `bg-clip-text` añaden las declaraciones `-webkit-`. Los corchetes aceptan cualquier valor, como en `w-[1240px]`, y los paréntesis leen una propiedad personalizada, como en `text-(--muted)`. Cada `--color-<nombre>` de los estilos globales se convierte en un color, como en `bg-brand`. Una utilidad desconocida detiene el build con el archivo y la línea. La página **Utilities** del sitio de documentación (`#utilities-docs`) enumera cada clase con su CSS; `node tools/utilities-docs.mjs` la vuelve a generar a partir del catálogo del paquete.
131
151
 
132
- Los iconos son opcionales y viven en su propio paquete. Instala `@aliens-syndicate/icons` y declaralo en `.config` en `icons:` con `from: @aliens-syndicate/icons` y un `style:` predeterminado. Los iconos pertenecen al markup, sin span y sin clase: `icon add-01 size-4 blue-500 red-500` nombra el icono y después, en cualquier orden, uno de los diez estilos, un tamaño, hasta dos colores (el segundo pinta el tono claro de bulk, duotone y twotone) y un estado como `disabled` o `hidden`; `id`, `variant` y `label` son sus únicos atributos. El build dibuja cada icono inline, y un proyecto sin el paquete se genera igual. La página **Icons** (`#icon-docs`) lista los 6070 iconos por categoría y copia la etiqueta de cualquiera; `node tools/icon-docs.mjs` la regenera a partir del paquete.
152
+ Los iconos son opcionales y viven en su propio paquete. Instala `@aliens-syndicate/icons` y decláralo en `.config` en `dependencies:` → `icons:` como `@aliens-syndicate/icons/stroke-rounded: <versión>`, donde la parte después del nombre es el estilo predeterminado. Los iconos pertenecen al markup, sin span y sin clase: `icon add-01 size-4 blue-500 red-500` nombra el icono y después, en cualquier orden, uno de los diez estilos, un tamaño, hasta dos colores (el segundo pinta el tono claro de bulk, duotone y twotone) y un estado como `disabled` o `hidden`; `id`, `variant` y `label` son sus únicos atributos. El build dibuja cada icono inline, y un proyecto sin el paquete se genera igual. La página **Icons** (`#icon-docs`) lista los 6070 iconos por categoría y copia la etiqueta de cualquiera; `node tools/icon-docs.mjs` la regenera a partir del paquete.
133
153
 
134
- Los Elements listos también son opcionales y viven en `@aliens-syndicate/elements`; un proyecto nuevo empieza sin ellos. Instala el paquete y decláralo en `.config` bajo `elements:` con `from: @aliens-syndicate/elements`, y cualquier markup puede escribir `ui-button`, `ui-icon-button`, `ui-badge`, `ui-alert`, `ui-card`, `ui-avatar`, `ui-spinner`, `ui-progress`, `ui-stat`, `ui-accordion`, `ui-empty-state`, `ui-divider`, `ui-text-field`, `ui-checkbox` y `ui-switch` con sus propiedades, como en `ui-button label="Guardar" variant="ui-button_primary" action="save"`. Son archivos Space como los Elements del proyecto: el build los valida, `ai/.map` los lista y solo los Elements que la página renderiza llegan a `dist/`. Sus estilos son CSS puro que lee los tokens del starter, y un `.style` del proyecto con los mismos nombres de variant los sobrescribe. La página **Elements** (`#element-docs`) muestra cada uno en vivo, con sus propiedades y su código.
154
+ Los Elements listos también son opcionales y viven en `@aliens-syndicate/elements`; un proyecto nuevo empieza sin ellos. Instala el paquete y decláralo en `.config` bajo `dependencies:` → `elements:` como `@aliens-syndicate/elements: <versión>`, y cualquier markup puede escribir `ui-button`, `ui-icon-button`, `ui-badge`, `ui-alert`, `ui-card`, `ui-avatar`, `ui-spinner`, `ui-progress`, `ui-stat`, `ui-accordion`, `ui-empty-state`, `ui-divider`, `ui-text-field`, `ui-checkbox` y `ui-switch` con sus propiedades, como en `ui-button label="Guardar" variant="ui-button_primary" action="save"`. Son archivos Space como los Elements del proyecto: el build los valida, `ai/.map` los lista y solo los Elements que la página renderiza llegan a `dist/`. Sus estilos son CSS puro que lee los tokens del starter, y un `.style` del proyecto con los mismos nombres de variant los sobrescribe. La página **Elements** (`#element-docs`) muestra cada uno en vivo, con sus propiedades y su código.
135
155
 
136
156
  #### Logic
137
157
 
@@ -164,6 +184,29 @@ Logic SiteHeader
164
184
 
165
185
  Un `id` con el formato `<element>-<signal>` no necesita `bind:` para el texto: `counter-value` muestra `value` en Counter. En el cuerpo de una acción, `element("counter-title")` devuelve la etiqueta. `bind:` alcanza las etiquetas del propio Element y las de Elements hijos sin `.logic`. Los atributos `data-show`, `data-pressed`, `data-expanded`, `data-state`, `data-bind`, `data-theme-control` y `data-language` no se aceptan en el markup. Los signals y las actions son identificadores JavaScript y siguen en camelCase, como `menuOpen` y `toggleMenu`.
166
186
 
187
+ El Reactive Core viene con Aliens, sin paquete que instalar, y mantiene los nombres y el comportamiento de otros frameworks. `signal` es estado escribible, como `signal()` en Angular, Solid y Preact o `ref()` en Vue. `computed` deriva un valor de solo lectura y solo lo recalcula cuando cambia lo que lee, como `computed()` en Vue, Angular y Preact o `createMemo()` en Solid. `effect` se ejecuta ahora y cada vez que cambia un valor que leyó, como `effect()` en Angular y Preact, `watchEffect()` en Vue o `createEffect()` en Solid. `watch` se ejecuta cuando un valor cambia y recibe el anterior en `previous`, como `watch()` en Vue. `cleanup:` se ejecuta antes de la siguiente ejecución, como `onCleanup()` en Solid o la función que devuelve `useEffect` en React. `batch(() => …)` agrupa escrituras en una sola actualización, como `batch()` en Solid y Preact; cada action ya se ejecuta en una.
188
+
189
+ ```text
190
+ Logic Counter
191
+ signal value: number = 0
192
+
193
+ computed doubled: number = this.value * 2
194
+
195
+ watch value:
196
+ body:
197
+ if (this.value > 10) this.value = 10
198
+
199
+ effect save:
200
+ body:
201
+ this.timer = setTimeout(() => localStorage.setItem("counter", String(this.value)), 300)
202
+ cleanup:
203
+ clearTimeout(this.timer)
204
+ ```
205
+
206
+ Solo se actualizan los binds que leen un valor, y se ejecutan antes que los effects y watches. Las escrituras fuera de una action, como en un `setTimeout` o después de un `fetch`, también actualizan la página. Un `computed` funciona en `bind:` y en el id `<element>-<nombre>` como un signal: `counter-doubled` muestra `doubled`. Asignar a un `computed` detiene el build, igual que un `watch` que no nombra ningún signal ni computed. Un effect que no deja de cambiar lo que lee se detiene en tiempo de ejecución con su nombre. Estas palabras son del lenguaje, así que `import: signal: aliens/core` es opcional.
207
+
208
+ El Reactive Core de arriba viene en todo proyecto. Los operadores de stream están en el paquete opcional `@aliens-syndicate/reactive`: ejecuta `npm install @aliens-syndicate/reactive`, decláralo en `.config` bajo `dependencies:` → `reactive:` como `@aliens-syndicate/reactive: <versión>`, y un `.logic` puede declarar `stream nombre: tipo = expresión` con 22 operadores con los nombres de RxJS, como `debounce`, `switchMap`, `combineLatest` y `retry`. Sin el paquete, un miembro `stream` detiene el build e indica cómo añadirlo. La página **Reactive** del sitio de documentación (`#reactive-core`) separa ambas partes y ejecuta una búsqueda en vivo con `debounce`.
209
+
167
210
  Las etiquetas nativas aceptan las mismas propiedades cortas que los Elements: `variant` se convierte en `class`, `action` en `data-action`, `label` en `aria-label` y `text` en el texto de la etiqueta. `button` recibe `type="button"` cuando no declara `type`.
168
211
 
169
212
  #### Listas y for
@@ -250,7 +293,7 @@ Para probar por HTTP, ejecuta `python3 -m http.server 4173 --bind 127.0.0.1 --di
250
293
 
251
294
  - La herramienta de `aliens-exemplo` solo demostraba la compilación de hojas de estilo. La vista previa de `tools/` se creó para renderizar la composición de Elements, aplicar traducciones, ejecutar las acciones del contador y alternar paneles. El código de la interfaz permanece en los archivos de cada Element.
252
295
  - El markup llama a las acciones con `action` y el `.logic` vincula los signals a las etiquetas por `id`, en el bloque `bind:`. Estas convenciones, la sintaxis de propiedades de Elements y el formato de las traducciones necesitan validación antes de formar parte de la gramática definitiva.
253
- - El compilador de vista previa cubre los signals primitivos y las acciones sin parámetros que usa la documentación. Elimina las anotaciones TypeScript, sin comprobación semántica de tipos. El ciclo de vida, las dependencias reales entre módulos, los servicios y la ejecución de archivos `.test` quedan pendientes. La navegación de la página usa fragmentos de URL. El archivo `app.route` registra la ruta inicial y aún necesita un enrutador para ejecutarla.
296
+ - El compilador de vista previa cubre los signals primitivos, `computed`, `effect`, `watch` y las acciones sin parámetros que usa la documentación. Elimina las anotaciones TypeScript, sin comprobación semántica de tipos. El ciclo de vida, las dependencias reales entre módulos, los servicios y la ejecución de archivos `.test` quedan pendientes. La navegación de la página usa fragmentos de URL. El archivo `app.route` registra la ruta inicial y aún necesita un enrutador para ejecutarla.
254
297
  - El índice sigue el catálogo de 25 tipos. `.style` y `.mock` son las extensiones definidas para hojas de estilo y datos simulados, respectivamente.
255
298
  - Las pestañas del playground reutilizan el código que compila la página. La simulación es interactiva y los archivos son de solo lectura en el navegador. La edición en el playground queda para cuando exista una forma aislada de compilar y ejecutar el código escrito.
256
299
 
package/README.md CHANGED
@@ -34,6 +34,26 @@ aliens run
34
34
 
35
35
  The comment at the top of `.config` lists the same commands, and the **Installation** page of the site (`#installation`) walks through them step by step.
36
36
 
37
+ `.config` lists the framework and every package with its version, grouped as in `package.json`: `dependencies:` for what the app uses and `devDependencies:` for what only the build uses. Each section holds one line, `<package>: <version>`; the icons line adds the default style after the name.
38
+
39
+ ```text
40
+ dependencies:
41
+ framework:
42
+ @aliens-syndicate/framework: 0.0.0
43
+ icons:
44
+ @aliens-syndicate/icons/stroke-rounded: 0.1.0
45
+ elements:
46
+ @aliens-syndicate/elements: 0.1.0
47
+ reactive:
48
+ @aliens-syndicate/reactive: 0.1.0
49
+
50
+ devDependencies:
51
+ utilities:
52
+ @aliens-syndicate/utilities: 0.1.0
53
+ ```
54
+
55
+ The build stops when a version differs from the installed one and says how to fix it. `aliens update` installs the newest versions, writes them in `package.json` and `.config` and rewrites the older `from:` form, and `aliens doctor` points out every difference.
56
+
37
57
  To publish a new version, update `version` in `package.json` and run `npm publish` at the root, with the `aliens-syndicate` account logged in to npm.
38
58
 
39
59
  The generator creates the Home in `project/app/pages/home/`, the four Element levels and the folders for the application file types. The commented examples of the hero catalog come from the engine base in `tools/starter/`, regardless of the application you have open. The `hero-card` Element brings together `.markup`, `.logic`, `.style` and `.test` in `project/app/elements/molecules/hero-card/`. The `agents/`, `rules/` and `skills/` folders live in `ai/`.
@@ -127,11 +147,11 @@ Style Counter
127
147
  bg-(--primary) text-(--primary-ink)
128
148
  ```
129
149
 
130
- Inside a selector, a line written as `property: value` is a CSS declaration. By default `.style` reads plain CSS only. Utilities are optional and live in their own package: install `@aliens-syndicate/utilities` and declare it in `.config` under `utilities:` with `from: @aliens-syndicate/utilities`. Without it, a utility line stops the build and says how to add the package. With it, any other line lists utilities with the names popularized by existing CSS frameworks: `flex`, `gap-4`, `rounded-lg`, `text-sm`. Variants such as `md:`, `max-lg:`, `hover:` and `dark:` write the `@media` rule or the selector, and utilities such as `backdrop-blur-md` and `bg-clip-text` add the `-webkit-` declarations. Brackets take any value, as in `w-[1240px]`, and parentheses read a custom property, as in `text-(--muted)`. Each `--color-<name>` in the global styles becomes a color, as in `bg-brand`. An unknown utility stops the build with the file and the line. The **Styles** page of the documentation site (`#style-docs`) lists every class with its CSS; `node tools/style-docs.mjs` regenerates it from the package's catalog.
150
+ Inside a selector, a line written as `property: value` is a CSS declaration. By default `.style` reads plain CSS only. Utilities are optional and live in their own package: install `@aliens-syndicate/utilities` and declare it in `.config` under `devDependencies:` → `utilities:` as `@aliens-syndicate/utilities: <version>`. Without it, a utility line stops the build and says how to add the package. With it, any other line lists utilities with the names popularized by existing CSS frameworks: `flex`, `gap-4`, `rounded-lg`, `text-sm`. Variants such as `md:`, `max-lg:`, `hover:` and `dark:` write the `@media` rule or the selector, and utilities such as `backdrop-blur-md` and `bg-clip-text` add the `-webkit-` declarations. Brackets take any value, as in `w-[1240px]`, and parentheses read a custom property, as in `text-(--muted)`. Each `--color-<name>` in the global styles becomes a color, as in `bg-brand`. An unknown utility stops the build with the file and the line. The **Utilities** page of the documentation site (`#utilities-docs`) lists every class with its CSS; `node tools/utilities-docs.mjs` regenerates it from the package's catalog.
131
151
 
132
- Icons are optional and live in their own package. Install `@aliens-syndicate/icons` and declare it in `.config` under `icons:` with `from: @aliens-syndicate/icons` and a default `style:`. Icons belong to the markup, with no span and no class: `icon add-01 size-4 blue-500 red-500` names the icon and then, in any order, one of the ten styles, a size, up to two colors (the second paints the light tone of bulk, duotone and twotone) and a state such as `disabled` or `hidden`; `id`, `variant` and `label` are its only attributes. The build draws each icon inline, and a project without the package builds the same way. The **Icons** page (`#icon-docs`) lists all 6,070 icons by category and copies the tag of any of them; `node tools/icon-docs.mjs` regenerates it from the package.
152
+ Icons are optional and live in their own package. Install `@aliens-syndicate/icons` and declare it in `.config` under `dependencies:` → `icons:` as `@aliens-syndicate/icons/stroke-rounded: <version>`, where the part after the name is the default style. Icons belong to the markup, with no span and no class: `icon add-01 size-4 blue-500 red-500` names the icon and then, in any order, one of the ten styles, a size, up to two colors (the second paints the light tone of bulk, duotone and twotone) and a state such as `disabled` or `hidden`; `id`, `variant` and `label` are its only attributes. The build draws each icon inline, and a project without the package builds the same way. The **Icons** page (`#icon-docs`) lists all 6,070 icons by category and copies the tag of any of them; `node tools/icon-docs.mjs` regenerates it from the package.
133
153
 
134
- Ready-made Elements are optional too and live in `@aliens-syndicate/elements`; a new project starts without them. Install the package and declare it in `.config` under `elements:` with `from: @aliens-syndicate/elements`, and any markup can write `ui-button`, `ui-icon-button`, `ui-badge`, `ui-alert`, `ui-card`, `ui-avatar`, `ui-spinner`, `ui-progress`, `ui-stat`, `ui-accordion`, `ui-empty-state`, `ui-divider`, `ui-text-field`, `ui-checkbox` and `ui-switch` with their properties, as in `ui-button label="Save" variant="ui-button_primary" action="save"`. They are Space files like the Elements of the project: the build validates them, `ai/.map` lists them, and only the Elements a page renders reach `dist/`. Their styles are plain CSS that read the starter tokens, and a project `.style` with the same variant names overrides them. The **Elements** page (`#element-docs`) shows each one live, with its properties and source.
154
+ Ready-made Elements are optional too and live in `@aliens-syndicate/elements`; a new project starts without them. Install the package and declare it in `.config` under `dependencies:` → `elements:` as `@aliens-syndicate/elements: <version>`, and any markup can write `ui-button`, `ui-icon-button`, `ui-badge`, `ui-alert`, `ui-card`, `ui-avatar`, `ui-spinner`, `ui-progress`, `ui-stat`, `ui-accordion`, `ui-empty-state`, `ui-divider`, `ui-text-field`, `ui-checkbox` and `ui-switch` with their properties, as in `ui-button label="Save" variant="ui-button_primary" action="save"`. They are Space files like the Elements of the project: the build validates them, `ai/.map` lists them, and only the Elements a page renders reach `dist/`. Their styles are plain CSS that read the starter tokens, and a project `.style` with the same variant names overrides them. The **Elements** page (`#element-docs`) shows each one live, with its properties and source.
135
155
 
136
156
  #### Logic
137
157
 
@@ -164,6 +184,29 @@ Logic SiteHeader
164
184
 
165
185
  An `id` in the `<element>-<signal>` format needs no `bind:` for text: `counter-value` shows `value` in Counter. In an action body, `element("counter-title")` returns the tag. `bind:` reaches the tags of the Element itself and those of child Elements without `.logic`. The attributes `data-show`, `data-pressed`, `data-expanded`, `data-state`, `data-bind`, `data-theme-control` and `data-language` are not accepted in markup. Signals and actions are JavaScript identifiers and stay in camelCase, such as `menuOpen` and `toggleMenu`.
166
186
 
187
+ The Reactive Core comes with Aliens, with no package to install, and keeps the names and behavior of other frameworks. `signal` is writable state, like `signal()` in Angular, Solid and Preact or `ref()` in Vue. `computed` derives a read-only value and recalculates it only when what it reads changes, like `computed()` in Vue, Angular and Preact or `createMemo()` in Solid. `effect` runs now and again whenever a value it read changes, like `effect()` in Angular and Preact, `watchEffect()` in Vue or `createEffect()` in Solid. `watch` runs when one value changes and receives the old one as `previous`, like `watch()` in Vue. `cleanup:` runs before the next run, like `onCleanup()` in Solid or the function `useEffect` returns in React. `batch(() => …)` groups writes into one update, like `batch()` in Solid and Preact; every action already runs in one.
188
+
189
+ ```text
190
+ Logic Counter
191
+ signal value: number = 0
192
+
193
+ computed doubled: number = this.value * 2
194
+
195
+ watch value:
196
+ body:
197
+ if (this.value > 10) this.value = 10
198
+
199
+ effect save:
200
+ body:
201
+ this.timer = setTimeout(() => localStorage.setItem("counter", String(this.value)), 300)
202
+ cleanup:
203
+ clearTimeout(this.timer)
204
+ ```
205
+
206
+ Only the binds that read a value update, and they run before effects and watches. Writes outside an action, as in a `setTimeout` or after a `fetch`, update the page too. A `computed` works in `bind:` and in the `<element>-<name>` id like a signal: `counter-doubled` shows `doubled`. Assigning to a `computed` stops the build, and so does a `watch` that names no signal or computed. An effect that keeps changing what it reads stops at runtime with its name. These words belong to the language, so `import: signal: aliens/core` is optional.
207
+
208
+ The Reactive Core above comes with every project. Stream operators live in the optional `@aliens-syndicate/reactive` package: run `npm install @aliens-syndicate/reactive`, declare it in `.config` under `dependencies:` → `reactive:` as `@aliens-syndicate/reactive: <version>`, and a `.logic` can declare `stream name: type = expression` with 22 operators named after RxJS, like `debounce`, `switchMap`, `combineLatest` and `retry`. Without the package, a `stream` member stops the build and says how to add it. The **Reactive** page of the documentation site (`#reactive-core`) separates both parts and runs a live search with `debounce`.
209
+
167
210
  Native tags accept the same short properties as Elements: `variant` becomes `class`, `action` becomes `data-action`, `label` becomes `aria-label` and `text` becomes the tag text. `button` gets `type="button"` when it declares no `type`.
168
211
 
169
212
  #### Lists and for
@@ -250,7 +293,7 @@ To test over HTTP, run `python3 -m http.server 4173 --bind 127.0.0.1 --directory
250
293
 
251
294
  - The `aliens-exemplo` tool only demonstrated stylesheet compilation. The preview in `tools/` was created to render Element composition, apply translations, run the counter actions and switch panels. The interface code stays in each Element's files.
252
295
  - Markup calls actions with `action` and `.logic` binds signals to tags by `id`, in the `bind:` block. These conventions, the Element property syntax and the translation format need validation before they become part of the final grammar.
253
- - The preview compiler covers primitive signals and the parameterless actions used by the documentation. It strips TypeScript annotations without semantic type checking. Lifecycle, real dependencies between modules, services and running `.test` files are pending. Page navigation uses URL fragments. The `app.route` file registers the initial route and still needs a router to run it.
296
+ - The preview compiler covers primitive signals, `computed`, `effect`, `watch` and the parameterless actions used by the documentation. It strips TypeScript annotations without semantic type checking. Lifecycle, real dependencies between modules, services and running `.test` files are pending. Page navigation uses URL fragments. The `app.route` file registers the initial route and still needs a router to run it.
254
297
  - The index follows the catalog of 25 types. `.style` and `.mock` are the extensions defined for stylesheets and mock data, respectively.
255
298
  - The playground tabs reuse the code the page compiles. The simulation is interactive and the files are read-only in the browser. Editing in the playground waits for an isolated way to compile and run typed code.
256
299
 
package/README.pt-BR.md CHANGED
@@ -34,6 +34,26 @@ aliens run
34
34
 
35
35
  O comentário no topo do `.config` lista os mesmos comandos, e a página **Instalação** do site (`#installation`) explica cada um passo a passo.
36
36
 
37
+ O `.config` lista o framework e cada pacote com a sua versão, agrupados como no `package.json`: `dependencies:` para o que o app usa e `devDependencies:` para o que só o build usa. Cada seção tem uma linha, `<pacote>: <versão>`; a linha dos ícones traz o estilo padrão depois do nome.
38
+
39
+ ```text
40
+ dependencies:
41
+ framework:
42
+ @aliens-syndicate/framework: 0.0.0
43
+ icons:
44
+ @aliens-syndicate/icons/stroke-rounded: 0.1.0
45
+ elements:
46
+ @aliens-syndicate/elements: 0.1.0
47
+ reactive:
48
+ @aliens-syndicate/reactive: 0.1.0
49
+
50
+ devDependencies:
51
+ utilities:
52
+ @aliens-syndicate/utilities: 0.1.0
53
+ ```
54
+
55
+ O build para quando uma versão difere da instalada e diz como corrigir. O `aliens update` instala as versões mais novas, grava as versões no `package.json` e no `.config` e reescreve a forma antiga com `from:`, e o `aliens doctor` aponta cada diferença.
56
+
37
57
  Para publicar uma nova versão, atualize `version` em `package.json` e execute `npm publish` na raiz, com a conta `aliens-syndicate` logada no npm.
38
58
 
39
59
  O gerador cria a Home em `project/app/pages/home/`, os quatro níveis de Elements e as pastas dos tipos de arquivo da aplicação. Os exemplos comentados do catálogo de heróis vêm da base do motor em `tools/starter/`, independente da aplicação que estiver aberta. O Element `hero-card` reúne `.markup`, `.logic`, `.style` e `.test` em `project/app/elements/molecules/hero-card/`. As pastas `agents/`, `rules/` e `skills/` ficam em `ai/`.
@@ -127,11 +147,11 @@ Style Counter
127
147
  bg-(--primary) text-(--primary-ink)
128
148
  ```
129
149
 
130
- Dentro de um seletor, uma linha escrita como `propriedade: valor` é uma declaração CSS. Por padrão, `.style` aceita apenas CSS normal. Os utilitários são opcionais e ficam num pacote próprio: instale `@aliens-syndicate/utilities` e declare-o no `.config` em `utilities:` com `from: @aliens-syndicate/utilities`. Sem ele, uma linha de utilitários interrompe o build e diz como adicionar o pacote. Com ele, qualquer outra linha lista utilitários com os nomes popularizados por frameworks de CSS existentes: `flex`, `gap-4`, `rounded-lg`, `text-sm`. Variantes como `md:`, `max-lg:`, `hover:` e `dark:` escrevem a regra `@media` ou o seletor, e utilitários como `backdrop-blur-md` e `bg-clip-text` acrescentam as declarações `-webkit-`. Colchetes aceitam qualquer valor, como em `w-[1240px]`, e parênteses leem uma propriedade customizada, como em `text-(--muted)`. Cada `--color-<nome>` dos estilos globais vira uma cor, como em `bg-brand`. Um utilitário desconhecido interrompe o build com o arquivo e a linha. A página **Styles** do site de documentação (`#style-docs`) lista cada classe com o seu CSS; `node tools/style-docs.mjs` a gera de novo a partir do catálogo do pacote.
150
+ Dentro de um seletor, uma linha escrita como `propriedade: valor` é uma declaração CSS. Por padrão, `.style` aceita apenas CSS normal. Os utilitários são opcionais e ficam num pacote próprio: instale `@aliens-syndicate/utilities` e declare-o no `.config` em `devDependencies:` → `utilities:` como `@aliens-syndicate/utilities: <versão>`. Sem ele, uma linha de utilitários interrompe o build e diz como adicionar o pacote. Com ele, qualquer outra linha lista utilitários com os nomes popularizados por frameworks de CSS existentes: `flex`, `gap-4`, `rounded-lg`, `text-sm`. Variantes como `md:`, `max-lg:`, `hover:` e `dark:` escrevem a regra `@media` ou o seletor, e utilitários como `backdrop-blur-md` e `bg-clip-text` acrescentam as declarações `-webkit-`. Colchetes aceitam qualquer valor, como em `w-[1240px]`, e parênteses leem uma propriedade customizada, como em `text-(--muted)`. Cada `--color-<nome>` dos estilos globais vira uma cor, como em `bg-brand`. Um utilitário desconhecido interrompe o build com o arquivo e a linha. A página **Utilities** do site de documentação (`#utilities-docs`) lista cada classe com o seu CSS; `node tools/utilities-docs.mjs` a gera de novo a partir do catálogo do pacote.
131
151
 
132
- Os ícones são opcionais e ficam em um pacote próprio. Instale `@aliens-syndicate/icons` e declare no `.config` em `icons:` com `from: @aliens-syndicate/icons` e um `style:` padrão. Os ícones pertencem ao markup, sem span e sem classe: `icon add-01 size-4 blue-500 red-500` dá o nome do ícone e depois, em qualquer ordem, um dos dez estilos, um tamanho, até duas cores (a segunda pinta o tom claro do bulk, duotone e twotone) e um estado como `disabled` ou `hidden`; `id`, `variant` e `label` são seus únicos atributos. O build desenha cada ícone inline, e um projeto sem o pacote é gerado do mesmo jeito. A página **Icons** (`#icon-docs`) lista os 6.070 ícones por categoria e copia a tag de qualquer um; `node tools/icon-docs.mjs` a regenera a partir do pacote.
152
+ Os ícones são opcionais e ficam em um pacote próprio. Instale `@aliens-syndicate/icons` e declare no `.config` em `dependencies:` → `icons:` como `@aliens-syndicate/icons/stroke-rounded: <versão>`, em que a parte depois do nome é o estilo padrão. Os ícones pertencem ao markup, sem span e sem classe: `icon add-01 size-4 blue-500 red-500` dá o nome do ícone e depois, em qualquer ordem, um dos dez estilos, um tamanho, até duas cores (a segunda pinta o tom claro do bulk, duotone e twotone) e um estado como `disabled` ou `hidden`; `id`, `variant` e `label` são seus únicos atributos. O build desenha cada ícone inline, e um projeto sem o pacote é gerado do mesmo jeito. A página **Icons** (`#icon-docs`) lista os 6.070 ícones por categoria e copia a tag de qualquer um; `node tools/icon-docs.mjs` a regenera a partir do pacote.
133
153
 
134
- Os Elements prontos também são opcionais e ficam em `@aliens-syndicate/elements`; um projeto novo começa sem eles. Instale o pacote e declare no `.config` em `elements:` com `from: @aliens-syndicate/elements`, e qualquer markup pode escrever `ui-button`, `ui-icon-button`, `ui-badge`, `ui-alert`, `ui-card`, `ui-avatar`, `ui-spinner`, `ui-progress`, `ui-stat`, `ui-accordion`, `ui-empty-state`, `ui-divider`, `ui-text-field`, `ui-checkbox` e `ui-switch` com suas propriedades, como em `ui-button label="Salvar" variant="ui-button_primary" action="save"`. Eles são arquivos Space como os Elements do projeto: o build os valida, o `ai/.map` os lista e só os Elements que a página renderiza chegam ao `dist/`. Os estilos são CSS puro que lê os tokens do starter, e um `.style` do projeto com os mesmos nomes de variant os sobrescreve. A página **Elements** (`#element-docs`) mostra cada um ao vivo, com propriedades e código.
154
+ Os Elements prontos também são opcionais e ficam em `@aliens-syndicate/elements`; um projeto novo começa sem eles. Instale o pacote e declare no `.config` em `dependencies:` → `elements:` como `@aliens-syndicate/elements: <versão>`, e qualquer markup pode escrever `ui-button`, `ui-icon-button`, `ui-badge`, `ui-alert`, `ui-card`, `ui-avatar`, `ui-spinner`, `ui-progress`, `ui-stat`, `ui-accordion`, `ui-empty-state`, `ui-divider`, `ui-text-field`, `ui-checkbox` e `ui-switch` com suas propriedades, como em `ui-button label="Salvar" variant="ui-button_primary" action="save"`. Eles são arquivos Space como os Elements do projeto: o build os valida, o `ai/.map` os lista e só os Elements que a página renderiza chegam ao `dist/`. Os estilos são CSS puro que lê os tokens do starter, e um `.style` do projeto com os mesmos nomes de variant os sobrescreve. A página **Elements** (`#element-docs`) mostra cada um ao vivo, com propriedades e código.
135
155
 
136
156
  #### Logic
137
157
 
@@ -164,6 +184,29 @@ Logic SiteHeader
164
184
 
165
185
  Um `id` no formato `<element>-<signal>` dispensa o `bind:` para texto: `counter-value` exibe `value` em Counter. No corpo de uma ação, `element("counter-title")` devolve a tag. O `bind:` alcança as tags do próprio Element e as de Elements filhos sem `.logic`. Os atributos `data-show`, `data-pressed`, `data-expanded`, `data-state`, `data-bind`, `data-theme-control` e `data-language` não são aceitos no markup. Signals e actions são identificadores JavaScript e continuam em camelCase, como `menuOpen` e `toggleMenu`.
166
186
 
187
+ O Reactive Core vem com o Aliens, sem pacote para instalar, e mantém os nomes e o comportamento de outros frameworks. `signal` é estado gravável, como `signal()` no Angular, Solid e Preact ou `ref()` no Vue. `computed` deriva um valor somente leitura e só o recalcula quando o que ele lê muda, como `computed()` no Vue, Angular e Preact ou `createMemo()` no Solid. `effect` roda agora e de novo sempre que um valor que leu muda, como `effect()` no Angular e Preact, `watchEffect()` no Vue ou `createEffect()` no Solid. `watch` roda quando um valor muda e recebe o anterior em `previous`, como `watch()` no Vue. `cleanup:` roda antes da próxima execução, como `onCleanup()` no Solid ou a função que o `useEffect` devolve no React. `batch(() => …)` agrupa escritas numa única atualização, como `batch()` no Solid e Preact; toda action já roda em uma.
188
+
189
+ ```text
190
+ Logic Counter
191
+ signal value: number = 0
192
+
193
+ computed doubled: number = this.value * 2
194
+
195
+ watch value:
196
+ body:
197
+ if (this.value > 10) this.value = 10
198
+
199
+ effect save:
200
+ body:
201
+ this.timer = setTimeout(() => localStorage.setItem("counter", String(this.value)), 300)
202
+ cleanup:
203
+ clearTimeout(this.timer)
204
+ ```
205
+
206
+ Só os binds que leem um valor são atualizados, e eles rodam antes dos effects e watches. Escritas fora de uma action, como num `setTimeout` ou depois de um `fetch`, também atualizam a página. Um `computed` funciona no `bind:` e no id `<element>-<nome>` como um signal: `counter-doubled` exibe `doubled`. Atribuir a um `computed` interrompe o build, assim como um `watch` que não nomeia signal nem computed. Um effect que não para de mudar o que lê é interrompido em tempo de execução com o seu nome. Essas palavras são da linguagem, então `import: signal: aliens/core` é opcional.
207
+
208
+ O Reactive Core acima vem em todo projeto. Os operadores de stream ficam no pacote opcional `@aliens-syndicate/reactive`: rode `npm install @aliens-syndicate/reactive`, declare no `.config` em `dependencies:` → `reactive:` como `@aliens-syndicate/reactive: <versão>`, e um `.logic` pode declarar `stream nome: tipo = expressão` com 22 operadores com os nomes do RxJS, como `debounce`, `switchMap`, `combineLatest` e `retry`. Sem o pacote, um membro `stream` interrompe o build e diz como adicioná-lo. A página **Reactive** do site de documentação (`#reactive-core`) separa as duas partes e roda uma busca ao vivo com `debounce`.
209
+
167
210
  Tags nativas aceitam as mesmas propriedades curtas dos Elements: `variant` vira `class`, `action` vira `data-action`, `label` vira `aria-label` e `text` vira o texto da tag. `button` recebe `type="button"` quando não declara `type`.
168
211
 
169
212
  #### Listas e for
@@ -250,7 +293,7 @@ Para testar via HTTP, execute `python3 -m http.server 4173 --bind 127.0.0.1 --di
250
293
 
251
294
  - A ferramenta do `aliens-exemplo` demonstrava apenas a compilação das folhas de estilo. A prévia em `tools/` foi criada para renderizar a composição de Elements, aplicar traduções, executar ações do contador e alternar os painéis. O código da interface permanece nos arquivos de cada Element.
252
295
  - O markup chama as ações com `action` e o `.logic` liga os signals às tags por `id`, no bloco `bind:`. Essas convenções, a sintaxe das propriedades de Elements e o formato das traduções precisam de validação antes de virarem parte da gramática definitiva.
253
- - O compilador de prévia cobre os sinais primitivos e as ações sem parâmetros usadas pela documentação. Ele remove anotações TypeScript, sem fazer checagem semântica de tipos. Ciclo de vida, dependências reais entre módulos, serviços e execução de arquivos `.test` ficam pendentes. A navegação da página usa fragmentos de URL. O arquivo `app.route` registra a rota inicial e ainda precisa de um roteador para executá-la.
296
+ - O compilador de prévia cobre os sinais primitivos, `computed`, `effect`, `watch` e as ações sem parâmetros usadas pela documentação. Ele remove anotações TypeScript, sem fazer checagem semântica de tipos. Ciclo de vida, dependências reais entre módulos, serviços e execução de arquivos `.test` ficam pendentes. A navegação da página usa fragmentos de URL. O arquivo `app.route` registra a rota inicial e ainda precisa de um roteador para executá-la.
254
297
  - O índice segue o catálogo de 25 tipos. `.style` e `.mock` são as extensões definidas para folhas de estilo e dados simulados, respectivamente.
255
298
  - As abas do playground reaproveitam o código que a página compila. A simulação é interativa e os arquivos são para leitura no navegador. A edição no playground fica para depois que existir uma forma isolada de compilar e executar o código digitado.
256
299
 
package/README.zh-CN.md CHANGED
@@ -34,6 +34,26 @@ aliens run
34
34
 
35
35
  `.config` 顶部的注释列出了同样的命令,网站的 **安装** 页面(`#installation`)会一步步讲解。
36
36
 
37
+ `.config` 列出框架以及每个包和它的版本,分组方式与 `package.json` 相同:`dependencies:` 放应用使用的包,`devDependencies:` 放只有构建使用的包。每个分节只有一行 `<包>: <版本>`;图标那一行在包名后面写默认样式。
38
+
39
+ ```text
40
+ dependencies:
41
+ framework:
42
+ @aliens-syndicate/framework: 0.0.0
43
+ icons:
44
+ @aliens-syndicate/icons/stroke-rounded: 0.1.0
45
+ elements:
46
+ @aliens-syndicate/elements: 0.1.0
47
+ reactive:
48
+ @aliens-syndicate/reactive: 0.1.0
49
+
50
+ devDependencies:
51
+ utilities:
52
+ @aliens-syndicate/utilities: 0.1.0
53
+ ```
54
+
55
+ 当版本与已安装的版本不一致时,构建会停止并说明如何修复。`aliens update` 会安装最新版本,把版本写入 `package.json` 和 `.config`,并改写旧的 `from:` 写法;`aliens doctor` 会指出每一处差异。
56
+
37
57
  要发布新版本,请更新 `package.json` 中的 `version`,并在已登录 `aliens-syndicate` 账号的情况下于根目录运行 `npm publish`。
38
58
 
39
59
  生成器会在 `project/app/pages/home/` 中创建首页,并创建四个 Element 层级以及应用各文件类型的文件夹。英雄目录的注释示例来自引擎基础目录 `tools/starter/`,与当前打开的应用无关。`hero-card` Element 在 `project/app/elements/molecules/hero-card/` 中包含 `.markup`、`.logic`、`.style` 和 `.test`。`agents/`、`rules/` 和 `skills/` 文件夹位于 `ai/`。
@@ -127,11 +147,11 @@ Style Counter
127
147
  bg-(--primary) text-(--primary-ink)
128
148
  ```
129
149
 
130
- 在选择器内部,写成 `属性: 值` 的行是 CSS 声明。默认情况下 `.style` 只接受普通 CSS。工具类是可选的,位于独立的包中:安装 `@aliens-syndicate/utilities`,并在 `.config` 的 `utilities:` 下声明 `from: @aliens-syndicate/utilities`。没有该包时,工具类行会让构建停止并提示如何添加它。有了该包,其他行列出现有 CSS 框架普及的工具类名称:`flex`、`gap-4`、`rounded-lg`、`text-sm`。`md:`、`max-lg:`、`hover:` 和 `dark:` 等变体会写出 `@media` 规则或选择器,`backdrop-blur-md` 和 `bg-clip-text` 等工具类会补上 `-webkit-` 声明。方括号接受任意值,例如 `w-[1240px]`;圆括号读取自定义属性,例如 `text-(--muted)`。全局样式中的每个 `--color-<名称>` 都会成为颜色,例如 `bg-brand`。未知的工具类会让构建停止,并给出文件和行号。文档站点的 **Styles** 页面(`#style-docs`)列出了每个类及其 CSS;`node tools/style-docs.mjs` 会根据该包的目录重新生成该页面。
150
+ 在选择器内部,写成 `属性: 值` 的行是 CSS 声明。默认情况下 `.style` 只接受普通 CSS。工具类是可选的,位于独立的包中:安装 `@aliens-syndicate/utilities`,并在 `.config` 的 `devDependencies:` → `utilities:` 下写 `@aliens-syndicate/utilities: <版本>`。没有该包时,工具类行会让构建停止并提示如何添加它。有了该包,其他行列出现有 CSS 框架普及的工具类名称:`flex`、`gap-4`、`rounded-lg`、`text-sm`。`md:`、`max-lg:`、`hover:` 和 `dark:` 等变体会写出 `@media` 规则或选择器,`backdrop-blur-md` 和 `bg-clip-text` 等工具类会补上 `-webkit-` 声明。方括号接受任意值,例如 `w-[1240px]`;圆括号读取自定义属性,例如 `text-(--muted)`。全局样式中的每个 `--color-<名称>` 都会成为颜色,例如 `bg-brand`。未知的工具类会让构建停止,并给出文件和行号。文档站点的 **Utilities** 页面(`#utilities-docs`)列出了每个类及其 CSS;`node tools/utilities-docs.mjs` 会根据该包的目录重新生成该页面。
131
151
 
132
- 图标是可选的,位于独立的包中。安装 `@aliens-syndicate/icons`,在 `.config` 的 `icons:` 下写 `from: @aliens-syndicate/icons` 和默认的 `style:`。图标属于 markup,不需要 span,也不需要 class:`icon add-01 size-4 blue-500 red-500` 先写图标名称,再按任意顺序写十种样式之一、尺寸、最多两种颜色(第二种用于 bulk、duotone 和 twotone 的浅色部分),以及 `disabled` 或 `hidden` 等状态;`id`、`variant` 和 `label` 是它仅有的属性。构建会把每个图标内联绘制,没有该包的项目照常构建。**Icons**页面(`#icon-docs`)按分类列出全部 6,070 个图标,并可复制任意图标的标签;`node tools/icon-docs.mjs` 会根据该包重新生成它。
152
+ 图标是可选的,位于独立的包中。安装 `@aliens-syndicate/icons`,在 `.config` 的 `dependencies:` → `icons:` 下写 `@aliens-syndicate/icons/stroke-rounded: <版本>`,包名后面的部分就是默认样式。图标属于 markup,不需要 span,也不需要 class:`icon add-01 size-4 blue-500 red-500` 先写图标名称,再按任意顺序写十种样式之一、尺寸、最多两种颜色(第二种用于 bulk、duotone 和 twotone 的浅色部分),以及 `disabled` 或 `hidden` 等状态;`id`、`variant` 和 `label` 是它仅有的属性。构建会把每个图标内联绘制,没有该包的项目照常构建。**Icons**页面(`#icon-docs`)按分类列出全部 6,070 个图标,并可复制任意图标的标签;`node tools/icon-docs.mjs` 会根据该包重新生成它。
133
153
 
134
- 现成的 Element 同样是可选的,位于 `@aliens-syndicate/elements` 包中;新项目默认不包含它们。安装该包,并在 `.config` 的 `elements:` 下写入 `from: @aliens-syndicate/elements`,任何 markup 就可以使用 `ui-button`、`ui-icon-button`、`ui-badge`、`ui-alert`、`ui-card`、`ui-avatar`、`ui-spinner`、`ui-progress`、`ui-stat`、`ui-accordion`、`ui-empty-state`、`ui-divider`、`ui-text-field`、`ui-checkbox` 和 `ui-switch` 及其属性,例如 `ui-button label="保存" variant="ui-button_primary" action="save"`。它们和项目中的 Element 一样是 Space 文件:构建会校验它们,`ai/.map` 会列出它们,只有页面实际渲染的 Element 才会进入 `dist/`。它们的样式是读取 starter 令牌的纯 CSS,项目中使用相同 variant 名称的 `.style` 可以覆盖它们。**Elements** 页面(`#element-docs`)实时展示每个 Element 及其属性和源码。
154
+ 现成的 Element 同样是可选的,位于 `@aliens-syndicate/elements` 包中;新项目默认不包含它们。安装该包,并在 `.config` 的 `dependencies:` → `elements:` 下写入 `@aliens-syndicate/elements: <版本>`,任何 markup 就可以使用 `ui-button`、`ui-icon-button`、`ui-badge`、`ui-alert`、`ui-card`、`ui-avatar`、`ui-spinner`、`ui-progress`、`ui-stat`、`ui-accordion`、`ui-empty-state`、`ui-divider`、`ui-text-field`、`ui-checkbox` 和 `ui-switch` 及其属性,例如 `ui-button label="保存" variant="ui-button_primary" action="save"`。它们和项目中的 Element 一样是 Space 文件:构建会校验它们,`ai/.map` 会列出它们,只有页面实际渲染的 Element 才会进入 `dist/`。它们的样式是读取 starter 令牌的纯 CSS,项目中使用相同 variant 名称的 `.style` 可以覆盖它们。**Elements** 页面(`#element-docs`)实时展示每个 Element 及其属性和源码。
135
155
 
136
156
  #### Logic
137
157
 
@@ -164,6 +184,29 @@ Logic SiteHeader
164
184
 
165
185
  格式为 `<element>-<signal>` 的 `id` 无需 `bind:` 即可显示文本:`counter-value` 会在 Counter 中显示 `value`。在 action 的 body 中,`element("counter-title")` 会返回该标签。`bind:` 可以作用于 Element 自身的标签,以及没有 `.logic` 的子 Element 的标签。markup 不接受 `data-show`、`data-pressed`、`data-expanded`、`data-state`、`data-bind`、`data-theme-control` 和 `data-language` 属性。signal 和 action 是 JavaScript 标识符,保持 camelCase,例如 `menuOpen` 和 `toggleMenu`。
166
186
 
187
+ Reactive Core 内置于 Aliens,无需安装额外的包,并沿用其他框架的名称与行为。`signal` 是可写状态,类似 Angular、Solid 和 Preact 中的 `signal()` 或 Vue 中的 `ref()`。`computed` 派生只读值,只在它读取的值变化时重新计算,类似 Vue、Angular 和 Preact 中的 `computed()` 或 Solid 中的 `createMemo()`。`effect` 立即运行,并在它读取的值变化时再次运行,类似 Angular 和 Preact 中的 `effect()`、Vue 中的 `watchEffect()` 或 Solid 中的 `createEffect()`。`watch` 在某个值变化时运行,并通过 `previous` 收到旧值,类似 Vue 中的 `watch()`。`cleanup:` 在下一次运行前执行,类似 Solid 中的 `onCleanup()` 或 React 中 `useEffect` 返回的函数。`batch(() => …)` 把多次写入合并为一次更新,类似 Solid 和 Preact 中的 `batch()`;每个 action 都已在其中运行。
188
+
189
+ ```text
190
+ Logic Counter
191
+ signal value: number = 0
192
+
193
+ computed doubled: number = this.value * 2
194
+
195
+ watch value:
196
+ body:
197
+ if (this.value > 10) this.value = 10
198
+
199
+ effect save:
200
+ body:
201
+ this.timer = setTimeout(() => localStorage.setItem("counter", String(this.value)), 300)
202
+ cleanup:
203
+ clearTimeout(this.timer)
204
+ ```
205
+
206
+ 只有读取该值的 bind 会更新,并且它们先于 effect 和 watch 运行。在 action 之外的写入,例如 `setTimeout` 中或 `fetch` 之后,也会更新页面。`computed` 与 signal 一样可用于 `bind:` 和 `<element>-<名称>` 形式的 id:`counter-doubled` 显示 `doubled`。给 `computed` 赋值会中止构建,`watch` 指向不存在的 signal 或 computed 时也会中止。不断修改自身所读取值的 effect 会在运行时以其名称报错并停止。这些都是语言本身的关键字,因此 `import: signal: aliens/core` 可以省略。
207
+
208
+ 上述 Reactive Core 内置于每个项目。stream 操作符位于可选包 `@aliens-syndicate/reactive`:运行 `npm install @aliens-syndicate/reactive`,在 `.config` 的 `dependencies:` → `reactive:` 下写 `@aliens-syndicate/reactive: <版本>`,`.logic` 即可声明 `stream 名称: 类型 = 表达式`,使用 22 个沿用 RxJS 名称的操作符,例如 `debounce`、`switchMap`、`combineLatest` 和 `retry`。没有该包时,`stream` 成员会中止构建并说明如何添加。文档站点的 **Reactive** 页面(`#reactive-core`)将两部分分开展示,并运行一个带 `debounce` 的实时搜索。
209
+
167
210
  原生标签接受与 Element 相同的简写属性:`variant` 变为 `class`,`action` 变为 `data-action`,`label` 变为 `aria-label`,`text` 变为标签文本。未声明 `type` 的 `button` 会获得 `type="button"`。
168
211
 
169
212
  #### 列表和 for
@@ -250,7 +293,7 @@ open -a "Google Chrome" dist/index.html
250
293
 
251
294
  - `aliens-exemplo` 工具只演示了样式表编译。`tools/` 中的预览是为渲染 Element 组合、应用翻译、运行计数器 action 和切换面板而创建的。界面代码保留在各个 Element 的文件中。
252
295
  - markup 通过 `action` 调用 action,`.logic` 在 `bind:` 块中通过 `id` 将 signal 绑定到标签。这些约定、Element 属性语法和翻译格式在成为最终语法的一部分之前还需要验证。
253
- - 预览编译器覆盖文档中使用的基本 signal 和无参数 action。它会去掉 TypeScript 注解,但不做语义类型检查。生命周期、模块之间的真实依赖、服务以及 `.test` 文件的执行仍待完成。页面导航使用 URL 片段。`app.route` 文件登记了初始路由,但仍需要路由器来执行它。
296
+ - 预览编译器覆盖文档中使用的基本 signal、`computed`、`effect`、`watch` 和无参数 action。它会去掉 TypeScript 注解,但不做语义类型检查。生命周期、模块之间的真实依赖、服务以及 `.test` 文件的执行仍待完成。页面导航使用 URL 片段。`app.route` 文件登记了初始路由,但仍需要路由器来执行它。
254
297
  - 索引遵循 25 种类型的目录。`.style` 和 `.mock` 分别是为样式表和模拟数据定义的扩展名。
255
298
  - 演练场的标签页复用页面编译的代码。模拟是可交互的,文件在浏览器中只读。演练场中的编辑功能要等到有独立的方式编译和运行输入的代码之后再实现。
256
299
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aliens-syndicate/cli",
3
- "version": "0.1.7",
3
+ "version": "0.1.9",
4
4
  "description": "CLI for Aliens, the AI-era front-end framework written in Space.",
5
5
  "license": "MIT",
6
6
  "author": "Aliens Syndicate",
@@ -30,9 +30,12 @@
30
30
  "publishConfig": {
31
31
  "access": "public"
32
32
  },
33
+ "dependencies": {
34
+ "@aliens-syndicate/icons": "0.1.0",
35
+ "@aliens-syndicate/elements": "0.1.0",
36
+ "@aliens-syndicate/reactive": "0.1.0"
37
+ },
33
38
  "devDependencies": {
34
- "@aliens-syndicate/elements": "file:../aliens-syndicate-elements",
35
- "@aliens-syndicate/icons": "^0.1.0",
36
- "@aliens-syndicate/utilities": "^0.1.0"
39
+ "@aliens-syndicate/utilities": "0.1.0"
37
40
  }
38
41
  }