@fuzdev/fuz_ui 0.191.1 → 0.191.3

package/dist/library_pipeline.d.ts

@@ -6,15 +6,15 @@
  *
  * Pipeline stages:
  * 1. **Collection** - `library_collect_source_files` gathers and filters source files
- * 2. **Analysis** - `library_analyze_module` (in library_analysis.ts) extracts metadata
+ * 2. **Analysis** - `library_analyze_module` (in `library_analysis.ts`) extracts metadata
  * 3. **Validation** - `library_find_duplicates` checks flat namespace constraints
  * 4. **Transformation** - `library_merge_re_exports` resolves re-export relationships
  * 5. **Output** - `library_sort_modules` prepares deterministic output
  *
- * @see library_generate.ts for the main generation entry point
- * @see library_analysis.ts for module-level analysis
- * @see library_output.ts for output file generation (JSON/TS wrapper)
- * @see library_gen.ts for Gro-specific integration
+ * @see `library_generate.ts` for the main generation entry point
+ * @see `library_analysis.ts` for module-level analysis
+ * @see `library_output.ts` for output file generation (JSON/TS wrapper)
+ * @see `library_gen.ts` for Gro-specific integration
  *
  * @module
  */
@@ -38,6 +38,7 @@ export interface DuplicateInfo {
  * Callers can decide how to handle duplicates (throw, warn, ignore).
  *
  * @example
+ * ```ts
  * const duplicates = library_find_duplicates(source_json);
  * if (duplicates.size > 0) {
  *   for (const [name, occurrences] of duplicates) {
@@ -48,6 +49,7 @@ export interface DuplicateInfo {
  *   }
  *   throw new Error(`Found ${duplicates.size} duplicate declaration names`);
  * }
+ * ```
  */
 export declare const library_find_duplicates: (source_json: SourceJson) => Map<string, Array<DuplicateInfo>>;
 /**
@@ -80,12 +82,14 @@ export interface CollectedReExport {
  * after all modules are analyzed.
  *
  * @example
+ * ```ts
  * // helpers.ts exports: foo, bar
  * // index.ts does: export {foo, bar} from './helpers.js'
  * //
  * // After processing:
  * // - helpers.ts foo declaration gets: also_exported_from: ['index.ts']
  * // - helpers.ts bar declaration gets: also_exported_from: ['index.ts']
+ * ```
  *
  * @param source_json - the source JSON with all modules (will be mutated)
  * @param collected_re_exports - array of re-exports collected during phase 1

package/dist/library_pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_pipeline.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,eAAe,EAAE,UAAU,EAAE,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAE7F,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAIxB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qCAAqC;IACrC,WAAW,EAAE,eAAe,CAAC;IAC7B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,uBAAuB,GACnC,aAAa,UAAU,KACrB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CA0BlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,KAAK,CAAC,UAAU,CAEjF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,kDAAkD;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,SAAS,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,wBAAwB,GACpC,aAAa,UAAU,EACvB,sBAAsB,KAAK,CAAC,iBAAiB,CAAC,KAC5C,IAgCF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,GACxC,OAAO,QAAQ,CAAC,cAAc,CAAC,EAC/B,SAAS,mBAAmB,EAC5B,MAAM,MAAM,KACV,KAAK,CAAC,cAAc,CA0BtB,CAAC"}
+{"version":3,"file":"library_pipeline.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,eAAe,EAAE,UAAU,EAAE,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAE7F,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAIxB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qCAAqC;IACrC,WAAW,EAAE,eAAe,CAAC;IAC7B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,uBAAuB,GACnC,aAAa,UAAU,KACrB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CA0BlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,KAAK,CAAC,UAAU,CAEjF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,kDAAkD;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,SAAS,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,wBAAwB,GACpC,aAAa,UAAU,EACvB,sBAAsB,KAAK,CAAC,iBAAiB,CAAC,KAC5C,IAgCF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,GACxC,OAAO,QAAQ,CAAC,cAAc,CAAC,EAC/B,SAAS,mBAAmB,EAC5B,MAAM,MAAM,KACV,KAAK,CAAC,cAAc,CA0BtB,CAAC"}

package/dist/library_pipeline.js

@@ -6,15 +6,15 @@
  *
  * Pipeline stages:
  * 1. **Collection** - `library_collect_source_files` gathers and filters source files
- * 2. **Analysis** - `library_analyze_module` (in library_analysis.ts) extracts metadata
+ * 2. **Analysis** - `library_analyze_module` (in `library_analysis.ts`) extracts metadata
  * 3. **Validation** - `library_find_duplicates` checks flat namespace constraints
  * 4. **Transformation** - `library_merge_re_exports` resolves re-export relationships
  * 5. **Output** - `library_sort_modules` prepares deterministic output
  *
- * @see library_generate.ts for the main generation entry point
- * @see library_analysis.ts for module-level analysis
- * @see library_output.ts for output file generation (JSON/TS wrapper)
- * @see library_gen.ts for Gro-specific integration
+ * @see `library_generate.ts` for the main generation entry point
+ * @see `library_analysis.ts` for module-level analysis
+ * @see `library_output.ts` for output file generation (JSON/TS wrapper)
+ * @see `library_gen.ts` for Gro-specific integration
  *
  * @module
  */
@@ -26,6 +26,7 @@ import { module_is_source, module_validate_source_options, module_get_source_roo
  * Callers can decide how to handle duplicates (throw, warn, ignore).
  *
  * @example
+ * ```ts
  * const duplicates = library_find_duplicates(source_json);
  * if (duplicates.size > 0) {
  *   for (const [name, occurrences] of duplicates) {
@@ -36,6 +37,7 @@ import { module_is_source, module_validate_source_options, module_get_source_roo
  *   }
  *   throw new Error(`Found ${duplicates.size} duplicate declaration names`);
  * }
+ * ```
  */
 export const library_find_duplicates = (source_json) => {
     const all_occurrences = new Map();
@@ -80,12 +82,14 @@ export const library_sort_modules = (modules) => {
  * after all modules are analyzed.
  *
  * @example
+ * ```ts
  * // helpers.ts exports: foo, bar
  * // index.ts does: export {foo, bar} from './helpers.js'
  * //
  * // After processing:
  * // - helpers.ts foo declaration gets: also_exported_from: ['index.ts']
  * // - helpers.ts bar declaration gets: also_exported_from: ['index.ts']
+ * ```
  *
  * @param source_json - the source JSON with all modules (will be mutated)
  * @param collected_re_exports - array of re-exports collected during phase 1

package/dist/logos.d.ts

@@ -12,7 +12,7 @@ export declare const logo_fuz: {
         d: string;
     }[];
 };
-export declare const logo_fuz_ui: {
+export declare const logo_fuz_app: {
     label: string;
     fill: string;
     paths: {
@@ -29,6 +29,13 @@ export declare const logo_fuz_css: {
         style: string;
     };
 };
+export declare const logo_fuz_ui: {
+    label: string;
+    fill: string;
+    paths: {
+        d: string;
+    }[];
+};
 export declare const logo_fuz_code: {
     label: string;
     fill: string;

package/dist/logos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logos.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/logos.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ;;;;;;CAgCF,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;;;CAKN,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAIX,CAAC;AAEpB,eAAO,MAAM,eAAe;;;;;;CAIT,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAQX,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAwBP,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;;;;CAWL,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC"}
+{"version":3,"file":"logos.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/logos.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ;;;;;;CAgCF,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;CAIN,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;;;CAKN,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAIX,CAAC;AAEpB,eAAO,MAAM,eAAe;;;;;;CAIT,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAQX,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAwBP,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;;;;CAWL,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC"}

package/dist/logos.js

@@ -57,9 +57,9 @@ export const logo_fuz = {
         },
     ],
 };
-export const logo_fuz_ui = {
-    label: 'a friendly red spider facing you',
-    fill: '#d93636',
+export const logo_fuz_app = {
+    label: 'a friendly teal spider facing you',
+    fill: '#2e9e6f',
     paths: logo_fuz.paths,
 };
 export const logo_fuz_css = {
@@ -68,6 +68,11 @@ export const logo_fuz_css = {
     paths: logo_fuz.paths,
     attrs: { style: 'transform: scaleX(-1) rotate(180deg)' },
 };
+export const logo_fuz_ui = {
+    label: 'a friendly red spider facing you',
+    fill: '#d93636',
+    paths: logo_fuz.paths,
+};
 export const logo_fuz_code = {
     label: 'a friendly pink spider facing you',
     fill: '#e55d95',

package/dist/module.svelte.d.ts

@@ -17,7 +17,7 @@ export declare class Module {
     path_import: string;
     module_comment: string | undefined;
     /**
-     * Array of Declaration instances. Filters out default exports.
+     * Array of `Declaration` instances. Filters out default exports.
      */
     declarations: Declaration[];
     /**

package/dist/module.svelte.js

@@ -16,7 +16,7 @@ export class Module {
     path_import = $derived('./' + this.path);
     module_comment = $derived(this.module_json.module_comment);
     /**
-     * Array of Declaration instances. Filters out default exports.
+     * Array of `Declaration` instances. Filters out default exports.
      */
     declarations = $derived(this.module_json.declarations
         ? this.module_json.declarations

package/dist/module_helpers.d.ts

@@ -18,7 +18,7 @@ export type AnalyzerType = 'typescript' | 'svelte';
 /**
  * File information for source analysis.
  *
- * Can be constructed from Gro's Disknode or from plain file system access.
+ * Can be constructed from Gro's `Disknode` or from plain file system access.
  * This abstraction enables non-Gro usage while keeping Gro support via adapter.
  *
  * Note: `content` is required to keep analysis functions pure (no hidden I/O).
@@ -235,7 +235,7 @@ export declare const module_validate_source_options: (options: ModuleSourceOptio
  *
  * Returns `source_root` if provided, otherwise returns `source_paths[0]` for single-path configs.
  *
- * @throws Error if source_root is required but not provided (multiple source_paths)
+ * @throws Error if `source_root` is required but not provided (multiple `source_paths`)
  */
 export declare const module_get_source_root: (options: ModuleSourceOptions) => string;
 /**

package/dist/module_helpers.js

@@ -166,7 +166,7 @@ export const module_validate_source_options = (options) => {
  *
  * Returns `source_root` if provided, otherwise returns `source_paths[0]` for single-path configs.
  *
- * @throws Error if source_root is required but not provided (multiple source_paths)
+ * @throws Error if `source_root` is required but not provided (multiple `source_paths`)
  */
 export const module_get_source_root = (options) => {
     if (options.source_root !== undefined) {

package/dist/package_helpers.d.ts

@@ -11,7 +11,7 @@
  * - `url_well_known` - .well-known metadata file
  *
  * Parsers:
- * - `repo_url_parse` - extract repo URL from package.json repository field
+ * - `repo_url_parse` - extract repo URL from `package.json` repository field
  * - `repo_name_parse` - extract repo name from scoped package name
  * - `repo_url_github_owner` - extract GitHub owner from repo URL
  *
@@ -96,7 +96,7 @@ export declare const url_npm_package: (package_name: string) => string;
  * - It has exports defined
  * - Its version is not the initial '0.0.1'
  *
- * @param package_json - the package.json object to check
+ * @param package_json - the `package.json` object to check
  * @returns `true` if the package appears to be published
  */
 export declare const package_is_published: (package_json: PackageJson) => boolean;
@@ -121,12 +121,12 @@ export declare const package_is_published: (package_json: PackageJson) => boolea
  */
 export declare const repo_name_parse: (name: string) => string;
 /**
- * Parse repository URL from package.json format.
+ * Parse repository URL from `package.json` format.
  *
  * Handles both string format and object format with `url` property.
  * Strips common prefixes ('git+') and suffixes ('.git', '/').
  *
- * @param repository - the repository field from package.json
+ * @param repository - the repository field from `package.json`
  * @returns clean repository URL, or null if not provided
  *
  * @example

package/dist/package_helpers.js

@@ -11,7 +11,7 @@
  * - `url_well_known` - .well-known metadata file
  *
  * Parsers:
- * - `repo_url_parse` - extract repo URL from package.json repository field
+ * - `repo_url_parse` - extract repo URL from `package.json` repository field
  * - `repo_name_parse` - extract repo name from scoped package name
  * - `repo_url_github_owner` - extract GitHub owner from repo URL
  *
@@ -108,7 +108,7 @@ export const url_npm_package = (package_name) => 'https://www.npmjs.com/package/
  * - It has exports defined
  * - Its version is not the initial '0.0.1'
  *
- * @param package_json - the package.json object to check
+ * @param package_json - the `package.json` object to check
  * @returns `true` if the package appears to be published
  */
 export const package_is_published = (package_json) => {
@@ -144,12 +144,12 @@ export const repo_name_parse = (name) => {
     return name;
 };
 /**
- * Parse repository URL from package.json format.
+ * Parse repository URL from `package.json` format.
  *
  * Handles both string format and object format with `url` property.
  * Strips common prefixes ('git+') and suffixes ('.git', '/').
  *
- * @param repository - the repository field from package.json
+ * @param repository - the repository field from `package.json`
  * @returns clean repository URL, or null if not provided
  *
  * @example

package/dist/svelte_preprocess_mdz.d.ts

@@ -26,18 +26,18 @@ export interface SveltePreprocessMdzOptions {
      * Value: import path (e.g., '$lib/Alert.svelte').
      *
      * If mdz content references a component not in this map,
-     * that Mdz usage is skipped (left as runtime).
+     * that `Mdz` usage is skipped (left as runtime).
      */
     components?: Record<string, string>;
     /**
      * Allowed HTML elements in mdz content.
      * If mdz content references an element not in this list,
-     * that Mdz usage is skipped (left as runtime).
+     * that `Mdz` usage is skipped (left as runtime).
      */
     elements?: Array<string>;
     /**
-     * Import sources that resolve to the Mdz component.
-     * Used to verify that `Mdz` in templates refers to fuz_ui's Mdz.svelte.
+     * Import sources that resolve to the `Mdz` component.
+     * Used to verify that `Mdz` in templates refers to fuz_ui's `Mdz.svelte`.
      *
      * @default ['@fuzdev/fuz_ui/Mdz.svelte']
      */

package/dist/svelte_preprocess_mdz.js

@@ -328,7 +328,7 @@ const remove_dead_const_bindings = (s, ast, transformations, source) => {
     }
 };
 /**
- * Builds the replacement string for a transformed Mdz component.
+ * Builds the replacement string for a transformed `Mdz` component.
  *
  * Reconstructs the opening tag as `<MdzPrecompiled` with all attributes except `content`,
  * using source text slicing to preserve exact formatting and dynamic expressions.
@@ -350,13 +350,13 @@ const build_replacement = (node, exclude_attrs, children_markup, source) => {
     return `${opening}${children_markup}</${PRECOMPILED_NAME}>`;
 };
 /**
- * Determines which Mdz import declarations can be safely removed or trimmed.
+ * Determines which `Mdz` import declarations can be safely removed or trimmed.
  *
  * An import is removable when:
  * 1. All template usages of that name were successfully transformed.
  * 2. The identifier is not referenced elsewhere in script or template expressions.
  *
- * For multi-specifier imports, only the Mdz specifier is removed (partial removal).
+ * For multi-specifier imports, only the `Mdz` specifier is removed (partial removal).
  * For single-specifier imports, the entire declaration is removed.
  */
 const find_removable_mdz_imports = (ast, mdz_names, total_usages, transformed_usages) => {
@@ -399,13 +399,13 @@ const find_removable_mdz_imports = (ast, mdz_names, total_usages, transformed_us
  * Manages import additions and removals.
  *
  * Adds the `MdzPrecompiled` import and other required imports (DocsLink, Code, resolve).
- * Removes Mdz import declarations that are no longer referenced.
+ * Removes `Mdz` import declarations that are no longer referenced.
  *
  * Handles both full removal (single-specifier imports) and partial removal
- * (multi-specifier imports where only the Mdz specifier is removed).
+ * (multi-specifier imports where only the `Mdz` specifier is removed).
  *
  * To avoid MagicString boundary conflicts when the insertion position falls inside
- * a removal range, one removable Mdz import is overwritten with the MdzPrecompiled
+ * a removal range, one removable `Mdz` import is overwritten with the `MdzPrecompiled`
  * import line instead of using separate remove + appendLeft.
  */
 const manage_imports = (s, ast, transformations, removable_imports, compiled_component_import, source) => {

package/dist/ts_helpers.d.ts

@@ -18,7 +18,7 @@ import type { DeclarationAnalysis, ReExportInfo, ModuleAnalysis } from './librar
 export interface TsProgramOptions {
     /** Project root directory. @default './' */
     root?: string;
-    /** Path to tsconfig.json (relative to root). @default 'tsconfig.json' */
+    /** Path to `tsconfig.json` (relative to root). @default 'tsconfig.json' */
     tsconfig?: string;
     /** Override compiler options. */
     compiler_options?: ts.CompilerOptions;
@@ -38,7 +38,7 @@ export interface ModuleExportsAnalysis {
     module_comment?: string;
     /** All exported declarations with nodocs flags - consumer filters based on policy. */
     declarations: Array<DeclarationAnalysis>;
-    /** Same-name re-exports (for building also_exported_from in post-processing). */
+    /** Same-name re-exports (for building `also_exported_from` in post-processing). */
     re_exports: Array<ReExportInfo>;
     /** Star exports (`export * from './module'`) - module paths that are fully re-exported. */
     star_exports: Array<string>;
@@ -49,7 +49,7 @@ export interface ModuleExportsAnalysis {
  * @param options - configuration options for program creation
  * @param log - optional logger for info messages
  * @returns the program and type checker
- * @throws Error if tsconfig.json is not found
+ * @throws Error if `tsconfig.json` is not found
  */
 export declare const ts_create_program: (options?: TsProgramOptions, log?: Logger) => TsProgram;
 /**
@@ -110,7 +110,7 @@ export declare const ts_analyze_declaration: (symbol: ts.Symbol, source_file: ts
  * Requires `@module` tag to identify module comments. The tag line is stripped
  * from the output. Supports optional module renaming: `@module custom-name`.
  *
- * @see https://typedoc.org/documents/Tags._module.html
+ * @see {@link https://typedoc.org/documents/Tags._module.html}
  */
 export declare const ts_extract_module_comment: (source_file: ts.SourceFile) => string | undefined;
 /**

package/dist/ts_helpers.d.ts.map

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

package/dist/ts_helpers.js

@@ -14,7 +14,7 @@ import { module_extract_dependencies, module_extract_path, module_is_source, } f
  * @param options - configuration options for program creation
  * @param log - optional logger for info messages
  * @returns the program and type checker
- * @throws Error if tsconfig.json is not found
+ * @throws Error if `tsconfig.json` is not found
  */
 export const ts_create_program = (options, log) => {
     const root = options?.root ?? './';
@@ -227,7 +227,7 @@ export const ts_analyze_declaration = (symbol, source_file, checker, ctx) => {
  * Requires `@module` tag to identify module comments. The tag line is stripped
  * from the output. Supports optional module renaming: `@module custom-name`.
  *
- * @see https://typedoc.org/documents/Tags._module.html
+ * @see {@link https://typedoc.org/documents/Tags._module.html}
  */
 export const ts_extract_module_comment = (source_file) => {
     const full_text = source_file.getFullText();

package/dist/vite_plugin_library_well_known.d.ts

@@ -1,7 +1,7 @@
 import type { Plugin } from 'vite';
 export interface VitePluginLibraryWellKnownOptions {
     /**
-     * Path to the library.json file (relative to vite.config.ts).
+     * Path to the `library.json` file (relative to `vite.config.ts`).
      * @default './src/routes/library.json'
      */
     library_path?: string;
@@ -9,7 +9,7 @@ export interface VitePluginLibraryWellKnownOptions {
 /**
  * Vite plugin that publishes `package.json` and `library.json` to `.well-known/`.
  *
- * Requires a generated library.json file (created by `library_gen` from `gro gen`).
+ * Requires a generated `library.json` file (created by `library_gen` from `gro gen`).
  * The plugin reads this JSON file and publishes its metadata to `.well-known/` for
  * both dev and production builds.
  *

package/dist/vite_plugin_library_well_known.js

@@ -9,7 +9,7 @@ const respond_json = (res, body) => {
 /**
  * Vite plugin that publishes `package.json` and `library.json` to `.well-known/`.
  *
- * Requires a generated library.json file (created by `library_gen` from `gro gen`).
+ * Requires a generated `library.json` file (created by `library_gen` from `gro gen`).
  * The plugin reads this JSON file and publishes its metadata to `.well-known/` for
  * both dev and production builds.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.191.1",
+  "version": "0.191.3",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -81,9 +81,9 @@
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.57.0",
+    "@fuzdev/fuz_css": "^0.58.0",
     "@fuzdev/fuz_util": "^0.55.0",
-    "@fuzdev/gro": "^0.197.0",
+    "@fuzdev/gro": "^0.197.2",
     "@jridgewell/trace-mapping": "^0.3.31",
     "@ryanatkn/eslint-config": "^0.10.1",
     "@sveltejs/acorn-typescript": "^1.0.9",
@@ -101,7 +101,7 @@
     "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
     "prettier-plugin-svelte": "^3.5.1",
-    "svelte": "^5.54.0",
+    "svelte": "^5.54.1",
     "svelte-check": "^4.4.5",
     "svelte2tsx": "^0.7.52",
     "tslib": "^2.8.1",

package/src/lib/analysis_context.ts

@@ -8,7 +8,7 @@
  *
  * Analysis functions follow a two-tier error model:
  *
- * **Accumulated (non-fatal)** - Collected in AnalysisContext, analysis continues:
+ * **Accumulated (non-fatal)** - Collected in `AnalysisContext`, analysis continues:
  * - Type resolution failures (complex generics, circular refs)
  * - Missing or unparseable JSDoc
  * - Individual member/prop extraction failures
@@ -44,6 +44,7 @@
  * ```
  *
  * @example
+ * ```ts
  * const ctx = new AnalysisContext();
  * // ... analysis functions add diagnostics via ctx.add(...)
  * if (ctx.has_errors()) {
@@ -51,6 +52,7 @@
  *     console.error(`${err.file}:${err.line}: ${err.message}`);
  *   }
  * }
+ * ```
  *
  * @module
  */
@@ -157,6 +159,7 @@ export type Diagnostic =
  * report collected diagnostics.
  *
  * @example
+ * ```ts
  * const ctx = new AnalysisContext();
  * ts_analyze_module_exports(source_file, checker, options, ctx);
  * if (ctx.has_errors()) {
@@ -165,12 +168,13 @@ export type Diagnostic =
  *     console.error(format_diagnostic(d));
  *   }
  * }
+ * ```
  */
 export class AnalysisContext {
 	readonly diagnostics: Array<Diagnostic> = [];
 
 	/**
-	 * Add a diagnostic to the collection.
+	 * Add a `Diagnostic` to the collection.
 	 */
 	add(diagnostic: Diagnostic): void {
 		this.diagnostics.push(diagnostic);
@@ -205,7 +209,7 @@ export class AnalysisContext {
 	}
 
 	/**
-	 * Get diagnostics of a specific kind.
+	 * Get diagnostics of a specific `DiagnosticKind`.
 	 */
 	by_kind<K extends DiagnosticKind>(kind: K): Array<Extract<Diagnostic, {kind: K}>> {
 		return this.diagnostics.filter((d) => d.kind === kind) as Array<Extract<Diagnostic, {kind: K}>>;

package/src/lib/contextmenu_state.svelte.ts

@@ -76,10 +76,10 @@ export interface ContextmenuStateOptions {
 }
 
 /**
- * Creates a `contextmenu` store.
+ * Creates a contextmenu store.
  * See usage with `ContextmenuRoot.svelte` and `Contextmenu.svelte`.
  *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event}
  */
 export class ContextmenuState {
 	layout: Dimensions; // TODO $state?
@@ -305,7 +305,7 @@ export class ContextmenuState {
 	}
 
 	/**
-	 * Used by `ContextmenuEntry` and custom entry components
+	 * Used by `ContextmenuEntry.svelte` and custom entry components.
 	 * @initializes
 	 */
 	add_entry(run: () => ContextmenuRun, disabled: () => boolean = () => false): EntryState {

package/src/lib/csp.ts

@@ -184,7 +184,7 @@ export type CspDirectiveValue<T extends CspDirective> = Defined<CspDirectives[T]
 export const csp_trust_levels = ['low', 'medium', 'high'] as const;
 
 /**
- * Numeric values for CSP trust levels, `csp_trust_levels`.
+ * Numeric values for CSP trust levels. See `csp_trust_levels`.
  * Lower is less trusted.
  * Includes `undefined` in the type for safety.
  */
@@ -265,7 +265,7 @@ export const COLOR_SCHEME_SCRIPT_HASH = 'sha256-QOxqn7EUzb3ydF9SALJoJGWSvywW9R0A
 /**
  * The base CSP directive defaults.
  * Prioritizes safety but loosens around media and styles, relying on defense-in-depth.
- * Customizable via `CreateCspDirectivesOptions.defaults`.
+ * Customizable via `CreateCspDirectivesOptions`.
  */
 export const csp_directive_value_defaults: Record<
 	CspDirective,
@@ -336,9 +336,9 @@ export const csp_directive_required_trust_defaults: Record<CspDirective, CspTrus
  * Fuz excludes deprecated directives, so those are intentionally omitted,
  * but any newer missing directives are bugs.
  *
- * Could be moved to `csp.ts` but is currently here to keep that module smaller.
+ * Could be co-located but is currently here to keep that module smaller.
  *
- * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy}
  */
 export const csp_directive_specs: Array<CspDirectiveSpec> = [
 	{

package/src/lib/docs_helpers.svelte.ts

@@ -9,7 +9,7 @@ import {create_context} from './context_helpers.js';
  * Unlike `slugify` from `@fuzdev/fuz_util/path.js` which lowercases,
  * this keeps the original casing so API declarations like `AsyncStatus`
  * and `async_status` produce distinct fragment IDs.
- * Used by the Tome documentation system for heading and section anchors.
+ * Used by the `Tome` documentation system for heading and section anchors.
  * @param str - the string to convert to a fragment
  * @returns a URL-safe fragment identifier with case preserved
  */

package/src/lib/library.svelte.ts

@@ -17,10 +17,10 @@ export const parse_library_url_prefix = (value: unknown): string => {
  * Rich runtime representation of a library.
  *
  * Wraps `LibraryJson` with computed properties and provides the root
- * of the API documentation hierarchy: Library → modules → declarations
+ * of the API documentation hierarchy: `Library` → `Module` → `Declaration`.
  *
- * @see module.svelte.ts for Module class
- * @see declaration.svelte.ts for Declaration class
+ * @see `module.svelte.ts` for `Module` class
+ * @see `declaration.svelte.ts` for `Declaration` class
  */
 export class Library {
 	readonly library_json: LibraryJson = $state.raw()!;
@@ -58,7 +58,7 @@ export class Library {
 	);
 
 	/**
-	 * All modules as rich Module instances.
+	 * All modules as rich `Module` instances.
 	 */
 	readonly modules = $derived(
 		this.source_json.modules

package/src/lib/library_analysis.ts

@@ -36,9 +36,9 @@
  * }
  * ```
  *
- * @see ts_helpers.ts for TypeScript-specific analysis
- * @see svelte_helpers.ts for Svelte component analysis
- * @see module_helpers.ts for path utilities and SourceFileInfo
+ * @see `ts_helpers.ts` for TypeScript-specific analysis
+ * @see `svelte_helpers.ts` for Svelte component analysis
+ * @see `module_helpers.ts` for path utilities and `SourceFileInfo`
  *
  * @module
  */
@@ -63,7 +63,7 @@ import type {AnalysisContext} from './analysis_context.js';
 export interface DeclarationAnalysis {
 	/** The analyzed declaration metadata. */
 	declaration: DeclarationJson;
-	/** Whether the declaration is marked @nodocs (should be excluded from documentation). */
+	/** Whether the declaration is marked `@nodocs` (should be excluded from documentation). */
 	nodocs: boolean;
 }