easyeda-mcp-pro 0.10.0 → 0.12.0

package/dist/bridge/types.d.ts

@@ -17,12 +17,12 @@ export declare const EasyedaApiMethodSchema: z.ZodEnum<{
     "export.pickPlace": "export.pickPlace";
     "export.pdf": "export.pdf";
     "export.netlist": "export.netlist";
+    "pcb.modifyComponent": "pcb.modifyComponent";
     "pcb.placeComponent": "pcb.placeComponent";
     "pcb.addTrack": "pcb.addTrack";
     "pcb.addVia": "pcb.addVia";
     "pcb.addZone": "pcb.addZone";
     "pcb.deleteComponent": "pcb.deleteComponent";
-    "pcb.modifyComponent": "pcb.modifyComponent";
     "schematic.searchDevice": "schematic.searchDevice";
     "schematic.listComponents": "schematic.listComponents";
     "schematic.getNetDetail": "schematic.getNetDetail";

package/dist/config/profiles.js

@@ -3,35 +3,35 @@ export const PROFILE_DEFINITIONS = {
         name: 'core',
         label: 'Core',
         description: 'High-confidence tools: diagnostics, EasyEDA API inventory, schematic, BOM, DRC/ERC, board layers/stackup, Gerber export',
-        approxToolCount: '40',
+        approxToolCount: '41',
         isDefault: true,
     },
     pro: {
         name: 'pro',
         label: 'Pro',
         description: 'Adds pick-and-place, PDF, netlist export for manufacturing workflows',
-        approxToolCount: '43',
+        approxToolCount: '44',
         isDefault: false,
     },
     full: {
         name: 'full',
         label: 'Full',
         description: 'Adds controlled documented EasyEDA API method calls for full runtime control without raw JavaScript execution',
-        approxToolCount: '50',
+        approxToolCount: '53',
         isDefault: false,
     },
     dev: {
         name: 'dev',
         label: 'Dev',
         description: 'Adds diagnostics probes for bridge methods and live component runtime shape inspection',
-        approxToolCount: '54',
+        approxToolCount: '57',
         isDefault: false,
     },
     experimental: {
         name: 'experimental',
         label: 'Experimental',
         description: 'MCP Apps, Tasks, simulation, autorouter, AI action plans',
-        approxToolCount: '52',
+        approxToolCount: '55',
         isDefault: false,
     },
 };

package/dist/config/version.d.ts

@@ -1 +1 @@
-export declare const SERVER_VERSION = "0.10.0";
+export declare const SERVER_VERSION = "0.12.0";

package/dist/config/version.js

@@ -1,2 +1,2 @@
-export const SERVER_VERSION = '0.10.0'; // x-release-please-version
+export const SERVER_VERSION = '0.12.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/dist/pcb-layout/index.d.ts

@@ -0,0 +1,2 @@
+export { planComponentGroupPlacement, planRoutePath } from './planner.js';
+export type * from './types.js';

package/dist/pcb-layout/index.js

@@ -0,0 +1,2 @@
+export { planComponentGroupPlacement, planRoutePath } from './planner.js';
+//# sourceMappingURL=index.js.map

package/dist/pcb-layout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pcb-layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/pcb-layout/planner.d.ts

@@ -0,0 +1,5 @@
+import type { ComponentGroupPlacementInput, ComponentGroupPlacementPlan, RoutePathInput, RoutePathPlan } from './types.js';
+/** Create a preview/apply plan for placing a group of components on a grid. */
+export declare function planComponentGroupPlacement(input: ComponentGroupPlacementInput): ComponentGroupPlacementPlan;
+/** Create a preview/apply plan for a constrained routed path. */
+export declare function planRoutePath(input: RoutePathInput): RoutePathPlan;

package/dist/pcb-layout/planner.js

@@ -0,0 +1,222 @@
+import { createHash } from 'node:crypto';
+function txId(prefix, payload) {
+    return `${prefix}_${createHash('sha256').update(JSON.stringify(payload)).digest('hex').slice(0, 16)}`;
+}
+function issue(code, severity, message, remediationHint, details) {
+    return { code, severity, message, remediationHint, details };
+}
+function rectsOverlap(a, b) {
+    return (a.x < b.x + b.widthMm &&
+        a.x + a.widthMm > b.x &&
+        a.y < b.y + b.heightMm &&
+        a.y + a.heightMm > b.y);
+}
+function pointInsideRect(point, rect) {
+    return (point.x >= rect.x &&
+        point.x <= rect.x + rect.widthMm &&
+        point.y >= rect.y &&
+        point.y <= rect.y + rect.heightMm);
+}
+function rectInsideBoard(rect, board) {
+    return (rect.x >= 0 &&
+        rect.y >= 0 &&
+        rect.x + rect.widthMm <= board.widthMm &&
+        rect.y + rect.heightMm <= board.heightMm);
+}
+function pointInsideBoard(point, board) {
+    return point.x >= 0 && point.y >= 0 && point.x <= board.widthMm && point.y <= board.heightMm;
+}
+function inflate(rect, amount) {
+    return {
+        x: rect.x - amount,
+        y: rect.y - amount,
+        widthMm: rect.widthMm + amount * 2,
+        heightMm: rect.heightMm + amount * 2,
+        name: rect.name,
+    };
+}
+function distance(a, b) {
+    return Math.hypot(a.x - b.x, a.y - b.y);
+}
+function routeLength(points) {
+    let total = 0;
+    for (let index = 1; index < points.length; index += 1) {
+        const previous = points[index - 1];
+        const current = points[index];
+        if (!previous || !current)
+            continue;
+        total += distance(previous, current);
+    }
+    return total;
+}
+function segmentIntersectsRect(a, b, rect) {
+    if (pointInsideRect(a, rect) || pointInsideRect(b, rect))
+        return true;
+    const steps = Math.max(2, Math.ceil(distance(a, b) / 0.5));
+    for (let i = 1; i < steps; i += 1) {
+        const t = i / steps;
+        const point = { x: a.x + (b.x - a.x) * t, y: a.y + (b.y - a.y) * t };
+        if (pointInsideRect(point, rect))
+            return true;
+    }
+    return false;
+}
+function invalidBoard(board) {
+    return board.widthMm <= 0 || board.heightMm <= 0;
+}
+/** Create a preview/apply plan for placing a group of components on a grid. */
+export function planComponentGroupPlacement(input) {
+    const mode = input.mode ?? 'preview';
+    const layer = input.layer ?? 1;
+    const columns = Math.max(1, input.columns ?? input.components.length);
+    const spacing = input.spacingMm ?? 1.5;
+    const minSpacing = input.minSpacingMm ?? 0.25;
+    const issues = [];
+    const placements = [];
+    if (invalidBoard(input.board)) {
+        issues.push(issue('LAYOUT_INVALID_BOARD', 'error', 'Board dimensions must be positive', 'Provide valid board width and height before planning placement.', { board: input.board }));
+    }
+    input.components.forEach((component, index) => {
+        if (!component.ref || component.widthMm <= 0 || component.heightMm <= 0) {
+            issues.push(issue('LAYOUT_INVALID_COMPONENT', 'error', `Component ${component.ref || index} has invalid dimensions or reference`, 'Provide component ref, width, and height in millimeters.', { component }));
+            return;
+        }
+        const col = index % columns;
+        const row = Math.floor(index / columns);
+        const x = input.anchor.x + col * (component.widthMm + spacing);
+        const y = input.anchor.y + row * (component.heightMm + spacing);
+        const bbox = {
+            x: x - component.widthMm / 2,
+            y: y - component.heightMm / 2,
+            widthMm: component.widthMm,
+            heightMm: component.heightMm,
+            name: component.ref,
+        };
+        const placement = {
+            ref: component.ref,
+            primitiveId: component.primitiveId,
+            footprint: component.footprint,
+            x,
+            y,
+            rotation: component.rotation ?? 0,
+            layer,
+            widthMm: component.widthMm,
+            heightMm: component.heightMm,
+            bbox,
+        };
+        if (!rectInsideBoard(bbox, input.board)) {
+            issues.push(issue('LAYOUT_COMPONENT_OUTSIDE_BOARD', 'error', `Component ${component.ref} would be outside the board`, 'Move the anchor, reduce spacing, increase board size, or reduce the component group size.', { ref: component.ref, bbox, board: input.board }));
+        }
+        for (const keepout of input.keepouts ?? []) {
+            if (rectsOverlap(bbox, keepout)) {
+                issues.push(issue('LAYOUT_COMPONENT_IN_KEEPOUT', 'error', `Component ${component.ref} overlaps keepout ${keepout.name ?? ''}`.trim(), 'Move the component group away from keepout regions.', { ref: component.ref, keepout, bbox }));
+            }
+        }
+        for (const previous of placements) {
+            if (rectsOverlap(inflate(previous.bbox, minSpacing), inflate(bbox, minSpacing))) {
+                issues.push(issue('LAYOUT_COMPONENT_COLLISION', 'error', `Component ${component.ref} collides with ${previous.ref}`, 'Increase placement spacing or change grid columns/anchor.', { ref: component.ref, otherRef: previous.ref, minSpacingMm: minSpacing }));
+            }
+        }
+        placements.push(placement);
+    });
+    const operations = placements.map((placement) => ({
+        method: placement.primitiveId ? 'pcb.modifyComponent' : 'pcb.placeComponent',
+        params: placement.primitiveId
+            ? {
+                primitiveId: placement.primitiveId,
+                property: {
+                    x: placement.x,
+                    y: placement.y,
+                    rotation: placement.rotation,
+                    layer: placement.layer,
+                },
+            }
+            : {
+                footprint: placement.footprint ?? placement.ref,
+                x: placement.x,
+                y: placement.y,
+                rotation: placement.rotation,
+                layer: placement.layer,
+            },
+    }));
+    const blocked = issues.some((i) => i.severity === 'error');
+    return {
+        transactionId: txId('layout_place', { input, placements }),
+        projectId: input.projectId ?? '',
+        mode,
+        applied: false,
+        blocked,
+        placements,
+        operations,
+        issues,
+        summary: blocked
+            ? `Placement plan blocked by ${issues.filter((i) => i.severity === 'error').length} error(s).`
+            : `Placement plan ready for ${placements.length} component(s).`,
+    };
+}
+/** Create a preview/apply plan for a constrained routed path. */
+export function planRoutePath(input) {
+    const mode = input.mode ?? 'preview';
+    const issues = [];
+    const length = routeLength(input.waypoints);
+    if (input.waypoints.length < 2) {
+        issues.push(issue('LAYOUT_PATH_TOO_SHORT', 'error', 'Route path requires at least two waypoints', 'Provide start and end waypoints for the route path.', { waypointCount: input.waypoints.length }));
+    }
+    if (input.widthMm <= 0) {
+        issues.push(issue('LAYOUT_TRACE_WIDTH_TOO_SMALL', 'error', 'Trace width must be positive', 'Provide a positive trace width in millimeters.', { widthMm: input.widthMm }));
+    }
+    else if (input.minWidthMm !== undefined && input.widthMm < input.minWidthMm) {
+        issues.push(issue('LAYOUT_TRACE_WIDTH_TOO_SMALL', 'error', `Trace width ${input.widthMm}mm is below required ${input.minWidthMm}mm`, 'Increase trace width or lower the constraint only after electrical/thermal review.', { widthMm: input.widthMm, minWidthMm: input.minWidthMm }));
+    }
+    if (input.maxLengthMm !== undefined && length > input.maxLengthMm) {
+        issues.push(issue('LAYOUT_PATH_TOO_LONG', 'warning', `Route length ${Number(length.toFixed(3))}mm exceeds maximum ${input.maxLengthMm}mm`, 'Shorten the route or relax the maximum length constraint if acceptable.', { pathLengthMm: length, maxLengthMm: input.maxLengthMm }));
+    }
+    if (input.board) {
+        for (const point of input.waypoints) {
+            if (!pointInsideBoard(point, input.board)) {
+                issues.push(issue('LAYOUT_PATH_OUTSIDE_BOARD', 'error', 'Route waypoint is outside the board', 'Move all route waypoints inside the board outline.', { point, board: input.board }));
+            }
+        }
+    }
+    for (let i = 1; i < input.waypoints.length; i += 1) {
+        const a = input.waypoints[i - 1];
+        const b = input.waypoints[i];
+        if (!a || !b)
+            continue;
+        for (const keepout of input.keepouts ?? []) {
+            if (segmentIntersectsRect(a, b, keepout)) {
+                issues.push(issue('LAYOUT_PATH_IN_KEEPOUT', 'error', `Route crosses keepout ${keepout.name ?? ''}`.trim(), 'Add waypoints around keepout regions or change the routing layer.', { keepout, segment: [a, b] }));
+            }
+        }
+    }
+    const flatPoints = input.waypoints.flatMap((point) => [point.x, point.y]);
+    const operations = [
+        {
+            method: 'pcb.addTrack',
+            params: {
+                points: flatPoints,
+                layer: input.layer,
+                width: input.widthMm,
+                netName: input.netName,
+            },
+        },
+    ];
+    const blocked = issues.some((i) => i.severity === 'error');
+    return {
+        transactionId: txId('layout_route', { input, length }),
+        projectId: input.projectId ?? '',
+        mode,
+        applied: false,
+        blocked,
+        netName: input.netName,
+        layer: input.layer,
+        widthMm: input.widthMm,
+        pathLengthMm: Number(length.toFixed(4)),
+        operations,
+        issues,
+        summary: blocked
+            ? `Route plan blocked by ${issues.filter((i) => i.severity === 'error').length} error(s).`
+            : `Route plan ready for net ${input.netName}; length ${Number(length.toFixed(3))}mm.`,
+    };
+}
+//# sourceMappingURL=planner.js.map

package/dist/pcb-layout/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/pcb-layout/planner.ts"],"names":[],"mappings":"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"}

package/dist/pcb-layout/types.d.ts

@@ -0,0 +1,104 @@
+/** High-level PCB layout planning types. */
+export type LayoutExecutionMode = 'preview' | 'apply';
+export type LayoutSeverity = 'error' | 'warning' | 'info';
+export type LayoutIssueCode = 'LAYOUT_COMPONENT_OUTSIDE_BOARD' | 'LAYOUT_COMPONENT_IN_KEEPOUT' | 'LAYOUT_COMPONENT_COLLISION' | 'LAYOUT_INVALID_COMPONENT' | 'LAYOUT_INVALID_BOARD' | 'LAYOUT_PATH_TOO_SHORT' | 'LAYOUT_PATH_OUTSIDE_BOARD' | 'LAYOUT_PATH_IN_KEEPOUT' | 'LAYOUT_PATH_TOO_LONG' | 'LAYOUT_TRACE_WIDTH_TOO_SMALL';
+export interface PointMm {
+    x: number;
+    y: number;
+}
+export interface BoardBox {
+    widthMm: number;
+    heightMm: number;
+}
+export interface RectMm {
+    x: number;
+    y: number;
+    widthMm: number;
+    heightMm: number;
+    name?: string;
+}
+export interface LayoutIssue {
+    code: LayoutIssueCode;
+    severity: LayoutSeverity;
+    message: string;
+    remediationHint: string;
+    details?: Record<string, unknown>;
+}
+export interface ComponentPlacementInput {
+    ref: string;
+    primitiveId?: string;
+    footprint?: string;
+    widthMm: number;
+    heightMm: number;
+    rotation?: number;
+    fixed?: boolean;
+}
+export interface ComponentGroupPlacementInput {
+    projectId?: string;
+    mode?: LayoutExecutionMode;
+    board: BoardBox;
+    anchor: PointMm;
+    columns?: number;
+    spacingMm?: number;
+    layer?: number;
+    minSpacingMm?: number;
+    components: ComponentPlacementInput[];
+    keepouts?: RectMm[];
+    confirmWrite?: boolean;
+}
+export interface PlannedComponentPlacement {
+    ref: string;
+    primitiveId?: string;
+    footprint?: string;
+    x: number;
+    y: number;
+    rotation: number;
+    layer: number;
+    widthMm: number;
+    heightMm: number;
+    bbox: RectMm;
+}
+export interface ComponentGroupPlacementPlan {
+    transactionId: string;
+    projectId: string;
+    mode: LayoutExecutionMode;
+    applied: boolean;
+    blocked: boolean;
+    placements: PlannedComponentPlacement[];
+    operations: Array<{
+        method: string;
+        params: Record<string, unknown>;
+    }>;
+    issues: LayoutIssue[];
+    summary: string;
+}
+export interface RoutePathInput {
+    projectId?: string;
+    mode?: LayoutExecutionMode;
+    board?: BoardBox;
+    netName: string;
+    layer: number;
+    widthMm: number;
+    waypoints: PointMm[];
+    keepouts?: RectMm[];
+    maxLengthMm?: number;
+    minWidthMm?: number;
+    confirmWrite?: boolean;
+}
+export interface RoutePathPlan {
+    transactionId: string;
+    projectId: string;
+    mode: LayoutExecutionMode;
+    applied: boolean;
+    blocked: boolean;
+    netName: string;
+    layer: number;
+    widthMm: number;
+    pathLengthMm: number;
+    operations: Array<{
+        method: string;
+        params: Record<string, unknown>;
+    }>;
+    issues: LayoutIssue[];
+    summary: string;
+}

package/dist/pcb-layout/types.js

@@ -0,0 +1,3 @@
+/** High-level PCB layout planning types. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pcb-layout/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pcb-layout/types.ts"],"names":[],"mappings":"AAAA,4CAA4C"}

package/dist/power-tree/analysis.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Power-tree current budget and thermal analysis.
+ *
+ * @module
+ */
+import type { PowerTreeInput, PowerTreeReport } from './types.js';
+/** Analyze current budget, regulator dissipation, protection, and bulk capacitance. */
+export declare function analyzePowerTree(input: PowerTreeInput): PowerTreeReport;