@fuzdev/fuz_ui 0.191.4 → 0.193.0

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.193.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.61.1",
+    "@fuzdev/gro": "^0.199.1",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@ryanatkn/eslint-config": "^0.10.1",
+    "@ryanatkn/eslint-config": "^0.12.1",
     "@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
@@ -253,7 +253,7 @@ export class ContextmenuState {
 		do {
 			i.selected = true;
 			new_selections.unshift(i);
-		} while ((i = i.menu) && i.menu); // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+		} while ((i = i.menu) && i.menu);
 		this.selections = new_selections;
 	}
 
@@ -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)!);
 	}
 
@@ -417,7 +418,7 @@ export const contextmenu_open = (
 	// `navigator.vibrate()` works with `ContextmenuRoot` but gets blocked by some browsers
 	// when used with `ContextmenuRootForSafariCompatibility` because its longpress
 	// workaround triggers from a timeout rather than a direct user interaction.
-	// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+
 	if (BROWSER && vibrate && navigator.vibrate) {
 		navigator.vibrate(CONTEXTMENU_OPEN_VIBRATE_DURATION);
 	}