@fuzdev/fuz_ui 0.189.1 → 0.191.0

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, } 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, 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';
 // TODO design incremental parsing or some system that preserves Svelte components across re-renders when possible
 /**
  * Parses text to an array of `MdzNode`.
@@ -507,89 +507,32 @@ export class MdzParser {
      */
     #parse_tag() {
         const start = this.#index;
-        // Save parent accumulation state to avoid polluting component children with parent's accumulated text
-        const saved_state = this.#save_accumulation_state();
-        // Clear accumulation state for parsing component children
-        this.#accumulated_text = '';
-        this.#nodes.length = 0;
-        // Consume <
-        if (!this.#match('<')) {
-            // Restore parent state before returning
-            this.#restore_accumulation_state(saved_state);
-            const content = this.#template[this.#index];
-            this.#index++;
-            return {
-                type: 'Text',
-                content,
-                start,
-                end: this.#index,
-            };
-        }
-        this.#index++;
-        // Parse tag name
-        const tag_name_start = this.#index;
-        let tag_name_end = this.#index;
+        // Phase 1: Validate tag structure using a local scan index.
+        // Avoids save/restore of accumulation state on the fast path
+        // (most `<` characters are not valid tags).
+        let i = start + 1; // skip <
         // Tag name must start with a letter
-        if (this.#index >= this.#template.length) {
-            // Just a `<` at EOF - restore parent state
-            this.#restore_accumulation_state(saved_state);
-            return {
-                type: 'Text',
-                content: '<',
-                start,
-                end: this.#index,
-            };
-        }
-        const first_char = this.#template.charCodeAt(this.#index);
-        if (!is_letter(first_char)) {
-            // Not a valid tag, treat as text - restore parent state
-            this.#restore_accumulation_state(saved_state);
-            return {
-                type: 'Text',
-                content: '<',
-                start,
-                end: start + 1,
-            };
+        if (i >= this.#template.length || !is_letter(this.#template.charCodeAt(i))) {
+            this.#index = start + 1;
+            return this.#make_text_node('<', start);
         }
         // Collect tag name (letters, numbers, hyphens, underscores)
-        while (this.#index < this.#template.length) {
-            const char_code = this.#template.charCodeAt(this.#index);
-            if (is_tag_name_char(char_code)) {
-                this.#index++;
-            }
-            else {
-                break;
-            }
-        }
-        tag_name_end = this.#index;
-        const tag_name = this.#template.slice(tag_name_start, tag_name_end);
-        if (tag_name.length === 0) {
-            // Empty tag name - restore parent state
-            this.#restore_accumulation_state(saved_state);
-            return {
-                type: 'Text',
-                content: '<',
-                start,
-                end: start + 1,
-            };
+        while (i < this.#template.length && is_tag_name_char(this.#template.charCodeAt(i))) {
+            i++;
         }
-        // Determine if this is a Component (uppercase) or Element (lowercase)
+        const tag_name = this.#template.slice(start + 1, i);
         const first_char_code = tag_name.charCodeAt(0);
-        const is_component = first_char_code >= A_UPPER && first_char_code <= Z_UPPER;
-        const node_type = is_component ? 'Component' : 'Element';
+        const node_type = first_char_code >= A_UPPER && first_char_code <= Z_UPPER ? 'Component' : 'Element';
         // Skip whitespace after tag name (for future attribute support)
-        while (this.#index < this.#template.length &&
-            this.#template.charCodeAt(this.#index) === SPACE) {
-            this.#index++;
+        while (i < this.#template.length && this.#template.charCodeAt(i) === SPACE) {
+            i++;
         }
         // TODO: Parse attributes here
         // Check for self-closing />
-        if (this.#index + 1 < this.#template.length &&
-            this.#template.charCodeAt(this.#index) === SLASH &&
-            this.#template.charCodeAt(this.#index + 1) === RIGHT_ANGLE) {
-            this.#index += 2;
-            // Restore parent state before returning
-            this.#restore_accumulation_state(saved_state);
+        if (i + 1 < this.#template.length &&
+            this.#template.charCodeAt(i) === SLASH &&
+            this.#template.charCodeAt(i + 1) === RIGHT_ANGLE) {
+            this.#index = i + 2;
             return {
                 type: node_type,
                 name: tag_name,
@@ -598,33 +541,38 @@ export class MdzParser {
                 end: this.#index,
             };
         }
-        // Check for closing >
-        if (this.#index >= this.#template.length ||
-            this.#template.charCodeAt(this.#index) !== RIGHT_ANGLE) {
-            // Unclosed opening tag, treat as text - restore parent state
-            this.#restore_accumulation_state(saved_state);
+        // Must have closing >
+        if (i >= this.#template.length || this.#template.charCodeAt(i) !== RIGHT_ANGLE) {
             this.#index = start + 1;
-            return {
-                type: 'Text',
-                content: '<',
-                start,
-                end: this.#index,
-            };
+            return this.#make_text_node('<', start);
         }
-        // Consume >
-        this.#index++;
-        // Parse children until closing tag
+        const content_start = i + 1; // past >
+        // Bail early if closing tag is missing, past a paragraph break,
+        // or past the search boundary (e.g. heading line end)
         const closing_tag = `</${tag_name}>`;
+        const search_limit = Math.min(this.#max_search_index, this.#template.length);
+        const close_tag_index = this.#template.indexOf(closing_tag, content_start);
+        if (close_tag_index === -1 || close_tag_index >= search_limit) {
+            this.#index = start + 1;
+            return this.#make_text_node('<', start);
+        }
+        const para_break = this.#template.indexOf('\n\n', content_start);
+        if (para_break !== -1 && para_break < close_tag_index) {
+            this.#index = start + 1;
+            return this.#make_text_node('<', start);
+        }
+        // Phase 2: Tag validated — save accumulation state and parse children.
+        const saved_state = this.#save_accumulation_state();
+        this.#accumulated_text = '';
+        this.#nodes.length = 0;
+        this.#index = content_start;
         const children = [];
         while (this.#index < this.#template.length) {
-            // Check for closing tag
             if (this.#match(closing_tag)) {
-                // Flush any accumulated text from children
                 this.#flush_text();
                 children.push(...this.#nodes);
                 this.#nodes.length = 0;
                 this.#index += closing_tag.length;
-                // Restore parent state before returning
                 this.#restore_accumulation_state(saved_state);
                 return {
                     type: node_type,
@@ -645,16 +593,10 @@ export class MdzParser {
                 children.push(node);
             }
         }
-        // Unclosed tag - reached EOF without finding closing tag
-        // Treat the opening tag as text - restore parent state
+        // Defensive: pre-check guarantees closing tag exists, but handle EOF gracefully
         this.#restore_accumulation_state(saved_state);
         this.#index = start + 1;
-        return {
-            type: 'Text',
-            content: '<',
-            start,
-            end: this.#index,
-        };
+        return this.#make_text_node('<', start);
     }
     /**
      * Read-only check if current position matches a block element.
@@ -1038,29 +980,27 @@ export class MdzParser {
         }
         // Consume the space after hashes (already verified to exist)
         this.#index++;
-        // Parse inline content until newline
+        // Find end-of-line to bound nested parsers (prevents tag scanner from scanning past heading)
+        let eol = this.#template.indexOf('\n', this.#index);
+        if (eol === -1)
+            eol = this.#template.length;
+        const saved_max_search_index = this.#max_search_index;
+        this.#max_search_index = eol;
+        // Parse inline content until end of line
         const content_nodes = [];
-        while (this.#index < this.#template.length) {
-            const char_code = this.#template.charCodeAt(this.#index);
-            if (char_code === NEWLINE) {
-                break;
-            }
+        while (this.#index < eol) {
             const node = this.#parse_node();
             if (node.type === 'Text') {
-                // Check if text node includes a newline (since #parse_text doesn't stop at single newlines)
-                // If so, trim it and move index back
-                const newline_index = node.content.indexOf('\n');
-                if (newline_index !== -1) {
-                    const trimmed_content = node.content.slice(0, newline_index);
+                // Trim if #parse_text overshot past the newline
+                if (node.end > eol) {
+                    const trimmed_content = node.content.slice(0, eol - node.start);
                     if (trimmed_content) {
                         this.#accumulate_text(trimmed_content, node.start);
                     }
-                    this.#index = node.start + newline_index;
+                    this.#index = eol;
                     break;
                 }
-                else {
-                    this.#accumulate_text(node.content, node.start);
-                }
+                this.#accumulate_text(node.content, node.start);
             }
             else {
                 this.#flush_text();
@@ -1069,6 +1009,7 @@ export class MdzParser {
                 content_nodes.push(node);
             }
         }
+        this.#max_search_index = saved_max_search_index;
         this.#flush_text();
         content_nodes.push(...this.#nodes);
         this.#nodes.length = 0;
@@ -1076,6 +1017,7 @@ export class MdzParser {
         return {
             type: 'Heading',
             level: level,
+            id: mdz_heading_id(content_nodes),
             children: content_nodes,
             start,
             end: this.#index,
@@ -1234,44 +1176,3 @@ export class MdzParser {
         throw Error('Code block not properly closed');
     }
 }
-/**
- * Check if a string is a URL (`https://` or `http://`).
- * Requires at least one valid character after the protocol.
- * Rejects whitespace and characters that can't start a valid hostname.
- */
-const URL_PATTERN = /^https?:\/\/[^\s)\]}<>.,:/?#!]/;
-export const mdz_is_url = (s) => URL_PATTERN.test(s);
-/**
- * Resolves a relative path (`./` or `../`) against a base path.
- * The base is treated as a directory regardless of trailing slash
- * (`'/docs/mdz'` and `'/docs/mdz/'` behave identically).
- * Handles embedded `.` and `..` segments within the reference
- * (e.g., `'./a/../b'` → navigates up then down).
- * Clamps at root — excess `..` segments stop at `/` rather than escaping.
- *
- * @param reference A relative path starting with `./` or `../`.
- * @param base An absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
- * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
- */
-export const resolve_relative_path = (reference, base) => {
-    const segments = base.split('/');
-    // Remove trailing empty from split (e.g., '/docs/mdz/' → ['', 'docs', 'mdz', ''])
-    // but keep the root segment ([''] from '' base or ['', ''] from '/').
-    if (segments.length > 1 && segments.at(-1) === '')
-        segments.pop();
-    const trailing = reference.endsWith('/');
-    for (const segment of reference.split('/')) {
-        if (segment === '.' || segment === '')
-            continue;
-        if (segment === '..') {
-            if (segments.length > 1)
-                segments.pop(); // clamp at root
-        }
-        else {
-            segments.push(segment);
-        }
-    }
-    if (trailing)
-        segments.push('');
-    return segments.join('/');
-};

package/dist/mdz_helpers.d.ts

@@ -95,14 +95,38 @@ export declare const trim_trailing_punctuation: (url: string) => string;
 /**
  * Check if position in text is the start of an absolute path (starts with `/`).
  * Must be preceded by whitespace or be at the start of the string.
- * Rejects `//` (comments/protocol-relative) and `/ ` (bare slash).
+ * Rejects `//` (comments/protocol-relative) and slash followed by whitespace.
  */
 export declare const is_at_absolute_path: (text: string, index: number) => boolean;
 /**
  * Check if position in text is the start of a relative path (`./` or `../`).
  * Must be preceded by whitespace or be at the start of the string.
- * Requires at least one path character after the prefix.
+ * Rejects prefix followed by whitespace, slash, or end of string.
  */
 export declare const is_at_relative_path: (text: string, index: number) => boolean;
+/**
+ * Extracts plain text content from an array of mdz nodes, recursing into children.
+ */
+export declare const mdz_text_content: (nodes: Array<MdzNode>) => string;
+/**
+ * Generates a lowercase slug id for a heading from its child nodes.
+ * Follows standard markdown conventions (GitHub, etc.) where heading IDs are lowercased.
+ * For case-preserving IDs (e.g. API declarations), see `docs_slugify` in `docs_helpers.svelte.ts`.
+ */
+export declare const mdz_heading_id: (nodes: Array<MdzNode>) => string;
+export declare const mdz_is_url: (s: string) => boolean;
+/**
+ * Resolves a relative path (`./` or `../`) against a base path.
+ * The base is treated as a directory regardless of trailing slash
+ * (`'/docs/mdz'` and `'/docs/mdz/'` behave identically).
+ * Handles embedded `.` and `..` segments within the reference
+ * (e.g., `'./a/../b'` → navigates up then down).
+ * Clamps at root — excess `..` segments stop at `/` rather than escaping.
+ *
+ * @param reference - a relative path starting with `./` or `../`.
+ * @param base - an absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
+ * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
+ */
+export declare const resolve_relative_path: (reference: string, base: string) => string;
 export declare const extract_single_tag: (nodes: Array<MdzNode>) => MdzComponentNode | MdzElementNode | null;
 //# sourceMappingURL=mdz_helpers.d.ts.map

package/dist/mdz_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdz_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAC,MAAM,UAAU,CAAC;AAGxE,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,KAAK,MAAM,CAAC;AACzB,eAAO,MAAM,OAAO,KAAK,CAAC;AAC1B,eAAO,MAAM,MAAM,KAAK,CAAC;AACzB,eAAO,MAAM,IAAI,KAAK,CAAC;AACvB,eAAO,MAAM,KAAK,KAAK,CAAC;AACxB,eAAO,MAAM,GAAG,IAAI,CAAC;AACrB,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,KAAK,KAAK,CAAC;AACxB,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,KAAK,KAAK,CAAC;AACxB,eAAO,MAAM,MAAM,KAAK,CAAC;AACzB,eAAO,MAAM,KAAK,KAAK,CAAC;AACxB,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,QAAQ,KAAK,CAAC;AAE3B,eAAO,MAAM,MAAM,KAAK,CAAC;AACzB,eAAO,MAAM,OAAO,KAAK,CAAC;AAC1B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,IAAI,KAAK,CAAC;AACvB,eAAO,MAAM,MAAM,KAAK,CAAC;AACzB,eAAO,MAAM,EAAE,KAAK,CAAC;AAErB,eAAO,MAAM,OAAO,KAAK,CAAC;AAC1B,eAAO,MAAM,OAAO,KAAK,CAAC;AAC1B,eAAO,MAAM,OAAO,KAAK,CAAC;AAC1B,eAAO,MAAM,OAAO,MAAM,CAAC;AAC3B,eAAO,MAAM,IAAI,KAAK,CAAC;AACvB,eAAO,MAAM,IAAI,KAAK,CAAC;AAEvB,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,KAAG,OACmD,CAAC;AAElG;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,OAI5B,CAAC;AAE1B;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,OAOhD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAAI,WAAW,MAAM,KAAG,OAwBjC,CAAC;AAEvB;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,MAAM,KAAG,MA4CvD,CAAC;AAEF;;;;GAIG;AACH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,OASjE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,OAsBjE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,KACnB,gBAAgB,GAAG,cAAc,GAAG,IAiBtC,CAAC"}
+{"version":3,"file":"mdz_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz_helpers.ts"],"names":[],"mappings":"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"}

package/dist/mdz_helpers.js

@@ -6,6 +6,7 @@
  *
  * @module
  */
+import { slugify } from '@fuzdev/fuz_util/path.js';
 // Character codes for performance
 export const BACKTICK = 96; // `
 export const ASTERISK = 42; // *
@@ -172,7 +173,7 @@ export const trim_trailing_punctuation = (url) => {
 /**
  * Check if position in text is the start of an absolute path (starts with `/`).
  * Must be preceded by whitespace or be at the start of the string.
- * Rejects `//` (comments/protocol-relative) and `/ ` (bare slash).
+ * Rejects `//` (comments/protocol-relative) and slash followed by whitespace.
  */
 export const is_at_absolute_path = (text, index) => {
     if (text.charCodeAt(index) !== SLASH)
@@ -185,12 +186,12 @@ export const is_at_absolute_path = (text, index) => {
     if (index + 1 >= text.length)
         return false;
     const next_char = text.charCodeAt(index + 1);
-    return next_char !== SLASH && next_char !== SPACE && next_char !== NEWLINE;
+    return next_char !== SLASH && next_char !== SPACE && next_char !== NEWLINE && next_char !== TAB;
 };
 /**
  * Check if position in text is the start of a relative path (`./` or `../`).
  * Must be preceded by whitespace or be at the start of the string.
- * Requires at least one path character after the prefix.
+ * Rejects prefix followed by whitespace, slash, or end of string.
  */
 export const is_at_relative_path = (text, index) => {
     if (text.charCodeAt(index) !== PERIOD)
@@ -206,15 +207,68 @@ export const is_at_relative_path = (text, index) => {
         text.charCodeAt(index + 1) === PERIOD &&
         text.charCodeAt(index + 2) === SLASH) {
         const after = text.charCodeAt(index + 3);
-        return after !== SPACE && after !== NEWLINE && after !== SLASH;
+        return after !== SPACE && after !== NEWLINE && after !== TAB && after !== SLASH;
     }
     // Check for ./ (at least 3 chars: ./x)
     if (remaining >= 3 && text.charCodeAt(index + 1) === SLASH) {
         const after = text.charCodeAt(index + 2);
-        return after !== SPACE && after !== NEWLINE && after !== SLASH;
+        return after !== SPACE && after !== NEWLINE && after !== TAB && after !== SLASH;
     }
     return false;
 };
+/**
+ * Extracts plain text content from an array of mdz nodes, recursing into children.
+ */
+export const mdz_text_content = (nodes) => nodes
+    .map((n) => ('children' in n ? mdz_text_content(n.children) : 'content' in n ? n.content : ''))
+    .join('');
+/**
+ * Generates a lowercase slug id for a heading from its child nodes.
+ * Follows standard markdown conventions (GitHub, etc.) where heading IDs are lowercased.
+ * For case-preserving IDs (e.g. API declarations), see `docs_slugify` in `docs_helpers.svelte.ts`.
+ */
+export const mdz_heading_id = (nodes) => slugify(mdz_text_content(nodes), false);
+/**
+ * Check if a string is a URL (`https://` or `http://`).
+ * Requires at least one valid character after the protocol.
+ * Rejects whitespace and characters that can't start a valid hostname.
+ */
+const URL_PATTERN = /^https?:\/\/[^\s)\]}<>.,:/?#!]/;
+export const mdz_is_url = (s) => URL_PATTERN.test(s);
+/**
+ * Resolves a relative path (`./` or `../`) against a base path.
+ * The base is treated as a directory regardless of trailing slash
+ * (`'/docs/mdz'` and `'/docs/mdz/'` behave identically).
+ * Handles embedded `.` and `..` segments within the reference
+ * (e.g., `'./a/../b'` → navigates up then down).
+ * Clamps at root — excess `..` segments stop at `/` rather than escaping.
+ *
+ * @param reference - a relative path starting with `./` or `../`.
+ * @param base - an absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
+ * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
+ */
+export const resolve_relative_path = (reference, base) => {
+    const segments = base.split('/');
+    // Remove trailing empty from split (e.g., '/docs/mdz/' → ['', 'docs', 'mdz', ''])
+    // but keep the root segment ([''] from '' base or ['', ''] from '/').
+    if (segments.length > 1 && segments.at(-1) === '')
+        segments.pop();
+    const trailing = reference.endsWith('/');
+    for (const segment of reference.split('/')) {
+        if (segment === '.' || segment === '')
+            continue;
+        if (segment === '..') {
+            if (segments.length > 1)
+                segments.pop(); // clamp at root
+        }
+        else {
+            segments.push(segment);
+        }
+    }
+    if (trailing)
+        segments.push('');
+    return segments.join('/');
+};
 export const extract_single_tag = (nodes) => {
     let tag = null;
     for (const node of nodes) {

package/dist/mdz_lexer.d.ts.map

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

package/dist/mdz_lexer.js

@@ -6,8 +6,7 @@
  *
  * @module
  */
-import { mdz_is_url } from './mdz.js';
-import { is_letter, is_tag_name_char, is_word_char, is_valid_path_char, trim_trailing_punctuation, BACKTICK, ASTERISK, UNDERSCORE, TILDE, NEWLINE, HYPHEN, HASH, SPACE, TAB, LEFT_ANGLE, RIGHT_ANGLE, SLASH, PERIOD, LEFT_BRACKET, LEFT_PAREN, RIGHT_PAREN, RIGHT_BRACKET, A_UPPER, Z_UPPER, HR_HYPHEN_COUNT, MIN_CODEBLOCK_BACKTICKS, MAX_HEADING_LEVEL, HTTPS_PREFIX_LENGTH, HTTP_PREFIX_LENGTH, is_at_absolute_path, is_at_relative_path, } from './mdz_helpers.js';
+import { mdz_is_url, is_letter, is_tag_name_char, is_word_char, is_valid_path_char, trim_trailing_punctuation, BACKTICK, ASTERISK, UNDERSCORE, TILDE, NEWLINE, HYPHEN, HASH, SPACE, TAB, LEFT_ANGLE, RIGHT_ANGLE, SLASH, PERIOD, LEFT_BRACKET, LEFT_PAREN, RIGHT_PAREN, RIGHT_BRACKET, A_UPPER, Z_UPPER, HR_HYPHEN_COUNT, MIN_CODEBLOCK_BACKTICKS, MAX_HEADING_LEVEL, HTTPS_PREFIX_LENGTH, HTTP_PREFIX_LENGTH, is_at_absolute_path, is_at_relative_path, } from './mdz_helpers.js';
 //
 // Lexer
 //
@@ -99,13 +98,16 @@ export class MdzLexer {
             start,
             end: this.#index, // end of "## " prefix
         });
+        // Find end-of-line to bound nested tokenizers (prevents tag scanner from scanning past heading)
+        let eol = this.#text.indexOf('\n', this.#index);
+        if (eol === -1)
+            eol = this.#text.length;
+        const saved_max = this.#max_search_index;
+        this.#max_search_index = eol;
         // Tokenize inline content until newline or EOF
         // tokenize_text may consume a newline as part of block-element lookahead,
         // so we check emitted text tokens for embedded newlines and trim.
-        while (this.#index < this.#text.length) {
-            if (this.#text.charCodeAt(this.#index) === NEWLINE) {
-                break;
-            }
+        while (this.#index < eol) {
             const token_count_before = this.#tokens.length;
             this.#tokenize_inline();
             // Check if the last emitted token is text containing a newline
@@ -128,6 +130,7 @@ export class MdzLexer {
                 }
             }
         }
+        this.#max_search_index = saved_max;
         // Emit heading_end marker so the token parser knows where heading content stops
         this.#tokens.push({ type: 'heading_end', start: this.#index, end: this.#index });
         // Skip newlines after heading (like original parser's main loop)
@@ -548,11 +551,17 @@ export class MdzLexer {
             return;
         }
         this.#index++; // consume >
-        // Check for closing tag existence before committing
+        // Check for closing tag existence before committing —
+        // must exist within search boundary and before any paragraph break
         const closing_tag = `</${tag_name}>`;
+        const search_limit = Math.min(this.#max_search_index, this.#text.length);
         const closing_tag_pos = this.#text.indexOf(closing_tag, this.#index);
-        if (closing_tag_pos === -1) {
-            // No closing tag - revert
+        if (closing_tag_pos === -1 || closing_tag_pos >= search_limit) {
+            this.#index = start + 1;
+            this.#emit_text('<', start);
+            return;
+        }
+        if (this.#has_paragraph_break_between(this.#index, closing_tag_pos)) {
             this.#index = start + 1;
             this.#emit_text('<', start);
             return;

package/dist/mdz_to_svelte.d.ts

@@ -7,7 +7,7 @@
  *
  * @module
  */
-import { type MdzNode } from './mdz.js';
+import type { MdzNode } from './mdz.js';
 /**
  * Result of converting `MdzNode` arrays to Svelte markup.
  */
@@ -28,12 +28,12 @@ export interface MdzToSvelteResult {
  * 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'}`).
+ * @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'])`).
+ * @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.
- * @param base Base path for resolving relative links (e.g., `'/docs/mdz/'`).
+ * @param base - base path for resolving relative links (e.g., `'/docs/mdz/'`).
  *   When provided, relative references (`./`, `../`) are resolved to absolute paths
  *   and passed through `resolve()`. Trailing slash recommended.
  */

package/dist/mdz_to_svelte.d.ts.map

@@ -1 +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,EAAC,KAAK,OAAO,EAAwB,MAAM,UAAU,CAAC;AAE7D;;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;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GACzB,OAAO,KAAK,CAAC,OAAO,CAAC,EACrB,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,UAAU,WAAW,CAAC,MAAM,CAAC,EAC7B,OAAO,MAAM,KACX,iBAyFF,CAAC"}
+{"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;AAGtC;;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;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GACzB,OAAO,KAAK,CAAC,OAAO,CAAC,EACrB,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,UAAU,WAAW,CAAC,MAAM,CAAC,EAC7B,OAAO,MAAM,KACX,iBAyFF,CAAC"}

package/dist/mdz_to_svelte.js

@@ -10,19 +10,19 @@
 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';
-import { resolve_relative_path } from './mdz.js';
+import { resolve_relative_path } from './mdz_helpers.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'}`).
+ * @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'])`).
+ * @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.
- * @param base Base path for resolving relative links (e.g., `'/docs/mdz/'`).
+ * @param base - base path for resolving relative links (e.g., `'/docs/mdz/'`).
  *   When provided, relative references (`./`, `../`) are resolved to absolute paths
  *   and passed through `resolve()`. Trailing slash recommended.
  */

package/dist/mdz_token_parser.js

@@ -6,7 +6,7 @@
  *
  * @module
  */
-import { extract_single_tag } from './mdz_helpers.js';
+import { extract_single_tag, mdz_heading_id } from './mdz_helpers.js';
 import { MdzLexer, } from './mdz_lexer.js';
 /**
  * Parses text to an array of `MdzNode` using a two-phase lexer+parser approach.
@@ -91,8 +91,9 @@ class MdzTokenParser {
             if (node)
                 children.push(node);
         }
-        const end = children.length > 0 ? children[children.length - 1].end : start + level + 1;
-        return { type: 'Heading', level, children, start, end };
+        const merged = this.#merge_adjacent_text(children);
+        const end = merged.length > 0 ? merged[merged.length - 1].end : start + level + 1;
+        return { type: 'Heading', level, id: mdz_heading_id(merged), children: merged, start, end };
     }
     #parse_inline() {
         if (this.#index >= this.#tokens.length)