ironmark 1.12.3 → 2.0.0

package/wasm/pkg/ironmark_bg.wasm.d.ts

@@ -9,7 +9,7 @@ export const parseToAst: (a: number, b: number, c: number, d: number, e: number,
 export const renderAnsi: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number) => void;
 export const renderMarkdown: (a: number, b: number, c: number) => void;
 export const ironmark_free: (a: number) => void;
-export const ironmark_parse: (a: number) => number;
+export const ironmark_render_html: (a: number) => number;
 export const __wbindgen_add_to_stack_pointer: (a: number) => number;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;

package/wasm/shared.js

@@ -1,5 +1,7 @@
 const decoder = new TextDecoder("utf-8");
 
+// ─── Internal helpers ────────────────────────────────────────────────────────
+
 function toStr(markdown) {
   if (typeof markdown === "string") return markdown;
   if (markdown instanceof Uint8Array) return decoder.decode(markdown);
@@ -11,96 +13,108 @@ function toStr(markdown) {
   throw new TypeError("markdown must be a string, Uint8Array, ArrayBuffer, or Buffer");
 }
 
+// ─── Preset resolution ───────────────────────────────────────────────────────
+
+const PRESETS = {
+  default: {},
+  safe: {
+    disableRawHtml: true,
+    tagFilter: true,
+  },
+  strict: {
+    hardBreaks: false,
+    enableHighlight: false,
+    enableStrikethrough: false,
+    enableUnderline: false,
+    enableAutolink: false,
+    enableWikiLinks: false,
+    enableLatexMath: false,
+    permissiveAtxHeaders: false,
+    collapseWhitespace: false,
+    disableRawHtml: true,
+  },
+  llm: {
+    hardBreaks: false,
+    enableHighlight: true,
+    enableStrikethrough: true,
+    enableUnderline: true,
+    enableTables: true,
+    enableAutolink: false,
+    enableTaskLists: true,
+    disableRawHtml: true,
+    enableHeadingIds: true,
+    enableIndentedCodeBlocks: true,
+    noHtmlBlocks: true,
+    noHtmlSpans: true,
+    tagFilter: true,
+    collapseWhitespace: true,
+    permissiveAtxHeaders: false,
+    enableWikiLinks: false,
+    enableLatexMath: false,
+  },
+};
+
+export function resolveOptions(options) {
+  if (options == null) return {};
+  const preset = options.preset != null ? (PRESETS[options.preset] ?? {}) : {};
+  const safe = options.safe === true ? PRESETS.safe : {};
+  const deterministic = options.deterministic === true ? { collapseWhitespace: true } : {};
+  const { preset: _p, safe: _s, deterministic: _d, stableAst: _a, ...rest } = options;
+  return { ...preset, ...safe, ...deterministic, ...rest };
+}
+
 function optionArgs(markdown, options) {
+  const r = resolveOptions(options);
   return [
     toStr(markdown),
-    options?.hardBreaks,
-    options?.enableHighlight,
-    options?.enableStrikethrough,
-    options?.enableUnderline,
-    options?.enableTables,
-    options?.enableAutolink,
-    options?.enableTaskLists,
-    options?.disableRawHtml,
-    options?.enableHeadingIds,
-    options?.enableHeadingAnchors,
-    options?.enableIndentedCodeBlocks,
-    options?.noHtmlBlocks,
-    options?.noHtmlSpans,
-    options?.tagFilter,
-    options?.collapseWhitespace,
-    options?.permissiveAtxHeaders,
-    options?.enableWikiLinks,
-    options?.enableLatexMath,
+    r.hardBreaks,
+    r.enableHighlight,
+    r.enableStrikethrough,
+    r.enableUnderline,
+    r.enableTables,
+    r.enableAutolink,
+    r.enableTaskLists,
+    r.disableRawHtml,
+    r.enableHeadingIds,
+    r.enableHeadingAnchors,
+    r.enableIndentedCodeBlocks,
+    r.noHtmlBlocks,
+    r.noHtmlSpans,
+    r.tagFilter,
+    r.collapseWhitespace,
+    r.permissiveAtxHeaders,
+    r.enableWikiLinks,
+    r.enableLatexMath,
   ];
 }
 
-export function createParse(wasmParse, wasmParseDefault = null) {
-  return function parse(markdown, options) {
-    const input = toStr(markdown);
-    if (options == null) {
-      if (wasmParseDefault) return wasmParseDefault(input);
-      return wasmParse(
-        input,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-      );
-    }
+// ─── Public API factories ─────────────────────────────────────────────────────
+
+export function createParseMarkdown(wasmParseToAst) {
+  return function parseMarkdown(input, options) {
+    return JSON.parse(wasmParseToAst(...optionArgs(input, options)));
+  };
+}
+
+export function createRenderHtml(wasmParse, wasmParseDefault = null) {
+  return function renderHtml(input, options) {
+    if (options == null && wasmParseDefault) return wasmParseDefault(toStr(input));
     return wasmParse(...optionArgs(input, options));
   };
 }
 
-export function createParseToAst(wasmParseToAst) {
-  return function parseToAst(markdown, options) {
-    const input = toStr(markdown);
-    if (options == null) {
-      return wasmParseToAst(
-        input,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-        undefined,
-      );
-    }
-    return wasmParseToAst(...optionArgs(input, options));
+export function createRenderMarkdown(wasmRenderMarkdown) {
+  return function renderMarkdown(ast) {
+    const json =
+      Array.isArray(ast) || (typeof ast === "object" && ast !== null) ? JSON.stringify(ast) : ast;
+    return wasmRenderMarkdown(json);
   };
 }
 
-export function createRenderAnsi(wasmRenderAnsi) {
-  return function renderAnsi(markdown, options, ansiOptions) {
+export function createRenderAnsiTerminal(wasmRenderAnsi) {
+  return function renderAnsiTerminal(input, options, ansiOptions) {
     return wasmRenderAnsi(
-      ...optionArgs(markdown, options),
-      // width is plain u32 (not Option): 0 = use default (80)
+      ...optionArgs(input, options),
       ansiOptions?.width ?? 0,
       ansiOptions?.color,
       ansiOptions?.lineNumbers,
@@ -111,7 +125,7 @@ export function createRenderAnsi(wasmRenderAnsi) {
 
 export function createParseHtmlToAst(wasmParseHtmlToAst) {
   return function parseHtmlToAst(html, preserveUnknownAsHtml) {
-    return wasmParseHtmlToAst(html, preserveUnknownAsHtml);
+    return JSON.parse(wasmParseHtmlToAst(html, preserveUnknownAsHtml));
   };
 }
 
@@ -121,8 +135,115 @@ export function createHtmlToMarkdown(wasmHtmlToMarkdown) {
   };
 }
 
-export function createRenderMarkdown(wasmRenderMarkdown) {
-  return function renderMarkdown(astJson) {
-    return wasmRenderMarkdown(astJson);
+// ─── Introspection helpers ────────────────────────────────────────────────────
+
+export const AST_SCHEMA_VERSION = "2";
+
+export function getCapabilities() {
+  return {
+    astSchemaVersion: AST_SCHEMA_VERSION,
+    formats: ["html", "ast", "markdown", "ansi"],
+    presets: Object.keys(PRESETS),
+    extensions: [
+      "hardBreaks",
+      "enableHighlight",
+      "enableStrikethrough",
+      "enableUnderline",
+      "enableTables",
+      "enableAutolink",
+      "enableTaskLists",
+      "enableHeadingIds",
+      "enableHeadingAnchors",
+      "enableIndentedCodeBlocks",
+      "enableWikiLinks",
+      "enableLatexMath",
+    ],
+    security: ["disableRawHtml", "noHtmlBlocks", "noHtmlSpans", "tagFilter"],
   };
 }
+
+export function getAstSchemaVersion() {
+  return AST_SCHEMA_VERSION;
+}
+
+export function getDefaultOptions() {
+  return {
+    hardBreaks: true,
+    enableHighlight: true,
+    enableStrikethrough: true,
+    enableUnderline: true,
+    enableTables: true,
+    enableAutolink: true,
+    enableTaskLists: true,
+    disableRawHtml: false,
+    enableHeadingIds: false,
+    enableHeadingAnchors: false,
+    enableIndentedCodeBlocks: true,
+    noHtmlBlocks: false,
+    noHtmlSpans: false,
+    tagFilter: false,
+    collapseWhitespace: false,
+    permissiveAtxHeaders: false,
+    enableWikiLinks: false,
+    enableLatexMath: false,
+  };
+}
+
+export function getPresets() {
+  return structuredClone(PRESETS);
+}
+
+// ─── Utility functions ────────────────────────────────────────────────────────
+
+export function extractHeadings(ast) {
+  const headings = [];
+  const blocks = Array.isArray(ast) ? ast : (ast?.children ?? []);
+  function walk(nodes) {
+    for (const node of nodes) {
+      if (node?.t === "Heading" || node?.type === "Heading") {
+        const level = node.level ?? node.l ?? 1;
+        const text = extractText(node.children ?? node.c ?? []);
+        headings.push({ level, text, id: slugify(text) });
+      }
+      const children = node?.children ?? node?.c ?? node?.items ?? [];
+      if (Array.isArray(children)) walk(children);
+    }
+  }
+  walk(blocks);
+  return headings;
+}
+
+function extractText(nodes) {
+  if (!Array.isArray(nodes)) return String(nodes ?? "");
+  return nodes
+    .map((n) => {
+      if (typeof n === "string") return n;
+      const t = n?.t ?? n?.type ?? "";
+      if (t === "Text" || t === "Code") return n.text ?? n.value ?? "";
+      return extractText(n?.children ?? n?.c ?? []);
+    })
+    .join("");
+}
+
+function slugify(text) {
+  return text
+    .toLowerCase()
+    .replace(/[^\w\s-]/g, "")
+    .trim()
+    .replace(/[\s_]+/g, "-");
+}
+
+export function summarizeAst(ast) {
+  const counts = {};
+  const blocks = Array.isArray(ast) ? ast : (ast?.children ?? []);
+  function walk(nodes) {
+    for (const node of nodes) {
+      const t = node?.t ?? node?.type ?? "Unknown";
+      counts[t] = (counts[t] ?? 0) + 1;
+      const children = node?.children ?? node?.c ?? node?.items ?? [];
+      if (Array.isArray(children)) walk(children);
+    }
+  }
+  walk(blocks);
+  return { blockCount: blocks.length, nodeCounts: counts };
+}

package/wasm/web.js

@@ -1,11 +1,17 @@
 import * as wasmGlue from "./pkg/ironmark_bg.js";
 import {
-  createParse,
-  createParseToAst,
-  createRenderAnsi,
+  createParseMarkdown,
+  createRenderHtml,
+  createRenderMarkdown,
+  createRenderAnsiTerminal,
   createParseHtmlToAst,
   createHtmlToMarkdown,
-  createRenderMarkdown,
+  getCapabilities,
+  getAstSchemaVersion,
+  getDefaultOptions,
+  getPresets,
+  extractHeadings,
+  summarizeAst,
 } from "./shared.js";
 
 let initialized = false;
@@ -34,9 +40,12 @@ export async function init(input) {
   initialized = true;
 }
 
-export const parse = createParse(wasmGlue.parse, wasmGlue.parseDefault);
-export const parseToAst = createParseToAst(wasmGlue.parseToAst);
-export const renderAnsi = createRenderAnsi(wasmGlue.renderAnsi);
+export const parseMarkdown = createParseMarkdown(wasmGlue.parseToAst);
+export const renderHtml = createRenderHtml(wasmGlue.parse, wasmGlue.parseDefault);
+export const renderMarkdown = createRenderMarkdown(wasmGlue.renderMarkdown);
+export const renderAnsiTerminal = createRenderAnsiTerminal(wasmGlue.renderAnsi);
 export const parseHtmlToAst = createParseHtmlToAst(wasmGlue.parseHtmlToAst);
 export const htmlToMarkdown = createHtmlToMarkdown(wasmGlue.htmlToMarkdown);
-export const renderMarkdown = createRenderMarkdown(wasmGlue.renderMarkdown);
+
+export { getCapabilities, getAstSchemaVersion, getDefaultOptions, getPresets };
+export { extractHeadings, summarizeAst };