tutuca 0.9.54 → 0.9.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tutuca",
-  "version": "0.9.54",
+  "version": "0.9.56",
   "type": "module",
   "description": "Zero-dependency SPA framework with immutable state and virtual DOM",
   "main": "./dist/tutuca.js",

package/skill/immutable-js/SKILL.md

@@ -1,22 +1,13 @@
 ---
 name: immutable-js
-description: Reference for the Immutable.js API organized by datatype (List, Map, Set, OrderedMap, OrderedSet, Stack, Record, Seq, Collection, Range, Repeat) and by topic (deep updates, equality, type predicates, JS conversion). Use when the user asks how to use a specific Immutable.js datatype or method, when writing or reviewing code in this repository, or when explaining Immutable.js semantics like persistent updates, value equality, or lazy evaluation.
+description: Reference for the Immutable.js API organized by datatype (List, Map, Set, OrderedMap, OrderedSet, Stack, Record, Seq, Collection, Range, Repeat) and by topic (deep updates, equality, type predicates, JS conversion). Use when the user asks how to use a specific Immutable.js datatype or method, when writing or reviewing code that imports from `immutable`, or when explaining Immutable.js semantics like persistent updates, value equality, or lazy evaluation.
 ---
 
 # Immutable.js
 
-Persistent immutable data structures for JavaScript. All operations return a
-new collection rather than mutating the original; structural sharing keeps
-this efficient. Treat collections as **values**, not objects — compare with
-`is(a, b)` or `a.equals(b)`, never `===`.
-
-```js
-import { Map } from 'immutable';
-const m1 = Map({ a: 1, b: 2 });
-const m2 = m1.set('b', 50);
-m1.get('b'); // 2  — m1 is unchanged
-m2.get('b'); // 50
-```
+Persistent immutable data structures: every operation returns a new collection,
+never mutates. Treat collections as **values** — compare with `is(a, b)` or
+`a.equals(b)`, never `===`. See [equality.md](references/equality.md).
 
 ## Inheritance cheatsheet
 
@@ -36,6 +27,14 @@ Seq mirrors the hierarchy lazily:
        └─ Seq.Set     ─ set-like lazy sequence
 ```
 
+## How to use this skill
+
+Load only the reference file(s) that match the question — do not preload
+all of them. Pick a datatype file when the question is about one type's
+methods; pick an operations/topics file when the question crosses types
+(deep updates, equality, conversions). For exact signatures, fall back
+to `type-definitions/immutable.d.ts` (see *Authoritative sources* below).
+
 ## Datatypes
 
 Read the reference for a specific datatype when answering questions about

package/skill/tutuca/SKILL.md

@@ -1,37 +1,27 @@
 ---
 name: tutuca
-description: Authoring or reviewing tutuca components, html`` views, macros, or running the `tutuca` CLI. Covers field types, @-directives, bubble/receive/response handlers, and the post-edit `tutuca <module> lint` + `tutuca <module> render --title …` verification recipe.
+description: Use when authoring or reviewing tutuca modules — `component({...})` definitions, `html\`...\`` views, `@`-directives, `input` / `bubble` / `receive` / `response` / `alter` handlers, macros, or `getTests` exports — or when running the `tutuca` CLI (`lint` / `test` / `render` / `docs`). Covers the post-edit `tutuca <module> lint` → `test` → `render --title "<example>"` verification recipe.
 ---
 
-# Tutuca
-
-Tutuca is an immutable-state SPA framework: components have typed
-`fields`, auto-generated mutators (`setX`, `pushInX`, …), HTML-template
-`view`s with `@`-prefixed directives, and `bubble` / `receive` /
-`response` handlers for orchestration.
-
-## Verifying changes
+<!-- This file is generated by scripts/build-skill.js from docs/llm/. Do not edit. -->
 
-After editing a tutuca module, run two checks before declaring the edit
-done:
-
-1. **Lint** — catches undefined fields/handlers/macros/events. Exits
-   `2` on any error-level finding.
+# Tutuca
 
-   ```sh
-   tutuca <module-path> lint
-   ```
+Tutuca is an immutable-state SPA framework. See [core.md](./core.md)
+for the framework primer and the post-edit verification recipe
+(`tutuca <module> lint` → `test` → `render --title "<example>"`).
 
-2. **Render the example that exercises the feature you changed** —
-   confirms the component mounts in a headless DOM with the new
-   behavior. Exits `3` on render crash.
+## Companion skills
 
-   ```sh
-   tutuca <module-path> render --title "<example title>"
-   ```
+When authoring tutuca code, also load these if available:
 
-   If no example covers the feature, add one to `getExamples()` first —
-   that's how the feature becomes verifiable.
+- **immutable-js** — every `immutable` export is reachable through
+  `tutuca` (`List`, `IMap`, `OMap`, `ISet`, `Record`, `Seq`,
+  `fromJS`, `is`, …). Reach for it whenever the work touches state
+  values.
+- **margaui** — the Tailwind v4 / daisyUI-compatible class library.
+  Reach for it when the project uses MargaUI / Tailwind class lists in
+  `class=` / `:class=`.
 
 ## Routing