@intlayer/core 7.6.0-canary.0 → 8.0.0-canary.0

package/dist/cjs/markdown/parser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.cjs","names":["qualifies","DURATION_DELAY_TRIGGER","normalizeWhitespace"],"sources":["../../../src/markdown/parser.ts"],"sourcesContent":["/**\n * Framework-agnostic markdown parser.\n * Converts markdown string to AST (Abstract Syntax Tree).\n *\n * This is part of the Solution F (Hybrid AST + Callback Pattern) implementation\n * for GitHub Issue #289: Adapt markdown parser in custom packages\n */\n\nimport { DURATION_DELAY_TRIGGER } from './constants';\nimport type { NestedParser, ParserResult, ParseState, Rules } from './types';\nimport { normalizeWhitespace, qualifies } from './utils';\n\n/**\n * Creates a parser for a given set of rules, with the precedence\n * specified as a list of rules.\n *\n * @param rules - An object containing rule type -> {match, order, parse} objects\n *                (lower order is higher precedence)\n *\n * @returns The resulting parse function\n */\nexport const parserFor = (\n  rules: Rules\n): ((source: string, state: ParseState) => ParserResult[]) => {\n  const start = performance.now();\n  const ruleList = Object.keys(rules);\n\n  if (process.env.NODE_ENV !== 'production') {\n    ruleList.forEach((type) => {\n      const order = rules[type]._order;\n      if (typeof order !== 'number' || !Number.isFinite(order)) {\n        console.warn(`intlayer: Invalid order for rule \\`${type}\\`: ${order}`);\n      }\n    });\n  }\n\n  // Sorts rules in order of increasing order, then\n  // ascending rule name in case of ties.\n  ruleList.sort((a, b) => {\n    return rules[a]._order - rules[b]._order || (a < b ? -1 : 1);\n  });\n\n  const nestedParse: NestedParser = (\n    source: string,\n    state: ParseState = {}\n  ): ParserResult[] => {\n    const parseStart = performance.now();\n    const result: ParserResult[] = [];\n    state.prevCapture = state.prevCapture || '';\n\n    if (source.trim()) {\n      while (source) {\n        let i = 0;\n        while (i < ruleList.length) {\n          const ruleType = ruleList[i];\n          const rule = rules[ruleType];\n\n          if (rule._qualify && !qualifies(source, state, rule._qualify)) {\n            i++;\n            continue;\n          }\n\n          const matchStart = performance.now();\n          const capture = rule._match(source, state);\n          const matchDuration = performance.now() - matchStart;\n\n          if (matchDuration > 1) {\n            console.log(\n              `${ruleType}._match: ${matchDuration.toFixed(3)}ms, source length: ${source.length}`\n            );\n          }\n\n          if (capture?.[0]) {\n            source = source.substring(capture[0].length);\n\n            const ruleParseStart = performance.now();\n            const parsedAny: any = rule._parse(capture, nestedParse, state);\n            const ruleParseDuration = performance.now() - ruleParseStart;\n\n            if (ruleParseDuration > 1) {\n              console.log(\n                `${ruleType}._parse: ${ruleParseDuration.toFixed(3)}ms, capture length: ${capture[0].length}`\n              );\n            }\n\n            state.prevCapture = (state.prevCapture || '') + capture[0];\n\n            if (!parsedAny.type) {\n              parsedAny.type = ruleType;\n            }\n            result.push(parsedAny as ParserResult);\n            break;\n          }\n          i++;\n        }\n      }\n    }\n\n    const parseDuration = performance.now() - parseStart;\n    if (parseDuration > 1) {\n      console.log(\n        `nestedParse: ${parseDuration.toFixed(3)}ms, source length: ${source.length}, result count: ${result.length}`\n      );\n    }\n\n    return result;\n  };\n\n  const duration = performance.now() - start;\n  if (duration > DURATION_DELAY_TRIGGER) {\n    console.log(\n      `parserFor: ${duration.toFixed(3)}ms, rules count: ${ruleList.length}`\n    );\n  }\n\n  return (source: string, state: ParseState) =>\n    nestedParse(normalizeWhitespace(source), state);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,aACX,UAC4D;CAC5D,MAAM,QAAQ,YAAY,KAAK;CAC/B,MAAM,WAAW,OAAO,KAAK,MAAM;AAEnC,KAAI,QAAQ,IAAI,aAAa,aAC3B,UAAS,SAAS,SAAS;EACzB,MAAM,QAAQ,MAAM,MAAM;AAC1B,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,MAAM,CACtD,SAAQ,KAAK,sCAAsC,KAAK,MAAM,QAAQ;GAExE;AAKJ,UAAS,MAAM,GAAG,MAAM;AACtB,SAAO,MAAM,GAAG,SAAS,MAAM,GAAG,WAAW,IAAI,IAAI,KAAK;GAC1D;CAEF,MAAM,eACJ,QACA,QAAoB,EAAE,KACH;EACnB,MAAM,aAAa,YAAY,KAAK;EACpC,MAAM,SAAyB,EAAE;AACjC,QAAM,cAAc,MAAM,eAAe;AAEzC,MAAI,OAAO,MAAM,CACf,QAAO,QAAQ;GACb,IAAI,IAAI;AACR,UAAO,IAAI,SAAS,QAAQ;IAC1B,MAAM,WAAW,SAAS;IAC1B,MAAM,OAAO,MAAM;AAEnB,QAAI,KAAK,YAAY,CAACA,iCAAU,QAAQ,OAAO,KAAK,SAAS,EAAE;AAC7D;AACA;;IAGF,MAAM,aAAa,YAAY,KAAK;IACpC,MAAM,UAAU,KAAK,OAAO,QAAQ,MAAM;IAC1C,MAAM,gBAAgB,YAAY,KAAK,GAAG;AAE1C,QAAI,gBAAgB,EAClB,SAAQ,IACN,GAAG,SAAS,WAAW,cAAc,QAAQ,EAAE,CAAC,qBAAqB,OAAO,SAC7E;AAGH,QAAI,UAAU,IAAI;AAChB,cAAS,OAAO,UAAU,QAAQ,GAAG,OAAO;KAE5C,MAAM,iBAAiB,YAAY,KAAK;KACxC,MAAM,YAAiB,KAAK,OAAO,SAAS,aAAa,MAAM;KAC/D,MAAM,oBAAoB,YAAY,KAAK,GAAG;AAE9C,SAAI,oBAAoB,EACtB,SAAQ,IACN,GAAG,SAAS,WAAW,kBAAkB,QAAQ,EAAE,CAAC,sBAAsB,QAAQ,GAAG,SACtF;AAGH,WAAM,eAAe,MAAM,eAAe,MAAM,QAAQ;AAExD,SAAI,CAAC,UAAU,KACb,WAAU,OAAO;AAEnB,YAAO,KAAK,UAA0B;AACtC;;AAEF;;;EAKN,MAAM,gBAAgB,YAAY,KAAK,GAAG;AAC1C,MAAI,gBAAgB,EAClB,SAAQ,IACN,gBAAgB,cAAc,QAAQ,EAAE,CAAC,qBAAqB,OAAO,OAAO,kBAAkB,OAAO,SACtG;AAGH,SAAO;;CAGT,MAAM,WAAW,YAAY,KAAK,GAAG;AACrC,KAAI,WAAWC,kDACb,SAAQ,IACN,cAAc,SAAS,QAAQ,EAAE,CAAC,mBAAmB,SAAS,SAC/D;AAGH,SAAQ,QAAgB,UACtB,YAAYC,2CAAoB,OAAO,EAAE,MAAM"}

package/dist/cjs/markdown/renderer.cjs

@@ -0,0 +1,68 @@
+const require_markdown_constants = require('./constants.cjs');
+
+//#region src/markdown/renderer.ts
+/**
+* Framework-agnostic markdown renderer.
+* Converts AST to framework-specific elements using the provided runtime.
+*
+* This is part of the Solution F (Hybrid AST + Callback Pattern) implementation
+* for GitHub Issue #289: Adapt markdown parser in custom packages
+*/
+/**
+* Creates a renderer for AST nodes.
+* Renamed from `reactFor` to be framework-agnostic.
+*
+* @param render - The render function to call for each node
+* @returns A function that renders AST to output
+*/
+const renderFor = (render) => (ast, state = {}) => {
+	const start = performance.now();
+	const patchedRender = (ast$1, state$1 = {}) => renderFor(render)(ast$1, state$1);
+	if (Array.isArray(ast)) {
+		const oldKey = state.key;
+		const result$1 = [];
+		let lastWasString = false;
+		let renderedIndex = 0;
+		for (let i = 0; i < ast.length; i++) {
+			const nodeOut = patchedRender(ast[i], {
+				...state,
+				key: renderedIndex
+			});
+			const isString = typeof nodeOut === "string";
+			if (isString && lastWasString) result$1[result$1.length - 1] = result$1[result$1.length - 1] + nodeOut;
+			else if (nodeOut !== null) {
+				result$1.push(nodeOut);
+				renderedIndex++;
+			}
+			lastWasString = isString;
+		}
+		state.key = oldKey;
+		const duration$1 = performance.now() - start;
+		if (duration$1 > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`renderFor (array): ${duration$1.toFixed(3)}ms, ast length: ${ast.length}`);
+		return result$1;
+	}
+	const result = render(ast, patchedRender, state);
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`renderFor (single): ${duration.toFixed(3)}ms, ast type: ${ast.type}`);
+	return result;
+};
+/**
+* Creates a renderer from rules with optional custom render hook.
+*
+* @param rules - The rules object containing _render functions
+* @param userRender - Optional custom render hook for full control
+* @returns A render function for AST nodes
+*/
+const createRenderer = (rules, userRender) => (ast, render, state) => {
+	const start = performance.now();
+	const renderer = rules[ast.type]?._render;
+	const result = userRender ? userRender(() => renderer?.(ast, render, state), ast, render, state) : renderer?.(ast, render, state);
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`createRenderer: ${duration.toFixed(3)}ms, ast type: ${ast.type}, hasUserRender: ${!!userRender}`);
+	return result;
+};
+
+//#endregion
+exports.createRenderer = createRenderer;
+exports.renderFor = renderFor;
+//# sourceMappingURL=renderer.cjs.map

package/dist/cjs/markdown/renderer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.cjs","names":["ast","state","result","duration","DURATION_DELAY_TRIGGER"],"sources":["../../../src/markdown/renderer.ts"],"sourcesContent":["/**\n * Framework-agnostic markdown renderer.\n * Converts AST to framework-specific elements using the provided runtime.\n *\n * This is part of the Solution F (Hybrid AST + Callback Pattern) implementation\n * for GitHub Issue #289: Adapt markdown parser in custom packages\n */\n\nimport { DURATION_DELAY_TRIGGER } from './constants';\nimport type {\n  ParserResult,\n  ParseState,\n  RenderRuleHook,\n  RuleOutput,\n  Rules,\n} from './types';\n\n/**\n * Creates a renderer for AST nodes.\n * Renamed from `reactFor` to be framework-agnostic.\n *\n * @param render - The render function to call for each node\n * @returns A function that renders AST to output\n */\nexport const renderFor =\n  (\n    render: (\n      ast: ParserResult,\n      render: RuleOutput,\n      state: ParseState\n    ) => unknown\n  ) =>\n  (ast: ParserResult | ParserResult[], state: ParseState = {}): any => {\n    const start = performance.now();\n\n    const patchedRender = (\n      ast: ParserResult | ParserResult[],\n      state: ParseState = {}\n    ): any => renderFor(render)(ast, state);\n\n    if (Array.isArray(ast)) {\n      const oldKey = state.key;\n      const result: any[] = [];\n\n      // map nestedOutput over the ast, except group any text\n      // nodes together into a single string output.\n      let lastWasString = false;\n      let renderedIndex = 0;\n\n      for (let i = 0; i < ast.length; i++) {\n        // We clone the state to avoid side effects on other nodes in the same level\n        // while ensuring each non-null rendered node gets a unique, sequential key.\n        const nodeOut = patchedRender(ast[i], { ...state, key: renderedIndex });\n        const isString = typeof nodeOut === 'string';\n\n        if (isString && lastWasString) {\n          result[result.length - 1] =\n            (result[result.length - 1] as string) + nodeOut;\n        } else if (nodeOut !== null) {\n          result.push(nodeOut);\n          renderedIndex++;\n        }\n\n        lastWasString = isString;\n      }\n\n      state.key = oldKey;\n\n      const duration = performance.now() - start;\n      if (duration > DURATION_DELAY_TRIGGER) {\n        console.log(\n          `renderFor (array): ${duration.toFixed(3)}ms, ast length: ${ast.length}`\n        );\n      }\n\n      return result;\n    }\n\n    const result = render(ast, patchedRender as RuleOutput, state);\n\n    const duration = performance.now() - start;\n    if (duration > DURATION_DELAY_TRIGGER) {\n      console.log(\n        `renderFor (single): ${duration.toFixed(3)}ms, ast type: ${(ast as ParserResult).type}`\n      );\n    }\n\n    return result;\n  };\n\n/**\n * Creates a renderer from rules with optional custom render hook.\n *\n * @param rules - The rules object containing _render functions\n * @param userRender - Optional custom render hook for full control\n * @returns A render function for AST nodes\n */\nexport const createRenderer =\n  (rules: Rules, userRender?: RenderRuleHook) =>\n  (ast: ParserResult, render: RuleOutput, state: ParseState): unknown => {\n    const start = performance.now();\n    const renderer = rules[ast.type]?._render;\n\n    const result = userRender\n      ? userRender(() => renderer?.(ast, render, state), ast, render, state)\n      : renderer?.(ast, render, state);\n\n    const duration = performance.now() - start;\n    if (duration > DURATION_DELAY_TRIGGER) {\n      console.log(\n        `createRenderer: ${duration.toFixed(3)}ms, ast type: ${ast.type}, hasUserRender: ${!!userRender}`\n      );\n    }\n\n    return result;\n  };\n"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,MAAa,aAET,YAMD,KAAoC,QAAoB,EAAE,KAAU;CACnE,MAAM,QAAQ,YAAY,KAAK;CAE/B,MAAM,iBACJ,OACA,UAAoB,EAAE,KACd,UAAU,OAAO,CAACA,OAAKC,QAAM;AAEvC,KAAI,MAAM,QAAQ,IAAI,EAAE;EACtB,MAAM,SAAS,MAAM;EACrB,MAAMC,WAAgB,EAAE;EAIxB,IAAI,gBAAgB;EACpB,IAAI,gBAAgB;AAEpB,OAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;GAGnC,MAAM,UAAU,cAAc,IAAI,IAAI;IAAE,GAAG;IAAO,KAAK;IAAe,CAAC;GACvE,MAAM,WAAW,OAAO,YAAY;AAEpC,OAAI,YAAY,cACd,UAAOA,SAAO,SAAS,KACpBA,SAAOA,SAAO,SAAS,KAAgB;YACjC,YAAY,MAAM;AAC3B,aAAO,KAAK,QAAQ;AACpB;;AAGF,mBAAgB;;AAGlB,QAAM,MAAM;EAEZ,MAAMC,aAAW,YAAY,KAAK,GAAG;AACrC,MAAIA,aAAWC,kDACb,SAAQ,IACN,sBAAsBD,WAAS,QAAQ,EAAE,CAAC,kBAAkB,IAAI,SACjE;AAGH,SAAOD;;CAGT,MAAM,SAAS,OAAO,KAAK,eAA6B,MAAM;CAE9D,MAAM,WAAW,YAAY,KAAK,GAAG;AACrC,KAAI,WAAWE,kDACb,SAAQ,IACN,uBAAuB,SAAS,QAAQ,EAAE,CAAC,gBAAiB,IAAqB,OAClF;AAGH,QAAO;;;;;;;;;AAUX,MAAa,kBACV,OAAc,gBACd,KAAmB,QAAoB,UAA+B;CACrE,MAAM,QAAQ,YAAY,KAAK;CAC/B,MAAM,WAAW,MAAM,IAAI,OAAO;CAElC,MAAM,SAAS,aACX,iBAAiB,WAAW,KAAK,QAAQ,MAAM,EAAE,KAAK,QAAQ,MAAM,GACpE,WAAW,KAAK,QAAQ,MAAM;CAElC,MAAM,WAAW,YAAY,KAAK,GAAG;AACrC,KAAI,WAAWA,kDACb,SAAQ,IACN,mBAAmB,SAAS,QAAQ,EAAE,CAAC,gBAAgB,IAAI,KAAK,mBAAmB,CAAC,CAAC,aACtF;AAGH,QAAO"}

package/dist/cjs/markdown/utils.cjs

@@ -0,0 +1,397 @@
+const require_markdown_constants = require('./constants.cjs');
+
+//#region src/markdown/utils.ts
+/**
+* Utility functions for the framework-agnostic markdown processor.
+*
+* This is part of the Solution F (Hybrid AST + Callback Pattern) implementation
+* for GitHub Issue #289: Adapt markdown parser in custom packages
+*/
+/**
+* Trim trailing whitespace from a string.
+*/
+const trimEnd = (str) => {
+	let end = str.length;
+	while (end > 0 && str[end - 1] <= " ") end--;
+	return str.slice(0, end);
+};
+/**
+* Check if string starts with prefix.
+*/
+const startsWith = (str, prefix) => {
+	return str.startsWith(prefix);
+};
+/**
+* Remove symmetrical leading and trailing quotes.
+*/
+const unquote = (str) => {
+	const first = str[0];
+	if ((first === "\"" || first === "'") && str.length >= 2 && str[str.length - 1] === first) return str.slice(1, -1);
+	return str;
+};
+/**
+* Unescape backslash-escaped characters.
+*/
+const unescapeString = (rawString) => rawString ? rawString.replace(require_markdown_constants.UNESCAPE_R, "$1") : rawString;
+/**
+* Join class names, filtering out falsy values.
+*/
+const cx = (...args) => args.filter(Boolean).join(" ");
+/**
+* Get a nested property from an object using dot notation.
+*/
+const get = (src, path, fb) => {
+	let ptr = src;
+	const frags = path.split(".");
+	while (frags.length) {
+		ptr = ptr[frags[0]];
+		if (ptr === void 0) break;
+		else frags.shift();
+	}
+	return ptr ?? fb;
+};
+/**
+* Convert a string to a URL-safe slug.
+* Based on https://stackoverflow.com/a/18123682/1141611
+*/
+const slugify = (str) => str.replace(/[ÀÁÂÃÄÅàáâãäåæÆ]/g, "a").replace(/[çÇ]/g, "c").replace(/[ðÐ]/g, "d").replace(/[ÈÉÊËéèêë]/g, "e").replace(/[ÏïÎîÍíÌì]/g, "i").replace(/[Ññ]/g, "n").replace(/[øØœŒÕõÔôÓóÒò]/g, "o").replace(/[ÜüÛûÚúÙù]/g, "u").replace(/[ŸÿÝý]/g, "y").replace(/[^a-z0-9- ]/gi, "").replace(/ /gi, "-").toLowerCase();
+const SANITIZE_R = /(javascript|vbscript|data(?!:image)):/i;
+/**
+* Sanitize URLs to prevent XSS attacks.
+* Returns null if the URL is unsafe.
+*/
+const sanitizer = (input) => {
+	try {
+		const decoded = decodeURIComponent(input).replace(/[^A-Za-z0-9/:]/g, "");
+		if (SANITIZE_R.test(decoded)) {
+			if (process.env.NODE_ENV !== "production") console.warn("Input contains an unsafe JavaScript/VBScript/data expression, it will not be rendered.", decoded);
+			return null;
+		}
+	} catch (_e) {
+		if (process.env.NODE_ENV !== "production") console.warn("Input could not be decoded due to malformed syntax or characters, it will not be rendered.", input);
+		return null;
+	}
+	return input;
+};
+/**
+* Normalize whitespace in source string.
+*/
+const normalizeWhitespace = (source) => {
+	const start = performance.now();
+	const result = source.replace(require_markdown_constants.CR_NEWLINE_R, "\n").replace(require_markdown_constants.FORMFEED_R, "").replace(require_markdown_constants.TAB_R, "    ");
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`normalizeWhitespace: ${duration.toFixed(3)}ms, source length: ${source.length}`);
+	return result;
+};
+/**
+* Safely remove a uniform leading indentation from lines, but do NOT touch
+* the content inside fenced code blocks (``` or ~~~).
+*/
+const trimLeadingWhitespaceOutsideFences = (text, whitespace) => {
+	const start = performance.now();
+	if (!whitespace) return text;
+	const lines = text.split("\n");
+	let inFence = false;
+	let fenceToken = null;
+	const isFenceLine = (line) => line.match(/^\s*(`{3,}|~{3,})/);
+	const maybeToggleFence = (line) => {
+		const m = isFenceLine(line);
+		if (!m) return;
+		const token = m[1];
+		if (!inFence) {
+			inFence = true;
+			fenceToken = token;
+		} else if (fenceToken && line.includes(fenceToken)) {
+			inFence = false;
+			fenceToken = null;
+		}
+	};
+	const result = lines.map((line) => {
+		if (isFenceLine(line)) {
+			const trimmedFenceLine = line.startsWith(whitespace) ? line.slice(whitespace.length) : line;
+			maybeToggleFence(line);
+			return trimmedFenceLine;
+		}
+		if (inFence) return line;
+		return line.startsWith(whitespace) ? line.slice(whitespace.length) : line;
+	}).join("\n");
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`trimLeadingWhitespaceOutsideFences: ${duration.toFixed(3)}ms, text length: ${text.length}, lines count: ${lines.length}`);
+	return result;
+};
+/**
+* Normalize HTML attribute key to JSX prop name.
+*/
+const normalizeAttributeKey = (key) => {
+	if (key.indexOf("-") !== -1 && key.match(require_markdown_constants.HTML_CUSTOM_ATTR_R) === null) key = key.replace(require_markdown_constants.CAPTURE_LETTER_AFTER_HYPHEN, (_, letter) => {
+		return letter.toUpperCase();
+	});
+	return key;
+};
+/**
+* Parse a CSS style string into an array of [key, value] tuples.
+*/
+const parseStyleAttribute = (styleString) => {
+	const start = performance.now();
+	const styles = [];
+	let buffer = "";
+	let inUrl = false;
+	let inQuotes = false;
+	let quoteChar = "";
+	if (!styleString) return styles;
+	for (let i = 0; i < styleString.length; i++) {
+		const char = styleString[i];
+		if ((char === "\"" || char === "'") && !inUrl) {
+			if (!inQuotes) {
+				inQuotes = true;
+				quoteChar = char;
+			} else if (char === quoteChar) {
+				inQuotes = false;
+				quoteChar = "";
+			}
+		}
+		if (char === "(" && buffer.endsWith("url")) inUrl = true;
+		else if (char === ")" && inUrl) inUrl = false;
+		if (char === ";" && !inQuotes && !inUrl) {
+			const declaration$1 = buffer.trim();
+			if (declaration$1) {
+				const colonIndex = declaration$1.indexOf(":");
+				if (colonIndex > 0) {
+					const key = declaration$1.slice(0, colonIndex).trim();
+					const value = declaration$1.slice(colonIndex + 1).trim();
+					styles.push([key, value]);
+				}
+			}
+			buffer = "";
+		} else buffer += char;
+	}
+	const declaration = buffer.trim();
+	if (declaration) {
+		const colonIndex = declaration.indexOf(":");
+		if (colonIndex > 0) {
+			const key = declaration.slice(0, colonIndex).trim();
+			const value = declaration.slice(colonIndex + 1).trim();
+			styles.push([key, value]);
+		}
+	}
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`parseStyleAttribute: ${duration.toFixed(3)}ms, styleString length: ${styleString.length}, styles count: ${styles.length}`);
+	return styles;
+};
+/**
+* Convert an attribute value to a Node prop value.
+*/
+const attributeValueToNodePropValue = (tag, key, value, sanitizeUrlFn) => {
+	if (key === "style") return parseStyleAttribute(value).reduce((styles, [styleKey, styleValue]) => {
+		const camelCasedKey = styleKey.replace(/(-[a-z])/g, (substr) => substr[1].toUpperCase());
+		styles[camelCasedKey] = sanitizeUrlFn(styleValue, tag, styleKey);
+		return styles;
+	}, {});
+	else if (require_markdown_constants.ATTRIBUTES_TO_SANITIZE.indexOf(key) !== -1) return sanitizeUrlFn(unescapeString(value), tag, key);
+	else if (value.match(require_markdown_constants.INTERPOLATION_R)) value = unescapeString(value.slice(1, value.length - 1));
+	if (value === "true") return true;
+	else if (value === "false") return false;
+	return value;
+};
+/**
+* Parse table alignment from a separator row.
+*/
+const parseTableAlignCapture = (alignCapture) => {
+	if (require_markdown_constants.TABLE_RIGHT_ALIGN.test(alignCapture)) return "right";
+	else if (require_markdown_constants.TABLE_CENTER_ALIGN.test(alignCapture)) return "center";
+	else if (require_markdown_constants.TABLE_LEFT_ALIGN.test(alignCapture)) return "left";
+	return "left";
+};
+/**
+* Parse table alignment row.
+*/
+const parseTableAlign = (source) => {
+	return source.replace(require_markdown_constants.TABLE_TRIM_PIPES, "").split("|").map(parseTableAlignCapture);
+};
+/**
+* Parse a single table row.
+*/
+const parseTableRow = (source, parse, state, tableOutput) => {
+	const start = performance.now();
+	const prevInTable = state.inTable;
+	state.inTable = true;
+	const cells = [[]];
+	let acc = "";
+	const flush = () => {
+		if (!acc) return;
+		const cell = cells[cells.length - 1];
+		cell.push.apply(cell, parse(acc, state));
+		acc = "";
+	};
+	source.trim().split(/(`[^`]*`|\\\||\|)/).filter(Boolean).forEach((fragment, i, arr) => {
+		if (fragment.trim() === "|") {
+			flush();
+			if (tableOutput) {
+				if (i !== 0 && i !== arr.length - 1) cells.push([]);
+				return;
+			}
+		}
+		acc += fragment;
+	});
+	flush();
+	state.inTable = prevInTable;
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`parseTableRow: ${duration.toFixed(3)}ms, source length: ${source.length}, cells count: ${cells.length}`);
+	return cells;
+};
+/**
+* Parse table cells (multiple rows).
+*/
+const parseTableCells = (source, parse, state) => {
+	const start = performance.now();
+	const rowsText = source.trim().split("\n");
+	const result = rowsText.map((rowText) => parseTableRow(rowText, parse, state, true));
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`parseTableCells: ${duration.toFixed(3)}ms, source length: ${source.length}, rows count: ${rowsText.length}`);
+	return result;
+};
+/**
+* Check if a rule qualifies for the current source and state.
+*/
+const qualifies = (source, state, qualify) => {
+	if (Array.isArray(qualify)) {
+		for (let i = 0; i < qualify.length; i++) if (startsWith(source, qualify[i])) return true;
+		return false;
+	}
+	return qualify(source, state);
+};
+/**
+* Marks a matcher function as eligible for being run inside an inline context.
+*/
+const allowInline = (fn) => {
+	fn.inline = 1;
+	return fn;
+};
+/**
+* Creates a match function for an inline scoped element from a regex.
+*/
+const inlineRegex = (regex) => allowInline((source, state) => {
+	if (state.inline) return regex.exec(source);
+	else return null;
+});
+/**
+* Creates a match function for inline elements except links.
+*/
+const simpleInlineRegex = (regex) => allowInline((source, state) => {
+	if (state.inline || state.simple) return regex.exec(source);
+	else return null;
+});
+/**
+* Creates a match function for a block scoped element from a regex.
+*/
+const blockRegex = (regex) => (source, state) => {
+	if (state.inline || state.simple) return null;
+	else return regex.exec(source);
+};
+/**
+* Creates a match function from a regex, ignoring block/inline scope.
+*/
+const anyScopeRegex = (fn) => allowInline((source, state) => {
+	if (typeof fn === "function") return fn(source, state);
+	return fn.exec(source);
+});
+/**
+* Parse inline content (including links).
+*/
+const parseInline = (parse, children, state) => {
+	const start = performance.now();
+	const isCurrentlyInline = state.inline ?? false;
+	const isCurrentlySimple = state.simple ?? false;
+	state.inline = true;
+	state.simple = true;
+	const result = parse(children, state);
+	state.inline = isCurrentlyInline;
+	state.simple = isCurrentlySimple;
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`parseInline: ${duration.toFixed(3)}ms, children length: ${children.length}, result count: ${result.length}`);
+	return result;
+};
+/**
+* Parse simple inline content (no links).
+*/
+const parseSimpleInline = (parse, children, state) => {
+	const start = performance.now();
+	const isCurrentlyInline = state.inline ?? false;
+	const isCurrentlySimple = state.simple ?? false;
+	state.inline = false;
+	state.simple = true;
+	const result = parse(children, state);
+	state.inline = isCurrentlyInline;
+	state.simple = isCurrentlySimple;
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`parseSimpleInline: ${duration.toFixed(3)}ms, children length: ${children.length}, result count: ${result.length}`);
+	return result;
+};
+/**
+* Parse block content.
+*/
+const parseBlock = (parse, children, state = {}) => {
+	const start = performance.now();
+	const isCurrentlyInline = state.inline || false;
+	state.inline = false;
+	const normalizedChildren = trimEnd(children);
+	const result = parse(/\n\n$/.test(normalizedChildren) === false ? normalizedChildren.endsWith("\n") ? `${normalizedChildren}\n` : `${normalizedChildren}\n\n` : normalizedChildren, state);
+	state.inline = isCurrentlyInline;
+	const duration = performance.now() - start;
+	if (duration > require_markdown_constants.DURATION_DELAY_TRIGGER) console.log(`parseBlock: ${duration.toFixed(3)}ms, children length: ${children.length}, result count: ${result.length}`);
+	return result;
+};
+/**
+* Helper to parse capture group 2 as inline content.
+*/
+const parseCaptureInline = (capture, parse, state) => {
+	return { children: parseInline(parse, capture[2], state) };
+};
+/**
+* Helper that captures nothing (empty object).
+*/
+const captureNothing = () => ({});
+/**
+* Helper that renders nothing (null).
+*/
+const renderNothing = () => null;
+/**
+* Check if any regex in a list matches the input.
+*/
+const some = (regexes, input) => {
+	for (let i = 0; i < regexes.length; i++) if (regexes[i].test(input)) return true;
+	return false;
+};
+
+//#endregion
+exports.allowInline = allowInline;
+exports.anyScopeRegex = anyScopeRegex;
+exports.attributeValueToNodePropValue = attributeValueToNodePropValue;
+exports.blockRegex = blockRegex;
+exports.captureNothing = captureNothing;
+exports.cx = cx;
+exports.get = get;
+exports.inlineRegex = inlineRegex;
+exports.normalizeAttributeKey = normalizeAttributeKey;
+exports.normalizeWhitespace = normalizeWhitespace;
+exports.parseBlock = parseBlock;
+exports.parseCaptureInline = parseCaptureInline;
+exports.parseInline = parseInline;
+exports.parseSimpleInline = parseSimpleInline;
+exports.parseStyleAttribute = parseStyleAttribute;
+exports.parseTableAlign = parseTableAlign;
+exports.parseTableAlignCapture = parseTableAlignCapture;
+exports.parseTableCells = parseTableCells;
+exports.parseTableRow = parseTableRow;
+exports.qualifies = qualifies;
+exports.renderNothing = renderNothing;
+exports.sanitizer = sanitizer;
+exports.simpleInlineRegex = simpleInlineRegex;
+exports.slugify = slugify;
+exports.some = some;
+exports.startsWith = startsWith;
+exports.trimEnd = trimEnd;
+exports.trimLeadingWhitespaceOutsideFences = trimLeadingWhitespaceOutsideFences;
+exports.unescapeString = unescapeString;
+exports.unquote = unquote;
+//# sourceMappingURL=utils.cjs.map

package/dist/cjs/markdown/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":["UNESCAPE_R","CR_NEWLINE_R","FORMFEED_R","TAB_R","DURATION_DELAY_TRIGGER","HTML_CUSTOM_ATTR_R","CAPTURE_LETTER_AFTER_HYPHEN","declaration","ATTRIBUTES_TO_SANITIZE","INTERPOLATION_R","TABLE_RIGHT_ALIGN","TABLE_CENTER_ALIGN","TABLE_LEFT_ALIGN","TABLE_TRIM_PIPES"],"sources":["../../../src/markdown/utils.ts"],"sourcesContent":["/**\n * Utility functions for the framework-agnostic markdown processor.\n *\n * This is part of the Solution F (Hybrid AST + Callback Pattern) implementation\n * for GitHub Issue #289: Adapt markdown parser in custom packages\n */\n\nimport {\n  ATTRIBUTES_TO_SANITIZE,\n  CAPTURE_LETTER_AFTER_HYPHEN,\n  CR_NEWLINE_R,\n  DURATION_DELAY_TRIGGER,\n  FORMFEED_R,\n  HTML_CUSTOM_ATTR_R,\n  INTERPOLATION_R,\n  TAB_R,\n  TABLE_CENTER_ALIGN,\n  TABLE_LEFT_ALIGN,\n  TABLE_RIGHT_ALIGN,\n  TABLE_TRIM_PIPES,\n  UNESCAPE_R,\n} from './constants';\nimport type { NestedParser, ParserResult, ParseState, Rule } from './types';\n\n// ============================================================================\n// STRING UTILITIES\n// ============================================================================\n\n/**\n * Trim trailing whitespace from a string.\n */\nexport const trimEnd = (str: string): string => {\n  let end = str.length;\n \n  while (end > 0 && str[end - 1] <= ' ') end--;\n  \n  return str.slice(0, end);\n};\n\n/**\n * Check if string starts with prefix.\n */\nexport const startsWith = (str: string, prefix: string): boolean => {\n  return str.startsWith(prefix);\n};\n\n/**\n * Remove symmetrical leading and trailing quotes.\n */\nexport const unquote = (str: string): string => {\n  const first = str[0];\n\n  if (\n    (first === '\"' || first === \"'\") &&\n    str.length >= 2 &&\n    str[str.length - 1] === first\n  ) {\n    return str.slice(1, -1);\n  }\n\n  return str;\n};\n\n/**\n * Unescape backslash-escaped characters.\n */\nexport const unescapeString = (rawString: string): string =>\n  rawString ? rawString.replace(UNESCAPE_R, '$1') : rawString;\n\n/**\n * Join class names, filtering out falsy values.\n */\nexport const cx = (...args: any[]): string => args.filter(Boolean).join(' ');\n\n/**\n * Get a nested property from an object using dot notation.\n */\nexport const get = (src: any, path: string, fb?: any): any => {\n  let ptr = src;\n  const frags = path.split('.');\n\n  while (frags.length) {\n    ptr = ptr[frags[0]];\n\n    if (ptr === undefined) break;\n    else frags.shift();\n  }\n\n  return ptr ?? fb;\n};\n\n// ============================================================================\n// SLUGIFY\n// ============================================================================\n\n/**\n * Convert a string to a URL-safe slug.\n * Based on https://stackoverflow.com/a/18123682/1141611\n */\nexport const slugify = (str: string): string =>\n  str\n    .replace(/[ÀÁÂÃÄÅàáâãäåæÆ]/g, 'a')\n    .replace(/[çÇ]/g, 'c')\n    .replace(/[ðÐ]/g, 'd')\n    .replace(/[ÈÉÊËéèêë]/g, 'e')\n    .replace(/[ÏïÎîÍíÌì]/g, 'i')\n    .replace(/[Ññ]/g, 'n')\n    .replace(/[øØœŒÕõÔôÓóÒò]/g, 'o')\n    .replace(/[ÜüÛûÚúÙù]/g, 'u')\n    .replace(/[ŸÿÝý]/g, 'y')\n    .replace(/[^a-z0-9- ]/gi, '')\n    .replace(/ /gi, '-')\n    .toLowerCase();\n\n// ============================================================================\n// SANITIZER\n// ============================================================================\n\nconst SANITIZE_R = /(javascript|vbscript|data(?!:image)):/i;\n\n/**\n * Sanitize URLs to prevent XSS attacks.\n * Returns null if the URL is unsafe.\n */\nexport const sanitizer = (input: string): string | null => {\n  try {\n    const decoded = decodeURIComponent(input).replace(/[^A-Za-z0-9/:]/g, '');\n\n    if (SANITIZE_R.test(decoded)) {\n      if (process.env.NODE_ENV !== 'production') {\n        console.warn(\n          'Input contains an unsafe JavaScript/VBScript/data expression, it will not be rendered.',\n          decoded\n        );\n      }\n\n      return null;\n    }\n  } catch (_e) {\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        'Input could not be decoded due to malformed syntax or characters, it will not be rendered.',\n        input\n      );\n    }\n\n    // decodeURIComponent sometimes throws a URIError\n    return null;\n  }\n\n  return input;\n};\n\n// ============================================================================\n// WHITESPACE NORMALIZATION\n// ============================================================================\n\n/**\n * Normalize whitespace in source string.\n */\nexport const normalizeWhitespace = (source: string): string => {\n  const start = performance.now();\n  const result = source\n    .replace(CR_NEWLINE_R, '\\n')\n    .replace(FORMFEED_R, '')\n    .replace(TAB_R, '    ');\n\n  const duration = performance.now() - start;\n\n  if (duration > DURATION_DELAY_TRIGGER) {\n    console.log(\n      `normalizeWhitespace: ${duration.toFixed(3)}ms, source length: ${source.length}`\n    );\n  }\n\n  return result;\n};\n\n/**\n * Safely remove a uniform leading indentation from lines, but do NOT touch\n * the content inside fenced code blocks (``` or ~~~).\n */\nexport const trimLeadingWhitespaceOutsideFences = (\n  text: string,\n  whitespace: string\n): string => {\n  const start = performance.now();\n  if (!whitespace) return text;\n\n  const lines = text.split('\\n');\n  let inFence = false;\n  let fenceToken: string | null = null;\n\n  const isFenceLine = (line: string): RegExpMatchArray | null =>\n    line.match(/^\\s*(`{3,}|~{3,})/);\n\n  const maybeToggleFence = (line: string): void => {\n    const m = isFenceLine(line);\n\n    if (!m) return;\n\n    const token = m[1];\n\n    if (!inFence) {\n      inFence = true;\n      fenceToken = token;\n    } else if (fenceToken && line.includes(fenceToken)) {\n      inFence = false;\n      fenceToken = null;\n    }\n  };\n\n  const out = lines.map((line) => {\n    const fenceMatch = isFenceLine(line);\n    if (fenceMatch) {\n      const trimmedFenceLine = line.startsWith(whitespace)\n        ? line.slice(whitespace.length)\n        : line;\n      maybeToggleFence(line);\n      return trimmedFenceLine;\n    }\n\n    if (inFence) {\n      return line;\n    }\n\n    return line.startsWith(whitespace) ? line.slice(whitespace.length) : line;\n  });\n\n  const result = out.join('\\n');\n\n  const duration = performance.now() - start;\n  if (duration > DURATION_DELAY_TRIGGER) {\n    console.log(\n      `trimLeadingWhitespaceOutsideFences: ${duration.toFixed(3)}ms, text length: ${text.length}, lines count: ${lines.length}`\n    );\n  }\n\n  return result;\n};\n\n/**\n * Normalize HTML attribute key to JSX prop name.\n */\nexport const normalizeAttributeKey = (key: string): string => {\n  const hyphenIndex = key.indexOf('-');\n\n  if (hyphenIndex !== -1 && key.match(HTML_CUSTOM_ATTR_R) === null) {\n    key = key.replace(CAPTURE_LETTER_AFTER_HYPHEN, (_, letter) => {\n      return letter.toUpperCase();\n    });\n  }\n\n  return key;\n};\n\ntype StyleTuple = [key: string, value: string];\n\n/**\n * Parse a CSS style string into an array of [key, value] tuples.\n */\nexport const parseStyleAttribute = (styleString: string): StyleTuple[] => {\n  const start = performance.now();\n  const styles: StyleTuple[] = [];\n  let buffer = '';\n  let inUrl = false;\n  let inQuotes = false;\n  let quoteChar: '\"' | \"'\" | '' = '';\n\n  if (!styleString) return styles;\n\n  for (let i = 0; i < styleString.length; i++) {\n    const char = styleString[i];\n\n    if ((char === '\"' || char === \"'\") && !inUrl) {\n      if (!inQuotes) {\n        inQuotes = true;\n        quoteChar = char;\n      } else if (char === quoteChar) {\n        inQuotes = false;\n        quoteChar = '';\n      }\n    }\n\n    if (char === '(' && buffer.endsWith('url')) {\n      inUrl = true;\n    } else if (char === ')' && inUrl) {\n      inUrl = false;\n    }\n\n    if (char === ';' && !inQuotes && !inUrl) {\n      const declaration = buffer.trim();\n\n      if (declaration) {\n        const colonIndex = declaration.indexOf(':');\n\n        if (colonIndex > 0) {\n          const key = declaration.slice(0, colonIndex).trim();\n          const value = declaration.slice(colonIndex + 1).trim();\n          styles.push([key, value]);\n        }\n      }\n      buffer = '';\n    } else {\n      buffer += char;\n    }\n  }\n\n  const declaration = buffer.trim();\n\n  if (declaration) {\n    const colonIndex = declaration.indexOf(':');\n    if (colonIndex > 0) {\n      const key = declaration.slice(0, colonIndex).trim();\n      const value = declaration.slice(colonIndex + 1).trim();\n      styles.push([key, value]);\n    }\n  }\n\n  const duration = performance.now() - start;\n\n  if (duration > DURATION_DELAY_TRIGGER) {\n    console.log(\n      `parseStyleAttribute: ${duration.toFixed(3)}ms, styleString length: ${styleString.length}, styles count: ${styles.length}`\n    );\n  }\n\n  return styles;\n};\n\n/**\n * Convert an attribute value to a Node prop value.\n */\nexport const attributeValueToNodePropValue = (\n  tag: string,\n  key: string,\n  value: string,\n  sanitizeUrlFn: (\n    value: string,\n    tag: string,\n    attribute: string\n  ) => string | null\n): any => {\n  if (key === 'style') {\n    return parseStyleAttribute(value).reduce(\n      (styles, [styleKey, styleValue]) => {\n        const camelCasedKey = styleKey.replace(/(-[a-z])/g, (substr) =>\n          substr[1].toUpperCase()\n        );\n\n        (styles as Record<string, any>)[camelCasedKey] = sanitizeUrlFn(\n          styleValue,\n          tag,\n          styleKey\n        );\n\n        return styles;\n      },\n      {} as Record<string, any>\n    );\n  } else if (ATTRIBUTES_TO_SANITIZE.indexOf(key) !== -1) {\n    return sanitizeUrlFn(unescapeString(value), tag, key);\n  } else if (value.match(INTERPOLATION_R)) {\n    value = unescapeString(value.slice(1, value.length - 1));\n  }\n\n  if (value === 'true') {\n    return true;\n  } else if (value === 'false') {\n    return false;\n  }\n\n  return value;\n};\n\n// ============================================================================\n// TABLE PARSING\n// ============================================================================\n\n/**\n * Parse table alignment from a separator row.\n */\nexport const parseTableAlignCapture = (\n  alignCapture: string\n): 'left' | 'right' | 'center' => {\n  if (TABLE_RIGHT_ALIGN.test(alignCapture)) {\n    return 'right';\n  } else if (TABLE_CENTER_ALIGN.test(alignCapture)) {\n    return 'center';\n  } else if (TABLE_LEFT_ALIGN.test(alignCapture)) {\n    return 'left';\n  }\n\n  return 'left';\n};\n\n/**\n * Parse table alignment row.\n */\nexport const parseTableAlign = (\n  source: string\n): ('left' | 'right' | 'center')[] => {\n  const alignText = source.replace(TABLE_TRIM_PIPES, '').split('|');\n  return alignText.map(parseTableAlignCapture);\n};\n\n/**\n * Parse a single table row.\n */\nexport const parseTableRow = (\n  source: string,\n  parse: NestedParser,\n  state: ParseState,\n  tableOutput: boolean\n): ParserResult[][] => {\n  const start = performance.now();\n  const prevInTable = state.inTable;\n\n  state.inTable = true;\n\n  const cells: ParserResult[][] = [[]];\n  let acc = '';\n\n  const flush = (): void => {\n    if (!acc) return;\n\n    const cell = cells[cells.length - 1];\n    cell.push.apply(cell, parse(acc, state));\n    acc = '';\n  };\n\n  source\n    .trim()\n    .split(/(`[^`]*`|\\\\\\||\\|)/)\n    .filter(Boolean)\n    .forEach((fragment, i, arr) => {\n      if (fragment.trim() === '|') {\n        flush();\n\n        if (tableOutput) {\n          if (i !== 0 && i !== arr.length - 1) {\n            cells.push([]);\n          }\n\n          return;\n        }\n      }\n\n      acc += fragment;\n    });\n\n  flush();\n\n  state.inTable = prevInTable;\n\n  const duration = performance.now() - start;\n  if (duration > DURATION_DELAY_TRIGGER) {\n    console.log(\n      `parseTableRow: ${duration.toFixed(3)}ms, source length: ${source.length}, cells count: ${cells.length}`\n    );\n  }\n\n  return cells;\n};\n\n/**\n * Parse table cells (multiple rows).\n */\nexport const parseTableCells = (\n  source: string,\n  parse: NestedParser,\n  state: ParseState\n): ParserResult[][][] => {\n  const start = performance.now();\n  const rowsText = source.trim().split('\\n');\n\n  const result = rowsText.map((rowText) =>\n    parseTableRow(rowText, parse, state, true)\n  );\n\n  const duration = performance.now() - start;\n  if (duration > DURATION_DELAY_TRIGGER) {\n    console.log(\n      `parseTableCells: ${duration.toFixed(3)}ms, source length: ${source.length}, rows count: ${rowsText.length}`\n    );\n  }\n\n  return result;\n};\n\n// ============================================================================\n// PARSING HELPERS\n// ============================================================================\n\n/**\n * Check if a rule qualifies for the current source and state.\n */\nexport const qualifies = (\n  source: string,\n  state: ParseState,\n  qualify: NonNullable<Rule<any>['_qualify']>\n): boolean => {\n  if (Array.isArray(qualify)) {\n    for (let i = 0; i < qualify.length; i++) {\n      if (startsWith(source, qualify[i])) return true;\n    }\n\n    return false;\n  }\n\n  return (qualify as (source: string, state: ParseState) => boolean)(\n    source,\n    state\n  );\n};\n\n/**\n * Marks a matcher function as eligible for being run inside an inline context.\n */\nexport const allowInline = <T extends (...args: any[]) => any>(\n  fn: T\n): T & { inline: 1 } => {\n  (fn as any).inline = 1;\n  return fn as T & { inline: 1 };\n};\n\n/**\n * Creates a match function for an inline scoped element from a regex.\n */\nexport const inlineRegex = (regex: RegExp) =>\n  allowInline((source: string, state: ParseState): RegExpMatchArray | null => {\n    if (state.inline) {\n      return regex.exec(source);\n    } else {\n      return null;\n    }\n  });\n\n/**\n * Creates a match function for inline elements except links.\n */\nexport const simpleInlineRegex = (regex: RegExp) =>\n  allowInline((source: string, state: ParseState): RegExpMatchArray | null => {\n    if (state.inline || state.simple) {\n      return regex.exec(source);\n    } else {\n      return null;\n    }\n  });\n\n/**\n * Creates a match function for a block scoped element from a regex.\n */\nexport const blockRegex =\n  (regex: RegExp) =>\n  (source: string, state: ParseState): RegExpMatchArray | null => {\n    if (state.inline || state.simple) {\n      return null;\n    } else {\n      return regex.exec(source);\n    }\n  };\n\n/**\n * Creates a match function from a regex, ignoring block/inline scope.\n */\nexport const anyScopeRegex = (\n  fn: RegExp | ((source: string, state: ParseState) => RegExpMatchArray | null)\n) =>\n  allowInline((source: string, state: ParseState): RegExpMatchArray | null => {\n    if (typeof fn === 'function') {\n      return fn(source, state);\n    }\n    return fn.exec(source);\n  });\n\n/**\n * Parse inline content (including links).\n */\nexport const parseInline = (\n  parse: NestedParser,\n  children: string,\n  state: ParseState\n): ParserResult[] => {\n  const start = performance.now();\n  const isCurrentlyInline = state.inline ?? false;\n  const isCurrentlySimple = state.simple ?? false;\n  state.inline = true;\n  state.simple = true;\n  const result = parse(children, state);\n  state.inline = isCurrentlyInline;\n  state.simple = isCurrentlySimple;\n\n  const duration = performance.now() - start;\n  if (duration > DURATION_DELAY_TRIGGER) {\n    console.log(\n      `parseInline: ${duration.toFixed(3)}ms, children length: ${children.length}, result count: ${result.length}`\n    );\n  }\n\n  return result;\n};\n\n/**\n * Parse simple inline content (no links).\n */\nexport const parseSimpleInline = (\n  parse: NestedParser,\n  children: string,\n  state: ParseState\n): ParserResult[] => {\n  const start = performance.now();\n  const isCurrentlyInline = state.inline ?? false;\n  const isCurrentlySimple = state.simple ?? false;\n\n  state.inline = false;\n  state.simple = true;\n  const result = parse(children, state);\n  state.inline = isCurrentlyInline;\n  state.simple = isCurrentlySimple;\n\n  const duration = performance.now() - start;\n  if (duration > DURATION_DELAY_TRIGGER) {\n    console.log(\n      `parseSimpleInline: ${duration.toFixed(3)}ms, children length: ${children.length}, result count: ${result.length}`\n    );\n  }\n\n  return result;\n};\n\n/**\n * Parse block content.\n */\nexport const parseBlock = (\n  parse: NestedParser,\n  children: string,\n  state: ParseState = {}\n): ParserResult[] => {\n  const start = performance.now();\n  const isCurrentlyInline = state.inline || false;\n  state.inline = false;\n  const normalizedChildren = trimEnd(children);\n  const needsTerminator = /\\n\\n$/.test(normalizedChildren) === false;\n  const blockInput = needsTerminator\n    ? normalizedChildren.endsWith('\\n')\n      ? `${normalizedChildren}\\n`\n      : `${normalizedChildren}\\n\\n`\n    : normalizedChildren;\n\n  const result = parse(blockInput, state);\n  state.inline = isCurrentlyInline;\n\n  const duration = performance.now() - start;\n  if (duration > DURATION_DELAY_TRIGGER) {\n    console.log(\n      `parseBlock: ${duration.toFixed(3)}ms, children length: ${children.length}, result count: ${result.length}`\n    );\n  }\n\n  return result;\n};\n\n/**\n * Helper to parse capture group 2 as inline content.\n */\nexport const parseCaptureInline = (\n  capture: RegExpMatchArray,\n  parse: NestedParser,\n  state: ParseState\n): { children: ParserResult[] } => {\n  return {\n    children: parseInline(parse, capture[2], state),\n  };\n};\n\n/**\n * Helper that captures nothing (empty object).\n */\nexport const captureNothing = (): Record<string, never> => ({});\n\n/**\n * Helper that renders nothing (null).\n */\nexport const renderNothing = (): null => null;\n\n/**\n * Check if any regex in a list matches the input.\n */\nexport const some = (regexes: RegExp[], input: string): boolean => {\n  for (let i = 0; i < regexes.length; i++) {\n    if (regexes[i].test(input)) {\n      return true;\n    }\n  }\n  return false;\n};\n"],"mappings":"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"}

package/dist/cjs/transpiler/html/getHTMLCustomComponents.cjs

@@ -0,0 +1,15 @@
+const require_transpiler_html_index = require('./index.cjs');
+
+//#region src/transpiler/html/getHTMLCustomComponents.ts
+/**
+* Extracts custom component names from an HTML string.
+* Custom components are any tags that are not standard HTML tags.
+*/
+const getHTMLCustomComponents = (content) => {
+	const customComponents = [...content.matchAll(/<(\/)?([a-zA-Z0-9.-]+)\s*([\s\S]*?)(\/?)>/g)].map((match) => match[2]).filter((tagName) => !require_transpiler_html_index.HTML_TAGS.includes(tagName.toLowerCase()));
+	return [...new Set(customComponents)];
+};
+
+//#endregion
+exports.getHTMLCustomComponents = getHTMLCustomComponents;
+//# sourceMappingURL=getHTMLCustomComponents.cjs.map

package/dist/cjs/transpiler/html/getHTMLCustomComponents.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getHTMLCustomComponents.cjs","names":["HTML_TAGS"],"sources":["../../../../src/transpiler/html/getHTMLCustomComponents.ts"],"sourcesContent":["import { HTML_TAGS } from './index';\n\n/**\n * Extracts custom component names from an HTML string.\n * Custom components are any tags that are not standard HTML tags.\n */\nexport const getHTMLCustomComponents = (content: string): string[] => {\n  // Regex to match tags: <Tag ...>, </Tag>, or <Tag ... />\n  // Captures: 2: Tag Name\n  const tagRegex = /<(\\/)?([a-zA-Z0-9.-]+)\\s*([\\s\\S]*?)(\\/?)>/g;\n  const matches = [...content.matchAll(tagRegex)];\n\n  const customComponents = matches\n    .map((match) => match[2])\n    .filter(\n      (tagName) =>\n        !(HTML_TAGS as readonly string[]).includes(tagName.toLowerCase())\n    );\n\n  return [...new Set(customComponents)];\n};\n"],"mappings":";;;;;;;AAMA,MAAa,2BAA2B,YAA8B;CAMpE,MAAM,mBAFU,CAAC,GAAG,QAAQ,SADX,6CAC6B,CAAC,CAG5C,KAAK,UAAU,MAAM,GAAG,CACxB,QACE,YACC,CAAEA,wCAAgC,SAAS,QAAQ,aAAa,CAAC,CACpE;AAEH,QAAO,CAAC,GAAG,IAAI,IAAI,iBAAiB,CAAC"}