jsswift 1.0.44 → 1.0.46

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/getting-started.md

@@ -6,6 +6,16 @@
 - Call UI components directly on `_`, for example `_.Toggle(...)` and `_.Input(...)`.
 - HTML/SVG helpers also use `_`, for example `_.div(...)`.
 
+Minimal Vite imports:
+
+```js
+import 'jsswift';
+import 'jsswift/css/ui.css';
+const _ = window._;
+```
+
+Read [application-rules.md](application-rules.md) before styling; the UI stylesheet already contains component styles and responsive rules.
+
 Example:
 
     _.ready(() => _.mount("#app", App()));
@@ -18,3 +28,20 @@ Example:
     }
 
 A view may return a DOM node, array, fragment, JSswift UI component, or reactive render function. Start with shell (AppShell, Layout, Page), layout (Container, Grid, Row, Card), then focused UI components.
+
+## Optional fonts and icons
+
+`jsswift/css/ui.css` includes component styles and uses system fonts. It does not load font files or activate the Tabler catalog. Existing applications that need Nunito or Material Symbols must now opt in explicitly:
+
+```js
+import 'jsswift';
+import 'jsswift/css/ui.css';
+// Optional: Nunito, including its theme font variables.
+import 'jsswift/css/fonts-nunito.css';
+// Optional: Material Symbols (downloads a font from Google).
+import 'jsswift/css/fonts-material.css';
+// Optional: configures the bundled Tabler SVG sprite for _.Icon('#name').
+import 'jsswift/tabler';
+```
+
+The same entries exist under `@jsswift/ui`; load the core and UI runtime first. Tabler can also be configured manually with `_.config.iconSpriteUrl` or the Icon `spriteUrl` prop. Inline SVG nodes and the built-in chevron remain available without the catalog. Import only the optional assets actually needed. The npm package still ships these assets; opting out reduces application build assets, not installation size. For CDN usage, load the runtime first, then import the optional `dist/tabler.js` module and/or link the optional CSS after `ui.css`.

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",
@@ -943,5 +961,5 @@
       ]
     }
   ],
-  "packageVersion": "1.0.44"
+  "packageVersion": "1.0.46"
 }