@jasonbelmonti/markdown-engine 0.1.0 → 2.0.0

package/dist/api/document-queries.js

@@ -0,0 +1,160 @@
+import { flattenNodes } from "../internal/document-node-walk.js";
+export const documentQueries = {
+    nodes,
+    sections,
+    textSpans,
+    tables,
+    lists,
+    links,
+    linkReferences,
+    targetCategory,
+    resolveTarget,
+    sourceSlice,
+};
+function nodes(document, query = {}) {
+    return flattenNodes(document.children).filter((node) => {
+        if (query.type !== undefined && node.type !== query.type) {
+            return false;
+        }
+        return query.targetId === undefined || node.target?.id === query.targetId;
+    });
+}
+function sections(document, query = {}) {
+    return (document.sections ?? []).filter((section) => {
+        if (query.targetId !== undefined && section.target.id !== query.targetId) {
+            return false;
+        }
+        if (query.headingTargetId !== undefined &&
+            section.headingTarget.id !== query.headingTargetId) {
+            return false;
+        }
+        if (query.parentSectionTargetId !== undefined &&
+            section.parentSection?.id !== query.parentSectionTargetId) {
+            return false;
+        }
+        if (query.title !== undefined && section.title !== query.title) {
+            return false;
+        }
+        return query.depth === undefined || section.depth === query.depth;
+    });
+}
+function textSpans(document, query = {}) {
+    return (document.textSpans ?? []).filter((span) => {
+        if (query.targetId !== undefined && span.target.id !== query.targetId) {
+            return false;
+        }
+        if (query.nodeType !== undefined && span.target.nodeType !== query.nodeType) {
+            return false;
+        }
+        if (query.text !== undefined && span.text !== query.text) {
+            return false;
+        }
+        return (query.textIncludes === undefined ||
+            span.text.includes(query.textIncludes));
+    });
+}
+function tables(document, query = {}) {
+    return (document.tables ?? []).filter((table) => query.targetId === undefined || table.target.id === query.targetId);
+}
+function lists(document, query = {}) {
+    return (document.lists ?? []).filter((list) => {
+        if (query.targetId !== undefined && list.target.id !== query.targetId) {
+            return false;
+        }
+        if (query.ordered !== undefined && list.ordered !== query.ordered) {
+            return false;
+        }
+        return (query.depth === undefined ||
+            list.items.some((item) => item.depth === query.depth));
+    });
+}
+function links(document, query = {}) {
+    return (document.links ?? []).filter((link) => {
+        if (query.targetId !== undefined && link.target.id !== query.targetId) {
+            return false;
+        }
+        if (query.url !== undefined && link.url !== query.url) {
+            return false;
+        }
+        return query.text === undefined || link.text === query.text;
+    });
+}
+function linkReferences(document, query = {}) {
+    return (document.linkReferences ?? []).filter((reference) => {
+        if (query.targetId !== undefined && reference.target.id !== query.targetId) {
+            return false;
+        }
+        if (query.kind !== undefined && reference.kind !== query.kind) {
+            return false;
+        }
+        if (query.url !== undefined && reference.url !== query.url) {
+            return false;
+        }
+        if (query.text !== undefined && reference.text !== query.text) {
+            return false;
+        }
+        if (query.alt !== undefined && reference.alt !== query.alt) {
+            return false;
+        }
+        if (query.label !== undefined && reference.label !== query.label) {
+            return false;
+        }
+        if (query.identifier !== undefined &&
+            reference.identifier !== query.identifier) {
+            return false;
+        }
+        if (query.referenceType !== undefined &&
+            reference.referenceType !== query.referenceType) {
+            return false;
+        }
+        return (query.definitionTargetId === undefined ||
+            reference.definitionTarget?.id === query.definitionTargetId);
+    });
+}
+function sourceSlice(document, target) {
+    const resolution = resolveTarget(document, target);
+    return resolution?.category === "document" ? undefined : resolution?.sourceSlice;
+}
+function targetCategory(document, target) {
+    return resolveTarget(document, target)?.category;
+}
+function resolveTarget(document, target) {
+    if (target.kind !== "node") {
+        return undefined;
+    }
+    if (document.target?.id === target.id) {
+        return {
+            category: "document",
+            target: document.target,
+        };
+    }
+    const section = (document.sections ?? []).find((section) => section.target.id === target.id);
+    if (section !== undefined) {
+        return {
+            category: "section",
+            target: section.target,
+            section,
+            ...sourceSliceProperty(sourceSliceForNodeTarget(document, section.headingTarget)),
+        };
+    }
+    const node = nodeByTargetId(document, target.id);
+    if (node === undefined || node.target === undefined) {
+        return undefined;
+    }
+    return {
+        category: "node",
+        target: node.target,
+        node,
+        ...sourceSliceProperty(node.source),
+    };
+}
+function nodeByTargetId(document, targetId) {
+    return flattenNodes(document.children).find((node) => node.target?.id === targetId);
+}
+function sourceSliceForNodeTarget(document, target) {
+    return nodeByTargetId(document, target.id)?.source;
+}
+function sourceSliceProperty(sourceSlice) {
+    return sourceSlice === undefined ? {} : { sourceSlice };
+}
+//# sourceMappingURL=document-queries.js.map

package/dist/api/document-queries.js.map

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

package/dist/api/document.d.ts

@@ -1,17 +1,194 @@
-import type { SourceRange } from "./diagnostics.js";
+import type { MarkdownDiagnostic, SourceRange } from "./diagnostics.js";
+export type EngineDocumentVersion = "0.0.0" | "1.0.0";
+export type EngineNodeTargetKind = "node";
+export interface EngineNodeTarget {
+    kind: EngineNodeTargetKind;
+    id: string;
+    path?: readonly number[];
+    nodeType?: string;
+    sourceRange?: SourceRange;
+}
+export interface EngineSourceSlice {
+    range: SourceRange;
+    text: string;
+}
 export interface EngineNode {
     type: string;
     text?: string;
     attributes?: Record<string, unknown>;
+    target?: EngineNodeTarget;
     sourceRange?: SourceRange;
+    source?: EngineSourceSlice;
     children?: EngineNode[];
 }
+export interface EngineSection {
+    target: EngineNodeTarget;
+    headingTarget: EngineNodeTarget;
+    parentSection?: EngineNodeTarget;
+    depth: number;
+    title: string;
+    bodyTargets: readonly EngineNodeTarget[];
+    childSections: readonly EngineNodeTarget[];
+}
+export interface EngineTextSpan {
+    target: EngineNodeTarget;
+    text: string;
+    sourceRange?: SourceRange;
+}
+export interface EngineTableCell {
+    target: EngineNodeTarget;
+    text: string;
+    rowIndex: number;
+    columnIndex: number;
+    header: boolean;
+    sourceRange?: SourceRange;
+}
+export interface EngineTable {
+    target: EngineNodeTarget;
+    cells: readonly EngineTableCell[];
+}
+export interface EngineListItem {
+    target: EngineNodeTarget;
+    itemIndex: number;
+    depth: number;
+    checked?: boolean;
+    sourceRange?: SourceRange;
+}
+export interface EngineList {
+    target: EngineNodeTarget;
+    ordered: boolean;
+    start?: number;
+    items: readonly EngineListItem[];
+}
+export interface EngineLink {
+    target: EngineNodeTarget;
+    url: string;
+    text: string;
+    title?: string;
+    sourceRange?: SourceRange;
+}
+export type EngineLinkReferenceKind = "definition" | "image" | "imageReference" | "link" | "linkReference";
+export interface EngineLinkReference {
+    target: EngineNodeTarget;
+    kind: EngineLinkReferenceKind;
+    url?: string;
+    title?: string;
+    text?: string;
+    alt?: string;
+    label?: string;
+    identifier?: string;
+    referenceType?: string;
+    definitionTarget?: EngineNodeTarget;
+    sourceRange?: SourceRange;
+}
+export type EngineAnnotationTarget = {
+    kind: "node";
+    nodeTarget: EngineNodeTarget;
+} | {
+    kind: "source";
+    sourceRange: SourceRange;
+};
+export interface EngineAnnotation<TPayload = unknown> {
+    id: string;
+    target: EngineAnnotationTarget;
+    payload: TPayload;
+}
+export interface EngineCompatibilityGate {
+    mode: "default" | "legacy-0.1";
+    reason?: string;
+}
+export interface EngineTargetDiagnostic extends MarkdownDiagnostic {
+    target?: unknown;
+}
 export interface EngineDocument {
     kind: "markdown-document";
-    version: "0.0.0";
+    version: EngineDocumentVersion;
     path?: string;
     frontmatter?: unknown;
+    target?: EngineNodeTarget;
     children: EngineNode[];
     sourceRange?: SourceRange;
+    sections?: readonly EngineSection[];
+    textSpans?: readonly EngineTextSpan[];
+    tables?: readonly EngineTable[];
+    lists?: readonly EngineList[];
+    links?: readonly EngineLink[];
+    linkReferences?: readonly EngineLinkReference[];
+    annotations?: readonly EngineAnnotation[];
+    compatibility?: EngineCompatibilityGate;
+}
+export interface EngineNodeQuery {
+    type?: string;
+    targetId?: string;
+}
+export interface EngineSectionQuery {
+    targetId?: string;
+    headingTargetId?: string;
+    parentSectionTargetId?: string;
+    title?: string;
+    depth?: number;
+}
+export interface EngineTextSpanQuery {
+    targetId?: string;
+    nodeType?: string;
+    text?: string;
+    textIncludes?: string;
+}
+export interface EngineTableQuery {
+    targetId?: string;
+}
+export interface EngineListQuery {
+    targetId?: string;
+    depth?: number;
+    ordered?: boolean;
+}
+export interface EngineLinkQuery {
+    targetId?: string;
+    url?: string;
+    text?: string;
+}
+export interface EngineLinkReferenceQuery {
+    targetId?: string;
+    kind?: EngineLinkReferenceKind;
+    url?: string;
+    text?: string;
+    alt?: string;
+    label?: string;
+    identifier?: string;
+    referenceType?: string;
+    definitionTargetId?: string;
+}
+export type EngineTargetCategory = "document" | "node" | "section";
+export type EngineTargetResolution = {
+    category: "document";
+    target: EngineNodeTarget;
+} | {
+    category: "node";
+    target: EngineNodeTarget;
+    node: EngineNode;
+    sourceSlice?: EngineSourceSlice;
+} | {
+    category: "section";
+    target: EngineNodeTarget;
+    section: EngineSection;
+    sourceSlice?: EngineSourceSlice;
+};
+export interface EngineDocumentQueries {
+    nodes(document: EngineDocument, query?: EngineNodeQuery): readonly EngineNode[];
+    sections(document: EngineDocument, query?: EngineSectionQuery): readonly EngineSection[];
+    textSpans(document: EngineDocument, query?: EngineTextSpanQuery): readonly EngineTextSpan[];
+    tables(document: EngineDocument, query?: EngineTableQuery): readonly EngineTable[];
+    lists(document: EngineDocument, query?: EngineListQuery): readonly EngineList[];
+    links(document: EngineDocument, query?: EngineLinkQuery): readonly EngineLink[];
+    linkReferences(document: EngineDocument, query?: EngineLinkReferenceQuery): readonly EngineLinkReference[];
+    targetCategory(document: EngineDocument, target: EngineNodeTarget): EngineTargetCategory | undefined;
+    resolveTarget(document: EngineDocument, target: EngineNodeTarget): EngineTargetResolution | undefined;
+    sourceSlice(document: EngineDocument, target: EngineNodeTarget): EngineSourceSlice | undefined;
+}
+export interface AnnotationValidationResult {
+    valid: boolean;
+    annotations: readonly EngineAnnotation[];
+    diagnostics: readonly EngineTargetDiagnostic[];
 }
+export type SerializableEngineResult = EngineDocument | AnnotationValidationResult;
 //# sourceMappingURL=document.d.ts.map

package/dist/api/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/api/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/api/document.ts"],"names":[],"mappings":"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"}

package/dist/api/engine-node-attributes.d.ts

@@ -0,0 +1,15 @@
+import type { EngineNode } from "./document.js";
+export type EngineCodeBlockKind = "fenced" | "indented";
+export type EngineTableAlignment = "left" | "right" | "center" | null;
+export declare function headingDepth(node: EngineNode): number | undefined;
+export declare function linkUrl(node: EngineNode): string | undefined;
+export declare function linkTitle(node: EngineNode): string | undefined;
+export declare function codeBlockKind(node: EngineNode): EngineCodeBlockKind | undefined;
+export declare function isFencedCodeBlock(node: EngineNode): boolean;
+export declare function codeLanguage(node: EngineNode): string | undefined;
+export declare function listOrdered(node: EngineNode): boolean | undefined;
+export declare function isOrderedList(node: EngineNode): boolean;
+export declare function listStart(node: EngineNode): number | undefined;
+export declare function listItemChecked(node: EngineNode): boolean | undefined;
+export declare function tableAlignments(node: EngineNode): readonly EngineTableAlignment[] | undefined;
+//# sourceMappingURL=engine-node-attributes.d.ts.map

package/dist/api/engine-node-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-node-attributes.d.ts","sourceRoot":"","sources":["../../src/api/engine-node-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,UAAU,CAAC;AACxD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEtE,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAMjE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAM5D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAM9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,GAAG,SAAS,CAQ/E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAE3D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAMjE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAMjE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEvD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAM9D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAMrE;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,GACf,SAAS,oBAAoB,EAAE,GAAG,SAAS,CAsB7C"}

package/dist/api/engine-node-attributes.js

@@ -0,0 +1,99 @@
+export function headingDepth(node) {
+    if (node.type !== "heading") {
+        return undefined;
+    }
+    return numberAttribute(node, "depth");
+}
+export function linkUrl(node) {
+    if (!hasLinkAttributes(node)) {
+        return undefined;
+    }
+    return stringAttribute(node, "url");
+}
+export function linkTitle(node) {
+    if (!hasLinkAttributes(node)) {
+        return undefined;
+    }
+    return stringAttribute(node, "title");
+}
+export function codeBlockKind(node) {
+    if (node.type !== "code") {
+        return undefined;
+    }
+    const kind = stringAttribute(node, "kind");
+    return isCodeBlockKind(kind) ? kind : undefined;
+}
+export function isFencedCodeBlock(node) {
+    return codeBlockKind(node) === "fenced";
+}
+export function codeLanguage(node) {
+    if (node.type !== "code") {
+        return undefined;
+    }
+    return stringAttribute(node, "lang");
+}
+export function listOrdered(node) {
+    if (node.type !== "list") {
+        return undefined;
+    }
+    return booleanAttribute(node, "ordered");
+}
+export function isOrderedList(node) {
+    return listOrdered(node) === true;
+}
+export function listStart(node) {
+    if (node.type !== "list") {
+        return undefined;
+    }
+    return numberAttribute(node, "start");
+}
+export function listItemChecked(node) {
+    if (node.type !== "listItem") {
+        return undefined;
+    }
+    return booleanAttribute(node, "checked");
+}
+export function tableAlignments(node) {
+    if (node.type !== "table") {
+        return undefined;
+    }
+    const alignments = node.attributes?.align;
+    if (!Array.isArray(alignments)) {
+        return undefined;
+    }
+    const typedAlignments = [];
+    for (const alignment of alignments) {
+        if (!isTableAlignment(alignment)) {
+            return undefined;
+        }
+        typedAlignments.push(alignment);
+    }
+    return typedAlignments;
+}
+function hasLinkAttributes(node) {
+    return (node.type === "definition" ||
+        node.type === "image" ||
+        node.type === "link");
+}
+function stringAttribute(node, name) {
+    const value = node.attributes?.[name];
+    return typeof value === "string" ? value : undefined;
+}
+function numberAttribute(node, name) {
+    const value = node.attributes?.[name];
+    return typeof value === "number" ? value : undefined;
+}
+function booleanAttribute(node, name) {
+    const value = node.attributes?.[name];
+    return typeof value === "boolean" ? value : undefined;
+}
+function isCodeBlockKind(value) {
+    return value === "fenced" || value === "indented";
+}
+function isTableAlignment(value) {
+    return (value === "left" ||
+        value === "right" ||
+        value === "center" ||
+        value === null);
+}
+//# sourceMappingURL=engine-node-attributes.js.map

package/dist/api/engine-node-attributes.js.map

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

package/dist/api/normalize.d.ts

@@ -1,7 +1,8 @@
 import type { MarkdownDiagnostic } from "./diagnostics.js";
-import type { EngineDocument } from "./document.js";
+import type { EngineDocument, EngineDocumentVersion } from "./document.js";
 import type { ParsedMarkdown } from "./parse.js";
 export interface NormalizeOptions {
+    documentVersion?: EngineDocumentVersion;
     preserveSourceLocations?: boolean;
 }
 export interface NormalizeResult {

package/dist/api/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/api/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,gBAAgB,KACvB,eAAe,CAAC;AAErB,eAAO,MAAM,SAAS,EAAE,iBAGtB,CAAC"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/api/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASjD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,gBAAgB,KACvB,eAAe,CAAC;AAErB,eAAO,MAAM,SAAS,EAAE,iBAMtB,CAAC"}

package/dist/api/normalize.js

@@ -1,7 +1,28 @@
 import { cloneDiagnostics } from "../diagnostics/index.js";
+import { hasOwnProperty } from "../internal/plain-record.js";
 import { normalizeParsedMarkdown } from "../ir/index.js";
 export const normalize = (parsed, options = {}) => ({
-    document: normalizeParsedMarkdown(parsed, options),
+    document: normalizeParsedMarkdown(toNormalizationInput(parsed), toNormalizationOptions(options)),
     diagnostics: cloneDiagnostics(parsed.diagnostics),
 });
+function toNormalizationInput(parsed) {
+    return {
+        markdown: parsed.markdown,
+        ...(parsed.path !== undefined ? { path: parsed.path } : {}),
+        ...(hasOwnProperty(parsed, "frontmatter")
+            ? { frontmatter: parsed.frontmatter }
+            : {}),
+        document: parsed.document,
+    };
+}
+function toNormalizationOptions(options) {
+    return {
+        ...(options.documentVersion !== undefined
+            ? { documentVersion: options.documentVersion }
+            : {}),
+        ...(options.preserveSourceLocations !== undefined
+            ? { preserveSourceLocations: options.preserveSourceLocations }
+            : {}),
+    };
+}
 //# sourceMappingURL=normalize.js.map

package/dist/api/normalize.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/api/normalize.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAgBzD,MAAM,CAAC,MAAM,SAAS,GAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,QAAQ,EAAE,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC;IAClD,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC;CAClD,CAAC,CAAC"}
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/api/normalize.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAqBzD,MAAM,CAAC,MAAM,SAAS,GAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,QAAQ,EAAE,uBAAuB,CAC/B,oBAAoB,CAAC,MAAM,CAAC,EAC5B,sBAAsB,CAAC,OAAO,CAAC,CAChC;IACD,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC;CAClD,CAAC,CAAC;AAEH,SAAS,oBAAoB,CAAC,MAAsB;IAClD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC;YACvC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE;YACrC,CAAC,CAAC,EAAE,CAAC;QACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,OAAyB;IAEzB,OAAO;QACL,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,CAAC,uBAAuB,KAAK,SAAS;YAC/C,CAAC,CAAC,EAAE,uBAAuB,EAAE,OAAO,CAAC,uBAAuB,EAAE;YAC9D,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

package/dist/api/serialize.d.ts

@@ -1,9 +1,13 @@
+import { type EngineCompatibilityMode } from "./compatibility.js";
+import type { SerializableEngineResult } from "./document.js";
 import type { NormalizeResult } from "./normalize.js";
 import type { ParseResult } from "./parse.js";
 import type { ValidationResult } from "./validate.js";
-export type SerializableMarkdownEngineResult = ParseResult | NormalizeResult | ValidationResult;
+export type SerializableMarkdownEngineResult = ParseResult | NormalizeResult | ValidationResult | SerializableEngineResult;
+export { EngineCompatibilityError, type EngineCompatibilityMode, } from "./compatibility.js";
 export interface SerializeOptions {
     pretty?: boolean;
+    compatibilityMode?: EngineCompatibilityMode;
 }
 export type SerializeFunction = (result: SerializableMarkdownEngineResult, options?: SerializeOptions) => string;
 export declare const serialize: SerializeFunction;

package/dist/api/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/api/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,MAAM,MAAM,gCAAgC,GACxC,WAAW,GACX,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,gCAAgC,EACxC,OAAO,CAAC,EAAE,gBAAgB,KACvB,MAAM,CAAC;AAEZ,eAAO,MAAM,SAAS,EAAE,iBAQvB,CAAC"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/api/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,MAAM,MAAM,gCAAgC,GACxC,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,wBAAwB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;CAC7C;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,gCAAgC,EACxC,OAAO,CAAC,EAAE,gBAAgB,KACvB,MAAM,CAAC;AAEZ,eAAO,MAAM,SAAS,EAAE,iBAYvB,CAAC"}

package/dist/api/serialize.js

@@ -1,18 +1,11 @@
-import { isPlainRecord } from "../internal/plain-record.js";
+import { assertCompatibleResultVersion, } from "./compatibility.js";
+import { normalizeStableJsonValue } from "../internal/stable-json.js";
+export { EngineCompatibilityError, } from "./compatibility.js";
 export const serialize = (result, options = {}) => {
-    const serialized = JSON.stringify(normalizeSerializableValue(result), null, options.pretty === true ? 2 : 0);
+    if (options.compatibilityMode !== undefined) {
+        assertCompatibleResultVersion(result, options.compatibilityMode);
+    }
+    const serialized = JSON.stringify(normalizeStableJsonValue(result), null, options.pretty === true ? 2 : 0);
     return serialized ?? "null";
 };
-function normalizeSerializableValue(value) {
-    if (Array.isArray(value)) {
-        return value.map((item) => normalizeSerializableValue(item));
-    }
-    if (isPlainRecord(value)) {
-        return Object.fromEntries(Object.keys(value)
-            .filter((key) => value[key] !== undefined)
-            .sort()
-            .map((key) => [key, normalizeSerializableValue(value[key])]));
-    }
-    return value;
-}
 //# sourceMappingURL=serialize.js.map

package/dist/api/serialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/api/serialize.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAgB5D,MAAM,CAAC,MAAM,SAAS,GAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;IACnE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAC/B,0BAA0B,CAAC,MAAM,CAAC,EAClC,IAAI,EACJ,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChC,CAAC;IAEF,OAAO,UAAU,IAAI,MAAM,CAAC;AAC9B,CAAC,CAAC;AAEF,SAAS,0BAA0B,CAAC,KAAc;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aACf,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;aACzC,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAC/D,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/api/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,GAE9B,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAQtE,OAAO,EACL,wBAAwB,GAEzB,MAAM,oBAAoB,CAAC;AAY5B,MAAM,CAAC,MAAM,SAAS,GAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;IACnE,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC5C,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAC/B,wBAAwB,CAAC,MAAM,CAAC,EAChC,IAAI,EACJ,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChC,CAAC;IAEF,OAAO,UAAU,IAAI,MAAM,CAAC;AAC9B,CAAC,CAAC"}

package/dist/cli/args.d.ts

@@ -0,0 +1,18 @@
+import type { EngineDocumentVersion } from "../api/contracts.js";
+import { type ValidateCliArgs } from "./validate-args.js";
+export type CliArgsResult = {
+    kind: "normalize";
+    documentVersion: EngineDocumentVersion;
+    targetPath: string;
+} | ValidateCliArgs | {
+    kind: "help";
+    usage: string;
+} | {
+    kind: "error";
+    message: string;
+    usage: string;
+};
+export declare const normalizeCliUsage: string;
+export declare const cliUsage: string;
+export declare function parseCliArgs(args: string[]): CliArgsResult;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAOjE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAY5B,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,eAAe,EAAE,qBAAqB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB,GACD,eAAe,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,eAAO,MAAM,iBAAiB,QAU7B,CAAC;AAEF,eAAO,MAAM,QAAQ,QACD,CAAC;AAErB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAM1D"}