flowpad-mcp 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,kFAAkF;AAClF,kFAAkF;AAClF,gFAAgF;AAChF,wBAAwB;AACxB,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,sFAAsF;AACtF,SAAS,SAAS;IAChB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;AACpE,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,+DAA+D;IAC/D,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;QAC/B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,gBAAgB;QACxD,2EAA2E;QAC3E,kDAAkD;QAClD,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;KAC/D,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,wDAAwD;IACxD,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,OAAO;IACpB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,iBAAiB,CAAC,CAAC;IAC/D,2EAA2E;IAC3E,kEAAkE;IAClE,gFAAgF;IAChF,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC;SACvD,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,MAAM,eAAe,CAAC;QACpB,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,gBAAgB;QACxD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM;QACpC,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QAC7C,oBAAoB,EAAE,WAAW;KAClC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib.js

@@ -0,0 +1,10 @@
+// Library entry — lets flowpad-mcp-local (the bundled PUBLIC stdio tool) reuse the
+// server + client WITHOUT copying any logic. flowpad-mcp-local imports these, attaches
+// a StdioServerTransport, and esbuild-bundles the whole tree (this + flowpad-core) into
+// one self-contained minified file. The CLI entry (index.ts / bin) stays the
+// hosted-HTTP + local-dev runner.
+// ts-unused-exports:disable-next-line
+export { createServer } from './server.js';
+// ts-unused-exports:disable-next-line
+export { FlowpadClient } from './client.js';
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,uFAAuF;AACvF,wFAAwF;AACxF,6EAA6E;AAC7E,kCAAkC;AAClC,sCAAsC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,sCAAsC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/local-engine.js

@@ -0,0 +1,82 @@
+// Local engine intelligence — the moat (vs Figma). flowpad-mcp carries flowpad-core
+// (the SAME engine the web client ships to the browser) so an external AI can:
+//   1. learn the engine's rules up front (describeEngine), then
+//   2. validate what it built ON THE USER'S MACHINE before any network round-trip
+//      (validateLocal) — fast, free, self-correcting feedback.
+// This is why flowpad-mcp depends on flowpad-core at RUNTIME, not just for types:
+// validation is the genuine engine, identical to web + backend → no drift.
+import { validateDiffPayload, layoutContainerChildren, detectLayoutOverflows, NODE_RULES, LAYOUT_RULES, BOUNDS_RULES, EDGE_RULES, } from 'flowpad-core';
+/**
+ * Validate a canvas diff with the real engine, locally — the exact check the web
+ * client (`guardUpdateProject`) and the backend run. `existingNodeCount` lets the
+ * engine apply project-size limits; pass 0 when unknown (skips the total-count rule).
+ *
+ * BaseNode is permissive (index signature); core's DiffLike is structural. They
+ * line up on the fields core actually reads (id/bounds/edges/layout), so we cast to
+ * core's param type instead of re-declaring its contract here (which would drift).
+ */
+export function validateLocal(diff, existingNodeCount = 0) {
+    return validateDiffPayload(diff, existingNodeCount);
+}
+/**
+ * Run the REAL layout engine locally to preview where a container's children
+ * land — the same `layoutContainerChildren` the canvas renders with — AND flag
+ * overflows (children that don't fit), the same `detectLayoutOverflows` analyze
+ * uses. Lets an external AI SEE both how its auto-layout frame tree renders and
+ * what overflows BEFORE sending it, instead of hand-computing x/y or
+ * round-tripping. Pure: clones the input, never mutates the caller's nodes.
+ *
+ * Only auto-layout containers position their children; nodes outside a container
+ * (no isAutoLayout ancestor) keep their given bounds.
+ */
+export function previewLayout(nodes) {
+    const doc = { nodes: structuredClone(nodes) };
+    layoutContainerChildren(doc);
+    const laid = doc.nodes;
+    return {
+        nodes: laid.map((n) => ({ id: String(n.id), bounds: n.bounds })),
+        // Overflow is judged on the engine-computed bounds, so run it on the laid-out
+        // nodes (not the caller's input).
+        overflows: detectLayoutOverflows(laid),
+    };
+}
+/**
+ * A concise, accurate description of the engine's constraints, DERIVED from
+ * flowpad-core's exported rule constants — no hand-maintained copy to drift. Gives
+ * an external AI the vocabulary + limits up front so what it builds passes
+ * `validateLocal` on the first try.
+ */
+export function describeEngine() {
+    const styleLines = Object.entries(NODE_RULES.STYLE_CAPABILITIES)
+        .filter(([, props]) => props.length > 0)
+        .map(([type, props]) => `    ${type}: ${props.join(', ')}`);
+    return [
+        'FLOWPAD ENGINE — rules an edit must satisfy (validated locally before send):',
+        '',
+        'NODES',
+        `  allowed types: ${NODE_RULES.ALLOWED_TYPES.join(', ')}`,
+        `  name ≤ ${NODE_RULES.NAME_MAX_LENGTH} chars; ≤ ${NODE_RULES.MAX_CHILDREN} children/node;`,
+        `  ≤ ${NODE_RULES.MAX_EDGES_PER_NODE} edges/node; ≤ ${NODE_RULES.MAX_NODES_PER_PROJECT} nodes/project.`,
+        '  box fill/border style props are type-specific:',
+        ...styleLines,
+        '  (text/sticky/image paint their own colors via separate fields, not these.)',
+        '',
+        'BOUNDS (x, y, width, height — all finite numbers)',
+        `  width/height ≥ 0 (0 collapses a flex item; negative rejected), ≤ ${BOUNDS_RULES.MAX_WIDTH}.`,
+        `  x/y within ${BOUNDS_RULES.MIN_COORDINATE}…${BOUNDS_RULES.MAX_COORDINATE}.`,
+        '',
+        'LAYOUT (only when isAutoLayout:true — node becomes a flex container)',
+        `  flexDirection: ${LAYOUT_RULES.ALLOWED_FLEX_DIRECTIONS.join(' | ')}`,
+        `  justifyContent: ${LAYOUT_RULES.ALLOWED_JUSTIFY_CONTENT.join(' | ')}`,
+        `  alignItems: ${LAYOUT_RULES.ALLOWED_ALIGN_ITEMS.join(' | ')}`,
+        `  gap ${LAYOUT_RULES.MIN_GAP}…${LAYOUT_RULES.MAX_GAP}, padding ${LAYOUT_RULES.MIN_PADDING}…${LAYOUT_RULES.MAX_PADDING},`,
+        `  margin ${LAYOUT_RULES.MIN_MARGIN}…${LAYOUT_RULES.MAX_MARGIN}, flexGrow/Shrink ${LAYOUT_RULES.MIN_FLEX_GROW}…${LAYOUT_RULES.MAX_FLEX_GROW}.`,
+        '  defaults are browser-parity: flexShrink 1, flexWrap nowrap, alignItems stretch.',
+        '',
+        'EDGES (connections FROM a node TO another)',
+        `  ports: ${EDGE_RULES.ALLOWED_PORTS.join(', ')}; no self-loops; no dangling targets.`,
+        '  direction rule: an edge may NOT point INTO a task node — connect task→regular,',
+        '  never regular→task or task→task (such edges are dropped).',
+    ].join('\n');
+}
+//# sourceMappingURL=local-engine.js.map

package/dist/local-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-engine.js","sourceRoot":"","sources":["../src/local-engine.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,+EAA+E;AAC/E,gEAAgE;AAChE,kFAAkF;AAClF,+DAA+D;AAC/D,kFAAkF;AAClF,2EAA2E;AAC3E,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,GAEX,MAAM,cAAc,CAAC;AAGtB;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAe,EACf,iBAAiB,GAAG,CAAC;IAErB,OAAO,mBAAmB,CACxB,IAA4D,EAC5D,iBAAiB,CAClB,CAAC;AACJ,CAAC;AASD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,EAEvC,CAAC;IACL,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,KAA8B,CAAC;IAChD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAc,EAAE,CAAC,CAAC;QACxE,8EAA8E;QAC9E,kCAAkC;QAClC,SAAS,EAAE,qBAAqB,CAC9B,IAA8D,CAC/D;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC;SAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE9D,OAAO;QACL,8EAA8E;QAC9E,EAAE;QACF,OAAO;QACP,oBAAoB,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACzD,YAAY,UAAU,CAAC,eAAe,aAAa,UAAU,CAAC,YAAY,iBAAiB;QAC3F,OAAO,UAAU,CAAC,kBAAkB,kBAAkB,UAAU,CAAC,qBAAqB,iBAAiB;QACvG,kDAAkD;QAClD,GAAG,UAAU;QACb,8EAA8E;QAC9E,EAAE;QACF,mDAAmD;QACnD,sEAAsE,YAAY,CAAC,SAAS,GAAG;QAC/F,gBAAgB,YAAY,CAAC,cAAc,IAAI,YAAY,CAAC,cAAc,GAAG;QAC7E,EAAE;QACF,sEAAsE;QACtE,oBAAoB,YAAY,CAAC,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QACtE,qBAAqB,YAAY,CAAC,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QACvE,iBAAiB,YAAY,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QAC/D,SAAS,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,OAAO,aAAa,YAAY,CAAC,WAAW,IAAI,YAAY,CAAC,WAAW,GAAG;QACzH,YAAY,YAAY,CAAC,UAAU,IAAI,YAAY,CAAC,UAAU,qBAAqB,YAAY,CAAC,aAAa,IAAI,YAAY,CAAC,aAAa,GAAG;QAC9I,mFAAmF;QACnF,EAAE;QACF,4CAA4C;QAC5C,YAAY,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,uCAAuC;QACtF,kFAAkF;QAClF,6DAA6D;KAC9D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}