@fuzdev/fuz_app 0.51.0 → 0.53.0

package/dist/ui/popover.svelte.d.ts

@@ -106,19 +106,32 @@ export declare class Popover {
     popover_class: string;
     constructor(params?: PopoverParameters);
     /**
-     * Updates the popover configuration.
+     * Updates the popover configuration. Swaps `popover_class` on the live
+     * content element when supplied and re-syncs the outside-click handler
+     * if `disable_outside_click` changed.
+     *
+     * @mutates `this`
      */
     update(params: PopoverParameters): void;
     /**
-     * Shows the popover.
+     * Shows the popover, registering the outside-click handler and updating
+     * `aria-expanded` on the trigger. No-ops when already visible.
+     *
+     * @mutates `this`
      */
     show(): void;
     /**
-     * Hides the popover.
+     * Hides the popover, removing the outside-click handler. No-ops when
+     * already hidden.
+     *
+     * @mutates `this`
      */
     hide(): void;
     /**
-     * Toggles the popover visibility.
+     * Toggles the popover visibility, or sets it to the given value.
+     *
+     * @param visible - desired visibility (defaults to the inverse of current)
+     * @mutates `this`
      */
     toggle(visible?: boolean): void;
     /**

package/dist/ui/popover.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popover.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/popover.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAGpC,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAC,KAAK,QAAQ,EAAE,KAAK,SAAS,EAA2B,MAAM,uBAAuB,CAAC;AAS9F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IAClE,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,gBAAgB,GAAG;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAC,CAAC;AAElG;;GAEG;AAEH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;CAElE;AAED;;GAEG;AACH,qBAAa,OAAO;;IACnB,gDAAgD;IAChD,OAAO,UAAqB;IAE5B,uDAAuD;IACvD,QAAQ,EAAE,QAAQ,CAAwB;IAE1C,yCAAyC;IACzC,KAAK,EAAE,SAAS,CAAwB;IAExC,kCAAkC;IAClC,MAAM,SAAmB;IAEzB,wDAAwD;IACxD,qBAAqB,UAAqB;IAE1C,oCAAoC;IACpC,aAAa,SAAkB;gBAoBnB,MAAM,CAAC,EAAE,iBAAiB;IAiCtC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAgEvC;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;OAEG;IACH,MAAM,CAAC,OAAO,UAAgB,GAAG,IAAI;IAQrC;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,CAQhC;IAEF;;OAEG;IACH,OAAO,GAAI,SAAS,wBAAwB,KAAG,UAAU,CAAC,WAAW,CAAC,CAsBpE;IAEF;;OAEG;IACH,OAAO,GAAI,SAAS,wBAAwB,KAAG,UAAU,CAAC,WAAW,CAAC,CA2DpE;CACF"}
+{"version":3,"file":"popover.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/popover.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAGpC,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAC,KAAK,QAAQ,EAAE,KAAK,SAAS,EAA2B,MAAM,uBAAuB,CAAC;AAS9F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IAClE,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,gBAAgB,GAAG;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAC,CAAC;AAElG;;GAEG;AAEH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;CAElE;AAED;;GAEG;AACH,qBAAa,OAAO;;IACnB,gDAAgD;IAChD,OAAO,UAAqB;IAE5B,uDAAuD;IACvD,QAAQ,EAAE,QAAQ,CAAwB;IAE1C,yCAAyC;IACzC,KAAK,EAAE,SAAS,CAAwB;IAExC,kCAAkC;IAClC,MAAM,SAAmB;IAEzB,wDAAwD;IACxD,qBAAqB,UAAqB;IAE1C,oCAAoC;IACpC,aAAa,SAAkB;gBAoBnB,MAAM,CAAC,EAAE,iBAAiB;IAiCtC;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAgEvC;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAWZ;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IAWZ;;;;;OAKG;IACH,MAAM,CAAC,OAAO,UAAgB,GAAG,IAAI;IAQrC;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,CAQhC;IAEF;;OAEG;IACH,OAAO,GAAI,SAAS,wBAAwB,KAAG,UAAU,CAAC,WAAW,CAAC,CAsBpE;IAEF;;OAEG;IACH,OAAO,GAAI,SAAS,wBAAwB,KAAG,UAAU,CAAC,WAAW,CAAC,CA2DpE;CACF"}

package/dist/ui/popover.svelte.js

@@ -107,7 +107,11 @@ export class Popover {
         }
     }
     /**
-     * Updates the popover configuration.
+     * Updates the popover configuration. Swaps `popover_class` on the live
+     * content element when supplied and re-syncs the outside-click handler
+     * if `disable_outside_click` changed.
+     *
+     * @mutates `this`
      */
     update(params) {
         // Store the old class before updating
@@ -166,7 +170,10 @@ export class Popover {
         }
     }
     /**
-     * Shows the popover.
+     * Shows the popover, registering the outside-click handler and updating
+     * `aria-expanded` on the trigger. No-ops when already visible.
+     *
+     * @mutates `this`
      */
     show() {
         if (this.visible)
@@ -178,7 +185,10 @@ export class Popover {
             this.#onshow();
     }
     /**
-     * Hides the popover.
+     * Hides the popover, removing the outside-click handler. No-ops when
+     * already hidden.
+     *
+     * @mutates `this`
      */
     hide() {
         if (!this.visible)
@@ -190,7 +200,10 @@ export class Popover {
             this.#onhide();
     }
     /**
-     * Toggles the popover visibility.
+     * Toggles the popover visibility, or sets it to the given value.
+     *
+     * @param visible - desired visibility (defaults to the inverse of current)
+     * @mutates `this`
      */
     toggle(visible = !this.visible) {
         if (visible) {

package/dist/ui/position_helpers.d.ts

@@ -18,10 +18,8 @@ export type Alignment = 'start' | 'center' | 'end';
 /**
  * Generates CSS positioning styles for UI elements.
  *
- * @param position - where to position the element ('left', 'right', etc.)
- * @param align - alignment along the position edge ('start', 'center', 'end')
  * @param offset - distance from the position (CSS value)
- * @returns CSS styles as a Record
+ * @throws UnreachableError if `position` is not a known `Position` value
  */
 export declare const generate_position_styles: (position?: Position, align?: Alignment, offset?: string) => Record<string, string>;
 //# sourceMappingURL=position_helpers.d.ts.map

package/dist/ui/position_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"position_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/position_helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACpC,WAAU,QAAmB,EAC7B,QAAO,SAAoB,EAC3B,eAAY,KACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAiEvB,CAAC"}
+{"version":3,"file":"position_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/position_helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACpC,WAAU,QAAmB,EAC7B,QAAO,SAAoB,EAC3B,eAAY,KACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAiEvB,CAAC"}

package/dist/ui/position_helpers.js

@@ -7,10 +7,8 @@ import { UnreachableError } from '@fuzdev/fuz_util/error.js';
 /**
  * Generates CSS positioning styles for UI elements.
  *
- * @param position - where to position the element ('left', 'right', etc.)
- * @param align - alignment along the position edge ('start', 'center', 'end')
  * @param offset - distance from the position (CSS value)
- * @returns CSS styles as a Record
+ * @throws UnreachableError if `position` is not a known `Position` value
  */
 export const generate_position_styles = (position = 'center', align = 'center', offset = '0') => {
     const styles = {

package/dist/ui/sidebar_state.svelte.d.ts

@@ -1,16 +1,26 @@
+/**
+ * Reactive sidebar visibility state. Provisioned by `AppShell.svelte` via
+ * `sidebar_state_context`; consumers read `show_sidebar` and call
+ * `toggle_sidebar` / `activate`.
+ *
+ * @module
+ */
+/**
+ * Svelte context carrying a reactive `SidebarState` accessor. Set by
+ * `AppShell.svelte` (creates a fresh `SidebarState` if not supplied);
+ * consumers call `sidebar_state_context.get()` to read or toggle visibility.
+ */
 export declare const sidebar_state_context: {
     get: (error_message?: string) => () => SidebarState;
     get_maybe: () => (() => SidebarState) | undefined;
     set: (value: () => SidebarState) => () => SidebarState;
 };
-/**
- * Options for configuring a `SidebarState`.
- *
- * @param enabled Optional reactive getter that controls whether the sidebar is enabled.
- *                When provided, overrides the internal `enabled` state.
- *                `show_sidebar` automatically returns `false` when `enabled` is `false`.
- */
 export interface SidebarStateOptions {
+    /**
+     * Reactive getter that controls whether the sidebar is enabled. When
+     * supplied, overrides the internal `enabled` state — `show_sidebar`
+     * auto-returns `false` while the getter returns `false`.
+     */
     enabled?: () => boolean;
 }
 export declare class SidebarState {
@@ -22,8 +32,10 @@ export declare class SidebarState {
     constructor(options?: SidebarStateOptions);
     toggle_sidebar(value?: boolean): void;
     /**
-     * Activates the sidebar, showing it and enabling the toggle.
-     * Returns a cleanup function that deactivates.
+     * Show the sidebar and enable the toggle. The returned disposer hides
+     * and disables on cleanup — pair with `$effect` for scoped activation.
+     *
+     * @mutates `this` - sets `enabled` and `show_sidebar`; disposer clears both
      */
     activate(): () => void;
 }

package/dist/ui/sidebar_state.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/sidebar_state.svelte.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB;2CAAwB,YAAY;4BAAZ,YAAY;uBAAZ,YAAY,WAAZ,YAAY;CAAG,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IACnC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CACxB;AAED,qBAAa,YAAY;;IAKxB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzB;IAED,IAAI,YAAY,IAAI,OAAO,CAG1B;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;gBAEW,OAAO,CAAC,EAAE,mBAAmB;IAIzC,cAAc,CAAC,KAAK,GAAE,OAA4B,GAAG,IAAI;IAIzD;;;OAGG;IACH,QAAQ,IAAI,MAAM,IAAI;CAQtB"}
+{"version":3,"file":"sidebar_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/sidebar_state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;2CAAwB,YAAY;4BAAZ,YAAY;uBAAZ,YAAY,WAAZ,YAAY;CAAG,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CACxB;AAED,qBAAa,YAAY;;IAKxB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzB;IAED,IAAI,YAAY,IAAI,OAAO,CAG1B;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;gBAEW,OAAO,CAAC,EAAE,mBAAmB;IAIzC,cAAc,CAAC,KAAK,GAAE,OAA4B,GAAG,IAAI;IAIzD;;;;;OAKG;IACH,QAAQ,IAAI,MAAM,IAAI;CAQtB"}

package/dist/ui/sidebar_state.svelte.js

@@ -1,4 +1,16 @@
+/**
+ * Reactive sidebar visibility state. Provisioned by `AppShell.svelte` via
+ * `sidebar_state_context`; consumers read `show_sidebar` and call
+ * `toggle_sidebar` / `activate`.
+ *
+ * @module
+ */
 import { create_context } from '@fuzdev/fuz_ui/context_helpers.js';
+/**
+ * Svelte context carrying a reactive `SidebarState` accessor. Set by
+ * `AppShell.svelte` (creates a fresh `SidebarState` if not supplied);
+ * consumers call `sidebar_state_context.get()` to read or toggle visibility.
+ */
 export const sidebar_state_context = create_context();
 export class SidebarState {
     #get_enabled;
@@ -25,8 +37,10 @@ export class SidebarState {
         this.show_sidebar = value;
     }
     /**
-     * Activates the sidebar, showing it and enabling the toggle.
-     * Returns a cleanup function that deactivates.
+     * Show the sidebar and enable the toggle. The returned disposer hides
+     * and disables on cleanup — pair with `$effect` for scoped activation.
+     *
+     * @mutates `this` - sets `enabled` and `show_sidebar`; disposer clears both
      */
     activate() {
         this.enabled = true;

package/dist/ui/table_state.svelte.d.ts

@@ -55,9 +55,23 @@ export declare class TableState extends Loadable {
     readonly showing_end: number;
     readonly has_prev: boolean;
     readonly has_next: boolean;
+    /**
+     * Fetch a page of rows for `table_name` from `GET /api/db/tables/{table_name}`.
+     * `limit` is clamped to `[1, TABLE_LIMIT_MAX]`.
+     *
+     * @mutates `this`
+     */
     fetch(table_name: string, offset?: number, limit?: number): Promise<void>;
     go_prev(): void;
     go_next(): void;
+    /**
+     * Delete a row by its primary key via `DELETE /api/db/tables/{table_name}/rows/{pk}`.
+     * Optimistically drops it from `rows` and decrements `total` on success;
+     * surfaces server errors on `delete_error`.
+     *
+     * @returns `true` when the row was removed; `false` on missing primary key or server error
+     * @mutates `this`
+     */
     delete_row(row: Record<string, unknown>): Promise<boolean>;
 }
 //# sourceMappingURL=table_state.svelte.d.ts.map

package/dist/ui/table_state.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/table_state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAG9C,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAErD,mEAAmE;AACnE,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,qBAAa,UAAW,SAAQ,QAAQ;IACvC,UAAU,EAAE,MAAM,CAAkB;IACpC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,CAAkB;IAC5C,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAkB;IACtD,KAAK,SAAiB;IACtB,MAAM,SAAiB;IACvB,KAAK,SAAmB;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAoB;IAC9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAoB;IAC3C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAoB;IAG/C,QAAQ,CAAC,aAAa,SAAoD;IAC1E,QAAQ,CAAC,WAAW,SAAkE;IACtF,QAAQ,CAAC,QAAQ,UAA6B;IAC9C,QAAQ,CAAC,QAAQ,UAAmD;IAE9D,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvE,OAAO,IAAI,IAAI;IAIf,OAAO,IAAI,IAAI;IAIT,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAoChE"}
+{"version":3,"file":"table_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/table_state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAG9C,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAErD,mEAAmE;AACnE,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,qBAAa,UAAW,SAAQ,QAAQ;IACvC,UAAU,EAAE,MAAM,CAAkB;IACpC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,CAAkB;IAC5C,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAkB;IACtD,KAAK,SAAiB;IACtB,MAAM,SAAiB;IACvB,KAAK,SAAmB;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAoB;IAC9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAoB;IAC3C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAoB;IAG/C,QAAQ,CAAC,aAAa,SAAoD;IAC1E,QAAQ,CAAC,WAAW,SAAkE;IACtF,QAAQ,CAAC,QAAQ,UAA6B;IAC9C,QAAQ,CAAC,QAAQ,UAAmD;IAEpE;;;;;OAKG;IACG,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvE,OAAO,IAAI,IAAI;IAIf,OAAO,IAAI,IAAI;IAIf;;;;;;;OAOG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAoChE"}

package/dist/ui/table_state.svelte.js

@@ -57,6 +57,12 @@ export class TableState extends Loadable {
     showing_end = $derived(Math.min(this.offset + this.rows.length, this.total));
     has_prev = $derived(this.offset > 0);
     has_next = $derived(this.offset + this.limit < this.total);
+    /**
+     * Fetch a page of rows for `table_name` from `GET /api/db/tables/{table_name}`.
+     * `limit` is clamped to `[1, TABLE_LIMIT_MAX]`.
+     *
+     * @mutates `this`
+     */
     async fetch(table_name, offset = 0, limit = 100) {
         this.table_name = table_name;
         this.offset = offset;
@@ -79,6 +85,14 @@ export class TableState extends Loadable {
     go_next() {
         this.offset += this.limit;
     }
+    /**
+     * Delete a row by its primary key via `DELETE /api/db/tables/{table_name}/rows/{pk}`.
+     * Optimistically drops it from `rows` and decrements `total` on success;
+     * surfaces server errors on `delete_error`.
+     *
+     * @returns `true` when the row was removed; `false` on missing primary key or server error
+     * @mutates `this`
+     */
     async delete_row(row) {
         if (!this.primary_key)
             return false;

package/dist/ui/ui_fetch.d.ts

@@ -9,10 +9,6 @@
  */
 /**
  * Fetch with credentials included (sends cookies).
- *
- * @param input - the request URL or Request object
- * @param init - optional fetch init options
- * @returns fetch response promise
  */
 export declare const ui_fetch: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 /**
@@ -21,9 +17,7 @@ export declare const ui_fetch: (input: RequestInfo | URL, init?: RequestInit) =>
  * Handles responses with non-JSON bodies (e.g. HTML 404 pages)
  * that would throw on `response.json()`.
  *
- * @param response - the non-ok response
- * @param fallback - fallback message when no `.error` field is found
- * @returns error message string
+ * @param fallback - message when no `.error` field is found
  */
 export declare const parse_response_error: (response: Response, fallback?: string) => Promise<string>;
 //# sourceMappingURL=ui_fetch.d.ts.map

package/dist/ui/ui_fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui_fetch.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/ui_fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,WAAW,GAAG,GAAG,EAAE,OAAO,WAAW,KAAG,OAAO,CAAC,QAAQ,CACxC,CAAC;AAEjD;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAChC,UAAU,QAAQ,EAClB,WAAW,MAAM,KACf,OAAO,CAAC,MAAM,CAQhB,CAAC"}
+{"version":3,"file":"ui_fetch.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/ui_fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,WAAW,GAAG,GAAG,EAAE,OAAO,WAAW,KAAG,OAAO,CAAC,QAAQ,CACxC,CAAC;AAEjD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAChC,UAAU,QAAQ,EAClB,WAAW,MAAM,KACf,OAAO,CAAC,MAAM,CAQhB,CAAC"}

package/dist/ui/ui_fetch.js

@@ -9,10 +9,6 @@
  */
 /**
  * Fetch with credentials included (sends cookies).
- *
- * @param input - the request URL or Request object
- * @param init - optional fetch init options
- * @returns fetch response promise
  */
 export const ui_fetch = (input, init) => fetch(input, { ...init, credentials: 'include' });
 /**
@@ -21,9 +17,7 @@ export const ui_fetch = (input, init) => fetch(input, { ...init, credentials: 'i
  * Handles responses with non-JSON bodies (e.g. HTML 404 pages)
  * that would throw on `response.json()`.
  *
- * @param response - the non-ok response
- * @param fallback - fallback message when no `.error` field is found
- * @returns error message string
+ * @param fallback - message when no `.error` field is found
  */
 export const parse_response_error = async (response, fallback) => {
     const default_message = fallback ?? `Error: ${response.status}`;

package/dist/ui/ui_format.d.ts

@@ -9,54 +9,42 @@
 /**
  * Format a timestamp as a relative time string.
  *
- * @param timestamp - a date value (`string`, `number`, or `Date`)
- * @param now - reference time in ms since epoch, defaults to `Date.now()`
  * @returns human-friendly relative time (e.g. "2m ago", "3h ago", "5d ago", "2mo ago", "1y ago")
  */
 export declare const format_relative_time: (timestamp: string | number | Date, now?: number) => string;
 /**
  * Format milliseconds as a human-friendly uptime string.
  *
- * @param ms - duration in milliseconds
  * @returns human-friendly duration (e.g. "45s", "12m", "3h 15m", "2d 5h")
  */
 export declare const format_uptime: (ms: number) => string;
 /**
  * Truncate a string by keeping the start and end, with a separator in the middle.
  *
- * @param str - the string to truncate
- * @param max_length - maximum total length including separator
- * @param separator - the middle separator
+ * @param max_length - total length including separator
  * @returns the truncated string, or the original if it fits
  */
 export declare const truncate_middle: (str: string, max_length: number, separator?: string) => string;
 /**
  * Truncate a UUID for display, keeping start and end visible.
  *
- * @param uuid - the UUID string to truncate
  * @returns a 12-character truncated UUID like `a1b2c…7890`
  */
 export declare const truncate_uuid: (uuid: string) => string;
 /**
  * Format an arbitrary value for table cell display.
- *
- * @param value - the value to format
- * @returns string representation suitable for UI display
  */
 export declare const format_value: (value: unknown) => string;
 /**
  * Format a timestamp as an absolute datetime string for title attributes.
  *
- * @param timestamp - a date value
  * @returns readable absolute datetime like `"2026-03-21 14:30:00 UTC"`
  */
 export declare const format_datetime_local: (timestamp: string | number | Date) => string;
 /**
  * Format audit event metadata for display based on event type.
  *
- * @param event_type - the audit event type (builtin or consumer-registered)
- * @param metadata - the metadata object (may be null)
- * @returns human-readable summary string
+ * @param event_type - builtin or consumer-registered audit event type
  */
 export declare const format_audit_metadata: (event_type: string, metadata: Record<string, unknown> | null) => string;
 //# sourceMappingURL=ui_format.d.ts.map

package/dist/ui/ui_format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui_format.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/ui_format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAChC,WAAW,MAAM,GAAG,MAAM,GAAG,IAAI,EACjC,MAAK,MAAmB,KACtB,MA2BF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,IAAI,MAAM,KAAG,MAY1C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,YAAY,MAAM,EAAE,kBAAe,KAAG,MAOlF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAmC,CAAC;AAEjF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAS7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,WAAW,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,MAOzE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GACjC,YAAY,MAAM,EAClB,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,KACtC,MAuDF,CAAC"}
+{"version":3,"file":"ui_format.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/ui_format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAChC,WAAW,MAAM,GAAG,MAAM,GAAG,IAAI,EACjC,MAAK,MAAmB,KACtB,MA2BF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,IAAI,MAAM,KAAG,MAY1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,YAAY,MAAM,EAAE,kBAAe,KAAG,MAOlF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAmC,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAS7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,WAAW,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,MAOzE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GACjC,YAAY,MAAM,EAClB,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,KACtC,MAuDF,CAAC"}

package/dist/ui/ui_format.js

@@ -9,8 +9,6 @@
 /**
  * Format a timestamp as a relative time string.
  *
- * @param timestamp - a date value (`string`, `number`, or `Date`)
- * @param now - reference time in ms since epoch, defaults to `Date.now()`
  * @returns human-friendly relative time (e.g. "2m ago", "3h ago", "5d ago", "2mo ago", "1y ago")
  */
 export const format_relative_time = (timestamp, now = Date.now()) => {
@@ -49,7 +47,6 @@ export const format_relative_time = (timestamp, now = Date.now()) => {
 /**
  * Format milliseconds as a human-friendly uptime string.
  *
- * @param ms - duration in milliseconds
  * @returns human-friendly duration (e.g. "45s", "12m", "3h 15m", "2d 5h")
  */
 export const format_uptime = (ms) => {
@@ -72,9 +69,7 @@ export const format_uptime = (ms) => {
 /**
  * Truncate a string by keeping the start and end, with a separator in the middle.
  *
- * @param str - the string to truncate
- * @param max_length - maximum total length including separator
- * @param separator - the middle separator
+ * @param max_length - total length including separator
  * @returns the truncated string, or the original if it fits
  */
 export const truncate_middle = (str, max_length, separator = '…') => {
@@ -90,15 +85,11 @@ export const truncate_middle = (str, max_length, separator = '…') => {
 /**
  * Truncate a UUID for display, keeping start and end visible.
  *
- * @param uuid - the UUID string to truncate
  * @returns a 12-character truncated UUID like `a1b2c…7890`
  */
 export const truncate_uuid = (uuid) => truncate_middle(uuid, 12);
 /**
  * Format an arbitrary value for table cell display.
- *
- * @param value - the value to format
- * @returns string representation suitable for UI display
  */
 export const format_value = (value) => {
     if (value === null)
@@ -118,7 +109,6 @@ export const format_value = (value) => {
 /**
  * Format a timestamp as an absolute datetime string for title attributes.
  *
- * @param timestamp - a date value
  * @returns readable absolute datetime like `"2026-03-21 14:30:00 UTC"`
  */
 export const format_datetime_local = (timestamp) => {
@@ -133,9 +123,7 @@ export const format_datetime_local = (timestamp) => {
 /**
  * Format audit event metadata for display based on event type.
  *
- * @param event_type - the audit event type (builtin or consumer-registered)
- * @param metadata - the metadata object (may be null)
- * @returns human-readable summary string
+ * @param event_type - builtin or consumer-registered audit event type
  */
 export const format_audit_metadata = (event_type, metadata) => {
     if (!metadata)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_app",
-  "version": "0.51.0",
+  "version": "0.53.0",
   "description": "fullstack app library",
   "glyph": "🗝",
   "logo": "logo.svg",
@@ -45,7 +45,7 @@
     "@fuzdev/blake3_wasm": "^0.1.0",
     "@fuzdev/fuz_code": "^0.45.1",
     "@fuzdev/fuz_css": "^0.59.0",
-    "@fuzdev/fuz_ui": "^0.191.4",
+    "@fuzdev/fuz_ui": "^0.192.0",
     "@fuzdev/fuz_util": "^0.59.0",
     "@fuzdev/gro": "^0.199.0",
     "@jridgewell/trace-mapping": "^0.3.31",