@jasonbelmonti/markdown-engine 0.1.0 → 1.0.0

package/dist/api/document-queries.js

@@ -0,0 +1,89 @@
+import { flattenNodes } from "../ir/document-node-walk.js";
+export const documentQueries = {
+    nodes,
+    sections,
+    textSpans,
+    tables,
+    lists,
+    links,
+    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 sourceSlice(document, target) {
+    if (target.kind !== "node") {
+        return undefined;
+    }
+    const section = (document.sections ?? []).find((section) => section.target.id === target.id);
+    if (section !== undefined) {
+        return sourceSlice(document, section.headingTarget);
+    }
+    return flattenNodes(document.children).find((node) => node.target?.id === target.id)?.source;
+}
+//# 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,150 @@
-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 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[];
+    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 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[];
+    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/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;AAIjD,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,iBAGtB,CAAC"}

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,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAiBzD,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"}

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,5 +1,10 @@
+import { assertCompatibleResultVersion, } from "./compatibility.js";
 import { isPlainRecord } from "../internal/plain-record.js";
+export { EngineCompatibilityError, } from "./compatibility.js";
 export const serialize = (result, options = {}) => {
+    if (options.compatibilityMode !== undefined) {
+        assertCompatibleResultVersion(result, options.compatibilityMode);
+    }
     const serialized = JSON.stringify(normalizeSerializableValue(result), null, options.pretty === true ? 2 : 0);
     return serialized ?? "null";
 };

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,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAQ5D,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,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"}

package/dist/cli/args.d.ts

@@ -0,0 +1,14 @@
+import type { EngineDocumentVersion } from "../api/contracts.js";
+export type CliArgsResult = {
+    kind: "run";
+    documentVersion: EngineDocumentVersion;
+    targetPath: string;
+} | {
+    kind: "help";
+} | {
+    kind: "error";
+    message: 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;AAajE,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,eAAe,EAAE,qBAAqB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,eAAO,MAAM,QAAQ,QAUpB,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CA2F1D"}

package/dist/cli/args.js

@@ -0,0 +1,101 @@
+import { cliDocumentVersionUsageValues, defaultCliDocumentVersion, missingCliDocumentVersionMessage, parseCliDocumentVersion, } from "./document-version.js";
+const documentVersionFlag = "--document-version";
+const documentVersionAssignmentPrefix = `${documentVersionFlag}=`;
+const duplicateDocumentVersionMessage = "Expected at most one --document-version selector.";
+export const cliUsage = `Usage: markdown-engine [--document-version <version>] (--file <markdown-file> | --path <markdown-file>)
+
+Runs parse and normalization for one Markdown file and writes normalized JSON.
+Defaults to documentVersion "1.0.0"; use "0.0.0" for legacy output.
+
+Options:
+  --file <markdown-file>         Markdown file to process.
+  --path <markdown-file>         Markdown file to process. Directories are not traversed.
+  --document-version <version>   Output document version (${cliDocumentVersionUsageValues()}).
+  -h, --help                     Show this help message.
+`;
+export function parseCliArgs(args) {
+    const targets = [];
+    let documentVersion;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "-h" || arg === "--help") {
+            return { kind: "help" };
+        }
+        if (arg === "--file" || arg === "--path") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("-")) {
+                return { kind: "error", message: `Missing value for ${arg}.` };
+            }
+            targets.push(value);
+            index += 1;
+            continue;
+        }
+        if (arg === documentVersionFlag ||
+            arg?.startsWith(documentVersionAssignmentPrefix) === true) {
+            if (documentVersion !== undefined) {
+                return {
+                    kind: "error",
+                    message: duplicateDocumentVersionMessage,
+                };
+            }
+            const selectorValue = readDocumentVersionSelectorValue(arg, args, index);
+            if (selectorValue.kind === "error") {
+                return selectorValue;
+            }
+            const parsedDocumentVersion = parseCliDocumentVersion(selectorValue.value);
+            if (parsedDocumentVersion.kind === "error") {
+                return parsedDocumentVersion;
+            }
+            documentVersion = parsedDocumentVersion.documentVersion;
+            if (selectorValue.consumesNextArg) {
+                index += 1;
+            }
+            continue;
+        }
+        if (arg?.startsWith("--file=") === true) {
+            targets.push(arg.slice("--file=".length));
+            continue;
+        }
+        if (arg?.startsWith("--path=") === true) {
+            targets.push(arg.slice("--path=".length));
+            continue;
+        }
+        return { kind: "error", message: `Unknown argument: ${arg ?? ""}` };
+    }
+    if (targets.length === 0) {
+        return {
+            kind: "error",
+            message: "Expected exactly one of --file or --path.",
+        };
+    }
+    if (targets.length > 1) {
+        return {
+            kind: "error",
+            message: "Expected one Markdown file target, received multiple.",
+        };
+    }
+    const [targetPath] = targets;
+    if (targetPath === undefined || targetPath.trim() === "") {
+        return { kind: "error", message: "Target path cannot be empty." };
+    }
+    return {
+        kind: "run",
+        documentVersion: documentVersion ?? defaultCliDocumentVersion,
+        targetPath,
+    };
+}
+function readDocumentVersionSelectorValue(arg, args, index) {
+    if (arg.startsWith(documentVersionAssignmentPrefix)) {
+        return {
+            kind: "ok",
+            value: arg.slice(documentVersionAssignmentPrefix.length),
+            consumesNextArg: false,
+        };
+    }
+    const value = args[index + 1];
+    if (value === undefined || value.startsWith("-")) {
+        return { kind: "error", message: missingCliDocumentVersionMessage };
+    }
+    return { kind: "ok", value, consumesNextArg: true };
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

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

package/dist/cli/document-version.d.ts

@@ -0,0 +1,14 @@
+import type { EngineCompatibilityMode, EngineDocumentVersion } from "../api/contracts.js";
+export declare const defaultCliDocumentVersion = "1.0.0";
+export declare const missingCliDocumentVersionMessage = "Missing value for --document-version.";
+export declare function isCliDocumentVersion(value: string): value is EngineDocumentVersion;
+export declare function cliDocumentVersionUsageValues(): string;
+export declare function parseCliDocumentVersion(value: string): {
+    kind: "ok";
+    documentVersion: EngineDocumentVersion;
+} | {
+    kind: "error";
+    message: string;
+};
+export declare function compatibilityModeForDocumentVersion(documentVersion: EngineDocumentVersion): EngineCompatibilityMode;
+//# sourceMappingURL=document-version.d.ts.map

package/dist/cli/document-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-version.d.ts","sourceRoot":"","sources":["../../src/cli/document-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,yBAAyB,UACG,CAAC;AAE1C,eAAO,MAAM,gCAAgC,0CACJ,CAAC;AAY1C,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,qBAAqB,CAEhC;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAEX;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,eAAe,EAAE,qBAAqB,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAarC;AAED,wBAAgB,mCAAmC,CACjD,eAAe,EAAE,qBAAqB,GACrC,uBAAuB,CAEzB"}

package/dist/cli/document-version.js

@@ -0,0 +1,32 @@
+export const defaultCliDocumentVersion = "1.0.0";
+export const missingCliDocumentVersionMessage = "Missing value for --document-version.";
+const supportedCliDocumentVersions = [
+    "0.0.0",
+    "1.0.0",
+];
+const compatibilityModeByDocumentVersion = {
+    "0.0.0": "legacy-0.1",
+    "1.0.0": "default",
+};
+export function isCliDocumentVersion(value) {
+    return supportedCliDocumentVersions.includes(value);
+}
+export function cliDocumentVersionUsageValues() {
+    return supportedCliDocumentVersions.join(" | ");
+}
+export function parseCliDocumentVersion(value) {
+    if (value.trim() === "") {
+        return { kind: "error", message: missingCliDocumentVersionMessage };
+    }
+    if (!isCliDocumentVersion(value)) {
+        return {
+            kind: "error",
+            message: `Invalid document version: ${value}. Expected one of: ${cliDocumentVersionUsageValues()}.`,
+        };
+    }
+    return { kind: "ok", documentVersion: value };
+}
+export function compatibilityModeForDocumentVersion(documentVersion) {
+    return compatibilityModeByDocumentVersion[documentVersion];
+}
+//# sourceMappingURL=document-version.js.map

package/dist/cli/document-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-version.js","sourceRoot":"","sources":["../../src/cli/document-version.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,yBAAyB,GACpC,OAAuC,CAAC;AAE1C,MAAM,CAAC,MAAM,gCAAgC,GAC3C,uCAAuC,CAAC;AAE1C,MAAM,4BAA4B,GAAG;IACnC,OAAO;IACP,OAAO;CAC4C,CAAC;AAEtD,MAAM,kCAAkC,GAAG;IACzC,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,SAAS;CAC8C,CAAC;AAEnE,MAAM,UAAU,oBAAoB,CAClC,KAAa;IAEb,OAAO,4BAA4B,CAAC,QAAQ,CAAC,KAA8B,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAa;IAIb,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;IACtE,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,6BAA6B,KAAK,sBAAsB,6BAA6B,EAAE,GAAG;SACpG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,eAAsC;IAEtC,OAAO,kCAAkC,CAAC,eAAe,CAAC,CAAC;AAC7D,CAAC"}

package/dist/cli/files.d.ts

@@ -0,0 +1,5 @@
+export declare class CliFileError extends Error {
+    readonly name = "CliFileError";
+}
+export declare function readMarkdownFile(targetPath: string, cwd: string): Promise<string>;
+//# sourceMappingURL=files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":"AAGA,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAkB,IAAI,kBAAkB;CACzC;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/cli/files.js

@@ -0,0 +1,30 @@
+import { readFile, stat } from "node:fs/promises";
+import { resolve } from "node:path";
+export class CliFileError extends Error {
+    name = "CliFileError";
+}
+export async function readMarkdownFile(targetPath, cwd) {
+    const absolutePath = resolve(cwd, targetPath);
+    const targetStat = await readTargetStat(absolutePath, targetPath);
+    if (!targetStat.isFile()) {
+        throw new CliFileError(`Expected a file path for "${targetPath}". Directories are not supported.`);
+    }
+    try {
+        return await readFile(absolutePath, "utf8");
+    }
+    catch (error) {
+        throw new CliFileError(`Unable to read "${targetPath}": ${errorMessage(error)}`);
+    }
+}
+async function readTargetStat(absolutePath, targetPath) {
+    try {
+        return await stat(absolutePath);
+    }
+    catch (error) {
+        throw new CliFileError(`Unable to read "${targetPath}": ${errorMessage(error)}`);
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=files.js.map

package/dist/cli/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,YAAa,SAAQ,KAAK;IACnB,IAAI,GAAG,cAAc,CAAC;CACzC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,GAAW;IAEX,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAElE,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,YAAY,CACpB,6BAA6B,UAAU,mCAAmC,CAC3E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,mBAAmB,UAAU,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,YAAoB,EAAE,UAAkB;IACpE,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,mBAAmB,UAAU,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { runCli } from "./run.js";
+process.exitCode = await runCli({
+    args: process.argv.slice(2),
+    cwd: process.cwd(),
+    stderr: process.stderr,
+    stdout: process.stdout,
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,MAAM,EAAE,OAAO,CAAC,MAAM;CACvB,CAAC,CAAC"}

package/dist/cli/normalize-markdown.d.ts

@@ -0,0 +1,8 @@
+import { type EngineDocumentVersion, type NormalizeResult } from "../api/contracts.js";
+export interface NormalizeMarkdownInput {
+    documentVersion: EngineDocumentVersion;
+    markdown: string;
+    path: string;
+}
+export declare function normalizeMarkdown(input: NormalizeMarkdownInput): NormalizeResult;
+//# sourceMappingURL=normalize-markdown.d.ts.map

package/dist/cli/normalize-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-markdown.d.ts","sourceRoot":"","sources":["../../src/cli/normalize-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,qBAAqB,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,eAAe,CAQjB"}

package/dist/cli/normalize-markdown.js

@@ -0,0 +1,10 @@
+import { normalize, parse, } from "../api/contracts.js";
+export function normalizeMarkdown(input) {
+    const parseResult = parse(input.markdown, {
+        path: input.path,
+    });
+    return normalize(parseResult.parsed, {
+        documentVersion: input.documentVersion,
+    });
+}
+//# sourceMappingURL=normalize-markdown.js.map

package/dist/cli/normalize-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-markdown.js","sourceRoot":"","sources":["../../src/cli/normalize-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,GAGN,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,UAAU,iBAAiB,CAC/B,KAA6B;IAE7B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE;QACxC,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE;QACnC,eAAe,EAAE,KAAK,CAAC,eAAe;KACvC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/run.d.ts

@@ -0,0 +1,11 @@
+export interface TextOutput {
+    write(chunk: string): void | boolean;
+}
+export interface RunCliInput {
+    args: string[];
+    cwd: string;
+    stderr: TextOutput;
+    stdout: TextOutput;
+}
+export declare function runCli(input: RunCliInput): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAkChE"}