@dogsbay/serialize-core 0.2.0-beta.98

package/dist/text.js

@@ -0,0 +1,191 @@
+/**
+ * Format-agnostic text utilities.
+ *
+ * These are byte-identical (or strictly stronger) versions of helpers
+ * currently duplicated across serializers: `indent` exists three times
+ * (format-dogsbay-md, format-obsidian, format-astro's `indentStr`), and
+ * format-obsidian's `chooseFence` is a weaker `pickCodeFence` (hardcoded
+ * backtick, `match` instead of `matchAll`).
+ *
+ * Only genuinely universal helpers live here. Per-dialect escaping
+ * (CommonMark text escaping, Astro brace-neutralising, dogsbay-md attribute
+ * syntax) stays in its own package — those profiles are not interchangeable.
+ */
+/**
+ * Choose a fence long enough to wrap `content` without being terminated early.
+ *
+ * Scans for the longest run of the fence character and returns one longer,
+ * with a minimum of three.
+ */
+export function pickCodeFence(content, fenceChar = "`") {
+    const re = fenceChar === "`" ? /`+/g : /~+/g;
+    let max = 2;
+    for (const match of content.matchAll(re)) {
+        if (match[0].length > max)
+            max = match[0].length;
+    }
+    return fenceChar.repeat(max + 1);
+}
+/**
+ * Choose a `:::` directive fence long enough to wrap `content`.
+ * Used by markdown dialects with container directives (Docusaurus
+ * admonitions, MyST, dogsbay-md).
+ */
+export function pickDirectiveFence(content) {
+    let max = 2;
+    for (const match of content.matchAll(/:{3,}/g)) {
+        if (match[0].length > max)
+            max = match[0].length;
+    }
+    return ":".repeat(max + 1);
+}
+/** Indent every non-empty line by `spaces`. Empty lines stay empty. */
+export function indent(content, spaces) {
+    const prefix = " ".repeat(spaces);
+    return content
+        .split("\n")
+        .map((line) => (line ? `${prefix}${line}` : line))
+        .join("\n");
+}
+/** Prefix every line, using a trimmed prefix for empty lines (blockquotes). */
+export function prefixLines(content, prefix) {
+    return content
+        .split("\n")
+        .map((line) => (line ? `${prefix}${line}` : prefix.trimEnd()))
+        .join("\n");
+}
+/** Collapse 3+ blank lines to 2 and strip trailing whitespace on each line. */
+export function normalizeTrailingWhitespace(content) {
+    return content
+        .split("\n")
+        .map((line) => line.replace(/[ \t]+$/, ""))
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n");
+}
+/**
+ * Strip HTML tags, keeping text content — the lossy fallback markdown targets
+ * use for HTML they cannot represent. Callers should record the degradation.
+ */
+export function stripHtml(html) {
+    return html
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/p>\s*<p[^>]*>/gi, "\n\n")
+        // Comments and doctype are not tag-shaped (no letter after `<`), so the
+        // letter-anchored pattern below skips them. markdown-it really does hand
+        // importers `<!-- … -->` inside prose html, which then leaked as literal
+        // markup into plain-text contexts (step titles, table cells).
+        .replace(/<!--[\s\S]*?-->/g, "")
+        .replace(/<![^>]*>/g, "")
+        // An image is CONTENT, not markup: dropping the tag whole loses the alt
+        // text and every trace that a picture was there. Recovered as markdown
+        // image syntax before the generic tag sweep below.
+        //
+        // format-obsidian carried this rule locally and lost it when it adopted
+        // this function — measured: `See <img src="a.png" alt="Diagram of the
+        // flow">` became `See  ` on a real mkdocs->obsidian conversion, because
+        // markdown-it hands importers raw `<img>` inside prose HTML routinely.
+        .replace(/<img\b(?:[^>"']|"[^"]*"|'[^']*')*>/gi, (tag) => {
+        const alt = /\balt\s*=\s*"([^"]*)"/i.exec(tag)?.[1]
+            ?? /\balt\s*=\s*'([^']*)'/i.exec(tag)?.[1];
+        const src = /\bsrc\s*=\s*"([^"]*)"/i.exec(tag)?.[1]
+            ?? /\bsrc\s*=\s*'([^']*)'/i.exec(tag)?.[1];
+        if (!alt && !src)
+            return "";
+        return src ? `![${alt ?? ""}](${src})` : `![${alt ?? ""}]`;
+    })
+        // Skip quoted attribute runs so a `>` inside an attribute doesn't end the tag early.
+        .replace(/<\/?[A-Za-z][^\s>]*(?:[^>"']|"[^"]*"|'[^']*')*>/g, "")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .trim();
+}
+/**
+ * Convert common INLINE HTML back to markdown.
+ *
+ * Importers frequently hand serializers pre-rendered HTML for prose
+ * (`<code>x</code>`, `<strong>y</strong>`). Passing it through works in
+ * MDX-ish targets but produces source no human wants to maintain — and the
+ * point of a migration is clean, editable markdown.
+ *
+ * Deliberately conservative: only unambiguous inline tags, non-greedy, and
+ * block-level markup is left completely alone (a regex cannot restructure
+ * tables or lists safely). Anything not listed here survives as raw HTML.
+ */
+export function inlineHtmlToMarkdown(html) {
+    // Code spans are converted FIRST and then masked, so the emphasis/link rules
+    // below cannot rewrite markup that is meant to be shown literally
+    // (`<code><b>x</b></code>` must stay `<b>x</b>`, not become `**x**`).
+    const masked = [];
+    let out = html.replace(/<code>([\s\S]*?)<\/code>/gi, (_m, inner) => {
+        masked.push(codeSpanText(inner));
+        return `\u0000CODE${masked.length - 1}\u0000`;
+    });
+    out = out
+        .replace(/<(?:strong|b)>([\s\S]*?)<\/(?:strong|b)>/gi, "**$1**")
+        .replace(/<(?:em|i)>([\s\S]*?)<\/(?:em|i)>/gi, "*$1*")
+        .replace(/<(?:del|s|strike)>([\s\S]*?)<\/(?:del|s|strike)>/gi, "~~$1~~")
+        .replace(/<mark>([\s\S]*?)<\/mark>/gi, "==$1==")
+        .replace(
+    // `[^>]*` would stop at a `>` inside another attribute value
+    // (`<a href="x" title="a > b">`), so skip quoted runs explicitly.
+    /<a\s+href="([^"]*)"(?:[^>"']|"[^"]*"|'[^']*')*>([\s\S]*?)<\/a>/gi, (_m, href, text) => `[${text}](${href})`)
+        .replace(/<br\s*\/?>/gi, "  \n");
+    return out.replace(/\u0000CODE(\d+)\u0000/g, (_m, i) => masked[Number(i)]);
+}
+/** CommonMark code span (see serialize-core `codeSpan`; duplicated here to keep
+ *  text.ts free of an inline.ts import cycle). */
+function codeSpanText(text) {
+    const longest = (text.match(/`+/g) ?? []).reduce((max, run) => Math.max(max, run.length), 0);
+    const fence = "`".repeat(longest + 1);
+    const needsPad = text.length === 0 ||
+        text.startsWith("`") || text.endsWith("`") ||
+        text.startsWith(" ") || text.endsWith(" ");
+    const pad = needsPad ? " " : "";
+    return `${fence}${pad}${text}${pad}${fence}`;
+}
+/** Serialize a value as YAML frontmatter scalar, quoting when required. */
+export function yamlScalar(value) {
+    if (value === "")
+        return '""';
+    const needsQuote = 
+    // structural / indicator characters
+    /[:#[\]{}&*!|>'"%@`,]/.test(value) ||
+        // leading indicators YAML reads as block syntax
+        /^[-?]/.test(value) ||
+        // surrounding whitespace, or any newline
+        /^\s|\s$/.test(value) ||
+        /[\n\r]/.test(value) ||
+        // values YAML 1.1 would coerce to a non-string: booleans, null, numbers
+        // (incl. hex/octal/binary/exponent), dates. A page titled "123" or "null"
+        // must stay a STRING in frontmatter.
+        /^(?:true|false|yes|no|on|off|null|~)$/i.test(value) ||
+        /^[+-]?(?:\d[\d_]*(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/.test(value) ||
+        /^0[bxo][0-9a-fA-F_]+$/i.test(value) ||
+        // YAML 1.1 float specials — `.inf` loads as Infinity, `.nan` as NaN.
+        /^[-+]?\.(?:inf|nan)$/i.test(value) ||
+        /^\d{4}-\d{2}-\d{2}/.test(value);
+    if (needsQuote) {
+        // Newlines MUST be escaped, not embedded: a literal `\n---\n` inside a
+        // quoted scalar terminates the frontmatter block early and the file no
+        // longer parses.
+        return `"${value
+            .replace(/\\/g, "\\\\")
+            .replace(/"/g, '\\"')
+            .replace(/\n/g, "\\n")
+            .replace(/\r/g, "\\r")}"`;
+    }
+    return value;
+}
+/** Build a YAML frontmatter block from ordered entries. Empty → "". */
+export function frontmatterBlock(entries) {
+    const lines = entries
+        .filter((e) => e[1] !== undefined)
+        .map(([key, value]) => typeof value === "string" ? `${key}: ${yamlScalar(value)}` : `${key}: ${value}`);
+    if (lines.length === 0)
+        return "";
+    return `---\n${lines.join("\n")}\n---`;
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

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

package/dist/unknown.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Unknown / unsupported block-node fallback.
+ *
+ * Generalises `format-dogsbay-md`'s `renderUnknown`, with one deliberate
+ * change: **the loss is recorded.** The original's `skip` mode returns `""`
+ * and tells nobody, which is precisely the silent-loss failure this package
+ * exists to end.
+ *
+ * The three existing peer fallbacks (dogsbay-md's configurable one, obsidian's
+ * `stripHtml`-or-children, astro's children-or-empty) are all expressible
+ * here.
+ */
+import type { TreeNode } from "@dogsbay/types";
+export type UnknownNodePolicy = 
+/** Emit `node.html`, else children, else a comment. Most content-preserving. */
+"html"
+/** Emit a visible marker comment only. */
+ | "comment"
+/** Emit nothing. Loss is still recorded. */
+ | "skip";
+export interface UnknownNodeOptions {
+    policy?: UnknownNodePolicy;
+    /** Render child nodes (needed by the "html" policy). */
+    renderChildren?: (children: TreeNode[]) => string;
+    /** How to write a comment in the target format. Default: HTML comment. */
+    comment?: (text: string) => string;
+    /** Loss recorder — wire to an `ExportLedger`. */
+    report?: (feature: string, detail?: string) => void;
+    /** Separator when falling back to children. */
+    join?: string;
+}
+/**
+ * Render a node whose type the exporter has no mapping for.
+ *
+ * Always records the event before returning, so an exporter cannot lose
+ * content without it appearing in the ledger.
+ */
+export declare function renderUnknownNode(node: TreeNode, options?: UnknownNodeOptions): string;
+//# sourceMappingURL=unknown.d.ts.map

package/dist/unknown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown.d.ts","sourceRoot":"","sources":["../src/unknown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,iBAAiB;AAC3B,gFAAgF;AAC9E,MAAM;AACR,0CAA0C;GACxC,SAAS;AACX,4CAA4C;GAC1C,MAAM,CAAC;AAEX,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,wDAAwD;IACxD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,MAAM,CAAC;IAClD,0EAA0E;IAC1E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,iDAAiD;IACjD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAgCR"}

package/dist/unknown.js

@@ -0,0 +1,34 @@
+/**
+ * Render a node whose type the exporter has no mapping for.
+ *
+ * Always records the event before returning, so an exporter cannot lose
+ * content without it appearing in the ledger.
+ */
+export function renderUnknownNode(node, options = {}) {
+    const policy = options.policy ?? "html";
+    const comment = options.comment ?? ((text) => `<!-- ${text} -->`);
+    const report = options.report ?? (() => { });
+    const join = options.join ?? "\n\n";
+    switch (policy) {
+        case "skip":
+            report(node.type, "unsupported node type — omitted from output");
+            return "";
+        case "comment":
+            report(node.type, "unsupported node type — replaced with a comment");
+            return comment(`unsupported: ${node.type}`);
+        case "html":
+        default: {
+            if (node.html) {
+                report(node.type, "unsupported node type — emitted as raw HTML");
+                return node.html;
+            }
+            if (node.children && node.children.length > 0 && options.renderChildren) {
+                report(node.type, "unsupported node type — wrapper dropped, children preserved");
+                return options.renderChildren(node.children);
+            }
+            report(node.type, "unsupported node type — no content to preserve");
+            return comment(`unsupported: ${node.type}`);
+        }
+    }
+}
+//# sourceMappingURL=unknown.js.map

package/dist/unknown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown.js","sourceRoot":"","sources":["../src/unknown.ts"],"names":[],"mappings":"AAkCA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;IACxC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC;IAEpC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,6CAA6C,CAAC,CAAC;YACjE,OAAO,EAAE,CAAC;QAEZ,KAAK,SAAS;YACZ,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,iDAAiD,CAAC,CAAC;YACrE,OAAO,OAAO,CAAC,gBAAgB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAE9C,KAAK,MAAM,CAAC;QACZ,OAAO,CAAC,CAAC,CAAC;YACR,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,6CAA6C,CAAC,CAAC;gBACjE,OAAO,IAAI,CAAC,IAAI,CAAC;YACnB,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBACxE,MAAM,CACJ,IAAI,CAAC,IAAI,EACT,6DAA6D,CAC9D,CAAC;gBACF,OAAO,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,gDAAgD,CAAC,CAAC;YACpE,OAAO,OAAO,CAAC,gBAAgB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@dogsbay/serialize-core",
+  "version": "0.2.0-beta.98",
+  "description": "Shared serializer core — shape-tolerant TreeNode reads, a generic inline walker, fence/indent utilities, and the export capability ledger every format exporter builds on",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.9.5",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.98"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@dogsbay/types": "0.2.0-beta.98"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dogsbay/dogsbay.git",
+    "directory": "packages/serialize-core"
+  },
+  "homepage": "https://github.com/dogsbay/dogsbay/tree/main/packages/serialize-core",
+  "bugs": {
+    "url": "https://github.com/dogsbay/dogsbay/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}