@jasonbelmonti/markdown-engine 1.0.0 → 2.0.0

package/CHANGELOG.md

@@ -2,7 +2,30 @@
 
 ## Unreleased
 
-No unreleased changes.
+### Added
+
+- Added a GitHub Pages consumer site under `docs/` with value proposition,
+  workflow examples, and quickstart material for package 2.0 users.
+
+## 2.0.0 - 2026-05-13
+
+### Changed
+
+- Promoted package metadata to `@jasonbelmonti/markdown-engine@2.0.0` while
+  retaining the serialized rich IR document contract at
+  `documentVersion: "1.0.0"`.
+- Changed `normalize(parsed)` to default to the rich IR `1.0.0` document shape.
+  Callers that still need the retained `0.1.0`-compatible shape must pass
+  `documentVersion: "0.0.0"` explicitly.
+- Added `docs/contracts/**` to the npm package artifact and included the rich
+  IR contract documentation gate in `release:verify`.
+
+### Fixed
+
+- Closed the direct-object `parseValidationProfile(...)` ingestion path before
+  schema traversal so unsafe accessors, proxies, cyclic values, sparse arrays,
+  functions, non-finite numbers, explicit `undefined`, and `__proto__` payloads
+  are rejected as inert profile data instead of being read by schema logic.
 
 ## 1.0.0 - 2026-05-07
 

package/README.md

@@ -6,9 +6,11 @@ profile and runtime work.
 Current package release:
 
 - package name: `@jasonbelmonti/markdown-engine`
-- version: `1.0.0`
-- release focus: feature-complete rich IR, structural query helpers, source
-  targeting, table/list models, annotations, and deterministic serialization
+- version: `2.0.0`
+- website: <https://jasonbelmonti.github.io/markdown-engine/>
+- release focus: package-level 2.0 hardening with the existing
+  `documentVersion: "1.0.0"` rich IR contract as the default API and CLI
+  document shape
 - design reference:
   [Markdown Engine 1.0 Rich IR design](docs/design/markdown-engine-1.0-rich-ir-operational-design-spec.md)
 
@@ -36,6 +38,8 @@ The package root exports:
 - `serialize(result, options?)`
 - `documentQueries`
 - `validateAnnotations(document, annotations)`
+- `parseValidationProfile(input, options?)`
+- `validateWithProfile(document, profile, options?)`
 
 Example:
 
@@ -76,8 +80,10 @@ console.log(validationResult.valid);
 console.log(serialize(validationResult, { pretty: true }));
 ```
 
-The 1.0 release exposes the rich IR contract through
-`normalize(parsed, { documentVersion: "1.0.0" })`. That path adds
+Package 2.0 keeps the serialized document contract at
+`documentVersion: "1.0.0"` and makes that rich IR path the default for
+`normalize(parsed)`. Callers may still pass
+`normalize(parsed, { documentVersion: "1.0.0" })` explicitly. That path adds
 deterministic targets, structural views, source slices, query helpers, and
 caller-owned annotation target validation. The retained `0.1.0`-compatible
 document path remains selectable as `documentVersion: "0.0.0"` and
@@ -86,20 +92,23 @@ serialization gates can require it with `compatibilityMode: "legacy-0.1"`.
 ## CLI
 
 The package includes a minimal local CLI for experimenting with one Markdown
-file at a time. It runs parse and normalization, then writes the normalized
-result as pretty JSON.
+file at a time. The default command runs parse and normalization, then writes
+the normalized result as pretty JSON. The `validate` subcommand runs one
+declarative validation profile against one Markdown file and writes pretty JSON.
 
-After building, run:
+From the repository or package root after building, run:
 
 ```sh
 npm run build
-node dist/cli/index.js --file fixtures/representative.md
+node dist/cli/index.js --file fixtures/declarative-validation/examples/operational-spec/pass.md
 ```
 
-The package binary accepts `--file` or `--path` as aliases for a single file:
+The package binary accepts `--file` or `--path` as aliases for a single file.
+For an npm install in the current project, point at the bundled examples through
+`node_modules/@jasonbelmonti/markdown-engine`:
 
 ```sh
-markdown-engine --path fixtures/representative.md
+markdown-engine --path node_modules/@jasonbelmonti/markdown-engine/fixtures/declarative-validation/examples/operational-spec/pass.md
 ```
 
 By default, CLI output uses the 1.0 rich IR contract:
@@ -118,7 +127,7 @@ Use `--document-version 0.0.0` when a caller still needs the legacy
 `0.1.0`-compatible document shape without rich derived views:
 
 ```sh
-markdown-engine --document-version 0.0.0 --file fixtures/representative.md
+markdown-engine --document-version 0.0.0 --file node_modules/@jasonbelmonti/markdown-engine/fixtures/declarative-validation/examples/operational-spec/pass.md
 ```
 
 The selector accepts spaced or assignment-form syntax, such as
@@ -128,16 +137,47 @@ values are `1.0.0` and `0.0.0`. Missing, invalid, or repeated
 assignment-form selector is treated as missing. Directory traversal is not
 supported by this CLI slice.
 
-BEL-952 classifies the default CLI output change as breaking for consumers that
-parse CLI JSON without selecting `--document-version 0.0.0`. Migration is to
-either consume the rich IR fields (`target`, `sections`, `textSpans`, `tables`,
-`lists`, and `links`) or pin the explicit legacy selector until the downstream
-consumer is ready. This default-output cutover belongs to the 1.0 release lane,
-not a `0.1.x` patch.
+Declarative validation uses the 1.0 document contract and does not accept
+`--document-version`:
+
+```sh
+markdown-engine validate --file node_modules/@jasonbelmonti/markdown-engine/fixtures/declarative-validation/examples/operational-spec/pass.md --profile node_modules/@jasonbelmonti/markdown-engine/fixtures/declarative-validation/examples/operational-spec/profile.yaml
+```
+
+`--format json` is accepted for validation, is the default, and is the only
+supported format. The validation command reads and checks the profile before
+reading the Markdown file. Profile parse/config/compile failures exit with code
+`1` and emit JSON with `stage: "profile"`, empty `ruleResults`, no `profile`,
+and no `evidence`. Markdown read errors and usage errors exit with code `2`.
+Successful validation exits with code `0`; validation or normalization error
+diagnostics exit with code `1`. Validation JSON includes `profile`,
+`ruleResults`, `diagnostics`, and `evidence`.
+
+Reader-facing declarative validation examples live under
+`fixtures/declarative-validation/examples/**`. From the repository or package
+root after building, run one passing and one intentionally failing example with:
+
+```sh
+node dist/cli/index.js validate --file fixtures/declarative-validation/examples/operational-spec/pass.md --profile fixtures/declarative-validation/examples/operational-spec/profile.yaml
+node dist/cli/index.js validate --file fixtures/declarative-validation/examples/operational-spec/fail.md --profile fixtures/declarative-validation/examples/operational-spec/profile.yaml
+```
+
+The passing example exits `0`; the failing example exits `1` and prints JSON
+diagnostics for review.
+
+Package 2.0 classifies the API normalization default as breaking for consumers
+that call `normalize(parsed)` and expect the legacy `0.0.0` shape. Migration is
+to either consume the rich IR fields (`target`, `sections`, `textSpans`,
+`tables`, `lists`, and `links`) or pin
+`normalize(parsed, { documentVersion: "0.0.0" })` until the downstream consumer
+is ready. The CLI already defaults to the rich IR document contract and keeps
+`--document-version 0.0.0` for explicit legacy output.
 
 Contract references:
 
+- [Consumer website](https://jasonbelmonti.github.io/markdown-engine/)
 - [Public API contract](docs/contracts/api.md)
+- [Declarative validation contract](docs/contracts/declarative-validation.md)
 - [Frontmatter contract](docs/contracts/frontmatter.md)
 - [Markdown Engine 1.0 Rich IR design](docs/design/markdown-engine-1.0-rich-ir-operational-design-spec.md)
 - [Testing and snapshot operations](docs/testing.md)
@@ -150,6 +190,8 @@ Run the release-readiness gates from the repository root:
 
 ```sh
 npm run docs:rich-ir-contract
+npm run docs:declarative-validation-contract
+npm run audit:declarative-validation-boundary
 npm run release:verify
 npm pack --dry-run
 npm publish --dry-run --access public
@@ -158,34 +200,41 @@ npm publish --dry-run --access public
 Validation records include:
 
 - [EVD-6 rich IR contract docs](docs/evidence/wp-5-evd-6-rich-ir-contract.md)
+- [EVD-6 declarative validation repeatability](docs/evidence/wp-5-evd-6-declarative-validation-repeatability.md)
+- [EVD-7 declarative validation contract review](docs/evidence/wp-5-evd-7-declarative-validation-contract-review.md)
+- [EVD-8 declarative validation boundary audit](docs/evidence/wp-5-evd-8-declarative-validation-boundary-audit.md)
+- [BEL-986 declarative validation MS-2 approval](docs/evidence/bel-986-ms-2-approval.md)
 - [EVD-8 compatibility and CLI impact](docs/evidence/wp-5-evd-8-compatibility-cli-impact.md)
 - [EVD-9 1.0 downstream exercise](docs/evidence/wp-6-evd-9-downstream-exercise.md)
+- [EVD-10 declarative validation release-readiness handoff](docs/evidence/wp-6-evd-10-declarative-validation-release-readiness.md)
 - [EVD-10 1.0 release readiness](docs/evidence/wp-6-evd-10-release-readiness.md)
 - [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)
+- [BEL-1025 declarative validation example suite](docs/evidence/bel-1025-declarative-validation-example-suite.md)
 
 Snapshot baseline updates are operational changes, not routine test-output
 cleanup. Use the [testing and snapshot operations](docs/testing.md) guide before
 updating files under `snapshots/**`.
 
-## 1.0 Release Gate
+## 2.0 Release Gate
 
-Do not tag or publish the 1.0 release until approval is recorded with:
+Do not tag or publish the 2.0 release until approval is recorded with:
 
-- semver classification and package version decision
+- semver classification distinguishing package version `2.0.0` from document
+  contract version `1.0.0`
 - release/tag decision
 - rollback and containment notes
 - downstream profile/runtime consumer confirmation
 - complete evidence links from EVD-1 through EVD-11
 
-Current release decision: BEL-965 promotes the package metadata and public rich
-IR document contract to `1.0.0` after BEL-956 child audit tracks completed and
-the release gates passed. The `v1.0.0` git tag must point only at a commit that
-passes the validation commands above.
+Current release decision: package `2.0.0` retains the public rich IR document
+contract at `documentVersion: "1.0.0"`, makes that contract the default API
+normalization output, and hardens declarative profile ingestion. The `v2.0.0`
+git tag must point only at a commit that passes the validation commands above.
 
-When 1.0 is approved, publish the package as:
+When 2.0 is approved, publish the package as:
 
 ```sh
 npm publish --access public

package/SECURITY.md

@@ -2,9 +2,11 @@
 
 ## 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.
+Security fixes target the latest published major version of
+`@jasonbelmonti/markdown-engine`. As of the 2.0 release line, fixes are expected
+to land on the latest `2.x` package unless a release note states otherwise.
+Older `0.x` and `1.x` lines are not maintained unless an explicit backport is
+announced.
 
 ## Reporting A Vulnerability
 

package/dist/api/annotation-source-range.d.ts

@@ -0,0 +1,7 @@
+import type { SourcePosition, SourceRange } from "./diagnostics.js";
+export declare function cloneSourceRangeCandidate(range: unknown): SourceRange | undefined;
+export declare function cloneSourceRange(sourceRange: SourceRange): SourceRange;
+export declare function sourceRangeIsInvalid(range: SourceRange): boolean;
+export declare function sourceRangeContains(container: SourceRange, target: SourceRange): boolean;
+export declare function compareSourcePositions(left: SourcePosition, right: SourcePosition): number;
+//# sourceMappingURL=annotation-source-range.d.ts.map

package/dist/api/annotation-source-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-source-range.d.ts","sourceRoot":"","sources":["../../src/api/annotation-source-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQpE,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,WAAW,GAAG,SAAS,CAazB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAKtE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAKhE;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,WAAW,GAClB,OAAO,CAMT;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,cAAc,GACpB,MAAM,CAMR"}

package/dist/api/annotation-source-range.js

@@ -0,0 +1,103 @@
+import { isPlainObject, ownDataProperty, ownRuntimeProperty, } from "./annotation-target-runtime.js";
+export 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 };
+}
+export function cloneSourceRange(sourceRange) {
+    return {
+        start: cloneSourcePosition(sourceRange.start),
+        end: cloneSourcePosition(sourceRange.end),
+    };
+}
+export function sourceRangeIsInvalid(range) {
+    return (compareLineAndColumn(range.end, range.start) < 0 ||
+        sourceOffsetsAreInvalid(range));
+}
+export function sourceRangeContains(container, target) {
+    return (compareLineAndColumn(container.start, target.start) <= 0 &&
+        compareLineAndColumn(target.end, container.end) <= 0 &&
+        sourceOffsetsAreContained(container, target));
+}
+export function compareSourcePositions(left, right) {
+    return (left.line - right.line ||
+        left.column - right.column ||
+        compareOptionalOffsets(left.offset, right.offset));
+}
+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 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 compareLineAndColumn(left, right) {
+    return left.line - right.line || left.column - right.column;
+}
+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 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-source-range.js.map

package/dist/api/annotation-source-range.js.map

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

package/dist/api/annotation-target-candidate.d.ts

@@ -0,0 +1,10 @@
+export type AnnotationTargetCandidate = {
+    kind?: unknown;
+    nodeTarget?: unknown;
+    sourceRange?: unknown;
+};
+export declare function isAnnotationTargetCandidate(target: unknown): target is AnnotationTargetCandidate;
+export declare function annotationTargetKind(target: AnnotationTargetCandidate): unknown;
+export declare function annotationNodeTarget(target: AnnotationTargetCandidate): unknown;
+export declare function annotationSourceRange(target: AnnotationTargetCandidate): unknown;
+//# sourceMappingURL=annotation-target-candidate.d.ts.map

package/dist/api/annotation-target-candidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-target-candidate.d.ts","sourceRoot":"","sources":["../../src/api/annotation-target-candidate.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,yBAAyB,CAErC;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAET;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAET;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAET"}

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

@@ -0,0 +1,14 @@
+import { isArray, ownDataProperty } from "./annotation-target-runtime.js";
+export function isAnnotationTargetCandidate(target) {
+    return typeof target === "object" && target !== null && !isArray(target);
+}
+export function annotationTargetKind(target) {
+    return ownDataProperty(target, "kind");
+}
+export function annotationNodeTarget(target) {
+    return ownDataProperty(target, "nodeTarget");
+}
+export function annotationSourceRange(target) {
+    return ownDataProperty(target, "sourceRange");
+}
+//# sourceMappingURL=annotation-target-candidate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-target-candidate.js","sourceRoot":"","sources":["../../src/api/annotation-target-candidate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAQ1E,MAAM,UAAU,2BAA2B,CACzC,MAAe;IAEf,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAiC;IAEjC,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAiC;IAEjC,OAAO,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAiC;IAEjC,OAAO,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAChD,CAAC"}

package/dist/api/annotation-target-cloning.d.ts

@@ -0,0 +1,5 @@
+import type { EngineAnnotationTarget, EngineNodeTarget } from "./document.js";
+export declare function cloneAnnotationTarget(target: EngineAnnotationTarget): EngineAnnotationTarget;
+export declare function cloneDiagnosticTarget(target: unknown): unknown;
+export declare function cloneEngineTargetCandidate(target: unknown): EngineNodeTarget | undefined;
+//# sourceMappingURL=annotation-target-cloning.d.ts.map

package/dist/api/annotation-target-cloning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-target-cloning.d.ts","sourceRoot":"","sources":["../../src/api/annotation-target-cloning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAwBvB,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAUxB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAU9D;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,GACd,gBAAgB,GAAG,SAAS,CAwC9B"}

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

@@ -0,0 +1,122 @@
+import { arrayLength, isArray, isPlainObject, MAX_NORMALIZED_ARRAY_LENGTH, normalizeRuntimeValue, ownRuntimeProperty, } from "./annotation-target-runtime.js";
+import { annotationNodeTarget, annotationSourceRange, annotationTargetKind, isAnnotationTargetCandidate, } from "./annotation-target-candidate.js";
+import { cloneSourceRangeCandidate } from "./annotation-source-range.js";
+export function cloneAnnotationTarget(target) {
+    if (isAnnotationTargetCandidate(target)) {
+        const clonedTarget = cloneKnownAnnotationTarget(target);
+        if (clonedTarget !== undefined) {
+            return clonedTarget;
+        }
+    }
+    return serializableTarget(target);
+}
+export function cloneDiagnosticTarget(target) {
+    if (isAnnotationTargetCandidate(target)) {
+        const clonedTarget = cloneKnownAnnotationTarget(target);
+        if (clonedTarget !== undefined) {
+            return clonedTarget;
+        }
+    }
+    return serializableTarget(target);
+}
+export 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 serializableTarget(target) {
+    return normalizeRuntimeValue(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 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 ownDataProperty(value, key) {
+    const property = ownRuntimeProperty(value, key);
+    return property.kind === "data" ? property.value : undefined;
+}
+function optionalDataPropertyValue(property) {
+    return property.kind === "data" ? property.value : undefined;
+}
+function optionalDataPropertyIsInvalid(property) {
+    return property.kind === "accessor" || property.kind === "unavailable";
+}
+function isNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+//# sourceMappingURL=annotation-target-cloning.js.map

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

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

package/dist/api/annotation-target-diagnostics.d.ts

@@ -0,0 +1,8 @@
+import type { EngineTargetDiagnostic } from "./document.js";
+export interface SortableTargetDiagnostic {
+    diagnostic: EngineTargetDiagnostic;
+    order: number;
+}
+export declare function sortableDiagnostic(diagnostic: EngineTargetDiagnostic, order: number): SortableTargetDiagnostic;
+export declare function compareSortableDiagnostics(left: SortableTargetDiagnostic, right: SortableTargetDiagnostic): number;
+//# sourceMappingURL=annotation-target-diagnostics.d.ts.map

package/dist/api/annotation-target-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-target-diagnostics.d.ts","sourceRoot":"","sources":["../../src/api/annotation-target-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAS5D,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,sBAAsB,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,sBAAsB,EAClC,KAAK,EAAE,MAAM,GACZ,wBAAwB,CAQ1B;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,wBAAwB,EAC9B,KAAK,EAAE,wBAAwB,GAC9B,MAAM,CAcR"}

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

@@ -0,0 +1,57 @@
+import { FUNCTION_PLACEHOLDER, normalizeRuntimeValue, UNAVAILABLE_PLACEHOLDER, } from "./annotation-target-runtime.js";
+import { cloneDiagnosticTarget } from "./annotation-target-cloning.js";
+import { compareSourcePositions } from "./annotation-source-range.js";
+export function sortableDiagnostic(diagnostic, order) {
+    return {
+        diagnostic: {
+            ...diagnostic,
+            target: cloneDiagnosticTarget(diagnostic.target),
+        },
+        order,
+    };
+}
+export 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 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);
+    }
+}
+//# sourceMappingURL=annotation-target-diagnostics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-target-diagnostics.js","sourceRoot":"","sources":["../../src/api/annotation-target-diagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAOtE,MAAM,UAAU,kBAAkB,CAChC,UAAkC,EAClC,KAAa;IAEb,OAAO;QACL,UAAU,EAAE;YACV,GAAG,UAAU;YACb,MAAM,EAAE,qBAAqB,CAAC,UAAU,CAAC,MAAM,CAAC;SACjD;QACD,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAA8B,EAC9B,KAA+B;IAE/B,OAAO,CACL,0BAA0B,CACxB,IAAI,CAAC,UAAU,CAAC,WAAW,EAC3B,KAAK,CAAC,UAAU,CAAC,WAAW,CAC7B;QACD,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3D,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QACjE,cAAc,CACZ,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EACrC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CACvC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CACzB,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,IAA6B,EAC7B,KAA8B;IAE9B,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,OAAO,CACL,sBAAsB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;QAC/C,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,KAAa;IACjD,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,aAAa,CAAC,MAAe;IACpC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;QAEjE,OAAO,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,oBAAoB,CAAC;QAC9B,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClD,OAAO,uBAAuB,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/api/annotation-target-validation.d.ts

@@ -1,4 +1,4 @@
-import type { EngineAnnotation, EngineAnnotationTarget, EngineDocument, EngineTargetDiagnostic } from "./document.js";
+import type { EngineAnnotation, EngineDocument, EngineTargetDiagnostic } from "./document.js";
+export { cloneAnnotationTarget } from "./annotation-target-cloning.js";
 export declare function annotationTargetDiagnostics(document: EngineDocument, annotations: readonly EngineAnnotation[]): EngineTargetDiagnostic[];
-export declare function cloneAnnotationTarget(target: EngineAnnotationTarget): EngineAnnotationTarget;
 //# sourceMappingURL=annotation-target-validation.d.ts.map

package/dist/api/annotation-target-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotation-target-validation.d.ts","sourceRoot":"","sources":["../../src/api/annotation-target-validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EAEd,sBAAsB,EACvB,MAAM,eAAe,CAAC;AA8BvB,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,SAAS,gBAAgB,EAAE,GACvC,sBAAsB,EAAE,CAkB1B;AAoVD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAUxB"}
+{"version":3,"file":"annotation-target-validation.d.ts","sourceRoot":"","sources":["../../src/api/annotation-target-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,cAAc,EAEd,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAsBvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,SAAS,gBAAgB,EAAE,GACvC,sBAAsB,EAAE,CAkB1B"}