jsswift 1.0.42 → 1.0.44

package/dist/documentions/platform.md

@@ -0,0 +1,9 @@
+# Router, store, HTTP, auth, and themes
+
+    _.router.setOutlet("#app");
+    _.router.add("/", () => DashboardPage());
+    _.router.notFound(() => _.EmptyState({ title: "Page not found" }));
+    _.router.start();
+    const rows = await _.http.getJSON("/api/rows");
+
+Use getJSON, postJSON, putJSON, patchJSON, and delJSON for JSON APIs. Use request hooks only through onBefore, onAfter, and onError. Use _.auth and _.Can only with a defined permission model. Theme helpers are setTheme, getTheme, and toggleTheme; default persistence is jsswift:theme.

package/dist/documentions/reactivity.md

@@ -0,0 +1,13 @@
+# 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.
+
+These direct aliases are exposed by the core runtime footer. Use them in application code.
+
+Example:
+
+    const [getCount, setCount] = _.signal(0);
+    _.Button({ onClick: () => setCount(getCount() + 1) }, "Add");
+    _.Badge({ label: () => String(getCount()) });
+
+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.

package/dist/documentions/reference/function-catalog.md

@@ -0,0 +1,333 @@
+# App-facing function catalog
+
+Use these JSswift functions when building apps. Some low-level renderer and helper functions are included because app code can call them directly.
+- `_.a`
+- `_.abbr`
+- `_.address`
+- `_.Alert`
+- `_.AppShell`
+- `_.article`
+- `_.aside`
+- `_.asNodeArray`
+- `_.audio`
+- `_.Avatar`
+- `_.b`
+- `_.Badge`
+- `_.Banner`
+- `_.base`
+- `_.batch`
+- `_.bdi`
+- `_.bdo`
+- `_.blockquote`
+- `_.body`
+- `_.br`
+- `_.Breadcrumbs`
+- `_.Button`
+- `_.button`
+- `_.Can`
+- `_.canvas`
+- `_.caption`
+- `_.Card`
+- `_.cardBody`
+- `_.cardFooter`
+- `_.cardHeader`
+- `_.Checkbox`
+- `_.Chip`
+- `_.circle`
+- `_.cite`
+- `_.clipPath`
+- `_.code`
+- `_.col`
+- `_.Col`
+- `_.colgroup`
+- `_.component`
+- `_.computed`
+- `_.Container`
+- `_.ContextMenu`
+- `_.data`
+- `_.datalist`
+- `_.Date`
+- `_.dd`
+- `_.debug.enabled`
+- `_.debug.error`
+- `_.debug.inc`
+- `_.debug.log`
+- `_.debug.reset`
+- `_.debug.stats`
+- `_.debug.warn`
+- `_.defs`
+- `_.details`
+- `_.dfn`
+- `_.Dialog`
+- `_.dialog.alert`
+- `_.dialog.confirm`
+- `_.dialog.prompt`
+- `_.div`
+- `_.dl`
+- `_.docTable`
+- `_.dom.attr`
+- `_.dom.q`
+- `_.dom.qa`
+- `_.Drawer`
+- `_.dt`
+- `_.dynamic`
+- `_.effect`
+- `_.ellipse`
+- `_.em`
+- `_.embed`
+- `_.EmptyState`
+- `_.enableAutoCleanup`
+- `_.feBlend`
+- `_.feColorMatrix`
+- `_.feGaussianBlur`
+- `_.feOffset`
+- `_.fieldset`
+- `_.filter`
+- `_.footer`
+- `_.Footer`
+- `_.form`
+- `_.Form`
+- `_.FormField`
+- `_.fragment`
+- `_.g`
+- `_.getTheme`
+- `_.Grid`
+- `_.GridCol`
+- `_.h1`
+- `_.h2`
+- `_.h3`
+- `_.h4`
+- `_.h5`
+- `_.h6`
+- `_.head`
+- `_.header`
+- `_.Header`
+- `_.hr`
+- `_.html`
+- `_.http.del`
+- `_.http.delJSON`
+- `_.http.get`
+- `_.http.getJSON`
+- `_.http.onAfter`
+- `_.http.onBefore`
+- `_.http.onError`
+- `_.http.patch`
+- `_.http.patchJSON`
+- `_.http.post`
+- `_.http.postJSON`
+- `_.http.put`
+- `_.http.putJSON`
+- `_.http.request`
+- `_.http.state`
+- `_.i`
+- `_.Icon`
+- `_.iframe`
+- `_.img`
+- `_.input`
+- `_.Input`
+- `_.InputRaw`
+- `_.isDev`
+- `_.isListItemNode`
+- `_.isUIPlainObject`
+- `_.Item`
+- `_.kbd`
+- `_.Kpi`
+- `_.label`
+- `_.Layout`
+- `_.legend`
+- `_.li`
+- `_.line`
+- `_.linearGradient`
+- `_.link`
+- `_.List`
+- `_.loading.hide`
+- `_.loading.progress`
+- `_.loading.show`
+- `_.loading.wrap`
+- `_.LoadingBar`
+- `_.main`
+- `_.mark`
+- `_.mask`
+- `_.Menu`
+- `_.meter`
+- `_.mount`
+- `_.nav`
+- `_.noscript`
+- `_.Notify`
+- `_.notify.clear`
+- `_.notify.error`
+- `_.notify.info`
+- `_.notify.primary`
+- `_.notify.promise`
+- `_.notify.remove`
+- `_.notify.secondary`
+- `_.notify.show`
+- `_.notify.success`
+- `_.notify.update`
+- `_.notify.warning`
+- `_.object`
+- `_.ol`
+- `_.omit`
+- `_.optgroup`
+- `_.option`
+- `_.output`
+- `_.overlay.close`
+- `_.overlay.closeTop`
+- `_.overlay.open`
+- `_.p`
+- `_.Page`
+- `_.Pagination`
+- `_.Parallax`
+- `_.param`
+- `_.path`
+- `_.pattern`
+- `_.perf.enable`
+- `_.perf.inc`
+- `_.perf.mark`
+- `_.perf.reset`
+- `_.perf.slowEffects`
+- `_.perf.stats`
+- `_.perf.tick`
+- `_.perf.time`
+- `_.perf.timeline`
+- `_.picture`
+- `_.plugins.auth.install`
+- `_.plugins.debug.install`
+- `_.plugins.forms.install`
+- `_.polygon`
+- `_.polyline`
+- `_.Popover`
+- `_.pre`
+- `_.progress`
+- `_.Progress`
+- `_.q`
+- `_.radialGradient`
+- `_.Radio`
+- `_.Rating`
+- `_.signal`
+- `_.untracked`
+- `_.ready`
+- `_.rect`
+- `_.rod`
+- `_.rodBind`
+- `_.rodFromSignal`
+- `_.rodModel`
+- `_.router.add`
+- `_.router.beforeEach`
+- `_.router.current`
+- `_.router.history`
+- `_.router.inspect`
+- `_.router.isActive`
+- `_.router.navigate`
+- `_.router.notFound`
+- `_.router.setBase`
+- `_.router.setOutlet`
+- `_.router.setURLOnly`
+- `_.router.start`
+- `_.router.status`
+- `_.router.subscribe`
+- `_.router.trace`
+- `_.RouteTab`
+- `_.Row`
+- `_.rp`
+- `_.rt`
+- `_.ruby`
+- `_.s`
+- `_.samp`
+- `_.script`
+- `_.Search`
+- `_.section`
+- `_.select`
+- `_.Select`
+- `_.Separator`
+- `_.setTheme`
+- `_.signalModel`
+- `_.Slider`
+- `_.slot`
+- `_.small`
+- `_.source`
+- `_.Spacer`
+- `_.span`
+- `_.Spinner`
+- `_.Stat`
+- `_.stop`
+- `_.store.autoForm`
+- `_.store.bind`
+- `_.store.bindAll`
+- `_.store.clear`
+- `_.store.computed`
+- `_.store.configure`
+- `_.store.get`
+- `_.store.inspect`
+- `_.store.migrate`
+- `_.store.model`
+- `_.store.remove`
+- `_.store.set`
+- `_.store.signal`
+- `_.store.stats`
+- `_.store.watch`
+- `_.strong`
+- `_.style`
+- `_.sub`
+- `_.summary`
+- `_.sup`
+- `_.svg`
+- `_.symbol`
+- `_.table`
+- `_.Table`
+- `_.TabPanel`
+- `_.Tabs`
+- `_.tbody`
+- `_.td`
+- `_.template`
+- `_.text`
+- `_.textarea`
+- `_.tfoot`
+- `_.th`
+- `_.thead`
+- `_.time`
+- `_.Time`
+- `_.title`
+- `_.Toggle`
+- `_.toggleTheme`
+- `_.Toolbar`
+- `_.Tooltip`
+- `_.tr`
+- `_.track`
+- `_.tspan`
+- `_.u`
+- `_.can`
+- `_.canAll`
+- `_.canAny`
+- `_.getSlot`
+- `_.inspect`
+- `_.renderSlot`
+- `_.slots`
+- `_.uiApplyResponsiveProps`
+- `_.uiClass`
+- `_.uiClassStatic`
+- `_.uiClassValue`
+- `_.uiComputed`
+- `_.uiIsReactive`
+- `_.uiNormalizeArgs`
+- `_.uiResponsiveClasses`
+- `_.uiResponsiveHasConfig`
+- `_.uiResponsiveHasProp`
+- `_.uiResponsivePropsFor`
+- `_.uiResponsiveStyleRules.10.mapValue`
+- `_.uiResponsiveStyleRules.11.mapValue`
+- `_.uiResponsiveStyleRules.2.mapValue`
+- `_.uiResponsiveStyleRules.9.mapValue`
+- `_.uiStyleValue`
+- `_.uiUnwrap`
+- `_.uiWhen`
+- `_.ul`
+- `_.use`
+- `_.useForm`
+- `_.usePlugin`
+- `_.useRoute`
+- `_.useRouter`
+- `_.useStore`
+- `_.var`
+- `_.video`
+- `_.wbr`

package/dist/documentions/reference/html-svg-helpers.md

@@ -0,0 +1,131 @@
+# HTML and SVG helper catalog
+
+Call these helpers on `_`, for example `_.div(...)` and `_.svg(...)`. Names are case-sensitive: `_.input` is an HTML helper, while `_.Input` is a UI component.
+
+- `a`
+- `abbr`
+- `address`
+- `article`
+- `aside`
+- `audio`
+- `b`
+- `base`
+- `bdi`
+- `bdo`
+- `blockquote`
+- `body`
+- `br`
+- `button`
+- `canvas`
+- `caption`
+- `circle`
+- `cite`
+- `clipPath`
+- `code`
+- `col`
+- `colgroup`
+- `data`
+- `datalist`
+- `dd`
+- `defs`
+- `details`
+- `dfn`
+- `div`
+- `dl`
+- `dt`
+- `ellipse`
+- `em`
+- `embed`
+- `feBlend`
+- `feColorMatrix`
+- `feGaussianBlur`
+- `feOffset`
+- `fieldset`
+- `filter`
+- `footer`
+- `form`
+- `g`
+- `h1`
+- `h2`
+- `h3`
+- `h4`
+- `h5`
+- `h6`
+- `head`
+- `header`
+- `hr`
+- `html`
+- `i`
+- `iframe`
+- `img`
+- `input`
+- `kbd`
+- `label`
+- `legend`
+- `li`
+- `line`
+- `linearGradient`
+- `link`
+- `main`
+- `mark`
+- `mask`
+- `meter`
+- `nav`
+- `noscript`
+- `object`
+- `ol`
+- `optgroup`
+- `option`
+- `output`
+- `p`
+- `param`
+- `path`
+- `pattern`
+- `picture`
+- `polygon`
+- `polyline`
+- `pre`
+- `progress`
+- `q`
+- `radialGradient`
+- `rect`
+- `rp`
+- `rt`
+- `ruby`
+- `s`
+- `samp`
+- `script`
+- `section`
+- `select`
+- `slot`
+- `small`
+- `source`
+- `span`
+- `stop`
+- `strong`
+- `style`
+- `sub`
+- `summary`
+- `sup`
+- `svg`
+- `symbol`
+- `table`
+- `tbody`
+- `td`
+- `template`
+- `text`
+- `textarea`
+- `tfoot`
+- `th`
+- `thead`
+- `time`
+- `title`
+- `tr`
+- `track`
+- `tspan`
+- `u`
+- `ul`
+- `use`
+- `var`
+- `video`
+- `wbr`

package/dist/documentions/ui/data-feedback-overlays.md

@@ -0,0 +1,5 @@
+# Data, feedback, and overlays
+
+Use Table for operational data. Use Spinner, Progress, LoadingBar, Notify, Alert, Banner, and EmptyState for the matching state. Use Dialog for focused flows and Menu, Popover, ContextMenu, or Tooltip for anchored interactions.
+
+Overlay behavior and imperative APIs differ. Before implementing triggers, focus, outside clicks, escape behavior, or return values, read the exact component file. Do not assume overlays share props.

package/dist/documentions/ui/forms.md

@@ -0,0 +1,11 @@
+# Forms
+
+Use _.useForm for values, validation, touched/dirty flags, and submissions. Bind fields through form.model("field").
+
+    const form = _.useForm({ values: { email: "" } });
+    _.Form({ form },
+      _.Input({ label: "Email", model: form.model("email") }),
+      _.Button({ type: "submit", color: "primary" }, "Save")
+    );
+
+Read each control document—Input, Select, Checkbox, Radio, Toggle, Slider, Rating, Date, and Time—because their value and model contracts differ.

package/dist/documentions/ui/layout-and-responsive.md

@@ -0,0 +1,15 @@
+# Layout and responsive UI
+
+Use Container, Grid, GridCol, Row, Col, Spacer, Toolbar, Card, Layout, Page, Header, Drawer, Footer, and AppShell before raw CSS layout.
+
+- Root props: mobile/default
+- tablet: from 768px
+- pc: from 1024px
+
+    _.Row({
+      direction: "column", gap: "sm",
+      tablet: { direction: "row", gap: "md" },
+      pc: { justify: "space-between" }
+    }, left, right);
+
+Read exact Grid, GridCol, and shell contracts before using spans, tracks, placement, or shell slots.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsswift",
-  "version": "1.0.42",
+  "version": "1.0.44",
   "description": "Umbrella package for JSswift core + UI",
   "license": "MIT",
   "repository": {
@@ -28,7 +28,9 @@
     "./css/ui-components.css": "./dist/css/ui-components.css",
     "./css/responsive.css": "./dist/css/responsive.css",
     "./css/animation.css": "./dist/css/animation.css",
-    "./css/docs.css": "./dist/css/docs.css"
+    "./css/docs.css": "./dist/css/docs.css",
+    "./package.json": "./package.json",
+    "./knowledge-map.json": "./dist/documentions/knowledge-map.json"
   },
   "files": [
     "dist"