jsswift 1.0.44 → 1.0.45

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

@@ -943,5 +943,5 @@
       ]
     }
   ],
-  "packageVersion": "1.0.44"
+  "packageVersion": "1.0.45"
 }

package/dist/tabler.js

@@ -0,0 +1,7 @@
+// Optional Tabler sprite: import after the JSswift runtime.
+const runtime = globalThis.JSswift;
+if (!runtime) throw new Error("Load JSswift before importing the optional Tabler sprite");
+const spriteUrl = new URL('./img/svg/tabler-icons-sprite.svg', import.meta.url).href;
+runtime.config ||= {};
+runtime.config.iconSpriteUrl = spriteUrl;
+export default spriteUrl;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsswift",
-  "version": "1.0.44",
+  "version": "1.0.45",
   "description": "Umbrella package for JSswift core + UI",
   "license": "MIT",
   "repository": {
@@ -30,7 +30,10 @@
     "./css/animation.css": "./dist/css/animation.css",
     "./css/docs.css": "./dist/css/docs.css",
     "./package.json": "./package.json",
-    "./knowledge-map.json": "./dist/documentions/knowledge-map.json"
+    "./knowledge-map.json": "./dist/documentions/knowledge-map.json",
+    "./tabler": "./dist/tabler.js",
+    "./css/fonts-nunito.css": "./dist/css/fonts-nunito.css",
+    "./css/fonts-material.css": "./dist/css/fonts-material.css"
   },
   "files": [
     "dist"