@dogsbay/format-dita 0.2.0-beta.101

package/dist/inline.js

@@ -0,0 +1,281 @@
+import { renameDitaHref } from "./types.js";
+/**
+ * A snippet is safe to splice INLINE (mid-sentence, list items, cells)
+ * only when it is a single line with no heading — anything else breaks
+ * the surrounding markdown structure when minja inlines it verbatim.
+ */
+export const inlineSafeSnippet = (snippet) => snippet.singleLine && snippet.headingBase === undefined;
+/**
+ * Ledger detail for a conref that could not become an automatic include.
+ * When the target WAS extracted (snippet exists) the note names the
+ * snippet file so the manual fix is one paste away.
+ */
+export const conrefLedgerDetail = (attribs, snippet, hasPlan) => {
+    if (attribs?.conaction) {
+        return `conref push (conaction="${attribs.conaction}") injects content INTO the target — apply the push manually`;
+    }
+    if (attribs?.conkeyref) {
+        return "key-based content reference (conkeyref) needs its map's key space — convert to a minja include manually";
+    }
+    if (attribs?.conrefend) {
+        return "conref ranges (conrefend) are not auto-converted — merge the range into an include manually";
+    }
+    if (snippet) {
+        return `reused content is multi-line and this site cannot splice it — include "${snippet.file}" manually`;
+    }
+    if (hasPlan) {
+        return "no auto-include possible (target outside the corpus, unresolved, or not an extractable element) — convert to a minja include manually";
+    }
+    return "convert to a minja include manually";
+};
+const isElement = (node) => node.type === "tag";
+const isText = (node) => node.type === "text";
+/** Collapse XML whitespace runs the way HTML rendering would. */
+export const collapseWhitespace = (text) => text.replace(/\s+/g, " ");
+const noteOnce = (ctx, construct, detail) => {
+    if (ctx.seenConstructs.has(construct))
+        return;
+    ctx.seenConstructs.add(construct);
+    ctx.note(construct, detail);
+};
+/** Elements rendered as inline code (monospace semantics in DITA). */
+const CODE_LIKE = new Set([
+    "codeph", "filepath", "cmdname", "apiname", "varname", "synph", "systemoutput", "userinput", "tt", "parmname",
+    // XML-domain elements (heavy in tooling docs like DITA-OT's)
+    "xmlelement", "xmlatt", "xmlnsname", "xmlpi", "numcharref", "parameterentity", "textentity", "msgph",
+]);
+/** Elements whose semantic identity is dropped; text passes through. */
+const TRANSPARENT = new Set(["ph", "keyword", "text", "option", "msgnum"]);
+const ITALIC_LIKE = new Set(["i", "term", "cite", "q", "var"]);
+const BOLD_LIKE = new Set(["b", "uicontrol", "wintitle", "menucascade", "shortcut"]);
+export const textOf = (nodes) => nodes
+    .map((node) => {
+    if (isText(node))
+        return node.data;
+    if (isElement(node))
+        return textOf(node.children);
+    return "";
+})
+    .join("");
+export const convertInline = (nodes, ctx, formatting = {}) => {
+    const out = [];
+    const pushText = (text) => {
+        if (text.length === 0)
+            return;
+        const prev = out[out.length - 1];
+        // Merge adjacent spans with identical formatting
+        if (prev?.type === "text" &&
+            !!prev.bold === !!formatting.bold &&
+            !!prev.italic === !!formatting.italic &&
+            !!prev.strikethrough === !!formatting.strikethrough) {
+            prev.text += text;
+            return;
+        }
+        const span = { type: "text", text };
+        if (formatting.bold)
+            span.bold = true;
+        if (formatting.italic)
+            span.italic = true;
+        if (formatting.strikethrough)
+            span.strikethrough = true;
+        out.push(span);
+    };
+    for (const node of nodes) {
+        if (isText(node)) {
+            pushText(collapseWhitespace(node.data));
+            continue;
+        }
+        if (!isElement(node))
+            continue;
+        const name = node.name.toLowerCase();
+        const children = node.children;
+        // Filter attributes FIRST: the include/defining-site paths below
+        // `continue` past the rest of the loop, and a profiled element that
+        // becomes an include still needs its condition on the ledger
+        for (const attr of ["audience", "platform", "product", "props", "otherprops", "rev"]) {
+            if (node.attribs?.[attr]) {
+                noteOnce(ctx, `@${attr}`, `<${name}> ${attr}="${node.attribs[attr]}" — map to a profile condition (ifdef) manually`);
+            }
+        }
+        // Defining site: this inline element was extracted into a reuse
+        // snippet — emit the include so one copy of the text survives.
+        // (Escape-wise the include directive passes through verbatim:
+        // the serializer's escapePreservingMinja treats it as an atom.)
+        if (ctx.conref && node.attribs?.id && !node.attribs?.conref && !node.attribs?.conkeyref) {
+            const defining = ctx.conref.definingSnippet(node.attribs.id);
+            if (defining && inlineSafeSnippet(defining)) {
+                pushText(`{% include "${ctx.conref.includePath(defining)}" %}`);
+                continue;
+            }
+        }
+        // Inline conrefs (<ph conref="…"/>) are the standard DITA reused-text
+        // pattern. With a corpus plan the target is spliced back as a minja
+        // include; otherwise (or when splicing is unsafe here) the occurrence
+        // is real content loss and must be on the ledger.
+        if (node.attribs?.conref || node.attribs?.conkeyref) {
+            const ref = node.attribs.conref ?? node.attribs.conkeyref;
+            const snippet = node.attribs.conref && !node.attribs.conrefend && !node.attribs.conaction
+                ? ctx.conref?.resolve(node.attribs.conref)
+                : undefined;
+            if (snippet && inlineSafeSnippet(snippet)) {
+                // Local children are the stale preview copy in DITA conref
+                // semantics — the include replaces the whole element
+                pushText(`{% include "${ctx.conref.includePath(snippet)}" %}`);
+                continue;
+            }
+            ctx.note(node.attribs.conref ? "@conref" : "@conkeyref", `<${name}> pulls content from "${ref}" — ${conrefLedgerDetail(node.attribs, snippet, ctx.conref !== undefined)}`);
+        }
+        // Key-based text reuse (<ph keyref="product-name"/>, <keyword keyref=…>).
+        // Authored fallback content always wins — it is the only text that is
+        // guaranteed to exist (href-only keys have no text to resolve). Only
+        // content-less elements emit the {{ key }} minja variable form.
+        if (node.attribs?.keyref && name !== "xref" && name !== "link" && name !== "image") {
+            const hasFallback = children.some((c) => isElement(c) || (isText(c) && c.data.trim().length > 0));
+            if (!hasFallback) {
+                noteOnce(ctx, "@keyref", "content-less keyref emitted as {{ key }} minja variable — resolves only for TEXT keys (keys.yaml entries with text:); href-only keys need manual attention");
+                pushText(`{{ ${node.attribs.keyref} }}`);
+                continue;
+            }
+            // Fallback content present: note the dropped indirection, then fall
+            // through so the element converts normally (term stays italic, …)
+            noteOnce(ctx, "@keyref", "keyref with fallback content: authored text kept, key indirection dropped — switch to {{ key }} manually where the key text should win");
+        }
+        if (TRANSPARENT.has(name)) {
+            out.push(...convertInline(children, ctx, formatting));
+            continue;
+        }
+        if (CODE_LIKE.has(name)) {
+            if (name !== "codeph" && name !== "tt") {
+                noteOnce(ctx, `<${name}>`, `rendered as inline code — semantic identity not preserved`);
+            }
+            out.push({ type: "code", text: collapseWhitespace(textOf(children)).trim() });
+            continue;
+        }
+        if (BOLD_LIKE.has(name)) {
+            if (name !== "b") {
+                noteOnce(ctx, `<${name}>`, `rendered as bold — semantic identity not preserved`);
+            }
+            out.push(...convertInline(children, ctx, { ...formatting, bold: true }));
+            continue;
+        }
+        if (ITALIC_LIKE.has(name)) {
+            if (name !== "i") {
+                noteOnce(ctx, `<${name}>`, `rendered as italic — semantic identity not preserved`);
+            }
+            out.push(...convertInline(children, ctx, { ...formatting, italic: true }));
+            continue;
+        }
+        if (name === "u") {
+            noteOnce(ctx, "<u>", "underline has no markdown equivalent — rendered as plain text");
+            out.push(...convertInline(children, ctx, formatting));
+            continue;
+        }
+        if (name === "sub" || name === "sup") {
+            noteOnce(ctx, `<${name}>`, "sub/superscript rendered as plain text");
+            out.push(...convertInline(children, ctx, formatting));
+            continue;
+        }
+        if (name === "xref" || name === "link") {
+            const href = node.attribs?.href;
+            const keyref = node.attribs?.keyref;
+            const linkChildren = convertInline(children, ctx, formatting);
+            const fallbackText = collapseWhitespace(textOf(children)).trim();
+            if (keyref) {
+                // Key-based links keep their indirection via the key: scheme
+                // (resolution is the build pipeline's job — see topic-map keys)
+                out.push({
+                    type: "link",
+                    href: `key:${keyref}`,
+                    children: linkChildren.length > 0 ? linkChildren : [{ type: "text", text: keyref }],
+                });
+                continue;
+            }
+            if (href) {
+                const external = /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(href);
+                out.push({
+                    type: "link",
+                    href: external ? href : renameDitaHref(href),
+                    children: linkChildren.length > 0
+                        ? linkChildren
+                        : [{ type: "text", text: fallbackText || href }],
+                });
+                continue;
+            }
+            noteOnce(ctx, `<${name}>`, "xref without href/keyref — emitted as plain text");
+            pushText(fallbackText);
+            continue;
+        }
+        if (name === "image") {
+            const imgHref = node.attribs?.href;
+            if (!imgHref) {
+                if (node.attribs?.keyref) {
+                    ctx.note("@keyref", `<image keyref="${node.attribs.keyref}"/> — key-based images cannot be resolved at conversion; insert the image manually`);
+                }
+                else {
+                    noteOnce(ctx, "<image>", "image without href dropped");
+                }
+                continue;
+            }
+            out.push({
+                type: "image",
+                src: imgHref,
+                ...(node.attribs?.alt ? { alt: node.attribs.alt } : {}),
+            });
+            continue;
+        }
+        if (name === "indexterm" || name === "draft-comment" || name === "data") {
+            noteOnce(ctx, `<${name}>`, "metadata element dropped from output");
+            continue;
+        }
+        // Unknown inline element: keep the text, note the loss
+        noteOnce(ctx, `<${name}>`, "unrecognized inline element — text kept, markup dropped");
+        out.push(...convertInline(children, ctx, formatting));
+    }
+    return mergeAdjacentText(out);
+};
+/** Merge neighbouring text spans with identical formatting (recursive calls
+ * push whole runs, so pushText's local merging alone is not enough). */
+const mergeAdjacentText = (nodes) => {
+    const merged = [];
+    for (const node of nodes) {
+        const prev = merged[merged.length - 1];
+        if (node.type === "text" &&
+            prev?.type === "text" &&
+            !!prev.bold === !!node.bold &&
+            !!prev.italic === !!node.italic &&
+            !!prev.strikethrough === !!node.strikethrough) {
+            prev.text += node.text;
+            continue;
+        }
+        merged.push(node);
+    }
+    return merged;
+};
+/** Trim leading/trailing whitespace-only fringe from an inline run. */
+export const trimInline = (nodes) => {
+    const result = [...nodes];
+    while (result.length > 0) {
+        const first = result[0];
+        if (first.type === "text") {
+            first.text = first.text.replace(/^\s+/, "");
+            if (first.text === "") {
+                result.shift();
+                continue;
+            }
+        }
+        break;
+    }
+    while (result.length > 0) {
+        const last = result[result.length - 1];
+        if (last.type === "text") {
+            last.text = last.text.replace(/\s+$/, "");
+            if (last.text === "") {
+                result.pop();
+                continue;
+            }
+        }
+        break;
+    }
+    return result;
+};
+//# sourceMappingURL=inline.js.map

package/dist/inline.js.map

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

package/dist/markdown.d.ts

@@ -0,0 +1,12 @@
+import type { DitaParseOptions, DitaTopicResult } from "./types.js";
+export interface DitaMarkdownResult extends DitaTopicResult {
+    /** Complete dogsbay-md document: frontmatter + body. */
+    markdown: string;
+}
+/**
+ * Convert a DITA topic to a complete dogsbay-md document. Frontmatter
+ * carries the title, the DITA-derived contentType, and provenance
+ * (`dita.id`, original path) for round-trip.
+ */
+export declare function ditaTopicToDogsbayMd(xml: string, options?: DitaParseOptions): DitaMarkdownResult;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAWpE,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,gBAAqB,GAC7B,kBAAkB,CAoDpB"}

package/dist/markdown.js

@@ -0,0 +1,72 @@
+import { treeToDogsbayMd } from "@dogsbay/format-dogsbay-md";
+import { ditaTopicToTree } from "./parse.js";
+/** DITA topic type → dogsbay contentType frontmatter value. */
+const CONTENT_TYPE_MAP = {
+    concept: "concept",
+    task: "task",
+    reference: "reference",
+    glossentry: "glossary",
+    topic: "topic",
+};
+/**
+ * Convert a DITA topic to a complete dogsbay-md document. Frontmatter
+ * carries the title, the DITA-derived contentType, and provenance
+ * (`dita.id`, original path) for round-trip.
+ */
+export function ditaTopicToDogsbayMd(xml, options = {}) {
+    const result = ditaTopicToTree(xml, options);
+    const frontmatter = {};
+    if (result.meta.title)
+        frontmatter.title = result.meta.title;
+    if (result.meta.ditaType) {
+        frontmatter.contentType = CONTENT_TYPE_MAP[result.meta.ditaType] ?? result.meta.ditaType;
+    }
+    if (result.meta.shortdesc)
+        frontmatter.description = result.meta.shortdesc;
+    if (result.meta.authors?.length) {
+        frontmatter.author = result.meta.authors.length === 1 ? result.meta.authors[0] : result.meta.authors;
+    }
+    if (result.meta.tags?.length)
+        frontmatter.tags = result.meta.tags;
+    if (result.meta.categories?.length) {
+        // dogsbay frontmatter carries a single category — extras are ledgered,
+        // never silently dropped
+        frontmatter.category = result.meta.categories[0];
+        if (result.meta.categories.length > 1) {
+            result.notes.push({
+                topicPath: options.topicPath ?? "",
+                construct: "<prolog>/<category>",
+                detail: `frontmatter carries one category; additional dropped: ${result.meta.categories.slice(1).join(", ")}`,
+            });
+        }
+    }
+    if (result.meta.created)
+        frontmatter.created = result.meta.created;
+    if (result.meta.revised)
+        frontmatter.revised = result.meta.revised;
+    const dita = {};
+    if (result.meta.id)
+        dita.id = result.meta.id;
+    if (options.topicPath)
+        dita.source = options.topicPath;
+    if (Object.keys(dita).length > 0)
+        frontmatter.dita = dita;
+    // The primary topic's id must exist as an in-page anchor: bare-fragment
+    // links (other.md#topicid) are kept by renameDitaHref and target it
+    const tree = result.meta.id
+        ? [
+            {
+                type: "html",
+                html: `<a id="${result.meta.id.replace(/"/g, "&quot;")}"></a>`,
+            },
+            ...result.tree,
+        ]
+        : result.tree;
+    const markdown = treeToDogsbayMd(tree, {
+        frontmatter: Object.keys(frontmatter).length > 0
+            ? frontmatter
+            : undefined,
+    });
+    return { ...result, markdown: markdown.endsWith("\n") ? markdown : `${markdown}\n` };
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,13 @@
+import { type DitaParseOptions, type DitaTopicResult } from "./types.js";
+/**
+ * Convert one DITA topic document to a TreeNode[] block tree plus topic
+ * metadata and a conversion-note ledger. Never throws on content problems.
+ *
+ * The primary topic's <title> becomes `meta.title` (page-level, not a
+ * block); <shortdesc> is both `meta.shortdesc` and the first paragraph.
+ * Additional topics — nested inside the primary or siblings under a
+ * composite (<dita>) wrapper — convert inline as heading-anchored sections,
+ * so multi-topic (chunked) files lose nothing.
+ */
+export declare function ditaTopicToTree(xml: string, options?: DitaParseOptions): DitaTopicResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAC;AAuLpB;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA8H5F"}