@fuzdev/fuz_app 0.52.0 → 0.53.0

package/dist/testing/surface_invariants.d.ts

@@ -85,7 +85,6 @@ export interface ErrorSchemaAuditEntry {
  * (`z.string()`) vs specific `z.literal()` or `z.enum()` error codes.
  * Use the output to prioritize progressive tightening of error schemas.
  *
- * @param surface - the app surface to audit
  * @returns audit entries for every route x status combination
  */
 export declare const audit_error_schema_tightness: (surface: AppSurface) => Array<ErrorSchemaAuditEntry>;
@@ -199,8 +198,6 @@ export declare const DEFAULT_ERROR_SCHEMA_TIGHTNESS: ErrorSchemaTightnessOptions
  * the configured threshold. Use `allowlist` and `ignore_statuses` to exclude
  * known exceptions during progressive tightening.
  *
- * @param surface - the app surface to check
- * @param options - threshold and exclusion configuration
  * @throws AssertionError listing every route × status combination whose error
  *   schema specificity is below `min_specificity` (default `'enum'`) and is
  *   not in `allowlist` or `ignore_statuses`.

package/dist/testing/surface_invariants.d.ts.map

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

package/dist/testing/surface_invariants.js

@@ -278,7 +278,6 @@ const extract_error_codes = (schema) => {
  * (`z.string()`) vs specific `z.literal()` or `z.enum()` error codes.
  * Use the output to prioritize progressive tightening of error schemas.
  *
- * @param surface - the app surface to audit
  * @returns audit entries for every route x status combination
  */
 export const audit_error_schema_tightness = (surface) => {
@@ -423,8 +422,6 @@ export const DEFAULT_ERROR_SCHEMA_TIGHTNESS = {
  * the configured threshold. Use `allowlist` and `ignore_statuses` to exclude
  * known exceptions during progressive tightening.
  *
- * @param surface - the app surface to check
- * @param options - threshold and exclusion configuration
  * @throws AssertionError listing every route × status combination whose error
  *   schema specificity is below `min_specificity` (default `'enum'`) and is
  *   not in `allowlist` or `ignore_statuses`.

package/dist/ui/CLAUDE.md

@@ -238,7 +238,7 @@ destructive actions.
     `connected`. Internal `#last_seq` for SSE gap fill on reconnect.
     Methods: `fetch(options?)` (RPC), `fetch_permit_history`,
     `subscribe()` (opens `EventSource` at `#stream_url`, default
-    `/api/admin/audit-log/stream`; prepends new events; refills gap
+    `/api/admin/audit/stream`; prepends new events; refills gap
     via `since_seq`), `disconnect()`. SSE stays on `EventSource` —
     streaming is not an RPC concern.
 - `admin_accounts_state.svelte.ts` — `AdminAccountsState` extends

package/dist/ui/audit_log_state.svelte.js

@@ -32,7 +32,7 @@ export class AuditLogState extends Loadable {
     constructor(options) {
         super();
         this.#get_rpc = options?.get_rpc ?? (() => null);
-        this.#stream_url = options?.stream_url ?? '/api/admin/audit-log/stream';
+        this.#stream_url = options?.stream_url ?? '/api/admin/audit/stream';
     }
     /** True when an RPC adapter is wired. `fetch`/`fetch_permit_history` no-op without it. */
     get has_rpc() {

package/dist/ui/position_helpers.d.ts

@@ -18,10 +18,7 @@ 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>;

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;;;;;;;;GAQG;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,7 @@ 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') => {

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

@@ -35,8 +35,7 @@ export declare class SidebarState {
      * 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`
+     * @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":"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"}
+{"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

@@ -40,8 +40,7 @@ export class SidebarState {
      * 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`
+     * @mutates `this` - sets `enabled` and `show_sidebar`; disposer clears both
      */
     activate() {
         this.enabled = true;

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.52.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",