/**
 * 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";
/**
 * Prefix used for a `symbolRef`/`footprintRef` value when a device was
 * ingested but the reference could not be resolved to a real EasyEDA
 * library entry (e.g. `LIB_Device.getByLcscIds` found no match). Kept
 * non-empty so it still satisfies `DeviceEntrySchema`'s `.min(1)`
 * constraint, but flagged as invalid by `validateCatalog`/`validateDeviceEntry`
 * for any category that requires a real symbol/footprint — see
 * `src/catalog/validation.ts`.
 */
export declare const UNRESOLVED_REF_PREFIX = "UNRESOLVED:";
/**
 * 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";
        bidirectional: "bidirectional";
        analog: "analog";
        "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";
            bidirectional: "bidirectional";
            analog: "analog";
            "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";
                bidirectional: "bidirectional";
                analog: "analog";
                "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;