easyeda-mcp-pro 0.4.0 → 0.5.2

package/dist/catalog/schema.js

@@ -0,0 +1,245 @@
+/**
+ * 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';
+import { CatalogError, CatalogErrorCode, fromZodError } from './errors.js';
+// ── Schema version ────────────────────────────────────────────────────────
+export const DEVICE_CATALOG_SCHEMA_VERSION = 'device-catalog/v1';
+// ── Sub-schemas ───────────────────────────────────────────────────────────
+/**
+ * Lifecycle status of a device.
+ */
+export const LifecycleStatusSchema = z.enum([
+    'active',
+    'deprecated',
+    'obsolete',
+    'new',
+    'not-recommended',
+]);
+/**
+ * Assembly availability hint.
+ */
+export const AssemblyHintSchema = z.object({
+    /** Typical stock availability: 'in-production', 'limited', 'end-of-life', 'contact-factory' */
+    status: z.enum(['in-production', 'limited', 'end-of-life', 'contact-factory', 'unknown']),
+    /** Minimum order quantity (if applicable) */
+    moq: z.number().int().positive().optional(),
+    /** Lead time estimate (weeks) */
+    leadTimeWeeks: z.number().int().nonnegative().optional(),
+    /** Notes about assembly availability */
+    notes: z.string().max(256).optional(),
+});
+/**
+ * Electrical parameter entry (key-value with optional unit).
+ */
+export const ElectricalParamSchema = z.object({
+    name: z.string().min(1).max(64),
+    value: z.string().min(1).max(128),
+    unit: z.string().max(32).optional(),
+    min: z.string().max(64).optional(),
+    max: z.string().max(64).optional(),
+});
+/**
+ * Pin mapping entry.
+ */
+export const PinMappingSchema = z.object({
+    pin: z.string().min(1).max(32),
+    name: z.string().min(1).max(128),
+    type: z
+        .enum([
+        'power',
+        'ground',
+        'input',
+        'output',
+        'bidirectional',
+        'analog',
+        'open-drain',
+        'pass-through',
+        'no-connect',
+    ])
+        .optional(),
+    description: z.string().max(256).optional(),
+});
+/**
+ * Supplier ID cross-reference.
+ */
+export const SupplierIdSchema = z.object({
+    /** Supplier name: 'lcsc', 'jlcpcb', 'mouser', 'digikey', 'farnell', etc. */
+    supplier: z.string().min(1).max(32),
+    /** Part ID at the supplier. */
+    partId: z.string().min(1).max(64),
+    /** Optional direct URL to the product page. */
+    url: z.string().url().optional(),
+});
+/**
+ * 3D model reference — either a URL/path or an explicit missing marker.
+ */
+export const Model3DRefSchema = z.union([
+    z.string().url(),
+    z.literal('__missing__'),
+    z.literal(''),
+]);
+/**
+ * Single device entry in the catalog.
+ */
+export const DeviceEntrySchema = z
+    .object({
+    /** Stable, unique device catalog ID (e.g. "device-esp32-s3-mini-1"). */
+    id: z.string().min(1).max(128),
+    /** Human-readable display name. */
+    displayName: z.string().min(1).max(256),
+    /** Functional category / block type the device belongs to. */
+    category: z.string().min(1).max(64),
+    /** Description of the device's role. */
+    description: z.string().max(2048).optional(),
+    /**
+     * Sub-category for finer classification
+     * (e.g. "mcu", "sensor-temperature", "ldo", "connector-usb").
+     */
+    subCategory: z.string().max(64).optional(),
+    // ── EasyEDA references ──────────────────────────────────────────────
+    /** EasyEDA symbol library reference (e.g. "SYM:ESP32-S3-MINI-1"). */
+    symbolRef: z.string().min(1).max(256),
+    /** EasyEDA footprint library reference (e.g. "FOOT:ESP32-S3-MINI-1"). */
+    footprintRef: z.string().min(1).max(256),
+    /** EasyEDA 3D model reference — URL/path or explicit missing marker. */
+    model3dRef: Model3DRefSchema.default('__missing__'),
+    // ── Manufacturer info ───────────────────────────────────────────────
+    manufacturer: z.string().min(1).max(256),
+    mpn: z.string().min(1).max(128),
+    /** LCSC part number (e.g. "C123456"). */
+    lcsc: z.string().max(32).optional(),
+    /** JLCPCB part number if different from LCSC. */
+    jlcpcb: z.string().max(32).optional(),
+    /** Additional supplier cross-references. */
+    supplierIds: z.array(SupplierIdSchema).default([]),
+    // ── Package ─────────────────────────────────────────────────────────
+    /** Package type description (e.g. "QFN-28_4x4mm_P0.4mm"). */
+    package: z.string().min(1).max(128),
+    /** Standard IPC/JEDEC package name if applicable. */
+    standardPackage: z.string().max(64).optional(),
+    // ── Pin mapping ─────────────────────────────────────────────────────
+    /** Pin mapping, required for ICs and connectors, optional for passives. */
+    pinMapping: z.array(PinMappingSchema).default([]),
+    // ── Electrical parameters ───────────────────────────────────────────
+    /** Key electrical parameters. */
+    electricalParams: z.array(ElectricalParamSchema).default([]),
+    // ── Lifecycle and assembly ──────────────────────────────────────────
+    lifecycleStatus: LifecycleStatusSchema.default('active'),
+    assemblyHint: AssemblyHintSchema.optional(),
+    // ── Documentation ───────────────────────────────────────────────────
+    /** URL to the device datasheet. */
+    datasheetUrl: z.string().url().optional().or(z.literal('')),
+    /** URL to the manufacturer product page. */
+    productPageUrl: z.string().url().optional().or(z.literal('')),
+    // ── Metadata ────────────────────────────────────────────────────────
+    /** Arbitrary key-value metadata. */
+    metadata: z.array(z.object({ key: z.string(), value: z.string() })).default([]),
+    /** Notes free-text. */
+    notes: z.string().max(4096).optional(),
+})
+    .strict();
+// ── Full catalog schema ───────────────────────────────────────────────────
+export const DeviceCatalogSchema = z
+    .object({
+    $schema: z.literal(DEVICE_CATALOG_SCHEMA_VERSION).default(DEVICE_CATALOG_SCHEMA_VERSION),
+    /** List of device entries. */
+    devices: z.array(DeviceEntrySchema).default([]),
+    metadata: z
+        .object({
+        version: z.literal('1.0.0').default('1.0.0'),
+        name: z.string().max(256).optional(),
+        description: z.string().max(2048).optional(),
+        updatedAt: z.string().datetime().optional(),
+        deviceCount: z.number().int().nonnegative().optional(),
+    })
+        .optional(),
+})
+    .strict()
+    .refine((data) => {
+    // Check for duplicate device IDs
+    const ids = new Set();
+    for (const dev of data.devices) {
+        if (ids.has(dev.id))
+            return false;
+        ids.add(dev.id);
+    }
+    return true;
+}, { message: 'Duplicate device IDs are not allowed', path: ['devices'] })
+    .refine((data) => {
+    // Check for duplicate supplier IDs per device
+    for (const dev of data.devices) {
+        const seen = new Set();
+        for (const sid of dev.supplierIds) {
+            const key = `${sid.supplier}:${sid.partId}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+        }
+    }
+    return true;
+}, { message: 'Duplicate supplier IDs within a single device are not allowed', path: ['devices'] });
+// ── Validation helpers ─────────────────────────────────────────────────────
+/**
+ * Parse and validate an unknown input as a DeviceCatalog.
+ *
+ * Returns the validated DeviceCatalog on success.
+ * Throws `CatalogError` with structured errors on failure.
+ */
+export function validateDeviceCatalog(input) {
+    const result = DeviceCatalogSchema.safeParse(input);
+    if (!result.success) {
+        const errors = fromZodError(result.error, 'catalog');
+        throw new CatalogError({
+            code: CatalogErrorCode.CATALOG_INVALID,
+            message: 'Device catalog validation failed',
+            errors,
+        });
+    }
+    return result.data;
+}
+/**
+ * Parse and validate an unknown input as a single DeviceEntry.
+ *
+ * Returns the validated DeviceEntry on success.
+ * Throws `CatalogError` with structured errors on failure.
+ */
+export function validateDeviceEntry(input) {
+    const result = DeviceEntrySchema.safeParse(input);
+    if (!result.success) {
+        const errors = fromZodError(result.error, 'device');
+        throw new CatalogError({
+            code: CatalogErrorCode.CATALOG_INVALID,
+            message: 'Device entry validation failed',
+            errors,
+        });
+    }
+    return result.data;
+}
+/**
+ * Type guard: check whether an unknown value is a valid DeviceCatalog.
+ */
+export function isDeviceCatalog(value) {
+    return DeviceCatalogSchema.safeParse(value).success;
+}
+/**
+ * Type guard: check whether an unknown value is a valid DeviceEntry.
+ */
+export function isDeviceEntry(value) {
+    return DeviceEntrySchema.safeParse(value).success;
+}
+//# sourceMappingURL=schema.js.map

package/dist/catalog/schema.js.map

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

package/dist/catalog/starter.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Starter device catalog entries.
+ *
+ * Pre-populated device definitions covering common MCU, sensor, power,
+ * connector, and passive classes. These entries serve as the foundation
+ * for the verified device catalog, enabling CircuitIR resolution and
+ * design validation without requiring the user to define devices from
+ * scratch.
+ *
+ * Each entry follows the DeviceEntry schema with:
+ * - Stable catalog IDs (prefixed by device class)
+ * - Symbol, footprint, and 3D model references (or explicit missing markers)
+ * - Manufacturer, MPN, supplier cross-references where available
+ * - Package descriptions
+ * - Pin mappings for ICs and connectors
+ * - Electrical parameters where available
+ * - Lifecycle and assembly hints
+ * - Datasheet URLs
+ *
+ * @module
+ */
+/**
+ * Pre-populated device catalog with entries covering the most common
+ * MCU, sensor, power, connector, and passive classes used in typical
+ * EasyEDA Pro designs.
+ *
+ * To use: import `STARTER_DEVICE_CATALOG` and pass to `validateDeviceCatalog()`
+ * before use. Individual entries can be added/removed as needed.
+ *
+ * @example
+ * ```typescript
+ * import { STARTER_DEVICE_CATALOG } from './starter.js';
+ * import { validateDeviceCatalog } from './schema.js';
+ *
+ * const catalog = validateDeviceCatalog({
+ *   $schema: DEVICE_CATALOG_SCHEMA_VERSION,
+ *   devices: STARTER_DEVICE_CATALOG,
+ *   metadata: { version: '1.0.0', name: 'My Catalog' },
+ * });
+ * ```
+ */
+export declare const STARTER_DEVICE_CATALOG: ({
+    id: string;
+    displayName: string;
+    category: string;
+    subCategory: string;
+    description: string;
+    symbolRef: string;
+    footprintRef: string;
+    model3dRef: string;
+    manufacturer: string;
+    mpn: string;
+    package: string;
+    standardPackage: string;
+    pinMapping: {
+        pin: string;
+        name: string;
+        type: string;
+        description: string;
+    }[];
+    electricalParams: ({
+        name: string;
+        value: string;
+        unit: string;
+        min: string;
+        max: string;
+    } | {
+        name: string;
+        value: string;
+        unit: string;
+        max: string;
+        min?: undefined;
+    } | {
+        name: string;
+        value: string;
+        unit: string;
+        min?: undefined;
+        max?: undefined;
+    })[];
+    lifecycleStatus: string;
+    assemblyHint: {
+        status: string;
+        moq: number;
+        leadTimeWeeks: number;
+        notes: string;
+    };
+    datasheetUrl: string;
+} | {
+    id: string;
+    displayName: string;
+    category: string;
+    subCategory: string;
+    description: string;
+    symbolRef: string;
+    footprintRef: string;
+    model3dRef: string;
+    manufacturer: string;
+    mpn: string;
+    lcsc: string;
+    package: string;
+    standardPackage: string;
+    pinMapping: {
+        pin: string;
+        name: string;
+        type: string;
+        description: string;
+    }[];
+    electricalParams: {
+        name: string;
+        value: string;
+        unit: string;
+    }[];
+    lifecycleStatus: string;
+    assemblyHint: {
+        status: string;
+        moq: number;
+        leadTimeWeeks: number;
+        notes: string;
+    };
+    datasheetUrl: string;
+} | {
+    id: string;
+    displayName: string;
+    category: string;
+    subCategory: string;
+    description: string;
+    symbolRef: string;
+    footprintRef: string;
+    model3dRef: string;
+    manufacturer: string;
+    mpn: string;
+    lcsc: string;
+    package: string;
+    standardPackage: string;
+    electricalParams: ({
+        name: string;
+        value: string;
+        unit: string;
+        min: string;
+        max: string;
+    } | {
+        name: string;
+        value: string;
+        unit: string;
+        min?: undefined;
+        max?: undefined;
+    } | {
+        name: string;
+        value: string;
+        unit?: undefined;
+        min?: undefined;
+        max?: undefined;
+    })[];
+    lifecycleStatus: string;
+    assemblyHint: {
+        status: string;
+        notes: string;
+    };
+})[];