@fuzdev/fuz_ui 0.191.0 → 0.191.2

package/dist/storage.js

@@ -20,7 +20,7 @@ export const save_to_storage = (key, value, is_json = false) => {
  * @param key - the localStorage key
  * @param is_json - whether to parse the value as JSON
  * @param parse_fn - optional custom parsing function to transform the value
- * @returns The parsed value or null if not found or parsing fails
+ * @returns the parsed value or null if not found or parsing fails
  */
 export const load_from_storage = (key, is_json = false, parse_fn) => {
     if (!BROWSER)

package/dist/svelte_helpers.d.ts

@@ -48,7 +48,7 @@ export interface SvelteFileAnalysis {
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module analysis matching ModuleAnalysis structure
+ * @returns module analysis matching `ModuleAnalysis` structure
  */
 export declare const svelte_analyze_module: (source_file: SourceFileInfo, module_path: string, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleAnalysis;
 /**
@@ -65,7 +65,7 @@ export declare const svelte_analyze_module: (source_file: SourceFileInfo, module
  * @param module_path - module path relative to source root (e.g., 'Alert.svelte')
  * @param checker - TypeScript type checker for type resolution
  * @param ctx - analysis context for collecting diagnostics
- * @returns Component declaration and optional module-level comment
+ * @returns component declaration and optional module-level comment
  */
 export declare const svelte_analyze_file: (source_file: SourceFileInfo, module_path: string, checker: ts.TypeChecker, ctx: AnalysisContext) => SvelteFileAnalysis;
 /**
@@ -85,8 +85,8 @@ export declare const svelte_extract_script_content: (svelte_source: string) => s
  * Requires `@module` tag to identify module comments. The tag line is stripped
  * from the output.
  *
- * @param script_content - The content of the `<script>` tag.
- * @returns The cleaned module comment text, or undefined if none found.
+ * @param script_content - the content of the `<script>` tag
+ * @returns the cleaned module comment text, or undefined if none found
  */
 export declare const svelte_extract_module_comment: (script_content: string) => string | undefined;
 //# sourceMappingURL=svelte_helpers.d.ts.map

package/dist/svelte_helpers.js

@@ -58,7 +58,7 @@ const svelte_assert_version = () => {
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module analysis matching ModuleAnalysis structure
+ * @returns module analysis matching `ModuleAnalysis` structure
  */
 export const svelte_analyze_module = (source_file, module_path, checker, options, ctx) => {
     // Use the existing helper for core analysis
@@ -90,7 +90,7 @@ export const svelte_analyze_module = (source_file, module_path, checker, options
  * @param module_path - module path relative to source root (e.g., 'Alert.svelte')
  * @param checker - TypeScript type checker for type resolution
  * @param ctx - analysis context for collecting diagnostics
- * @returns Component declaration and optional module-level comment
+ * @returns component declaration and optional module-level comment
  */
 export const svelte_analyze_file = (source_file, module_path, checker, ctx) => {
     svelte_assert_version();
@@ -172,8 +172,8 @@ export const svelte_extract_script_content = (svelte_source) => {
  * Requires `@module` tag to identify module comments. The tag line is stripped
  * from the output.
  *
- * @param script_content - The content of the `<script>` tag.
- * @returns The cleaned module comment text, or undefined if none found.
+ * @param script_content - the content of the `<script>` tag
+ * @returns the cleaned module comment text, or undefined if none found
  */
 export const svelte_extract_module_comment = (script_content) => {
     // Parse the script content as TypeScript and reuse the shared extraction logic

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']
      */
@@ -59,7 +59,7 @@ export interface SveltePreprocessMdzOptions {
  * Creates a Svelte preprocessor that compiles static `Mdz` content at build time.
  *
  * @param options - configuration for component/element resolution and file filtering
- * @returns A Svelte `PreprocessorGroup` for use in `svelte.config.js`.
+ * @returns a Svelte `PreprocessorGroup` for use in `svelte.config.js`
  */
 export declare const svelte_preprocess_mdz: (options?: SveltePreprocessMdzOptions) => PreprocessorGroup;
 //# sourceMappingURL=svelte_preprocess_mdz.d.ts.map

package/dist/svelte_preprocess_mdz.js

@@ -25,7 +25,7 @@ const PRECOMPILED_NAME = 'MdzPrecompiled';
  * Creates a Svelte preprocessor that compiles static `Mdz` content at build time.
  *
  * @param options - configuration for component/element resolution and file filtering
- * @returns A Svelte `PreprocessorGroup` for use in `svelte.config.js`.
+ * @returns a Svelte `PreprocessorGroup` for use in `svelte.config.js`
  */
 export const svelte_preprocess_mdz = (options = {}) => {
     const { exclude = [], components = {}, elements: elements_array = [], component_imports = ['@fuzdev/fuz_ui/Mdz.svelte'], compiled_component_import = '@fuzdev/fuz_ui/MdzPrecompiled.svelte', on_error = process.env.CI === 'true' ? 'throw' : 'log', } = options;
@@ -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/tome.d.ts

@@ -10,7 +10,7 @@ export declare const Tome: z.ZodObject<{
 }, z.core.$strip>;
 export type Tome = z.infer<typeof Tome>;
 /**
- * @param hash - URL fragment to append, with or without the `#`.
+ * @param hash - URL fragment to append, with or without the `#`
  */
 export declare const to_tome_pathname: (item: Tome | string, docs_path?: string, hash?: string) => string;
 export declare const tomes_context: {

package/dist/tome.js

@@ -13,7 +13,7 @@ export const Tome = z.object({
     related_declarations: z.array(z.string()),
 });
 /**
- * @param hash - URL fragment to append, with or without the `#`.
+ * @param hash - URL fragment to append, with or without the `#`
  */
 export const to_tome_pathname = (item, docs_path = DOCS_PATH_DEFAULT, hash) => {
     const name = typeof item === 'string' ? item : item.name;

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>;
@@ -48,8 +48,8 @@ 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
+ * @returns the program and type checker
+ * @throws Error if `tsconfig.json` is not found
  */
 export declare const ts_create_program: (options?: TsProgramOptions, log?: Logger) => TsProgram;
 /**
@@ -67,7 +67,7 @@ export declare const ts_create_program: (options?: TsProgramOptions, log?: Logge
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module metadata and re-export information
+ * @returns module metadata and re-export information
  */
 export declare const ts_analyze_module: (source_file_info: SourceFileInfo, ts_source_file: ts.SourceFile, module_path: string, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleAnalysis;
 /**
@@ -87,7 +87,7 @@ export declare const ts_analyze_module: (source_file_info: SourceFileInfo, ts_so
  * @param checker - the TypeScript type checker
  * @param options - module source options for path extraction in re-exports
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module comment, declarations, re-exports, and star exports
+ * @returns module comment, declarations, re-exports, and star exports
  */
 export declare const ts_analyze_module_exports: (source_file: ts.SourceFile, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleExportsAnalysis;
 /**
@@ -101,7 +101,7 @@ export declare const ts_analyze_module_exports: (source_file: ts.SourceFile, che
  * @param source_file - the source file containing the symbol
  * @param checker - the TypeScript type checker
  * @param ctx - optional analysis context for collecting diagnostics
- * @returns Complete declaration metadata including docs, types, and parameters, plus nodocs flag
+ * @returns complete declaration metadata including docs, types, and parameters, plus nodocs flag
  */
 export declare const ts_analyze_declaration: (symbol: ts.Symbol, source_file: ts.SourceFile, checker: ts.TypeChecker, ctx: AnalysisContext) => DeclarationAnalysis;
 /**
@@ -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;
 /**
@@ -133,7 +133,7 @@ export declare const ts_infer_declaration_kind: (symbol: ts.Symbol, node: ts.Nod
  * @param sig - the TypeScript signature to extract parameters from
  * @param checker - TypeScript type checker for type resolution
  * @param tsdoc_params - map of parameter names to TSDoc descriptions (from tsdoc.params)
- * @returns Array of parameter info objects
+ * @returns array of parameter info objects
  */
 export declare const ts_extract_signature_parameters: (sig: ts.Signature, checker: ts.TypeChecker, tsdoc_params: Map<string, string> | undefined) => Array<{
     name: string;

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

@@ -13,8 +13,8 @@ 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
+ * @returns the program and type checker
+ * @throws Error if `tsconfig.json` is not found
  */
 export const ts_create_program = (options, log) => {
     const root = options?.root ?? './';
@@ -48,7 +48,7 @@ export const ts_create_program = (options, log) => {
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module metadata and re-export information
+ * @returns module metadata and re-export information
  */
 export const ts_analyze_module = (source_file_info, ts_source_file, module_path, checker, options, ctx) => {
     // Use the mid-level helper for core analysis
@@ -82,7 +82,7 @@ export const ts_analyze_module = (source_file_info, ts_source_file, module_path,
  * @param checker - the TypeScript type checker
  * @param options - module source options for path extraction in re-exports
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module comment, declarations, re-exports, and star exports
+ * @returns module comment, declarations, re-exports, and star exports
  */
 export const ts_analyze_module_exports = (source_file, checker, options, ctx) => {
     const declarations = [];
@@ -184,7 +184,7 @@ export const ts_analyze_module_exports = (source_file, checker, options, ctx) =>
  * @param source_file - the source file containing the symbol
  * @param checker - the TypeScript type checker
  * @param ctx - optional analysis context for collecting diagnostics
- * @returns Complete declaration metadata including docs, types, and parameters, plus nodocs flag
+ * @returns complete declaration metadata including docs, types, and parameters, plus nodocs flag
  */
 export const ts_analyze_declaration = (symbol, source_file, checker, ctx) => {
     const name = symbol.name;
@@ -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();
@@ -328,7 +328,7 @@ export const ts_infer_declaration_kind = (symbol, node) => {
  * @param sig - the TypeScript signature to extract parameters from
  * @param checker - TypeScript type checker for type resolution
  * @param tsdoc_params - map of parameter names to TSDoc descriptions (from tsdoc.params)
- * @returns Array of parameter info objects
+ * @returns array of parameter info objects
  */
 export const ts_extract_signature_parameters = (sig, checker, tsdoc_params) => {
     return sig.parameters.map((param) => {

package/dist/tsdoc_helpers.d.ts

@@ -104,7 +104,7 @@ export declare const tsdoc_apply_to_declaration: (declaration: DeclarationJson,
  * Transforms `/** ... *\/` style comments into clean text.
  *
  * @param comment_text - the raw comment text including `/**` and `*\/` markers
- * @returns Cleaned comment text, or undefined if empty after cleaning
+ * @returns cleaned comment text, or undefined if empty after cleaning
  */
 export declare const tsdoc_clean_comment: (comment_text: string) => string | undefined;
 //# sourceMappingURL=tsdoc_helpers.d.ts.map

package/dist/tsdoc_helpers.js

@@ -183,7 +183,7 @@ export const tsdoc_apply_to_declaration = (declaration, tsdoc) => {
  * Transforms `/** ... *\/` style comments into clean text.
  *
  * @param comment_text - the raw comment text including `/**` and `*\/` markers
- * @returns Cleaned comment text, or undefined if empty after cleaning
+ * @returns cleaned comment text, or undefined if empty after cleaning
  */
 export const tsdoc_clean_comment = (comment_text) => {
     const text = comment_text

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.0",
+  "version": "0.191.2",
   "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.56.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",
@@ -100,10 +100,10 @@
     "jsdom": "^27.2.0",
     "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
-    "prettier-plugin-svelte": "^3.4.1",
-    "svelte": "^5.53.12",
+    "prettier-plugin-svelte": "^3.5.1",
+    "svelte": "^5.54.1",
     "svelte-check": "^4.4.5",
-    "svelte2tsx": "^0.7.47",
+    "svelte2tsx": "^0.7.52",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.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}>>;
@@ -227,7 +231,7 @@ export interface FormatDiagnosticOptions {
  *
  * @param diagnostic - the diagnostic to format
  * @param options - formatting options
- * @returns Formatted string like './file.ts:10:5: error: message'
+ * @returns formatted string like './file.ts:10:5: error: message'
  */
 export const format_diagnostic = (
 	diagnostic: Diagnostic,

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;
 }
 
@@ -118,7 +118,7 @@ export interface ModuleAnalysis {
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
  * @param log - optional logger for warnings
- * @returns Module metadata and re-exports, or undefined if source file not found in program
+ * @returns module metadata and re-exports, or undefined if source file not found in program
  */
 export const library_analyze_module = (
 	source_file: SourceFileInfo,

package/src/lib/library_gen.ts

@@ -7,9 +7,9 @@
  *
  * For build-tool agnostic usage, see `library_generate.ts`.
  *
- * @see library_generate.ts for the generic generation entry point
- * @see library_pipeline.ts for pipeline helpers
- * @see library_output.ts for output file generation
+ * @see `library_generate.ts` for the generic generation entry point
+ * @see `library_pipeline.ts` for pipeline helpers
+ * @see `library_output.ts` for output file generation
  *
  * @module
  */
@@ -46,6 +46,7 @@ export interface LibraryGenOptions {
 	 * Use `library_throw_on_duplicates` for strict flat namespace enforcement.
 	 *
 	 * @example
+	 * ```ts
 	 * // Throw on duplicates (strict flat namespace)
 	 * library_gen({ on_duplicates: library_throw_on_duplicates });
 	 *
@@ -57,12 +58,13 @@ export interface LibraryGenOptions {
 	 *     }
 	 *   }
 	 * });
+	 * ```
 	 */
 	on_duplicates?: OnDuplicatesCallback;
 }
 
 /**
- * Convert Gro's Disknode to the build-tool agnostic SourceFileInfo interface.
+ * Convert Gro's `Disknode` to the build-tool agnostic `SourceFileInfo` interface.
  *
  * Use this when you want to analyze files using Gro's filer directly.
  *
@@ -83,7 +85,7 @@ export const source_file_from_disknode = (disknode: Disknode): SourceFileInfo =>
 };
 
 /**
- * Collect source files from Gro disknodes, filtering BEFORE conversion to SourceFileInfo.
+ * Collect source files from Gro disknodes, filtering BEFORE conversion to `SourceFileInfo`.
  *
  * This avoids errors from files outside source directories (like test fixtures that may
  * have malformed paths or missing content). The filtering uses `module_is_source` which
@@ -129,12 +131,12 @@ export const library_collect_source_files_from_disknodes = (
 };
 
 /**
- * Creates a Gen object for generating library metadata with full TypeScript analysis.
+ * Creates a `Gen` object for generating library metadata with full TypeScript analysis.
  *
  * This is the Gro-specific entry point. It handles:
  * - Reading files from Gro's filer
- * - Loading package.json via Gro utilities
- * - Returning output in Gro's Gen format
+ * - Loading `package.json` via Gro utilities
+ * - Returning output in Gro's `Gen` format
  *
  * For build-tool agnostic usage, use `library_generate` directly.
  *