@fuzdev/fuz_ui 0.181.1 → 0.182.1

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}
@@ -323,13 +319,13 @@
 					<Mdz content={prop.doc_comment} />
 				{/if}
 				{#if prop.type_signature}
-					<div class="row gap_md">
+					<div class="row gap_md mt_lg">
 						<strong>type</strong>
 						<TypeLink type={prop.type_signature} />
 					</div>
 				{/if}
 				{#if prop.modifiers?.length}
-					<div class="row gap_md">
+					<div class="row gap_md mt_lg">
 						{#each prop.modifiers as modifier (modifier)}
 							<span class="chip">{modifier}</span>
 						{/each}

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/Mdz.svelte

@@ -21,7 +21,7 @@
 <svelte:element
 	this={inline ? 'span' : 'div'}
 	{...rest}
-	class="{rest.class} {nowrap ? 'white-space:pre' : 'white-space:pre-wrap'}"
+	style:white-space={nowrap ? 'pre' : 'pre-wrap'}
 >
 	{#each nodes as node (node)}
 		<MdzNodeView {node} />

package/dist/MdzPrecompiled.svelte

@@ -0,0 +1,30 @@
+<script lang="ts">
+	import type {Snippet} from 'svelte';
+	import type {SvelteHTMLElements} from 'svelte/elements';
+
+	/**
+	 * Wrapper for precompiled mdz content. Used by `svelte_preprocess_mdz`.
+	 * Not intended for direct use.
+	 *
+	 * @module
+	 */
+
+	const {
+		inline = false,
+		nowrap = false,
+		children,
+		...rest
+	}: (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
+		inline?: boolean;
+		nowrap?: boolean;
+		children: Snippet;
+	} = $props();
+</script>
+
+<svelte:element
+	this={inline ? 'span' : 'div'}
+	{...rest}
+	style:white-space={nowrap ? 'pre' : 'pre-wrap'}
+>
+	{@render children()}
+</svelte:element>

package/dist/MdzPrecompiled.svelte.d.ts

@@ -0,0 +1,11 @@
+import type { Snippet } from 'svelte';
+import type { SvelteHTMLElements } from 'svelte/elements';
+type $$ComponentProps = (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
+    inline?: boolean;
+    nowrap?: boolean;
+    children: Snippet;
+};
+declare const MdzPrecompiled: import("svelte").Component<$$ComponentProps, {}, "">;
+type MdzPrecompiled = ReturnType<typeof MdzPrecompiled>;
+export default MdzPrecompiled;
+//# sourceMappingURL=MdzPrecompiled.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MdzPrecompiled.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/MdzPrecompiled.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAEvD,KAAK,gBAAgB,GAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AA0BH,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/declaration.svelte.d.ts

@@ -12,7 +12,7 @@ export declare class Declaration {
      */
     module_path: string;
     name: string;
-    kind: "function" | "class" | "type" | "constructor" | "json" | "variable" | "component" | "css";
+    kind: "function" | "class" | "type" | "json" | "variable" | "constructor" | "component" | "css";
     /**
      * GitHub source URL with line number.
      */

package/dist/library.svelte.d.ts

@@ -86,7 +86,7 @@ export declare class Library {
             declarations?: {
                 [x: string]: unknown;
                 name: string;
-                kind: "function" | "class" | "type" | "constructor" | "json" | "variable" | "component" | "css";
+                kind: "function" | "class" | "type" | "json" | "variable" | "constructor" | "component" | "css";
                 doc_comment?: string | undefined;
                 type_signature?: string | undefined;
                 modifiers?: string[] | undefined;

package/dist/mdz_to_svelte.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Converts parsed `MdzNode` arrays to Svelte markup strings.
+ *
+ * Used by the `svelte_preprocess_mdz` preprocessor to expand static `<Mdz content="...">` usages
+ * into pre-rendered Svelte markup at build time. The output for each node type matches what
+ * `MdzNodeView.svelte` renders at runtime, so precompiled and runtime rendering are identical.
+ *
+ * @module
+ */
+import type { MdzNode } from './mdz.js';
+/**
+ * Result of converting `MdzNode` arrays to Svelte markup.
+ */
+export interface MdzToSvelteResult {
+    /** Generated Svelte markup string. */
+    markup: string;
+    /** Required imports: `Map<local_name, {path, kind}>`. */
+    imports: Map<string, {
+        path: string;
+        kind: 'default' | 'named';
+    }>;
+    /** Whether content references unconfigured Component or Element tags. */
+    has_unconfigured_tags: boolean;
+}
+/**
+ * Converts an array of `MdzNode` to a Svelte markup string.
+ *
+ * Each node type produces output matching what `MdzNodeView.svelte` renders at runtime.
+ * Collects required imports and flags unconfigured component/element references.
+ *
+ * @param nodes Parsed mdz nodes to render.
+ * @param components Component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`).
+ *   If content references a component not in this map, `has_unconfigured_tags` is set.
+ * @param elements Allowed HTML element names (e.g., `new Set(['aside', 'details'])`).
+ *   If content references an element not in this set, `has_unconfigured_tags` is set.
+ */
+export declare const mdz_to_svelte: (nodes: Array<MdzNode>, components: Record<string, string>, elements: ReadonlySet<string>) => MdzToSvelteResult;
+//# sourceMappingURL=mdz_to_svelte.d.ts.map

package/dist/mdz_to_svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdz_to_svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz_to_svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,yDAAyD;IACzD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAA;KAAC,CAAC,CAAC;IAEhE,yEAAyE;IACzE,qBAAqB,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GACzB,OAAO,KAAK,CAAC,OAAO,CAAC,EACrB,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,UAAU,WAAW,CAAC,MAAM,CAAC,KAC3B,iBAgFF,CAAC"}

package/dist/mdz_to_svelte.js

@@ -0,0 +1,89 @@
+/**
+ * Converts parsed `MdzNode` arrays to Svelte markup strings.
+ *
+ * Used by the `svelte_preprocess_mdz` preprocessor to expand static `<Mdz content="...">` usages
+ * into pre-rendered Svelte markup at build time. The output for each node type matches what
+ * `MdzNodeView.svelte` renders at runtime, so precompiled and runtime rendering are identical.
+ *
+ * @module
+ */
+import { UnreachableError } from '@fuzdev/fuz_util/error.js';
+import { escape_svelte_text } from '@fuzdev/fuz_util/svelte_preprocess_helpers.js';
+import { escape_js_string } from '@fuzdev/fuz_util/string.js';
+/**
+ * Converts an array of `MdzNode` to a Svelte markup string.
+ *
+ * Each node type produces output matching what `MdzNodeView.svelte` renders at runtime.
+ * Collects required imports and flags unconfigured component/element references.
+ *
+ * @param nodes Parsed mdz nodes to render.
+ * @param components Component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`).
+ *   If content references a component not in this map, `has_unconfigured_tags` is set.
+ * @param elements Allowed HTML element names (e.g., `new Set(['aside', 'details'])`).
+ *   If content references an element not in this set, `has_unconfigured_tags` is set.
+ */
+export const mdz_to_svelte = (nodes, components, elements) => {
+    const imports = new Map();
+    let has_unconfigured_tags = false;
+    const render_nodes = (children) => {
+        return children.map((child) => render_node(child)).join('');
+    };
+    const render_node = (node) => {
+        switch (node.type) {
+            case 'Text':
+                return escape_svelte_text(node.content);
+            case 'Code':
+                imports.set('DocsLink', { path: '@fuzdev/fuz_ui/DocsLink.svelte', kind: 'default' });
+                return `<DocsLink reference={'${escape_js_string(node.content)}'} />`;
+            case 'Codeblock': {
+                imports.set('Code', { path: '@fuzdev/fuz_code/Code.svelte', kind: 'default' });
+                const lang_attr = node.lang === null ? 'lang={null}' : `lang={'${escape_js_string(node.lang)}'}`;
+                return `<Code ${lang_attr} content={'${escape_js_string(node.content)}'} />`;
+            }
+            case 'Bold':
+                return `<strong>${render_nodes(node.children)}</strong>`;
+            case 'Italic':
+                return `<em>${render_nodes(node.children)}</em>`;
+            case 'Strikethrough':
+                return `<s>${render_nodes(node.children)}</s>`;
+            case 'Link': {
+                const children_markup = render_nodes(node.children);
+                if (node.link_type === 'internal') {
+                    if (node.reference.startsWith('#') || node.reference.startsWith('?')) {
+                        return `<a href={'${escape_js_string(node.reference)}'}>${children_markup}</a>`;
+                    }
+                    imports.set('resolve', { path: '$app/paths', kind: 'named' });
+                    return `<a href={resolve('${escape_js_string(node.reference)}')}>${children_markup}</a>`;
+                }
+                // External link — matches MdzNodeView: target="_blank" rel="noopener"
+                return `<a href={'${escape_js_string(node.reference)}'} target="_blank" rel="noopener">${children_markup}</a>`;
+            }
+            case 'Paragraph':
+                return `<p>${render_nodes(node.children)}</p>`;
+            case 'Hr':
+                return '<hr />';
+            case 'Heading':
+                return `<h${node.level}>${render_nodes(node.children)}</h${node.level}>`;
+            case 'Element': {
+                if (!elements.has(node.name)) {
+                    has_unconfigured_tags = true;
+                    return '';
+                }
+                return `<${node.name}>${render_nodes(node.children)}</${node.name}>`;
+            }
+            case 'Component': {
+                const import_path = components[node.name];
+                if (!import_path) {
+                    has_unconfigured_tags = true;
+                    return '';
+                }
+                imports.set(node.name, { path: import_path, kind: 'default' });
+                return `<${node.name}>${render_nodes(node.children)}</${node.name}>`;
+            }
+            default:
+                throw new UnreachableError(node);
+        }
+    };
+    const markup = render_nodes(nodes);
+    return { markup, imports, has_unconfigured_tags };
+};

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)