@fuzdev/mdz 0.3.0 → 0.5.0

package/dist/mdz_token_parser.js

@@ -6,7 +6,7 @@
  *
  * @module
  */
-import { has_non_whitespace, mdz_extract_single_tag, mdz_heading_id, mdz_merge_adjacent_text, mdz_push_merging_text, } from './mdz_helpers.js';
+import { has_non_whitespace, mdz_extract_single_tag, mdz_heading_id, mdz_merge_adjacent_text, mdz_push_merging_text } from './mdz_helpers.js';
 import {} from './mdz_lexer.js';
 /**
  * Whether a token type ends the current inline context — the block-boundary
@@ -101,7 +101,7 @@ export class MdzTokenParser {
                     lang: token.lang,
                     content: token.content,
                     start: token.start,
-                    end: token.end,
+                    end: token.end
                 });
                 this.#index++;
                 continue;
@@ -256,7 +256,7 @@ export class MdzTokenParser {
                 start_number: children[0]?.number ?? 1,
                 children,
                 start: open.start,
-                end,
+                end
             };
         }
         return { type: 'List', ordered: false, children, start: open.start, end };
@@ -306,7 +306,7 @@ export class MdzTokenParser {
                     lang: t.lang,
                     content: t.content,
                     start: t.start,
-                    end: t.end,
+                    end: t.end
                 });
                 this.#index++;
                 continue;
@@ -378,7 +378,7 @@ export class MdzTokenParser {
                     type: 'Text',
                     content: `(${token.reference})`,
                     start: token.start,
-                    end: token.end,
+                    end: token.end
                 };
             case 'tag_close':
                 this.#index++;
@@ -386,7 +386,7 @@ export class MdzTokenParser {
                     type: 'Text',
                     content: `</${token.name}>`,
                     start: token.start,
-                    end: token.end,
+                    end: token.end
                 };
             default:
                 this.#index++;
@@ -440,7 +440,7 @@ export class MdzTokenParser {
                         children,
                         link_type: ref_token.link_type,
                         start,
-                        end: ref_token.end,
+                        end: ref_token.end
                     };
                 }
                 // No link_ref - treat as text
@@ -464,7 +464,7 @@ export class MdzTokenParser {
             children: [{ type: 'Text', content: token.reference, start: token.start, end: token.end }],
             link_type: token.link_type,
             start: token.start,
-            end: token.end,
+            end: token.end
         };
     }
     #parse_tag_node() {
@@ -478,7 +478,14 @@ export class MdzTokenParser {
             const t = this.#tokens[this.#index];
             if (t.type === 'tag_close' && t.name === tag_name) {
                 this.#index++;
-                return { type: node_type, name: tag_name, children, start, end: t.end };
+                return {
+                    type: node_type,
+                    name: tag_name,
+                    attributes: open_token.attributes,
+                    children,
+                    start,
+                    end: t.end
+                };
             }
             const node = this.#parse_inline();
             if (node)
@@ -491,7 +498,14 @@ export class MdzTokenParser {
         const token = this.#tokens[this.#index];
         const node_type = token.is_component ? 'Component' : 'Element';
         this.#index++;
-        return { type: node_type, name: token.name, children: [], start: token.start, end: token.end };
+        return {
+            type: node_type,
+            name: token.name,
+            attributes: token.attributes,
+            children: [],
+            start: token.start,
+            end: token.end
+        };
     }
     // -- Paragraph flushing --
     #flush_paragraph(paragraph_children, trim_trailing = false) {
@@ -541,7 +555,7 @@ export class MdzTokenParser {
             type: 'Paragraph',
             children: merged,
             start: merged[0].start,
-            end: merged[merged.length - 1].end,
+            end: merged[merged.length - 1].end
         };
     }
 }

package/dist/svelte_preprocess_mdz.d.ts

@@ -14,6 +14,7 @@
  * @module
  */
 import { type PreprocessorGroup } from 'svelte/compiler';
+import { type MdzComponentImport } from './mdz_to_svelte.js';
 /**
  * Options for `svelte_preprocess_mdz`.
  */
@@ -23,12 +24,14 @@ export interface SveltePreprocessMdzOptions {
     /**
      * Component import mapping for mdz content.
      * Key: component name as used in mdz (e.g., 'Alert').
-     * Value: import path (e.g., '$lib/Alert.svelte').
+     * Value: import path (e.g., '#lib/Alert.svelte'), which receives no attributes,
+     * or `{path, props}` naming the attributes passed as props
+     * (e.g., `{path: '#lib/Alert.svelte', props: ['status']}`, or `props: 'all'`).
      *
      * If mdz content references a component not in this map,
      * that `Mdz` usage is skipped (left as runtime).
      */
-    components?: Record<string, string>;
+    components?: Record<string, MdzComponentImport>;
     /**
      * Allowed HTML elements in mdz content (e.g., `{aside: true, details: true}`).
      * Values are boolean placeholders for future per-element configuration,
@@ -74,7 +77,7 @@ export interface SveltePreprocessMdzOptions {
  * 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`
+ * @returns a Svelte `PreprocessorGroup` for a `preprocess` option, like `sveltekit({preprocess})` in `vite.config.ts`
  */
 export declare const svelte_preprocess_mdz: (options?: SveltePreprocessMdzOptions) => PreprocessorGroup;
 //# sourceMappingURL=svelte_preprocess_mdz.d.ts.map

package/dist/svelte_preprocess_mdz.d.ts.map

@@ -1 +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;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC3B;AAID;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GACjC,UAAS,0BAA+B,KACtC,iBAyFF,CAAC"}
+{"version":3,"file":"svelte_preprocess_mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svelte_preprocess_mdz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAS,KAAK,iBAAiB,EAAY,MAAM,iBAAiB,CAAC;AAsB1E,OAAO,EAAiB,KAAK,kBAAkB,EAA0B,MAAM,oBAAoB,CAAC;AASpG;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,gCAAgC;IAChC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAEjC;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAEhD;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC3B;AAID;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GACjC,UAAS,0BAA+B,KACtC,iBA6FF,CAAC"}

package/dist/svelte_preprocess_mdz.js

@@ -17,7 +17,7 @@ import { parse } from 'svelte/compiler';
 import MagicString from 'magic-string';
 import { walk } from 'zimmerframe';
 import { should_exclude_path } from '@fuzdev/fuz_util/path.ts';
-import { find_attribute, extract_static_string, try_extract_conditional_chain, build_static_bindings, resolve_component_names, has_identifier_in_tree, find_import_insert_position, generate_import_lines, remove_variable_declaration, remove_import_declaration, remove_import_specifier, handle_preprocess_error, } from '@fuzdev/fuz_util/svelte_preprocess_helpers.ts';
+import { find_attribute, extract_static_string, try_extract_conditional_chain, build_static_bindings, resolve_component_names, has_identifier_in_tree, find_import_insert_position, generate_import_lines, remove_variable_declaration, remove_import_declaration, remove_import_specifier, handle_preprocess_error } from '@fuzdev/fuz_util/svelte_preprocess_helpers.ts';
 import { mdz_parse } from './mdz.js';
 import { mdz_to_svelte } from './mdz_to_svelte.js';
 const PRECOMPILED_NAME = 'MdzPrecompiled';
@@ -25,10 +25,10 @@ const PRECOMPILED_NAME = 'MdzPrecompiled';
  * 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`
+ * @returns a Svelte `PreprocessorGroup` for a `preprocess` option, like `sveltekit({preprocess})` in `vite.config.ts`
  */
 export const svelte_preprocess_mdz = (options = {}) => {
-    const { exclude = [], components = {}, elements = {}, mdz_component_imports = ['@fuzdev/mdz/Mdz.svelte'], compiled_component_import = '@fuzdev/mdz/MdzPrecompiled.svelte', code_component_import, codeblock_component_import, on_error = process.env.CI === 'true' ? 'throw' : 'log', } = options;
+    const { exclude = [], components = {}, elements = {}, mdz_component_imports = ['@fuzdev/mdz/Mdz.svelte'], compiled_component_import = '@fuzdev/mdz/MdzPrecompiled.svelte', code_component_import, codeblock_component_import, on_error = process.env.CI === 'true' ? 'throw' : 'log' } = options;
     return {
         name: 'fuz-mdz',
         markup: ({ content, filename }) => {
@@ -60,7 +60,7 @@ export const svelte_preprocess_mdz = (options = {}) => {
                 bindings,
                 on_error,
                 code_component_import,
-                codeblock_component_import,
+                codeblock_component_import
             });
             if (transformations.length === 0) {
                 return { code: content };
@@ -77,9 +77,9 @@ export const svelte_preprocess_mdz = (options = {}) => {
             manage_imports(s, ast, transformations, removable_imports, compiled_component_import, content);
             return {
                 code: s.toString(),
-                map: s.generateMap({ hires: true }),
+                map: s.generateMap({ hires: true })
             };
-        },
+        }
     };
 };
 /**
@@ -152,7 +152,7 @@ const render_static_mdz = (content, base, context) => {
             elements: context.elements,
             base,
             code_component_import: context.code_component_import,
-            codeblock_component_import: context.codeblock_component_import,
+            codeblock_component_import: context.codeblock_component_import
         });
     }
     catch (error) {
@@ -216,7 +216,7 @@ const find_mdz_usages = (ast, mdz_names, context) => {
                     replacement,
                     required_imports: result.imports,
                     consumed_bindings: consumed,
-                    component_node: node,
+                    component_node: node
                 });
                 return;
             }
@@ -264,9 +264,9 @@ const find_mdz_usages = (ast, mdz_names, context) => {
                 replacement,
                 required_imports: merged_imports,
                 consumed_bindings: consumed,
-                component_node: node,
+                component_node: node
             });
-        },
+        }
     });
     return { transformations, total_usages, transformed_usages };
 };
@@ -396,7 +396,7 @@ const find_removable_mdz_imports = (ast, mdz_names, total_usages, transformed_us
             removable.set(name, {
                 node: positioned_node,
                 kind: 'partial',
-                specifier_to_remove: specifier,
+                specifier_to_remove: specifier
             });
         }
     }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@fuzdev/mdz",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "a strict markdown dialect built for streaming, Svelte authoring, docs websites, and untrusted content",
   "tagline": "markdown for fuz",
   "glyph": "📝",
   "logo": "logo.svg",
   "logo_alt": "a friendly pixelated spider facing you",
-  "license": "MIT",
+  "license": "0BSD",
   "homepage": "https://mdz.fuz.dev/",
   "author": {
     "name": "Ryan Atkinson",
@@ -36,12 +36,16 @@
     "benchmark:render:clean": "rm -f src/benchmarks/render/baseline.json"
   },
   "type": "module",
+  "imports": {
+    "#lib/*": "./src/lib/*",
+    "#routes/*": "./src/routes/*"
+  },
   "engines": {
     "node": ">=24.14"
   },
   "peerDependencies": {
     "@fuzdev/fuz_util": ">=0.65.1",
-    "@sveltejs/kit": "^2.47.3",
+    "@sveltejs/kit": "^3",
     "@types/estree": "^1",
     "esm-env": "^1",
     "svelte": "^5"
@@ -59,52 +63,33 @@
     "zimmerframe": "^1.1.4"
   },
   "devDependencies": {
-    "@fuzdev/blake3_wasm": "^0.1.1",
-    "@fuzdev/fuz_code": "^0.46.1",
-    "@fuzdev/fuz_css": "^0.63.2",
-    "@fuzdev/fuz_ui": "^0.205.1",
-    "@fuzdev/fuz_util": "^0.65.1",
-    "@fuzdev/gro": "^0.205.1",
-    "@ryanatkn/eslint-config": "^0.12.1",
+    "@fuzdev/blake3-wasm": "^0.2.0",
+    "@fuzdev/fuz_code": "^0.52.1",
+    "@fuzdev/fuz_css": "^0.66.1",
+    "@fuzdev/fuz_ui": "^0.213.0",
+    "@fuzdev/fuz_util": "^0.72.0",
+    "@fuzdev/gro": "^0.216.0",
+    "@ryanatkn/eslint-config": "^0.13.0",
     "@sveltejs/acorn-typescript": "^1.0.10",
-    "@sveltejs/adapter-static": "^3.0.10",
-    "@sveltejs/kit": "2.64.0",
-    "@sveltejs/package": "^2.5.7",
-    "@sveltejs/vite-plugin-svelte": "^6.2.4",
+    "@sveltejs/adapter-static": "^4.0.0",
+    "@sveltejs/kit": "^3.0.1",
+    "@sveltejs/package": "^3.0.0",
+    "@sveltejs/vite-plugin-svelte": "^7.3.1",
     "@types/estree": "^1.0.8",
     "@types/node": "^24.12.4",
     "@webref/css": "^8.2.0",
     "eslint": "^9.39.1",
     "eslint-plugin-svelte": "^3.13.1",
     "esm-env": "^1.2.2",
-    "prettier": "^3.7.4",
-    "prettier-plugin-svelte": "^3.5.1",
-    "svelte": "^5.56.3",
-    "svelte-check": "^4.6.0",
-    "svelte-docinfo": "^0.5.3",
+    "svelte": "^5.57.2",
+    "svelte-check": "^4.7.6",
+    "svelte-docinfo": "^0.9.0",
     "svelte2tsx": "^0.7.56",
     "tslib": "^2.8.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.48.1",
-    "vite": "^7.3.6",
-    "vitest": "^4.0.15"
-  },
-  "prettier": {
-    "plugins": [
-      "prettier-plugin-svelte"
-    ],
-    "useTabs": true,
-    "printWidth": 100,
-    "singleQuote": true,
-    "bracketSpacing": false,
-    "overrides": [
-      {
-        "files": "package.json",
-        "options": {
-          "useTabs": false
-        }
-      }
-    ]
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.71.1",
+    "vite": "^8.3.4",
+    "vitest": "^5.0.0"
   },
   "sideEffects": [
     "**/*.css"

package/src/lib/context_helpers.ts

@@ -1,4 +1,4 @@
-import {getContext, setContext} from 'svelte';
+import { getContext, setContext } from 'svelte';
 
 // This uses a function instead of a class because of the overloaded type signatures.
 // It could be implemented internally with a class like `SvelteContext`
@@ -47,6 +47,6 @@ export function create_context<T>(fallback?: () => T): {
 		},
 		get_maybe,
 		// this is typesafe, so no runtime check:
-		set: (value: T | undefined = fallback?.()) => setContext(key, value)!,
+		set: (value: T | undefined = fallback?.()) => setContext(key, value)!
 	};
 }

package/src/lib/mdz.ts

@@ -45,13 +45,13 @@
  * ## Status
  *
  * Pre-stable — breaking changes are expected as the dialect matures.
- * Next: attributes, editing.
+ * Next: editing.
  *
  * @module
  */
 
-import {MdzLexer} from './mdz_lexer.ts';
-import {MdzTokenParser} from './mdz_token_parser.ts';
+import { MdzLexer } from './mdz_lexer.ts';
+import { MdzTokenParser } from './mdz_token_parser.ts';
 
 // TODO design incremental parsing or some system that preserves Svelte components across re-renders when possible
 
@@ -251,10 +251,20 @@ export interface MdzNodeTableCell extends MdzNodeBase {
 	children: Array<MdzNode>;
 }
 
+export interface MdzAttribute {
+	name: string;
+	/** `true` for bare boolean shorthand (`disabled` ≡ `disabled={true}`). */
+	value: string | true;
+	start: number;
+	end: number;
+}
+
 export interface MdzNodeElement extends MdzNodeBase {
 	type: 'Element';
 	/** HTML element name (e.g. `div`, `span`, `aside`). */
 	name: string;
+	/** Parsed tag attributes; always present, possibly empty. */
+	attributes: Array<MdzAttribute>;
 	children: Array<MdzNode>;
 }
 
@@ -262,5 +272,7 @@ export interface MdzNodeComponent extends MdzNodeBase {
 	type: 'Component';
 	/** Svelte component name (e.g. `Alert`, `Card`). */
 	name: string;
+	/** Parsed tag attributes; always present, possibly empty. */
+	attributes: Array<MdzAttribute>;
 	children: Array<MdzNode>;
 }

package/src/lib/mdz_contexts.ts

@@ -1,22 +1,52 @@
-import type {Component} from 'svelte';
+import type { Component } from 'svelte';
 
-import {create_context} from './context_helpers.ts';
+import { create_context } from './context_helpers.ts';
+
+/**
+ * The attributes a registered component receives as props: a list of allowed
+ * names, or `'all'` to pass every attribute through. Attributes outside the
+ * list are dropped (DEV-warned).
+ */
+export type MdzComponentProps = ReadonlyArray<string> | 'all';
+
+/**
+ * A component registry entry that allows attributes through as props.
+ */
+export interface MdzComponentConfig {
+	component: Component<any, any>;
+	/** Attribute names passed as props, or `'all'`; omitted passes none. */
+	props?: MdzComponentProps;
+}
 
 /**
  * Component registry for custom Svelte components that can be used in mdz content.
  *
- * For example, registering 'Alert' allows using `<Alert>...</Alert>` in mdz content.
+ * A bare component entry renders the tag with no props — its attributes are
+ * dropped. A `MdzComponentConfig` entry names the attributes that pass through
+ * as props, so a component only receives what it's prepared for:
  *
- * The Map values are Svelte components.
+ * ```ts
+ * new Map([
+ * 	['Alert', {component: Alert, props: ['status']}], // `<Alert status="error">`
+ * 	['Note', Note], // `<Note>`, attributes dropped
+ * ]);
+ * ```
+ *
+ * Attribute values are author-controlled strings (or `true` for bare names),
+ * so with untrusted content, allow only props the component treats safely.
+ * `props: 'all'` passes everything — a component that spreads rest props onto
+ * an element then forwards `style`, `href`, and the like.
  */
-export type MdzComponents = Map<string, Component<any, any>>; // TODO support params
+// props pass through untyped (`string | true`); a typed registry is a separate concern
+export type MdzComponents = Map<string, Component<any, any> | MdzComponentConfig>;
 
 /**
  * Element registry for HTML elements that can be used in mdz content.
  *
- * For example, registering 'div' allows using `<div>...</div>` in mdz content.
- *
- * The Map values are boolean placeholders for future configuration options.
+ * Register an element by mapping its name to `true` (e.g. `['aside', true]`),
+ * which allows `<aside>...</aside>` in mdz content. Only `true` enables an
+ * element — the renderers treat any other value (including `false`) as
+ * unregistered, so the tag falls back to literal text.
  */
 export type MdzElements = Map<string, boolean>;
 
@@ -56,7 +86,7 @@ export const mdz_base_context = create_context<() => string | undefined>();
  * content as `reference` — the prop name matches `fuz_ui`'s `DocsLink`, so it
  * can be injected directly to auto-link backticked API identifiers.
  */
-export type MdzCodeComponent = Component<{reference: string}>;
+export type MdzCodeComponent = Component<{ reference: string }>;
 
 /**
  * Context for overriding how inline `` `code` `` spans render, via a getter
@@ -69,7 +99,7 @@ export const mdz_code_context = create_context<() => MdzCodeComponent | undefine
  * matching `@fuzdev/fuz_code`'s `Code`, so it can be injected directly for
  * syntax highlighting.
  */
-export type MdzCodeblockComponent = Component<{lang: string | null; content: string}>;
+export type MdzCodeblockComponent = Component<{ lang: string | null; content: string }>;
 
 /**
  * Context for overriding how fenced code blocks render, via a getter function.
@@ -92,7 +122,7 @@ interface MdzGetterContext<T> {
  */
 export const mdz_set_context_with_fallback = <T>(
 	context: MdzGetterContext<T>,
-	value_fn: () => T | undefined,
+	value_fn: () => T | undefined
 ): void => {
 	const ancestor = context.get_maybe();
 	context.set(() => value_fn() ?? ancestor?.());

package/src/lib/mdz_debug_work.ts

@@ -23,7 +23,7 @@
  *
  * @nodocs
  */
-export const mdz_debug_work: {enabled: boolean; total: number} = {enabled: false, total: 0};
+export const mdz_debug_work: { enabled: boolean; total: number } = { enabled: false, total: 0 };
 
 /**
  * Reset the counter and set whether the hot paths accumulate into it. Tests call