easyeda-mcp-pro 0.3.2 → 0.5.2

package/dist/bridge/protocol.d.ts

@@ -1,13 +1,42 @@
 import { z } from 'zod';
+/** Supported protocol versions for the bridge pairing/handshake. */
+export declare const SUPPORTED_PROTOCOL_VERSIONS: readonly ["1.0.0"];
+/**
+ * Zod schema for the initial handshake message.
+ * Client → Server: identifies the client and its protocol version.
+ */
 export declare const BridgeHandshakeSchema: z.ZodObject<{
     type: z.ZodLiteral<"handshake">;
     protocol: z.ZodLiteral<"easyeda-mcp-pro.bridge">;
-    protocolVersion: z.ZodLiteral<"1.0.0">;
+    protocolVersion: z.ZodString;
     clientName: z.ZodLiteral<"easyeda-mcp-pro">;
+    extensionVersion: z.ZodOptional<z.ZodString>;
     easyedaVersion: z.ZodOptional<z.ZodString>;
     devMode: z.ZodOptional<z.ZodBoolean>;
     sessionToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * Server → Client: issued before handshake when the bridge requires
+ * a pairing proof-of-possession (non-loopback + BRIDGE_TOKEN set).
+ */
+export declare const BridgePairingChallengeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"pairing_challenge">;
+    challenge: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Client → Server: response to a pairing challenge.
+ * The client echoes the challenge and supplies the session token.
+ */
+export declare const BridgePairingResponseSchema: z.ZodObject<{
+    type: z.ZodLiteral<"pairing_response">;
+    challenge: z.ZodString;
+    sessionToken: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for the hello message.
+ * Server → Client: sent after successful handshake/pairing to announce
+ * bridge capabilities, version info, and the method registry hash.
+ */
 export declare const BridgeHelloSchema: z.ZodObject<{
     type: z.ZodLiteral<"hello">;
     bridgeVersion: z.ZodString;
@@ -17,6 +46,10 @@ export declare const BridgeHelloSchema: z.ZodObject<{
     methodRegistryHash: z.ZodString;
     devMode: z.ZodBoolean;
 }, z.core.$strip>;
+/**
+ * Zod schema for an RPC request message.
+ * Client → Server: invokes a named method with optional parameters.
+ */
 export declare const BridgeRequestSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodLiteral<"request">;
@@ -25,6 +58,10 @@ export declare const BridgeRequestSchema: z.ZodObject<{
     timeoutMs: z.ZodOptional<z.ZodNumber>;
     traceparent: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * Zod schema for an RPC response message.
+ * Server → Client: carries the result or a structured error.
+ */
 export declare const BridgeResponseSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodLiteral<"response">;
@@ -35,6 +72,7 @@ export declare const BridgeResponseSchema: z.ZodObject<{
             BRIDGE_NOT_READY: "BRIDGE_NOT_READY";
             METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED";
             METHOD_NOT_FOUND: "METHOD_NOT_FOUND";
+            NET_NOT_FOUND: "NET_NOT_FOUND";
             EASYEDA_API_ERROR: "EASYEDA_API_ERROR";
             TIMEOUT: "TIMEOUT";
             INVALID_PARAMS: "INVALID_PARAMS";
@@ -49,11 +87,20 @@ export declare const BridgeResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
     durationMs: z.ZodNumber;
 }, z.core.$strip>;
+/**
+ * Zod schema for a heartbeat keep-alive message.
+ * Both directions: ensures the WebSocket connection is still alive.
+ */
 export declare const BridgeHeartbeatSchema: z.ZodObject<{
     type: z.ZodLiteral<"heartbeat">;
     timestamp: z.ZodNumber;
 }, z.core.$strip>;
+/** Inferred TypeScript type for a hello message. */
 export type BridgeHello = z.infer<typeof BridgeHelloSchema>;
+/**
+ * Inferred TypeScript type for a response message with typed result.
+ * @template TResult - The shape of the successful result payload.
+ */
 export type BridgeResponse<TResult = unknown> = Omit<z.infer<typeof BridgeResponseSchema>, 'result' | 'error'> & {
     result?: TResult;
     error?: {

package/dist/bridge/protocol.js

@@ -1,13 +1,42 @@
 import { z } from 'zod';
+/** Supported protocol versions for the bridge pairing/handshake. */
+export const SUPPORTED_PROTOCOL_VERSIONS = ['1.0.0'];
+/**
+ * Zod schema for the initial handshake message.
+ * Client → Server: identifies the client and its protocol version.
+ */
 export const BridgeHandshakeSchema = z.object({
     type: z.literal('handshake'),
     protocol: z.literal('easyeda-mcp-pro.bridge'),
-    protocolVersion: z.literal('1.0.0'),
+    protocolVersion: z.string(),
     clientName: z.literal('easyeda-mcp-pro'),
+    extensionVersion: z.string().optional(),
     easyedaVersion: z.string().optional(),
     devMode: z.boolean().optional(),
     sessionToken: z.string().optional(),
 });
+/**
+ * Server → Client: issued before handshake when the bridge requires
+ * a pairing proof-of-possession (non-loopback + BRIDGE_TOKEN set).
+ */
+export const BridgePairingChallengeSchema = z.object({
+    type: z.literal('pairing_challenge'),
+    challenge: z.string(),
+});
+/**
+ * Client → Server: response to a pairing challenge.
+ * The client echoes the challenge and supplies the session token.
+ */
+export const BridgePairingResponseSchema = z.object({
+    type: z.literal('pairing_response'),
+    challenge: z.string(),
+    sessionToken: z.string(),
+});
+/**
+ * Zod schema for the hello message.
+ * Server → Client: sent after successful handshake/pairing to announce
+ * bridge capabilities, version info, and the method registry hash.
+ */
 export const BridgeHelloSchema = z.object({
     type: z.literal('hello'),
     bridgeVersion: z.string(),
@@ -17,6 +46,10 @@ export const BridgeHelloSchema = z.object({
     methodRegistryHash: z.string(),
     devMode: z.boolean(),
 });
+/**
+ * Zod schema for an RPC request message.
+ * Client → Server: invokes a named method with optional parameters.
+ */
 export const BridgeRequestSchema = z.object({
     id: z.string(),
     type: z.literal('request'),
@@ -25,6 +58,10 @@ export const BridgeRequestSchema = z.object({
     timeoutMs: z.number().int().optional(),
     traceparent: z.string().optional(),
 });
+/**
+ * Zod schema for an RPC response message.
+ * Server → Client: carries the result or a structured error.
+ */
 export const BridgeResponseSchema = z.object({
     id: z.string(),
     type: z.literal('response'),
@@ -36,6 +73,7 @@ export const BridgeResponseSchema = z.object({
             'BRIDGE_NOT_READY',
             'METHOD_NOT_ALLOWED',
             'METHOD_NOT_FOUND',
+            'NET_NOT_FOUND',
             'EASYEDA_API_ERROR',
             'TIMEOUT',
             'INVALID_PARAMS',
@@ -51,6 +89,10 @@ export const BridgeResponseSchema = z.object({
         .optional(),
     durationMs: z.number(),
 });
+/**
+ * Zod schema for a heartbeat keep-alive message.
+ * Both directions: ensures the WebSocket connection is still alive.
+ */
 export const BridgeHeartbeatSchema = z.object({
     type: z.literal('heartbeat'),
     timestamp: z.number(),

package/dist/bridge/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/bridge/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC;IAC7C,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACnC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IACxC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC;SACL,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;YACX,kBAAkB;YAClB,oBAAoB;YACpB,kBAAkB;YAClB,mBAAmB;YACnB,SAAS;YACT,gBAAgB;YAChB,cAAc;YACd,mBAAmB;YACnB,SAAS;SACV,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC5B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACtC,CAAC;SACD,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/bridge/protocol.ts"],"names":[],"mappings":"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"}

package/dist/bridge/types.d.ts

@@ -11,6 +11,11 @@ export declare const EasyedaApiMethodSchema: z.ZodEnum<{
     "schematic.addWire": "schematic.addWire";
     "schematic.deletePrimitive": "schematic.deletePrimitive";
     "schematic.modifyPrimitive": "schematic.modifyPrimitive";
+    "schematic.createNetFlag": "schematic.createNetFlag";
+    "schematic.createNetPort": "schematic.createNetPort";
+    "schematic.connectPinToNet": "schematic.connectPinToNet";
+    "schematic.connectPinsByNet": "schematic.connectPinsByNet";
+    "schematic.validateNetlist": "schematic.validateNetlist";
     "system.apiInventory": "system.apiInventory";
     "system.inspectComponents": "system.inspectComponents";
     "api.call": "api.call";
@@ -36,4 +41,5 @@ export declare const EasyedaApiMethodSchema: z.ZodEnum<{
     "pcb.addZone": "pcb.addZone";
     "pcb.deleteComponent": "pcb.deleteComponent";
     "pcb.modifyComponent": "pcb.modifyComponent";
+    "api.execute": "api.execute";
 }>;

package/dist/bridge/types.js

@@ -11,6 +11,11 @@ export const EasyedaApiMethodSchema = z.enum([
     'schematic.addWire',
     'schematic.deletePrimitive',
     'schematic.modifyPrimitive',
+    'schematic.createNetFlag',
+    'schematic.createNetPort',
+    'schematic.connectPinToNet',
+    'schematic.connectPinsByNet',
+    'schematic.validateNetlist',
     'system.apiInventory',
     'system.inspectComponents',
     'api.call',
@@ -36,5 +41,6 @@ export const EasyedaApiMethodSchema = z.enum([
     'pcb.addZone',
     'pcb.deleteComponent',
     'pcb.modifyComponent',
+    'api.execute',
 ]);
 //# sourceMappingURL=types.js.map

package/dist/bridge/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,oBAAoB;IACpB,wBAAwB;IACxB,0BAA0B;IAC1B,wBAAwB;IACxB,0BAA0B;IAC1B,mBAAmB;IACnB,2BAA2B;IAC3B,2BAA2B;IAC3B,qBAAqB;IACrB,0BAA0B;IAC1B,UAAU;IACV,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,mBAAmB;IACnB,qBAAqB;IACrB,cAAc;IACd,cAAc;IACd,kBAAkB;IAClB,oBAAoB;IACpB,kBAAkB;IAClB,YAAY;IACZ,YAAY;IACZ,kBAAkB;IAClB,kBAAkB;IAClB,YAAY;IACZ,gBAAgB;IAChB,oBAAoB;IACpB,cAAc;IACd,YAAY;IACZ,aAAa;IACb,qBAAqB;IACrB,qBAAqB;CACtB,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,oBAAoB;IACpB,wBAAwB;IACxB,0BAA0B;IAC1B,wBAAwB;IACxB,0BAA0B;IAC1B,mBAAmB;IACnB,2BAA2B;IAC3B,2BAA2B;IAC3B,yBAAyB;IACzB,yBAAyB;IACzB,2BAA2B;IAC3B,4BAA4B;IAC5B,2BAA2B;IAC3B,qBAAqB;IACrB,0BAA0B;IAC1B,UAAU;IACV,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,mBAAmB;IACnB,qBAAqB;IACrB,cAAc;IACd,cAAc;IACd,kBAAkB;IAClB,oBAAoB;IACpB,kBAAkB;IAClB,YAAY;IACZ,YAAY;IACZ,kBAAkB;IAClB,kBAAkB;IAClB,YAAY;IACZ,gBAAgB;IAChB,oBAAoB;IACpB,cAAc;IACd,YAAY;IACZ,aAAa;IACb,qBAAqB;IACrB,qBAAqB;IACrB,aAAa;CACd,CAAC,CAAC"}

package/dist/catalog/errors.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Catalog-specific validation and lookup errors.
+ *
+ * Follows the same pattern as src/circuit/errors.ts and src/schemas/common.ts.
+ *
+ * @module
+ */
+export declare const CatalogErrorCode: {
+    readonly CATALOG_INVALID: "CATALOG_INVALID";
+    readonly CATALOG_SCHEMA_VERSION_MISMATCH: "CATALOG_SCHEMA_VERSION_MISMATCH";
+    readonly DEVICE_DUPLICATE_ID: "DEVICE_DUPLICATE_ID";
+    readonly DEVICE_MISSING_SYMBOL: "DEVICE_MISSING_SYMBOL";
+    readonly DEVICE_MISSING_FOOTPRINT: "DEVICE_MISSING_FOOTPRINT";
+    readonly DEVICE_MISSING_PIN_MAP: "DEVICE_MISSING_PIN_MAP";
+    readonly DEVICE_INCOMPATIBLE_PACKAGE: "DEVICE_INCOMPATIBLE_PACKAGE";
+    readonly DEVICE_MISSING_MPN: "DEVICE_MISSING_MPN";
+    readonly DEVICE_MISSING_ASSEMBLY_DATA: "DEVICE_MISSING_ASSEMBLY_DATA";
+    readonly DEVICE_DUPLICATE_SUPPLIER_ID: "DEVICE_DUPLICATE_SUPPLIER_ID";
+    readonly DEVICE_NOT_FOUND: "DEVICE_NOT_FOUND";
+    readonly DEVICE_RESOLUTION_FAILED: "DEVICE_RESOLUTION_FAILED";
+};
+export type CatalogErrorCode = (typeof CatalogErrorCode)[keyof typeof CatalogErrorCode];
+export interface CatalogValidationError {
+    code: CatalogErrorCode;
+    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 CatalogError extends Error {
+    readonly code: CatalogErrorCode;
+    readonly errors: CatalogValidationError[];
+    readonly retryable: boolean;
+    constructor(opts: {
+        code: CatalogErrorCode;
+        message: string;
+        errors?: CatalogValidationError[];
+        retryable?: boolean;
+    });
+}
+/**
+ * Create a single validation error.
+ */
+export declare function catalogValidationError(code: CatalogErrorCode, message: string, details?: Record<string, unknown>): CatalogValidationError;
+/**
+ * Build a list of CatalogValidationErrors from a Zod error.
+ */
+export declare function fromZodError(zodError: import('zod').ZodError, prefix?: string): CatalogValidationError[];

package/dist/catalog/errors.js

@@ -0,0 +1,60 @@
+/**
+ * Catalog-specific validation and lookup errors.
+ *
+ * Follows the same pattern as src/circuit/errors.ts and src/schemas/common.ts.
+ *
+ * @module
+ */
+// ── Error codes ───────────────────────────────────────────────────────────
+export const CatalogErrorCode = {
+    // Schema validation
+    CATALOG_INVALID: 'CATALOG_INVALID',
+    CATALOG_SCHEMA_VERSION_MISMATCH: 'CATALOG_SCHEMA_VERSION_MISMATCH',
+    // Device validation
+    DEVICE_DUPLICATE_ID: 'DEVICE_DUPLICATE_ID',
+    DEVICE_MISSING_SYMBOL: 'DEVICE_MISSING_SYMBOL',
+    DEVICE_MISSING_FOOTPRINT: 'DEVICE_MISSING_FOOTPRINT',
+    DEVICE_MISSING_PIN_MAP: 'DEVICE_MISSING_PIN_MAP',
+    DEVICE_INCOMPATIBLE_PACKAGE: 'DEVICE_INCOMPATIBLE_PACKAGE',
+    DEVICE_MISSING_MPN: 'DEVICE_MISSING_MPN',
+    DEVICE_MISSING_ASSEMBLY_DATA: 'DEVICE_MISSING_ASSEMBLY_DATA',
+    DEVICE_DUPLICATE_SUPPLIER_ID: 'DEVICE_DUPLICATE_SUPPLIER_ID',
+    // Lookup
+    DEVICE_NOT_FOUND: 'DEVICE_NOT_FOUND',
+    DEVICE_RESOLUTION_FAILED: 'DEVICE_RESOLUTION_FAILED',
+};
+export class CatalogError extends Error {
+    code;
+    errors;
+    retryable;
+    constructor(opts) {
+        super(opts.message);
+        this.name = 'CatalogError';
+        this.code = opts.code;
+        this.errors = opts.errors ?? [];
+        this.retryable = opts.retryable ?? false;
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────────────
+/**
+ * Create a single validation error.
+ */
+export function catalogValidationError(code, message, details) {
+    return { code, message, details };
+}
+/**
+ * Build a list of CatalogValidationErrors from a Zod error.
+ */
+export function fromZodError(zodError, prefix) {
+    return zodError.issues.map((issue) => ({
+        code: 'CATALOG_INVALID',
+        message: issue.message,
+        path: prefix ? `${prefix}.${issue.path.join('.')}` : issue.path.join('.'),
+        details: {
+            code: issue.code,
+            expected: issue.message,
+            received: issue.received,
+        },
+    }));
+}
+//# sourceMappingURL=errors.js.map

package/dist/catalog/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/catalog/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6EAA6E;AAE7E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,oBAAoB;IACpB,eAAe,EAAE,iBAAiB;IAClC,+BAA+B,EAAE,iCAAiC;IAElE,oBAAoB;IACpB,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,wBAAwB,EAAE,0BAA0B;IACpD,sBAAsB,EAAE,wBAAwB;IAChD,2BAA2B,EAAE,6BAA6B;IAC1D,kBAAkB,EAAE,oBAAoB;IACxC,4BAA4B,EAAE,8BAA8B;IAC5D,4BAA4B,EAAE,8BAA8B;IAE5D,SAAS;IACT,gBAAgB,EAAE,kBAAkB;IACpC,wBAAwB,EAAE,0BAA0B;CAC5C,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,sBAAsB,CACpC,IAAsB,EACtB,OAAe,EACf,OAAiC;IAEjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAgC,EAChC,MAAe;IAEf,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,EAAE,iBAAqC;QAC3C,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"}

package/dist/catalog/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Device Catalog module — verified device library with schema, validation,
+ * and starter entries for EasyEDA Pro project design.
+ *
+ * Public API surface for the device catalog subsystem.
+ *
+ * @module
+ */
+export { CatalogError, CatalogErrorCode, catalogValidationError, fromZodError } from './errors.js';
+export type { CatalogErrorCode as CatalogErrorCodeType, CatalogValidationError } from './errors.js';
+export { DEVICE_CATALOG_SCHEMA_VERSION, DeviceCatalogSchema, DeviceEntrySchema, LifecycleStatusSchema, AssemblyHintSchema, ElectricalParamSchema, PinMappingSchema, SupplierIdSchema, Model3DRefSchema, validateDeviceCatalog, validateDeviceEntry, isDeviceCatalog, isDeviceEntry, } from './schema.js';
+export type { DeviceCatalog, DeviceEntry, LifecycleStatus, AssemblyHint, ElectricalParam, PinMapping, SupplierId, Model3DRef, } from './schema.js';
+export { validateCatalog, validateCatalogOrThrow, validateDeviceEntry as validateSingleEntry, } from './validation.js';
+export type { CatalogValidationResult } from './validation.js';
+export { STARTER_DEVICE_CATALOG } from './starter.js';

package/dist/catalog/index.js

@@ -0,0 +1,17 @@
+/**
+ * Device Catalog module — verified device library with schema, validation,
+ * and starter entries for EasyEDA Pro project design.
+ *
+ * Public API surface for the device catalog subsystem.
+ *
+ * @module
+ */
+// Errors
+export { CatalogError, CatalogErrorCode, catalogValidationError, fromZodError } from './errors.js';
+// Schema
+export { DEVICE_CATALOG_SCHEMA_VERSION, DeviceCatalogSchema, DeviceEntrySchema, LifecycleStatusSchema, AssemblyHintSchema, ElectricalParamSchema, PinMappingSchema, SupplierIdSchema, Model3DRefSchema, validateDeviceCatalog, validateDeviceEntry, isDeviceCatalog, isDeviceEntry, } from './schema.js';
+// Validation
+export { validateCatalog, validateCatalogOrThrow, validateDeviceEntry as validateSingleEntry, } from './validation.js';
+// Starter catalog
+export { STARTER_DEVICE_CATALOG } from './starter.js';
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGnG,SAAS;AACT,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AAYrB,aAAa;AACb,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,mBAAmB,IAAI,mBAAmB,GAC3C,MAAM,iBAAiB,CAAC;AAGzB,kBAAkB;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/catalog/schema.d.ts

@@ -0,0 +1,268 @@
+/**
+ * DeviceCatalog — versioned, validated device catalog schema.
+ *
+ * A DeviceCatalog is a curated library of verified device definitions used
+ * in EasyEDA Pro projects. Each entry is a "known-good" device with stable
+ * catalog IDs, pre-validated symbol/footprint/3D-model references, pin
+ * mapping, electrical parameters, lifecycle and assembly hints, and cross-
+ * references to supplier databases (LCSC, JLCPCB, Mouser, DigiKey).
+ *
+ * The catalog is designed to be:
+ * 1. **Versioned** — schema version string for forward compatibility.
+ * 2. **Validated** — cross-field refs are checked at parse time.
+ * 3. **Extensible** — new device classes and suppliers can be added.
+ * 4. **Reusable** — CircuitIR devices can be resolved from the catalog.
+ *
+ * @schema device-catalog/v1
+ */
+import { z } from 'zod';
+export declare const DEVICE_CATALOG_SCHEMA_VERSION = "device-catalog/v1";
+/**
+ * Lifecycle status of a device.
+ */
+export declare const LifecycleStatusSchema: z.ZodEnum<{
+    deprecated: "deprecated";
+    obsolete: "obsolete";
+    active: "active";
+    new: "new";
+    "not-recommended": "not-recommended";
+}>;
+export type LifecycleStatus = z.infer<typeof LifecycleStatusSchema>;
+/**
+ * Assembly availability hint.
+ */
+export declare const AssemblyHintSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        unknown: "unknown";
+        "in-production": "in-production";
+        limited: "limited";
+        "end-of-life": "end-of-life";
+        "contact-factory": "contact-factory";
+    }>;
+    moq: z.ZodOptional<z.ZodNumber>;
+    leadTimeWeeks: z.ZodOptional<z.ZodNumber>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AssemblyHint = z.infer<typeof AssemblyHintSchema>;
+/**
+ * Electrical parameter entry (key-value with optional unit).
+ */
+export declare const ElectricalParamSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodString;
+    unit: z.ZodOptional<z.ZodString>;
+    min: z.ZodOptional<z.ZodString>;
+    max: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ElectricalParam = z.infer<typeof ElectricalParamSchema>;
+/**
+ * Pin mapping entry.
+ */
+export declare const PinMappingSchema: z.ZodObject<{
+    pin: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<{
+        output: "output";
+        input: "input";
+        power: "power";
+        ground: "ground";
+        analog: "analog";
+        bidirectional: "bidirectional";
+        "open-drain": "open-drain";
+        "pass-through": "pass-through";
+        "no-connect": "no-connect";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PinMapping = z.infer<typeof PinMappingSchema>;
+/**
+ * Supplier ID cross-reference.
+ */
+export declare const SupplierIdSchema: z.ZodObject<{
+    supplier: z.ZodString;
+    partId: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SupplierId = z.infer<typeof SupplierIdSchema>;
+/**
+ * 3D model reference — either a URL/path or an explicit missing marker.
+ */
+export declare const Model3DRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"__missing__">, z.ZodLiteral<"">]>;
+export type Model3DRef = z.infer<typeof Model3DRefSchema>;
+/**
+ * Single device entry in the catalog.
+ */
+export declare const DeviceEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    displayName: z.ZodString;
+    category: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    subCategory: z.ZodOptional<z.ZodString>;
+    symbolRef: z.ZodString;
+    footprintRef: z.ZodString;
+    model3dRef: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"__missing__">, z.ZodLiteral<"">]>>;
+    manufacturer: z.ZodString;
+    mpn: z.ZodString;
+    lcsc: z.ZodOptional<z.ZodString>;
+    jlcpcb: z.ZodOptional<z.ZodString>;
+    supplierIds: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        supplier: z.ZodString;
+        partId: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    package: z.ZodString;
+    standardPackage: z.ZodOptional<z.ZodString>;
+    pinMapping: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        pin: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            output: "output";
+            input: "input";
+            power: "power";
+            ground: "ground";
+            analog: "analog";
+            bidirectional: "bidirectional";
+            "open-drain": "open-drain";
+            "pass-through": "pass-through";
+            "no-connect": "no-connect";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    electricalParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+        unit: z.ZodOptional<z.ZodString>;
+        min: z.ZodOptional<z.ZodString>;
+        max: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    lifecycleStatus: z.ZodDefault<z.ZodEnum<{
+        deprecated: "deprecated";
+        obsolete: "obsolete";
+        active: "active";
+        new: "new";
+        "not-recommended": "not-recommended";
+    }>>;
+    assemblyHint: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            "in-production": "in-production";
+            limited: "limited";
+            "end-of-life": "end-of-life";
+            "contact-factory": "contact-factory";
+        }>;
+        moq: z.ZodOptional<z.ZodNumber>;
+        leadTimeWeeks: z.ZodOptional<z.ZodNumber>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    datasheetUrl: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    productPageUrl: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    metadata: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DeviceEntry = z.infer<typeof DeviceEntrySchema>;
+export declare const DeviceCatalogSchema: z.ZodObject<{
+    $schema: z.ZodDefault<z.ZodLiteral<"device-catalog/v1">>;
+    devices: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        category: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        subCategory: z.ZodOptional<z.ZodString>;
+        symbolRef: z.ZodString;
+        footprintRef: z.ZodString;
+        model3dRef: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"__missing__">, z.ZodLiteral<"">]>>;
+        manufacturer: z.ZodString;
+        mpn: z.ZodString;
+        lcsc: z.ZodOptional<z.ZodString>;
+        jlcpcb: z.ZodOptional<z.ZodString>;
+        supplierIds: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            supplier: z.ZodString;
+            partId: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        package: z.ZodString;
+        standardPackage: z.ZodOptional<z.ZodString>;
+        pinMapping: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            pin: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                output: "output";
+                input: "input";
+                power: "power";
+                ground: "ground";
+                analog: "analog";
+                bidirectional: "bidirectional";
+                "open-drain": "open-drain";
+                "pass-through": "pass-through";
+                "no-connect": "no-connect";
+            }>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        electricalParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            unit: z.ZodOptional<z.ZodString>;
+            min: z.ZodOptional<z.ZodString>;
+            max: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        lifecycleStatus: z.ZodDefault<z.ZodEnum<{
+            deprecated: "deprecated";
+            obsolete: "obsolete";
+            active: "active";
+            new: "new";
+            "not-recommended": "not-recommended";
+        }>>;
+        assemblyHint: z.ZodOptional<z.ZodObject<{
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                "in-production": "in-production";
+                limited: "limited";
+                "end-of-life": "end-of-life";
+                "contact-factory": "contact-factory";
+            }>;
+            moq: z.ZodOptional<z.ZodNumber>;
+            leadTimeWeeks: z.ZodOptional<z.ZodNumber>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        datasheetUrl: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+        productPageUrl: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+        metadata: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        version: z.ZodDefault<z.ZodLiteral<"1.0.0">>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        deviceCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type DeviceCatalog = z.infer<typeof DeviceCatalogSchema>;
+/**
+ * Parse and validate an unknown input as a DeviceCatalog.
+ *
+ * Returns the validated DeviceCatalog on success.
+ * Throws `CatalogError` with structured errors on failure.
+ */
+export declare function validateDeviceCatalog(input: unknown): DeviceCatalog;
+/**
+ * Parse and validate an unknown input as a single DeviceEntry.
+ *
+ * Returns the validated DeviceEntry on success.
+ * Throws `CatalogError` with structured errors on failure.
+ */
+export declare function validateDeviceEntry(input: unknown): DeviceEntry;
+/**
+ * Type guard: check whether an unknown value is a valid DeviceCatalog.
+ */
+export declare function isDeviceCatalog(value: unknown): value is DeviceCatalog;
+/**
+ * Type guard: check whether an unknown value is a valid DeviceEntry.
+ */
+export declare function isDeviceEntry(value: unknown): value is DeviceEntry;