jsswift 1.0.45 → 1.0.47

package/dist/documentions/components/tooltip.md

@@ -1,546 +1,45 @@
 # Tooltip
 
-Exact JSswift UI metadata contract. Use only the props, slots, events, and methods documented below.
+Exact JSswift UI contract. Shared definitions listed in `commonProps` are in [common props](../ui/common-props.md); all component-specific props, slots, events, and methods are below.
 
 ```json
 {
   "signature": "_.Tooltip(props, target?) | _.Tooltip(target, content)",
   "props": {
-    "size": {
-      "type": "string|number",
-      "description": "Size token, number, or CSS length for sizing.",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "style"
-    },
-    "color": {
-      "type": "string",
-      "description": "Semantic color name used to style the component.",
-      "default": null,
-      "values": [
-        "primary",
-        "secondary",
-        "success",
-        "warning",
-        "danger",
-        "info",
-        "light",
-        "dark"
-      ],
-      "category": "style"
-    },
-    "outline": {
-      "type": "boolean",
-      "description": "Uses outlined visual style.",
-      "default": false,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "style"
-    },
-    "clickable": {
-      "type": "boolean",
-      "description": "Enables pointer/hover styles and click handling on the component.",
-      "default": false,
-      "values": null,
-      "category": "behavior"
-    },
-    "padding": {
-      "type": "string|number",
-      "description": "Padding applied to the component root element.",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "layout"
-    },
-    "margin": {
-      "type": "string|number",
-      "description": "Margin applied to the component root element.",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "layout"
-    },
-    "width": {
-      "type": "string|number",
-      "description": "Explicit width (number interpreted as px or CSS length).",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "layout"
-    },
-    "minWidth": {
-      "type": "string|number",
-      "description": "Minimum width constraint (number interpreted as px or CSS length).",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "layout"
-    },
-    "maxWidth": {
-      "type": "string|number",
-      "description": "Maximum width constraint (number interpreted as px or CSS length).",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "layout"
-    },
-    "height": {
-      "type": "string|number",
-      "description": "Explicit height (number interpreted as px or CSS length).",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "layout"
-    },
-    "minHeight": {
-      "type": "string|number",
-      "description": "Minimum height constraint (number interpreted as px or CSS length).",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "layout"
-    },
-    "maxHeight": {
-      "type": "string|number",
-      "description": "Maximum height constraint (number interpreted as px or CSS length).",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "layout"
-    },
-    "radius": {
-      "type": "string|number",
-      "description": "Border radius token or CSS length applied to the component.",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "style"
-    },
-    "borderRadius": {
-      "type": "string|number",
-      "description": "Border radius token or CSS length applied to the component.",
-      "default": null,
-      "values": [
-        "number",
-        "CSS units",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "style"
-    },
-    "shadow": {
-      "type": "string|boolean",
-      "description": "Shadow token or CSS box-shadow string applied to the component.",
-      "default": null,
-      "values": [
-        "none",
-        "xxs",
-        "xs",
-        "sm",
-        "md",
-        "lg",
-        "xl",
-        "xxl",
-        "xxxl"
-      ],
-      "category": "style"
-    },
-    "mobile": {
-      "type": "object",
-      "description": "Responsive overrides applied at the base/mobile viewport.",
-      "default": null,
-      "values": null,
-      "category": "layout"
-    },
-    "tablet": {
-      "type": "object",
-      "description": "Responsive overrides applied from the tablet breakpoint upward.",
-      "default": null,
-      "values": null,
-      "category": "layout"
-    },
-    "pc": {
-      "type": "object",
-      "description": "Responsive overrides applied from the desktop breakpoint upward.",
-      "default": null,
-      "values": null,
-      "category": "layout"
-    },
-    "class": {
-      "type": "string",
-      "description": "Additional CSS classes applied to the component root element.",
-      "default": null,
-      "values": null,
-      "category": "style"
-    },
-    "style": {
-      "type": "object",
-      "description": "Inline styles applied to the component root element.",
-      "default": null,
-      "values": null,
-      "category": "style"
-    },
-    "title": {
-      "type": "String|Node|Function|Array",
-      "description": "Title text or node.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "content": {
-      "type": "String|Node|Function|Array",
-      "description": "Main content node(s) or render function for the component body.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "text": {
-      "type": "String|Node|Function|Array",
-      "description": "Text content for simple components.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "body": {
-      "type": "String|Node|Function|Array",
-      "description": "Component configuration for \"body\". When not handled internally, it is forwarded to the root element.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "footer": {
-      "type": "String|Node|Function|Array",
-      "description": "Footer content node(s) or render function.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "icon": {
-      "type": "String|Node|Function|Array",
-      "description": "Icon name or node rendered with the component.",
-      "default": null,
-      "values": [
-        "#name_tabler",
-        "name_material",
-        "class"
-      ],
-      "category": "general"
-    },
-    "target": {
-      "type": "Node|Function|Array",
-      "description": "Target element or anchor used for positioning.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "trigger": {
-      "type": "\"hover focus\" | \"click\" | \"manual\" | Array",
-      "description": "Component configuration for \"trigger\". When not handled internally, it is forwarded to the root element.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "interactive": {
-      "type": "boolean",
-      "description": "Component configuration for \"interactive\". When not handled internally, it is forwarded to the root element.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "disabled": {
-      "type": "boolean",
-      "description": "Disables interaction and applies disabled styling/ARIA.",
-      "default": false,
-      "values": null,
-      "category": "state"
-    },
-    "open": {
-      "type": "boolean | reactive",
-      "description": "Controls open/visible state (controlled).",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "placement": {
-      "type": "string",
-      "description": "Overlay placement relative to the target/anchor.",
-      "default": null,
-      "values": [
-        "top",
-        "bottom",
-        "left",
-        "right",
-        "top-start",
-        "top-end",
-        "bottom-start",
-        "bottom-end"
-      ],
-      "category": "general"
-    },
-    "delay": {
-      "type": "number",
-      "description": "Delay in milliseconds before showing or hiding.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "hideDelay": {
-      "type": "number",
-      "description": "Component configuration for \"hideDelay\". When not handled internally, it is forwarded to the root element.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "offset": {
-      "type": "number (legacy)",
-      "description": "General offset for positioning.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "offsetX": {
-      "type": "number",
-      "description": "Horizontal offset for overlay placement in pixels.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "offsetY": {
-      "type": "number",
-      "description": "Vertical offset for overlay placement in pixels.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "closeOnOutside": {
-      "type": "boolean",
-      "description": "Closes the component when clicking outside its bounds.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "closeOnEsc": {
-      "type": "boolean",
-      "description": "Closes the component when the Escape key is pressed.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "slots": {
-      "type": "{ target?, icon?, title?, content?, footer?, default? }",
-      "description": "Named slots map for render overrides.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "panelClass": {
-      "type": "string",
-      "description": "Component configuration for \"panelClass\". When not handled internally, it is forwarded to the root element.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "wrapClass": {
-      "type": "string",
-      "description": "Additional CSS classes applied to the outer wrapper.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "targetStyle": {
-      "type": "object",
-      "description": "Component configuration for \"targetStyle\". When not handled internally, it is forwarded to the root element.",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "children": {
-      "type": "Node|Array|Function",
-      "description": "Default child content (nodes, arrays, or render function).",
-      "default": null,
-      "values": null,
-      "category": "general"
-    },
-    "iconRight": {
-      "type": "String|Node|Function|Array",
-      "description": "Icon name or node rendered on the right side of the component.",
-      "default": null,
-      "values": [
-        "#name_tabler",
-        "name_material",
-        "class"
-      ],
-      "category": "general"
-    }
+    "title": {"type": "String|Node|Function|Array", "description": "Title text or node.", "default": null, "values": null, "category": "general"},
+    "content": {"type": "String|Node|Function|Array", "description": "Main content node(s) or render function for the component body.", "default": null, "values": null, "category": "general"},
+    "text": {"type": "String|Node|Function|Array", "description": "Text content for simple components.", "default": null, "values": null, "category": "general"},
+    "body": {"type": "String|Node|Function|Array", "description": "Component configuration for \"body\". When not handled internally, it is forwarded to the root element.", "default": null, "values": null, "category": "general"},
+    "footer": {"type": "String|Node|Function|Array", "description": "Footer content node(s) or render function.", "default": null, "values": null, "category": "general"},
+    "icon": {"type": "String|Node|Function|Array", "description": "Icon name or node rendered with the component.", "default": null, "values": ["#name_tabler", "name_material", "class"], "category": "general"},
+    "target": {"type": "Node|Function|Array", "description": "Target element or anchor used for positioning.", "default": null, "values": null, "category": "general"},
+    "trigger": {"type": "\"hover focus\" | \"click\" | \"manual\" | Array", "description": "Component configuration for \"trigger\". When not handled internally, it is forwarded to the root element.", "default": null, "values": null, "category": "general"},
+    "interactive": {"type": "boolean", "description": "Component configuration for \"interactive\". When not handled internally, it is forwarded to the root element.", "default": null, "values": null, "category": "general"},
+    "disabled": {"type": "boolean", "description": "Disables interaction and applies disabled styling/ARIA.", "default": false, "values": null, "category": "state"},
+    "open": {"type": "boolean | reactive", "description": "Controls open/visible state (controlled).", "default": null, "values": null, "category": "general"},
+    "placement": {"type": "string", "description": "Overlay placement relative to the target/anchor.", "default": null, "values": ["top", "bottom", "left", "right", "top-start", "top-end", "bottom-start", "bottom-end"], "category": "general"},
+    "delay": {"type": "number", "description": "Delay in milliseconds before showing or hiding.", "default": null, "values": null, "category": "general"},
+    "hideDelay": {"type": "number", "description": "Component configuration for \"hideDelay\". When not handled internally, it is forwarded to the root element.", "default": null, "values": null, "category": "general"},
+    "offset": {"type": "number (legacy)", "description": "General offset for positioning.", "default": null, "values": null, "category": "general"},
+    "offsetX": {"type": "number", "description": "Horizontal offset for overlay placement in pixels.", "default": null, "values": null, "category": "general"},
+    "offsetY": {"type": "number", "description": "Vertical offset for overlay placement in pixels.", "default": null, "values": null, "category": "general"},
+    "closeOnOutside": {"type": "boolean", "description": "Closes the component when clicking outside its bounds.", "default": null, "values": null, "category": "general"},
+    "closeOnEsc": {"type": "boolean", "description": "Closes the component when the Escape key is pressed.", "default": null, "values": null, "category": "general"},
+    "slots": {"type": "{ target?, icon?, title?, content?, footer?, default? }", "description": "Named slots map for render overrides.", "default": null, "values": null, "category": "general"},
+    "panelClass": {"type": "string", "description": "Component configuration for \"panelClass\". When not handled internally, it is forwarded to the root element.", "default": null, "values": null, "category": "general"},
+    "wrapClass": {"type": "string", "description": "Additional CSS classes applied to the outer wrapper.", "default": null, "values": null, "category": "general"},
+    "targetStyle": {"type": "object", "description": "Component configuration for \"targetStyle\". When not handled internally, it is forwarded to the root element.", "default": null, "values": null, "category": "general"},
+    "children": {"type": "Node|Array|Function", "description": "Default child content (nodes, arrays, or render function).", "default": null, "values": null, "category": "general"},
+    "iconRight": {"type": "String|Node|Function|Array", "description": "Icon name or node rendered on the right side of the component.", "default": null, "values": ["#name_tabler", "name_material", "class"], "category": "general"}
   },
   "slots": {
-    "target": {
-      "type": "Tooltip trigger content ({ open, show, hide, toggle, isOpen })",
-      "description": "Slot for custom target/anchor element.",
-      "default": null,
-      "values": null,
-      "category": "slot"
-    },
-    "icon": {
-      "type": "Tooltip icon content",
-      "description": "Slot for icon content.",
-      "default": null,
-      "values": [
-        "#name_tabler",
-        "name_material",
-        "class"
-      ],
-      "category": "slot"
-    },
-    "title": {
-      "type": "Tooltip title content",
-      "description": "Slot for title content.",
-      "default": null,
-      "values": null,
-      "category": "slot"
-    },
-    "content": {
-      "type": "Tooltip body content ({ close, hide, isOpen, anchorEl })",
-      "description": "Slot for the main body content.",
-      "default": null,
-      "values": null,
-      "category": "slot"
-    },
-    "footer": {
-      "type": "Tooltip footer content ({ close, hide, isOpen, anchorEl })",
-      "description": "Slot for footer content.",
-      "default": null,
-      "values": null,
-      "category": "slot"
-    },
-    "default": {
-      "type": "Fallback tooltip body content",
-      "description": "Primary content for the component.",
-      "default": null,
-      "values": null,
-      "category": "slot"
-    },
-    "iconRight": {
-      "type": "Tooltip icon content",
-      "description": "Slot for right-aligned icon content."
-    }
+    "target": {"type": "Tooltip trigger content ({ open, show, hide, toggle, isOpen })", "description": "Slot for custom target/anchor element.", "default": null, "values": null, "category": "slot"},
+    "icon": {"type": "Tooltip icon content", "description": "Slot for icon content.", "default": null, "values": ["#name_tabler", "name_material", "class"], "category": "slot"},
+    "title": {"type": "Tooltip title content", "description": "Slot for title content.", "default": null, "values": null, "category": "slot"},
+    "content": {"type": "Tooltip body content ({ close, hide, isOpen, anchorEl })", "description": "Slot for the main body content.", "default": null, "values": null, "category": "slot"},
+    "footer": {"type": "Tooltip footer content ({ close, hide, isOpen, anchorEl })", "description": "Slot for footer content.", "default": null, "values": null, "category": "slot"},
+    "default": {"type": "Fallback tooltip body content", "description": "Primary content for the component.", "default": null, "values": null, "category": "slot"},
+    "iconRight": {"type": "Tooltip icon content", "description": "Slot for right-aligned icon content."}
   },
   "events": {
     "onOpen": "(entry) => void",
@@ -548,6 +47,7 @@ Exact JSswift UI metadata contract. Use only the props, slots, events, and metho
     "onTriggerClick": "(event) => void"
   },
   "returns": "Object { bind(), open(), show(), hide(), close(), toggle(), isOpen() } | HTMLSpanElement",
-  "description": "Anchored tooltip with hover/focus/click triggers, rich content, and imperative API."
+  "description": "Anchored tooltip with hover/focus/click triggers, rich content, and imperative API.",
+  "commonProps": {"path": "ui/common-props.md", "keys": ["size", "color", "outline", "clickable", "padding", "margin", "width", "minWidth", "maxWidth", "height", "minHeight", "maxHeight", "radius", "borderRadius", "shadow", "mobile", "tablet", "pc", "class", "style"]}
 }
 ```

package/dist/documentions/knowledge-map.json

@@ -3,6 +3,24 @@
   "scope": "application-development",
   "entrypoint": "README.md",
   "topics": [
+    {
+      "id": "ai-quick-start",
+      "title": "AI quick start and shared styling",
+      "keywords": [
+        "AI.md",
+        "quick start",
+        "percorso breve",
+        "esempi minimi",
+        "callback",
+        "common props",
+        "proprietà comuni",
+        "CSS"
+      ],
+      "paths": [
+        "AI.md",
+        "ui/common-props.md"
+      ]
+    },
     {
       "id": "getting-started",
       "title": "First application or screen",
@@ -55,7 +73,11 @@
         "_.effect",
         "_.computed",
         "_.untracked",
-        "_.batch"
+        "_.batch",
+        "rod",
+        "_.rod",
+        "bidirezionale",
+        "two-way binding"
       ],
       "paths": [
         "reactivity.md"
@@ -943,5 +965,8 @@
       ]
     }
   ],
-  "packageVersion": "1.0.45"
+  "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.