@fuzdev/fuz_ui 0.191.4 → 0.192.0

package/dist/csp_of_fuzdev.js

@@ -1,9 +1,25 @@
 /**
- * Trusted sources owned by fuz.dev.
+ * Per-directive sources that allow full interop between fuzdev/sister sites
+ * (`*.fuz.dev`, `*.zzz.software`) — loading assets and APIs from each other,
+ * and iframing in both directions.
+ *
+ * Pass into `create_csp_directives({extend: [csp_directives_of_fuzdev]})`.
+ * Intended for sites within the ecosystem; external apps usually want a
+ * narrower, hand-written allow-list.
+ *
+ * Deliberately scoped — `script-src`, `style-src`, `worker-src`, etc. are not
+ * granted, even between sister sites. Add at the call site if a specific page
+ * needs them.
  */
-export const csp_trusted_sources_of_fuzdev = [
-    { source: 'https://*.fuz.dev/', trust: 'low' },
-    { source: 'https://*.zzz.software/', trust: 'low' },
-    // if needed
-    // {source: 'https://fuzdev.github.io/', trust: 'low'},
-];
+export const csp_directives_of_fuzdev = {
+    'img-src': ['https://*.fuz.dev/', 'https://*.zzz.software/'],
+    'media-src': ['https://*.fuz.dev/', 'https://*.zzz.software/'],
+    'font-src': ['https://*.fuz.dev/', 'https://*.zzz.software/'],
+    'connect-src': ['https://*.fuz.dev/', 'https://*.zzz.software/'],
+    'frame-src': ['https://*.fuz.dev/', 'https://*.zzz.software/'],
+    'frame-ancestors': ['https://*.fuz.dev/', 'https://*.zzz.software/'],
+    // `child-src` is intentionally omitted — it defaults to `['none']`, and `extend` cannot
+    // append to a `'none'`-valued directive. Including it here would break the common
+    // `create_csp_directives({extend: [csp_directives_of_fuzdev]})` call. `frame-src` is its
+    // fallback target anyway, so direct opt-in via `frame-src` is the supported path.
+};

package/dist/dimensions.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dimensions.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dimensions.svelte.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACtB,KAAK,EAAE,MAAM,CAAa;IAC1B,MAAM,EAAE,MAAM,CAAa;CAC3B"}
+{"version":3,"file":"dimensions.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dimensions.svelte.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACtB,KAAK,EAAE,MAAM,CAAiB;IAC9B,MAAM,EAAE,MAAM,CAAiB;CAC/B"}

package/dist/dimensions.svelte.js

@@ -1,4 +1,4 @@
 export class Dimensions {
-    width = $state(0);
-    height = $state(0);
+    width = $state.raw(0);
+    height = $state.raw(0);
 }

package/dist/library.svelte.d.ts

@@ -25,7 +25,7 @@ export declare class Library {
     readonly package_json: {
         [x: string]: unknown;
         name: string;
-        version: string;
+        version?: string | undefined;
         private?: boolean | undefined;
         description?: string | undefined;
         tagline?: string | undefined;

package/dist/library_generate.js

@@ -81,7 +81,7 @@ export const library_generate = (input) => {
     // Phase 1: Analyze all modules and collect re-exports
     const source_json = {
         name: package_json.name,
-        version: package_json.version,
+        version: package_json.version || '',
         modules,
     };
     // Collect re-exports for phase 2 merging

package/dist/style_variable_helpers.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"style_variable_helpers.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/style_variable_helpers.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,6BAA6B,CAAC;AAK/D,qBAAa,qBAAqB;IACjC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAa;gBAE5B,OAAO,GAAE,aAAa,GAAG,IAAW;CAGhD;AAED,eAAO,MAAM,yBAAyB;;;CAAwD,CAAC"}
+{"version":3,"file":"style_variable_helpers.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/style_variable_helpers.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,6BAA6B,CAAC;AAK/D,qBAAa,qBAAqB;IACjC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAiB;gBAEhC,OAAO,GAAE,aAAa,GAAG,IAAW;CAGhD;AAED,eAAO,MAAM,yBAAyB;;;CAAwD,CAAC"}

package/dist/style_variable_helpers.svelte.js

@@ -1,7 +1,7 @@
 import { create_context } from './context_helpers.js';
 // TODO maybe change this to a generic wrapper class for any value?
 export class SelectedStyleVariable {
-    value = $state();
+    value = $state.raw();
     constructor(initial = null) {
         this.value = initial;
     }

package/dist/theme_state.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/theme_state.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,KAAK,EAAC,MAAM,0BAA0B,CAAC;AAOrF,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAExD,qBAAa,UAAU;IACtB,KAAK,EAAE,KAAK,CAAa;IACzB,YAAY,EAAE,WAAW,CAAa;gBAE1B,OAAO,CAAC,EAAE,iBAAiB;IAUvC,MAAM,IAAI,cAAc;CAMxB;AACD,eAAO,MAAM,mBAAmB;2CAAwB,UAAU;4BAAV,UAAU;uBAAV,UAAU,WAAV,UAAU;CAAG,CAAC;AAEtE,eAAO,MAAM,iBAAiB,GAAI,cAAc,WAAW,GAAG,IAAI,KAAG,IAOpE,CAAC;AAEF,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAC3D,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,eAAO,MAAM,iBAAiB,GAC7B,cAAc,WAAW,GAAG,IAAI,EAChC,YAA8B,KAC5B,IAEF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC7B,WAAU,WAAoB,EAC9B,YAA8B,KAC5B,WAA4E,CAAC;AAEhF,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,GAAG,IAAI,EAAE,YAAuB,KAAG,IAEzE,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,WAAU,KAA0B,EAAE,YAAuB,KAAG,KAC3C,CAAC"}
+{"version":3,"file":"theme_state.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/theme_state.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,KAAK,EAAC,MAAM,0BAA0B,CAAC;AAOrF,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAExD,qBAAa,UAAU;IACtB,KAAK,EAAE,KAAK,CAAiB;IAC7B,YAAY,EAAE,WAAW,CAAiB;gBAE9B,OAAO,CAAC,EAAE,iBAAiB;IAUvC,MAAM,IAAI,cAAc;CAMxB;AACD,eAAO,MAAM,mBAAmB;2CAAwB,UAAU;4BAAV,UAAU;uBAAV,UAAU,WAAV,UAAU;CAAG,CAAC;AAEtE,eAAO,MAAM,iBAAiB,GAAI,cAAc,WAAW,GAAG,IAAI,KAAG,IAOpE,CAAC;AAEF,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAC3D,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,eAAO,MAAM,iBAAiB,GAC7B,cAAc,WAAW,GAAG,IAAI,EAChC,YAA8B,KAC5B,IAEF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC7B,WAAU,WAAoB,EAC9B,YAA8B,KAC5B,WAA4E,CAAC;AAEhF,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,GAAG,IAAI,EAAE,YAAuB,KAAG,IAEzE,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,WAAU,KAA0B,EAAE,YAAuB,KAAG,KAC3C,CAAC"}

package/dist/theme_state.svelte.js

@@ -4,8 +4,8 @@ import { BROWSER } from 'esm-env';
 import { create_context } from './context_helpers.js';
 import { load_from_storage, save_to_storage } from './storage.js';
 export class ThemeState {
-    theme = $state();
-    color_scheme = $state();
+    theme = $state.raw();
+    color_scheme = $state.raw();
     constructor(options) {
         const theme = options?.theme ?? default_themes[0];
         const color_scheme = options?.color_scheme ?? 'auto';

package/dist/tsdoc_helpers.d.ts

@@ -98,6 +98,15 @@ export declare const tsdoc_parse: (node: ts.Node, source_file: ts.SourceFile) =>
  * @mutates declaration - adds doc_comment, deprecated_message, examples, see_also, throws, since fields
  */
 export declare const tsdoc_apply_to_declaration: (declaration: DeclarationJson, tsdoc: TsdocParsedComment | undefined) => void;
+/**
+ * Concatenates a JSDoc comment (string or node array) into plain text, preserving `{@link ...}`.
+ *
+ * `JSDocLink` / `JSDocLinkCode` / `JSDocLinkPlain` nodes have empty `.text` — the identifier
+ * lives on `.name`, not `.text`. Using `.text` alone silently drops link content; we fall back
+ * to the source-text representation for link nodes so `{@link Foo}` survives intact for downstream
+ * renderers (see `tsdoc_mdz.ts`).
+ */
+export declare const tsdoc_comment_to_text: (comment: string | ts.NodeArray<ts.JSDocComment>, source_file: ts.SourceFile) => string;
 /**
  * Clean raw JSDoc comment text by removing comment markers and leading asterisks.
  *

package/dist/tsdoc_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tsdoc_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iCAAiC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACrD,oCAAoC;IACpC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GACvB,MAAM,EAAE,CAAC,IAAI,EACb,aAAa,EAAE,CAAC,UAAU,KACxB,kBAAkB,GAAG,SAyFvB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,GACtC,aAAa,eAAe,EAC5B,OAAO,kBAAkB,GAAG,SAAS,KACnC,IAmBF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,cAAc,MAAM,KAAG,MAAM,GAAG,SAUnE,CAAC"}
+{"version":3,"file":"tsdoc_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tsdoc_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iCAAiC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACrD,oCAAoC;IACpC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GACvB,MAAM,EAAE,CAAC,IAAI,EACb,aAAa,EAAE,CAAC,UAAU,KACxB,kBAAkB,GAAG,SAoFvB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,GACtC,aAAa,eAAe,EAC5B,OAAO,kBAAkB,GAAG,SAAS,KACnC,IAmBF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GACjC,SAAS,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,EAC/C,aAAa,EAAE,CAAC,UAAU,KACxB,MAGF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,cAAc,MAAM,KAAG,MAAM,GAAG,SAUnE,CAAC"}

package/dist/tsdoc_helpers.js

@@ -74,16 +74,13 @@ export const tsdoc_parse = (node, source_file) => {
     // Extract main comment text
     for (const comment of tsdoc_comments) {
         if (ts.isJSDoc(comment) && comment.comment) {
-            const text = typeof comment.comment === 'string'
-                ? comment.comment
-                : comment.comment.map((c) => c.text).join('');
-            full_text += text + '\n';
+            full_text += tsdoc_comment_to_text(comment.comment, source_file) + '\n';
         }
     }
     // Extract tags
     const tags = ts.getJSDocTags(node);
     for (const tag of tags) {
-        const tag_text = typeof tag.comment === 'string' ? tag.comment : tag.comment?.map((c) => c.text).join('');
+        const tag_text = tag.comment ? tsdoc_comment_to_text(tag.comment, source_file) : undefined;
         const tag_name = tag.tagName.text;
         if (tag_name === 'param' && ts.isJSDocParameterTag(tag)) {
             // Extract parameter name and description
@@ -177,6 +174,19 @@ export const tsdoc_apply_to_declaration = (declaration, tsdoc) => {
         declaration.since = tsdoc.since;
     }
 };
+/**
+ * Concatenates a JSDoc comment (string or node array) into plain text, preserving `{@link ...}`.
+ *
+ * `JSDocLink` / `JSDocLinkCode` / `JSDocLinkPlain` nodes have empty `.text` — the identifier
+ * lives on `.name`, not `.text`. Using `.text` alone silently drops link content; we fall back
+ * to the source-text representation for link nodes so `{@link Foo}` survives intact for downstream
+ * renderers (see `tsdoc_mdz.ts`).
+ */
+export const tsdoc_comment_to_text = (comment, source_file) => {
+    if (typeof comment === 'string')
+        return comment;
+    return comment.map((c) => (ts.isJSDocLinkLike(c) ? c.getText(source_file) : c.text)).join('');
+};
 /**
  * Clean raw JSDoc comment text by removing comment markers and leading asterisks.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.191.4",
+  "version": "0.192.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -81,11 +81,11 @@
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.58.0",
-    "@fuzdev/fuz_util": "^0.55.0",
-    "@fuzdev/gro": "^0.197.2",
+    "@fuzdev/fuz_css": "^0.59.0",
+    "@fuzdev/fuz_util": "^0.57.0",
+    "@fuzdev/gro": "^0.198.0",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@ryanatkn/eslint-config": "^0.10.1",
+    "@ryanatkn/eslint-config": "^0.11.0",
     "@sveltejs/acorn-typescript": "^1.0.9",
     "@sveltejs/adapter-static": "^3.0.10",
     "@sveltejs/kit": "^2.55.0",

package/src/lib/api_search.svelte.ts

@@ -24,7 +24,7 @@ export interface ApiSearchState {
  * Creates unified search state for the API index page (modules and declarations).
  */
 export const create_api_search = (library: Library): ApiSearchState => {
-	let query = $state('');
+	let query = $state.raw('');
 
 	// Module filtering
 	const all_modules = $derived(library.modules_sorted);
@@ -77,7 +77,7 @@ export const create_api_search = (library: Library): ApiSearchState => {
 export const create_module_declaration_search = (
 	declarations: Array<Declaration>,
 ): DeclarationSearchState => {
-	let query = $state('');
+	let query = $state.raw('');
 
 	const all = $derived(declarations);
 

package/src/lib/contextmenu_state.svelte.ts

@@ -31,9 +31,9 @@ export class EntryState {
 	readonly run: () => ContextmenuRun;
 	readonly disabled: () => boolean;
 
-	selected: boolean = $state(false);
-	pending: boolean = $state(false);
-	error_message: string | null = $state(null);
+	selected: boolean = $state.raw(false);
+	pending: boolean = $state.raw(false);
+	error_message: string | null = $state.raw(null);
 	promise: Promise<ContextmenuActivateResult> | null = $state.raw(null);
 
 	constructor(
@@ -52,7 +52,7 @@ export class SubmenuState {
 	readonly menu: SubmenuState | RootMenuState;
 	readonly depth: number;
 
-	selected: boolean = $state(false);
+	selected: boolean = $state.raw(false);
 	items: ReadonlyArray<ItemState> = $state.raw([]);
 
 	constructor(menu: SubmenuState | RootMenuState, depth: number) {
@@ -90,11 +90,11 @@ export class ContextmenuState {
 	readonly has_custom_layout: boolean;
 
 	// State for external consumers.
-	opened: boolean = $state(false);
-	x: number = $state(0);
-	y: number = $state(0);
+	opened: boolean = $state.raw(false);
+	x: number = $state.raw(0);
+	y: number = $state.raw(0);
 	params: ReadonlyArray<ContextmenuParams> = $state.raw([]);
-	error: string | undefined = $state();
+	error: string | undefined = $state.raw();
 
 	// These arrays use immutable updates (reassignment, not mutation).
 	// If you need reactivity, use `$contextmenu` in a reactive statement to react to all changes, and
@@ -301,6 +301,7 @@ export class ContextmenuState {
 
 	select_last(): void {
 		const {items} = this.selections.at(-1)?.menu ?? this.root_menu;
+		if (!items.length) return;
 		this.select(items.at(-1)!);
 	}