@ogabrielluiz/patchflow 0.1.0

package/dist/types.cjs

@@ -0,0 +1,38 @@
+"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/types.ts
+var types_exports = {};
+__export(types_exports, {
+  SIGNAL_OPERATORS: () => SIGNAL_OPERATORS
+});
+module.exports = __toCommonJS(types_exports);
+var SIGNAL_OPERATORS = {
+  "->": "audio",
+  ">>": "cv",
+  "p>": "pitch",
+  "g>": "gate",
+  "t>": "trigger",
+  "c>": "clock"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SIGNAL_OPERATORS
+});
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// ── Signal Types ──\n\nexport type SignalType = 'audio' | 'cv' | 'pitch' | 'gate' | 'trigger' | 'clock';\n\nexport const SIGNAL_OPERATORS: Record<string, SignalType> = {\n  '->': 'audio',\n  '>>': 'cv',\n  'p>': 'pitch',\n  'g>': 'gate',\n  't>': 'trigger',\n  'c>': 'clock',\n};\n\n// ── Graph Primitives ──\n\nexport interface Port {\n  id: string;          // normalized key (lowercase, trimmed)\n  display: string;     // original form for rendering\n  direction: 'in' | 'out';\n}\n\nexport interface Param {\n  key: string;\n  value: string;\n}\n\nexport interface Block {\n  id: string;\n  label: string;\n  subLabel: string | null;\n  params: Param[];\n  ports: Port[];\n  parentModule: string | null;  // null for top-level modules, module name for sections\n  voice: string | null;\n}\n\nexport interface ConnectionEndpoint {\n  blockId: string;\n  portId: string;       // normalized key\n  portDisplay: string;  // original form\n}\n\nexport interface Connection {\n  id: string;\n  source: ConnectionEndpoint;\n  target: ConnectionEndpoint;\n  signalType: SignalType;\n  annotation: string | null;\n  graphvizExtras: Record<string, string> | null;\n}\n\n// ── Patch Graph (Parser Output) ──\n\nexport interface PatchGraph {\n  declaredBlocks: Block[];\n  stubBlocks: Block[];\n  connections: Connection[];\n  feedbackEdges: Connection[];\n  signalTypeStats: Partial<Record<SignalType, number>>;\n  voices: string[];\n}\n\n// ── Layout Types ──\n\nexport interface Point {\n  x: number;\n  y: number;\n}\n\nexport interface LayoutPort extends Port {\n  position: Point;\n  signalType: SignalType | null;\n}\n\nexport interface LayoutBlock {\n  id: string;\n  label: string;\n  subLabel: string | null;\n  params: Param[];\n  ports: LayoutPort[];\n  parentModule: string | null;\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport interface LayoutConnection {\n  id: string;\n  source: ConnectionEndpoint;\n  target: ConnectionEndpoint;\n  signalType: SignalType;\n  annotation: string | null;\n  path: string;            // SVG path d attribute\n  isFeedback: boolean;\n  sourcePoint: Point;\n  targetPoint: Point;\n}\n\nexport interface LayoutResult {\n  blocks: LayoutBlock[];\n  connections: LayoutConnection[];\n  width: number;\n  height: number;\n  signalTypeStats: Partial<Record<SignalType, number>>;\n}\n\n// ── Theme Types ──\n\nexport interface CableColor {\n  stroke: string;\n  plugTip: string;\n}\n\nexport interface SocketColors {\n  bezel: string;\n  bezelStroke: string;\n  ring: string;\n  hole: string;\n  pin: string;\n}\n\nexport interface Theme {\n  background: string;\n  panel: {\n    fill: string;\n    stroke: string;\n    highlight: string;\n    shadow: string;\n    cornerRadius: number;\n    shadowBlur: number;\n    shadowOpacity: number;\n    bevelWidth: number;\n  };\n  label: {\n    fontFamily: string;\n    color: string;\n    subColor: string;\n    plateFill: string;\n    plateStroke: string;\n  };\n  param: {\n    plateFill: string;\n    plateStroke: string;\n    textColor: string;\n  };\n  port: {\n    fontFamily: string;\n    fontSize: number;\n    colors: SocketColors;\n    hideSocket: boolean;\n    labelColor: string;\n    pill: {\n      show: boolean;\n      fontSize: number;\n      textColor: string;\n      cornerRadius: number;\n    };\n  };\n  cable: {\n    width: number;\n    colors: Record<SignalType, CableColor>;\n    plugTipRadius: number;\n  };\n  annotation: {\n    fontFamily: string;\n    fontSize: number;\n    color: string;\n    haloColor: string;\n  };\n  grid: {\n    dotColor: string;\n    dotRadius: number;\n    spacing: number;\n    opacity: number;\n  } | null;\n}\n\n// ── Options ──\n\nexport interface RenderOptions {\n  theme?: DeepPartial<Theme>;\n  maxWidth?: number;\n  padding?: number;\n  legend?: boolean | 'auto';\n}\n\nexport interface LayoutOptions {\n  direction?: 'LR' | 'TB';\n  nodeSep?: number;\n  rankSep?: number;\n  feedbackSide?: 'top' | 'bottom';\n}\n\n// ── Parse Result ──\n\nexport type ErrorCode =\n  | 'SYNTAX_ERROR'\n  | 'UNKNOWN_OPERATOR'\n  | 'MISSING_PORT'\n  | 'UNCLOSED_PAREN'\n  | 'DUPLICATE_MODULE'\n  | 'UNKNOWN_MODULE'\n  | 'INVALID_PORT';\n\nexport type ErrorSeverity = 'error' | 'warning';\n\nexport interface ParseDiagnostic {\n  code: ErrorCode;\n  message: string;\n  line: number;\n  column: number;\n  length: number;\n  severity: ErrorSeverity;\n}\n\nexport interface ParseResult {\n  graph: PatchGraph;\n  errors: ParseDiagnostic[];\n  warnings: ParseDiagnostic[];\n}\n\n// ── Utility Types ──\n\nexport type DeepPartial<T> = {\n  [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,IAAM,mBAA+C;AAAA,EAC1D,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AACR;","names":[]}

package/dist/types.d.cts

@@ -0,0 +1,177 @@
+type SignalType = 'audio' | 'cv' | 'pitch' | 'gate' | 'trigger' | 'clock';
+declare const SIGNAL_OPERATORS: Record<string, SignalType>;
+interface Port {
+    id: string;
+    display: string;
+    direction: 'in' | 'out';
+}
+interface Param {
+    key: string;
+    value: string;
+}
+interface Block {
+    id: string;
+    label: string;
+    subLabel: string | null;
+    params: Param[];
+    ports: Port[];
+    parentModule: string | null;
+    voice: string | null;
+}
+interface ConnectionEndpoint {
+    blockId: string;
+    portId: string;
+    portDisplay: string;
+}
+interface Connection {
+    id: string;
+    source: ConnectionEndpoint;
+    target: ConnectionEndpoint;
+    signalType: SignalType;
+    annotation: string | null;
+    graphvizExtras: Record<string, string> | null;
+}
+interface PatchGraph {
+    declaredBlocks: Block[];
+    stubBlocks: Block[];
+    connections: Connection[];
+    feedbackEdges: Connection[];
+    signalTypeStats: Partial<Record<SignalType, number>>;
+    voices: string[];
+}
+interface Point {
+    x: number;
+    y: number;
+}
+interface LayoutPort extends Port {
+    position: Point;
+    signalType: SignalType | null;
+}
+interface LayoutBlock {
+    id: string;
+    label: string;
+    subLabel: string | null;
+    params: Param[];
+    ports: LayoutPort[];
+    parentModule: string | null;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface LayoutConnection {
+    id: string;
+    source: ConnectionEndpoint;
+    target: ConnectionEndpoint;
+    signalType: SignalType;
+    annotation: string | null;
+    path: string;
+    isFeedback: boolean;
+    sourcePoint: Point;
+    targetPoint: Point;
+}
+interface LayoutResult {
+    blocks: LayoutBlock[];
+    connections: LayoutConnection[];
+    width: number;
+    height: number;
+    signalTypeStats: Partial<Record<SignalType, number>>;
+}
+interface CableColor {
+    stroke: string;
+    plugTip: string;
+}
+interface SocketColors {
+    bezel: string;
+    bezelStroke: string;
+    ring: string;
+    hole: string;
+    pin: string;
+}
+interface Theme {
+    background: string;
+    panel: {
+        fill: string;
+        stroke: string;
+        highlight: string;
+        shadow: string;
+        cornerRadius: number;
+        shadowBlur: number;
+        shadowOpacity: number;
+        bevelWidth: number;
+    };
+    label: {
+        fontFamily: string;
+        color: string;
+        subColor: string;
+        plateFill: string;
+        plateStroke: string;
+    };
+    param: {
+        plateFill: string;
+        plateStroke: string;
+        textColor: string;
+    };
+    port: {
+        fontFamily: string;
+        fontSize: number;
+        colors: SocketColors;
+        hideSocket: boolean;
+        labelColor: string;
+        pill: {
+            show: boolean;
+            fontSize: number;
+            textColor: string;
+            cornerRadius: number;
+        };
+    };
+    cable: {
+        width: number;
+        colors: Record<SignalType, CableColor>;
+        plugTipRadius: number;
+    };
+    annotation: {
+        fontFamily: string;
+        fontSize: number;
+        color: string;
+        haloColor: string;
+    };
+    grid: {
+        dotColor: string;
+        dotRadius: number;
+        spacing: number;
+        opacity: number;
+    } | null;
+}
+interface RenderOptions {
+    theme?: DeepPartial<Theme>;
+    maxWidth?: number;
+    padding?: number;
+    legend?: boolean | 'auto';
+}
+interface LayoutOptions {
+    direction?: 'LR' | 'TB';
+    nodeSep?: number;
+    rankSep?: number;
+    feedbackSide?: 'top' | 'bottom';
+}
+type ErrorCode = 'SYNTAX_ERROR' | 'UNKNOWN_OPERATOR' | 'MISSING_PORT' | 'UNCLOSED_PAREN' | 'DUPLICATE_MODULE' | 'UNKNOWN_MODULE' | 'INVALID_PORT';
+type ErrorSeverity = 'error' | 'warning';
+interface ParseDiagnostic {
+    code: ErrorCode;
+    message: string;
+    line: number;
+    column: number;
+    length: number;
+    severity: ErrorSeverity;
+}
+interface ParseResult {
+    graph: PatchGraph;
+    errors: ParseDiagnostic[];
+    warnings: ParseDiagnostic[];
+}
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+export { type Block, type CableColor, type Connection, type ConnectionEndpoint, type DeepPartial, type ErrorCode, type ErrorSeverity, type LayoutBlock, type LayoutConnection, type LayoutOptions, type LayoutPort, type LayoutResult, type Param, type ParseDiagnostic, type ParseResult, type PatchGraph, type Point, type Port, type RenderOptions, SIGNAL_OPERATORS, type SignalType, type SocketColors, type Theme };

package/dist/types.d.ts

@@ -0,0 +1,177 @@
+type SignalType = 'audio' | 'cv' | 'pitch' | 'gate' | 'trigger' | 'clock';
+declare const SIGNAL_OPERATORS: Record<string, SignalType>;
+interface Port {
+    id: string;
+    display: string;
+    direction: 'in' | 'out';
+}
+interface Param {
+    key: string;
+    value: string;
+}
+interface Block {
+    id: string;
+    label: string;
+    subLabel: string | null;
+    params: Param[];
+    ports: Port[];
+    parentModule: string | null;
+    voice: string | null;
+}
+interface ConnectionEndpoint {
+    blockId: string;
+    portId: string;
+    portDisplay: string;
+}
+interface Connection {
+    id: string;
+    source: ConnectionEndpoint;
+    target: ConnectionEndpoint;
+    signalType: SignalType;
+    annotation: string | null;
+    graphvizExtras: Record<string, string> | null;
+}
+interface PatchGraph {
+    declaredBlocks: Block[];
+    stubBlocks: Block[];
+    connections: Connection[];
+    feedbackEdges: Connection[];
+    signalTypeStats: Partial<Record<SignalType, number>>;
+    voices: string[];
+}
+interface Point {
+    x: number;
+    y: number;
+}
+interface LayoutPort extends Port {
+    position: Point;
+    signalType: SignalType | null;
+}
+interface LayoutBlock {
+    id: string;
+    label: string;
+    subLabel: string | null;
+    params: Param[];
+    ports: LayoutPort[];
+    parentModule: string | null;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface LayoutConnection {
+    id: string;
+    source: ConnectionEndpoint;
+    target: ConnectionEndpoint;
+    signalType: SignalType;
+    annotation: string | null;
+    path: string;
+    isFeedback: boolean;
+    sourcePoint: Point;
+    targetPoint: Point;
+}
+interface LayoutResult {
+    blocks: LayoutBlock[];
+    connections: LayoutConnection[];
+    width: number;
+    height: number;
+    signalTypeStats: Partial<Record<SignalType, number>>;
+}
+interface CableColor {
+    stroke: string;
+    plugTip: string;
+}
+interface SocketColors {
+    bezel: string;
+    bezelStroke: string;
+    ring: string;
+    hole: string;
+    pin: string;
+}
+interface Theme {
+    background: string;
+    panel: {
+        fill: string;
+        stroke: string;
+        highlight: string;
+        shadow: string;
+        cornerRadius: number;
+        shadowBlur: number;
+        shadowOpacity: number;
+        bevelWidth: number;
+    };
+    label: {
+        fontFamily: string;
+        color: string;
+        subColor: string;
+        plateFill: string;
+        plateStroke: string;
+    };
+    param: {
+        plateFill: string;
+        plateStroke: string;
+        textColor: string;
+    };
+    port: {
+        fontFamily: string;
+        fontSize: number;
+        colors: SocketColors;
+        hideSocket: boolean;
+        labelColor: string;
+        pill: {
+            show: boolean;
+            fontSize: number;
+            textColor: string;
+            cornerRadius: number;
+        };
+    };
+    cable: {
+        width: number;
+        colors: Record<SignalType, CableColor>;
+        plugTipRadius: number;
+    };
+    annotation: {
+        fontFamily: string;
+        fontSize: number;
+        color: string;
+        haloColor: string;
+    };
+    grid: {
+        dotColor: string;
+        dotRadius: number;
+        spacing: number;
+        opacity: number;
+    } | null;
+}
+interface RenderOptions {
+    theme?: DeepPartial<Theme>;
+    maxWidth?: number;
+    padding?: number;
+    legend?: boolean | 'auto';
+}
+interface LayoutOptions {
+    direction?: 'LR' | 'TB';
+    nodeSep?: number;
+    rankSep?: number;
+    feedbackSide?: 'top' | 'bottom';
+}
+type ErrorCode = 'SYNTAX_ERROR' | 'UNKNOWN_OPERATOR' | 'MISSING_PORT' | 'UNCLOSED_PAREN' | 'DUPLICATE_MODULE' | 'UNKNOWN_MODULE' | 'INVALID_PORT';
+type ErrorSeverity = 'error' | 'warning';
+interface ParseDiagnostic {
+    code: ErrorCode;
+    message: string;
+    line: number;
+    column: number;
+    length: number;
+    severity: ErrorSeverity;
+}
+interface ParseResult {
+    graph: PatchGraph;
+    errors: ParseDiagnostic[];
+    warnings: ParseDiagnostic[];
+}
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+export { type Block, type CableColor, type Connection, type ConnectionEndpoint, type DeepPartial, type ErrorCode, type ErrorSeverity, type LayoutBlock, type LayoutConnection, type LayoutOptions, type LayoutPort, type LayoutResult, type Param, type ParseDiagnostic, type ParseResult, type PatchGraph, type Point, type Port, type RenderOptions, SIGNAL_OPERATORS, type SignalType, type SocketColors, type Theme };

package/dist/types.js

@@ -0,0 +1,7 @@
+import {
+  SIGNAL_OPERATORS
+} from "./chunk-B7DUSPQH.js";
+export {
+  SIGNAL_OPERATORS
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ogabrielluiz/patchflow",
+  "version": "0.1.0",
+  "description": "Eurorack patch diagram renderer. Patchbook-compatible notation → skeuomorphic SVG.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs",
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "samples": "bun scripts/generate-samples.ts",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": ["eurorack", "patchbook", "modular-synth", "svg", "diagram"],
+  "author": "ogabrielluiz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ogabrielluiz/patchflow"
+  },
+  "dependencies": {
+    "@dagrejs/dagre": "^1.1.4"
+  },
+  "devDependencies": {
+    "@resvg/resvg-js": "^2.6.2",
+    "@types/bun": "latest",
+    "sharp": "^0.34.5",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0"
+  }
+}