@coldtea/pr-lens-schema 0.1.0

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;GAKG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;kBAAoC,CAAC;AAC3D,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyC,CAAC;AAChE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyC,CAAC;AAChE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAoC,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAoBsC,CAAC;AAC3D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,eAAO,MAAM,SAAS,YACpB,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,CACH,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,WAAY;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,KAAG,OAA0C,CAAC;AAE/C,+DAA+D;AAC/D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqBmB,CAAC;AACzC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/patch.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import { Flow, GraphEdge, GraphNode, Lane, Stats } from "./graph.js";
+import { FullSha, Id, SchemaVersionField, Summary } from "./primitives.js";
+/**
+ * Update payloads are the element minus its id: a patch never renames the
+ * thing it addresses. Every field is optional and only the supplied fields
+ * are written, so two producers can patch different facets of one element
+ * without clobbering each other.
+ */
+export const LanePatch = Lane.omit({ id: true }).partial();
+export const NodePatch = GraphNode.omit({ id: true }).partial();
+export const EdgePatch = GraphEdge.omit({ id: true }).partial();
+export const FlowPatch = Flow.omit({ id: true }).partial();
+/**
+ * Operations that evolve a stored graph — in practice the baseline map, which
+ * is updated by each merged pull request rather than re-extracted wholesale.
+ *
+ * `remove_*` deletes the element from the map. That is a different statement
+ * from `delta: "removed"`, which says an element still exists in the map but
+ * is being deleted by the change under review.
+ */
+export const PatchOp = z
+    .discriminatedUnion("op", [
+    z.strictObject({ op: z.literal("add_lane"), lane: Lane }),
+    z.strictObject({ op: z.literal("update_lane"), id: Id, patch: LanePatch }),
+    z.strictObject({ op: z.literal("remove_lane"), id: Id }),
+    z.strictObject({ op: z.literal("add_node"), node: GraphNode }),
+    z.strictObject({ op: z.literal("update_node"), id: Id, patch: NodePatch }),
+    z.strictObject({ op: z.literal("remove_node"), id: Id }),
+    z.strictObject({ op: z.literal("add_edge"), edge: GraphEdge }),
+    z.strictObject({ op: z.literal("update_edge"), id: Id, patch: EdgePatch }),
+    z.strictObject({ op: z.literal("remove_edge"), id: Id }),
+    z.strictObject({ op: z.literal("add_flow"), flow: Flow }),
+    z.strictObject({ op: z.literal("update_flow"), id: Id, patch: FlowPatch }),
+    z.strictObject({ op: z.literal("remove_flow"), id: Id }),
+    z.strictObject({ op: z.literal("set_stats"), stats: Stats }),
+])
+    .describe("A single change to a stored graph document.");
+export const PATCH_OPS = [
+    "add_lane",
+    "update_lane",
+    "remove_lane",
+    "add_node",
+    "update_node",
+    "remove_node",
+    "add_edge",
+    "update_edge",
+    "remove_edge",
+    "add_flow",
+    "update_flow",
+    "remove_flow",
+    "set_stats",
+];
+/**
+ * A patch has to move the map: the same commit at both ends describes no
+ * transition, and such a patch could be applied over and over.
+ *
+ * The rule lives here as a predicate because a zod refinement does not
+ * survive into the inferred type — a caller holding a `PatchDoc` it built
+ * itself has to be held to the same rule as one that came from a parser.
+ */
+export const targetDescribesATransition = (target) => target.fromSha !== target.toSha;
+/** An ordered batch of operations against one stored graph. */
+export const PatchDoc = z
+    .strictObject({
+    schemaVersion: SchemaVersionField,
+    kind: z.literal("patch"),
+    generatedAt: z.iso.datetime().optional(),
+    summary: Summary.optional().describe("Why the map is changing, in prose."),
+    target: z
+        .strictObject({
+        graphId: Id.describe("Id of the stored graph being patched."),
+        fromSha: FullSha.describe("Commit the stored graph reflects before the operations run."),
+        toSha: FullSha.describe("Commit it reflects once they have."),
+    })
+        .refine(targetDescribesATransition, {
+        message: "a patch has to move the map to a different commit",
+        path: ["toSha"],
+    })
+        .describe("Which stored graph these operations belong to, and which commits they carry it between. All three are required, and the commits must differ: they are what stops a patch landing on the wrong map, on a stale one, or twice."),
+    ops: z.array(PatchOp).min(1).max(512).describe("Applied in array order."),
+})
+    .describe("A PR Lens patch document.");
+//# sourceMappingURL=patch.js.map

package/dist/patch.js.map

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

package/dist/primitives.d.ts

@@ -0,0 +1,92 @@
+import { z } from "zod";
+/**
+ * Identifiers are authored by an extraction model, so they are constrained to
+ * a shape that survives being embedded in an SVG id, a URL fragment and a
+ * GitHub comment anchor without escaping.
+ */
+export declare const Id: z.ZodString;
+export type Id = z.infer<typeof Id>;
+/**
+ * The loose shape is checked here and the supported range is checked by the
+ * parser, which can say which version it implements. The exported JSON
+ * Schemas carry the range instead, since they have no parser behind them.
+ */
+export declare const SchemaVersionField: z.ZodString;
+/** Non-empty single-line label rendered on a card, lane header or edge. */
+export declare const Label: z.ZodString;
+/** Prose shown in drill-down bodies; kept short enough to stay scannable. */
+export declare const Summary: z.ZodString;
+export declare const Sha: z.ZodString;
+/**
+ * Abbreviations are fine for something a human reads, but not for deciding
+ * whether two records mean the same commit: two abbreviations of different
+ * lengths compare unequal, and a short one can collide as a repository grows.
+ * Anything a machine compares uses the full name.
+ */
+export declare const FullSha: z.ZodString;
+/**
+ * The two lenses PR Lens ships. The enum is additive: a future contract
+ * version may introduce further lenses, and consumers must treat an unknown
+ * lens as "skip this view" rather than as a hard failure.
+ */
+export declare const Lens: z.ZodEnum<{
+    architecture: "architecture";
+    "data-flow": "data-flow";
+}>;
+export type Lens = z.infer<typeof Lens>;
+export declare const LENSES: ("architecture" | "data-flow")[];
+/** The two renders that make a `<picture>` pair. */
+export declare const Theme: z.ZodEnum<{
+    dark: "dark";
+    light: "light";
+}>;
+export type Theme = z.infer<typeof Theme>;
+export declare const THEMES: ("dark" | "light")[];
+/**
+ * A render is one asset per view per theme, so these two caps are one rule
+ * rather than two numbers that happen to sit near each other: a document with
+ * more views than a manifest can carry at every theme is one whose full
+ * render could never be described, however well formed it looks.
+ *
+ * Deriving the view cap from the asset budget keeps the relationship in one
+ * place — raise the budget, or add a theme, and the other end moves with it
+ * instead of every surface rediscovering the arithmetic.
+ *
+ * The cap is deliberately the worst case, every theme rendered, rather than
+ * what some particular render would emit. A renderer asked for one theme
+ * could describe twice as many views, but then whether a document is
+ * renderable would depend on how it was asked to be rendered, and the promise
+ * this package exists to make — if it parses, it renders — would need a
+ * second rule at a second boundary to stay true.
+ */
+export declare const MAX_RENDER_ASSETS = 256;
+export declare const MAX_VIEWS: number;
+/**
+ * How an element relates to the base branch. `unchanged` elements are the
+ * context a reader needs to judge blast radius, so they are first-class
+ * rather than omitted.
+ */
+export declare const Delta: z.ZodEnum<{
+    added: "added";
+    modified: "modified";
+    removed: "removed";
+    unchanged: "unchanged";
+}>;
+export type Delta = z.infer<typeof Delta>;
+export declare const DELTAS: ("added" | "modified" | "removed" | "unchanged")[];
+/**
+ * A pointer into the head tree, used to build diff permalinks. Line numbers
+ * are 1-based and refer to the head revision except on `removed` elements,
+ * where they refer to the base revision.
+ */
+export declare const FileRef: z.ZodObject<{
+    path: z.ZodString;
+    startLine: z.ZodOptional<z.ZodInt>;
+    endLine: z.ZodOptional<z.ZodInt>;
+    revision: z.ZodOptional<z.ZodEnum<{
+        base: "base";
+        head: "head";
+    }>>;
+}, z.core.$strict>;
+export type FileRef = z.infer<typeof FileRef>;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,eAAO,MAAM,EAAE,aAQ8D,CAAC;AAC9E,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAIkD,CAAC;AAElF,2EAA2E;AAC3E,eAAO,MAAM,KAAK,aAA8D,CAAC;AAEjF,6EAA6E;AAC7E,eAAO,MAAM,OAAO,aAIqD,CAAC;AAE1E,eAAO,MAAM,GAAG,aAGmC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,aAGmB,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,IAAI;;;EAAoE,CAAC;AACtF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,eAAO,MAAM,MAAM,kCAAe,CAAC;AAEnC,oDAAoD;AACpD,eAAO,MAAM,KAAK;;;EAA8E,CAAC;AACjG,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,eAAO,MAAM,MAAM,sBAAgB,CAAC;AAEpC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,eAAO,MAAM,SAAS,QAAoC,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,KAAK;;;;;EAEsC,CAAC;AACzD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,eAAO,MAAM,MAAM,oDAAgB,CAAC;AASpC;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;;;;kBA2B+C,CAAC;AACpE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC"}

package/dist/primitives.js

@@ -0,0 +1,120 @@
+import { z } from "zod";
+import { SCHEMA_VERSION, SUPPORTED_VERSION_PATTERN } from "./version.js";
+/**
+ * Identifiers are authored by an extraction model, so they are constrained to
+ * a shape that survives being embedded in an SVG id, a URL fragment and a
+ * GitHub comment anchor without escaping.
+ */
+export const Id = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[A-Za-z0-9][A-Za-z0-9._:/-]*$/, "must start alphanumeric and contain only letters, digits and . _ : / -")
+    .describe("Stable identifier, unique within its collection in a document.");
+/**
+ * The loose shape is checked here and the supported range is checked by the
+ * parser, which can say which version it implements. The exported JSON
+ * Schemas carry the range instead, since they have no parser behind them.
+ */
+export const SchemaVersionField = z
+    .string()
+    .regex(/^\d+\.\d+\.\d+$/, "must be a semver string, e.g. 0.1.0")
+    .meta({ pattern: SUPPORTED_VERSION_PATTERN })
+    .describe(`Contract version the document targets. Current: ${SCHEMA_VERSION}.`);
+/** Non-empty single-line label rendered on a card, lane header or edge. */
+export const Label = z.string().min(1).max(120).describe("Short display label.");
+/** Prose shown in drill-down bodies; kept short enough to stay scannable. */
+export const Summary = z
+    .string()
+    .min(1)
+    .max(2000)
+    .describe("One or two sentences of plain prose. No markdown headings.");
+export const Sha = z
+    .string()
+    .regex(/^[0-9a-f]{7,40}$/, "must be a lowercase hex git object name")
+    .describe("Git commit sha, abbreviated or full.");
+/**
+ * Abbreviations are fine for something a human reads, but not for deciding
+ * whether two records mean the same commit: two abbreviations of different
+ * lengths compare unequal, and a short one can collide as a repository grows.
+ * Anything a machine compares uses the full name.
+ */
+export const FullSha = z
+    .string()
+    .regex(/^[0-9a-f]{40}$/, "must be a full 40-character lowercase hex git object name")
+    .describe("Git commit sha, in full.");
+/**
+ * The two lenses PR Lens ships. The enum is additive: a future contract
+ * version may introduce further lenses, and consumers must treat an unknown
+ * lens as "skip this view" rather than as a hard failure.
+ */
+export const Lens = z.enum(["architecture", "data-flow"]).describe("Rendering lens.");
+export const LENSES = Lens.options;
+/** The two renders that make a `<picture>` pair. */
+export const Theme = z.enum(["light", "dark"]).describe("Which colour scheme a render targets.");
+export const THEMES = Theme.options;
+/**
+ * A render is one asset per view per theme, so these two caps are one rule
+ * rather than two numbers that happen to sit near each other: a document with
+ * more views than a manifest can carry at every theme is one whose full
+ * render could never be described, however well formed it looks.
+ *
+ * Deriving the view cap from the asset budget keeps the relationship in one
+ * place — raise the budget, or add a theme, and the other end moves with it
+ * instead of every surface rediscovering the arithmetic.
+ *
+ * The cap is deliberately the worst case, every theme rendered, rather than
+ * what some particular render would emit. A renderer asked for one theme
+ * could describe twice as many views, but then whether a document is
+ * renderable would depend on how it was asked to be rendered, and the promise
+ * this package exists to make — if it parses, it renders — would need a
+ * second rule at a second boundary to stay true.
+ */
+export const MAX_RENDER_ASSETS = 256;
+export const MAX_VIEWS = MAX_RENDER_ASSETS / THEMES.length;
+/**
+ * How an element relates to the base branch. `unchanged` elements are the
+ * context a reader needs to judge blast radius, so they are first-class
+ * rather than omitted.
+ */
+export const Delta = z
+    .enum(["added", "modified", "removed", "unchanged"])
+    .describe("Change state relative to the base commit.");
+export const DELTAS = Delta.options;
+/**
+ * One rule both representations share: no absolute path in any spelling a
+ * platform recognises, and no `..` segment. A path that breaks it cannot
+ * produce a diff permalink, whatever else it might mean.
+ */
+const REPOSITORY_PATH = /^(?!\/)(?![A-Za-z]:)(?!.*\\)(?!.*(?:^|\/)\.\.(?:\/|$)).+$/;
+/**
+ * A pointer into the head tree, used to build diff permalinks. Line numbers
+ * are 1-based and refer to the head revision except on `removed` elements,
+ * where they refer to the base revision.
+ */
+export const FileRef = z
+    .strictObject({
+    path: z
+        .string()
+        .min(1)
+        .max(1024)
+        .regex(REPOSITORY_PATH, "must be a repository-relative POSIX path, without a drive letter, a backslash or a '..' segment")
+        .describe("Repository-relative path, POSIX separators."),
+    startLine: z.int().min(1).optional().describe("1-based first line."),
+    endLine: z.int().min(1).optional().describe("1-based last line, inclusive."),
+    revision: z
+        .enum(["head", "base"])
+        .optional()
+        .describe("Which side of the diff the lines refer to. Defaults to head."),
+})
+    .meta({ dependentRequired: { endLine: ["startLine"] } })
+    .refine((f) => f.endLine === undefined || f.startLine !== undefined, {
+    message: "endLine requires startLine",
+    path: ["endLine"],
+})
+    .refine((f) => f.endLine === undefined || f.startLine === undefined || f.endLine >= f.startLine, {
+    message: "endLine must be greater than or equal to startLine",
+    path: ["endLine"],
+})
+    .describe("A file (and optional line range) backing an element.");
+//# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Ends a switch over a closed set. Adding a variant then fails to compile at
+ * every consumer instead of silently falling through at runtime.
+ */
+export declare const assertNever: (value: never, message?: string) => never;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,WAAW,UAAW,KAAK,uBAAkC,KAEzE,CAAC"}

package/dist/utils.js

@@ -0,0 +1,8 @@
+/**
+ * Ends a switch over a closed set. Adding a variant then fails to compile at
+ * every consumer instead of silently falling through at runtime.
+ */
+export const assertNever = (value, message = "Unhandled variant") => {
+    throw new Error(`${message}: ${JSON.stringify(value)}`);
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAY,EAAE,OAAO,GAAG,mBAAmB,EAAS,EAAE;IAChF,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,18 @@
+import { Config } from "./config.js";
+import { type Parsed } from "./errors.js";
+import { GraphDoc } from "./graph.js";
+import { RenderManifest } from "./manifest.js";
+import { PatchDoc } from "./patch.js";
+/**
+ * Structure, contract version and referential integrity in one pass. A
+ * document that survives this is safe to render without further checking.
+ */
+export declare const safeParseGraphDoc: (input: unknown) => Parsed<GraphDoc>;
+export declare const parseGraphDoc: (input: unknown) => GraphDoc;
+export declare const safeParsePatchDoc: (input: unknown) => Parsed<PatchDoc>;
+export declare const parsePatchDoc: (input: unknown) => PatchDoc;
+export declare const safeParseConfig: (input: unknown) => Parsed<Config>;
+export declare const parseConfig: (input: unknown) => Config;
+export declare const safeParseRenderManifest: (input: unknown) => Parsed<RenderManifest>;
+export declare const parseRenderManifest: (input: unknown) => RenderManifest;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAmC,KAAK,MAAM,EAAoB,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA6FtC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,UAAW,OAAO,KAAG,MAAM,CAAC,QAAQ,CAI9D,CAAC;AAEL,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,QAA4C,CAAC;AAE5F,eAAO,MAAM,iBAAiB,UAAW,OAAO,KAAG,MAAM,CAAC,QAAQ,CAG/D,CAAC;AAEJ,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,QAA4C,CAAC;AAE5F,eAAO,MAAM,eAAe,UAAW,OAAO,KAAG,MAAM,CAAC,MAAM,CAG3D,CAAC;AAEJ,eAAO,MAAM,WAAW,UAAW,OAAO,KAAG,MAAwC,CAAC;AAEtF,eAAO,MAAM,uBAAuB,UAAW,OAAO,KAAG,MAAM,CAAC,cAAc,CAG3E,CAAC;AAEJ,eAAO,MAAM,mBAAmB,UAAW,OAAO,KAAG,cACb,CAAC"}

package/dist/validate.js

@@ -0,0 +1,95 @@
+import { Config } from "./config.js";
+import { formatIssues, PrLensSchemaError } from "./errors.js";
+import { GraphDoc } from "./graph.js";
+import { graphIntegrityIssues } from "./integrity.js";
+import { RenderManifest } from "./manifest.js";
+import { PatchDoc } from "./patch.js";
+import { isSupportedVersion, SCHEMA_VERSION } from "./version.js";
+const formatPath = (path) => path.reduce((acc, segment) => {
+    if (typeof segment === "number")
+        return `${acc}[${segment}]`;
+    return acc === "" ? String(segment) : `${acc}.${String(segment)}`;
+}, "");
+const toIssues = (error) => error.issues.map((issue) => ({
+    code: "INVALID_DOCUMENT",
+    path: formatPath(issue.path),
+    message: issue.message,
+}));
+const versionIssues = (version, path) => isSupportedVersion(version)
+    ? []
+    : [
+        {
+            code: "UNSUPPORTED_SCHEMA_VERSION",
+            path,
+            message: `document targets schema version ${version}; this package implements ${SCHEMA_VERSION}`,
+        },
+    ];
+const fail = (label, issues) => {
+    const first = issues[0];
+    return new PrLensSchemaError(first ? first.code : "INVALID_DOCUMENT", `invalid ${label}:\n${formatIssues(issues)}`, issues);
+};
+/**
+ * Validating a recursive structure recurses, so a document nested deeply
+ * enough exhausts the stack while zod is still walking it — before any check
+ * of ours can count anything. A `safeParse` that throws would be a worse
+ * failure than the document it was handed, so the stack running out is
+ * reported as what it is: a document too deep to read.
+ *
+ * Every `RangeError` is read that way, not only the ones provoked by depth.
+ * That is deliberate: failing closed keeps the promise that these functions
+ * return a verdict rather than throwing one, and nesting is the only way a
+ * document is known to provoke one. Narrowing this to rethrow would trade
+ * that promise for a diagnosis.
+ */
+const attemptParse = (schema, input) => {
+    try {
+        const result = schema.safeParse(input);
+        return result.success
+            ? { read: true, value: result.data }
+            : { read: false, issues: toIssues(result.error) };
+    }
+    catch (error) {
+        if (!(error instanceof RangeError))
+            throw error;
+        return {
+            read: false,
+            issues: [
+                {
+                    code: "INVALID_DOCUMENT",
+                    path: "",
+                    message: "document nests too deeply to read",
+                },
+            ],
+        };
+    }
+};
+const parseDocument = (schema, label, input, extraIssues) => {
+    const result = attemptParse(schema, input);
+    if (!result.read)
+        return { ok: false, error: fail(label, result.issues) };
+    const issues = extraIssues(result.value);
+    if (issues.length > 0)
+        return { ok: false, error: fail(label, issues) };
+    return { ok: true, value: result.value };
+};
+const unwrap = (parsed) => {
+    if (parsed.ok)
+        return parsed.value;
+    throw parsed.error;
+};
+/**
+ * Structure, contract version and referential integrity in one pass. A
+ * document that survives this is safe to render without further checking.
+ */
+export const safeParseGraphDoc = (input) => parseDocument(GraphDoc, "graph document", input, (doc) => [
+    ...versionIssues(doc.schemaVersion, "schemaVersion"),
+    ...graphIntegrityIssues(doc),
+]);
+export const parseGraphDoc = (input) => unwrap(safeParseGraphDoc(input));
+export const safeParsePatchDoc = (input) => parseDocument(PatchDoc, "patch document", input, (doc) => versionIssues(doc.schemaVersion, "schemaVersion"));
+export const parsePatchDoc = (input) => unwrap(safeParsePatchDoc(input));
+export const safeParseConfig = (input) => parseDocument(Config, "config", input, (config) => versionIssues(config.schemaVersion, "schemaVersion"));
+export const parseConfig = (input) => unwrap(safeParseConfig(input));
+export const safeParseRenderManifest = (input) => parseDocument(RenderManifest, "render manifest", input, (manifest) => versionIssues(manifest.schemaVersion, "schemaVersion"));
+export const parseRenderManifest = (input) => unwrap(safeParseRenderManifest(input));
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Version of the PR Lens document contract.
+ *
+ * Every document carries this string so a consumer can refuse, migrate, or
+ * degrade gracefully when it meets a document it was not built for. Bumped
+ * with semver semantics: patch/minor releases only ever add optional fields
+ * or widen an enum, a major release may remove or retype a field.
+ */
+export declare const SCHEMA_VERSION: "0.1.0";
+export type SchemaVersion = typeof SCHEMA_VERSION;
+/**
+ * Which versions this package reads, as a pattern so the rule can be carried
+ * into the exported JSON Schemas rather than restated there.
+ *
+ * Below 1.0 a minor bump is allowed to break, so only the exact major.minor
+ * is accepted; from 1.0 on, the major must match and a newer minor is
+ * readable because minor releases only add optional fields.
+ */
+export declare const SUPPORTED_VERSION_PATTERN: string;
+export declare const isSupportedVersion: (version: string) => boolean;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAG,OAAgB,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC;AAMlD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,QAG0B,CAAC;AAEjE,eAAO,MAAM,kBAAkB,YAAa,MAAM,KAAG,OACA,CAAC"}

package/dist/version.js

@@ -0,0 +1,24 @@
+/**
+ * Version of the PR Lens document contract.
+ *
+ * Every document carries this string so a consumer can refuse, migrate, or
+ * degrade gracefully when it meets a document it was not built for. Bumped
+ * with semver semantics: patch/minor releases only ever add optional fields
+ * or widen an enum, a major release may remove or retype a field.
+ */
+export const SCHEMA_VERSION = "0.1.0";
+const [currentMajor = "0", currentMinor = "0"] = SCHEMA_VERSION.split(".");
+const readableMinors = Array.from({ length: Number(currentMinor) + 1 }, (_, minor) => minor);
+/**
+ * Which versions this package reads, as a pattern so the rule can be carried
+ * into the exported JSON Schemas rather than restated there.
+ *
+ * Below 1.0 a minor bump is allowed to break, so only the exact major.minor
+ * is accepted; from 1.0 on, the major must match and a newer minor is
+ * readable because minor releases only add optional fields.
+ */
+export const SUPPORTED_VERSION_PATTERN = currentMajor === "0"
+    ? `^0\\.${currentMinor}\\.\\d+$`
+    : `^${currentMajor}\\.(${readableMinors.join("|")})\\.\\d+$`;
+export const isSupportedVersion = (version) => new RegExp(SUPPORTED_VERSION_PATTERN).test(version);
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAgB,CAAC;AAI/C,MAAM,CAAC,YAAY,GAAG,GAAG,EAAE,YAAY,GAAG,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAE3E,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAE7F;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GACpC,YAAY,KAAK,GAAG;IAClB,CAAC,CAAC,QAAQ,YAAY,UAAU;IAChC,CAAC,CAAC,IAAI,YAAY,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;AAEjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAe,EAAW,EAAE,CAC7D,IAAI,MAAM,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC"}