@fuzdev/mdz 0.2.0 → 0.4.0

package/dist/mdz_token_parser.js

@@ -6,8 +6,21 @@
  *
  * @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
+ * set shared by the delimiter-pair and link children loops (an unclosed
+ * inline never swallows block structure).
+ */
+const token_is_block_boundary = (type) => type === 'paragraph_break' ||
+    type === 'heading_start' ||
+    type === 'hr' ||
+    type === 'codeblock' ||
+    type === 'list_open' ||
+    type === 'list_item_close' ||
+    type === 'blockquote_open' ||
+    type === 'table_open';
 /**
  * Builds an `MdzNode[]` tree from a lexed `MdzToken[]` stream.
  * Used by `mdz_parse`, which should be preferred for simple usage.
@@ -88,7 +101,7 @@ export class MdzTokenParser {
                     lang: token.lang,
                     content: token.content,
                     start: token.start,
-                    end: token.end,
+                    end: token.end
                 });
                 this.#index++;
                 continue;
@@ -243,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 };
@@ -293,7 +306,7 @@ export class MdzTokenParser {
                     lang: t.lang,
                     content: t.content,
                     start: t.start,
-                    end: t.end,
+                    end: t.end
                 });
                 this.#index++;
                 continue;
@@ -365,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++;
@@ -373,7 +386,7 @@ export class MdzTokenParser {
                     type: 'Text',
                     content: `</${token.name}>`,
                     start: token.start,
-                    end: token.end,
+                    end: token.end
                 };
             default:
                 this.#index++;
@@ -398,14 +411,7 @@ export class MdzTokenParser {
                 this.#index++;
                 return { type: node_type, children, start, end: t.end };
             }
-            if (t.type === 'paragraph_break' ||
-                t.type === 'heading_start' ||
-                t.type === 'hr' ||
-                t.type === 'codeblock' ||
-                t.type === 'list_open' ||
-                t.type === 'list_item_close' ||
-                t.type === 'blockquote_open' ||
-                t.type === 'table_open') {
+            if (token_is_block_boundary(t.type)) {
                 break;
             }
             const node = this.#parse_inline();
@@ -434,20 +440,13 @@ 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
                 return { type: 'Text', content: '[', start, end: start + 1 };
             }
-            if (t.type === 'paragraph_break' ||
-                t.type === 'heading_start' ||
-                t.type === 'hr' ||
-                t.type === 'codeblock' ||
-                t.type === 'list_open' ||
-                t.type === 'list_item_close' ||
-                t.type === 'blockquote_open' ||
-                t.type === 'table_open') {
+            if (token_is_block_boundary(t.type)) {
                 break;
             }
             const node = this.#parse_inline();
@@ -465,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() {
@@ -542,7 +541,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

@@ -23,7 +23,7 @@ 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').
      *
      * If mdz content references a component not in this map,
      * that `Mdz` usage is skipped (left as runtime).
@@ -74,7 +74,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;AA+B1E;;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,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 })
             };
-        },
+        }
     };
 };
 /**
@@ -138,6 +138,29 @@ const collect_consumed_bindings = (value, bindings) => {
     collect_from_expr(value.expression);
     return consumed;
 };
+/**
+ * Parse a static mdz string and render it to Svelte markup. Returns `null` to
+ * leave the usage for the runtime — either the content raised a parse error
+ * (reported via `on_error`) or it contains unconfigured tags (which the
+ * precompiler emits nothing for; the runtime renders the fallback chrome).
+ */
+const render_static_mdz = (content, base, context) => {
+    let result;
+    try {
+        result = mdz_to_svelte(mdz_parse(content), {
+            components: context.components,
+            elements: context.elements,
+            base,
+            code_component_import: context.code_component_import,
+            codeblock_component_import: context.codeblock_component_import
+        });
+    }
+    catch (error) {
+        handle_preprocess_error(error, '[fuz-mdz]', context.filename, context.on_error);
+        return null;
+    }
+    return result.has_unconfigured_tags ? null : result;
+};
 /**
  * Walks the AST to find `Mdz` component usages with static `content` props
  * and generates transformations to replace them with `MdzPrecompiled` children.
@@ -181,25 +204,9 @@ const find_mdz_usages = (ast, mdz_names, context) => {
             // Extract static string value
             const content_value = extract_static_string(content_attr.value, context.bindings);
             if (content_value !== null) {
-                // Parse mdz content and render to Svelte markup
-                let result;
-                try {
-                    const nodes = mdz_parse(content_value);
-                    result = mdz_to_svelte(nodes, {
-                        components: context.components,
-                        elements: context.elements,
-                        base,
-                        code_component_import: context.code_component_import,
-                        codeblock_component_import: context.codeblock_component_import,
-                    });
-                }
-                catch (error) {
-                    handle_preprocess_error(error, '[fuz-mdz]', context.filename, context.on_error);
-                    return;
-                }
-                // If content has unconfigured tags, skip this usage (fall back to runtime)
-                if (result.has_unconfigured_tags)
-                    return;
+                const result = render_static_mdz(content_value, base, context);
+                if (result === null)
+                    return; // parse error or unconfigured tags — leave for runtime
                 const consumed = collect_consumed_bindings(content_attr.value, context.bindings);
                 const replacement = build_replacement(node, exclude_attrs, result.markup, context.source);
                 transformed_usages.set(node.name, (transformed_usages.get(node.name) ?? 0) + 1);
@@ -209,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;
             }
@@ -219,24 +226,11 @@ const find_mdz_usages = (ast, mdz_names, context) => {
                 return;
             // Parse and render each branch
             const branch_results = [];
-            try {
-                for (const branch of chain) {
-                    const nodes = mdz_parse(branch.value);
-                    const result = mdz_to_svelte(nodes, {
-                        components: context.components,
-                        elements: context.elements,
-                        base,
-                        code_component_import: context.code_component_import,
-                        codeblock_component_import: context.codeblock_component_import,
-                    });
-                    if (result.has_unconfigured_tags)
-                        return;
-                    branch_results.push({ markup: result.markup, imports: result.imports });
-                }
-            }
-            catch (error) {
-                handle_preprocess_error(error, '[fuz-mdz]', context.filename, context.on_error);
-                return;
+            for (const branch of chain) {
+                const result = render_static_mdz(branch.value, base, context);
+                if (result === null)
+                    return; // parse error or unconfigured tags — leave for runtime
+                branch_results.push({ markup: result.markup, imports: result.imports });
             }
             // Build {#if}/{:else if}/{:else} markup
             let children_markup = '';
@@ -270,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 };
 };
@@ -402,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,6 +1,6 @@
 {
   "name": "@fuzdev/mdz",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "a strict markdown dialect built for streaming, Svelte authoring, docs websites, and untrusted content",
   "tagline": "markdown for fuz",
   "glyph": "📝",
@@ -30,15 +30,22 @@
     "deploy": "gro deploy",
     "benchmark": "gro run src/benchmarks/mdz.benchmark.ts",
     "benchmark:save": "gro run src/benchmarks/mdz.benchmark.ts --save",
-    "benchmark:clean": "rm -f src/benchmarks/baseline.json"
+    "benchmark:clean": "rm -f src/benchmarks/baseline.json",
+    "benchmark:render": "BENCHMARK_RENDER=1 gro test render.benchmark",
+    "benchmark:render:save": "BENCHMARK_RENDER=save gro test render.benchmark",
+    "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"
@@ -56,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.50.0",
+    "@fuzdev/fuz_css": "^0.66.1",
+    "@fuzdev/fuz_ui": "^0.212.0",
+    "@fuzdev/fuz_util": "^0.72.0",
+    "@fuzdev/gro": "^0.214.0",
+    "@ryanatkn/eslint-config": "^0.12.2",
     "@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": "^7.1.2",
+    "@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.8.0",
     "svelte2tsx": "^0.7.56",
     "tslib": "^2.8.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.48.1",
-    "vite": "^8.0.16",
-    "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

@@ -50,8 +50,8 @@
  * @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
 
@@ -89,6 +89,15 @@ export class MdzTableCellParser {
 		this.#lexer = new MdzLexer(text);
 	}
 
+	/**
+	 * Rebind to a new buffer so one instance serves a whole table — the
+	 * streaming path rebinds per row (the buffer string changes across feeds;
+	 * the lexer's search memo survives when it doesn't).
+	 */
+	rebind(text: string): void {
+		this.#lexer.rebind(text);
+	}
+
 	parse(cell_start: number, cell_end: number): Array<MdzNode> {
 		this.#parser.reset(this.#lexer.lex_table_cell(cell_start, cell_end));
 		return this.#parser.parse_inline_run();

package/src/lib/mdz_contexts.ts

@@ -1,6 +1,6 @@
-import type {Component} from 'svelte';
+import type { Component } from 'svelte';
 
-import {create_context} from './context_helpers.ts';
+import { create_context } from './context_helpers.ts';
 
 /**
  * Component registry for custom Svelte components that can be used in mdz content.
@@ -56,7 +56,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 +69,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 +92,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

@@ -0,0 +1,38 @@
+/**
+ * Deterministic scan-work counter for the complexity-ratio guards
+ * (`mdz_scaling_ratio.test.ts`). Off by default; when `enabled`, the parser hot
+ * paths accumulate the number of characters scanned (and tag-stack frames
+ * walked) into `total`. Unlike wall-clock timing this is a pure function of
+ * input + algorithm — invariant across machines, runs, and thermal state — so a
+ * super-linear regression shows up as a work ratio > ~linear regardless of the
+ * ~2× machine variance that makes absolute timing unusable here. Its sole
+ * consumer is `mdz_scaling_ratio.test.ts`.
+ *
+ * Coverage is the dominant re-scan choke points — `#index_of` + `#tokenize_text`
+ * (sync) and the streaming memo scans, `consume_text_run`, and `try_close_tag`'s
+ * stack walk — not every scan. A super-linear regression isolated to an
+ * *uncounted* probe (e.g. `#has_paragraph_break_between`, the tag-name collection
+ * loop, the URL/path probes) wouldn't move the ratio; extend the instrumentation
+ * if hot cost ever migrates there.
+ *
+ * Zero store when disabled: each instrumented site guards on `enabled` (a single
+ * branch-predicted property load, the same category as the shipped `DEV`
+ * checks). It is deliberately NOT the `esm-env` `DEV` flag — `DEV` is true under
+ * every `gro test`/`gro dev` run, which would leave the counter live in ordinary
+ * development; this flag is flipped true only by the ratio test.
+ *
+ * @nodocs
+ */
+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
+ * `mdz_debug_work_reset()` immediately before a parse and read
+ * `mdz_debug_work.total` immediately after; pass `false` to disable and zero it.
+ *
+ * @nodocs
+ */
+export const mdz_debug_work_reset = (enabled = true): void => {
+	mdz_debug_work.enabled = enabled;
+	mdz_debug_work.total = 0;
+};