@dogsbay/serialize-core 0.2.0-beta.98

package/dist/reads.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Shape-tolerant TreeNode reads — the single place that knows WHERE a value
+ * lives on a node.
+ *
+ * Different importers produce different TreeNode shapes for the same content:
+ * text arrives as flat `node.inline` (the dogsbay-md parser) or wrapped as
+ * `node.children[{ type: "prose", inline }]` (the Starlight importer); code
+ * text as `props.code` or `node.html`; language as `props.lang` or
+ * `props.language`; a tab title as `props.title`, `props.label`, or
+ * `props.value`.
+ *
+ * Every serializer used to re-derive these independently, and every serializer
+ * that got one wrong emitted SILENTLY EMPTY output — the entire
+ * "format-obsidian serializer field-drift" bug class
+ * (plans/format-obsidian-serializer-realign.md), where six separate reads had
+ * drifted from what the parser actually emits.
+ *
+ * These functions are deliberately DATA-ONLY: they return values and nodes,
+ * never rendered text, so every format can render them its own way while
+ * agreeing on where to look. Extracted from the canonical reads in
+ * `format-astro/src/serialize.ts`; the operator asymmetries below are
+ * behavioural and deliberate — read the comments before "simplifying" them.
+ */
+import type { TreeNode, InlineNode } from "@dogsbay/types";
+/**
+ * A node's inline content, handling BOTH shapes:
+ * flat `node.inline`, or a single wrapped `prose` child carrying `inline`.
+ *
+ * Mirrors `paragraphToAstro`'s dual-shape read. Note it does NOT fall back to
+ * arbitrary children — only the single-`prose`-child wrapper, matching the
+ * importer shape it exists for.
+ */
+export declare function leafInline(node: TreeNode): InlineNode[] | undefined;
+/** True when the node carries inline content in either shape. */
+export declare function hasInline(node: TreeNode): boolean;
+/**
+ * A node's pre-rendered HTML content, handling both the flat and the
+ * wrapped-`prose` shapes.
+ *
+ * THIRD shape, and the one that bites: several importers (MDX, Starlight,
+ * MkDocs) emit `prose` nodes carrying `html` with NO `inline` array at all.
+ * A serializer that reads only `inline`/`children` renders those nodes as
+ * EMPTY — silently dropping every paragraph and list-item body on a real
+ * page. (Found by dogfooding this very package on a real Mintlify → Docusaurus
+ * conversion: two paragraphs vanished and every bullet came out bare.)
+ */
+export declare function leafHtml(node: TreeNode): string | undefined;
+/** True when the node has content in ANY of the three shapes. */
+export declare function hasContent(node: TreeNode): boolean;
+/**
+ * A code node's text.
+ *
+ * Uses `??` (NOT `||`) deliberately: an explicitly empty `props.code` (`""`)
+ * is a real, intentional empty code block and must win over `node.html`.
+ * Switching this to `||` silently changes behaviour for empty code blocks.
+ */
+export declare function codeText(node: TreeNode): string;
+/**
+ * A code node's language.
+ *
+ * Uses `||` (NOT `??`) deliberately: an empty-string language is meaningless
+ * and must fall through to the next candidate, then to `fallback`.
+ */
+export declare function codeLang(node: TreeNode, fallback?: string): string;
+/**
+ * A tab's display title.
+ *
+ * Cascade order is `title || label || value`, then an index-based default —
+ * which is why the index must be passed rather than this being a plain
+ * property pick. (The dogsbay-md parser emits `label`; MDX importers emit
+ * `title`; reading only one of them renders every tab as the literal fallback.)
+ */
+export declare function tabTitle(tab: TreeNode, index?: number): string;
+/** A tab's stable value/key, falling back to its title. */
+export declare function tabValue(tab: TreeNode, index?: number): string;
+/** The non-content fields of a card / link-card. */
+export interface CardFields {
+    title: string;
+    href: string;
+    icon?: string;
+    /** Only the `props.description` fallback — NOT the node's body content. */
+    description?: string;
+}
+/**
+ * A card's scalar fields.
+ *
+ * Body content is deliberately NOT resolved here: cards use
+ * children-before-inline precedence (the opposite of {@link leafInline}'s
+ * inline-first order) and each format escapes the `props.description`
+ * fallback differently. Resolve the body with {@link cardBodySources}.
+ */
+export declare function cardFields(node: TreeNode): CardFields;
+/**
+ * The ordered candidate sources for a card's body, most-preferred first:
+ * children → inline → `props.description`.
+ *
+ * Returned as a discriminated list (rather than a rendered string) because the
+ * last source needs format-specific escaping while the first two are rendered
+ * through the format's normal paths.
+ */
+export declare function cardBodySources(node: TreeNode): Array<{
+    kind: "children";
+    children: TreeNode[];
+} | {
+    kind: "inline";
+    inline: InlineNode[];
+} | {
+    kind: "text";
+    text: string;
+}>;
+/** A heading's level, defaulting to 1. */
+export declare function headingLevel(node: TreeNode): number;
+/**
+ * THE Dogsbay heading slug rule — lowercase, drop non-word chars (keeping
+ * `_` and `-`), spaces → `-`. This is what the site build assigns as anchor
+ * ids (`format-dogsbay-md/src/headings.ts` re-exports it), what
+ * `format-dogsbay-md`'s TOC emits, and what every exporter that writes a
+ * heading link must use — one rule, so a link and its target cannot
+ * disagree. Dedupe (`-1`, `-2`) is the CALLER's job over its own heading
+ * set; an explicit `{#id}` replaces the text slug (see `headingFragment`).
+ */
+export declare function slugifyHeadingText(text: string): string;
+/** The plain text of a heading across the three TreeNode shapes. */
+export declare function headingText(node: TreeNode): string;
+/**
+ * The fragment a link to this heading uses on a Dogsbay site: the explicit
+ * `props.slug` (backfilled by the parser's `extractHeadings`, or an author's
+ * `{#id}`), else the slug of the text.
+ */
+export declare function headingFragment(node: TreeNode): string;
+/**
+ * A callout/details variant (`note`, `warning`, …), lower-cased, default
+ * `note`. Importers spell this `variant` or `type` depending on source syntax.
+ */
+export declare function calloutVariant(node: TreeNode, fallback?: string): string;
+/**
+ * An explicit callout title, or undefined when the format should derive one
+ * from the variant. `null` is preserved by callers that distinguish
+ * "deliberately untitled" from "absent".
+ */
+export declare function calloutTitle(node: TreeNode): string | undefined;
+/** An ordered list's start number, or undefined when it starts at 1. */
+export declare function listStart(node: TreeNode): number | undefined;
+/** An image/media source, tolerating `props.src` and `props.url`. */
+export declare function mediaSrc(node: TreeNode): string;
+/**
+ * Render a "leaf" node's content (list-item, table cell, step, dt, dd) in the
+ * canonical order: inline content first, then block children.
+ *
+ * This is the ordering `format-astro`'s `leafContent` established and the one
+ * the obsidian field-drift fix adopted. Formats supply their own renderers;
+ * only the ORDER and the empty-part filtering are shared.
+ */
+export declare function renderLeaf(node: TreeNode, renderers: {
+    inline: (nodes: InlineNode[]) => string;
+    children: (nodes: TreeNode[]) => string;
+    /**
+     * Render pre-rendered HTML content. Supply this or nodes carrying only
+     * `html` (the MDX/Starlight/MkDocs `prose` shape) render as EMPTY —
+     * see {@link leafHtml}.
+     */
+    html?: (html: string) => string;
+    join?: string;
+}): string;
+//# sourceMappingURL=reads.d.ts.map

package/dist/reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../src/reads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,GAAG,SAAS,CAUnE;AAED,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAGjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAgB3D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAMlD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,SAAK,GAAG,MAAM,CAI9D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,SAAI,GAAG,MAAM,CAOzD;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,SAAI,GAAG,MAAM,CAEzD;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAOrD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,GACb,KAAK,CACJ;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,QAAQ,EAAE,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CACjC,CAeA;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAqBlD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAItD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,SAAS,GAAG,MAAM,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAM/D;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAK5D;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE;IACT,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,MAAM,CAAC;IACxC;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,MAAM,CAgCR"}

package/dist/reads.js

@@ -0,0 +1,268 @@
+/**
+ * A node's inline content, handling BOTH shapes:
+ * flat `node.inline`, or a single wrapped `prose` child carrying `inline`.
+ *
+ * Mirrors `paragraphToAstro`'s dual-shape read. Note it does NOT fall back to
+ * arbitrary children — only the single-`prose`-child wrapper, matching the
+ * importer shape it exists for.
+ */
+export function leafInline(node) {
+    if (node.inline)
+        return node.inline;
+    if (node.children?.length === 1 &&
+        node.children[0].type === "prose" &&
+        node.children[0].inline) {
+        return node.children[0].inline;
+    }
+    return undefined;
+}
+/** True when the node carries inline content in either shape. */
+export function hasInline(node) {
+    const inline = leafInline(node);
+    return Boolean(inline && inline.length > 0);
+}
+/**
+ * A node's pre-rendered HTML content, handling both the flat and the
+ * wrapped-`prose` shapes.
+ *
+ * THIRD shape, and the one that bites: several importers (MDX, Starlight,
+ * MkDocs) emit `prose` nodes carrying `html` with NO `inline` array at all.
+ * A serializer that reads only `inline`/`children` renders those nodes as
+ * EMPTY — silently dropping every paragraph and list-item body on a real
+ * page. (Found by dogfooding this very package on a real Mintlify → Docusaurus
+ * conversion: two paragraphs vanished and every bullet came out bare.)
+ */
+export function leafHtml(node) {
+    // Symmetry matters: inline wins over html in BOTH shapes. Returning
+    // `node.html` while `node.inline` also exists gave callers writing the
+    // natural `leafHtml(n) ?? render(leafInline(n))` opposite precedence on flat
+    // vs wrapped nodes.
+    if (node.inline && node.inline.length > 0)
+        return undefined;
+    if (node.html)
+        return node.html;
+    if (node.children?.length === 1 &&
+        node.children[0].type === "prose" &&
+        !node.children[0].inline &&
+        node.children[0].html) {
+        return node.children[0].html;
+    }
+    return undefined;
+}
+/** True when the node has content in ANY of the three shapes. */
+export function hasContent(node) {
+    return (hasInline(node) ||
+        Boolean(leafHtml(node)) ||
+        Boolean(node.children && node.children.length > 0));
+}
+/**
+ * A code node's text.
+ *
+ * Uses `??` (NOT `||`) deliberately: an explicitly empty `props.code` (`""`)
+ * is a real, intentional empty code block and must win over `node.html`.
+ * Switching this to `||` silently changes behaviour for empty code blocks.
+ */
+export function codeText(node) {
+    return (node.props?.code ?? node.html ?? "");
+}
+/**
+ * A code node's language.
+ *
+ * Uses `||` (NOT `??`) deliberately: an empty-string language is meaningless
+ * and must fall through to the next candidate, then to `fallback`.
+ */
+export function codeLang(node, fallback = "") {
+    return ((node.props?.lang || node.props?.language || fallback));
+}
+/**
+ * A tab's display title.
+ *
+ * Cascade order is `title || label || value`, then an index-based default —
+ * which is why the index must be passed rather than this being a plain
+ * property pick. (The dogsbay-md parser emits `label`; MDX importers emit
+ * `title`; reading only one of them renders every tab as the literal fallback.)
+ */
+export function tabTitle(tab, index = 0) {
+    return (tab.props?.title ||
+        tab.props?.label ||
+        tab.props?.value ||
+        `Tab ${index + 1}`);
+}
+/** A tab's stable value/key, falling back to its title. */
+export function tabValue(tab, index = 0) {
+    return tab.props?.value || tabTitle(tab, index);
+}
+/**
+ * A card's scalar fields.
+ *
+ * Body content is deliberately NOT resolved here: cards use
+ * children-before-inline precedence (the opposite of {@link leafInline}'s
+ * inline-first order) and each format escapes the `props.description`
+ * fallback differently. Resolve the body with {@link cardBodySources}.
+ */
+export function cardFields(node) {
+    return {
+        title: node.props?.title ?? "",
+        href: node.props?.href ?? "",
+        icon: node.props?.icon,
+        description: node.props?.description,
+    };
+}
+/**
+ * The ordered candidate sources for a card's body, most-preferred first:
+ * children → inline → `props.description`.
+ *
+ * Returned as a discriminated list (rather than a rendered string) because the
+ * last source needs format-specific escaping while the first two are rendered
+ * through the format's normal paths.
+ */
+export function cardBodySources(node) {
+    const out = [];
+    if (node.children && node.children.length > 0) {
+        out.push({ kind: "children", children: node.children });
+    }
+    if (node.inline && node.inline.length > 0) {
+        out.push({ kind: "inline", inline: node.inline });
+    }
+    const description = node.props?.description;
+    if (description)
+        out.push({ kind: "text", text: description });
+    return out;
+}
+/** A heading's level, defaulting to 1. */
+export function headingLevel(node) {
+    return node.props?.level ?? 1;
+}
+/**
+ * THE Dogsbay heading slug rule — lowercase, drop non-word chars (keeping
+ * `_` and `-`), spaces → `-`. This is what the site build assigns as anchor
+ * ids (`format-dogsbay-md/src/headings.ts` re-exports it), what
+ * `format-dogsbay-md`'s TOC emits, and what every exporter that writes a
+ * heading link must use — one rule, so a link and its target cannot
+ * disagree. Dedupe (`-1`, `-2`) is the CALLER's job over its own heading
+ * set; an explicit `{#id}` replaces the text slug (see `headingFragment`).
+ */
+export function slugifyHeadingText(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, "")
+        .trim()
+        .replace(/\s+/g, "-");
+}
+/** The plain text of a heading across the three TreeNode shapes. */
+export function headingText(node) {
+    const fromInline = (nodes) => {
+        let out = "";
+        for (const n of nodes) {
+            if (!n || typeof n !== "object")
+                continue;
+            const x = n;
+            if (typeof x.text === "string")
+                out += x.text;
+            else if (typeof x.alt === "string")
+                out += x.alt;
+            if (Array.isArray(x.children))
+                out += fromInline(x.children);
+        }
+        return out;
+    };
+    if (Array.isArray(node.inline) && node.inline.length)
+        return fromInline(node.inline);
+    if (typeof node.props?.text === "string" && node.props.text)
+        return node.props.text;
+    // the wrapped shape: children:[{type:"prose", inline}] (fluidtopics/html importers)
+    if (Array.isArray(node.children) && node.children.length) {
+        const inner = node.children.map((c) => headingText(c)).join("");
+        if (inner)
+            return inner;
+    }
+    if (typeof node.html === "string")
+        return node.html.replace(/<[^>]+>/g, "");
+    return "";
+}
+/**
+ * The fragment a link to this heading uses on a Dogsbay site: the explicit
+ * `props.slug` (backfilled by the parser's `extractHeadings`, or an author's
+ * `{#id}`), else the slug of the text.
+ */
+export function headingFragment(node) {
+    const explicit = node.props?.slug;
+    if (typeof explicit === "string" && explicit)
+        return explicit;
+    return slugifyHeadingText(headingText(node));
+}
+/**
+ * A callout/details variant (`note`, `warning`, …), lower-cased, default
+ * `note`. Importers spell this `variant` or `type` depending on source syntax.
+ */
+export function calloutVariant(node, fallback = "note") {
+    const raw = node.props?.variant || node.props?.type || fallback;
+    return raw.toLowerCase();
+}
+/**
+ * An explicit callout title, or undefined when the format should derive one
+ * from the variant. `null` is preserved by callers that distinguish
+ * "deliberately untitled" from "absent".
+ */
+export function calloutTitle(node) {
+    const title = node.props?.title;
+    // An explicit `title=""` is the author suppressing the auto-title. Mapping it
+    // to undefined means "derive one from the variant" and the exporter puts the
+    // title back — so the empty string is preserved and only absence is undefined.
+    return typeof title === "string" ? title : undefined;
+}
+/** An ordered list's start number, or undefined when it starts at 1. */
+export function listStart(node) {
+    const raw = node.props?.start;
+    if (raw == null)
+        return undefined;
+    const n = typeof raw === "number" ? raw : parseInt(String(raw), 10);
+    return Number.isNaN(n) ? undefined : n;
+}
+/** An image/media source, tolerating `props.src` and `props.url`. */
+export function mediaSrc(node) {
+    return (node.props?.src || node.props?.url || "");
+}
+/**
+ * Render a "leaf" node's content (list-item, table cell, step, dt, dd) in the
+ * canonical order: inline content first, then block children.
+ *
+ * This is the ordering `format-astro`'s `leafContent` established and the one
+ * the obsidian field-drift fix adopted. Formats supply their own renderers;
+ * only the ORDER and the empty-part filtering are shared.
+ */
+export function renderLeaf(node, renderers) {
+    const parts = [];
+    // Go through the TOLERANT reads, not the raw fields. Reading `node.inline` /
+    // `node.html` directly meant the wrapped `children:[{prose, html}]` shape
+    // never reached the html renderer and rendered EMPTY — the exact field-drift
+    // failure this package exists to prevent.
+    const inline = leafInline(node);
+    const html = leafHtml(node);
+    // Provenance is established by IDENTITY against the wrapper child, not by
+    // re-deriving it from `node.inline === undefined`. That inference was wrong
+    // for a falsy-but-present field: `{ html: "", children:[{prose, html:"H"}] }`
+    // read the wrapper, concluded the value was flat, and then descended into
+    // children — emitting the same paragraph twice.
+    const wrapper = node.children?.length === 1 && node.children[0].type === "prose"
+        ? node.children[0]
+        : undefined;
+    let consumedWrapper = false;
+    if (inline && inline.length > 0) {
+        parts.push(renderers.inline(inline));
+        consumedWrapper = wrapper !== undefined && inline === wrapper.inline;
+    }
+    else if (html && renderers.html) {
+        parts.push(renderers.html(html));
+        consumedWrapper = wrapper !== undefined && html === wrapper.html;
+    }
+    // When the content came from the single wrapped `prose` child, that child is
+    // already rendered — descending into children would duplicate it.
+    if (!consumedWrapper && node.children && node.children.length > 0) {
+        const rendered = renderers.children(node.children);
+        if (rendered)
+            parts.push(rendered);
+    }
+    return parts.filter(Boolean).join(renderers.join ?? "\n");
+}
+//# sourceMappingURL=reads.js.map

package/dist/reads.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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 declare function pickCodeFence(content: string, fenceChar?: "`" | "~"): string;
+/**
+ * Choose a `:::` directive fence long enough to wrap `content`.
+ * Used by markdown dialects with container directives (Docusaurus
+ * admonitions, MyST, dogsbay-md).
+ */
+export declare function pickDirectiveFence(content: string): string;
+/** Indent every non-empty line by `spaces`. Empty lines stay empty. */
+export declare function indent(content: string, spaces: number): string;
+/** Prefix every line, using a trimmed prefix for empty lines (blockquotes). */
+export declare function prefixLines(content: string, prefix: string): string;
+/** Collapse 3+ blank lines to 2 and strip trailing whitespace on each line. */
+export declare function normalizeTrailingWhitespace(content: string): string;
+/**
+ * Strip HTML tags, keeping text content — the lossy fallback markdown targets
+ * use for HTML they cannot represent. Callers should record the degradation.
+ */
+export declare function stripHtml(html: string): string;
+/**
+ * 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 declare function inlineHtmlToMarkdown(html: string): string;
+/** Serialize a value as YAML frontmatter scalar, quoting when required. */
+export declare function yamlScalar(value: string): string;
+/** Build a YAML frontmatter block from ordered entries. Empty → "". */
+export declare function frontmatterBlock(entries: Array<[string, string | number | boolean | undefined]>): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,GAAG,GAAG,GAAS,GAAG,MAAM,CAOjF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkC9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwBzD;AAkBD,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA8BhD;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,GAC9D,MAAM,CAQR"}