@fuzdev/fuz_ui 0.185.0 → 0.185.2

package/dist/autofocus.svelte.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Svelte 5 attachment that focuses an element on mount.
+ *
+ * @module
+ */
+import type { Attachment } from 'svelte/attachments';
+/**
+ * Creates an attachment that focuses the element on mount.
+ * Use this instead of the HTML `autofocus` attribute for elements
+ * that mount dynamically from reactive conditionals like `{#if}`.
+ * @param options - focus options forwarded to `element.focus()`; defaults to `{focusVisible: true}` to show focus indicators on programmatic focus
+ */
+export declare const autofocus: (options?: FocusOptions) => Attachment<HTMLElement | SVGElement>;
+//# sourceMappingURL=autofocus.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"autofocus.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/autofocus.svelte.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,oBAAoB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,YAAY,KAAG,UAAU,CAAC,WAAW,GAAG,UAAU,CAI5D,CAAC"}

package/dist/autofocus.svelte.js

@@ -0,0 +1,15 @@
+/**
+ * Svelte 5 attachment that focuses an element on mount.
+ *
+ * @module
+ */
+/**
+ * Creates an attachment that focuses the element on mount.
+ * Use this instead of the HTML `autofocus` attribute for elements
+ * that mount dynamically from reactive conditionals like `{#if}`.
+ * @param options - focus options forwarded to `element.focus()`; defaults to `{focusVisible: true}` to show focus indicators on programmatic focus
+ */
+export const autofocus = (options) => (el) => {
+    // focusVisible missing from TS lib.dom.d.ts as of 5.9
+    el.focus({ focusVisible: true, ...options });
+};

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

@@ -1 +1 @@
-{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,eAAe,EAGpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAG/C;;GAEG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,eAAe,CAAiB;IAE3D,OAAO,wCAAiC;IAExC;;OAEG;IACH,WAAW,SAA8B;IAEzC,IAAI,SAAwC;IAC5C,IAAI,4FAAwC;IAE5C;;OAEG;IACH,UAAU,qBAQR;IAEF;;OAEG;IACH,OAAO,SAAoF;IAE3F;;OAEG;IACH,gBAAgB,SAMd;IAEF;;OAEG;IACH,YAAY,qBAIV;IAEF;;OAEG;IACH,YAAY,SAAiE;IAE7E,cAAc,qBAAkD;IAChE,WAAW,qBAA+C;IAC1D,kBAAkB,qBAAsD;IACxE,UAAU;;;;;;;oBAA8C;IACxD,KAAK;;;;;;;;;;;;;;;;;oBAAyC;IAC9C,WAAW,qBAA+C;IAC1D,kBAAkB,qBAAsD;IACxE,cAAc;;;;;oBAAkD;IAChE,OAAO,uBAA2C;IAClD,UAAU,uBAA8C;IACxD,MAAM;;;;oBAA0C;IAChD,KAAK,qBAAyC;IAC9C,QAAQ,uBAA4C;IACpD,QAAQ,uBAA4C;IACpD,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,CAEzC;IACF,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,CAE5C;IAEF,YAAY,UAA2D;IACvE,aAAa,UAAuC;IACpD,iBAAiB,UAAgC;IACjD,cAAc,UAA+D;IAC7E,SAAS,UAAqD;IAC9D,YAAY,UAAuE;gBAEvE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe;CAI7D"}
+{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,eAAe,EAGpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAK/C;;GAEG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,eAAe,CAAiB;IAE3D,OAAO,wCAAiC;IAExC;;OAEG;IACH,WAAW,SAA8B;IAEzC,IAAI,SAAwC;IAC5C,IAAI,4FAAwC;IAE5C;;OAEG;IACH,UAAU,qBAQR;IAEF;;OAEG;IACH,OAAO,SAAoF;IAE3F;;OAEG;IACH,gBAAgB,SAMd;IAEF;;OAEG;IACH,YAAY,qBAIV;IAEF;;OAEG;IACH,YAAY,SAAiE;IAE7E,cAAc,qBAAkD;IAChE,WAAW,qBAA+C;IAC1D,kBAAkB,qBAAsD;IACxE,UAAU;;;;;;;oBAA8C;IACxD,KAAK;;;;;;;;;;;;;;;;;oBAAyC;IAC9C,WAAW,qBAA+C;IAC1D,kBAAkB,qBAAsD;IACxE,cAAc;;;;;oBAAkD;IAChE,OAAO,uBAA2C;IAClD,UAAU,uBAA8C;IACxD,MAAM;;;;oBAA0C;IAChD,KAAK,qBAAyC;IAC9C,QAAQ,uBAA4C;IACpD,QAAQ,uBAA4C;IACpD,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,CAEzC;IACF,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,CAE5C;IAEF,YAAY,UAA2D;IACvE,aAAa,UAAuC;IACpD,iBAAiB,UAAgC;IACjD,cAAc,UAA+D;IAC7E,SAAS,UAAqD;IAC9D,YAAY,UAAuE;gBAEvE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe;CAI7D"}

package/dist/declaration.svelte.js

@@ -1,5 +1,6 @@
 import { declaration_generate_import, declaration_get_display_name, } from '@fuzdev/fuz_util/source_json.js';
 import { url_github_file } from './package_helpers.js';
+/* eslint-disable @typescript-eslint/no-deprecated */
 /**
  * Rich runtime representation of an exported declaration.
  */

package/dist/ts_helpers.js

@@ -140,7 +140,7 @@ export const ts_analyze_module_exports = (source_file, checker, options, ctx) =>
                                 const decl = {
                                     name: export_symbol.name,
                                     kind,
-                                    alias_of: { module: original_module, name: original_name },
+                                    alias_of: { module: original_module, name: original_name, kind },
                                 };
                                 // Renamed re-exports aren't nodocs - they're new declarations pointing to the original
                                 declarations.push({ declaration: decl, nodocs: false });

package/dist/tsdoc_helpers.d.ts

@@ -30,7 +30,8 @@
  * ## Behavioral notes
  *
  * Due to TS Compiler API limitations:
- * - Preserves dash separator in `@param` descriptions: `@param x desc` → `"- desc"`
+ * - `@param` and `@mutates` descriptions have leading `- ` stripped for visual consistency
+ *   (TSDoc spec uses `@param name - description` but the separator is aesthetic)
  * - `@throws` tags have `{Type}` stripped by TS API; fallback regex extracts first word as error type
  * - TS API strips URL protocols from `@see` tag text; we use `getText()` to preserve original format including `{@link}` syntax
  *

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;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,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"}

package/dist/tsdoc_helpers.js

@@ -30,7 +30,8 @@
  * ## Behavioral notes
  *
  * Due to TS Compiler API limitations:
- * - Preserves dash separator in `@param` descriptions: `@param x desc` → `"- desc"`
+ * - `@param` and `@mutates` descriptions have leading `- ` stripped for visual consistency
+ *   (TSDoc spec uses `@param name - description` but the separator is aesthetic)
  * - `@throws` tags have `{Type}` stripped by TS API; fallback regex extracts first word as error type
  * - TS API strips URL protocols from `@see` tag text; we use `getText()` to preserve original format including `{@link}` syntax
  *
@@ -88,7 +89,7 @@ export const tsdoc_parse = (node, source_file) => {
             // Extract parameter name and description
             const param_name = ts.isIdentifier(tag.name) ? tag.name.text : tag.name.getText();
             if (param_name && tag_text) {
-                params.set(param_name, tag_text.trim());
+                params.set(param_name, tag_text.trim().replace(/^-\s+/, ''));
             }
         }
         else if (tag_name === 'returns' && tag_text) {
@@ -127,7 +128,7 @@ export const tsdoc_parse = (node, source_file) => {
             since = tag_text.trim();
         }
         else if (tag_name === 'mutates' && tag_text) {
-            mutates.push(tag_text.trim());
+            mutates.push(tag_text.trim().replace(/^-\s+/, ''));
         }
         else if (tag_name === 'nodocs') {
             nodocs = true;

package/dist/tsdoc_mdz.d.ts

@@ -16,8 +16,9 @@
  * - `{@link identifier}` → `` `identifier` `` (code formatting)
  * - Bare URLs → returned as-is
  * - Bare identifiers → wrapped in backticks
+ * - `identifier description text` → `` `identifier` description text `` (first token is the reference)
  *
- * @param content Raw `@see` tag content in TSDoc format
+ * @param content - raw `@see` tag content in TSDoc format
  * @returns mdz-formatted string ready for `Mdz` component
  *
  * @example
@@ -30,6 +31,9 @@
  *
  * tsdoc_see_to_mdz('https://example.com')
  * // → 'https://example.com'
+ *
+ * tsdoc_see_to_mdz('library_gen.ts for Gro-specific integration')
+ * // → '`library_gen.ts` for Gro-specific integration'
  * ```
  */
 export declare const tsdoc_see_to_mdz: (content: string) => string;

package/dist/tsdoc_mdz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc_mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tsdoc_mdz.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG,MAqBlD,CAAC"}
+{"version":3,"file":"tsdoc_mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tsdoc_mdz.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG,MA6BlD,CAAC"}

package/dist/tsdoc_mdz.js

@@ -19,8 +19,9 @@ const format_reference = (ref) => (mdz_is_url(ref) ? ref : `\`${ref}\``);
  * - `{@link identifier}` → `` `identifier` `` (code formatting)
  * - Bare URLs → returned as-is
  * - Bare identifiers → wrapped in backticks
+ * - `identifier description text` → `` `identifier` description text `` (first token is the reference)
  *
- * @param content Raw `@see` tag content in TSDoc format
+ * @param content - raw `@see` tag content in TSDoc format
  * @returns mdz-formatted string ready for `Mdz` component
  *
  * @example
@@ -33,6 +34,9 @@ const format_reference = (ref) => (mdz_is_url(ref) ? ref : `\`${ref}\``);
  *
  * tsdoc_see_to_mdz('https://example.com')
  * // → 'https://example.com'
+ *
+ * tsdoc_see_to_mdz('library_gen.ts for Gro-specific integration')
+ * // → '`library_gen.ts` for Gro-specific integration'
  * ```
  */
 export const tsdoc_see_to_mdz = (content) => {
@@ -52,5 +56,12 @@ export const tsdoc_see_to_mdz = (content) => {
         }
         return format_reference(inner);
     }
-    return format_reference(trimmed);
+    // Split at first whitespace: first token is the reference, rest is description
+    const space_index = trimmed.indexOf(' ');
+    if (space_index === -1) {
+        return format_reference(trimmed);
+    }
+    const reference = trimmed.slice(0, space_index);
+    const description = trimmed.slice(space_index); // preserve leading space
+    return format_reference(reference) + description;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.185.0",
+  "version": "0.185.2",
   "description": "Svelte UI library",
   "motto": "friendly user zystem",
   "glyph": "🧶",

package/src/lib/autofocus.svelte.ts

@@ -0,0 +1,20 @@
+/**
+ * Svelte 5 attachment that focuses an element on mount.
+ *
+ * @module
+ */
+
+import type {Attachment} from 'svelte/attachments';
+
+/**
+ * Creates an attachment that focuses the element on mount.
+ * Use this instead of the HTML `autofocus` attribute for elements
+ * that mount dynamically from reactive conditionals like `{#if}`.
+ * @param options - focus options forwarded to `element.focus()`; defaults to `{focusVisible: true}` to show focus indicators on programmatic focus
+ */
+export const autofocus =
+	(options?: FocusOptions): Attachment<HTMLElement | SVGElement> =>
+	(el) => {
+		// focusVisible missing from TS lib.dom.d.ts as of 5.9
+		el.focus({focusVisible: true, ...options} as FocusOptions);
+	};

package/src/lib/declaration.svelte.ts

@@ -7,6 +7,8 @@ import {
 import type {Module} from './module.svelte.js';
 import {url_github_file} from './package_helpers.js';
 
+/* eslint-disable @typescript-eslint/no-deprecated */
+
 /**
  * Rich runtime representation of an exported declaration.
  */

package/src/lib/ts_helpers.ts

@@ -228,7 +228,7 @@ export const ts_analyze_module_exports = (
 								const decl: DeclarationJson = {
 									name: export_symbol.name,
 									kind,
-									alias_of: {module: original_module, name: original_name},
+									alias_of: {module: original_module, name: original_name, kind},
 								};
 								// Renamed re-exports aren't nodocs - they're new declarations pointing to the original
 								declarations.push({declaration: decl, nodocs: false});

package/src/lib/tsdoc_helpers.ts

@@ -30,7 +30,8 @@
  * ## Behavioral notes
  *
  * Due to TS Compiler API limitations:
- * - Preserves dash separator in `@param` descriptions: `@param x desc` → `"- desc"`
+ * - `@param` and `@mutates` descriptions have leading `- ` stripped for visual consistency
+ *   (TSDoc spec uses `@param name - description` but the separator is aesthetic)
  * - `@throws` tags have `{Type}` stripped by TS API; fallback regex extracts first word as error type
  * - TS API strips URL protocols from `@see` tag text; we use `getText()` to preserve original format including `{@link}` syntax
  *
@@ -125,7 +126,7 @@ export const tsdoc_parse = (
 			// Extract parameter name and description
 			const param_name = ts.isIdentifier(tag.name) ? tag.name.text : tag.name.getText();
 			if (param_name && tag_text) {
-				params.set(param_name, tag_text.trim());
+				params.set(param_name, tag_text.trim().replace(/^-\s+/, ''));
 			}
 		} else if (tag_name === 'returns' && tag_text) {
 			returns = tag_text.trim();
@@ -157,7 +158,7 @@ export const tsdoc_parse = (
 		} else if (tag_name === 'since' && tag_text) {
 			since = tag_text.trim();
 		} else if (tag_name === 'mutates' && tag_text) {
-			mutates.push(tag_text.trim());
+			mutates.push(tag_text.trim().replace(/^-\s+/, ''));
 		} else if (tag_name === 'nodocs') {
 			nodocs = true;
 		}

package/src/lib/tsdoc_mdz.ts

@@ -22,8 +22,9 @@ const format_reference = (ref: string): string => (mdz_is_url(ref) ? ref : `\`${
  * - `{@link identifier}` → `` `identifier` `` (code formatting)
  * - Bare URLs → returned as-is
  * - Bare identifiers → wrapped in backticks
+ * - `identifier description text` → `` `identifier` description text `` (first token is the reference)
  *
- * @param content Raw `@see` tag content in TSDoc format
+ * @param content - raw `@see` tag content in TSDoc format
  * @returns mdz-formatted string ready for `Mdz` component
  *
  * @example
@@ -36,6 +37,9 @@ const format_reference = (ref: string): string => (mdz_is_url(ref) ? ref : `\`${
  *
  * tsdoc_see_to_mdz('https://example.com')
  * // → 'https://example.com'
+ *
+ * tsdoc_see_to_mdz('library_gen.ts for Gro-specific integration')
+ * // → '`library_gen.ts` for Gro-specific integration'
  * ```
  */
 export const tsdoc_see_to_mdz = (content: string): string => {
@@ -58,5 +62,13 @@ export const tsdoc_see_to_mdz = (content: string): string => {
 		return format_reference(inner);
 	}
 
-	return format_reference(trimmed);
+	// Split at first whitespace: first token is the reference, rest is description
+	const space_index = trimmed.indexOf(' ');
+	if (space_index === -1) {
+		return format_reference(trimmed);
+	}
+
+	const reference = trimmed.slice(0, space_index);
+	const description = trimmed.slice(space_index); // preserve leading space
+	return format_reference(reference) + description;
 };