@fuzdev/fuz_app 0.50.0 → 0.52.0

package/dist/ui/audit_log_state.svelte.js

@@ -68,6 +68,7 @@ export class AuditLogState extends Loadable {
      * transient errors; `since_seq` fills gaps on reconnection.
      *
      * @returns cleanup function that closes the connection
+     * @mutates `this`
      */
     subscribe() {
         this.disconnect();
@@ -109,7 +110,11 @@ export class AuditLogState extends Loadable {
         };
         return () => this.disconnect();
     }
-    /** Close the SSE connection. */
+    /**
+     * Close the SSE connection.
+     *
+     * @mutates `this`
+     */
     disconnect() {
         if (this.#event_source) {
             this.#event_source.close();

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

@@ -58,28 +58,40 @@ export declare class AuthState {
      * Fetches `GET /api/account/status` — returns account info (200) or
      * 401 with optional `bootstrap_available` flag.
      * Called on init, and after login/bootstrap to refresh state.
+     *
+     * @mutates `this`
      */
     check_session(): Promise<void>;
     /**
-     * Log in with username and password.
+     * Log in with username and password. Translates 401 / 429 to friendly
+     * messages on `verify_error`; refreshes the session via `check_session`
+     * on success.
      *
      * @returns `true` if login succeeded, `false` otherwise
+     * @mutates `this`
      */
     login(username: string, password: string): Promise<boolean>;
     /**
-     * Bootstrap the first keeper account.
+     * Bootstrap the first keeper account using a single-use token.
      *
      * @returns `true` if bootstrap succeeded, `false` otherwise
+     * @mutates `this`
      */
     bootstrap(token: string, username: string, password: string): Promise<boolean>;
     /**
-     * Sign up with an invite.
+     * Sign up via invite (or open signup, when `app_settings.open_signup`
+     * is true server-side). Translates 403 / 409 / 429 to friendly messages
+     * on `verify_error`.
      *
      * @returns `true` if signup succeeded, `false` otherwise
+     * @mutates `this`
      */
     signup(username: string, password: string, email?: string): Promise<boolean>;
     /**
-     * Log out by clearing the session cookie.
+     * Log out — best-effort `POST /api/account/logout` to clear the session
+     * cookie, then clears local state regardless of the network outcome.
+     *
+     * @mutates `this`
      */
     logout(): Promise<void>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"auth_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/auth_state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,EACN,KAAK,gBAAgB,EAErB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;CAA8B,CAAC;AAE9D,qBAAa,SAAS;IACrB,SAAS,UAAqB;IAC9B,QAAQ,UAAqB;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAoB;IAC/C,OAAO,EAAE,cAAc,GAAG,IAAI,CAAoB;IAClD,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAoB;IAClD,OAAO,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAkB;IACnD,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAE/C;IACF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAoD;IAEjF,gEAAgE;IAChE,eAAe,UAAqB;IAEpC;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BpC;;;;OAIG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwCjE;;;;OAIG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiCpF;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4ClF;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}
+{"version":3,"file":"auth_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/auth_state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,EACN,KAAK,gBAAgB,EAErB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;CAA8B,CAAC;AAE9D,qBAAa,SAAS;IACrB,SAAS,UAAqB;IAC9B,QAAQ,UAAqB;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAoB;IAC/C,OAAO,EAAE,cAAc,GAAG,IAAI,CAAoB;IAClD,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAoB;IAClD,OAAO,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAkB;IACnD,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAE/C;IACF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAoD;IAEjF,gEAAgE;IAChE,eAAe,UAAqB;IAEpC;;;;;;;;OAQG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BpC;;;;;;;OAOG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwCjE;;;;;OAKG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiCpF;;;;;;;OAOG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4ClF;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}

package/dist/ui/auth_state.svelte.js

@@ -56,6 +56,8 @@ export class AuthState {
      * Fetches `GET /api/account/status` — returns account info (200) or
      * 401 with optional `bootstrap_available` flag.
      * Called on init, and after login/bootstrap to refresh state.
+     *
+     * @mutates `this`
      */
     async check_session() {
         this.verifying = true;
@@ -90,9 +92,12 @@ export class AuthState {
         }
     }
     /**
-     * Log in with username and password.
+     * Log in with username and password. Translates 401 / 429 to friendly
+     * messages on `verify_error`; refreshes the session via `check_session`
+     * on success.
      *
      * @returns `true` if login succeeded, `false` otherwise
+     * @mutates `this`
      */
     async login(username, password) {
         this.verifying = true;
@@ -136,9 +141,10 @@ export class AuthState {
         }
     }
     /**
-     * Bootstrap the first keeper account.
+     * Bootstrap the first keeper account using a single-use token.
      *
      * @returns `true` if bootstrap succeeded, `false` otherwise
+     * @mutates `this`
      */
     async bootstrap(token, username, password) {
         this.verifying = true;
@@ -173,9 +179,12 @@ export class AuthState {
         }
     }
     /**
-     * Sign up with an invite.
+     * Sign up via invite (or open signup, when `app_settings.open_signup`
+     * is true server-side). Translates 403 / 409 / 429 to friendly messages
+     * on `verify_error`.
      *
      * @returns `true` if signup succeeded, `false` otherwise
+     * @mutates `this`
      */
     async signup(username, password, email) {
         this.verifying = true;
@@ -224,7 +233,10 @@ export class AuthState {
         }
     }
     /**
-     * Log out by clearing the session cookie.
+     * Log out — best-effort `POST /api/account/logout` to clear the session
+     * cookie, then clears local state regardless of the network outcome.
+     *
+     * @mutates `this`
      */
     async logout() {
         try {

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

@@ -52,6 +52,9 @@ export declare class FormState {
      * focusable elements and tracks field touched state via delegated `focusout`.
      *
      * Fields are identified by their `name` attribute.
+     *
+     * @throws Error in DEV when called while already attached, or when an
+     *   input loses focus without a `name` attribute
      */
     form(): Attachment<HTMLFormElement>;
     /**
@@ -65,6 +68,8 @@ export declare class FormState {
     show(field: string): boolean;
     /**
      * Programmatically marks a field as touched without requiring a blur event.
+     *
+     * @mutates `this`
      */
     touch(field: string): void;
     /**
@@ -73,10 +78,14 @@ export declare class FormState {
     focus(field: string): void;
     /**
      * Marks the form as having been submitted, causing all field errors to show.
+     *
+     * @mutates `this`
      */
     attempt(): void;
     /**
      * Resets all touched and attempted state.
+     *
+     * @mutates `this`
      */
     reset(): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"form_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/form_state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,oBAAoB,CAAC;AASnD,qBAAa,SAAS;;IAKrB;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;;OAKG;IACH,IAAI,IAAI,UAAU,CAAC,eAAe,CAAC;IAuCnC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAe1B;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,KAAK,IAAI,IAAI;CAIb"}
+{"version":3,"file":"form_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/form_state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,oBAAoB,CAAC;AASnD,qBAAa,SAAS;;IAKrB;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI,UAAU,CAAC,eAAe,CAAC;IAuCnC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI5B;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAe1B;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAIf;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAIb"}

package/dist/ui/form_state.svelte.js

@@ -60,6 +60,9 @@ export class FormState {
      * focusable elements and tracks field touched state via delegated `focusout`.
      *
      * Fields are identified by their `name` attribute.
+     *
+     * @throws Error in DEV when called while already attached, or when an
+     *   input loses focus without a `name` attribute
      */
     form() {
         if (DEV && this.#form) {
@@ -113,6 +116,8 @@ export class FormState {
     }
     /**
      * Programmatically marks a field as touched without requiring a blur event.
+     *
+     * @mutates `this`
      */
     touch(field) {
         this.#touched.add(field);
@@ -134,12 +139,16 @@ export class FormState {
     }
     /**
      * Marks the form as having been submitted, causing all field errors to show.
+     *
+     * @mutates `this`
      */
     attempt() {
         this.#attempted = true;
     }
     /**
      * Resets all touched and attempted state.
+     *
+     * @mutates `this`
      */
     reset() {
         this.#touched.clear();

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

@@ -47,9 +47,14 @@ export declare class Loadable<TError = string> {
      * Pass `map_error` to produce structured errors instead of strings.
      *
      * @returns the result or `undefined` if the operation failed
+     * @mutates `this`
      */
     protected run<T>(fn: () => Promise<T>, map_error?: (e: unknown) => TError): Promise<T | undefined>;
-    /** Reset loading and error state. Subclasses override to clear data. */
+    /**
+     * Reset loading and error state. Subclasses override to clear data.
+     *
+     * @mutates `this`
+     */
     reset(): void;
 }
 //# sourceMappingURL=loadable.svelte.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"loadable.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/loadable.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,qBAAa,QAAQ,CAAC,MAAM,GAAG,MAAM;IACpC,OAAO,UAAqB;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAoB;IAExC,sFAAsF;IACtF,UAAU,EAAE,OAAO,CAAoB;IAEvC;;;;;;;OAOG;cACa,GAAG,CAAC,CAAC,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,GAChC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAiBzB,wEAAwE;IACxE,KAAK,IAAI,IAAI;CAKb"}
+{"version":3,"file":"loadable.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/loadable.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,qBAAa,QAAQ,CAAC,MAAM,GAAG,MAAM;IACpC,OAAO,UAAqB;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAoB;IAExC,sFAAsF;IACtF,UAAU,EAAE,OAAO,CAAoB;IAEvC;;;;;;;;OAQG;cACa,GAAG,CAAC,CAAC,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,GAChC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAiBzB;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAKb"}

package/dist/ui/loadable.svelte.js

@@ -47,6 +47,7 @@ export class Loadable {
      * Pass `map_error` to produce structured errors instead of strings.
      *
      * @returns the result or `undefined` if the operation failed
+     * @mutates `this`
      */
     async run(fn, map_error) {
         this.loading = true;
@@ -66,7 +67,11 @@ export class Loadable {
             this.loading = false;
         }
     }
-    /** Reset loading and error state. Subclasses override to clear data. */
+    /**
+     * Reset loading and error state. Subclasses override to clear data.
+     *
+     * @mutates `this`
+     */
     reset() {
         this.loading = false;
         this.error = null;

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

@@ -117,6 +117,8 @@ export declare class PermitOffersState extends Loadable {
      * Reduce a single WS notification into the cache. Exposed so consumers
      * wiring their WS receiver directly (without `subscribe`) and tests can
      * drive the reducer without allocating a subscription.
+     *
+     * @mutates `this`
      */
     apply_notification(notification: PermitOfferNotification): void;
     /** Clear the cache and reset loading/error state. */

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

@@ -1 +1 @@
-{"version":3,"file":"permit_offers_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/permit_offers_state.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"permit_offers_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/permit_offers_state.svelte.ts"],"names":[],"mappings":"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"}

package/dist/ui/permit_offers_state.svelte.js

@@ -144,6 +144,8 @@ export class PermitOffersState extends Loadable {
      * Reduce a single WS notification into the cache. Exposed so consumers
      * wiring their WS receiver directly (without `subscribe`) and tests can
      * drive the reducer without allocating a subscription.
+     *
+     * @mutates `this`
      */
     apply_notification(notification) {
         switch (notification.method) {

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

@@ -22,6 +22,7 @@ export type Alignment = 'start' | 'center' | 'end';
  * @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;;;;;;;;GAQG;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

@@ -11,6 +11,7 @@ import { UnreachableError } from '@fuzdev/fuz_util/error.js';
  * @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,11 @@ 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.
+     *
+     * @returns cleanup function that deactivates and hides the sidebar
+     * @mutates `this`
      */
     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;;;;;;OAMG;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,11 @@ 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.
+     *
+     * @returns cleanup function that deactivates and hides the sidebar
+     * @mutates `this`
      */
     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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_app",
-  "version": "0.50.0",
+  "version": "0.52.0",
   "description": "fullstack app library",
   "glyph": "🗝",
   "logo": "logo.svg",