@fuzdev/fuz_ui 0.198.1 → 0.200.0

package/dist/MdzStream.svelte

@@ -0,0 +1,32 @@
+<script lang="ts">
+	import type {SvelteHTMLElements} from 'svelte/elements';
+
+	import MdzStreamNodeView from './MdzStreamNodeView.svelte';
+	import {mdz_base_context, set_mdz_context_with_fallback} from './mdz_components.js';
+	import type {MdzStreamState} from './mdz_stream_state.svelte.js';
+
+	const {
+		state,
+		inline = false,
+		nowrap = false,
+		base,
+		...rest
+	}: (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
+		state: MdzStreamState;
+		inline?: boolean;
+		nowrap?: boolean;
+		base?: string;
+	} = $props();
+
+	set_mdz_context_with_fallback(mdz_base_context, () => base);
+</script>
+
+<svelte:element
+	this={inline ? 'span' : 'div'}
+	{...rest}
+	style:white-space={nowrap ? 'pre' : 'pre-wrap'}
+>
+	{#each state.root as node (node.id)}
+		<MdzStreamNodeView {node} />
+	{/each}
+</svelte:element>

package/dist/MdzStream.svelte.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"MdzStream.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/MdzStream.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAIxD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,8BAA8B,CAAC;AAEhE,KAAK,gBAAgB,GAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG;IACnF,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AA2BH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/MdzStreamNodeView.svelte

@@ -0,0 +1,106 @@
+<script lang="ts">
+	import Code from '@fuzdev/fuz_code/Code.svelte';
+	import {resolve} from '$app/paths';
+
+	import {resolve_relative_path, mdz_is_safe_reference} from './mdz_helpers.js';
+	import DocsLink from './DocsLink.svelte';
+	import MdzStreamNodeView from './MdzStreamNodeView.svelte';
+	import {
+		mdz_components_context,
+		mdz_elements_context,
+		mdz_base_context,
+	} from './mdz_components.js';
+	import type {MdzStreamNode} from './mdz_stream_state.svelte.js';
+
+	const {
+		node,
+	}: {
+		node: MdzStreamNode;
+	} = $props();
+
+	const get_components = mdz_components_context.get_maybe();
+	const get_elements = mdz_elements_context.get_maybe();
+	const get_mdz_base = mdz_base_context.get_maybe();
+</script>
+
+{#if node.type === 'Element'}
+	{@const element_config = get_elements?.()?.get(node.name ?? '')}
+	{#if element_config !== undefined}
+		<svelte:element this={node.name}>
+			{#if node.children.length > 0}
+				{@render render_children(node.children)}
+			{/if}
+		</svelte:element>
+	{:else}
+		{@render render_unregistered_tag(node.name ?? '', node.children)}
+	{/if}
+{:else if node.type === 'Component'}
+	{@const Component = get_components?.()?.get(node.name ?? '')}
+	{#if Component}
+		<Component>
+			{#if node.children.length > 0}
+				{@render render_children(node.children)}
+			{/if}
+		</Component>
+	{:else}
+		{@render render_unregistered_tag(node.name ?? '', node.children)}
+	{/if}
+{:else if node.type === 'Text'}
+	{node.content}
+{:else if node.type === 'Code'}
+	<DocsLink reference={node.content} />
+{:else if node.type === 'Bold'}
+	<strong>{@render render_children(node.children)}</strong>
+{:else if node.type === 'Italic'}
+	<em>{@render render_children(node.children)}</em>
+{:else if node.type === 'Strikethrough'}
+	<s>{@render render_children(node.children)}</s>
+{:else if node.type === 'Link'}
+	{@const reference = node.reference ?? ''}
+	{#if !mdz_is_safe_reference(reference)}
+		{@render render_children(node.children)}
+	{:else if node.link_type === 'internal'}
+		{@const skip_resolve = reference.startsWith('#') || reference.startsWith('?')}
+		{@const mdz_base = get_mdz_base?.()}
+		{#if reference.startsWith('.') && mdz_base}
+			{@const resolved = resolve_relative_path(reference, mdz_base)}
+			<a href={resolve(resolved as any)}>{@render render_children(node.children)}</a>
+		{:else if skip_resolve || reference.startsWith('.')}
+			<!-- Fragment, query, and relative links without base skip resolve() -->
+			<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
+			<a href={reference}>{@render render_children(node.children)}</a>
+		{:else}
+			<a href={resolve(reference as any)}>{@render render_children(node.children)}</a>
+		{/if}
+	{:else}
+		<!-- external link -->
+		<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
+		<a href={reference} target="_blank" rel="noopener">{@render render_children(node.children)}</a>
+	{/if}
+{:else if node.type === 'Paragraph'}
+	<p>{@render render_children(node.children)}</p>
+{:else if node.type === 'Hr'}
+	<hr />
+{:else if node.type === 'Heading'}
+	<svelte:element this={`h${node.level}`} id={node.heading_id}>
+		{@render render_children(node.children)}
+	</svelte:element>
+{:else if node.type === 'Codeblock'}
+	<Code lang={node.lang} content={node.content} />
+{/if}
+
+{#snippet render_children(nodes: Array<MdzStreamNode>)}
+	{#each nodes as node (node.id)}
+		<MdzStreamNodeView {node} />
+	{/each}
+{/snippet}
+
+{#snippet render_unregistered_tag(name: string, children: Array<MdzStreamNode>)}
+	{#if children.length > 0}
+		<code class="color_c_50">&lt;{name}&gt;</code>{@render render_children(children)}<code
+			class="color_c_50">&lt;/{name}&gt;</code
+		>
+	{:else}
+		<code class="color_c_50">&lt;{name} /&gt;</code>
+	{/if}
+{/snippet}

package/dist/MdzStreamNodeView.svelte.d.ts

@@ -0,0 +1,9 @@
+import MdzStreamNodeView from './MdzStreamNodeView.svelte';
+import type { MdzStreamNode } from './mdz_stream_state.svelte.js';
+type $$ComponentProps = {
+    node: MdzStreamNode;
+};
+declare const MdzStreamNodeView: import("svelte").Component<$$ComponentProps, {}, "">;
+type MdzStreamNodeView = ReturnType<typeof MdzStreamNodeView>;
+export default MdzStreamNodeView;
+//# sourceMappingURL=MdzStreamNodeView.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MdzStreamNodeView.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/MdzStreamNodeView.svelte"],"names":[],"mappings":"AAQA,OAAO,iBAAiB,MAAM,4BAA4B,CAAC;AAM3D,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,8BAA8B,CAAC;AAE/D,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE,aAAa,CAAC;CACpB,CAAC;AAsGH,QAAA,MAAM,iBAAiB,sDAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/ProjectLinks.svelte

@@ -35,8 +35,8 @@
 		{name: 'fuz_css', url: 'https://css.fuz.dev/', logo: logo_fuz_css, description: 'CSS framework and design system', glyph: '🌿', color_class: 'color_b_50'},
 		{name: 'fuz_ui', url: 'https://ui.fuz.dev/', logo: logo_fuz_ui, description: 'Svelte UI library', glyph: '🧶', color_class: 'color_c_50'},
 		{name: 'fuz_template', url: 'https://template.fuz.dev/', logo: logo_fuz_template, description: 'a static web app and Node library template with TypeScript, Svelte, SvelteKit, Vite, esbuild, Fuz, and Gro', glyph: '❄', color_class: 'color_h_50'},
-		{name: 'fuz_code', url: 'https://code.fuz.dev/', logo: logo_fuz_code, description: 'syntax styling utilities and components for TypeScript, Svelte, SvelteKit', glyph: '🎨', color_class: 'color_g_50'},
 		{name: 'fuz_blog', url: 'https://blog.fuz.dev/', logo: logo_fuz_blog, description: 'blog software from scratch with SvelteKit', glyph: '🖊️', color_class: 'color_e_50'},
+		{name: 'fuz_code', url: 'https://code.fuz.dev/', logo: logo_fuz_code, description: 'syntax styling utilities and components for TypeScript, Svelte, SvelteKit', glyph: '🎨', color_class: 'color_g_50'},
 		{name: 'fuz_mastodon', url: 'https://mastodon.fuz.dev/', logo: logo_fuz_mastodon, description: 'Mastodon components and helpers for Svelte, SvelteKit, and Fuz', glyph: '🦣', color_class: 'color_d_50'},
 		{name: 'fuz_gitops', url: 'https://gitops.fuz.dev/', logo: logo_fuz_gitops, description: 'a tool for managing many repos', glyph: '🪄', color_class: 'color_a_50'},
 		{name: 'fuz_docs', url: 'https://docs.fuz.dev/', logo: logo_fuz_docs, description: 'AI-generated documentation and skills for the Fuz stack', glyph: '📜', color_class: 'color_i_50'},

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

@@ -1 +1 @@
-{"version":3,"file":"api_search.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/api_search.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACR,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;KACxB,CAAC;IACF,YAAY,EAAE;QACb,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACxB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;KAC7B,CAAC;CACF;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,cA8CpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAC5C,cAAc,KAAK,CAAC,WAAW,CAAC,KAC9B,sBAyCF,CAAC"}
+{"version":3,"file":"api_search.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/api_search.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACR,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;KACxB,CAAC;IACF,YAAY,EAAE;QACb,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACxB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;KAC7B,CAAC;CACF;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,cA+CpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAC5C,cAAc,KAAK,CAAC,WAAW,CAAC,KAC9B,sBA0CF,CAAC"}

package/dist/api_search.svelte.js

@@ -19,7 +19,8 @@ export const create_api_search = (library) => {
     const all_declarations = $derived(library.declarations);
     const filtered_declarations = $derived.by(() => {
         const items = query.trim() ? library.search_declarations(query) : all_declarations;
-        return items.sort((a, b) => a.name.localeCompare(b.name));
+        // spread before sort — `items` may be the shared source array
+        return [...items].sort((a, b) => a.name.localeCompare(b.name));
     });
     return {
         get query() {
@@ -54,8 +55,9 @@ export const create_module_declaration_search = (declarations) => {
     const all = $derived(declarations);
     const filtered = $derived.by(() => {
         const trimmed_query = query.trim();
+        // spread before sort — `all` is the shared source array
         if (!trimmed_query)
-            return all.sort((a, b) => a.name.localeCompare(b.name));
+            return [...all].sort((a, b) => a.name.localeCompare(b.name));
         const terms = trimmed_query.toLowerCase().split(/\s+/);
         const items = all.filter((d) => {
             const name_lower = d.name.toLowerCase();

package/dist/declaration.svelte.d.ts

@@ -293,10 +293,21 @@ export declare class Declaration {
         module: string;
         name: string;
     } | undefined;
+    /**
+     * Other modules that also export this declaration (re-export paths
+     * relative to src/lib). Absent when only exported from its defining module.
+     */
+    also_exported_from: string[] | undefined;
     /**
      * Mutation documentation from `@mutates` tags, mapping parameter names to descriptions.
      */
     mutates: Record<string, string> | undefined;
+    /**
+     * Svelte reactivity flavor (`$state`, `$state.raw`, `$derived`, `$derived.by`)
+     * when this variable is initialized with a value-producing rune.
+     * Present on `variable` kind only.
+     */
+    reactivity: "$state" | "$state.raw" | "$derived" | "$derived.by" | undefined;
     has_examples: boolean;
     is_deprecated: boolean;
     has_documentation: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,oBAAoB,EAKpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAc/C;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAiB;IAEhE,OAAO,wCAAiC;IAExC;;OAEG;IACH,WAAW,SAA8B;IAEzC,IAAI,SAAwC;IAC5C,IAAI,4GAAwC;IAE5C;;OAEG;IACH,UAAU,qBAQR;IAEF;;OAEG;IACH,OAAO,SAAoF;IAE3F;;OAEG;IACH,gBAAgB,SAQd;IAEF;;OAEG;IACH,YAAY,qBAIV;IAEF;;OAEG;IAGH,YAAY,SAKV;IAEF,cAAc,qBAAiD;IAC/D,WAAW,qBAA8C;IACzD,kBAAkB,qBAAqD;IACvE,UAAU;;;;;;;;oBAAmF;IAC7F,KAAK;;;;;;;;;;;;;;;;;;;;;;;;oBAAkF;IACvF,WAAW,qBAAgE;IAC3E,kBAAkB,qBAAuE;IACzF,cAAc;;;;QAAuD;IACrE,YAAY,gCAA6E;IACzF,gBAAgB,uBAAuE;IACvF,MAAM;;;QAAgD;IACtD,KAAK,qBAAyC;IAC9C,QAAQ,WAAkD;IAC1D,QAAQ,WAAiD;IACzD;;OAEG;IACH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAA6E;IAEpF;;;OAGG;IACH,UAAU,uBAAuE;IAEjF;;;OAGG;IACH,gBAAgB,sBAAsE;IAEtF;;;OAGG;IACH,SAAS;;;;;;;;;;;;;;;;;;;oBAAiF;IAE1F;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA2C;IAEnD;;OAEG;IACH,OAAO,qCAA2C;IAElD,YAAY,UAAsC;IAClD,aAAa,UAAuC;IACpD,iBAAiB,UAAgC;IACjD,cAAc,UAA+D;IAC7E,SAAS,UAAqD;IAC9D,YAAY,UAA4C;gBAE5C,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,oBAAoB;CAIlE"}
+{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,oBAAoB,EAMpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAc/C;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAiB;IAEhE,OAAO,wCAAiC;IAExC;;OAEG;IACH,WAAW,SAA8B;IAEzC,IAAI,SAAwC;IAC5C,IAAI,4GAAwC;IAE5C;;OAEG;IACH,UAAU,qBAQR;IAEF;;OAEG;IACH,OAAO,SAAoF;IAE3F;;OAEG;IACH,gBAAgB,SAQd;IAEF;;OAEG;IACH,YAAY,qBAIV;IAEF;;OAEG;IAGH,YAAY,SAKV;IAEF,cAAc,qBAAiD;IAC/D,WAAW,qBAA8C;IACzD,kBAAkB,qBAAqD;IACvE,UAAU;;;;;;;;oBAAmF;IAC7F,KAAK;;;;;;;;;;;;;;;;;;;;;;;;oBAAkF;IACvF,WAAW,qBAAgE;IAC3E,kBAAkB,qBAAuE;IACzF,cAAc;;;;QAAuD;IACrE,YAAY,gCAA6E;IACzF,gBAAgB,uBAAuE;IACvF,MAAM;;;QAAgD;IACtD,KAAK,qBAAyC;IAC9C,QAAQ,WAAkD;IAC1D,QAAQ,WAAiD;IACzD;;OAEG;IACH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAA6E;IAEpF;;;OAGG;IACH,UAAU,uBAAuE;IAEjF;;;OAGG;IACH,gBAAgB,sBAAsE;IAEtF;;;OAGG;IACH,SAAS;;;;;;;;;;;;;;;;;;;oBAAiF;IAE1F;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA2C;IAEnD;;;OAGG;IACH,kBAAkB,uBAA6E;IAE/F;;OAEG;IACH,OAAO,qCAA2C;IAElD;;;;OAIG;IACH,UAAU,mEAAoE;IAE9E,YAAY,UAAsC;IAElD,aAAa,UAAmD;IAChE,iBAAiB,UAAgC;IACjD,cAAc,UAA+D;IAC7E,SAAS,UAAqD;IAC9D,YAAY,UAA4C;gBAE5C,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,oBAAoB;CAIlE"}

package/dist/declaration.svelte.js

@@ -1,5 +1,5 @@
 import { generateImport, getDisplayName } from 'svelte-docinfo/declaration-helpers.js';
-import { url_github_file } from './package_helpers.js';
+import { url_github_file } from '@fuzdev/fuz_util/package_helpers.js';
 // The `virtual:svelte-docinfo` module is serialized with svelte-docinfo's
 // `compactReplacer`, which strips empty default arrays — so the runtime data
 // is the `*Input` shape (defaulted arrays optional), not the parsed `*Json`
@@ -46,7 +46,7 @@ export class Declaration {
     import_statement = $derived(
     // `generateImport` reads only `name`/`kind`/path, none of the defaulted
     // arrays, so asserting the parsed shape here is sound.
-    generateImport(this.declaration_json, this.module_path, this.library.package_json.name));
+    generateImport(this.declaration_json, this.module_path, this.library.pkg_json.name));
     /**
      * Public documentation link (if homepage_url is available).
      */
@@ -99,12 +99,24 @@ export class Declaration {
      * Re-export alias info when this declaration is a renamed re-export.
      */
     alias_of = $derived(this.declaration_json.aliasOf);
+    /**
+     * Other modules that also export this declaration (re-export paths
+     * relative to src/lib). Absent when only exported from its defining module.
+     */
+    also_exported_from = $derived(field(this.declaration_json, 'alsoExportedFrom'));
     /**
      * Mutation documentation from `@mutates` tags, mapping parameter names to descriptions.
      */
     mutates = $derived(this.declaration_json.mutates);
+    /**
+     * Svelte reactivity flavor (`$state`, `$state.raw`, `$derived`, `$derived.by`)
+     * when this variable is initialized with a value-producing rune.
+     * Present on `variable` kind only.
+     */
+    reactivity = $derived(field(this.declaration_json, 'reactivity'));
     has_examples = $derived(this.examples.length > 0);
-    is_deprecated = $derived(!!this.deprecated_message);
+    // presence, not truthiness — a bare `@deprecated` (no message text) arrives as `''`
+    is_deprecated = $derived(this.deprecated_message !== undefined);
     has_documentation = $derived(!!this.doc_comment);
     has_parameters = $derived(!!(this.parameters && this.parameters.length > 0));
     has_props = $derived(!!(this.props && this.props.length > 0));

package/dist/library.svelte.d.ts

@@ -1,4 +1,5 @@
 import type { LibraryJson } from '@fuzdev/fuz_util/library_json.js';
+import type { Url } from '@fuzdev/fuz_util/url.js';
 import { Declaration } from './declaration.svelte.js';
 import { Module } from './module.svelte.js';
 export declare const library_context: {
@@ -27,83 +28,21 @@ export declare class Library {
      * Default `''` preserves single-package behavior.
      */
     readonly url_prefix: string;
-    readonly package_json: {
-        [x: string]: unknown;
-        name: string;
-        version?: string | undefined;
-        private?: boolean | undefined;
-        description?: string | undefined;
-        tagline?: string | undefined;
-        glyph?: string | undefined;
-        logo?: string | undefined;
-        logo_alt?: string | undefined;
-        license?: string | undefined;
-        scripts?: Record<string, string> | undefined;
-        homepage?: string | undefined;
-        author?: string | {
-            [x: string]: unknown;
-            name: string;
-            email?: string | undefined;
-            url?: string | undefined;
-        } | undefined;
-        repository?: string | {
-            [x: string]: unknown;
-            type: string;
-            url: string;
-            directory?: string | undefined;
-        } | undefined;
-        contributors?: (string | {
-            [x: string]: unknown;
-            name: string;
-            email?: string | undefined;
-            url?: string | undefined;
-        })[] | undefined;
-        bugs?: string | {
-            [x: string]: unknown;
-            url?: string | undefined;
-            email?: string | undefined;
-        } | undefined;
-        funding?: string | {
-            [x: string]: unknown;
-            type: string;
-            url: string;
-        } | (string | {
-            [x: string]: unknown;
-            type: string;
-            url: string;
-        })[] | undefined;
-        keywords?: string[] | undefined;
-        type?: string | undefined;
-        engines?: Record<string, string> | undefined;
-        os?: string[] | undefined;
-        cpu?: string[] | undefined;
-        dependencies?: Record<string, string> | undefined;
-        devDependencies?: Record<string, string> | undefined;
-        peerDependencies?: Record<string, string> | undefined;
-        peerDependenciesMeta?: Record<string, {
-            [x: string]: unknown;
-            optional: boolean;
-        }> | undefined;
-        optionalDependencies?: Record<string, string> | undefined;
-        bin?: Record<string, string> | undefined;
-        sideEffects?: string[] | undefined;
-        files?: string[] | undefined;
-        main?: string | undefined;
-        exports?: string | Record<string, unknown> | null | undefined;
-    };
+    readonly pkg_json: import("@fuzdev/fuz_util/pkg_json.js").PkgJson;
     readonly source_json: import("@fuzdev/fuz_util/library_json.js").SourceJson;
     readonly name: string;
     readonly repo_name: string;
-    readonly repo_url: import("@fuzdev/fuz_util/url.js").Url;
+    /** Non-null — the constructor rejects a `pkg_json` without a parseable `repository`. */
+    readonly repo_url: Url;
     readonly owner_name: string | null;
-    readonly homepage_url: import("@fuzdev/fuz_util/url.js").Url | null;
-    readonly logo_url: import("@fuzdev/fuz_util/url.js").Url | null;
+    readonly homepage_url: Url | null;
+    readonly logo_url: Url | null;
     readonly logo_alt: string;
-    readonly npm_url: import("@fuzdev/fuz_util/url.js").Url | null;
-    readonly changelog_url: import("@fuzdev/fuz_util/url.js").Url | null;
     readonly published: boolean;
+    readonly npm_url: Url | null;
+    readonly changelog_url: Url | null;
     /**
-     * Organization URL (e.g., 'https://github.com/ryanatkn').
+     * Organization URL (e.g., 'https://github.com/ryanatkn'), built from `owner_name`.
      */
     readonly org_url: string | null;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"library.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAIlE,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE1C,eAAO,MAAM,eAAe;;;;CAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,MAGzD,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAiB;IAEnD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA4C;IACjE,QAAQ,CAAC,WAAW,wDAA2C;IAE/D,QAAQ,CAAC,IAAI,SAAoC;IACjD,QAAQ,CAAC,SAAS,SAAyC;IAC3D,QAAQ,CAAC,QAAQ,wCAAwC;IACzD,QAAQ,CAAC,UAAU,gBAA0C;IAC7D,QAAQ,CAAC,YAAY,+CAA4C;IACjE,QAAQ,CAAC,QAAQ,+CAAwC;IACzD,QAAQ,CAAC,QAAQ,SAAwC;IACzD,QAAQ,CAAC,OAAO,+CAAuC;IACvD,QAAQ,CAAC,aAAa,+CAA6C;IACnE,QAAQ,CAAC,SAAS,UAAyC;IAE3D;;OAEG;IACH,QAAQ,CAAC,OAAO,gBAMd;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,WAId;IAEF;;OAEG;IACH,QAAQ,CAAC,cAAc,WAErB;IAEF;;OAEG;IACH,QAAQ,CAAC,YAAY,gBAAmE;IAExF;;OAEG;IACH,QAAQ,CAAC,cAAc,sBAA2D;IAElF;;OAEG;IACH,QAAQ,CAAC,mBAAmB,2BAAgE;gBAEhF,YAAY,EAAE,WAAW,EAAE,UAAU,SAAK;IAKtD;;;OAGG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;IAW5D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;CAGtD"}
+{"version":3,"file":"library.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,yBAAyB,CAAC;AAGjD,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAW1C,eAAO,MAAM,eAAe;;;;CAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,MAGzD,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAiB;IAEnD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,QAAQ,iDAAwC;IACzD,QAAQ,CAAC,WAAW,wDAA2C;IAI/D,QAAQ,CAAC,IAAI,SAAgC;IAC7C,QAAQ,CAAC,SAAS,SAAiD;IACnE,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAuD;IAC7E,QAAQ,CAAC,UAAU,gBAAkD;IACrE,QAAQ,CAAC,YAAY,EAAE,GAAG,GAAG,IAAI,CAA4C;IAC7E,QAAQ,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAA6D;IAC1F,QAAQ,CAAC,QAAQ,SAAoE;IACrF,QAAQ,CAAC,SAAS,UAAiD;IACnE,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAAgE;IAC5F,QAAQ,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAEhC;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,gBAA8E;IAE9F;;OAEG;IACH,QAAQ,CAAC,OAAO,WAId;IAEF;;OAEG;IACH,QAAQ,CAAC,cAAc,WAErB;IAEF;;OAEG;IACH,QAAQ,CAAC,YAAY,gBAAmE;IAExF;;OAEG;IACH,QAAQ,CAAC,cAAc,sBAA2D;IAElF;;OAEG;IACH,QAAQ,CAAC,mBAAmB,2BAAgE;gBAEhF,YAAY,EAAE,WAAW,EAAE,UAAU,SAAK;IAatD;;;OAGG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;IAW5D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;CAGtD"}

package/dist/library.svelte.js

@@ -2,6 +2,7 @@ import { ensure_start, strip_end } from '@fuzdev/fuz_util/string.js';
 import { create_context } from './context_helpers.js';
 import { Declaration } from './declaration.svelte.js';
 import { Module } from './module.svelte.js';
+import { package_is_published, repo_name_parse, repo_url_github_owner, repo_url_parse, url_github_file, url_logo, url_npm_package, } from '@fuzdev/fuz_util/package_helpers.js';
 export const library_context = create_context();
 /**
  * Normalizes a URL prefix: ensures leading `/`, strips trailing `/`, returns `''` for falsy and non-string values.
@@ -28,31 +29,30 @@ export class Library {
      * Default `''` preserves single-package behavior.
      */
     url_prefix;
-    package_json = $derived(this.library_json.package_json);
+    pkg_json = $derived(this.library_json.pkg_json);
     source_json = $derived(this.library_json.source_json);
-    name = $derived(this.library_json.name);
-    repo_name = $derived(this.library_json.repo_name);
-    repo_url = $derived(this.library_json.repo_url);
-    owner_name = $derived(this.library_json.owner_name);
-    homepage_url = $derived(this.library_json.homepage_url);
-    logo_url = $derived(this.library_json.logo_url);
-    logo_alt = $derived(this.library_json.logo_alt);
-    npm_url = $derived(this.library_json.npm_url);
-    changelog_url = $derived(this.library_json.changelog_url);
-    published = $derived(this.library_json.published);
+    // Everything below is derived from `pkg_json` — `LibraryJson` stores only the
+    // raw `pkg_json`/`source_json` pair, so derivation lives in exactly one place.
+    name = $derived(this.pkg_json.name);
+    repo_name = $derived(repo_name_parse(this.pkg_json.name));
+    /** Non-null — the constructor rejects a `pkg_json` without a parseable `repository`. */
+    repo_url = $derived(repo_url_parse(this.pkg_json.repository));
+    owner_name = $derived(repo_url_github_owner(this.repo_url));
+    homepage_url = $derived(this.pkg_json.homepage ?? null);
+    logo_url = $derived(url_logo(this.homepage_url, this.pkg_json.logo));
+    logo_alt = $derived(this.pkg_json.logo_alt ?? `logo for ${this.repo_name}`);
+    published = $derived(package_is_published(this.pkg_json));
+    npm_url = $derived(this.published ? url_npm_package(this.name) : null);
+    changelog_url = $derived(this.published ? url_github_file(this.repo_url, 'CHANGELOG.md') : null);
     /**
-     * Organization URL (e.g., 'https://github.com/ryanatkn').
+     * Organization URL (e.g., 'https://github.com/ryanatkn'), built from `owner_name`.
      */
-    org_url = $derived(this.repo_url && this.repo_name
-        ? this.repo_url.endsWith('/' + this.repo_name)
-            ? this.repo_url.slice(0, -this.repo_name.length - 1)
-            : null
-        : null);
+    org_url = $derived(this.owner_name ? 'https://github.com/' + this.owner_name : null);
     /**
      * All modules as rich `Module` instances.
      */
     modules = $derived(this.source_json.modules
-        ? this.source_json.modules.map((module_json) => new Module(this, module_json)) // TODO: remove cast when fuz_util SourceJson uses svelte-docinfo types
+        ? this.source_json.modules.map((module_json) => new Module(this, module_json))
         : []);
     /**
      * All modules sorted alphabetically by path.
@@ -71,6 +71,12 @@ export class Library {
      */
     declaration_by_name = $derived(new Map(this.declarations.map((d) => [d.name, d])));
     constructor(library_json, url_prefix = '') {
+        // `repo_url` is exposed non-null and several derived URLs depend on it, so
+        // fail loud here rather than letting a missing/unparseable repository surface
+        // as a downstream `null`.
+        if (repo_url_parse(library_json.pkg_json.repository) === null) {
+            throw Error(`failed to construct Library - pkg_json for "${library_json.pkg_json.name}" has no parseable \`repository\``);
+        }
         this.library_json = library_json;
         this.url_prefix = parse_library_url_prefix(url_prefix);
     }

package/dist/library_helpers.d.ts

@@ -4,7 +4,7 @@
  * Runtime UI helpers for building URLs in the library documentation system.
  * These depend on fuz_ui's documentation paths and SvelteKit's runtime state.
  *
- * For generic package/repository URL helpers, see `package_helpers.ts`.
+ * For generic package/repository URL helpers, see `@fuzdev/fuz_util/package_helpers.js`.
  *
  * @module
  */
@@ -19,8 +19,8 @@
  *
  * @example
  * ```ts
- * // Assuming page.url.origin is 'https://example.com'
- * url_to_root_relative('https://example.com/docs/api')
+ * // Assuming page.url.origin is 'https://fuz.dev'
+ * url_to_root_relative('https://fuz.dev/docs/api')
  * // => '/docs/api'
  * ```
  */

package/dist/library_helpers.js

@@ -4,7 +4,7 @@
  * Runtime UI helpers for building URLs in the library documentation system.
  * These depend on fuz_ui's documentation paths and SvelteKit's runtime state.
  *
- * For generic package/repository URL helpers, see `package_helpers.ts`.
+ * For generic package/repository URL helpers, see `@fuzdev/fuz_util/package_helpers.js`.
  *
  * @module
  */
@@ -21,8 +21,8 @@ import { page } from '$app/state';
  *
  * @example
  * ```ts
- * // Assuming page.url.origin is 'https://example.com'
- * url_to_root_relative('https://example.com/docs/api')
+ * // Assuming page.url.origin is 'https://fuz.dev'
+ * url_to_root_relative('https://fuz.dev/docs/api')
  * // => '/docs/api'
  * ```
  */

package/dist/mdz.d.ts.map

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

package/dist/mdz.js

@@ -28,7 +28,7 @@
  *
  * @module
  */
-import { BACKTICK, ASTERISK, UNDERSCORE, TILDE, NEWLINE, HYPHEN, HASH, SPACE, TAB, LEFT_ANGLE, RIGHT_ANGLE, SLASH, LEFT_BRACKET, RIGHT_BRACKET, LEFT_PAREN, RIGHT_PAREN, A_UPPER, Z_UPPER, HR_HYPHEN_COUNT, MIN_CODEBLOCK_BACKTICKS, MAX_HEADING_LEVEL, HTTPS_PREFIX_LENGTH, HTTP_PREFIX_LENGTH, is_letter, is_tag_name_char, is_word_char, PERIOD, is_valid_path_char, trim_trailing_punctuation, is_at_absolute_path, is_at_relative_path, extract_single_tag, mdz_heading_id, mdz_is_url, } from './mdz_helpers.js';
+import { BACKTICK, ASTERISK, UNDERSCORE, TILDE, NEWLINE, HYPHEN, HASH, SPACE, TAB, LEFT_ANGLE, RIGHT_ANGLE, SLASH, LEFT_BRACKET, RIGHT_BRACKET, LEFT_PAREN, RIGHT_PAREN, A_UPPER, Z_UPPER, HR_HYPHEN_COUNT, MIN_CODEBLOCK_BACKTICKS, MAX_HEADING_LEVEL, match_url_prefix_case_insensitive, is_letter, is_tag_name_char, is_word_char, PERIOD, is_valid_path_char, trim_trailing_punctuation, is_at_absolute_path, is_at_relative_path, extract_single_tag, mdz_heading_id, mdz_is_url, mdz_is_safe_reference, mdz_push_merging_text, } from './mdz_helpers.js';
 // TODO design incremental parsing or some system that preserves Svelte components across re-renders when possible
 /**
  * Parses text to an array of `MdzNode`.
@@ -479,6 +479,18 @@ export class MdzParser {
                 };
             }
         }
+        // Reject unsafe protocols (javascript:, data:, etc.) — fall back to text.
+        // `is_valid_path_char` permits `:` so a malicious `[x](javascript:...)` would
+        // otherwise pass character validation and reach the renderer.
+        if (!mdz_is_safe_reference(reference)) {
+            this.#index = start + 1;
+            return {
+                type: 'Text',
+                content: '[',
+                start,
+                end: this.#index,
+            };
+        }
         this.#index = close_paren + 1;
         // Determine link type (external vs internal)
         const link_type = mdz_is_url(reference) ? 'external' : 'internal';
@@ -663,27 +675,28 @@ export class MdzParser {
     }
     /**
      * Check if current position is the start of an external URL (`https://` or `http://`).
+     *
+     * Requires the preceding character (if any) to not be a word character. This
+     * matches the streaming parser and the spec's "false negatives over false
+     * positives" policy — `xhttps://...` is treated as plain text rather than
+     * `x` followed by a link.
+     *
+     * Scheme matching is case-insensitive (RFC 3986 §3.1); the original casing
+     * is preserved in the emitted reference.
      */
     #is_at_url() {
-        if (this.#match('https://')) {
-            // Check for protocol-only (e.g., just "https://")
-            // Must have at least one non-whitespace character after protocol
-            if (this.#index + HTTPS_PREFIX_LENGTH >= this.#template.length) {
-                return false;
-            }
-            const next_char = this.#template.charCodeAt(this.#index + HTTPS_PREFIX_LENGTH);
-            return next_char !== SPACE && next_char !== NEWLINE;
-        }
-        if (this.#match('http://')) {
-            // Check for protocol-only (e.g., just "http://")
-            // Must have at least one non-whitespace character after protocol
-            if (this.#index + HTTP_PREFIX_LENGTH >= this.#template.length) {
-                return false;
-            }
-            const next_char = this.#template.charCodeAt(this.#index + HTTP_PREFIX_LENGTH);
-            return next_char !== SPACE && next_char !== NEWLINE;
+        // word boundary check: skip when preceded by [A-Za-z0-9]
+        if (this.#index > 0 && is_word_char(this.#template.charCodeAt(this.#index - 1))) {
+            return false;
         }
-        return false;
+        const prefix_len = match_url_prefix_case_insensitive(this.#template, this.#index);
+        if (prefix_len === 0)
+            return false;
+        // Must have at least one non-whitespace character after protocol
+        if (this.#index + prefix_len >= this.#template.length)
+            return false;
+        const next_char = this.#template.charCodeAt(this.#index + prefix_len);
+        return next_char !== SPACE && next_char !== NEWLINE;
     }
     /**
      * Parse auto-detected external URL (`https://` or `http://`).
@@ -691,13 +704,8 @@ export class MdzParser {
      */
     #parse_auto_link_url() {
         const start = this.#index;
-        // Consume protocol
-        if (this.#match('https://')) {
-            this.#index += HTTPS_PREFIX_LENGTH;
-        }
-        else if (this.#match('http://')) {
-            this.#index += HTTP_PREFIX_LENGTH;
-        }
+        // Consume protocol (case-insensitive match; original casing preserved in reference)
+        this.#index += match_url_prefix_case_insensitive(this.#template, this.#index);
         // Collect URL characters using RFC 3986 whitelist
         // Stop at whitespace or any character invalid in URIs
         while (this.#index < this.#template.length) {
@@ -797,7 +805,7 @@ export class MdzParser {
                 }
             }
             // Check for URL or internal absolute/relative path mid-text (char code guard avoids startsWith on every char)
-            if ((char_code === 104 /* h */ && this.#is_at_url()) ||
+            if (((char_code === 104 /* h */ || char_code === 72) /* H */ && this.#is_at_url()) ||
                 (char_code === SLASH && is_at_absolute_path(this.#template, this.#index)) ||
                 (char_code === PERIOD && is_at_relative_path(this.#template, this.#index))) {
                 break;
@@ -851,8 +859,8 @@ export class MdzParser {
                 // Paragraph break interrupts inline formatting
                 break;
             }
-            const node = this.#parse_node();
-            nodes.push(node);
+            // merge adjacent Text nodes (e.g., text + failed delimiter + text)
+            mdz_push_merging_text(nodes, this.#parse_node());
         }
         // Restore previous boundary
         this.#max_search_index = saved_max_search_index;