@jasonbelmonti/markdown-engine 0.1.0 → 1.0.0

package/dist/api/annotation-target-validation.js

@@ -0,0 +1,414 @@
+import { documentQueries } from "./document-queries.js";
+import { arrayLength, FUNCTION_PLACEHOLDER, isArray, isPlainObject, MAX_NORMALIZED_ARRAY_LENGTH, normalizeRuntimeValue, ownDataProperty, ownRuntimeProperty, UNAVAILABLE_PLACEHOLDER, } from "./annotation-target-runtime.js";
+export function annotationTargetDiagnostics(document, annotations) {
+    const validTargetIds = documentTargetIds(document);
+    const documentSourceRange = document.sourceRange !== undefined
+        ? cloneSourceRangeCandidate(document.sourceRange)
+        : undefined;
+    return annotations
+        .flatMap((annotation, order) => diagnosticsForAnnotation(annotation.target, validTargetIds, documentSourceRange, order))
+        .sort(compareSortableDiagnostics)
+        .map(({ diagnostic }) => diagnostic);
+}
+function documentTargetIds(document) {
+    return new Set([
+        ...(document.target !== undefined ? [document.target.id] : []),
+        ...(document.sections ?? []).map((section) => section.target.id),
+        ...documentQueries
+            .nodes(document)
+            .map((node) => node.target?.id)
+            .filter((id) => id !== undefined),
+    ]);
+}
+function diagnosticsForAnnotation(target, validTargetIds, documentSourceRange, order) {
+    if (!isAnnotationTargetCandidate(target)) {
+        return [
+            sortableDiagnostic({
+                code: "annotation.target.invalidKind",
+                message: "Annotation target kind must be 'node' or 'source'.",
+                severity: "error",
+                target,
+            }, order),
+        ];
+    }
+    const kind = annotationTargetKind(target);
+    if (kind === "node") {
+        return nodeTargetDiagnostics(target, validTargetIds, documentSourceRange, order);
+    }
+    if (kind === "source") {
+        return sourceTargetDiagnostics(target, documentSourceRange, order);
+    }
+    return [
+        sortableDiagnostic({
+            code: "annotation.target.invalidKind",
+            message: "Annotation target kind must be 'node' or 'source'.",
+            severity: "error",
+            target,
+        }, order),
+    ];
+}
+function nodeTargetDiagnostics(target, validTargetIds, documentSourceRange, order) {
+    const nodeTarget = cloneEngineTargetCandidate(annotationNodeTarget(target));
+    if (nodeTarget === undefined) {
+        return [
+            sortableDiagnostic({
+                code: "annotation.target.invalidKind",
+                message: "Annotation node target must reference an engine node target.",
+                severity: "error",
+                target,
+            }, order),
+        ];
+    }
+    const sourceRangeDiagnostic = nodeTargetSourceRangeDiagnostic(target, nodeTarget, documentSourceRange, order);
+    if (sourceRangeDiagnostic !== undefined) {
+        return [sourceRangeDiagnostic];
+    }
+    if (validTargetIds.has(nodeTarget.id)) {
+        return [];
+    }
+    return [
+        sortableDiagnostic({
+            code: "annotation.target.unknown",
+            message: `Annotation target '${nodeTarget.id}' does not exist in the document.`,
+            severity: "error",
+            ...(nodeTarget.sourceRange !== undefined
+                ? { sourceRange: cloneSourceRange(nodeTarget.sourceRange) }
+                : {}),
+            target,
+        }, order),
+    ];
+}
+function nodeTargetSourceRangeDiagnostic(target, nodeTarget, documentSourceRange, order) {
+    if (nodeTarget.sourceRange === undefined) {
+        return undefined;
+    }
+    if (sourceRangeIsInvalid(nodeTarget.sourceRange)) {
+        return sortableDiagnostic({
+            code: "annotation.target.invalidRange",
+            message: "Annotation node target source range ends before it starts.",
+            severity: "error",
+            sourceRange: cloneSourceRange(nodeTarget.sourceRange),
+            target,
+        }, order);
+    }
+    if (documentSourceRange !== undefined &&
+        !sourceRangeContains(documentSourceRange, nodeTarget.sourceRange)) {
+        return sortableDiagnostic({
+            code: "annotation.target.outOfBounds",
+            message: "Annotation node target source range must be contained by the document source range.",
+            severity: "error",
+            sourceRange: cloneSourceRange(nodeTarget.sourceRange),
+            target,
+        }, order);
+    }
+    return undefined;
+}
+function sourceTargetDiagnostics(target, documentSourceRange, order) {
+    const range = cloneSourceRangeCandidate(annotationSourceRange(target));
+    if (range === undefined) {
+        return [
+            sortableDiagnostic({
+                code: "annotation.target.invalidRange",
+                message: "Annotation source target range must include start and end positions.",
+                severity: "error",
+                target,
+            }, order),
+        ];
+    }
+    if (sourceRangeIsInvalid(range)) {
+        return [
+            sortableDiagnostic({
+                code: "annotation.target.invalidRange",
+                message: "Annotation source target range ends before it starts.",
+                severity: "error",
+                sourceRange: cloneSourceRange(range),
+                target,
+            }, order),
+        ];
+    }
+    if (documentSourceRange !== undefined &&
+        !sourceRangeContains(documentSourceRange, range)) {
+        return [
+            sortableDiagnostic({
+                code: "annotation.target.outOfBounds",
+                message: "Annotation source target range must be contained by the document source range.",
+                severity: "error",
+                sourceRange: cloneSourceRange(range),
+                target,
+            }, order),
+        ];
+    }
+    return [];
+}
+function sortableDiagnostic(diagnostic, order) {
+    return {
+        diagnostic: {
+            ...diagnostic,
+            target: cloneDiagnosticTarget(diagnostic.target),
+        },
+        order,
+    };
+}
+function compareSortableDiagnostics(left, right) {
+    return (compareOptionalSourceRange(left.diagnostic.sourceRange, right.diagnostic.sourceRange) ||
+        compareStrings(left.diagnostic.code, right.diagnostic.code) ||
+        compareStrings(left.diagnostic.message, right.diagnostic.message) ||
+        compareStrings(targetSortKey(left.diagnostic.target), targetSortKey(right.diagnostic.target)) ||
+        left.order - right.order);
+}
+function compareOptionalSourceRange(left, right) {
+    if (left === undefined && right === undefined) {
+        return 0;
+    }
+    if (left === undefined) {
+        return 1;
+    }
+    if (right === undefined) {
+        return -1;
+    }
+    return (compareSourcePositions(left.start, right.start) ||
+        compareSourcePositions(left.end, right.end));
+}
+function compareSourcePositions(left, right) {
+    return (left.line - right.line ||
+        left.column - right.column ||
+        compareOptionalOffsets(left.offset, right.offset));
+}
+function compareOptionalOffsets(left, right) {
+    if (left === undefined && right === undefined) {
+        return 0;
+    }
+    if (left === undefined) {
+        return 1;
+    }
+    if (right === undefined) {
+        return -1;
+    }
+    return left - right;
+}
+function compareStrings(left, right) {
+    if (left < right) {
+        return -1;
+    }
+    if (left > right) {
+        return 1;
+    }
+    return 0;
+}
+function targetSortKey(target) {
+    try {
+        const serialized = JSON.stringify(normalizeRuntimeValue(target));
+        return serialized ?? String(target);
+    }
+    catch {
+        if (typeof target === "function") {
+            return FUNCTION_PLACEHOLDER;
+        }
+        if (typeof target === "object" && target !== null) {
+            return UNAVAILABLE_PLACEHOLDER;
+        }
+        return String(target);
+    }
+}
+function serializableTarget(target) {
+    return normalizeRuntimeValue(target);
+}
+function annotationTargetKind(target) {
+    return ownDataProperty(target, "kind");
+}
+function annotationNodeTarget(target) {
+    return ownDataProperty(target, "nodeTarget");
+}
+function annotationSourceRange(target) {
+    return ownDataProperty(target, "sourceRange");
+}
+export function cloneAnnotationTarget(target) {
+    if (isAnnotationTargetCandidate(target)) {
+        const clonedTarget = cloneKnownAnnotationTarget(target);
+        if (clonedTarget !== undefined) {
+            return clonedTarget;
+        }
+    }
+    return serializableTarget(target);
+}
+function cloneDiagnosticTarget(target) {
+    if (isAnnotationTargetCandidate(target)) {
+        const clonedTarget = cloneKnownAnnotationTarget(target);
+        if (clonedTarget !== undefined) {
+            return clonedTarget;
+        }
+    }
+    return serializableTarget(target);
+}
+function cloneKnownAnnotationTarget(target) {
+    const kind = annotationTargetKind(target);
+    if (kind === "node") {
+        const nodeTarget = cloneEngineTargetCandidate(annotationNodeTarget(target));
+        if (nodeTarget === undefined) {
+            return undefined;
+        }
+        return {
+            kind: "node",
+            nodeTarget,
+        };
+    }
+    if (kind === "source") {
+        const sourceRange = cloneSourceRangeCandidate(annotationSourceRange(target));
+        if (sourceRange === undefined) {
+            return undefined;
+        }
+        return {
+            kind: "source",
+            sourceRange,
+        };
+    }
+    return undefined;
+}
+function cloneEngineTargetCandidate(target) {
+    if (!isPlainObject(target)) {
+        return undefined;
+    }
+    const kind = ownDataProperty(target, "kind");
+    const id = ownDataProperty(target, "id");
+    const pathProperty = ownRuntimeProperty(target, "path");
+    const nodeTypeProperty = ownRuntimeProperty(target, "nodeType");
+    const sourceRangeProperty = ownRuntimeProperty(target, "sourceRange");
+    const path = optionalDataPropertyValue(pathProperty);
+    const nodeType = optionalDataPropertyValue(nodeTypeProperty);
+    const sourceRange = optionalDataPropertyValue(sourceRangeProperty);
+    if (kind !== "node" || typeof id !== "string") {
+        return undefined;
+    }
+    const pathClone = path !== undefined ? cloneTargetPathCandidate(path) : undefined;
+    const clonedSourceRange = sourceRange !== undefined ? cloneSourceRangeCandidate(sourceRange) : undefined;
+    if (pathProperty.kind === "accessor" ||
+        optionalDataPropertyIsInvalid(nodeTypeProperty) ||
+        optionalDataPropertyIsInvalid(sourceRangeProperty) ||
+        pathClone?.kind === "invalid" ||
+        (nodeType !== undefined && typeof nodeType !== "string") ||
+        (sourceRange !== undefined && clonedSourceRange === undefined)) {
+        return undefined;
+    }
+    return {
+        kind,
+        id,
+        ...(pathClone?.kind === "cloned" ? { path: pathClone.path } : {}),
+        ...(typeof nodeType === "string" ? { nodeType } : {}),
+        ...(clonedSourceRange !== undefined ? { sourceRange: clonedSourceRange } : {}),
+    };
+}
+function cloneTargetPathCandidate(path) {
+    if (!isArray(path)) {
+        return { kind: "invalid" };
+    }
+    const length = arrayLength(path);
+    if (length === undefined) {
+        return { kind: "unavailable" };
+    }
+    if (length > MAX_NORMALIZED_ARRAY_LENGTH) {
+        return { kind: "unavailable" };
+    }
+    const clonedPath = [];
+    for (let index = 0; index < length; index += 1) {
+        const segmentProperty = ownRuntimeProperty(path, String(index));
+        if (segmentProperty.kind === "unavailable") {
+            return { kind: "unavailable" };
+        }
+        if (segmentProperty.kind !== "data") {
+            return { kind: "invalid" };
+        }
+        if (!isNonNegativeInteger(segmentProperty.value)) {
+            return { kind: "invalid" };
+        }
+        clonedPath.push(segmentProperty.value);
+    }
+    return { kind: "cloned", path: clonedPath };
+}
+function cloneSourceRangeCandidate(range) {
+    if (!isPlainObject(range)) {
+        return undefined;
+    }
+    const start = cloneSourcePositionCandidate(ownDataProperty(range, "start"));
+    const end = cloneSourcePositionCandidate(ownDataProperty(range, "end"));
+    if (start === undefined || end === undefined) {
+        return undefined;
+    }
+    return { start, end };
+}
+function cloneSourceRange(sourceRange) {
+    return {
+        start: cloneSourcePosition(sourceRange.start),
+        end: cloneSourcePosition(sourceRange.end),
+    };
+}
+function cloneSourcePosition(position) {
+    return {
+        line: position.line,
+        column: position.column,
+        ...(position.offset !== undefined ? { offset: position.offset } : {}),
+    };
+}
+function cloneSourcePositionCandidate(position) {
+    if (!isPlainObject(position)) {
+        return undefined;
+    }
+    const line = ownDataProperty(position, "line");
+    const column = ownDataProperty(position, "column");
+    const offsetProperty = ownRuntimeProperty(position, "offset");
+    const offset = optionalDataPropertyValue(offsetProperty);
+    if (!isPositiveInteger(line) ||
+        !isPositiveInteger(column) ||
+        optionalDataPropertyIsInvalid(offsetProperty) ||
+        (offset !== undefined && !isNonNegativeInteger(offset))) {
+        return undefined;
+    }
+    return {
+        line,
+        column,
+        ...(offset !== undefined ? { offset } : {}),
+    };
+}
+function isAnnotationTargetCandidate(target) {
+    return typeof target === "object" && target !== null && !isArray(target);
+}
+function optionalDataPropertyValue(property) {
+    return property.kind === "data" ? property.value : undefined;
+}
+function optionalDataPropertyIsInvalid(property) {
+    return property.kind === "accessor" || property.kind === "unavailable";
+}
+function isPositiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 1;
+}
+function isNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function sourceRangeIsInvalid(range) {
+    return (compareLineAndColumn(range.end, range.start) < 0 ||
+        sourceOffsetsAreInvalid(range));
+}
+function sourceRangeContains(container, target) {
+    return (compareLineAndColumn(container.start, target.start) <= 0 &&
+        compareLineAndColumn(target.end, container.end) <= 0 &&
+        sourceOffsetsAreContained(container, target));
+}
+function compareLineAndColumn(left, right) {
+    return left.line - right.line || left.column - right.column;
+}
+function sourceOffsetsAreInvalid(range) {
+    return (range.start.offset !== undefined &&
+        range.end.offset !== undefined &&
+        range.end.offset < range.start.offset);
+}
+function sourceOffsetsAreContained(container, target) {
+    return (sourceOffsetIsContained(container, target.start.offset) &&
+        sourceOffsetIsContained(container, target.end.offset));
+}
+function sourceOffsetIsContained(container, offset) {
+    if (offset === undefined) {
+        return true;
+    }
+    return ((container.start.offset === undefined || container.start.offset <= offset) &&
+        (container.end.offset === undefined || offset <= container.end.offset));
+}
+//# sourceMappingURL=annotation-target-validation.js.map

package/dist/api/annotation-target-validation.js.map

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

package/dist/api/annotations.d.ts

@@ -0,0 +1,4 @@
+import type { AnnotationValidationResult, EngineAnnotation, EngineDocument } from "./document.js";
+export type ValidateAnnotationsFunction = (document: EngineDocument, annotations: readonly EngineAnnotation[]) => AnnotationValidationResult;
+export declare const validateAnnotations: ValidateAnnotationsFunction;
+//# sourceMappingURL=annotations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/api/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,cAAc,EACf,MAAM,eAAe,CAAC;AAMvB,MAAM,MAAM,2BAA2B,GAAG,CACxC,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,SAAS,gBAAgB,EAAE,KACrC,0BAA0B,CAAC;AAEhC,eAAO,MAAM,mBAAmB,EAAE,2BAWjC,CAAC"}

package/dist/api/annotations.js

@@ -0,0 +1,16 @@
+import { annotationTargetDiagnostics, cloneAnnotationTarget, } from "./annotation-target-validation.js";
+export const validateAnnotations = (document, annotations) => {
+    const diagnostics = annotationTargetDiagnostics(document, annotations);
+    return {
+        valid: diagnostics.length === 0,
+        annotations: annotations.map((annotation) => cloneAnnotation(annotation)),
+        diagnostics,
+    };
+};
+function cloneAnnotation(annotation) {
+    return {
+        ...annotation,
+        target: cloneAnnotationTarget(annotation.target),
+    };
+}
+//# sourceMappingURL=annotations.js.map

package/dist/api/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/api/annotations.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAO3C,MAAM,CAAC,MAAM,mBAAmB,GAAgC,CAC9D,QAAQ,EACR,WAAW,EACX,EAAE;IACF,MAAM,WAAW,GAAG,2BAA2B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEvE,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;QAC/B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACzE,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC;AAEF,SAAS,eAAe,CACtB,UAAsC;IAEtC,OAAO;QACL,GAAG,UAAU;QACb,MAAM,EAAE,qBAAqB,CAAC,UAAU,CAAC,MAAM,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/dist/api/compatibility.d.ts

@@ -0,0 +1,15 @@
+import type { EngineDocumentVersion } from "./document.js";
+export type EngineCompatibilityMode = "default" | "legacy-0.1";
+export declare class EngineCompatibilityError extends Error {
+    readonly code = "engine.compatibility.versionMismatch";
+    readonly requestedMode: EngineCompatibilityMode;
+    readonly expectedVersion: EngineDocumentVersion;
+    readonly actualVersion: string;
+    constructor(details: {
+        requestedMode: EngineCompatibilityMode;
+        expectedVersion: EngineDocumentVersion;
+        actualVersion: string;
+    });
+}
+export declare function assertCompatibleResultVersion(result: unknown, requestedMode: EngineCompatibilityMode): void;
+//# sourceMappingURL=compatibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/api/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAK3D,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,YAAY,CAAC;AAE/D,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,0CAA0C;IACvD,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE;QACnB,aAAa,EAAE,uBAAuB,CAAC;QACvC,eAAe,EAAE,qBAAqB,CAAC;QACvC,aAAa,EAAE,MAAM,CAAC;KACvB;CASF;AAOD,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,uBAAuB,GACrC,IAAI,CAgBN"}

package/dist/api/compatibility.js

@@ -0,0 +1,57 @@
+import { isPlainRecord } from "../internal/plain-record.js";
+export class EngineCompatibilityError extends Error {
+    code = "engine.compatibility.versionMismatch";
+    requestedMode;
+    expectedVersion;
+    actualVersion;
+    constructor(details) {
+        super(`Compatibility mode "${details.requestedMode}" expects document version "${details.expectedVersion}" but received "${details.actualVersion}".`);
+        this.name = "EngineCompatibilityError";
+        this.requestedMode = details.requestedMode;
+        this.expectedVersion = details.expectedVersion;
+        this.actualVersion = details.actualVersion;
+    }
+}
+const expectedVersionByCompatibilityMode = {
+    default: "1.0.0",
+    "legacy-0.1": "0.0.0",
+};
+export function assertCompatibleResultVersion(result, requestedMode) {
+    const actualVersion = documentVersionFromPublicResult(result);
+    if (actualVersion === undefined) {
+        return;
+    }
+    const expectedVersion = expectedVersionByCompatibilityMode[requestedMode];
+    if (actualVersion !== expectedVersion) {
+        throw new EngineCompatibilityError({
+            requestedMode,
+            expectedVersion,
+            actualVersion,
+        });
+    }
+}
+function documentVersionFromPublicResult(value) {
+    const rootDocumentVersion = documentVersionFromPublicDocument(value);
+    if (rootDocumentVersion !== undefined) {
+        return rootDocumentVersion;
+    }
+    return versionFromNormalizeResult(value) ?? versionFromParseResult(value);
+}
+function versionFromNormalizeResult(value) {
+    const result = value;
+    return documentVersionFromPublicDocument(result.document);
+}
+function versionFromParseResult(value) {
+    const result = value;
+    if (!isPlainRecord(result.parsed)) {
+        return undefined;
+    }
+    return documentVersionFromPublicDocument(result.parsed.document);
+}
+function documentVersionFromPublicDocument(value) {
+    if (!isPlainRecord(value) || value.kind !== "markdown-document") {
+        return undefined;
+    }
+    return typeof value.version === "string" ? value.version : undefined;
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/api/compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../../src/api/compatibility.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI5D,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,IAAI,GAAG,sCAAsC,CAAC;IAC9C,aAAa,CAA0B;IACvC,eAAe,CAAwB;IACvC,aAAa,CAAS;IAE/B,YAAY,OAIX;QACC,KAAK,CACH,uBAAuB,OAAO,CAAC,aAAa,+BAA+B,OAAO,CAAC,eAAe,mBAAmB,OAAO,CAAC,aAAa,IAAI,CAC/I,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,kCAAkC,GAAG;IACzC,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE,OAAO;CAC2C,CAAC;AAEnE,MAAM,UAAU,6BAA6B,CAC3C,MAAe,EACf,aAAsC;IAEtC,MAAM,aAAa,GAAG,+BAA+B,CAAC,MAAM,CAAC,CAAC;IAE9D,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,eAAe,GAAG,kCAAkC,CAAC,aAAa,CAAC,CAAC;IAE1E,IAAI,aAAa,KAAK,eAAe,EAAE,CAAC;QACtC,MAAM,IAAI,wBAAwB,CAAC;YACjC,aAAa;YACb,eAAe;YACf,aAAa;SACd,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,+BAA+B,CAAC,KAAc;IACrD,MAAM,mBAAmB,GAAG,iCAAiC,CAAC,KAAK,CAAC,CAAC;IAErE,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,OAAO,0BAA0B,CAAC,KAAK,CAAC,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAChD,MAAM,MAAM,GAAG,KAAiC,CAAC;IAEjD,OAAO,iCAAiC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,MAAM,MAAM,GAAG,KAA6B,CAAC;IAE7C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,iCAAiC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,iCAAiC,CAAC,KAAc;IACvD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}

package/dist/api/contracts.d.ts

@@ -1,6 +1,8 @@
-export type MarkdownEngineApiName = "parse" | "normalize" | "validate" | "serialize";
+export type MarkdownEngineApiName = "parse" | "normalize" | "validate" | "serialize" | "documentQueries" | "validateAnnotations";
+export * from "./annotations.js";
 export * from "./diagnostics.js";
 export * from "./document.js";
+export * from "./document-queries.js";
 export * from "./normalize.js";
 export * from "./parse.js";
 export * from "./serialize.js";

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

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/api/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAErF,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/api/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,OAAO,GACP,WAAW,GACX,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,qBAAqB,CAAC;AAE1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/api/contracts.js

@@ -1,5 +1,7 @@
+export * from "./annotations.js";
 export * from "./diagnostics.js";
 export * from "./document.js";
+export * from "./document-queries.js";
 export * from "./normalize.js";
 export * from "./parse.js";
 export * from "./serialize.js";

package/dist/api/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/api/contracts.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/api/contracts.ts"],"names":[],"mappings":"AAQA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/api/document-queries.d.ts

@@ -0,0 +1,3 @@
+import type { EngineDocumentQueries } from "./document.js";
+export declare const documentQueries: EngineDocumentQueries;
+//# sourceMappingURL=document-queries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-queries.d.ts","sourceRoot":"","sources":["../../src/api/document-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EAetB,MAAM,eAAe,CAAC;AAGvB,eAAO,MAAM,eAAe,EAAE,qBAQ7B,CAAC"}