@fuzdev/fuz_ui 0.181.0 → 0.182.0

package/dist/DeclarationDetail.svelte

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

package/dist/LibraryDetail.svelte

@@ -270,7 +270,7 @@
 		--link_color: var(--text_70);
 	}
 	.module_content {
-		background-color: var(--shade_30);
+		background-color: var(--shade_10);
 		border-radius: var(--border_radius_sm);
 		padding: var(--space_xs);
 	}

package/dist/Mdz.svelte

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

package/dist/MdzPrecompiled.svelte

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

package/dist/MdzPrecompiled.svelte.d.ts

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

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

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

package/dist/Spiders.svelte

@@ -49,7 +49,7 @@
 	.spiders {
 		--width: calc(100% / var(--spider_count));
 		position: relative;
-		z-index: -1;
+		z-index: 1;
 		overflow: hidden;
 		display: grid;
 		grid-template-columns: repeat(var(--spider_count), 1fr);

package/dist/declaration.svelte.d.ts

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

package/dist/library.svelte.d.ts

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

package/dist/mdz_to_svelte.d.ts

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

package/dist/mdz_to_svelte.d.ts.map

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

package/dist/mdz_to_svelte.js

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

package/dist/svelte_preprocess_mdz.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Svelte preprocessor that compiles static `Mdz` content to Svelte markup at build time.
+ *
+ * Detects `Mdz` components with static string `content` props, parses the mdz content,
+ * renders each `MdzNode` to equivalent Svelte markup via `mdz_to_svelte`, and replaces
+ * the `Mdz` with `MdzPrecompiled` containing pre-rendered children.
+ *
+ * Also handles ternary chains (`content={a ? 'x' : b ? 'y' : 'z'}`) where all leaf
+ * values are statically resolvable strings, emitting `{#if a}markup_x{:else if b}markup_y{:else}markup_z{/if}`
+ * as children of a single `MdzPrecompiled`.
+ *
+ * Truly dynamic `content` props are left untouched.
+ *
+ * @module
+ */
+import { type PreprocessorGroup } from 'svelte/compiler';
+/**
+ * Options for `svelte_preprocess_mdz`.
+ */
+export interface SveltePreprocessMdzOptions {
+    /** File patterns to exclude. */
+    exclude?: Array<string | RegExp>;
+    /**
+     * Component import mapping for mdz content.
+     * Key: component name as used in mdz (e.g., 'Alert').
+     * Value: import path (e.g., '$lib/Alert.svelte').
+     *
+     * If mdz content references a component not in this map,
+     * that Mdz usage is skipped (left as runtime).
+     */
+    components?: Record<string, string>;
+    /**
+     * Allowed HTML elements in mdz content.
+     * If mdz content references an element not in this list,
+     * that Mdz usage is skipped (left as runtime).
+     */
+    elements?: Array<string>;
+    /**
+     * Import sources that resolve to the Mdz component.
+     * Used to verify that `Mdz` in templates refers to fuz_ui's Mdz.svelte.
+     *
+     * @default ['@fuzdev/fuz_ui/Mdz.svelte']
+     */
+    component_imports?: Array<string>;
+    /**
+     * Import path for the precompiled wrapper component.
+     *
+     * @default '@fuzdev/fuz_ui/MdzPrecompiled.svelte'
+     */
+    compiled_component_import?: string;
+    /**
+     * How to handle errors during mdz parsing or rendering.
+     *
+     * @default 'throw' in CI, 'log' otherwise
+     */
+    on_error?: 'log' | 'throw';
+}
+/**
+ * Creates a Svelte preprocessor that compiles static `Mdz` content at build time.
+ *
+ * @param options Configuration for component/element resolution and file filtering.
+ * @returns A Svelte `PreprocessorGroup` for use in `svelte.config.js`.
+ */
+export declare const svelte_preprocess_mdz: (options?: SveltePreprocessMdzOptions) => PreprocessorGroup;
+//# sourceMappingURL=svelte_preprocess_mdz.d.ts.map

package/dist/svelte_preprocess_mdz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte_preprocess_mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svelte_preprocess_mdz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAQ,KAAK,iBAAiB,EAAW,MAAM,iBAAiB,CAAC;AA+BxE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,gCAAgC;IAChC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAEjC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAElC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC3B;AAID;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GACjC,UAAS,0BAA+B,KACtC,iBAsFF,CAAC"}