jsswift 1.0.46 → 1.0.47

package/dist/documentions/AI.md

@@ -1,6 +1,6 @@
 # JSswift AI quick start
 
-Start here for a small page using Input, Select, Button, Card, Table, and Dialog. The example and callback table below are a supported subset; read a component contract only when using additional APIs. Do not read the whole catalog or search runtime bundles for documentation.
+Start here for a small page using Input, Select, Button, Card, Table, and Dialog. The example and callback table below are a supported subset; read a component contract only when using additional APIs. Do not read the whole catalog or search runtime bundles for documentation. Button’s full contract is `components/btn.md`; `components/button.md` redirects to it.
 
 ## Import, create, mount
 
@@ -11,8 +11,8 @@ import 'jsswift';
 import 'jsswift/css/ui.css';
 const _ = window._;
 
-const name = _.signal('Prodotto 01');
-const category = _.signal('Casa');
+const name = _.rod('Prodotto 01');
+const category = _.rod('Casa');
 const nameInput = _.Input({ label: 'Nome prodotto', model: name });
 const categorySelect = _.Select({
   label: 'Categoria', model: category,
@@ -25,12 +25,12 @@ const dialog = _.Dialog({
   closeOnEsc: true, trapFocus: true, autoFocus: true
 });
 const save = _.Button({ color: 'primary', onClick: () => {
-  if (!name[0]().trim()) {
+  if (!name.value.trim()) {
     errors.replaceChildren(_.p('Il nome è obbligatorio.'));
     return;
   }
   errors.replaceChildren();
-  console.log({ name: name[0](), category: category[0]() });
+  console.log({ name: name.value, category: category.value });
   dialog.close();
 }}, 'Salva');
 dialog.update({ actions: [
@@ -49,7 +49,7 @@ const page = _.Page({}, _.Card({ title: 'Prodotti' }, edit, table));
 _.mount('#app', page);
 ```
 
-This demonstrates composition and validation; saving logs the values. Add application persistence and refresh the table when your task requires them. `_.signal` returns `[get, set, dispose]`: read `name[0]()`, write `name[1]('Nuovo nome')`; `model` synchronizes the control. This avoids reading private `_input` or `_select` references. The current controls do not document public `focus/getValue/setValue` methods; do not invent them.
+This demonstrates composition and validation; saving logs the values. Add application persistence and refresh the table when your task requires them. Prefer `_.rod(initial)` for bidirectional field models: read `name.value`, write `name.value = 'Nuovo nome'`; `model` synchronizes the control. Use `_.signal(initial)` when explicit getter/setter functions suit the state, and `_.useForm()` for structured form validation and errors. This avoids reading private `_input` or `_select` references. The current controls do not document public `focus/getValue/setValue` methods; do not invent them.
 
 ## Exact callback arguments
 

package/dist/documentions/components/button.md

@@ -0,0 +1,3 @@
+# Button
+
+The canonical complete contract is [btn.md](btn.md). Use `_.Button`; `_.Btn` is a compatible alias. This path is a documentation alias, not a separate component.

package/dist/documentions/components/select.md

@@ -78,3 +78,17 @@ _.Select({
 ```
 
 An empty-string option is a valid selected value. Read `multiple` and `model` contracts when those modes are needed. Verify the rendered control's accessible name.
+
+## Signal model
+
+Pass the full public tuple from `_.signal(initial)` directly as `model`; `[get, set]` is also supported. Choosing an option updates the model synchronously before `onChange` runs. Updating the model updates the displayed option.
+
+```js
+const category = _.signal('');
+const field = _.Select({ model: category, options: [
+  { value: '', label: 'Seleziona' }, { value: 'Casa', label: 'Casa' }
+] });
+const save = _.Button({ onClick: () => console.log(category[0]()) }, 'Salva');
+```
+
+Mount both controls; choose Casa through the menu, then save. The logged model value must be Casa.

package/dist/documentions/knowledge-map.json

@@ -73,7 +73,11 @@
         "_.effect",
         "_.computed",
         "_.untracked",
-        "_.batch"
+        "_.batch",
+        "rod",
+        "_.rod",
+        "bidirezionale",
+        "two-way binding"
       ],
       "paths": [
         "reactivity.md"
@@ -961,5 +965,8 @@
       ]
     }
   ],
-  "packageVersion": "1.0.46"
+  "documentAliases": {
+    "components/button.md": "components/btn.md"
+  },
+  "packageVersion": "1.0.47"
 }

package/dist/documentions/reactivity.md

@@ -1,13 +1,27 @@
 # Reactivity and models
 
-`_.signal(initial)` returns `[get, set, dispose]`. Use `_.computed` for derived values, `_.effect` for side effects, `_.untracked` for a non-subscribing read, and `_.batch` for grouped updates.
+Prefer `_.rod(initial)` for bidirectional control models. Pass the rod as `model`, read and update its public `.value`; do not manually mutate the control DOM.
 
-These direct aliases are exposed by the core runtime footer. Use them in application code.
+```js
+const name = _.rod('');
+const category = _.rod('');
+const input = _.Input({ label: 'Nome prodotto', model: name });
+const select = _.Select({ model: category, options: [
+  { value: '', label: 'Seleziona' }, { value: 'Casa', label: 'Casa' }
+] });
+const save = _.Button({ onClick: () => console.log(name.value, category.value) }, 'Salva');
+name.value = 'Prodotto 01';
+// Choosing Casa in Select updates category.value; changing category.value updates Select.
+```
 
-Example:
+Rod control notifications are scheduled through microtasks; wait for the control update before inspecting DOM after a programmatic assignment. Rod values themselves can be read immediately. Use `_.useForm()` for values, validation, touched/dirty flags and submit state; see [forms](ui/forms.md). Follow each component's documented model contract.
 
-    const [getCount, setCount] = _.signal(0);
-    _.Button({ onClick: () => setCount(getCount() + 1) }, "Add");
-    _.Badge({ label: () => String(getCount()) });
+`_.signal(initial)` remains supported and returns `[get, set, dispose]`. Use it when explicit getter/setter functions are useful. Pass the full tuple as `model` to a control supporting signals; `[get, set]` is also supported.
 
-For a documented controlled component, pass a signal tuple as model; do not manually mutate DOM values. Use _.useForm for form values, validation, touched/dirty flags, and submit state.
+```js
+const [getCount, setCount] = _.signal(0);
+_.Button({ onClick: () => setCount(getCount() + 1) }, 'Add');
+_.Badge({ label: () => String(getCount()) });
+```
+
+Use `_.computed` for derived values, `_.effect` for side effects, `_.untracked` for a non-subscribing read, and `_.batch` for grouped updates. These direct aliases are exposed by the core runtime footer.

package/dist/jsswift.js

@@ -6644,7 +6644,7 @@ const unitCover = (v, name = 'size') => {
   };
 
   function uiIsSignal(v) {
-    return Array.isArray(v) && v.length === 2 && typeof v[0] === "function" && typeof v[1] === "function";
+    return Array.isArray(v) && (v.length === 2 || (v.length === 3 && typeof v[2] === "function")) && typeof v[0] === "function" && typeof v[1] === "function";
   }
 
   function uiIsRod(v) {