@ashley-shrok/viewmodel-shell 0.16.0 → 1.1.0

package/dist/browser.d.ts

@@ -1,24 +1,14 @@
-import type { ViewNode, ActionEvent, Adapter } from "./index.js";
+import type { ViewNode, ActionEvent, Adapter, StateAccess } from "./index.js";
 export declare class BrowserAdapter implements Adapter {
     private container;
     private fileRegistry;
+    private sa;
     constructor(container: HTMLElement);
-    render(vm: ViewNode, onAction: (action: ActionEvent) => void): void;
+    render(vm: ViewNode, onAction: (action: ActionEvent) => void, stateAccess?: StateAccess): void;
     navigate(url: string): void;
     storage(scope: "local" | "session", key: string, value: string): void;
-    /** Save an authenticated-download blob via the browser's native Save-As.
-     *  contentType is informational — the Blob's own .type takes precedence in
-     *  browsers. We accept the arg for adapter symmetry (other adapters use it). */
     saveFile(data: Blob, filename: string, _contentType: string): void;
-    /** 0.16.0 — toggle the `.vms-busy` class on the container. Default CSS makes
-     *  every interactive descendant non-clickable (cursor:wait + pointer-events:
-     *  none), so a rapid checkbox click during a round-trip never visually flips
-     *  the box. Idempotent (classList.toggle with a force value). */
     setBusy(active: boolean): void;
-    /** 0.14.0 — install / clear the browser's `beforeunload` guard. The shell
-     *  calls this on every response with `response.preventUnload ?? false`, so
-     *  the lock-and-clear cycle is just "server sets preventUnload:true while
-     *  work is pending, omits it (or sets false) when done." Idempotent. */
     private unloadHandler;
     setPreventUnload(active: boolean): void;
     transport(input: string, init: {
@@ -34,17 +24,39 @@ export declare class BrowserAdapter implements Adapter {
     private section;
     private list;
     private listItem;
+    /** FormNode — no harvest. Field values live in state via their bind paths;
+     *  submit dispatches just `{name}`. File inputs are walked for binaries to
+     *  attach to action.files (multipart side channel). */
     private form;
+    /** FieldNode — reads value from `sa.read(bind)`; writes back on input/change.
+     *  When `action` is set, it fires on Enter (text-like) or change (select) —
+     *  the new value is already in state by that point. */
     private field;
+    /** CheckboxNode (standalone, immediate-dispatch) — bound boolean; on toggle,
+     *  write to state then dispatch the action name (if any). */
     private checkbox;
     private button;
     private text;
     private link;
     private statBar;
+    /** TabsNode — on click, write tab.value to state at node.bind, then dispatch
+     *  the tab's own action name. */
     private tabs;
     private image;
     private progress;
     private modal;
+    /** TableNode — sort writes {column, direction} to sortBind then dispatches
+     *  sortActions[col.key]; filter inputs are bound to filterBinds[col.key],
+     *  every keystroke writes, Enter dispatches filterAction; pagination
+     *  prev/next write the target page to paginationBind then dispatch
+     *  prevAction/nextAction. Per-row controls (row.actions[]) are a mix of
+     *  ButtonNode and CheckboxNode dispatched by entry.type. When row.action
+     *  is set, the entire <tr> becomes clickable + keyboard-activatable
+     *  (Enter / Space — Space preventDefaults page scroll) and exposes
+     *  role="button", tabindex=0, and an aria-label derived from cell text;
+     *  clicks on per-row controls or cell linkLabel anchors stopPropagation
+     *  so they don't also fire row.action. Selection is no longer a framework
+     *  concept. */
     private table;
     private copyButton;
 }