flowpad-mcp 0.1.0 → 0.1.2

package/dist/local-engine.js

@@ -1,82 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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"}