@fuzdev/fuz_ui 0.182.0 → 0.183.0

package/README.md

@@ -84,7 +84,7 @@ npm run build
 npm start
 ```
 
-Fuz uses [Gro](https://github.com/ryanatkn/gro),
+Fuz uses [Gro](https://github.com/fuzdev/gro),
 my CLI and toolkit that I use to run tasks in all of my projects.
 If you're not allergic it's handy to install globally.
 

package/dist/DeclarationDetail.svelte

@@ -2,7 +2,6 @@
 	import Code from '@fuzdev/fuz_code/Code.svelte';
 
 	import type {Declaration} from './declaration.svelte.js';
-	import Details from './Details.svelte';
 	import TypeLink from './TypeLink.svelte';
 	import ModuleLink from './ModuleLink.svelte';
 	import Mdz from './Mdz.svelte';
@@ -200,11 +199,8 @@
 {#if declaration.examples?.length}
 	<section>
 		<h4>examples</h4>
-		{#each declaration.examples as example, i (example)}
-			<Details>
-				{#snippet summary()}Example {i + 1}{/snippet}
-				<Code lang="ts" content={example} />
-			</Details>
+		{#each declaration.examples as example (example)}
+			<Mdz content={example} />
 		{/each}
 	</section>
 {/if}

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

@@ -1 +1 @@
-{"version":3,"file":"DeclarationDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DeclarationDetail.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAOxD,KAAK,gBAAgB,GAAI;IAAC,WAAW,EAAE,WAAW,CAAA;CAAC,CAAC;AAiVrD,QAAA,MAAM,iBAAiB,sDAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"DeclarationDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DeclarationDetail.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAMxD,KAAK,gBAAgB,GAAI;IAAC,WAAW,EAAE,WAAW,CAAA;CAAC,CAAC;AA6UrD,QAAA,MAAM,iBAAiB,sDAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/GithubLink.svelte

@@ -15,9 +15,18 @@
 	}: SvelteHTMLElements['a'] & {
 		/**
 		 * GitHub path - can be a full URL or a relative path like `owner/repo` or `owner/repo/blob/main/file.ts`
-		 * @example fuzdev/fuz_ui
-		 * @example fuzdev/fuz_ui/blob/main/src/lib/Card.svelte
-		 * @example https://github.com/fuzdev/fuz_ui/issues/123
+		 * @example
+		 * ```ts
+		 * 'fuzdev/fuz_ui'
+		 * ```
+		 * @example
+		 * ```ts
+		 * 'fuzdev/fuz_ui/blob/main/src/lib/Card.svelte'
+		 * ```
+		 * @example
+		 * ```ts
+		 * 'https://github.com/fuzdev/fuz_ui/issues/123'
+		 * ```
 		 */
 		path?: string;
 		/** URL fragment to append, with or without the `#`. */

package/dist/GithubLink.svelte.d.ts

@@ -2,9 +2,18 @@ import type { SvelteHTMLElements } from 'svelte/elements';
 type $$ComponentProps = SvelteHTMLElements['a'] & {
     /**
      * GitHub path - can be a full URL or a relative path like `owner/repo` or `owner/repo/blob/main/file.ts`
-     * @example fuzdev/fuz_ui
-     * @example fuzdev/fuz_ui/blob/main/src/lib/Card.svelte
-     * @example https://github.com/fuzdev/fuz_ui/issues/123
+     * @example
+     * ```ts
+     * 'fuzdev/fuz_ui'
+     * ```
+     * @example
+     * ```ts
+     * 'fuzdev/fuz_ui/blob/main/src/lib/Card.svelte'
+     * ```
+     * @example
+     * ```ts
+     * 'https://github.com/fuzdev/fuz_ui/issues/123'
+     * ```
      */
     path?: string;
     /** URL fragment to append, with or without the `#`. */

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

@@ -1 +1 @@
-{"version":3,"file":"GithubLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/GithubLink.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAMvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG;IAClD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAoEH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"GithubLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/GithubLink.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAMvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG;IAClD;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAoEH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/library_gen.d.ts

@@ -13,8 +13,8 @@
  *
  * @module
  */
-import type { Gen } from '@ryanatkn/gro';
-import type { Disknode } from '@ryanatkn/gro/disknode.js';
+import type { Gen } from '@fuzdev/gro';
+import type { Disknode } from '@fuzdev/gro/disknode.js';
 import { type SourceFileInfo, type ModuleSourceOptions, type ModuleSourcePartial } from './module_helpers.js';
 import { type OnDuplicatesCallback } from './library_generate.js';
 /** Options for Gro library generation. */

package/dist/library_gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_gen.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,eAAe,CAAC;AAEvC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,2BAA2B,CAAC;AAExD,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAKxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAmB,KAAK,oBAAoB,EAAC,MAAM,uBAAuB,CAAC;AAElF,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IACjC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,QAAQ,KAAG,cAY9D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2CAA2C,GACvD,WAAW,QAAQ,CAAC,QAAQ,CAAC,EAC7B,SAAS,mBAAmB,EAC5B,MAAM;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;CAAC,KACtF,KAAK,CAAC,cAAc,CA6BtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,iBAAiB,KAAG,GA2CzD,CAAC"}
+{"version":3,"file":"library_gen.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAKxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAmB,KAAK,oBAAoB,EAAC,MAAM,uBAAuB,CAAC;AAElF,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IACjC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,QAAQ,KAAG,cAY9D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2CAA2C,GACvD,WAAW,QAAQ,CAAC,QAAQ,CAAC,EAC7B,SAAS,mBAAmB,EAC5B,MAAM;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;CAAC,KACtF,KAAK,CAAC,cAAc,CA6BtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,iBAAiB,KAAG,GA2CzD,CAAC"}

package/dist/library_gen.js

@@ -13,7 +13,7 @@
  *
  * @module
  */
-import { package_json_load } from '@ryanatkn/gro/package_json.js';
+import { package_json_load } from '@fuzdev/gro/package_json.js';
 import { module_create_source_options, module_validate_source_options, module_is_source, module_get_source_root, } from './module_helpers.js';
 import { library_generate } from './library_generate.js';
 /**

package/dist/module_helpers.d.ts

@@ -49,10 +49,12 @@ export interface SourceFileInfo {
  * handles nested directories without special heuristics.
  *
  * @example
+ * ```ts
  * const options = module_create_source_options(process.cwd(), {
  *   source_paths: ['src/lib', 'src/routes'],
  *   source_root: 'src',
  * });
+ * ```
  */
 export interface ModuleSourceOptions {
     /**
@@ -61,7 +63,10 @@ export interface ModuleSourceOptions {
      * All `source_paths` are relative to this. Typically `process.cwd()` when
      * running from the project root via Gro, Vite, or other build tools.
      *
-     * @example '/home/user/my-project'
+     * @example
+     * ```ts
+     * '/home/user/my-project'
+     * ```
      */
     project_root: string;
     /**
@@ -70,8 +75,14 @@ export interface ModuleSourceOptions {
      * Paths should not have leading or trailing slashes - they are added
      * internally for correct matching.
      *
-     * @example ['src/lib'] - single source directory
-     * @example ['src/lib', 'src/routes'] - multiple directories
+     * @example
+     * ```ts
+     * ['src/lib'] // single source directory
+     * ```
+     * @example
+     * ```ts
+     * ['src/lib', 'src/routes'] // multiple directories
+     * ```
      */
     source_paths: Array<string>;
     /**
@@ -81,8 +92,14 @@ export interface ModuleSourceOptions {
      * - Single `source_path`: defaults to that path
      * - Multiple `source_paths`: required (no auto-derivation)
      *
-     * @example 'src/lib' - module paths like 'foo.ts', 'utils/bar.ts'
-     * @example 'src' - module paths like 'lib/foo.ts', 'routes/page.svelte'
+     * @example
+     * ```ts
+     * 'src/lib' // module paths like 'foo.ts', 'utils/bar.ts'
+     * ```
+     * @example
+     * ```ts
+     * 'src' // module paths like 'lib/foo.ts', 'routes/page.svelte'
+     * ```
      */
     source_root?: string;
     /** Patterns to exclude (matched against full path). */
@@ -97,20 +114,24 @@ export interface ModuleSourceOptions {
      * @default Uses file extension: `.svelte` → svelte, `.ts`/`.js` → typescript
      *
      * @example
+     * ```ts
      * // Add MDsveX support
      * get_analyzer: (path) => {
      *   if (path.endsWith('.svelte') || path.endsWith('.svx')) return 'svelte';
      *   if (path.endsWith('.ts') || path.endsWith('.js')) return 'typescript';
      *   return null;
      * }
+     * ```
      *
      * @example
+     * ```ts
      * // Include .d.ts files
      * get_analyzer: (path) => {
      *   if (path.endsWith('.svelte')) return 'svelte';
      *   if (path.endsWith('.ts') || path.endsWith('.d.ts') || path.endsWith('.js')) return 'typescript';
      *   return null;
      * }
+     * ```
      */
     get_analyzer: (path: string) => AnalyzerType | null;
 }
@@ -142,21 +163,27 @@ export declare const MODULE_SOURCE_PARTIAL: ModuleSourcePartial;
  * @param overrides Optional overrides for default options
  *
  * @example
+ * ```ts
  * // Standard SvelteKit library
  * const options = module_create_source_options(process.cwd());
+ * ```
  *
  * @example
+ * ```ts
  * // Multiple source directories
  * const options = module_create_source_options(process.cwd(), {
  *   source_paths: ['src/lib', 'src/routes'],
  *   source_root: 'src',
  * });
+ * ```
  *
  * @example
+ * ```ts
  * // Custom exclusions
  * const options = module_create_source_options(process.cwd(), {
  *   exclude_patterns: [/\.test\.ts$/, /\.internal\.ts$/],
  * });
+ * ```
  */
 export declare const module_create_source_options: (project_root: string, overrides?: Partial<ModuleSourcePartial>) => ModuleSourceOptions;
 /**
@@ -172,14 +199,17 @@ export declare const module_create_source_options: (project_root: string, overri
  * @throws Error if validation fails
  *
  * @example
+ * ```ts
  * // Valid - single source path (source_root auto-derived)
  * module_validate_source_options({
  *   project_root: '/home/user/project',
  *   source_paths: ['src/lib'],
  *   ...
  * });
+ * ```
  *
  * @example
+ * ```ts
  * // Valid - multiple source paths with explicit source_root
  * module_validate_source_options({
  *   project_root: '/home/user/project',
@@ -187,14 +217,17 @@ export declare const module_create_source_options: (project_root: string, overri
  *   source_root: 'src',
  *   ...
  * });
+ * ```
  *
  * @example
+ * ```ts
  * // Invalid - multiple source paths without source_root
  * module_validate_source_options({
  *   project_root: '/home/user/project',
  *   source_paths: ['src/lib', 'src/routes'],  // throws
  *   ...
  * });
+ * ```
  */
 export declare const module_validate_source_options: (options: ModuleSourceOptions) => void;
 /**
@@ -214,32 +247,40 @@ export declare const module_get_source_root: (options: ModuleSourceOptions) => s
  * @param options Module source options for path extraction
  *
  * @example
+ * ```ts
  * const options = module_create_source_options('/home/user/project');
  * module_extract_path('/home/user/project/src/lib/foo.ts', options) // => 'foo.ts'
  * module_extract_path('/home/user/project/src/lib/nested/bar.svelte', options) // => 'nested/bar.svelte'
+ * ```
  *
  * @example
+ * ```ts
  * const options = module_create_source_options('/home/user/project', {
  *   source_paths: ['src/lib', 'src/routes'],
  *   source_root: 'src',
  * });
  * module_extract_path('/home/user/project/src/lib/foo.ts', options) // => 'lib/foo.ts'
  * module_extract_path('/home/user/project/src/routes/page.svelte', options) // => 'routes/page.svelte'
+ * ```
  */
 export declare const module_extract_path: (source_id: string, options: ModuleSourceOptions) => string;
 /**
  * Extract component name from a Svelte module path.
  *
  * @example
+ * ```ts
  * module_get_component_name('Alert.svelte') // => 'Alert'
  * module_get_component_name('components/Button.svelte') // => 'Button'
+ * ```
  */
 export declare const module_get_component_name: (module_path: string) => string;
 /**
  * Convert module path to module key format (with ./ prefix).
  *
  * @example
+ * ```ts
  * module_get_key('foo.ts') // => './foo.ts'
+ * ```
  */
 export declare const module_get_key: (module_path: string) => string;
 /**
@@ -269,10 +310,12 @@ export declare const module_is_test: (path: string) => boolean;
  * @returns True if the path is an analyzable source file
  *
  * @example
+ * ```ts
  * const options = module_create_source_options('/home/user/project');
  * module_is_source('/home/user/project/src/lib/foo.ts', options) // => true
  * module_is_source('/home/user/project/src/lib/foo.test.ts', options) // => false (excluded)
  * module_is_source('/home/user/project/src/fixtures/mini/src/lib/bar.ts', options) // => false (wrong prefix)
+ * ```
  */
 export declare const module_is_source: (path: string, options: ModuleSourceOptions) => boolean;
 /**

package/dist/module_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC9B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;;;;OAOG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;OAQG;IACH,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;CACpD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GAAI,MAAM,MAAM,KAAG,YAAY,GAAG,IAIzE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAInC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,4BAA4B,GACxC,cAAc,MAAM,EACpB,YAAY,OAAO,CAAC,mBAAmB,CAAC,KACtC,mBAID,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,8BAA8B,GAAI,SAAS,mBAAmB,KAAG,IAqE7E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,mBAAmB,KAAG,MAWrE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,EAAE,SAAS,mBAAmB,KAAG,MAUrF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,MAAM,KAAG,MACN,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,KAAG,MAA4B,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,OACsB,CAAC;AAE3E,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,OAAmC,CAAC;AAEpF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,OAAgC,CAAC;AAE9E,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAAiC,CAAC;AAEhF,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAAoC,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,SAAS,mBAAmB,KAAG,OAe7E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,GACvC,aAAa,cAAc,EAC3B,SAAS,mBAAmB,KAC1B;IAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CA2BzD,CAAC"}
+{"version":3,"file":"module_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC9B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;;;;;;;OAUG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;;OAcG;IACH,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;CACpD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GAAI,MAAM,MAAM,KAAG,YAAY,GAAG,IAIzE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAInC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,4BAA4B,GACxC,cAAc,MAAM,EACpB,YAAY,OAAO,CAAC,mBAAmB,CAAC,KACtC,mBAID,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,8BAA8B,GAAI,SAAS,mBAAmB,KAAG,IAqE7E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,mBAAmB,KAAG,MAWrE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,EAAE,SAAS,mBAAmB,KAAG,MAUrF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,MAAM,KAAG,MACN,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,KAAG,MAA4B,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,OACsB,CAAC;AAE3E,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,OAAmC,CAAC;AAEpF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,OAAgC,CAAC;AAE9E,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAAiC,CAAC;AAEhF,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAAoC,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,SAAS,mBAAmB,KAAG,OAe7E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,GACvC,aAAa,cAAc,EAC3B,SAAS,mBAAmB,KAC1B;IAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CA2BzD,CAAC"}

package/dist/module_helpers.js

@@ -40,21 +40,27 @@ export const MODULE_SOURCE_PARTIAL = {
  * @param overrides Optional overrides for default options
  *
  * @example
+ * ```ts
  * // Standard SvelteKit library
  * const options = module_create_source_options(process.cwd());
+ * ```
  *
  * @example
+ * ```ts
  * // Multiple source directories
  * const options = module_create_source_options(process.cwd(), {
  *   source_paths: ['src/lib', 'src/routes'],
  *   source_root: 'src',
  * });
+ * ```
  *
  * @example
+ * ```ts
  * // Custom exclusions
  * const options = module_create_source_options(process.cwd(), {
  *   exclude_patterns: [/\.test\.ts$/, /\.internal\.ts$/],
  * });
+ * ```
  */
 export const module_create_source_options = (project_root, overrides) => ({
     project_root,
@@ -74,14 +80,17 @@ export const module_create_source_options = (project_root, overrides) => ({
  * @throws Error if validation fails
  *
  * @example
+ * ```ts
  * // Valid - single source path (source_root auto-derived)
  * module_validate_source_options({
  *   project_root: '/home/user/project',
  *   source_paths: ['src/lib'],
  *   ...
  * });
+ * ```
  *
  * @example
+ * ```ts
  * // Valid - multiple source paths with explicit source_root
  * module_validate_source_options({
  *   project_root: '/home/user/project',
@@ -89,14 +98,17 @@ export const module_create_source_options = (project_root, overrides) => ({
  *   source_root: 'src',
  *   ...
  * });
+ * ```
  *
  * @example
+ * ```ts
  * // Invalid - multiple source paths without source_root
  * module_validate_source_options({
  *   project_root: '/home/user/project',
  *   source_paths: ['src/lib', 'src/routes'],  // throws
  *   ...
  * });
+ * ```
  */
 export const module_validate_source_options = (options) => {
     const { project_root, source_paths, source_root } = options;
@@ -175,17 +187,21 @@ export const module_get_source_root = (options) => {
  * @param options Module source options for path extraction
  *
  * @example
+ * ```ts
  * const options = module_create_source_options('/home/user/project');
  * module_extract_path('/home/user/project/src/lib/foo.ts', options) // => 'foo.ts'
  * module_extract_path('/home/user/project/src/lib/nested/bar.svelte', options) // => 'nested/bar.svelte'
+ * ```
  *
  * @example
+ * ```ts
  * const options = module_create_source_options('/home/user/project', {
  *   source_paths: ['src/lib', 'src/routes'],
  *   source_root: 'src',
  * });
  * module_extract_path('/home/user/project/src/lib/foo.ts', options) // => 'lib/foo.ts'
  * module_extract_path('/home/user/project/src/routes/page.svelte', options) // => 'routes/page.svelte'
+ * ```
  */
 export const module_extract_path = (source_id, options) => {
     const effective_root = module_get_source_root(options);
@@ -201,15 +217,19 @@ export const module_extract_path = (source_id, options) => {
  * Extract component name from a Svelte module path.
  *
  * @example
+ * ```ts
  * module_get_component_name('Alert.svelte') // => 'Alert'
  * module_get_component_name('components/Button.svelte') // => 'Button'
+ * ```
  */
 export const module_get_component_name = (module_path) => module_path.replace(/^.*\//, '').replace(/\.svelte$/, '');
 /**
  * Convert module path to module key format (with ./ prefix).
  *
  * @example
+ * ```ts
  * module_get_key('foo.ts') // => './foo.ts'
+ * ```
  */
 export const module_get_key = (module_path) => `./${module_path}`;
 /**
@@ -239,10 +259,12 @@ export const module_is_test = (path) => path.endsWith('.test.ts');
  * @returns True if the path is an analyzable source file
  *
  * @example
+ * ```ts
  * const options = module_create_source_options('/home/user/project');
  * module_is_source('/home/user/project/src/lib/foo.ts', options) // => true
  * module_is_source('/home/user/project/src/lib/foo.test.ts', options) // => false (excluded)
  * module_is_source('/home/user/project/src/fixtures/mini/src/lib/bar.ts', options) // => false (wrong prefix)
+ * ```
  */
 export const module_is_source = (path, options) => {
     // Check exclusion patterns first (fast regex check)

package/dist/package_helpers.d.ts

@@ -30,12 +30,16 @@ import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
  * @returns Full GitHub URL to the file on the main branch
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', 'src/index.ts')
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
+ * ```
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', './src/index.ts', 42)
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts#L42'
+ * ```
  */
 export declare const url_github_file: (repo_url: string, file_path: string, line?: number) => string;
 /**
@@ -46,8 +50,10 @@ export declare const url_github_file: (repo_url: string, file_path: string, line
  * @returns Organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
+ * ```ts
  * url_github_org('https://github.com/fuzdev/fuz_ui', 'fuz_ui')
  * // => 'https://github.com/fuzdev'
+ * ```
  */
 export declare const url_github_org: (repo_url: string, repo_name: string) => string | null;
 /**
@@ -57,12 +63,16 @@ export declare const url_github_org: (repo_url: string, repo_name: string) => st
  * @returns Owner name, or null if not a valid GitHub URL
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
  * // => 'fuzdev'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://gitlab.com/foo/bar')
  * // => null (not a GitHub URL)
+ * ```
  */
 export declare const repo_url_github_owner: (repo_url: string) => string | null;
 /**
@@ -72,8 +82,10 @@ export declare const repo_url_github_owner: (repo_url: string) => string | null;
  * @returns Full npm package page URL
  *
  * @example
+ * ```ts
  * url_npm_package('@fuzdev/fuz_ui')
  * // => 'https://www.npmjs.com/package/@fuzdev/fuz_ui'
+ * ```
  */
 export declare const url_npm_package: (package_name: string) => string;
 /**
@@ -96,12 +108,16 @@ export declare const package_is_published: (package_json: PackageJson) => boolea
  * @throws Error if scoped package name is malformed
  *
  * @example
+ * ```ts
  * repo_name_parse('@fuzdev/fuz_ui')
  * // => 'fuz_ui'
+ * ```
  *
  * @example
+ * ```ts
  * repo_name_parse('lodash')
  * // => 'lodash'
+ * ```
  */
 export declare const repo_name_parse: (name: string) => string;
 /**
@@ -114,16 +130,22 @@ export declare const repo_name_parse: (name: string) => string;
  * @returns Clean repository URL, or null if not provided
  *
  * @example
+ * ```ts
  * repo_url_parse('https://github.com/foo/bar')
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse(undefined)
  * // => null
+ * ```
  */
 export declare const repo_url_parse: (repository: PackageJson["repository"]) => string | null;
 /**
@@ -134,8 +156,10 @@ export declare const repo_url_parse: (repository: PackageJson["repository"]) =>
  * @returns Full URL to the .well-known file
  *
  * @example
+ * ```ts
  * url_well_known('https://fuz.dev', 'package.json')
  * // => 'https://fuz.dev/.well-known/package.json'
+ * ```
  */
 export declare const url_well_known: (homepage_url: string, filename: string) => string;
 //# sourceMappingURL=package_helpers.d.ts.map

package/dist/package_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,KAAG,MAIpF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAAM,GAAG,IAE7E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,IAKjE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,KAAG,MACP,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,KAAG,OAEhE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAS9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,WAAW,CAAC,YAAY,CAAC,KAAG,MAAM,GAAG,IAK/E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAEvE,CAAC"}
+{"version":3,"file":"package_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,KAAG,MAIpF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAAM,GAAG,IAE7E,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,IAKjE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,KAAG,MACP,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,KAAG,OAEhE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAS9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,WAAW,CAAC,YAAY,CAAC,KAAG,MAAM,GAAG,IAK/E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAEvE,CAAC"}

package/dist/package_helpers.js

@@ -30,12 +30,16 @@ import { ensure_end, strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
  * @returns Full GitHub URL to the file on the main branch
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', 'src/index.ts')
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
+ * ```
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', './src/index.ts', 42)
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts#L42'
+ * ```
  */
 export const url_github_file = (repo_url, file_path, line) => {
     const clean_path = file_path.replace(/^\.\//, '');
@@ -50,8 +54,10 @@ export const url_github_file = (repo_url, file_path, line) => {
  * @returns Organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
+ * ```ts
  * url_github_org('https://github.com/fuzdev/fuz_ui', 'fuz_ui')
  * // => 'https://github.com/fuzdev'
+ * ```
  */
 export const url_github_org = (repo_url, repo_name) => {
     return repo_url.endsWith('/' + repo_name) ? strip_end(repo_url, '/' + repo_name) : null;
@@ -63,12 +69,16 @@ export const url_github_org = (repo_url, repo_name) => {
  * @returns Owner name, or null if not a valid GitHub URL
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
  * // => 'fuzdev'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://gitlab.com/foo/bar')
  * // => null (not a GitHub URL)
+ * ```
  */
 export const repo_url_github_owner = (repo_url) => {
     const stripped = strip_start(repo_url, 'https://github.com/');
@@ -84,8 +94,10 @@ export const repo_url_github_owner = (repo_url) => {
  * @returns Full npm package page URL
  *
  * @example
+ * ```ts
  * url_npm_package('@fuzdev/fuz_ui')
  * // => 'https://www.npmjs.com/package/@fuzdev/fuz_ui'
+ * ```
  */
 export const url_npm_package = (package_name) => 'https://www.npmjs.com/package/' + package_name;
 /**
@@ -110,12 +122,16 @@ export const package_is_published = (package_json) => {
  * @throws Error if scoped package name is malformed
  *
  * @example
+ * ```ts
  * repo_name_parse('@fuzdev/fuz_ui')
  * // => 'fuz_ui'
+ * ```
  *
  * @example
+ * ```ts
  * repo_name_parse('lodash')
  * // => 'lodash'
+ * ```
  */
 export const repo_name_parse = (name) => {
     if (name[0] === '@') {
@@ -137,16 +153,22 @@ export const repo_name_parse = (name) => {
  * @returns Clean repository URL, or null if not provided
  *
  * @example
+ * ```ts
  * repo_url_parse('https://github.com/foo/bar')
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse(undefined)
  * // => null
+ * ```
  */
 export const repo_url_parse = (repository) => {
     if (!repository)
@@ -164,8 +186,10 @@ export const repo_url_parse = (repository) => {
  * @returns Full URL to the .well-known file
  *
  * @example
+ * ```ts
  * url_well_known('https://fuz.dev', 'package.json')
  * // => 'https://fuz.dev/.well-known/package.json'
+ * ```
  */
 export const url_well_known = (homepage_url, filename) => {
     return `${ensure_end(homepage_url, '/')}.well-known/${filename}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.182.0",
+  "version": "0.183.0",
   "description": "Svelte UI library",
   "motto": "friendly user zystem",
   "glyph": "🧶",
@@ -35,9 +35,10 @@
     "node": ">=22.15"
   },
   "peerDependencies": {
-    "@fuzdev/fuz_code": ">=0.44.0",
+    "@fuzdev/fuz_code": ">=0.45.0",
     "@fuzdev/fuz_css": ">=0.47.0",
-    "@fuzdev/fuz_util": ">=0.49.2",
+    "@fuzdev/fuz_util": ">=0.50.1",
+    "@fuzdev/gro": ">=0.192.0",
     "@jridgewell/trace-mapping": "^0.3",
     "@ryanatkn/gro": ">=0.191.0",
     "@sveltejs/kit": "^2.47.3",
@@ -54,6 +55,9 @@
     "@fuzdev/fuz_util": {
       "optional": true
     },
+    "@fuzdev/gro": {
+      "optional": true
+    },
     "@jridgewell/trace-mapping": {
       "optional": true
     },
@@ -75,9 +79,10 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/fuz_code": "^0.44.1",
-    "@fuzdev/fuz_css": "^0.47.0",
+    "@fuzdev/fuz_code": "^0.45.0",
+    "@fuzdev/fuz_css": "^0.49.0",
     "@fuzdev/fuz_util": "^0.50.1",
+    "@fuzdev/gro": "^0.192.1",
     "@jridgewell/trace-mapping": "^0.3.31",
     "@ryanatkn/eslint-config": "^0.9.0",
     "@ryanatkn/gro": "^0.191.0",
@@ -97,13 +102,13 @@
     "prettier-plugin-svelte": "^3.4.1",
     "svelte": "^5.49.1",
     "svelte-check": "^4.3.6",
-    "svelte2tsx": "^0.7.46",
+    "svelte2tsx": "^0.7.47",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.1",
     "vitest": "^4.0.15",
     "zimmerframe": "^1.1.4",
-    "zod": "^4.1.13"
+    "zod": "^4.3.6"
   },
   "prettier": {
     "plugins": [

package/src/lib/library_gen.ts

@@ -14,9 +14,9 @@
  * @module
  */
 
-import type {Gen} from '@ryanatkn/gro';
-import {package_json_load} from '@ryanatkn/gro/package_json.js';
-import type {Disknode} from '@ryanatkn/gro/disknode.js';
+import type {Gen} from '@fuzdev/gro';
+import {package_json_load} from '@fuzdev/gro/package_json.js';
+import type {Disknode} from '@fuzdev/gro/disknode.js';
 
 import {
 	type SourceFileInfo,

package/src/lib/module_helpers.ts

@@ -52,10 +52,12 @@ export interface SourceFileInfo {
  * handles nested directories without special heuristics.
  *
  * @example
+ * ```ts
  * const options = module_create_source_options(process.cwd(), {
  *   source_paths: ['src/lib', 'src/routes'],
  *   source_root: 'src',
  * });
+ * ```
  */
 export interface ModuleSourceOptions {
 	/**
@@ -64,7 +66,10 @@ export interface ModuleSourceOptions {
 	 * All `source_paths` are relative to this. Typically `process.cwd()` when
 	 * running from the project root via Gro, Vite, or other build tools.
 	 *
-	 * @example '/home/user/my-project'
+	 * @example
+	 * ```ts
+	 * '/home/user/my-project'
+	 * ```
 	 */
 	project_root: string;
 	/**
@@ -73,8 +78,14 @@ export interface ModuleSourceOptions {
 	 * Paths should not have leading or trailing slashes - they are added
 	 * internally for correct matching.
 	 *
-	 * @example ['src/lib'] - single source directory
-	 * @example ['src/lib', 'src/routes'] - multiple directories
+	 * @example
+	 * ```ts
+	 * ['src/lib'] // single source directory
+	 * ```
+	 * @example
+	 * ```ts
+	 * ['src/lib', 'src/routes'] // multiple directories
+	 * ```
 	 */
 	source_paths: Array<string>;
 	/**
@@ -84,8 +95,14 @@ export interface ModuleSourceOptions {
 	 * - Single `source_path`: defaults to that path
 	 * - Multiple `source_paths`: required (no auto-derivation)
 	 *
-	 * @example 'src/lib' - module paths like 'foo.ts', 'utils/bar.ts'
-	 * @example 'src' - module paths like 'lib/foo.ts', 'routes/page.svelte'
+	 * @example
+	 * ```ts
+	 * 'src/lib' // module paths like 'foo.ts', 'utils/bar.ts'
+	 * ```
+	 * @example
+	 * ```ts
+	 * 'src' // module paths like 'lib/foo.ts', 'routes/page.svelte'
+	 * ```
 	 */
 	source_root?: string;
 	/** Patterns to exclude (matched against full path). */
@@ -100,20 +117,24 @@ export interface ModuleSourceOptions {
 	 * @default Uses file extension: `.svelte` → svelte, `.ts`/`.js` → typescript
 	 *
 	 * @example
+	 * ```ts
 	 * // Add MDsveX support
 	 * get_analyzer: (path) => {
 	 *   if (path.endsWith('.svelte') || path.endsWith('.svx')) return 'svelte';
 	 *   if (path.endsWith('.ts') || path.endsWith('.js')) return 'typescript';
 	 *   return null;
 	 * }
+	 * ```
 	 *
 	 * @example
+	 * ```ts
 	 * // Include .d.ts files
 	 * get_analyzer: (path) => {
 	 *   if (path.endsWith('.svelte')) return 'svelte';
 	 *   if (path.endsWith('.ts') || path.endsWith('.d.ts') || path.endsWith('.js')) return 'typescript';
 	 *   return null;
 	 * }
+	 * ```
 	 */
 	get_analyzer: (path: string) => AnalyzerType | null;
 }
@@ -157,21 +178,27 @@ export const MODULE_SOURCE_PARTIAL: ModuleSourcePartial = {
  * @param overrides Optional overrides for default options
  *
  * @example
+ * ```ts
  * // Standard SvelteKit library
  * const options = module_create_source_options(process.cwd());
+ * ```
  *
  * @example
+ * ```ts
  * // Multiple source directories
  * const options = module_create_source_options(process.cwd(), {
  *   source_paths: ['src/lib', 'src/routes'],
  *   source_root: 'src',
  * });
+ * ```
  *
  * @example
+ * ```ts
  * // Custom exclusions
  * const options = module_create_source_options(process.cwd(), {
  *   exclude_patterns: [/\.test\.ts$/, /\.internal\.ts$/],
  * });
+ * ```
  */
 export const module_create_source_options = (
 	project_root: string,
@@ -195,14 +222,17 @@ export const module_create_source_options = (
  * @throws Error if validation fails
  *
  * @example
+ * ```ts
  * // Valid - single source path (source_root auto-derived)
  * module_validate_source_options({
  *   project_root: '/home/user/project',
  *   source_paths: ['src/lib'],
  *   ...
  * });
+ * ```
  *
  * @example
+ * ```ts
  * // Valid - multiple source paths with explicit source_root
  * module_validate_source_options({
  *   project_root: '/home/user/project',
@@ -210,14 +240,17 @@ export const module_create_source_options = (
  *   source_root: 'src',
  *   ...
  * });
+ * ```
  *
  * @example
+ * ```ts
  * // Invalid - multiple source paths without source_root
  * module_validate_source_options({
  *   project_root: '/home/user/project',
  *   source_paths: ['src/lib', 'src/routes'],  // throws
  *   ...
  * });
+ * ```
  */
 export const module_validate_source_options = (options: ModuleSourceOptions): void => {
 	const {project_root, source_paths, source_root} = options;
@@ -319,17 +352,21 @@ export const module_get_source_root = (options: ModuleSourceOptions): string =>
  * @param options Module source options for path extraction
  *
  * @example
+ * ```ts
  * const options = module_create_source_options('/home/user/project');
  * module_extract_path('/home/user/project/src/lib/foo.ts', options) // => 'foo.ts'
  * module_extract_path('/home/user/project/src/lib/nested/bar.svelte', options) // => 'nested/bar.svelte'
+ * ```
  *
  * @example
+ * ```ts
  * const options = module_create_source_options('/home/user/project', {
  *   source_paths: ['src/lib', 'src/routes'],
  *   source_root: 'src',
  * });
  * module_extract_path('/home/user/project/src/lib/foo.ts', options) // => 'lib/foo.ts'
  * module_extract_path('/home/user/project/src/routes/page.svelte', options) // => 'routes/page.svelte'
+ * ```
  */
 export const module_extract_path = (source_id: string, options: ModuleSourceOptions): string => {
 	const effective_root = module_get_source_root(options);
@@ -347,8 +384,10 @@ export const module_extract_path = (source_id: string, options: ModuleSourceOpti
  * Extract component name from a Svelte module path.
  *
  * @example
+ * ```ts
  * module_get_component_name('Alert.svelte') // => 'Alert'
  * module_get_component_name('components/Button.svelte') // => 'Button'
+ * ```
  */
 export const module_get_component_name = (module_path: string): string =>
 	module_path.replace(/^.*\//, '').replace(/\.svelte$/, '');
@@ -357,7 +396,9 @@ export const module_get_component_name = (module_path: string): string =>
  * Convert module path to module key format (with ./ prefix).
  *
  * @example
+ * ```ts
  * module_get_key('foo.ts') // => './foo.ts'
+ * ```
  */
 export const module_get_key = (module_path: string): string => `./${module_path}`;
 
@@ -394,10 +435,12 @@ export const module_is_test = (path: string): boolean => path.endsWith('.test.ts
  * @returns True if the path is an analyzable source file
  *
  * @example
+ * ```ts
  * const options = module_create_source_options('/home/user/project');
  * module_is_source('/home/user/project/src/lib/foo.ts', options) // => true
  * module_is_source('/home/user/project/src/lib/foo.test.ts', options) // => false (excluded)
  * module_is_source('/home/user/project/src/fixtures/mini/src/lib/bar.ts', options) // => false (wrong prefix)
+ * ```
  */
 export const module_is_source = (path: string, options: ModuleSourceOptions): boolean => {
 	// Check exclusion patterns first (fast regex check)

package/src/lib/package_helpers.ts

@@ -33,12 +33,16 @@ import type {PackageJson} from '@fuzdev/fuz_util/package_json.js';
  * @returns Full GitHub URL to the file on the main branch
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', 'src/index.ts')
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
+ * ```
  *
  * @example
+ * ```ts
  * url_github_file('https://github.com/foo/bar', './src/index.ts', 42)
  * // => 'https://github.com/foo/bar/blob/main/src/index.ts#L42'
+ * ```
  */
 export const url_github_file = (repo_url: string, file_path: string, line?: number): string => {
 	const clean_path = file_path.replace(/^\.\//, '');
@@ -54,8 +58,10 @@ export const url_github_file = (repo_url: string, file_path: string, line?: numb
  * @returns Organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
+ * ```ts
  * url_github_org('https://github.com/fuzdev/fuz_ui', 'fuz_ui')
  * // => 'https://github.com/fuzdev'
+ * ```
  */
 export const url_github_org = (repo_url: string, repo_name: string): string | null => {
 	return repo_url.endsWith('/' + repo_name) ? strip_end(repo_url, '/' + repo_name) : null;
@@ -68,12 +74,16 @@ export const url_github_org = (repo_url: string, repo_name: string): string | nu
  * @returns Owner name, or null if not a valid GitHub URL
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
  * // => 'fuzdev'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_github_owner('https://gitlab.com/foo/bar')
  * // => null (not a GitHub URL)
+ * ```
  */
 export const repo_url_github_owner = (repo_url: string): string | null => {
 	const stripped = strip_start(repo_url, 'https://github.com/');
@@ -89,8 +99,10 @@ export const repo_url_github_owner = (repo_url: string): string | null => {
  * @returns Full npm package page URL
  *
  * @example
+ * ```ts
  * url_npm_package('@fuzdev/fuz_ui')
  * // => 'https://www.npmjs.com/package/@fuzdev/fuz_ui'
+ * ```
  */
 export const url_npm_package = (package_name: string): string =>
 	'https://www.npmjs.com/package/' + package_name;
@@ -118,12 +130,16 @@ export const package_is_published = (package_json: PackageJson): boolean => {
  * @throws Error if scoped package name is malformed
  *
  * @example
+ * ```ts
  * repo_name_parse('@fuzdev/fuz_ui')
  * // => 'fuz_ui'
+ * ```
  *
  * @example
+ * ```ts
  * repo_name_parse('lodash')
  * // => 'lodash'
+ * ```
  */
 export const repo_name_parse = (name: string): string => {
 	if (name[0] === '@') {
@@ -146,16 +162,22 @@ export const repo_name_parse = (name: string): string => {
  * @returns Clean repository URL, or null if not provided
  *
  * @example
+ * ```ts
  * repo_url_parse('https://github.com/foo/bar')
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
  * // => 'https://github.com/foo/bar'
+ * ```
  *
  * @example
+ * ```ts
  * repo_url_parse(undefined)
  * // => null
+ * ```
  */
 export const repo_url_parse = (repository: PackageJson['repository']): string | null => {
 	if (!repository) return null;
@@ -172,8 +194,10 @@ export const repo_url_parse = (repository: PackageJson['repository']): string |
  * @returns Full URL to the .well-known file
  *
  * @example
+ * ```ts
  * url_well_known('https://fuz.dev', 'package.json')
  * // => 'https://fuz.dev/.well-known/package.json'
+ * ```
  */
 export const url_well_known = (homepage_url: string, filename: string): string => {
 	return `${ensure_end(homepage_url, '/')}.well-known/${filename}`;