easyeda-mcp-pro 0.3.2 → 0.5.2

package/dist/circuit/design-intent.d.ts

@@ -0,0 +1,94 @@
+/**
+ * DesignIntent — versioned, validated user requirements model.
+ *
+ * A DesignIntent captures what the user wants to build at a high level:
+ * project goal, functional blocks, electrical requirements, power rails,
+ * mechanical constraints, manufacturing intent, and safety/regulatory notes.
+ *
+ * DesignIntent is the **input** to the compile pipeline.  It is compiled
+ * into a CircuitIR (the validated, machine-readable source of truth) which
+ * downstream EasyEDA tools consume.
+ *
+ * @schema design-intent/v1
+ */
+import { z } from 'zod';
+import { BoardType } from './types.js';
+export declare const DESIGN_INTENT_SCHEMA_VERSION = "design-intent/v1";
+export declare const DesignIntentSchema: z.ZodObject<{
+    $schema: z.ZodDefault<z.ZodLiteral<"design-intent/v1">>;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        goal: z.ZodString;
+        boardType: z.ZodEnum<typeof BoardType>;
+    }, z.core.$strip>;
+    requirements: z.ZodObject<{
+        functionalBlocks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodString;
+            purpose: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        electrical: z.ZodDefault<z.ZodObject<{
+            vinMin: z.ZodOptional<z.ZodNumber>;
+            vinMax: z.ZodOptional<z.ZodNumber>;
+            currentMaxAmps: z.ZodOptional<z.ZodNumber>;
+            frequencyMaxHz: z.ZodOptional<z.ZodNumber>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        power: z.ZodObject<{
+            rails: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                voltage: z.ZodNumber;
+                tolerance: z.ZodDefault<z.ZodNumber>;
+                maxCurrentAmps: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        mechanical: z.ZodDefault<z.ZodObject<{
+            widthMm: z.ZodOptional<z.ZodNumber>;
+            heightMm: z.ZodOptional<z.ZodNumber>;
+            layers: z.ZodOptional<z.ZodNumber>;
+            mountingHoles: z.ZodOptional<z.ZodBoolean>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        manufacturing: z.ZodDefault<z.ZodObject<{
+            volume: z.ZodOptional<z.ZodEnum<{
+                prototype: "prototype";
+                "small-series": "small-series";
+                "medium-series": "medium-series";
+                "mass-production": "mass-production";
+            }>>;
+            process: z.ZodOptional<z.ZodEnum<{
+                "lead-free": "lead-free";
+                "lead-based": "lead-based";
+                mixed: "mixed";
+            }>>;
+            timelineWeeks: z.ZodOptional<z.ZodNumber>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        safety: z.ZodDefault<z.ZodObject<{
+            isolation: z.ZodOptional<z.ZodBoolean>;
+            certifications: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            regulatory: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    assumptions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    unknowns: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        version: z.ZodDefault<z.ZodLiteral<"1.0.0">>;
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type DesignIntent = z.infer<typeof DesignIntentSchema>;
+/**
+ * Parse and validate an unknown input as a DesignIntent.
+ *
+ * Returns the validated DesignIntent on success.
+ * Throws `CircuitError` with structured errors on failure.
+ */
+export declare function validateDesignIntent(input: unknown): DesignIntent;
+/**
+ * Type guard: check whether an unknown value is a valid DesignIntent.
+ */
+export declare function isDesignIntent(value: unknown): value is DesignIntent;

package/dist/circuit/design-intent.js

@@ -0,0 +1,118 @@
+/**
+ * DesignIntent — versioned, validated user requirements model.
+ *
+ * A DesignIntent captures what the user wants to build at a high level:
+ * project goal, functional blocks, electrical requirements, power rails,
+ * mechanical constraints, manufacturing intent, and safety/regulatory notes.
+ *
+ * DesignIntent is the **input** to the compile pipeline.  It is compiled
+ * into a CircuitIR (the validated, machine-readable source of truth) which
+ * downstream EasyEDA tools consume.
+ *
+ * @schema design-intent/v1
+ */
+import { z } from 'zod';
+import { BoardType } from './types.js';
+import { CircuitError, CircuitErrorCode, fromZodError } from './errors.js';
+// ── Schema version ────────────────────────────────────────────────────────
+export const DESIGN_INTENT_SCHEMA_VERSION = 'design-intent/v1';
+// ── Sub-schemas ───────────────────────────────────────────────────────────
+const boardTypeSchema = z.nativeEnum(BoardType);
+const functionalBlockReqSchema = z.object({
+    id: z.string().min(1).max(64),
+    name: z.string().min(1).max(128),
+    type: z.string().min(1).max(64),
+    purpose: z.string().min(1).max(1024),
+    required: z.boolean().default(true),
+});
+const powerRailReqSchema = z.object({
+    id: z.string().min(1).max(64),
+    voltage: z.number().positive(),
+    tolerance: z.number().min(0).max(100).default(5),
+    maxCurrentAmps: z.number().nonnegative().optional(),
+    description: z.string().max(256).optional(),
+});
+const electricalReqSchema = z.object({
+    vinMin: z.number().nonnegative().optional(),
+    vinMax: z.number().nonnegative().optional(),
+    currentMaxAmps: z.number().nonnegative().optional(),
+    frequencyMaxHz: z.number().nonnegative().optional(),
+    notes: z.string().max(1024).optional(),
+});
+const mechanicalConstraintsSchema = z.object({
+    widthMm: z.number().positive().optional(),
+    heightMm: z.number().positive().optional(),
+    layers: z.number().int().positive().max(64).optional(),
+    mountingHoles: z.boolean().optional(),
+    notes: z.string().max(1024).optional(),
+});
+const manufacturingIntentSchema = z.object({
+    volume: z.enum(['prototype', 'small-series', 'medium-series', 'mass-production']).optional(),
+    process: z.enum(['lead-free', 'lead-based', 'mixed']).optional(),
+    timelineWeeks: z.number().int().positive().optional(),
+    notes: z.string().max(1024).optional(),
+});
+const safetyNotesSchema = z.object({
+    isolation: z.boolean().optional(),
+    certifications: z.array(z.string()).optional(),
+    regulatory: z.string().max(2048).optional(),
+});
+// ── Full DesignIntent schema ──────────────────────────────────────────────
+export const DesignIntentSchema = z
+    .object({
+    $schema: z.literal(DESIGN_INTENT_SCHEMA_VERSION).default(DESIGN_INTENT_SCHEMA_VERSION),
+    project: z.object({
+        name: z.string().min(1).max(128),
+        goal: z.string().min(1).max(4096),
+        boardType: boardTypeSchema,
+    }),
+    requirements: z.object({
+        functionalBlocks: z.array(functionalBlockReqSchema).min(1, {
+            message: 'At least one functional block is required',
+        }),
+        electrical: electricalReqSchema.default({}),
+        power: z.object({
+            rails: z.array(powerRailReqSchema).min(1, {
+                message: 'At least one power rail is required',
+            }),
+        }),
+        mechanical: mechanicalConstraintsSchema.default({}),
+        manufacturing: manufacturingIntentSchema.default({}),
+        safety: safetyNotesSchema.default({}),
+    }),
+    assumptions: z.array(z.string()).default([]),
+    unknowns: z.array(z.string()).default([]),
+    metadata: z
+        .object({
+        version: z.literal('1.0.0').default('1.0.0'),
+        createdAt: z.string().datetime().optional(),
+    })
+        .optional(),
+})
+    .strict();
+// ── Validation helper ─────────────────────────────────────────────────────
+/**
+ * Parse and validate an unknown input as a DesignIntent.
+ *
+ * Returns the validated DesignIntent on success.
+ * Throws `CircuitError` with structured errors on failure.
+ */
+export function validateDesignIntent(input) {
+    const result = DesignIntentSchema.safeParse(input);
+    if (!result.success) {
+        const errors = fromZodError(result.error, 'designIntent');
+        throw new CircuitError({
+            code: CircuitErrorCode.DESIGN_INTENT_INVALID,
+            message: 'DesignIntent validation failed',
+            errors,
+        });
+    }
+    return result.data;
+}
+/**
+ * Type guard: check whether an unknown value is a valid DesignIntent.
+ */
+export function isDesignIntent(value) {
+    return DesignIntentSchema.safeParse(value).success;
+}
+//# sourceMappingURL=design-intent.js.map

package/dist/circuit/design-intent.js.map

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

package/dist/circuit/errors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Circuit-specific validation and compilation errors.
+ *
+ * These extend the project's existing error pattern (see src/schemas/common.ts)
+ * and provide structured, actionable error messages for DesignIntent and CircuitIR
+ * validation failures.
+ */
+import { ZodError } from 'zod';
+export declare const CircuitErrorCode: {
+    readonly DESIGN_INTENT_INVALID: "DESIGN_INTENT_INVALID";
+    readonly DESIGN_INTENT_MISSING_BLOCKS: "DESIGN_INTENT_MISSING_BLOCKS";
+    readonly DESIGN_INTENT_RAIL_CONFLICT: "DESIGN_INTENT_RAIL_CONFLICT";
+    readonly CIRCUIT_IR_INVALID: "CIRCUIT_IR_INVALID";
+    readonly CIRCUIT_IR_BLOCK_DEVICE_MISMATCH: "CIRCUIT_IR_BLOCK_DEVICE_MISMATCH";
+    readonly CIRCUIT_IR_NET_ORPHAN: "CIRCUIT_IR_NET_ORPHAN";
+    readonly CIRCUIT_IR_RAIL_VOLTAGE_MISMATCH: "CIRCUIT_IR_RAIL_VOLTAGE_MISMATCH";
+    readonly CIRCUIT_IR_DUPLICATE_ID: "CIRCUIT_IR_DUPLICATE_ID";
+    readonly CIRCUIT_IR_REFERENCE_MISSING: "CIRCUIT_IR_REFERENCE_MISSING";
+    readonly COMPILE_FAILED: "COMPILE_FAILED";
+    readonly COMPILE_UNSUPPORTED_BOARD_TYPE: "COMPILE_UNSUPPORTED_BOARD_TYPE";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+};
+export type CircuitErrorCode = (typeof CircuitErrorCode)[keyof typeof CircuitErrorCode];
+export interface CircuitValidationError {
+    code: CircuitErrorCode;
+    message: string;
+    /** Path to the field that caused the error (dot-notation) */
+    path?: string;
+    /** Specific details for programmatic handling */
+    details?: Record<string, unknown>;
+}
+export declare class CircuitError extends Error {
+    readonly code: CircuitErrorCode;
+    readonly errors: CircuitValidationError[];
+    readonly retryable: boolean;
+    constructor(opts: {
+        code: CircuitErrorCode;
+        message: string;
+        errors?: CircuitValidationError[];
+        retryable?: boolean;
+    });
+}
+/**
+ * Wrap a ZodError into a list of CircuitValidationErrors.
+ */
+export declare function fromZodError(zodError: ZodError, prefix?: string): CircuitValidationError[];
+/**
+ * Create a single validation error.
+ */
+export declare function validationError(code: CircuitErrorCode, message: string, details?: Record<string, unknown>): CircuitValidationError;

package/dist/circuit/errors.js

@@ -0,0 +1,61 @@
+/**
+ * Circuit-specific validation and compilation errors.
+ *
+ * These extend the project's existing error pattern (see src/schemas/common.ts)
+ * and provide structured, actionable error messages for DesignIntent and CircuitIR
+ * validation failures.
+ */
+// ── Error codes ───────────────────────────────────────────────────────────
+export const CircuitErrorCode = {
+    // DesignIntent validation
+    DESIGN_INTENT_INVALID: 'DESIGN_INTENT_INVALID',
+    DESIGN_INTENT_MISSING_BLOCKS: 'DESIGN_INTENT_MISSING_BLOCKS',
+    DESIGN_INTENT_RAIL_CONFLICT: 'DESIGN_INTENT_RAIL_CONFLICT',
+    // CircuitIR validation
+    CIRCUIT_IR_INVALID: 'CIRCUIT_IR_INVALID',
+    CIRCUIT_IR_BLOCK_DEVICE_MISMATCH: 'CIRCUIT_IR_BLOCK_DEVICE_MISMATCH',
+    CIRCUIT_IR_NET_ORPHAN: 'CIRCUIT_IR_NET_ORPHAN',
+    CIRCUIT_IR_RAIL_VOLTAGE_MISMATCH: 'CIRCUIT_IR_RAIL_VOLTAGE_MISMATCH',
+    CIRCUIT_IR_DUPLICATE_ID: 'CIRCUIT_IR_DUPLICATE_ID',
+    CIRCUIT_IR_REFERENCE_MISSING: 'CIRCUIT_IR_REFERENCE_MISSING',
+    // Compilation
+    COMPILE_FAILED: 'COMPILE_FAILED',
+    COMPILE_UNSUPPORTED_BOARD_TYPE: 'COMPILE_UNSUPPORTED_BOARD_TYPE',
+    // Internal
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+};
+export class CircuitError extends Error {
+    code;
+    errors;
+    retryable;
+    constructor(opts) {
+        super(opts.message);
+        this.name = 'CircuitError';
+        this.code = opts.code;
+        this.errors = opts.errors ?? [];
+        this.retryable = opts.retryable ?? false;
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────────────
+/**
+ * Wrap a ZodError into a list of CircuitValidationErrors.
+ */
+export function fromZodError(zodError, prefix) {
+    return zodError.issues.map((issue) => ({
+        code: 'CIRCUIT_IR_INVALID',
+        message: issue.message,
+        path: prefix ? `${prefix}.${issue.path.join('.')}` : issue.path.join('.'),
+        details: {
+            code: issue.code,
+            expected: issue.message,
+            received: issue.received,
+        },
+    }));
+}
+/**
+ * Create a single validation error.
+ */
+export function validationError(code, message, details) {
+    return { code, message, details };
+}
+//# sourceMappingURL=errors.js.map

package/dist/circuit/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/circuit/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,6EAA6E;AAE7E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,0BAA0B;IAC1B,qBAAqB,EAAE,uBAAuB;IAC9C,4BAA4B,EAAE,8BAA8B;IAC5D,2BAA2B,EAAE,6BAA6B;IAE1D,uBAAuB;IACvB,kBAAkB,EAAE,oBAAoB;IACxC,gCAAgC,EAAE,kCAAkC;IACpE,qBAAqB,EAAE,uBAAuB;IAC9C,gCAAgC,EAAE,kCAAkC;IACpE,uBAAuB,EAAE,yBAAyB;IAClD,4BAA4B,EAAE,8BAA8B;IAE5D,cAAc;IACd,cAAc,EAAE,gBAAgB;IAChC,8BAA8B,EAAE,gCAAgC;IAEhE,WAAW;IACX,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAeX,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAmB;IACvB,MAAM,CAA2B;IACjC,SAAS,CAAU;IAEnC,YAAY,IAKX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,CAAC;CACF;AAED,6EAA6E;AAE7E;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAkB,EAAE,MAAe;IAC9D,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,EAAE,oBAAwC;QAC9C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QACzE,OAAO,EAAE;YACP,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,QAAQ,EAAG,KAAgC,CAAC,QAAQ;SACrD;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAsB,EACtB,OAAe,EACf,OAAiC;IAEjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/circuit/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Circuit module — DesignIntent and CircuitIR schemas, compiler, and types.
+ *
+ * Public API surface for the circuit modeling subsystem.
+ *
+ * @module
+ */
+export { CircuitError, CircuitErrorCode, fromZodError, validationError } from './errors.js';
+export type { CircuitErrorCode as CircuitErrorCodeType, CircuitValidationError } from './errors.js';
+export { BoardType, ValidationStatus, NetType, BlockType, ConstraintSeverity, ConstraintType, isValidBoardType, isValidBlockType, } from './types.js';
+export type { DesignIntentRef, MetadataEntry } from './types.js';
+export { DesignIntentSchema, DESIGN_INTENT_SCHEMA_VERSION, validateDesignIntent, isDesignIntent, } from './design-intent.js';
+export type { DesignIntent } from './design-intent.js';
+export { CircuitIRSchema, CIRCUIT_IR_SCHEMA_VERSION, BlockSchema, DeviceSchema, NetSchema, NetNodeSchema, PowerRailSchema, InterfaceSchema, InterfacePinSchema, ConstraintSchema, BomIntentSchema, PcbIntentSchema, ManufacturingIntentSchema, validateCircuitIR, isCircuitIR, } from './circuit-ir.js';
+export type { CircuitIR, Block, Device, Net, NetNode, PowerRail, Interface, InterfacePin, Constraint, BomIntent, PcbIntent, ManufacturingIntent, } from './circuit-ir.js';
+export { compile, setValidationStatus, isReadyForEasyEDA } from './compiler.js';
+export type { CompileOptions, CompileResult } from './compiler.js';

package/dist/circuit/index.js

@@ -0,0 +1,18 @@
+/**
+ * Circuit module — DesignIntent and CircuitIR schemas, compiler, and types.
+ *
+ * Public API surface for the circuit modeling subsystem.
+ *
+ * @module
+ */
+// Errors
+export { CircuitError, CircuitErrorCode, fromZodError, validationError } from './errors.js';
+// Types
+export { BoardType, ValidationStatus, NetType, BlockType, ConstraintSeverity, ConstraintType, isValidBoardType, isValidBlockType, } from './types.js';
+// DesignIntent
+export { DesignIntentSchema, DESIGN_INTENT_SCHEMA_VERSION, validateDesignIntent, isDesignIntent, } from './design-intent.js';
+// CircuitIR
+export { CircuitIRSchema, CIRCUIT_IR_SCHEMA_VERSION, BlockSchema, DeviceSchema, NetSchema, NetNodeSchema, PowerRailSchema, InterfaceSchema, InterfacePinSchema, ConstraintSchema, BomIntentSchema, PcbIntentSchema, ManufacturingIntentSchema, validateCircuitIR, isCircuitIR, } from './circuit-ir.js';
+// Compiler
+export { compile, setValidationStatus, isReadyForEasyEDA } from './compiler.js';
+//# sourceMappingURL=index.js.map

package/dist/circuit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/circuit/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5F,QAAQ;AACR,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,eAAe;AACf,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,oBAAoB,EACpB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY;AACZ,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAgBzB,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/circuit/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Shared enums and primitive types for DesignIntent and CircuitIR.
+ *
+ * These types are schema-agnostic — they define the vocabulary used by
+ * both DesignIntent (user-facing requirements) and CircuitIR (machine-readable
+ * resolved model).
+ */
+/** High-level board / application category. */
+export declare enum BoardType {
+    PowerSupply = "power-supply",
+    McuBoard = "mcu-board",
+    SensorBoard = "sensor-board",
+    AcDcIot = "ac-dc-iot",
+    Hierarchical = "hierarchical",
+    Custom = "custom"
+}
+/** Validation lifecycle state of a CircuitIR model. */
+export declare enum ValidationStatus {
+    Draft = "draft",
+    Validated = "validated",
+    Rejected = "rejected"
+}
+/** Classification of an electrical net. */
+export declare enum NetType {
+    Power = "power",
+    Signal = "signal",
+    Ground = "ground"
+}
+/** Classification of a functional block. */
+export declare enum BlockType {
+    PowerManagement = "power-management",
+    Microcontroller = "microcontroller",
+    Sensor = "sensor",
+    Communication = "communication",
+    Interface = "interface",
+    Protection = "protection",
+    Analog = "analog",
+    Custom = "custom"
+}
+/** Severity of a circuit constraint. */
+export declare enum ConstraintSeverity {
+    Required = "required",
+    Recommended = "recommended",
+    Informational = "informational"
+}
+/** Kind of constraint. */
+export declare enum ConstraintType {
+    Electrical = "electrical",
+    Mechanical = "mechanical",
+    Thermal = "thermal",
+    Regulatory = "regulatory",
+    Cost = "cost",
+    PcbLayout = "pcb-layout",
+    Manufacturing = "manufacturing"
+}
+/** PCB layer function / type. */
+export declare enum BoardLayerType {
+    Signal = "signal",
+    Power = "power",
+    Ground = "ground",
+    Plane = "plane",
+    Mechanical = "mechanical",
+    SolderMask = "solder-mask",
+    Paste = "paste",
+    Silkscreen = "silkscreen",
+    Drill = "drill",
+    Keepout = "keepout"
+}
+/** Side of the board for component placement. */
+export declare enum PlacementSide {
+    Top = "top",
+    Bottom = "bottom",
+    Both = "both"
+}
+/** Restriction applied to a keepout area. */
+export declare enum KeepoutRestriction {
+    All = "all",
+    Tracks = "tracks",
+    Vias = "vias",
+    Components = "components",
+    Copper = "copper",
+    Routing = "routing"
+}
+/** Type of mounting hole. */
+export declare enum MountingHoleType {
+    Unplated = "unplated",
+    Plated = "plated",
+    Tooling = "tooling"
+}
+/** Purpose for a placement zone. */
+export declare enum PlacementZoneType {
+    Power = "power",
+    Analog = "analog",
+    Digital = "digital",
+    Usb = "usb",
+    Sensor = "sensor",
+    AcDc = "ac-dc",
+    HighVoltage = "high-voltage",
+    Rf = "rf",
+    Thermal = "thermal",
+    General = "general"
+}
+/** A 2D point on the board (mm). */
+export interface Point2D {
+    x: number;
+    y: number;
+}
+/** A board outline defined as an extruded polygon. */
+export interface BoardOutline {
+    shape: Point2D[];
+    cutouts?: Point2D[][];
+}
+/** One layer in the PCB stackup. */
+export interface LayerStackEntry {
+    name: string;
+    type: BoardLayerType;
+    thicknessMm: number;
+    material: string;
+    copperWeightOz?: number;
+    dielectricConstant?: number;
+    order: number;
+}
+/** A net class with routing rules. */
+export interface NetClassRule {
+    name: string;
+    traceWidthMm: number;
+    clearanceMm: number;
+    viaDiameterMm?: number;
+    viaHoleMm?: number;
+    priority?: number;
+    netNames?: string[];
+}
+/** Clearance rule between two net classes. */
+export interface ClearanceRule {
+    netClassA: string;
+    netClassB: string;
+    clearanceMm: number;
+    layer?: string;
+}
+/** A restricted area on the board. */
+export interface KeepoutArea {
+    outline: Point2D[];
+    layer: string;
+    restriction: KeepoutRestriction;
+    description?: string;
+}
+/** A placement zone for grouping components. */
+export interface PlacementZone {
+    outline: Point2D[];
+    layer: PlacementSide;
+    zoneType: PlacementZoneType;
+    name: string;
+    allowedRefs?: string[];
+    description?: string;
+}
+/** A fiducial mark. */
+export interface Fiducial {
+    x: number;
+    y: number;
+    type: 'global' | 'local';
+    top: boolean;
+    bottom?: boolean;
+}
+/** A test pad specification. */
+export interface TestPad {
+    x: number;
+    y: number;
+    netName: string;
+    diameterMm: number;
+    layer: PlacementSide;
+    label?: string;
+}
+/** A traceability reference pointing back to a DesignIntent requirement. */
+export interface DesignIntentRef {
+    /** ID of the requirement within the DesignIntent (e.g. "req-power-001"). */
+    requirementId: string;
+    /** Optional free-text note explaining how this node satisfies the requirement. */
+    note?: string;
+}
+/** A generic key-value metadata entry. */
+export interface MetadataEntry {
+    key: string;
+    value: string;
+}
+export declare function isValidBoardType(value: string): value is BoardType;
+export declare function isValidBlockType(value: string): value is BlockType;