@statelyai/graph 0.10.0 → 0.11.1

package/dist/schemas.d.mts

@@ -1,12 +1,27 @@
 import * as z from "zod";
 
 //#region src/schemas.d.ts
+declare const PortSchema: z.ZodObject<{
+  name: z.ZodString;
+  direction: z.ZodOptional<z.ZodEnum<{
+    in: "in";
+    out: "out";
+    inout: "inout";
+  }>>;
+  label: z.ZodOptional<z.ZodString>;
+  data: z.ZodAny;
+  x: z.ZodOptional<z.ZodNumber>;
+  y: z.ZodOptional<z.ZodNumber>;
+  width: z.ZodOptional<z.ZodNumber>;
+  height: z.ZodOptional<z.ZodNumber>;
+  style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+}, z.core.$strip>;
 declare const NodeSchema: z.ZodObject<{
   type: z.ZodLiteral<"node">;
   id: z.ZodString;
   parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   initialNodeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  label: z.ZodOptional<z.ZodString>;
+  label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   data: z.ZodAny;
   x: z.ZodOptional<z.ZodNumber>;
   y: z.ZodOptional<z.ZodNumber>;
@@ -15,6 +30,21 @@ declare const NodeSchema: z.ZodObject<{
   shape: z.ZodOptional<z.ZodString>;
   color: z.ZodOptional<z.ZodString>;
   style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+  ports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    direction: z.ZodOptional<z.ZodEnum<{
+      in: "in";
+      out: "out";
+      inout: "inout";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    data: z.ZodAny;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 declare const EdgeSchema: z.ZodObject<{
   type: z.ZodLiteral<"edge">;
@@ -23,6 +53,8 @@ declare const EdgeSchema: z.ZodObject<{
   targetId: z.ZodString;
   label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   weight: z.ZodOptional<z.ZodNumber>;
+  sourcePort: z.ZodOptional<z.ZodString>;
+  targetPort: z.ZodOptional<z.ZodString>;
   data: z.ZodAny;
   x: z.ZodOptional<z.ZodNumber>;
   y: z.ZodOptional<z.ZodNumber>;
@@ -43,7 +75,7 @@ declare const GraphSchema: z.ZodObject<{
     id: z.ZodString;
     parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     initialNodeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    label: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     data: z.ZodAny;
     x: z.ZodOptional<z.ZodNumber>;
     y: z.ZodOptional<z.ZodNumber>;
@@ -52,6 +84,21 @@ declare const GraphSchema: z.ZodObject<{
     shape: z.ZodOptional<z.ZodString>;
     color: z.ZodOptional<z.ZodString>;
     style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    ports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      direction: z.ZodOptional<z.ZodEnum<{
+        in: "in";
+        out: "out";
+        inout: "inout";
+      }>>;
+      label: z.ZodOptional<z.ZodString>;
+      data: z.ZodAny;
+      x: z.ZodOptional<z.ZodNumber>;
+      y: z.ZodOptional<z.ZodNumber>;
+      width: z.ZodOptional<z.ZodNumber>;
+      height: z.ZodOptional<z.ZodNumber>;
+      style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
   edges: z.ZodArray<z.ZodObject<{
     type: z.ZodLiteral<"edge">;
@@ -60,6 +107,8 @@ declare const GraphSchema: z.ZodObject<{
     targetId: z.ZodString;
     label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     weight: z.ZodOptional<z.ZodNumber>;
+    sourcePort: z.ZodOptional<z.ZodString>;
+    targetPort: z.ZodOptional<z.ZodString>;
     data: z.ZodAny;
     x: z.ZodOptional<z.ZodNumber>;
     y: z.ZodOptional<z.ZodNumber>;
@@ -78,4 +127,4 @@ declare const GraphSchema: z.ZodObject<{
   style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
 }, z.core.$strip>;
 //#endregion
-export { EdgeSchema, GraphSchema, NodeSchema };
+export { EdgeSchema, GraphSchema, NodeSchema, PortSchema };

package/dist/schemas.mjs

@@ -2,12 +2,28 @@ import * as z from "zod";
 
 //#region src/schemas.ts
 const StyleSchema = z.record(z.string(), z.union([z.string(), z.number()]));
+const PortDirectionSchema = z.enum([
+	"in",
+	"out",
+	"inout"
+]);
+const PortSchema = z.object({
+	name: z.string(),
+	direction: PortDirectionSchema.optional(),
+	label: z.string().optional(),
+	data: z.any(),
+	x: z.number().optional(),
+	y: z.number().optional(),
+	width: z.number().optional(),
+	height: z.number().optional(),
+	style: StyleSchema.optional()
+});
 const NodeSchema = z.object({
 	type: z.literal("node"),
 	id: z.string(),
 	parentId: z.string().nullable().optional(),
 	initialNodeId: z.string().nullable().optional(),
-	label: z.string().optional(),
+	label: z.string().nullable().optional(),
 	data: z.any(),
 	x: z.number().optional(),
 	y: z.number().optional(),
@@ -15,7 +31,8 @@ const NodeSchema = z.object({
 	height: z.number().optional(),
 	shape: z.string().optional(),
 	color: z.string().optional(),
-	style: StyleSchema.optional()
+	style: StyleSchema.optional(),
+	ports: z.array(PortSchema).optional()
 });
 const EdgeSchema = z.object({
 	type: z.literal("edge"),
@@ -24,6 +41,8 @@ const EdgeSchema = z.object({
 	targetId: z.string(),
 	label: z.string().nullable().optional(),
 	weight: z.number().optional(),
+	sourcePort: z.string().optional(),
+	targetPort: z.string().optional(),
 	data: z.any(),
 	x: z.number().optional(),
 	y: z.number().optional(),
@@ -49,4 +68,4 @@ const GraphSchema = z.object({
 });
 
 //#endregion
-export { EdgeSchema, GraphSchema, NodeSchema };
+export { EdgeSchema, GraphSchema, NodeSchema, PortSchema };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@statelyai/graph",
   "type": "module",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "A TypeScript-first graph library with plain JSON-serializable objects",
   "author": "David Khourshid <david@stately.ai>",
   "license": "MIT",
@@ -24,6 +24,7 @@
   "exports": {
     ".": "./dist/index.mjs",
     "./algorithms": "./dist/algorithms.mjs",
+    "./format-support": "./dist/format-support.mjs",
     "./adjacency-list": "./dist/formats/adjacency-list/index.mjs",
     "./converter": "./dist/formats/converter/index.mjs",
     "./cytoscape": "./dist/formats/cytoscape/index.mjs",
@@ -101,10 +102,13 @@
   },
   "scripts": {
     "build": "tsdown",
+    "bench": "vitest bench --run",
     "dev": "tsdown --watch",
+    "fix:generated": "pnpm generate-schema",
     "test": "vitest",
     "typecheck": "tsc --noEmit",
-    "verify": "pnpm typecheck && pnpm test -- --run && pnpm build && pnpm validate:package",
+    "check:generated": "tsx scripts/generate-json-schema.ts --check",
+    "verify": "pnpm typecheck && pnpm check:generated && pnpm test -- --run && pnpm build && pnpm validate:package",
     "validate:package": "publint && tsx scripts/smoke-package.ts",
     "generate-schema": "tsx scripts/generate-json-schema.ts",
     "changeset": "changeset",

package/schemas/edge.schema.json

@@ -16,6 +16,22 @@
       "type": "string"
     },
     "label": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "weight": {
+      "type": "number"
+    },
+    "sourcePort": {
+      "type": "string"
+    },
+    "targetPort": {
       "type": "string"
     },
     "data": {},
@@ -56,7 +72,6 @@
     "id",
     "sourceId",
     "targetId",
-    "label",
     "data"
   ],
   "additionalProperties": false

package/schemas/graph.schema.json

@@ -55,7 +55,14 @@
             ]
           },
           "label": {
-            "type": "string"
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
           },
           "data": {},
           "x": {
@@ -91,12 +98,67 @@
                 }
               ]
             }
+          },
+          "ports": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "direction": {
+                  "type": "string",
+                  "enum": [
+                    "in",
+                    "out",
+                    "inout"
+                  ]
+                },
+                "label": {
+                  "type": "string"
+                },
+                "data": {},
+                "x": {
+                  "type": "number"
+                },
+                "y": {
+                  "type": "number"
+                },
+                "width": {
+                  "type": "number"
+                },
+                "height": {
+                  "type": "number"
+                },
+                "style": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "number"
+                      }
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "name",
+                "data"
+              ],
+              "additionalProperties": false
+            }
           }
         },
         "required": [
           "type",
           "id",
-          "label",
           "data"
         ],
         "additionalProperties": false
@@ -121,6 +183,22 @@
             "type": "string"
           },
           "label": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "weight": {
+            "type": "number"
+          },
+          "sourcePort": {
+            "type": "string"
+          },
+          "targetPort": {
             "type": "string"
           },
           "data": {},
@@ -161,7 +239,6 @@
           "id",
           "sourceId",
           "targetId",
-          "label",
           "data"
         ],
         "additionalProperties": false
@@ -197,7 +274,6 @@
   "required": [
     "id",
     "type",
-    "initialNodeId",
     "nodes",
     "edges",
     "data"

package/schemas/node.schema.json

@@ -30,7 +30,14 @@
       ]
     },
     "label": {
-      "type": "string"
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
     },
     "data": {},
     "x": {
@@ -66,12 +73,67 @@
           }
         ]
       }
+    },
+    "ports": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "in",
+              "out",
+              "inout"
+            ]
+          },
+          "label": {
+            "type": "string"
+          },
+          "data": {},
+          "x": {
+            "type": "number"
+          },
+          "y": {
+            "type": "number"
+          },
+          "width": {
+            "type": "number"
+          },
+          "height": {
+            "type": "number"
+          },
+          "style": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            }
+          }
+        },
+        "required": [
+          "name",
+          "data"
+        ],
+        "additionalProperties": false
+      }
     }
   },
   "required": [
     "type",
     "id",
-    "label",
     "data"
   ],
   "additionalProperties": false