@fuzdev/mdz 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) fuz.dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# mdz
+
+[**mdz.fuz.dev**](https://mdz.fuz.dev/)
+
+mdz is a strict markdown dialect built for streaming, Svelte authoring,
+docs websites, and untrusted content. The same grammar serves multiple use cases:
+
+- streaming output from LLMs and other live sources
+- authoring with Svelte components, with an optional build-time preprocessor
+  that compiles static usage to plain Svelte markup
+- rendering TSDoc/JSDoc comments on docs websites with domain-specific behavior
+  like backticked identifiers linkifying to API docs
+- dynamic content from untrusted users, with granular control over enabled behaviors
+
+mdz's predictable grammar means streaming never re-parses:
+LLM output renders incrementally, and the infrequent corrections --
+like an unclosed `**` or a link resolving late -- are bounded, explicit opcodes.
+The streaming design is derived from [@pngwn](https://github.com/pngwn)'s
+ideas in this [Bluesky thread](https://bsky.app/profile/pngwn.at/post/3mi527zntb22n)
+([pngwn.at](https://pngwn.at/)), and other parts of the mdz design are
+inspired by pngwn's [MDsveX](https://mdsvex.pngwn.io/).
+
+mdz takes after [CommonMark](https://commonmark.org/) and [GFM](https://github.github.com/gfm/),
+diverging where their rules fight streaming or carry avoidable complexity and ambiguity.
+For more see the [docs](https://mdz.fuz.dev/docs).
+
+AI disclosure: almost everything here was generated by machine agents except
+for the designs and intros. mdz is the result of 5+ years of prototyping ideas.
+
+## License
+
+[MIT](LICENSE)

package/dist/Mdz.svelte

@@ -0,0 +1,39 @@
+<script lang="ts">
+	import type {SvelteHTMLElements} from 'svelte/elements';
+
+	import {mdz_parse} from './mdz.js';
+	import MdzNodeView from './MdzNodeView.svelte';
+	import {
+		mdz_base_context,
+		mdz_set_context_with_fallback,
+		type MdzWhitespace,
+	} from './mdz_contexts.js';
+
+	const {
+		content,
+		inline = false,
+		whitespace,
+		base,
+		...rest
+	}: (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
+		content: string;
+		inline?: boolean;
+		/**
+		 * Sets `white-space` on the wrapper. When omitted, whitespace collapses
+		 * like standard markdown — single newlines render as soft breaks.
+		 * Use `pre-line` to render every newline as a line break.
+		 */
+		whitespace?: MdzWhitespace;
+		base?: string;
+	} = $props();
+
+	mdz_set_context_with_fallback(mdz_base_context, () => base);
+
+	const nodes = $derived(mdz_parse(content));
+</script>
+
+<svelte:element this={inline ? 'span' : 'div'} {...rest} style:white-space={whitespace}>
+	{#each nodes as node (node)}
+		<MdzNodeView {node} />
+	{/each}
+</svelte:element>

package/dist/Mdz.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { SvelteHTMLElements } from 'svelte/elements';
+import { type MdzWhitespace } from './mdz_contexts.js';
+type $$ComponentProps = (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
+    content: string;
+    inline?: boolean;
+    /**
+     * Sets `white-space` on the wrapper. When omitted, whitespace collapses
+     * like standard markdown — single newlines render as soft breaks.
+     * Use `pre-line` to render every newline as a line break.
+     */
+    whitespace?: MdzWhitespace;
+    base?: string;
+};
+declare const Mdz: import("svelte").Component<$$ComponentProps, {}, "">;
+type Mdz = ReturnType<typeof Mdz>;
+export default Mdz;
+//# sourceMappingURL=Mdz.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Mdz.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Mdz.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAIxD,OAAO,EAGL,KAAK,aAAa,EAClB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,gBAAgB,GAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AA6BH,QAAA,MAAM,GAAG,sDAAwC,CAAC;AAClD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;AAClC,eAAe,GAAG,CAAC"}

package/dist/MdzNodeView.svelte

@@ -0,0 +1,140 @@
+<script lang="ts">
+	import {resolve} from '$app/paths';
+
+	import type {MdzNode} from './mdz.js';
+	import {
+		mdz_resolve_relative_path,
+		mdz_is_safe_reference,
+		mdz_is_void_element,
+	} from './mdz_helpers.js';
+	import MdzNodeView from './MdzNodeView.svelte';
+	import {
+		mdz_components_context,
+		mdz_elements_context,
+		mdz_base_context,
+		mdz_code_context,
+		mdz_codeblock_context,
+	} from './mdz_contexts.js';
+
+	const {
+		node,
+	}: {
+		node: MdzNode;
+	} = $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();
+	const get_code = mdz_code_context.get_maybe();
+	const get_codeblock = mdz_codeblock_context.get_maybe();
+</script>
+
+{#if node.type === 'Element'}
+	{@const element_config = get_elements?.()?.get(node.name)}
+	{#if element_config !== undefined}
+		{#if mdz_is_void_element(node.name)}
+			<!-- void elements cannot have content — any parsed children are dropped -->
+			<svelte:element this={node.name} />
+		{:else}
+			<svelte:element this={node.name}>
+				{#if node.children.length > 0}
+					{@render render_children(node.children)}
+				{/if}
+			</svelte:element>
+		{/if}
+	{: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'}
+	{@const Code = get_code?.()}
+	{#if Code}
+		<Code reference={node.content} />
+	{:else}
+		<code>{node.content}</code>
+	{/if}
+{: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}
+	{#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 = mdz_resolve_relative_path(reference, mdz_base)}
+			<a href={resolve(resolved as any)}>{@render render_children(node.children)}</a>
+		{:else if skip_resolve || reference.startsWith('.') || !reference.startsWith('/')}
+			<!-- Fragment, query, and relative links (including bare references like `foo`) skip resolve() -->
+			<!-- resolve() only accepts absolute pathnames or route IDs and throws on anything else -->
+			<!-- 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 === 'List'}
+	{#if node.ordered}
+		<ol start={node.start_number === 1 ? undefined : node.start_number}>
+			{@render render_children(node.children)}
+		</ol>
+	{:else}
+		<ul>{@render render_children(node.children)}</ul>
+	{/if}
+{:else if node.type === 'ListItem'}
+	<li>{@render render_children(node.children)}</li>
+{:else if node.type === 'Blockquote'}
+	<blockquote>{@render render_children(node.children)}</blockquote>
+{:else if node.type === 'Hr'}
+	<hr />
+{:else if node.type === 'Heading'}
+	<svelte:element this={`h${node.level}`} id={node.id || undefined}>
+		{@render render_children(node.children)}
+	</svelte:element>
+{:else if node.type === 'Codeblock'}
+	{@const Codeblock = get_codeblock?.()}
+	{#if Codeblock}
+		<Codeblock lang={node.lang} content={node.content} />
+	{:else}
+		<pre><code>{node.content}</code></pre>
+	{/if}
+{/if}
+
+{#snippet render_children(nodes: Array<MdzNode>)}
+	{#each nodes as node (node)}
+		<MdzNodeView {node} />
+	{/each}
+{/snippet}
+
+{#snippet render_unregistered_tag(name: string, children: Array<MdzNode>)}
+	{#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/MdzNodeView.svelte.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"MdzNodeView.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/MdzNodeView.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,UAAU,CAAC;AAMtC,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAS9C,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE,OAAO,CAAC;CACd,CAAC;AAkIH,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/MdzPrecompiled.svelte

@@ -0,0 +1,33 @@
+<script lang="ts">
+	import type {Snippet} from 'svelte';
+	import type {SvelteHTMLElements} from 'svelte/elements';
+
+	import type {MdzWhitespace} from './mdz_contexts.js';
+
+	/**
+	 * Wrapper for precompiled mdz content. Used by `svelte_preprocess_mdz`.
+	 * Not intended for direct use.
+	 *
+	 * @module
+	 */
+
+	const {
+		inline = false,
+		whitespace,
+		children,
+		...rest
+	}: (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
+		inline?: boolean;
+		/**
+		 * Sets `white-space` on the wrapper. When omitted, whitespace collapses
+		 * like standard markdown — single newlines render as soft breaks.
+		 * Use `pre-line` to render every newline as a line break.
+		 */
+		whitespace?: MdzWhitespace;
+		children: Snippet;
+	} = $props();
+</script>
+
+<svelte:element this={inline ? 'span' : 'div'} {...rest} style:white-space={whitespace}>
+	{@render children()}
+</svelte:element>

package/dist/MdzPrecompiled.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { Snippet } from 'svelte';
+import type { SvelteHTMLElements } from 'svelte/elements';
+import type { MdzWhitespace } from './mdz_contexts.js';
+type $$ComponentProps = (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
+    inline?: boolean;
+    /**
+     * Sets `white-space` on the wrapper. When omitted, whitespace collapses
+     * like standard markdown — single newlines render as soft breaks.
+     * Use `pre-line` to render every newline as a line break.
+     */
+    whitespace?: MdzWhitespace;
+    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;AAExD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAEpD,KAAK,gBAAgB,GAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AA4BH,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/MdzRoot.svelte

@@ -0,0 +1,40 @@
+<script lang="ts">
+	import type {Snippet} from 'svelte';
+
+	import {
+		mdz_base_context,
+		mdz_code_context,
+		mdz_codeblock_context,
+		mdz_components_context,
+		mdz_elements_context,
+		mdz_set_context_with_fallback,
+		type MdzCodeComponent,
+		type MdzCodeblockComponent,
+		type MdzComponents,
+		type MdzElements,
+	} from './mdz_contexts.js';
+
+	const {
+		base,
+		components,
+		elements,
+		code,
+		codeblock,
+		children,
+	}: {
+		base?: string;
+		components?: MdzComponents;
+		elements?: MdzElements;
+		code?: MdzCodeComponent;
+		codeblock?: MdzCodeblockComponent;
+		children: Snippet;
+	} = $props();
+
+	mdz_set_context_with_fallback(mdz_base_context, () => base);
+	mdz_set_context_with_fallback(mdz_components_context, () => components);
+	mdz_set_context_with_fallback(mdz_elements_context, () => elements);
+	mdz_set_context_with_fallback(mdz_code_context, () => code);
+	mdz_set_context_with_fallback(mdz_codeblock_context, () => codeblock);
+</script>
+
+{@render children()}

package/dist/MdzRoot.svelte.d.ts

@@ -0,0 +1,14 @@
+import type { Snippet } from 'svelte';
+import { type MdzCodeComponent, type MdzCodeblockComponent, type MdzComponents, type MdzElements } from './mdz_contexts.js';
+type $$ComponentProps = {
+    base?: string;
+    components?: MdzComponents;
+    elements?: MdzElements;
+    code?: MdzCodeComponent;
+    codeblock?: MdzCodeblockComponent;
+    children: Snippet;
+};
+declare const MdzRoot: import("svelte").Component<$$ComponentProps, {}, "">;
+type MdzRoot = ReturnType<typeof MdzRoot>;
+export default MdzRoot;
+//# sourceMappingURL=MdzRoot.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MdzRoot.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/MdzRoot.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAOL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,gBAAgB,GAAI;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AA0BH,QAAA,MAAM,OAAO,sDAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/MdzStream.svelte

@@ -0,0 +1,37 @@
+<script lang="ts">
+	import type {SvelteHTMLElements} from 'svelte/elements';
+
+	import MdzStreamNodeView from './MdzStreamNodeView.svelte';
+	import {
+		mdz_base_context,
+		mdz_set_context_with_fallback,
+		type MdzWhitespace,
+	} from './mdz_contexts.js';
+	import type {MdzStreamState} from './mdz_stream_state.svelte.js';
+
+	const {
+		stream,
+		inline = false,
+		whitespace,
+		base,
+		...rest
+	}: (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
+		stream: MdzStreamState;
+		inline?: boolean;
+		/**
+		 * Sets `white-space` on the wrapper. When omitted, whitespace collapses
+		 * like standard markdown — single newlines render as soft breaks.
+		 * Use `pre-line` to render every newline as a line break.
+		 */
+		whitespace?: MdzWhitespace;
+		base?: string;
+	} = $props();
+
+	mdz_set_context_with_fallback(mdz_base_context, () => base);
+</script>
+
+<svelte:element this={inline ? 'span' : 'div'} {...rest} style:white-space={whitespace}>
+	{#each stream.root as node (node.id)}
+		<MdzStreamNodeView {node} />
+	{/each}
+</svelte:element>

package/dist/MdzStream.svelte.d.ts

@@ -0,0 +1,18 @@
+import type { SvelteHTMLElements } from 'svelte/elements';
+import { type MdzWhitespace } from './mdz_contexts.js';
+import type { MdzStreamState } from './mdz_stream_state.svelte.js';
+type $$ComponentProps = (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
+    stream: MdzStreamState;
+    inline?: boolean;
+    /**
+     * Sets `white-space` on the wrapper. When omitted, whitespace collapses
+     * like standard markdown — single newlines render as soft breaks.
+     * Use `pre-line` to render every newline as a line break.
+     */
+    whitespace?: MdzWhitespace;
+    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;AAGxD,OAAO,EAGL,KAAK,aAAa,EAClB,MAAM,mBAAmB,CAAC;AAC5B,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,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,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,150 @@
+<script lang="ts">
+	import {resolve} from '$app/paths';
+
+	import {
+		mdz_resolve_relative_path,
+		mdz_is_safe_reference,
+		mdz_is_void_element,
+	} from './mdz_helpers.js';
+	import MdzStreamNodeView from './MdzStreamNodeView.svelte';
+	import {
+		mdz_components_context,
+		mdz_elements_context,
+		mdz_base_context,
+		mdz_code_context,
+		mdz_codeblock_context,
+	} from './mdz_contexts.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();
+	const get_code = mdz_code_context.get_maybe();
+	const get_codeblock = mdz_codeblock_context.get_maybe();
+
+	// While a Code/Codeblock container is open, streamed text accumulates in
+	// `children`; `MdzStreamState` collapses it into `content` at close. Joining
+	// the children makes the content visible as it streams instead of popping in
+	// all at once when the fence closes (`content` is preferred after close —
+	// it's identical, the children are just retained in the render tree).
+	const streaming_content = (n: MdzStreamNode): string =>
+		n.content || n.children.map((c) => c.content).join('');
+</script>
+
+{#if node.type === 'Element'}
+	{@const element_config = get_elements?.()?.get(node.name ?? '')}
+	{#if element_config !== undefined}
+		{#if mdz_is_void_element(node.name ?? '')}
+			<!-- void elements cannot have content — any parsed children are dropped -->
+			<svelte:element this={node.name} />
+		{:else}
+			<svelte:element this={node.name}>
+				{#if node.children.length > 0}
+					{@render render_children(node.children)}
+				{/if}
+			</svelte:element>
+		{/if}
+	{: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'}
+	{@const Code = get_code?.()}
+	{@const code_content = streaming_content(node)}
+	{#if Code}
+		<Code reference={code_content} />
+	{:else}
+		<code>{code_content}</code>
+	{/if}
+{: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 = mdz_resolve_relative_path(reference, mdz_base)}
+			<a href={resolve(resolved as any)}>{@render render_children(node.children)}</a>
+		{:else if skip_resolve || reference.startsWith('.') || !reference.startsWith('/')}
+			<!-- Fragment, query, and relative links (including bare references like `foo`) skip resolve() -->
+			<!-- resolve() only accepts absolute pathnames or route IDs and throws on anything else -->
+			<!-- 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 === 'List'}
+	{#if node.ordered}
+		<ol start={node.start_number === 1 ? undefined : node.start_number}>
+			{@render render_children(node.children)}
+		</ol>
+	{:else}
+		<ul>{@render render_children(node.children)}</ul>
+	{/if}
+{:else if node.type === 'ListItem'}
+	<li>{@render render_children(node.children)}</li>
+{:else if node.type === 'Blockquote'}
+	<blockquote>{@render render_children(node.children)}</blockquote>
+{:else if node.type === 'Hr'}
+	<hr />
+{:else if node.type === 'Heading'}
+	<svelte:element this={`h${node.level}`} id={node.heading_id || undefined}>
+		{@render render_children(node.children)}
+	</svelte:element>
+{:else if node.type === 'Codeblock'}
+	{@const Codeblock = get_codeblock?.()}
+	{@const codeblock_content = streaming_content(node)}
+	{#if Codeblock}
+		<Codeblock lang={node.lang ?? null} content={codeblock_content} />
+	{:else}
+		<pre><code>{codeblock_content}</code></pre>
+	{/if}
+{/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":"AAUA,OAAO,iBAAiB,MAAM,4BAA4B,CAAC;AAQ3D,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,8BAA8B,CAAC;AAE/D,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE,aAAa,CAAC;CACpB,CAAC;AA4IH,QAAA,MAAM,iBAAiB,sDAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/context_helpers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Wraps Svelte's `setContext` and `getContext` for better ergonomics.
+ * When no value is set in the context,
+ * `get` throws an error and `get_maybe` returns `undefined`.
+ * If a `fallback` is provided, the `value` argument to `set` is optional
+ * and `get_maybe` is omitted from the type.
+ *
+ * Vendored from `@fuzdev/fuz_ui/context_helpers.js` — fuz_ui sits above mdz
+ * in the dependency graph, so mdz keeps its own copy for `mdz_contexts.ts`.
+ * Consumers should import fuz_ui's.
+ *
+ * @nodocs
+ */
+export declare function create_context<T>(fallback: () => T): {
+    get: () => T;
+    set: (value?: T) => T;
+};
+export declare function create_context<T>(): {
+    get: (error_message?: string) => T;
+    get_maybe: () => T | undefined;
+    set: (value: T) => T;
+};
+//# sourceMappingURL=context_helpers.d.ts.map

package/dist/context_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/context_helpers.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG;IACrD,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;CACtB,CAAC;AACF,wBAAgB,cAAc,CAAC,CAAC,KAAK;IACpC,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC/B,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CACrB,CAAC"}

package/dist/context_helpers.js

@@ -0,0 +1,19 @@
+import { getContext, setContext } from 'svelte';
+export function create_context(fallback) {
+    const key = Symbol();
+    const get_maybe = () => {
+        const value = getContext(key); // treat `null` as a valid value - the `typescript-eslint` rule below is bugged because `??` would clobber nulls, see issue https://github.com/typescript-eslint/typescript-eslint/issues/7842
+        return value === undefined ? fallback?.() : value;
+    };
+    return {
+        get: (error_message) => {
+            const value = get_maybe();
+            if (value === undefined)
+                throw Error(error_message ?? 'context value is not set');
+            return value;
+        },
+        get_maybe,
+        // this is typesafe, so no runtime check:
+        set: (value = fallback?.()) => setContext(key, value),
+    };
+}