@fuzdev/fuz_ui 0.190.0 → 0.191.0

package/dist/ContextmenuRootForSafariCompatibility.svelte

@@ -382,7 +382,7 @@
 	 * The critical fix is calling preventDefault() in the touchmove handler when tracking
 	 * a longpress with movement below threshold.
 	 *
-	 * @param el The Window or HTMLElement to attach touch listeners to
+	 * @param el - the Window or HTMLElement to attach touch listeners to
 	 * @returns Cleanup function to remove all event listeners
 	 */
 	const touch_event_attachment = (el: HTMLElement | Window) => {

package/dist/MdzNodeView.svelte

@@ -2,7 +2,8 @@
 	import Code from '@fuzdev/fuz_code/Code.svelte';
 	import {resolve} from '$app/paths';
 
-	import {type MdzNode, resolve_relative_path} from './mdz.js';
+	import type {MdzNode} from './mdz.js';
+	import {resolve_relative_path} from './mdz_helpers.js';
 	import DocsLink from './DocsLink.svelte';
 	import MdzNodeView from './MdzNodeView.svelte';
 	import {
@@ -80,7 +81,7 @@
 {:else if node.type === 'Hr'}
 	<hr />
 {:else if node.type === 'Heading'}
-	<svelte:element this={`h${node.level}`}>
+	<svelte:element this={`h${node.level}`} id={node.id}>
 		{@render render_children(node.children)}
 	</svelte:element>
 {:else if node.type === 'Codeblock'}

package/dist/MdzNodeView.svelte.d.ts

@@ -1,4 +1,4 @@
-import { type MdzNode } from './mdz.js';
+import type { MdzNode } from './mdz.js';
 import MdzNodeView from './MdzNodeView.svelte';
 type $$ComponentProps = {
     node: MdzNode;

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

@@ -1 +1 @@
-{"version":3,"file":"MdzNodeView.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/MdzNodeView.svelte"],"names":[],"mappings":"AAMA,OAAO,EAAC,KAAK,OAAO,EAAwB,MAAM,UAAU,CAAC;AAE7D,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAO9C,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE,OAAO,CAAC;CACd,CAAC;AAoGH,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"MdzNodeView.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/MdzNodeView.svelte"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,UAAU,CAAC;AAGtC,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAO9C,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE,OAAO,CAAC;CACd,CAAC;AAqGH,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/analysis_context.d.ts

@@ -187,8 +187,8 @@ export interface FormatDiagnosticOptions {
 /**
  * Format a diagnostic for display.
  *
- * @param diagnostic The diagnostic to format
- * @param options Formatting options
+ * @param diagnostic - the diagnostic to format
+ * @param options - formatting options
  * @returns Formatted string like './file.ts:10:5: error: message'
  */
 export declare const format_diagnostic: (diagnostic: Diagnostic, options?: FormatDiagnosticOptions) => string;

package/dist/analysis_context.js

@@ -113,8 +113,8 @@ export class AnalysisContext {
 /**
  * Format a diagnostic for display.
  *
- * @param diagnostic The diagnostic to format
- * @param options Formatting options
+ * @param diagnostic - the diagnostic to format
+ * @param options - formatting options
  * @returns Formatted string like './file.ts:10:5: error: message'
  */
 export const format_diagnostic = (diagnostic, options) => {

package/dist/contextmenu_state.svelte.d.ts

@@ -108,7 +108,7 @@ export declare class ContextmenuState {
 }
 /**
  * Creates an attachment that sets up contextmenu behavior on an element.
- * @param params Contextmenu parameters or nullish to disable
+ * @param params - contextmenu parameters or nullish to disable
  */
 export declare const contextmenu_attachment: <T extends ContextmenuParams, U extends T | Array<T>>(params: U | null | undefined) => Attachment<HTMLElement | SVGElement>;
 export interface ContextmenuOpenOptions {
@@ -120,11 +120,11 @@ export interface ContextmenuOpenOptions {
 /**
  * Opens the contextmenu, if appropriate,
  * querying the menu items from the DOM starting at the event target.
- * @param target the leaf element from which to open the contextmenu
- * @param x the page X coordinate at which to open the contextmenu, typically the mouse `pageX`
- * @param y the page Y coordinate at which to open the contextmenu, typically the mouse `pageY`
- * @param contextmenu the contextmenu store
- * @param options optional configuration for filtering entries and haptic feedback
+ * @param target - the leaf element from which to open the contextmenu
+ * @param x - the page X coordinate at which to open the contextmenu, typically the mouse `pageX`
+ * @param y - the page Y coordinate at which to open the contextmenu, typically the mouse `pageY`
+ * @param contextmenu - the contextmenu store
+ * @param options - optional configuration for filtering entries and haptic feedback
  * @returns a boolean indicating if the menu was opened or not
  */
 export declare const contextmenu_open: (target: HTMLElement | SVGElement, x: number, y: number, contextmenu: ContextmenuState, options?: ContextmenuOpenOptions) => boolean;
@@ -146,7 +146,7 @@ export declare const contextmenu_dimensions_context: {
  * Registers a contextmenu root and warns if multiple non-scoped roots are detected.
  * Only active in development mode. Automatically handles cleanup on unmount.
  *
- * @param get_scoped Getter function that returns the current scoped value
+ * @param get_scoped - getter function that returns the current scoped value
  */
 export declare const contextmenu_check_global_root: (get_scoped: () => boolean) => void;
 //# sourceMappingURL=contextmenu_state.svelte.d.ts.map

package/dist/contextmenu_state.svelte.js

@@ -298,7 +298,7 @@ const contextmenu_cache = new Map();
 let cache_key_counter = 0;
 /**
  * Creates an attachment that sets up contextmenu behavior on an element.
- * @param params Contextmenu parameters or nullish to disable
+ * @param params - contextmenu parameters or nullish to disable
  */
 export const contextmenu_attachment = (params) => (el) => {
     // TODO could clean up the dataset attr, maybe use a weakmap?
@@ -319,11 +319,11 @@ const CONTEXTMENU_OPEN_VIBRATE_DURATION = 17;
 /**
  * Opens the contextmenu, if appropriate,
  * querying the menu items from the DOM starting at the event target.
- * @param target the leaf element from which to open the contextmenu
- * @param x the page X coordinate at which to open the contextmenu, typically the mouse `pageX`
- * @param y the page Y coordinate at which to open the contextmenu, typically the mouse `pageY`
- * @param contextmenu the contextmenu store
- * @param options optional configuration for filtering entries and haptic feedback
+ * @param target - the leaf element from which to open the contextmenu
+ * @param x - the page X coordinate at which to open the contextmenu, typically the mouse `pageX`
+ * @param y - the page Y coordinate at which to open the contextmenu, typically the mouse `pageY`
+ * @param contextmenu - the contextmenu store
+ * @param options - optional configuration for filtering entries and haptic feedback
  * @returns a boolean indicating if the menu was opened or not
  */
 export const contextmenu_open = (target, x, y, contextmenu, options) => {
@@ -401,7 +401,7 @@ const non_scoped_roots = new Set();
  * Registers a contextmenu root and warns if multiple non-scoped roots are detected.
  * Only active in development mode. Automatically handles cleanup on unmount.
  *
- * @param get_scoped Getter function that returns the current scoped value
+ * @param get_scoped - getter function that returns the current scoped value
  */
 export const contextmenu_check_global_root = (get_scoped) => {
     $effect(() => {

package/dist/docs_helpers.svelte.d.ts

@@ -1,10 +1,12 @@
 import { SvelteMap, SvelteSet } from 'svelte/reactivity';
 /**
- * Convert a string to a URL-safe fragment identifier, preserving case for API declarations.
- * Only transforms spaces and special characters, keeping valid identifier characters intact.
- * Used for hash anchors in documentation.
- * @param str - The string to convert to a fragment
- * @returns A URL-safe fragment identifier
+ * Convert a string to a URL-safe fragment identifier, preserving case.
+ * 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.
+ * @param str - the string to convert to a fragment
+ * @returns a URL-safe fragment identifier with case preserved
  */
 export declare const docs_slugify: (str: string) => string;
 export declare const DOCS_PATH_DEFAULT = "/docs";

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

@@ -1 +1 @@
-{"version":3,"file":"docs_helpers.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/docs_helpers.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAKvD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAY1C,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,SAAS,QAAmB,CAAC;AAC1C,eAAO,MAAM,aAAa,QAAqB,CAAC;AAEhD,eAAO,MAAM,iBAAiB,GAC7B,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,kBAA6B,KAC3B;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAK5E,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;CAA8B,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,qBAAa,SAAS;;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAmB;IAgBlE,UAAU,iBA4BP;IAEH,QAAQ,CAAC,kBAAkB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAmB;gBAErD,SAAS,SAAoB;IAIzC,GAAG,CACF,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,WAAW,EACjB,KAAK,SAAI,EACT,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GAClB,MAAM;IAkBT,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB;;;OAGG;IACH,mBAAmB,IAAI,MAAM;CAG7B"}
+{"version":3,"file":"docs_helpers.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/docs_helpers.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAKvD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAY1C,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,SAAS,QAAmB,CAAC;AAC1C,eAAO,MAAM,aAAa,QAAqB,CAAC;AAEhD,eAAO,MAAM,iBAAiB,GAC7B,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,kBAA6B,KAC3B;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAK5E,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;CAA8B,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,qBAAa,SAAS;;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAmB;IAgBlE,UAAU,iBA4BP;IAEH,QAAQ,CAAC,kBAAkB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAmB;gBAErD,SAAS,SAAoB;IAIzC,GAAG,CACF,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,WAAW,EACjB,KAAK,SAAI,EACT,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GAClB,MAAM;IAkBT,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB;;;OAGG;IACH,mBAAmB,IAAI,MAAM;CAG7B"}

package/dist/docs_helpers.svelte.js

@@ -3,11 +3,13 @@ import { SvelteMap, SvelteSet } from 'svelte/reactivity';
 import { ensure_end, ensure_start } from '@fuzdev/fuz_util/string.js';
 import { create_context } from './context_helpers.js';
 /**
- * Convert a string to a URL-safe fragment identifier, preserving case for API declarations.
- * Only transforms spaces and special characters, keeping valid identifier characters intact.
- * Used for hash anchors in documentation.
- * @param str - The string to convert to a fragment
- * @returns A URL-safe fragment identifier
+ * Convert a string to a URL-safe fragment identifier, preserving case.
+ * 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.
+ * @param str - the string to convert to a fragment
+ * @returns a URL-safe fragment identifier with case preserved
  */
 export const docs_slugify = (str) => {
     return (str

package/dist/intersect.svelte.d.ts

@@ -26,7 +26,7 @@ export type IntersectParamsOrCallback = OnIntersect | IntersectParams;
  * Creates an attachment that observes element viewport intersection.
  * Uses the lazy function pattern to optimize reactivity:
  * callbacks can update without recreating the observer, preserving state.
- * @param get_params Function that returns callback, params object, or nullish to disable
+ * @param get_params - function that returns callback, params object, or nullish to disable
  */
 export declare const intersect: (get_params: () => IntersectParamsOrCallback | null | undefined) => Attachment<HTMLElement | SVGElement>;
 export type OnIntersect = (state: IntersectState) => void;

package/dist/intersect.svelte.js

@@ -3,7 +3,7 @@ import { deep_equal } from '@fuzdev/fuz_util/deep_equal.js';
  * Creates an attachment that observes element viewport intersection.
  * Uses the lazy function pattern to optimize reactivity:
  * callbacks can update without recreating the observer, preserving state.
- * @param get_params Function that returns callback, params object, or nullish to disable
+ * @param get_params - function that returns callback, params object, or nullish to disable
  */
 export const intersect = (get_params) => (el) => {
     // State that persists across callback changes

package/dist/library_analysis.d.ts

@@ -101,11 +101,11 @@ export interface ModuleAnalysis {
  * only re-analyze changed files. The TypeScript program should include all files
  * for accurate type resolution, but only changed files need re-analysis.
  *
- * @param source_file The source file info with content and optional dependency data
- * @param program TypeScript program (used for type checking and source file lookup)
- * @param options Module source options for path extraction
- * @param ctx Analysis context for collecting diagnostics
- * @param log Optional logger for warnings
+ * @param source_file - the source file info with content and optional dependency data
+ * @param program - TypeScript program (used for type checking and source file lookup)
+ * @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
  */
 export declare const library_analyze_module: (source_file: SourceFileInfo, program: ts.Program, options: ModuleSourceOptions, ctx: AnalysisContext, log?: Logger) => ModuleAnalysis | undefined;

package/dist/library_analysis.js

@@ -60,11 +60,11 @@ import { module_extract_path, } from './module_helpers.js';
  * only re-analyze changed files. The TypeScript program should include all files
  * for accurate type resolution, but only changed files need re-analysis.
  *
- * @param source_file The source file info with content and optional dependency data
- * @param program TypeScript program (used for type checking and source file lookup)
- * @param options Module source options for path extraction
- * @param ctx Analysis context for collecting diagnostics
- * @param log Optional logger for warnings
+ * @param source_file - the source file info with content and optional dependency data
+ * @param program - TypeScript program (used for type checking and source file lookup)
+ * @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
  */
 export const library_analyze_module = (source_file, program, options, ctx, log) => {

package/dist/library_gen.d.ts

@@ -63,9 +63,9 @@ export declare const source_file_from_disknode: (disknode: Disknode) => SourceFi
  * have malformed paths or missing content). The filtering uses `module_is_source` which
  * checks `source_paths` to only include files in configured source directories.
  *
- * @param disknodes Iterator of Gro disknodes from filer
- * @param options Module source options for filtering
- * @param log Optional logger for status messages
+ * @param disknodes - iterator of Gro disknodes from filer
+ * @param options - module source options for filtering
+ * @param log - optional logger for status messages
  */
 export declare const library_collect_source_files_from_disknodes: (disknodes: Iterable<Disknode>, options: ModuleSourceOptions, log?: {
     info: (...args: Array<unknown>) => void;
@@ -89,7 +89,7 @@ export declare const library_collect_source_files_from_disknodes: (disknodes: It
  * export const gen = library_gen();
  * ```
  *
- * @param options Optional generation options
+ * @param options - optional generation options
  */
 export declare const library_gen: (options?: LibraryGenOptions) => Gen;
 //# sourceMappingURL=library_gen.d.ts.map

package/dist/library_gen.js

@@ -41,9 +41,9 @@ export const source_file_from_disknode = (disknode) => {
  * have malformed paths or missing content). The filtering uses `module_is_source` which
  * checks `source_paths` to only include files in configured source directories.
  *
- * @param disknodes Iterator of Gro disknodes from filer
- * @param options Module source options for filtering
- * @param log Optional logger for status messages
+ * @param disknodes - iterator of Gro disknodes from filer
+ * @param options - module source options for filtering
+ * @param log - optional logger for status messages
  */
 export const library_collect_source_files_from_disknodes = (disknodes, options, log) => {
     // Validate options early to fail fast on misconfiguration
@@ -87,7 +87,7 @@ export const library_collect_source_files_from_disknodes = (disknodes, options,
  * export const gen = library_gen();
  * ```
  *
- * @param options Optional generation options
+ * @param options - optional generation options
  */
 export const library_gen = (options) => {
     return {

package/dist/library_generate.d.ts

@@ -30,8 +30,8 @@ import { type DuplicateInfo } from './library_pipeline.js';
 /**
  * Callback for handling duplicate declaration names.
  *
- * @param duplicates Map of declaration names to their occurrences across modules
- * @param log Logger for reporting
+ * @param duplicates - map of declaration names to their occurrences across modules
+ * @param log - logger for reporting
  */
 export type OnDuplicatesCallback = (duplicates: Map<string, Array<DuplicateInfo>>, log: {
     error: (...args: Array<unknown>) => void;

package/dist/library_helpers.d.ts

@@ -11,30 +11,30 @@
 /**
  * Build project-relative API documentation URL with hash anchor.
  *
- * @param declaration_name Name of the declaration to link to
+ * @param declaration_name - name of the declaration to link to
  * @returns URL path like '/docs/api#declaration_name'
  */
 export declare const url_api_declaration: (declaration_name: string) => string;
 /**
  * Build full API documentation URL with domain and hash anchor.
  *
- * @param homepage Package homepage URL
- * @param declaration_name Name of the declaration to link to
+ * @param homepage - package homepage URL
+ * @param declaration_name - name of the declaration to link to
  * @returns Full URL like 'https://example.com/docs/api#declaration_name'
  */
 export declare const url_api_declaration_full: (homepage: string, declaration_name: string) => string;
 /**
  * Build project-relative module documentation URL.
  *
- * @param module_path Module path (e.g., 'helpers.ts')
+ * @param module_path - module path (e.g., 'helpers.ts')
  * @returns URL path like '/docs/api/helpers.ts'
  */
 export declare const url_api_module: (module_path: string) => string;
 /**
  * Build package logo URL with favicon.png fallback.
  *
- * @param homepage_url Package homepage URL, or null
- * @param logo_path Optional custom logo path (defaults to 'favicon.png')
+ * @param homepage_url - package homepage URL, or null
+ * @param logo_path - optional custom logo path (defaults to 'favicon.png')
  * @returns Full URL to the logo, or null if no homepage
  */
 export declare const url_package_logo: (homepage_url: string | null, logo_path?: string) => string | null;
@@ -43,8 +43,8 @@ export declare const url_package_logo: (homepage_url: string | null, logo_path?:
  *
  * Uses SvelteKit's page state for the current origin by default.
  *
- * @param url Full URL to convert
- * @param origin Origin to strip (defaults to current page origin)
+ * @param url - full URL to convert
+ * @param origin - origin to strip (defaults to current page origin)
  * @returns Root-relative URL starting with '/'
  *
  * @example

package/dist/library_helpers.js

@@ -14,30 +14,30 @@ import { DOCS_API_PATH, DOCS_PATH_DEFAULT } from './docs_helpers.svelte.js';
 /**
  * Build project-relative API documentation URL with hash anchor.
  *
- * @param declaration_name Name of the declaration to link to
+ * @param declaration_name - name of the declaration to link to
  * @returns URL path like '/docs/api#declaration_name'
  */
 export const url_api_declaration = (declaration_name) => `${DOCS_API_PATH}#${encodeURIComponent(declaration_name)}`;
 /**
  * Build full API documentation URL with domain and hash anchor.
  *
- * @param homepage Package homepage URL
- * @param declaration_name Name of the declaration to link to
+ * @param homepage - package homepage URL
+ * @param declaration_name - name of the declaration to link to
  * @returns Full URL like 'https://example.com/docs/api#declaration_name'
  */
 export const url_api_declaration_full = (homepage, declaration_name) => `${homepage}${DOCS_PATH_DEFAULT}/api#${encodeURIComponent(declaration_name)}`;
 /**
  * Build project-relative module documentation URL.
  *
- * @param module_path Module path (e.g., 'helpers.ts')
+ * @param module_path - module path (e.g., 'helpers.ts')
  * @returns URL path like '/docs/api/helpers.ts'
  */
 export const url_api_module = (module_path) => `${DOCS_API_PATH}/${module_path}`;
 /**
  * Build package logo URL with favicon.png fallback.
  *
- * @param homepage_url Package homepage URL, or null
- * @param logo_path Optional custom logo path (defaults to 'favicon.png')
+ * @param homepage_url - package homepage URL, or null
+ * @param logo_path - optional custom logo path (defaults to 'favicon.png')
  * @returns Full URL to the logo, or null if no homepage
  */
 export const url_package_logo = (homepage_url, logo_path) => {
@@ -51,8 +51,8 @@ export const url_package_logo = (homepage_url, logo_path) => {
  *
  * Uses SvelteKit's page state for the current origin by default.
  *
- * @param url Full URL to convert
- * @param origin Origin to strip (defaults to current page origin)
+ * @param url - full URL to convert
+ * @param origin - origin to strip (defaults to current page origin)
  * @returns Root-relative URL starting with '/'
  *
  * @example

package/dist/library_pipeline.d.ts

@@ -87,8 +87,8 @@ export interface CollectedReExport {
  * // - helpers.ts foo declaration gets: also_exported_from: ['index.ts']
  * // - helpers.ts bar declaration gets: also_exported_from: ['index.ts']
  *
- * @param source_json The source JSON with all modules (will be mutated)
- * @param collected_re_exports Array of re-exports collected during phase 1
+ * @param source_json - the source JSON with all modules (will be mutated)
+ * @param collected_re_exports - array of re-exports collected during phase 1
  * @mutates source_json - adds `also_exported_from` to declarations
  */
 export declare const library_merge_re_exports: (source_json: SourceJson, collected_re_exports: Array<CollectedReExport>) => void;
@@ -101,9 +101,9 @@ export declare const library_merge_re_exports: (source_json: SourceJson, collect
  * File types are determined by `options.get_analyzer`. By default, `.ts`, `.js`, and `.svelte`
  * files are supported. Customize `get_analyzer` to support additional file types like `.svx`.
  *
- * @param files Iterable of source file info (from Gro filer, file system, or other source)
- * @param options Module source options for filtering
- * @param log Optional logger for status messages
+ * @param files - iterable of source file info (from Gro filer, file system, or other source)
+ * @param options - module source options for filtering
+ * @param log - optional logger for status messages
  */
 export declare const library_collect_source_files: (files: Iterable<SourceFileInfo>, options: ModuleSourceOptions, log?: Logger) => Array<SourceFileInfo>;
 //# sourceMappingURL=library_pipeline.d.ts.map

package/dist/library_pipeline.js

@@ -87,8 +87,8 @@ export const library_sort_modules = (modules) => {
  * // - helpers.ts foo declaration gets: also_exported_from: ['index.ts']
  * // - helpers.ts bar declaration gets: also_exported_from: ['index.ts']
  *
- * @param source_json The source JSON with all modules (will be mutated)
- * @param collected_re_exports Array of re-exports collected during phase 1
+ * @param source_json - the source JSON with all modules (will be mutated)
+ * @param collected_re_exports - array of re-exports collected during phase 1
  * @mutates source_json - adds `also_exported_from` to declarations
  */
 export const library_merge_re_exports = (source_json, collected_re_exports) => {
@@ -129,9 +129,9 @@ export const library_merge_re_exports = (source_json, collected_re_exports) => {
  * File types are determined by `options.get_analyzer`. By default, `.ts`, `.js`, and `.svelte`
  * files are supported. Customize `get_analyzer` to support additional file types like `.svx`.
  *
- * @param files Iterable of source file info (from Gro filer, file system, or other source)
- * @param options Module source options for filtering
- * @param log Optional logger for status messages
+ * @param files - iterable of source file info (from Gro filer, file system, or other source)
+ * @param options - module source options for filtering
+ * @param log - optional logger for status messages
  */
 export const library_collect_source_files = (files, options, log) => {
     // Validate options early to fail fast on misconfiguration

package/dist/mdz.d.ts

@@ -79,6 +79,7 @@ export interface MdzHrNode extends MdzBaseNode {
 export interface MdzHeadingNode extends MdzBaseNode {
     type: 'Heading';
     level: 1 | 2 | 3 | 4 | 5 | 6;
+    id: string;
     children: Array<MdzNode>;
 }
 export interface MdzElementNode extends MdzBaseNode {
@@ -108,18 +109,4 @@ export declare class MdzParser {
      */
     parse(): Array<MdzNode>;
 }
-export declare const mdz_is_url: (s: string) => boolean;
-/**
- * Resolves a relative path (`./` or `../`) against a base path.
- * The base is treated as a directory regardless of trailing slash
- * (`'/docs/mdz'` and `'/docs/mdz/'` behave identically).
- * Handles embedded `.` and `..` segments within the reference
- * (e.g., `'./a/../b'` → navigates up then down).
- * Clamps at root — excess `..` segments stop at `/` rather than escaping.
- *
- * @param reference A relative path starting with `./` or `../`.
- * @param base An absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
- * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
- */
-export declare const resolve_relative_path: (reference: string, base: string) => string;
 //# sourceMappingURL=mdz.d.ts.map

package/dist/mdz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAyCH;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,KAAK,CAAC,OAAO,CAAgC,CAAC;AAEvF,MAAM,MAAM,OAAO,GAChB,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,aAAa,GACb,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,cAAc,GACd,cAAc,GACd,gBAAgB,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACxD,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;CACnC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC7C,IAAI,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,SAAS;;gBAQT,QAAQ,EAAE,MAAM;IAI5B;;;;;;OAMG;IACH,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;CAyzCvB"}