@x12i/graphenix-core 2.0.0

package/README.md

@@ -0,0 +1,252 @@
+# @x12i/graphenix-core
+
+Core tier of the Graphenix ecosystem — **Format 2.0.0**.
+
+Execution-neutral graph description: JSON schema, TypeScript types, validation, and CRUD helpers. Profile packages build strict subtypes on top of this core via generic metadata, typed parameters, and `validateGraphWithProfile()`.
+
+## Install
+
+```bash
+npm install @x12i/graphenix-core
+```
+
+## Validate a graph document
+
+```ts
+import {
+  validateGraph,
+  GRAPHENIX_FORMAT_VERSION,
+  type GraphDocument
+} from "@x12i/graphenix-core";
+
+const doc: GraphDocument = {
+  formatVersion: GRAPHENIX_FORMAT_VERSION,
+  id: "graph:auth/user-signup",
+  graph: {
+    nodes: [],
+    edges: [],
+    inputs: [],
+    outputs: []
+  }
+};
+
+const result = validateGraph(doc);
+if (!result.valid) {
+  console.error(result.errors);
+}
+```
+
+Each error is a `GraphValidationError`:
+
+- **`message`** — human-readable message
+- **`path`** — JSON Pointer to the failing instance
+- **`keyword`** / **`params`** — from AJV when applicable
+- **`source`** — `'graphenix'` or `'profile'`
+- **`code`** — optional profile-specific error code
+
+---
+
+## Document fields
+
+| Field | Required | Description |
+| ----- | -------- | ----------- |
+| `formatVersion` | yes | Must be `"2.0.0"` |
+| `id` | yes | Globally unique graph identifier |
+| `revision` | no | Version of this graph document (not the format version) |
+| `graph` | yes | Structural graph (nodes, edges, inputs, outputs) |
+| `metadata` | no | Document metadata, extensions, summary contracts |
+| `types` | no | Custom type definitions |
+| `subgraphs` | no | Inlined reusable graphs |
+
+---
+
+## Namespaced extensions (`metadata.extensions`)
+
+Custom data lives in `metadata.extensions`, keyed by namespace (e.g. `x12i.execution/v1`). Graphenix core validates that `extensions` is an object but does not interpret namespace payloads.
+
+```json
+{
+  "graph": {
+    "metadata": {
+      "extensions": {
+        "x12i.execution/v1": {
+          "modelConfig": {}
+        }
+      }
+    }
+  }
+}
+```
+
+The same convention applies on document, graph, node, edge, input, output, type, and subgraph metadata.
+
+```ts
+import type { GraphenixMetadata, GraphenixExtensions } from "@x12i/graphenix-core";
+
+type X12iGraphMetadata = GraphenixMetadata & {
+  extensions: GraphenixExtensions & {
+    "x12i.execution/v1": { modelConfig: Record<string, unknown> };
+  };
+};
+```
+
+Execution-specific fields (models, runtime, credentials, studio envelopes, etc.) belong in profile packages via extensions — not in Graphenix core.
+
+---
+
+## Generic types for profile subtypes
+
+```ts
+import type { GraphDocument, GraphenixMetadata } from "@x12i/graphenix-core";
+
+interface X12iGraphMetadata extends GraphenixMetadata {
+  extensions: {
+    "x12i.execution/v1": { modelConfig: Record<string, unknown> };
+  };
+}
+
+type X12iNodeParameters = { prompt?: string };
+
+type X12iExecutableGraphDocument = GraphDocument<
+  GraphenixMetadata,
+  X12iGraphMetadata,
+  X12iNodeParameters,
+  GraphenixMetadata
+>;
+```
+
+Aliases: `GraphNode`, `GraphEdge`, `GraphPort`, `GraphType`, `Subgraph`.
+
+---
+
+## Profile validation
+
+```ts
+import {
+  validateGraphWithProfile,
+  type GraphProfileValidator,
+  type GraphValidationError
+} from "@x12i/graphenix-core";
+
+const validateX12iProfile: GraphProfileValidator = (doc) => {
+  const errors: GraphValidationError[] = [];
+  const ext = doc.graph.metadata?.extensions?.["x12i.execution/v1"];
+  if (!ext || typeof ext !== "object" || !("modelConfig" in ext)) {
+    errors.push({
+      source: "profile",
+      code: "X12I_MODEL_CONFIG_MISSING",
+      message: "Execution profile is missing modelConfig.",
+      path: "/graph/metadata/extensions/x12i.execution~1v1/modelConfig"
+    });
+  }
+  return { valid: errors.length === 0, errors };
+};
+
+validateGraphWithProfile(doc, validateX12iProfile);
+```
+
+Base validation runs first; profile validation runs only when base validation passes.
+
+---
+
+## Input and output contracts
+
+**Per-port input contract** — `graph.inputs[].contract`:
+
+```json
+{
+  "id": "rawRecord",
+  "type": "object",
+  "target": { "nodeId": "q1", "portId": "record" },
+  "contract": {
+    "semanticKind": "record",
+    "required": true,
+    "schema": { "type": "object" }
+  }
+}
+```
+
+**Per-port output contract** — `graph.outputs[].contract`:
+
+```json
+{
+  "id": "graph-output:final",
+  "type": "builtin:object",
+  "source": { "nodeId": "node:finalizer", "portId": "out:final" },
+  "contract": {
+    "semanticKind": "final-output",
+    "required": true,
+    "schema": { "type": "object" }
+  }
+}
+```
+
+**Graph-level summary contracts** — complement per-port contracts:
+
+| Layer | Purpose |
+| ----- | ------- |
+| `graph.inputs[].contract` | Contract for a specific graph input port |
+| `metadata.graphEntry` | Summary contract for graph invocation |
+| `graph.outputs[].contract` | Contract for a specific graph output port |
+| `metadata.graphResponse` | Summary contract for final graph result |
+
+Optional AJV checks against `executionSchema` / `finalOutputSchema`:
+
+```ts
+import {
+  validateExecutionAgainstContract,
+  validateFinalOutputAgainstContract
+} from "@x12i/graphenix-core";
+```
+
+See [`docs/interop-worox-graph.md`](./docs/interop-worox-graph.md) for worox-graph interop notes.
+
+---
+
+## CRUD helpers
+
+Immutable by default; pass `{ mutate: true }` to modify in place.
+
+```ts
+import { addNode, updateNode, removeNode, addEdge } from "@x12i/graphenix-core";
+```
+
+- **Nodes**: `getNode`, `addNode`, `updateNode`, `removeNode`
+- **Edges**: `getEdge`, `addEdge`, `updateEdge`, `removeEdge`
+- **Types**: `getType`, `addType`, `updateType`, `removeType`
+- **Subgraphs**: `getSubgraph`, `addSubgraph`, `updateSubgraph`, `removeSubgraph`
+
+---
+
+## JSON Schema
+
+Published at `schema/graphenix-format-2.0.0.schema.json` (`$id`: `https://graphenix.dev/schema/graphenix-format-2.0.0.json`).
+
+Full field reference: [`GRAPHENIX-FORMAT.md`](./GRAPHENIX-FORMAT.md).
+
+---
+
+## Development
+
+From the monorepo root:
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+Or from this package:
+
+```bash
+npm run build
+npm test
+```
+
+---
+
+## Notes
+
+- **Execution-agnostic** — core defines structure only.
+- Profile packages enforce execution semantics via extensions, typed parameters, and profile validators.
+- Graphenix may **allow** execution-specific data through `metadata.extensions`; core does not interpret or enforce it.

package/dist/crud.d.ts

@@ -0,0 +1,25 @@
+import type { GraphDocument, Node, Edge, TypeDefinition, SubgraphDefinition } from "./types";
+export interface CrudOptions {
+    /**
+     * When true, mutations are applied to the passed-in object.
+     * When false (default), a shallow-cloned document is returned.
+     */
+    mutate?: boolean;
+}
+export declare function getNode(doc: GraphDocument, nodeId: string): Node | undefined;
+export declare function addNode(doc: GraphDocument, node: Node, options?: CrudOptions): GraphDocument;
+export declare function updateNode(doc: GraphDocument, nodeId: string, patch: Partial<Node>, options?: CrudOptions): GraphDocument;
+export declare function removeNode(doc: GraphDocument, nodeId: string, options?: CrudOptions): GraphDocument;
+export declare function getEdge(doc: GraphDocument, edgeId: string): Edge | undefined;
+export declare function addEdge(doc: GraphDocument, edge: Edge, options?: CrudOptions): GraphDocument;
+export declare function updateEdge(doc: GraphDocument, edgeId: string, patch: Partial<Edge>, options?: CrudOptions): GraphDocument;
+export declare function removeEdge(doc: GraphDocument, edgeId: string, options?: CrudOptions): GraphDocument;
+export declare function getType(doc: GraphDocument, typeId: string): TypeDefinition | undefined;
+export declare function addType(doc: GraphDocument, typeDef: TypeDefinition, options?: CrudOptions): GraphDocument;
+export declare function updateType(doc: GraphDocument, typeId: string, patch: Partial<TypeDefinition>, options?: CrudOptions): GraphDocument;
+export declare function removeType(doc: GraphDocument, typeId: string, options?: CrudOptions): GraphDocument;
+export declare function getSubgraph(doc: GraphDocument, subgraphId: string): SubgraphDefinition | undefined;
+export declare function addSubgraph(doc: GraphDocument, subgraph: SubgraphDefinition, options?: CrudOptions): GraphDocument;
+export declare function updateSubgraph(doc: GraphDocument, subgraphId: string, patch: Partial<SubgraphDefinition>, options?: CrudOptions): GraphDocument;
+export declare function removeSubgraph(doc: GraphDocument, subgraphId: string, options?: CrudOptions): GraphDocument;
+//# sourceMappingURL=crud.d.ts.map

package/dist/crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../src/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,IAAI,EACJ,IAAI,EACJ,cAAc,EACd,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgBD,wBAAgB,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5E;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAQf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CASf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAef;AAID,wBAAgB,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5E;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAQf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CASf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CASf;AAID,wBAAgB,OAAO,CACrB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,GAAG,SAAS,CAE5B;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAQf;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,EAC9B,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAef;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAWf;AAID,wBAAgB,WAAW,CACzB,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,GACjB,kBAAkB,GAAG,SAAS,CAEhC;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAQf;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,EAClC,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAef;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAWf"}

package/dist/crud.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNode = getNode;
+exports.addNode = addNode;
+exports.updateNode = updateNode;
+exports.removeNode = removeNode;
+exports.getEdge = getEdge;
+exports.addEdge = addEdge;
+exports.updateEdge = updateEdge;
+exports.removeEdge = removeEdge;
+exports.getType = getType;
+exports.addType = addType;
+exports.updateType = updateType;
+exports.removeType = removeType;
+exports.getSubgraph = getSubgraph;
+exports.addSubgraph = addSubgraph;
+exports.updateSubgraph = updateSubgraph;
+exports.removeSubgraph = removeSubgraph;
+function cloneIfNeeded(value, mutate) {
+    if (mutate)
+        return value;
+    return structuredClone(value);
+}
+function ensureGraph(doc) {
+    if (!doc.graph) {
+        throw new Error("GraphDocument.graph is missing");
+    }
+    return doc.graph;
+}
+// NODES
+function getNode(doc, nodeId) {
+    return ensureGraph(doc).nodes.find((n) => n.id === nodeId);
+}
+function addNode(doc, node, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    if (graph.nodes.some((n) => n.id === node.id)) {
+        throw new Error(`Node with id '${node.id}' already exists`);
+    }
+    graph.nodes.push(node);
+    return next;
+}
+function updateNode(doc, nodeId, patch, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    const idx = graph.nodes.findIndex((n) => n.id === nodeId);
+    if (idx === -1) {
+        throw new Error(`Node with id '${nodeId}' not found`);
+    }
+    graph.nodes[idx] = { ...graph.nodes[idx], ...patch, id: graph.nodes[idx].id };
+    return next;
+}
+function removeNode(doc, nodeId, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    const before = graph.nodes.length;
+    graph.nodes = graph.nodes.filter((n) => n.id !== nodeId);
+    if (graph.nodes.length === before) {
+        throw new Error(`Node with id '${nodeId}' not found`);
+    }
+    // Also remove edges and graph IO that reference this node
+    graph.edges = graph.edges.filter((e) => e.from.nodeId !== nodeId && e.to.nodeId !== nodeId);
+    graph.inputs = graph.inputs.filter((i) => i.target.nodeId !== nodeId);
+    graph.outputs = graph.outputs.filter((o) => o.source?.nodeId !== nodeId);
+    return next;
+}
+// EDGES
+function getEdge(doc, edgeId) {
+    return ensureGraph(doc).edges.find((e) => e.id === edgeId);
+}
+function addEdge(doc, edge, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    if (graph.edges.some((e) => e.id === edge.id)) {
+        throw new Error(`Edge with id '${edge.id}' already exists`);
+    }
+    graph.edges.push(edge);
+    return next;
+}
+function updateEdge(doc, edgeId, patch, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    const idx = graph.edges.findIndex((e) => e.id === edgeId);
+    if (idx === -1) {
+        throw new Error(`Edge with id '${edgeId}' not found`);
+    }
+    graph.edges[idx] = { ...graph.edges[idx], ...patch, id: graph.edges[idx].id };
+    return next;
+}
+function removeEdge(doc, edgeId, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    const graph = ensureGraph(next);
+    const before = graph.edges.length;
+    graph.edges = graph.edges.filter((e) => e.id !== edgeId);
+    if (graph.edges.length === before) {
+        throw new Error(`Edge with id '${edgeId}' not found`);
+    }
+    return next;
+}
+// TYPES
+function getType(doc, typeId) {
+    return (doc.types ?? []).find((t) => t.id === typeId);
+}
+function addType(doc, typeDef, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.types)
+        next.types = [];
+    if (next.types.some((t) => t.id === typeDef.id)) {
+        throw new Error(`Type with id '${typeDef.id}' already exists`);
+    }
+    next.types.push(typeDef);
+    return next;
+}
+function updateType(doc, typeId, patch, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.types) {
+        throw new Error("No types are defined on this document");
+    }
+    const idx = next.types.findIndex((t) => t.id === typeId);
+    if (idx === -1) {
+        throw new Error(`Type with id '${typeId}' not found`);
+    }
+    next.types[idx] = {
+        ...next.types[idx],
+        ...patch,
+        id: next.types[idx].id
+    };
+    return next;
+}
+function removeType(doc, typeId, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.types) {
+        throw new Error("No types are defined on this document");
+    }
+    const before = next.types.length;
+    next.types = next.types.filter((t) => t.id !== typeId);
+    if (next.types.length === before) {
+        throw new Error(`Type with id '${typeId}' not found`);
+    }
+    return next;
+}
+// SUBGRAPHS
+function getSubgraph(doc, subgraphId) {
+    return (doc.subgraphs ?? []).find((s) => s.id === subgraphId);
+}
+function addSubgraph(doc, subgraph, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.subgraphs)
+        next.subgraphs = [];
+    if (next.subgraphs.some((s) => s.id === subgraph.id)) {
+        throw new Error(`Subgraph with id '${subgraph.id}' already exists`);
+    }
+    next.subgraphs.push(subgraph);
+    return next;
+}
+function updateSubgraph(doc, subgraphId, patch, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.subgraphs) {
+        throw new Error("No subgraphs are defined on this document");
+    }
+    const idx = next.subgraphs.findIndex((s) => s.id === subgraphId);
+    if (idx === -1) {
+        throw new Error(`Subgraph with id '${subgraphId}' not found`);
+    }
+    next.subgraphs[idx] = {
+        ...next.subgraphs[idx],
+        ...patch,
+        id: next.subgraphs[idx].id
+    };
+    return next;
+}
+function removeSubgraph(doc, subgraphId, options) {
+    const next = cloneIfNeeded(doc, options?.mutate);
+    if (!next.subgraphs) {
+        throw new Error("No subgraphs are defined on this document");
+    }
+    const before = next.subgraphs.length;
+    next.subgraphs = next.subgraphs.filter((s) => s.id !== subgraphId);
+    if (next.subgraphs.length === before) {
+        throw new Error(`Subgraph with id '${subgraphId}' not found`);
+    }
+    return next;
+}
+//# sourceMappingURL=crud.js.map

package/dist/crud.js.map

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

package/dist/examples/minimal-graph.d.ts

@@ -0,0 +1,3 @@
+import { type GraphDocument } from "../types";
+export declare const minimalGraph: GraphDocument;
+//# sourceMappingURL=minimal-graph.d.ts.map

package/dist/examples/minimal-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal-graph.d.ts","sourceRoot":"","sources":["../../src/examples/minimal-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAExE,eAAO,MAAM,YAAY,EAAE,aAuG1B,CAAC"}

package/dist/examples/minimal-graph.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.minimalGraph = void 0;
+const types_1 = require("../types");
+exports.minimalGraph = {
+    formatVersion: types_1.GRAPHENIX_FORMAT_VERSION,
+    id: "graph:auth/user-signup",
+    name: "User Signup",
+    graph: {
+        nodes: [
+            {
+                id: "node:validate-input",
+                kind: "builtin:validate",
+                inputs: [
+                    {
+                        id: "in:payload",
+                        direction: "input",
+                        type: "builtin:object",
+                        required: true
+                    }
+                ],
+                outputs: [
+                    {
+                        id: "out:validated",
+                        direction: "output",
+                        type: "builtin:object"
+                    }
+                ],
+                parameters: {
+                    schemaType: "type:User"
+                }
+            },
+            {
+                id: "node:create-user",
+                kind: "task:http-request",
+                inputs: [
+                    {
+                        id: "in:validated",
+                        direction: "input",
+                        type: "type:User",
+                        required: true
+                    }
+                ],
+                outputs: [
+                    {
+                        id: "out:user",
+                        direction: "output",
+                        type: "type:User"
+                    }
+                ],
+                parameters: {
+                    method: "POST",
+                    url: "https://example.com/users"
+                }
+            }
+        ],
+        edges: [
+            {
+                id: "edge:validate-to-create",
+                from: {
+                    nodeId: "node:validate-input",
+                    portId: "out:validated"
+                },
+                to: {
+                    nodeId: "node:create-user",
+                    portId: "in:validated"
+                }
+            }
+        ],
+        inputs: [
+            {
+                id: "graph-input:request",
+                name: "Request Body",
+                type: "builtin:object",
+                target: {
+                    nodeId: "node:validate-input",
+                    portId: "in:payload"
+                },
+                contract: {
+                    semanticKind: "record",
+                    required: true,
+                    schema: { type: "object" }
+                }
+            }
+        ],
+        outputs: [
+            {
+                id: "graph-output:user",
+                name: "Created User",
+                type: "type:User",
+                source: {
+                    nodeId: "node:create-user",
+                    portId: "out:user"
+                }
+            }
+        ]
+    },
+    types: [
+        {
+            id: "type:User",
+            kind: "object",
+            fields: [
+                { name: "id", type: "builtin:string", required: true },
+                { name: "email", type: "builtin:string", required: true }
+            ]
+        }
+    ]
+};
+//# sourceMappingURL=minimal-graph.js.map

package/dist/examples/minimal-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal-graph.js","sourceRoot":"","sources":["../../src/examples/minimal-graph.ts"],"names":[],"mappings":";;;AAAA,oCAAwE;AAE3D,QAAA,YAAY,GAAkB;IACzC,aAAa,EAAE,gCAAwB;IACvC,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE;QACL,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,qBAAqB;gBACzB,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE;oBACN;wBACE,EAAE,EAAE,YAAY;wBAChB,SAAS,EAAE,OAAO;wBAClB,IAAI,EAAE,gBAAgB;wBACtB,QAAQ,EAAE,IAAI;qBACf;iBACF;gBACD,OAAO,EAAE;oBACP;wBACE,EAAE,EAAE,eAAe;wBACnB,SAAS,EAAE,QAAQ;wBACnB,IAAI,EAAE,gBAAgB;qBACvB;iBACF;gBACD,UAAU,EAAE;oBACV,UAAU,EAAE,WAAW;iBACxB;aACF;YACD;gBACE,EAAE,EAAE,kBAAkB;gBACtB,IAAI,EAAE,mBAAmB;gBACzB,MAAM,EAAE;oBACN;wBACE,EAAE,EAAE,cAAc;wBAClB,SAAS,EAAE,OAAO;wBAClB,IAAI,EAAE,WAAW;wBACjB,QAAQ,EAAE,IAAI;qBACf;iBACF;gBACD,OAAO,EAAE;oBACP;wBACE,EAAE,EAAE,UAAU;wBACd,SAAS,EAAE,QAAQ;wBACnB,IAAI,EAAE,WAAW;qBAClB;iBACF;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE,MAAM;oBACd,GAAG,EAAE,2BAA2B;iBACjC;aACF;SACF;QACD,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,yBAAyB;gBAC7B,IAAI,EAAE;oBACJ,MAAM,EAAE,qBAAqB;oBAC7B,MAAM,EAAE,eAAe;iBACxB;gBACD,EAAE,EAAE;oBACF,MAAM,EAAE,kBAAkB;oBAC1B,MAAM,EAAE,cAAc;iBACvB;aACF;SACF;QACD,MAAM,EAAE;YACN;gBACE,EAAE,EAAE,qBAAqB;gBACzB,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE;oBACN,MAAM,EAAE,qBAAqB;oBAC7B,MAAM,EAAE,YAAY;iBACrB;gBACD,QAAQ,EAAE;oBACR,YAAY,EAAE,QAAQ;oBACtB,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3B;aACF;SACF;QACD,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,mBAAmB;gBACvB,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE;oBACN,MAAM,EAAE,kBAAkB;oBAC1B,MAAM,EAAE,UAAU;iBACnB;aACF;SACF;KACF;IACD,KAAK,EAAE;QACL;YACE,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACtD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC1D;SACF;KACF;CACF,CAAC"}

package/dist/examples/validate-minimal.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-minimal.d.ts.map

package/dist/examples/validate-minimal.d.ts.map

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