@jasonbelmonti/markdown-engine 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+## 0.1.0 - 2026-05-01
+
+Initial public release candidate for `@jasonbelmonti/markdown-engine`.
+
+### Added
+
+- Public package root exports for `parse`, `normalize`, `validate`, and
+  `serialize`.
+- Engine-owned normalized Markdown document and node contracts.
+- YAML frontmatter extraction with JSON-safe materialization and structured
+  diagnostics.
+- Deterministic validation rule families:
+  - `frontmatter.required`
+  - `headings.required`
+  - `codeFences.languages`
+  - `links.allowedSchemes`
+  - `rawHtml.policy`
+- Stable JSON serialization for public parse, normalize, and validation
+  results.
+- Parser/frontmatter fixtures, cmark-gfm comparison coverage, deterministic
+  repeatability proof, and dependency boundary audit tooling.
+
+### Release Status
+
+This version is prepared as the first public package version. Publication still
+requires MS-3 approval, downstream confirmation or owner waiver, final
+release-candidate validation, and npm publish verification.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jason Belmonti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+# @jasonbelmonti/markdown-engine
+
+Deterministic Markdown parsing and validation engine package for downstream
+profile and runtime work.
+
+Current release candidate:
+
+- package name: `@jasonbelmonti/markdown-engine`
+- version: `0.1.0`
+- release status: package metadata is public-release-ready; package tag and
+  npm publication still require MS-3 approval
+
+## Scope
+
+`@jasonbelmonti/markdown-engine` owns the deterministic engine boundary:
+
+- parse GFM Markdown and YAML frontmatter
+- normalize parser output into engine-owned IR
+- validate deterministic declarative rules
+- emit structured diagnostics
+- serialize public results with stable JSON key ordering
+
+Out of scope for this package: profile compiler behavior, runtime lenses, MCP
+transport, agent adapters, semantic or LLM evaluation, arbitrary rule plugins,
+network services, persistence, and raw parser AST as a public contract.
+
+## Public API
+
+The package root exports:
+
+- `parse(markdown, options?)`
+- `normalize(parsed, options?)`
+- `validate(document, config?, options?)`
+- `serialize(result, options?)`
+
+Example:
+
+```ts
+import {
+  normalize,
+  parse,
+  serialize,
+  validate,
+} from "@jasonbelmonti/markdown-engine";
+
+const markdown = `---
+title: Mission Brief
+owner: docs
+---
+
+# Mission Brief
+
+\`\`\`ts
+const ready = true;
+\`\`\`
+`;
+
+const parseResult = parse(markdown, { path: "mission.md" });
+const normalizeResult = normalize(parseResult.parsed);
+const validationResult = validate(normalizeResult.document, {
+  rules: {
+    "frontmatter.required": { fields: ["title", "owner"] },
+    "headings.required": { headings: ["Mission Brief"] },
+    "codeFences.languages": {
+      allowed: ["ts"],
+      requireLanguage: true,
+    },
+  },
+});
+
+console.log(validationResult.valid);
+console.log(serialize(validationResult, { pretty: true }));
+```
+
+Contract references:
+
+- [Public API contract](docs/contracts/api.md)
+- [Frontmatter contract](docs/contracts/frontmatter.md)
+- [Changelog](CHANGELOG.md)
+- [Security policy](SECURITY.md)
+
+## Validation
+
+Run the release-readiness gates from the repository root:
+
+```sh
+npm run release:verify
+npm pack --dry-run
+npm publish --dry-run --access public
+```
+
+The WP-6 validation record is:
+
+- [EVD-7 release readiness](docs/evidence/wp-6-evd-7-release-readiness.md)
+- [EVD-9 merge readiness](docs/evidence/wp-6-evd-9-merge-readiness.md)
+- [EVD-10 rollback containment](docs/evidence/wp-6-evd-10-rollback-containment.md)
+- [EVD-11 downstream handoff](docs/evidence/wp-6-evd-11-downstream-handoff.md)
+
+## Release Gate
+
+Do not tag or publish this package until MS-3 approval is recorded with:
+
+- semver classification and package version decision
+- release/tag decision
+- rollback and containment notes
+- downstream profile/runtime consumer confirmation
+- complete evidence links from EVD-1 through EVD-11
+
+When MS-3 is approved, publish the package as:
+
+```sh
+npm publish --access public
+```
+
+The publish path is guarded by npm lifecycle scripts: `prepublishOnly` and
+`prepack` both run the release verification gate before `npm publish` or
+`npm pack` creates an artifact. The gate rebuilds `dist` and fails if tracked
+files drift from `HEAD`.

package/SECURITY.md

@@ -0,0 +1,28 @@
+# Security Policy
+
+## Supported Versions
+
+`@jasonbelmonti/markdown-engine` is pre-1.0 software. Security fixes are
+expected to target the latest published minor version unless a release note
+states otherwise.
+
+## Reporting A Vulnerability
+
+Report suspected vulnerabilities privately by emailing
+jasonbelmonti@gmail.com. Include:
+
+- affected package version
+- reproduction steps or input Markdown/config
+- expected and observed behavior
+- any known impact or workaround
+
+Do not publish exploit details publicly until a fix or mitigation plan is
+available.
+
+## Scope
+
+This package parses Markdown and YAML frontmatter, normalizes engine-owned IR,
+evaluates deterministic validation rules, and serializes public result objects.
+
+It does not execute raw HTML, fetch network resources, call LLM providers,
+run plugins, start services, persist data, or evaluate semantic rules.

package/dist/api/contracts.d.ts

@@ -0,0 +1,8 @@
+export type MarkdownEngineApiName = "parse" | "normalize" | "validate" | "serialize";
+export * from "./diagnostics.js";
+export * from "./document.js";
+export * from "./normalize.js";
+export * from "./parse.js";
+export * from "./serialize.js";
+export * from "./validate.js";
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +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"}

package/dist/api/contracts.js

@@ -0,0 +1,7 @@
+export * from "./diagnostics.js";
+export * from "./document.js";
+export * from "./normalize.js";
+export * from "./parse.js";
+export * from "./serialize.js";
+export * from "./validate.js";
+//# sourceMappingURL=contracts.js.map

package/dist/api/contracts.js.map

@@ -0,0 +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"}

package/dist/api/diagnostics.d.ts

@@ -0,0 +1,18 @@
+export type MarkdownDiagnosticSeverity = "error" | "warning" | "info";
+export interface SourcePosition {
+    line: number;
+    column: number;
+    offset?: number;
+}
+export interface SourceRange {
+    start: SourcePosition;
+    end: SourcePosition;
+}
+export interface MarkdownDiagnostic {
+    code: string;
+    ruleId?: string;
+    message: string;
+    severity: MarkdownDiagnosticSeverity;
+    sourceRange?: SourceRange;
+}
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/api/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,0BAA0B,CAAC;IACrC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}

package/dist/api/diagnostics.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostics.js.map

package/dist/api/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/api/diagnostics.ts"],"names":[],"mappings":""}

package/dist/api/document.d.ts

@@ -0,0 +1,17 @@
+import type { SourceRange } from "./diagnostics.js";
+export interface EngineNode {
+    type: string;
+    text?: string;
+    attributes?: Record<string, unknown>;
+    sourceRange?: SourceRange;
+    children?: EngineNode[];
+}
+export interface EngineDocument {
+    kind: "markdown-document";
+    version: "0.0.0";
+    path?: string;
+    frontmatter?: unknown;
+    children: EngineNode[];
+    sourceRange?: SourceRange;
+}
+//# sourceMappingURL=document.d.ts.map

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

@@ -0,0 +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"}

package/dist/api/document.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document.js.map

package/dist/api/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/api/document.ts"],"names":[],"mappings":""}

package/dist/api/normalize.d.ts

@@ -0,0 +1,13 @@
+import type { MarkdownDiagnostic } from "./diagnostics.js";
+import type { EngineDocument } from "./document.js";
+import type { ParsedMarkdown } from "./parse.js";
+export interface NormalizeOptions {
+    preserveSourceLocations?: boolean;
+}
+export interface NormalizeResult {
+    document: EngineDocument;
+    diagnostics: MarkdownDiagnostic[];
+}
+export type NormalizeFunction = (parsed: ParsedMarkdown, options?: NormalizeOptions) => NormalizeResult;
+export declare const normalize: NormalizeFunction;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +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"}

package/dist/api/normalize.js

@@ -0,0 +1,7 @@
+import { cloneDiagnostics } from "../diagnostics/index.js";
+import { normalizeParsedMarkdown } from "../ir/index.js";
+export const normalize = (parsed, options = {}) => ({
+    document: normalizeParsedMarkdown(parsed, options),
+    diagnostics: cloneDiagnostics(parsed.diagnostics),
+});
+//# sourceMappingURL=normalize.js.map

package/dist/api/normalize.js.map

@@ -0,0 +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"}

package/dist/api/parse.d.ts

@@ -0,0 +1,20 @@
+import type { MarkdownDiagnostic } from "./diagnostics.js";
+import type { EngineDocument } from "./document.js";
+export interface ParseOptions {
+    path?: string;
+}
+export interface ParsedMarkdown {
+    markdown: string;
+    body: string;
+    path?: string;
+    frontmatter?: unknown;
+    document: EngineDocument;
+    diagnostics: MarkdownDiagnostic[];
+}
+export interface ParseResult {
+    parsed: ParsedMarkdown;
+    diagnostics: MarkdownDiagnostic[];
+}
+export type ParseFunction = (markdown: string, options?: ParseOptions) => ParseResult;
+export declare const parse: ParseFunction;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/api/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,YAAY,KACnB,WAAW,CAAC;AAEjB,eAAO,MAAM,KAAK,EAAE,aAiCnB,CAAC"}

package/dist/api/parse.js

@@ -0,0 +1,46 @@
+import { parseFrontmatter } from "../frontmatter/index.js";
+import { parseMarkdownBody } from "../parser/index.js";
+export const parse = (markdown, options = {}) => {
+    const frontmatterResult = parseFrontmatter(markdown);
+    const parserOptions = {
+        ...(options.path !== undefined ? { path: options.path } : {}),
+        lineOffset: frontmatterResult.bodyStart.line - 1,
+        columnOffset: frontmatterResult.bodyStart.column - 1,
+        ...(frontmatterResult.bodyStart.offset !== undefined
+            ? { offsetOffset: frontmatterResult.bodyStart.offset }
+            : {}),
+    };
+    const bodyResult = parseMarkdownBody(frontmatterResult.body, parserOptions);
+    const diagnostics = [
+        ...frontmatterResult.diagnostics,
+        ...bodyResult.diagnostics,
+    ];
+    const frontmatter = parsedFrontmatterValue(frontmatterResult.frontmatter);
+    const document = {
+        ...bodyResult.document,
+        ...(frontmatter.hasValue ? { frontmatter: frontmatter.value } : {}),
+    };
+    const parsed = {
+        markdown,
+        body: frontmatterResult.body,
+        ...(options.path !== undefined ? { path: options.path } : {}),
+        ...(frontmatter.hasValue ? { frontmatter: frontmatter.value } : {}),
+        document,
+        diagnostics,
+    };
+    return {
+        parsed,
+        diagnostics,
+    };
+};
+function parsedFrontmatterValue(block) {
+    const hasValue = block !== undefined && Object.prototype.hasOwnProperty.call(block, "value");
+    if (hasValue) {
+        return {
+            hasValue: true,
+            value: block.value,
+        };
+    }
+    return { hasValue: false };
+}
+//# sourceMappingURL=parse.js.map

package/dist/api/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/api/parse.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAyBvD,MAAM,CAAC,MAAM,KAAK,GAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;IAC7D,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG;QACpB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,UAAU,EAAE,iBAAiB,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC;QAChD,YAAY,EAAE,iBAAiB,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QACpD,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS;YAClD,CAAC,CAAC,EAAE,YAAY,EAAE,iBAAiB,CAAC,SAAS,CAAC,MAAM,EAAE;YACtD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,MAAM,UAAU,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG;QAClB,GAAG,iBAAiB,CAAC,WAAW;QAChC,GAAG,UAAU,CAAC,WAAW;KAC1B,CAAC;IACF,MAAM,WAAW,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAmB;QAC/B,GAAG,UAAU,CAAC,QAAQ;QACtB,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;IACF,MAAM,MAAM,GAAmB;QAC7B,QAAQ;QACR,IAAI,EAAE,iBAAiB,CAAC,IAAI;QAC5B,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,QAAQ;QACR,WAAW;KACZ,CAAC;IAEF,OAAO;QACL,MAAM;QACN,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC;AAEF,SAAS,sBAAsB,CAC7B,KAAmC;IAEnC,MAAM,QAAQ,GACZ,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE9E,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/api/serialize.d.ts

@@ -0,0 +1,10 @@
+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 interface SerializeOptions {
+    pretty?: boolean;
+}
+export type SerializeFunction = (result: SerializableMarkdownEngineResult, options?: SerializeOptions) => string;
+export declare const serialize: SerializeFunction;
+//# sourceMappingURL=serialize.d.ts.map

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

@@ -0,0 +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"}

package/dist/api/serialize.js

@@ -0,0 +1,18 @@
+import { isPlainRecord } from "../internal/plain-record.js";
+export const serialize = (result, options = {}) => {
+    const serialized = JSON.stringify(normalizeSerializableValue(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

@@ -0,0 +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"}

package/dist/api/validate.d.ts

@@ -0,0 +1,21 @@
+import type { MarkdownDiagnostic } from "./diagnostics.js";
+import type { EngineDocument } from "./document.js";
+export interface ValidationConfig {
+    rules?: Record<string, unknown>;
+}
+export interface ValidateOptions {
+    path?: string;
+}
+export interface ValidationRuleResult {
+    ruleId: string;
+    passed: boolean;
+    diagnostics: MarkdownDiagnostic[];
+}
+export interface ValidationResult {
+    valid: boolean;
+    diagnostics: MarkdownDiagnostic[];
+    ruleResults: ValidationRuleResult[];
+}
+export type ValidateFunction = (document: EngineDocument, config?: ValidationConfig, options?: ValidateOptions) => ValidationResult;
+export declare const validate: ValidateFunction;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/api/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,cAAc,EACxB,MAAM,CAAC,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,eAAe,KACtB,gBAAgB,CAAC;AAEtB,eAAO,MAAM,QAAQ,EAAE,gBAqBtB,CAAC"}

package/dist/api/validate.js

@@ -0,0 +1,21 @@
+import { loadValidationConfig } from "../config/index.js";
+import { cloneDiagnostics, hasErrorDiagnostic } from "../diagnostics/index.js";
+import { evaluateConfiguredRules } from "../rules/index.js";
+export const validate = (document, config = {}, _options = {}) => {
+    const loadedConfig = loadValidationConfig(config);
+    const ruleResults = evaluateConfiguredRules(document, loadedConfig.rules);
+    const diagnostics = [
+        ...loadedConfig.diagnostics,
+        ...ruleResults.flatMap((result) => result.diagnostics),
+    ];
+    return {
+        valid: !hasErrorDiagnostic(diagnostics),
+        diagnostics: cloneDiagnostics(diagnostics),
+        ruleResults: ruleResults.map((result) => ({
+            ruleId: result.ruleId,
+            passed: result.passed,
+            diagnostics: cloneDiagnostics(result.diagnostics),
+        })),
+    };
+};
+//# sourceMappingURL=validate.js.map

package/dist/api/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/api/validate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AA4B5D,MAAM,CAAC,MAAM,QAAQ,GAAqB,CACxC,QAAQ,EACR,MAAM,GAAG,EAAE,EACX,QAAQ,GAAG,EAAE,EACb,EAAE;IACF,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,uBAAuB,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG;QAClB,GAAG,YAAY,CAAC,WAAW;QAC3B,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;KACvD,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC;QACvC,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC;QAC1C,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACxC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC;SAClD,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,8 @@
+import type { MarkdownDiagnostic } from "../api/diagnostics.js";
+import { type SupportedValidationRuleConfig } from "../rules/index.js";
+export interface LoadedValidationConfig {
+    rules: SupportedValidationRuleConfig[];
+    diagnostics: MarkdownDiagnostic[];
+}
+export declare function loadValidationConfig(config?: unknown): LoadedValidationConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,6BAA6B,EAAE,CAAC;IACvC,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,OAAY,GACnB,sBAAsB,CA2DxB"}

package/dist/config/index.js

@@ -0,0 +1,53 @@
+import { makeDiagnostic } from "../diagnostics/index.js";
+import { isPlainRecord } from "../internal/plain-record.js";
+import { parseValidationRuleConfig, } from "../rules/index.js";
+export function loadValidationConfig(config = {}) {
+    if (!isPlainRecord(config)) {
+        return {
+            rules: [],
+            diagnostics: [
+                makeDiagnostic({
+                    code: "config.invalid",
+                    message: "Validation config must be an object.",
+                    severity: "error",
+                }),
+            ],
+        };
+    }
+    const rules = config.rules;
+    if (rules === undefined) {
+        return { rules: [], diagnostics: [] };
+    }
+    if (!isPlainRecord(rules)) {
+        return {
+            rules: [],
+            diagnostics: [
+                makeDiagnostic({
+                    code: "config.rules.invalid",
+                    message: "Validation config rules must be an object.",
+                    severity: "error",
+                }),
+            ],
+        };
+    }
+    const loaded = { rules: [], diagnostics: [] };
+    for (const [ruleId, ruleConfig] of Object.entries(rules)) {
+        const parsed = parseValidationRuleConfig(ruleId, ruleConfig);
+        if (parsed === undefined) {
+            loaded.diagnostics.push(makeDiagnostic({
+                code: "config.rule.unsupported",
+                ruleId,
+                message: `Unsupported validation rule "${ruleId}".`,
+                severity: "error",
+            }));
+            continue;
+        }
+        if (parsed.diagnostic !== undefined) {
+            loaded.diagnostics.push(parsed.diagnostic);
+            continue;
+        }
+        loaded.rules.push(parsed.rule);
+    }
+    return loaded;
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,yBAAyB,GAE1B,MAAM,mBAAmB,CAAC;AAO3B,MAAM,UAAU,oBAAoB,CAClC,SAAkB,EAAE;IAEpB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE,EAAE;YACT,WAAW,EAAE;gBACX,cAAc,CAAC;oBACb,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,sCAAsC;oBAC/C,QAAQ,EAAE,OAAO;iBAClB,CAAC;aACH;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAE3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,EAAE;YACT,WAAW,EAAE;gBACX,cAAc,CAAC;oBACb,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,4CAA4C;oBACrD,QAAQ,EAAE,OAAO;iBAClB,CAAC;aACH;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAEtE,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAE7D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,CAAC,WAAW,CAAC,IAAI,CACrB,cAAc,CAAC;gBACb,IAAI,EAAE,yBAAyB;gBAC/B,MAAM;gBACN,OAAO,EAAE,gCAAgC,MAAM,IAAI;gBACnD,QAAQ,EAAE,OAAO;aAClB,CAAC,CACH,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/diagnostics/index.d.ts

@@ -0,0 +1,6 @@
+import type { MarkdownDiagnostic } from "../api/diagnostics.js";
+export declare function makeDiagnostic(diagnostic: MarkdownDiagnostic): MarkdownDiagnostic;
+export declare function cloneDiagnostics(diagnostics: readonly MarkdownDiagnostic[]): MarkdownDiagnostic[];
+export declare function cloneDiagnostic(diagnostic: MarkdownDiagnostic): MarkdownDiagnostic;
+export declare function hasErrorDiagnostic(diagnostics: readonly MarkdownDiagnostic[]): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,uBAAuB,CAAC;AAE7E,wBAAgB,cAAc,CAC5B,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAEpB;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,kBAAkB,EAAE,CAEtB;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAUpB;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,OAAO,CAET"}

package/dist/diagnostics/index.js

@@ -0,0 +1,27 @@
+export function makeDiagnostic(diagnostic) {
+    return cloneDiagnostic(diagnostic);
+}
+export function cloneDiagnostics(diagnostics) {
+    return diagnostics.map((diagnostic) => cloneDiagnostic(diagnostic));
+}
+export function cloneDiagnostic(diagnostic) {
+    return {
+        code: diagnostic.code,
+        ...(diagnostic.ruleId !== undefined ? { ruleId: diagnostic.ruleId } : {}),
+        message: diagnostic.message,
+        severity: diagnostic.severity,
+        ...(diagnostic.sourceRange !== undefined
+            ? { sourceRange: cloneSourceRange(diagnostic.sourceRange) }
+            : {}),
+    };
+}
+export function hasErrorDiagnostic(diagnostics) {
+    return diagnostics.some((diagnostic) => diagnostic.severity === "error");
+}
+function cloneSourceRange(sourceRange) {
+    return {
+        start: { ...sourceRange.start },
+        end: { ...sourceRange.end },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/diagnostics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/diagnostics/index.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAC5B,UAA8B;IAE9B,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,WAA0C;IAE1C,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,UAA8B;IAE9B,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,GAAG,CAAC,UAAU,CAAC,WAAW,KAAK,SAAS;YACtC,CAAC,CAAC,EAAE,WAAW,EAAE,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;YAC3D,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,WAA0C;IAE1C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAwB;IAChD,OAAO;QACL,KAAK,EAAE,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE;QAC/B,GAAG,EAAE,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/dist/frontmatter/adapter.d.ts

@@ -0,0 +1,3 @@
+import type { FrontmatterParseResult } from "./types.js";
+export declare function parseFrontmatter(markdown: string): FrontmatterParseResult;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/frontmatter/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/frontmatter/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG3E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAuBzE"}

package/dist/frontmatter/adapter.js

@@ -0,0 +1,20 @@
+import { extractFrontmatter } from "./extract.js";
+import { parseYamlFrontmatter } from "./yaml.js";
+export function parseFrontmatter(markdown) {
+    const extracted = extractFrontmatter(markdown);
+    if (extracted.frontmatter === undefined) {
+        return extracted;
+    }
+    const parsed = parseYamlFrontmatter(extracted.frontmatter.raw, extracted.frontmatter.contentStart, extracted.frontmatter.sourceRange);
+    const frontmatter = {
+        ...extracted.frontmatter,
+        ...(parsed.valueParsed ? { value: parsed.value } : {}),
+    };
+    return {
+        body: extracted.body,
+        bodyStart: extracted.bodyStart,
+        diagnostics: [...extracted.diagnostics, ...parsed.diagnostics],
+        frontmatter,
+    };
+}
+//# sourceMappingURL=adapter.js.map