@andro.dev/jsonflow-engine 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+# JSONFLOW Engine
+
+Schema-aware engine for validating JSON graphs and producing Cytoscape-ready elements.
+
+## What It Does
+
+- Validates JSON via Zod schemas
+- Outputs Cytoscape-compatible nodes and edges
+- Headless: no UI required
+
+## Install (local)
+
+```bash
+pnpm -C engine install
+```
+
+## Build
+
+```bash
+pnpm -C engine build
+```
+
+## Test
+
+```bash
+pnpm -C engine test
+```
+
+## Usage
+
+```ts
+import { Engine } from "jsonflow-engine";
+
+const engine = new Engine();
+const result = engine.parse({
+  type: "flow",
+  nodes: [{ id: "A" }, { id: "B" }],
+  edges: [{ from: "A", to: "B" }],
+});
+
+if (result.ok) {
+  console.log(result.cytoscape);
+}
+```
+
+## Schema (Summary)
+
+- Graph: `type`, `layout.direction`, `nodes`, `edges`
+- Node: `id`, `label`, `type`, `kind`, `properties`
+- Edge: `from`, `to`, `label`, `kind`, `link_type`
+
+See `docs/diagram-spec.md` for details.

package/dist/index.d.mts

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+
+declare const NodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        actor: "actor";
+        lifeline: "lifeline";
+        message: "message";
+        activity: "activity";
+        state: "state";
+        class: "class";
+    }>>;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const EdgeSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        next: "next";
+        call: "call";
+        return: "return";
+        async: "async";
+        transition: "transition";
+        inherit: "inherit";
+        association: "association";
+    }>>;
+    link_type: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        dash: "dash";
+        dot: "dot";
+        double: "double";
+        bold: "bold";
+        arrow: "arrow";
+        "open-arrow": "open-arrow";
+    }>>;
+}, z.core.$strip>;
+declare const GraphSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<{
+        graph: "graph";
+        sequence: "sequence";
+        flow: "flow";
+    }>>;
+    layout: z.ZodOptional<z.ZodObject<{
+        direction: z.ZodDefault<z.ZodEnum<{
+            LR: "LR";
+            RL: "RL";
+            TB: "TB";
+            BT: "BT";
+        }>>;
+    }, z.core.$strip>>;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            actor: "actor";
+            lifeline: "lifeline";
+            message: "message";
+            activity: "activity";
+            state: "state";
+            class: "class";
+        }>>;
+        properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    edges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            next: "next";
+            call: "call";
+            return: "return";
+            async: "async";
+            transition: "transition";
+            inherit: "inherit";
+            association: "association";
+        }>>;
+        link_type: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dash: "dash";
+            dot: "dot";
+            double: "double";
+            bold: "bold";
+            arrow: "arrow";
+            "open-arrow": "open-arrow";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+type Graph = z.infer<typeof GraphSchema>;
+type CytoscapeNode = {
+    data: {
+        id: string;
+        label?: string;
+        type?: string;
+        kind?: string;
+        properties?: Record<string, unknown>;
+    };
+};
+type CytoscapeEdge = {
+    data: {
+        id: string;
+        source: string;
+        target: string;
+        label?: string;
+        kind?: string;
+        link_type?: string;
+    };
+};
+type CytoscapeGraph = {
+    nodes: CytoscapeNode[];
+    edges: CytoscapeEdge[];
+};
+
+type EngineResult = {
+    ok: true;
+    graph: Graph;
+    cytoscape: CytoscapeGraph;
+} | {
+    ok: false;
+    error: z.ZodError;
+};
+declare class Engine {
+    validate(input: unknown): Graph;
+    safeValidate(input: unknown): ReturnType<typeof GraphSchema.safeParse>;
+    parse(input: unknown): EngineResult;
+}
+
+export { EdgeSchema, Engine, type EngineResult, GraphSchema, NodeSchema };

package/dist/index.d.ts

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+
+declare const NodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        actor: "actor";
+        lifeline: "lifeline";
+        message: "message";
+        activity: "activity";
+        state: "state";
+        class: "class";
+    }>>;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const EdgeSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        next: "next";
+        call: "call";
+        return: "return";
+        async: "async";
+        transition: "transition";
+        inherit: "inherit";
+        association: "association";
+    }>>;
+    link_type: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        dash: "dash";
+        dot: "dot";
+        double: "double";
+        bold: "bold";
+        arrow: "arrow";
+        "open-arrow": "open-arrow";
+    }>>;
+}, z.core.$strip>;
+declare const GraphSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<{
+        graph: "graph";
+        sequence: "sequence";
+        flow: "flow";
+    }>>;
+    layout: z.ZodOptional<z.ZodObject<{
+        direction: z.ZodDefault<z.ZodEnum<{
+            LR: "LR";
+            RL: "RL";
+            TB: "TB";
+            BT: "BT";
+        }>>;
+    }, z.core.$strip>>;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            actor: "actor";
+            lifeline: "lifeline";
+            message: "message";
+            activity: "activity";
+            state: "state";
+            class: "class";
+        }>>;
+        properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    edges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            next: "next";
+            call: "call";
+            return: "return";
+            async: "async";
+            transition: "transition";
+            inherit: "inherit";
+            association: "association";
+        }>>;
+        link_type: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dash: "dash";
+            dot: "dot";
+            double: "double";
+            bold: "bold";
+            arrow: "arrow";
+            "open-arrow": "open-arrow";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+type Graph = z.infer<typeof GraphSchema>;
+type CytoscapeNode = {
+    data: {
+        id: string;
+        label?: string;
+        type?: string;
+        kind?: string;
+        properties?: Record<string, unknown>;
+    };
+};
+type CytoscapeEdge = {
+    data: {
+        id: string;
+        source: string;
+        target: string;
+        label?: string;
+        kind?: string;
+        link_type?: string;
+    };
+};
+type CytoscapeGraph = {
+    nodes: CytoscapeNode[];
+    edges: CytoscapeEdge[];
+};
+
+type EngineResult = {
+    ok: true;
+    graph: Graph;
+    cytoscape: CytoscapeGraph;
+} | {
+    ok: false;
+    error: z.ZodError;
+};
+declare class Engine {
+    validate(input: unknown): Graph;
+    safeValidate(input: unknown): ReturnType<typeof GraphSchema.safeParse>;
+    parse(input: unknown): EngineResult;
+}
+
+export { EdgeSchema, Engine, type EngineResult, GraphSchema, NodeSchema };

package/dist/index.js

@@ -0,0 +1,151 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  EdgeSchema: () => EdgeSchema,
+  Engine: () => Engine,
+  GraphSchema: () => GraphSchema,
+  NodeSchema: () => NodeSchema
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/schema/graph.ts
+var import_zod = require("zod");
+var GraphTypeSchema = import_zod.z.enum(["graph", "sequence", "flow"]);
+var NodeKindSchema = import_zod.z.enum([
+  "actor",
+  "lifeline",
+  "message",
+  "activity",
+  "state",
+  "class"
+]);
+var EdgeLinkTypeSchema = import_zod.z.enum([
+  "solid",
+  "dash",
+  "dot",
+  "double",
+  "bold",
+  "arrow",
+  "open-arrow"
+]);
+var EdgeKindSchema = import_zod.z.enum([
+  "next",
+  "call",
+  "return",
+  "async",
+  "transition",
+  "inherit",
+  "association"
+]);
+var LayoutDirectionSchema = import_zod.z.enum(["LR", "RL", "TB", "BT"]);
+var LayoutSchema = import_zod.z.object({
+  direction: LayoutDirectionSchema.default("LR")
+});
+var NodeSchema = import_zod.z.object({
+  id: import_zod.z.string(),
+  label: import_zod.z.string().optional(),
+  type: import_zod.z.string().optional(),
+  kind: NodeKindSchema.optional(),
+  properties: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional()
+});
+var EdgeSchema = import_zod.z.object({
+  from: import_zod.z.string(),
+  to: import_zod.z.string(),
+  label: import_zod.z.string().optional(),
+  kind: EdgeKindSchema.optional(),
+  link_type: EdgeLinkTypeSchema.optional()
+});
+var GraphSchema = import_zod.z.object({
+  type: GraphTypeSchema.default("flow"),
+  layout: LayoutSchema.optional(),
+  nodes: import_zod.z.array(NodeSchema),
+  edges: import_zod.z.array(EdgeSchema)
+});
+
+// src/index.ts
+var toCytoscape = (graph) => {
+  const nodes = graph.nodes.map((node) => {
+    const data = {
+      id: node.id
+    };
+    if (node.label !== void 0) {
+      data.label = node.label;
+    }
+    if (node.type !== void 0) {
+      data.type = node.type;
+    }
+    if (node.kind !== void 0) {
+      data.kind = node.kind;
+    }
+    if (node.properties !== void 0) {
+      data.properties = node.properties;
+    }
+    return { data };
+  });
+  const edges = graph.edges.map((edge) => {
+    const data = {
+      id: `${edge.from}->${edge.to}`,
+      source: edge.from,
+      target: edge.to
+    };
+    if (edge.label !== void 0) {
+      data.label = edge.label;
+    }
+    if (edge.kind !== void 0) {
+      data.kind = edge.kind;
+    }
+    if (edge.link_type !== void 0) {
+      data.link_type = edge.link_type;
+    }
+    return { data };
+  });
+  return { nodes, edges };
+};
+var Engine = class {
+  validate(input) {
+    return GraphSchema.parse(input);
+  }
+  safeValidate(input) {
+    return GraphSchema.safeParse(input);
+  }
+  parse(input) {
+    const result = GraphSchema.safeParse(input);
+    if (!result.success) {
+      return { ok: false, error: result.error };
+    }
+    const graph = result.data;
+    const cytoscape = toCytoscape(graph);
+    if (graph.type === "flow") {
+      const flowchart = cytoscape;
+      return { ok: true, graph, cytoscape: flowchart };
+    }
+    return { ok: true, graph, cytoscape };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EdgeSchema,
+  Engine,
+  GraphSchema,
+  NodeSchema
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/schema/graph.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { EdgeSchema, GraphSchema, NodeSchema } from \"@engine/schema/graph\";\nimport type {\n  CytoscapeGraph,\n  Edge,\n  FlowchartCytoscapeGraph,\n  Graph,\n  Node,\n} from \"@engine/types/graph\";\n\nexport type EngineResult =\n  | { ok: true; graph: Graph; cytoscape: CytoscapeGraph }\n  | { ok: false; error: z.ZodError };\n\nconst toCytoscape = (graph: Graph): CytoscapeGraph => {\n  const nodes = graph.nodes.map((node) => {\n    const data: {\n      id: string;\n      label?: string;\n      type?: string;\n      kind?: string;\n      properties?: Record<string, unknown>;\n    } = {\n      id: node.id,\n    };\n\n    if (node.label !== undefined) {\n      data.label = node.label;\n    }\n    if (node.type !== undefined) {\n      data.type = node.type;\n    }\n    if (node.kind !== undefined) {\n      data.kind = node.kind;\n    }\n    if (node.properties !== undefined) {\n      data.properties = node.properties;\n    }\n\n    return { data };\n  });\n\n  const edges = graph.edges.map((edge) => {\n    const data: {\n      id: string;\n      source: string;\n      target: string;\n      label?: string;\n      kind?: string;\n      link_type?: string;\n    } = {\n      id: `${edge.from}->${edge.to}`,\n      source: edge.from,\n      target: edge.to,\n    };\n\n    if (edge.label !== undefined) {\n      data.label = edge.label;\n    }\n    if (edge.kind !== undefined) {\n      data.kind = edge.kind;\n    }\n    if (edge.link_type !== undefined) {\n      data.link_type = edge.link_type;\n    }\n\n    return { data };\n  });\n\n  return { nodes, edges };\n};\n\nexport class Engine {\n  validate(input: unknown): Graph {\n    return GraphSchema.parse(input);\n  }\n\n  safeValidate(input: unknown): ReturnType<typeof GraphSchema.safeParse> {\n    return GraphSchema.safeParse(input);\n  }\n\n  parse(input: unknown): EngineResult {\n    const result = GraphSchema.safeParse(input);\n    if (!result.success) {\n      return { ok: false, error: result.error };\n    }\n\n    const graph = result.data;\n    const cytoscape = toCytoscape(graph);\n\n    if (graph.type === \"flow\") {\n      const flowchart: FlowchartCytoscapeGraph = cytoscape;\n      return { ok: true, graph, cytoscape: flowchart };\n    }\n\n    return { ok: true, graph, cytoscape };\n  }\n}\n\nexport {\n  EdgeSchema,\n  GraphSchema,\n  NodeSchema,\n};\n","import { z } from \"zod\";\n\nexport const GraphTypeSchema = z.enum([\"graph\", \"sequence\", \"flow\"]);\n\nexport const NodeKindSchema = z.enum([\n  \"actor\",\n  \"lifeline\",\n  \"message\",\n  \"activity\",\n  \"state\",\n  \"class\",\n]);\n\nexport const EdgeLinkTypeSchema = z.enum([\n  \"solid\",\n  \"dash\",\n  \"dot\",\n  \"double\",\n  \"bold\",\n  \"arrow\",\n  \"open-arrow\",\n]);\n\nexport const EdgeKindSchema = z.enum([\n  \"next\",\n  \"call\",\n  \"return\",\n  \"async\",\n  \"transition\",\n  \"inherit\",\n  \"association\",\n]);\n\nexport const LayoutDirectionSchema = z.enum([\"LR\", \"RL\", \"TB\", \"BT\"]);\n\nexport const LayoutSchema = z.object({\n  direction: LayoutDirectionSchema.default(\"LR\"),\n});\n\nexport const NodeSchema = z.object({\n  id: z.string(),\n  label: z.string().optional(),\n  type: z.string().optional(),\n  kind: NodeKindSchema.optional(),\n  properties: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const EdgeSchema = z.object({\n  from: z.string(),\n  to: z.string(),\n  label: z.string().optional(),\n  kind: EdgeKindSchema.optional(),\n  link_type: EdgeLinkTypeSchema.optional(),\n});\n\nexport const GraphSchema = z.object({\n  type: GraphTypeSchema.default(\"flow\"),\n  layout: LayoutSchema.optional(),\n  nodes: z.array(NodeSchema),\n  edges: z.array(EdgeSchema),\n});\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,121 @@
+// src/schema/graph.ts
+import { z } from "zod";
+var GraphTypeSchema = z.enum(["graph", "sequence", "flow"]);
+var NodeKindSchema = z.enum([
+  "actor",
+  "lifeline",
+  "message",
+  "activity",
+  "state",
+  "class"
+]);
+var EdgeLinkTypeSchema = z.enum([
+  "solid",
+  "dash",
+  "dot",
+  "double",
+  "bold",
+  "arrow",
+  "open-arrow"
+]);
+var EdgeKindSchema = z.enum([
+  "next",
+  "call",
+  "return",
+  "async",
+  "transition",
+  "inherit",
+  "association"
+]);
+var LayoutDirectionSchema = z.enum(["LR", "RL", "TB", "BT"]);
+var LayoutSchema = z.object({
+  direction: LayoutDirectionSchema.default("LR")
+});
+var NodeSchema = z.object({
+  id: z.string(),
+  label: z.string().optional(),
+  type: z.string().optional(),
+  kind: NodeKindSchema.optional(),
+  properties: z.record(z.string(), z.unknown()).optional()
+});
+var EdgeSchema = z.object({
+  from: z.string(),
+  to: z.string(),
+  label: z.string().optional(),
+  kind: EdgeKindSchema.optional(),
+  link_type: EdgeLinkTypeSchema.optional()
+});
+var GraphSchema = z.object({
+  type: GraphTypeSchema.default("flow"),
+  layout: LayoutSchema.optional(),
+  nodes: z.array(NodeSchema),
+  edges: z.array(EdgeSchema)
+});
+
+// src/index.ts
+var toCytoscape = (graph) => {
+  const nodes = graph.nodes.map((node) => {
+    const data = {
+      id: node.id
+    };
+    if (node.label !== void 0) {
+      data.label = node.label;
+    }
+    if (node.type !== void 0) {
+      data.type = node.type;
+    }
+    if (node.kind !== void 0) {
+      data.kind = node.kind;
+    }
+    if (node.properties !== void 0) {
+      data.properties = node.properties;
+    }
+    return { data };
+  });
+  const edges = graph.edges.map((edge) => {
+    const data = {
+      id: `${edge.from}->${edge.to}`,
+      source: edge.from,
+      target: edge.to
+    };
+    if (edge.label !== void 0) {
+      data.label = edge.label;
+    }
+    if (edge.kind !== void 0) {
+      data.kind = edge.kind;
+    }
+    if (edge.link_type !== void 0) {
+      data.link_type = edge.link_type;
+    }
+    return { data };
+  });
+  return { nodes, edges };
+};
+var Engine = class {
+  validate(input) {
+    return GraphSchema.parse(input);
+  }
+  safeValidate(input) {
+    return GraphSchema.safeParse(input);
+  }
+  parse(input) {
+    const result = GraphSchema.safeParse(input);
+    if (!result.success) {
+      return { ok: false, error: result.error };
+    }
+    const graph = result.data;
+    const cytoscape = toCytoscape(graph);
+    if (graph.type === "flow") {
+      const flowchart = cytoscape;
+      return { ok: true, graph, cytoscape: flowchart };
+    }
+    return { ok: true, graph, cytoscape };
+  }
+};
+export {
+  EdgeSchema,
+  Engine,
+  GraphSchema,
+  NodeSchema
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/graph.ts","../src/index.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const GraphTypeSchema = z.enum([\"graph\", \"sequence\", \"flow\"]);\n\nexport const NodeKindSchema = z.enum([\n  \"actor\",\n  \"lifeline\",\n  \"message\",\n  \"activity\",\n  \"state\",\n  \"class\",\n]);\n\nexport const EdgeLinkTypeSchema = z.enum([\n  \"solid\",\n  \"dash\",\n  \"dot\",\n  \"double\",\n  \"bold\",\n  \"arrow\",\n  \"open-arrow\",\n]);\n\nexport const EdgeKindSchema = z.enum([\n  \"next\",\n  \"call\",\n  \"return\",\n  \"async\",\n  \"transition\",\n  \"inherit\",\n  \"association\",\n]);\n\nexport const LayoutDirectionSchema = z.enum([\"LR\", \"RL\", \"TB\", \"BT\"]);\n\nexport const LayoutSchema = z.object({\n  direction: LayoutDirectionSchema.default(\"LR\"),\n});\n\nexport const NodeSchema = z.object({\n  id: z.string(),\n  label: z.string().optional(),\n  type: z.string().optional(),\n  kind: NodeKindSchema.optional(),\n  properties: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const EdgeSchema = z.object({\n  from: z.string(),\n  to: z.string(),\n  label: z.string().optional(),\n  kind: EdgeKindSchema.optional(),\n  link_type: EdgeLinkTypeSchema.optional(),\n});\n\nexport const GraphSchema = z.object({\n  type: GraphTypeSchema.default(\"flow\"),\n  layout: LayoutSchema.optional(),\n  nodes: z.array(NodeSchema),\n  edges: z.array(EdgeSchema),\n});\n","import { z } from \"zod\";\nimport { EdgeSchema, GraphSchema, NodeSchema } from \"@engine/schema/graph\";\nimport type {\n  CytoscapeGraph,\n  Edge,\n  FlowchartCytoscapeGraph,\n  Graph,\n  Node,\n} from \"@engine/types/graph\";\n\nexport type EngineResult =\n  | { ok: true; graph: Graph; cytoscape: CytoscapeGraph }\n  | { ok: false; error: z.ZodError };\n\nconst toCytoscape = (graph: Graph): CytoscapeGraph => {\n  const nodes = graph.nodes.map((node) => {\n    const data: {\n      id: string;\n      label?: string;\n      type?: string;\n      kind?: string;\n      properties?: Record<string, unknown>;\n    } = {\n      id: node.id,\n    };\n\n    if (node.label !== undefined) {\n      data.label = node.label;\n    }\n    if (node.type !== undefined) {\n      data.type = node.type;\n    }\n    if (node.kind !== undefined) {\n      data.kind = node.kind;\n    }\n    if (node.properties !== undefined) {\n      data.properties = node.properties;\n    }\n\n    return { data };\n  });\n\n  const edges = graph.edges.map((edge) => {\n    const data: {\n      id: string;\n      source: string;\n      target: string;\n      label?: string;\n      kind?: string;\n      link_type?: string;\n    } = {\n      id: `${edge.from}->${edge.to}`,\n      source: edge.from,\n      target: edge.to,\n    };\n\n    if (edge.label !== undefined) {\n      data.label = edge.label;\n    }\n    if (edge.kind !== undefined) {\n      data.kind = edge.kind;\n    }\n    if (edge.link_type !== undefined) {\n      data.link_type = edge.link_type;\n    }\n\n    return { data };\n  });\n\n  return { nodes, edges };\n};\n\nexport class Engine {\n  validate(input: unknown): Graph {\n    return GraphSchema.parse(input);\n  }\n\n  safeValidate(input: unknown): ReturnType<typeof GraphSchema.safeParse> {\n    return GraphSchema.safeParse(input);\n  }\n\n  parse(input: unknown): EngineResult {\n    const result = GraphSchema.safeParse(input);\n    if (!result.success) {\n      return { ok: false, error: result.error };\n    }\n\n    const graph = result.data;\n    const cytoscape = toCytoscape(graph);\n\n    if (graph.type === \"flow\") {\n      const flowchart: FlowchartCytoscapeGraph = cytoscape;\n      return { ok: true, graph, cytoscape: flowchart };\n    }\n\n    return { ok: true, graph, cytoscape };\n  }\n}\n\nexport {\n  EdgeSchema,\n  GraphSchema,\n  NodeSchema,\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@andro.dev/jsonflow-engine",
+  "version": "1.0.0",
+  "description": "JSONFLOW engine (logic + parser) for schema-validated diagrams.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "packageManager": "pnpm@10.28.1",
+  "dependencies": {
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@types/node": "^25.2.0"
+  }
+}