easyeda-mcp-pro 0.4.0 → 0.5.2

package/dist/net-validation/errors.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Net validation — error codes, structured issues, and factories.
+ *
+ * Follows the same pattern as `CircuitError` / `CatalogError`:
+ * a const-object error code enum, a structured issue interface, and
+ * factory helpers.
+ *
+ * @module
+ */
+export declare const NetValidationCode: {
+    /** Net has zero node connections (floating). */
+    readonly NetFloating: "NET_FLOATING";
+    /** Two or more nets share the same name. */
+    readonly NetDuplicateName: "NET_DUPLICATE_NAME";
+    /** Two different nets connect to the same device pin. */
+    readonly NetAccidentalShort: "NET_ACCIDENTAL_SHORT";
+    /** No net with type=Power exists. */
+    readonly NetMissingPower: "NET_MISSING_POWER";
+    /** No net with type=Ground exists. */
+    readonly NetMissingGround: "NET_MISSING_GROUND";
+    /** A hierarchical port (Interface) has no matching net. */
+    readonly NetMissingHierarchicalPort: "NET_MISSING_HIERARCHICAL_PORT";
+    /** A required device pin has no net connection. */
+    readonly NetUnconnectedRequiredPin: "NET_UNCONNECTED_REQUIRED_PIN";
+    /** Cross-sheet interface pin references don't match. */
+    readonly NetInconsistentCrossSheet: "NET_INCONSISTENT_CROSS_SHEET";
+    /** Net name violates analog/digital rail naming conventions. */
+    readonly NetNamingConvention: "NET_NAMING_CONVENTION";
+    /** Net associated with AC/high-voltage lacks protective naming. */
+    readonly NetProtectedDomain: "NET_PROTECTED_DOMAIN";
+    /** Validation could not be completed due to an internal error. */
+    readonly NetValidationInternal: "NET_VALIDATION_INTERNAL";
+};
+export type NetValidationCode = (typeof NetValidationCode)[keyof typeof NetValidationCode];
+/**
+ * A single net validation issue (error or warning).
+ *
+ * Mirrors `CircuitValidationError`'s shape but adds fields specific
+ * to net/wire semantics: component ref, pin, net name, severity, and
+ * a human-readable remediation hint.
+ */
+export interface NetValidationIssue {
+    /** Machine-readable error code (e.g. "NET_FLOATING"). */
+    code: NetValidationCode;
+    /** Human-readable description of what is wrong. */
+    message: string;
+    /** Dot-notation path to the offending field (e.g. "nets[2]"). */
+    path?: string;
+    /** Whether this issue blocks validation (error) or is advisory (warning). */
+    severity: 'error' | 'warning';
+    /** Name of the offending net, if applicable. */
+    netName?: string;
+    /** Reference designator of the offending component, if applicable. */
+    componentRef?: string;
+    /** Pin number or name on the component, if applicable. */
+    pin?: string;
+    /** Actionable hint for the user on how to fix this issue. */
+    remediationHint: string;
+    /** Additional machine-readable context. */
+    details?: Record<string, unknown>;
+}
+export interface NetValidationResult {
+    /** True when there are zero errors (warnings are allowed). */
+    valid: boolean;
+    /** Issues that block validation (catalog / circuit is invalid). */
+    errors: NetValidationIssue[];
+    /** Issues that are advisory (catalog / circuit is valid but should be reviewed). */
+    warnings: NetValidationIssue[];
+}
+/**
+ * Create a single net validation issue.
+ */
+export declare function netValidationIssue(code: NetValidationCode, message: string, opts?: {
+    severity?: 'error' | 'warning';
+    path?: string;
+    netName?: string;
+    componentRef?: string;
+    pin?: string;
+    remediationHint?: string;
+    details?: Record<string, unknown>;
+}): NetValidationIssue;
+/**
+ * Convenience: create an error-severity issue.
+ */
+export declare function netError(code: NetValidationCode, message: string, opts?: Omit<Parameters<typeof netValidationIssue>[2], 'severity'>): NetValidationIssue;
+/**
+ * Convenience: create a warning-severity issue.
+ */
+export declare function netWarning(code: NetValidationCode, message: string, opts?: Omit<Parameters<typeof netValidationIssue>[2], 'severity'>): NetValidationIssue;

package/dist/net-validation/errors.js

@@ -0,0 +1,69 @@
+/**
+ * Net validation — error codes, structured issues, and factories.
+ *
+ * Follows the same pattern as `CircuitError` / `CatalogError`:
+ * a const-object error code enum, a structured issue interface, and
+ * factory helpers.
+ *
+ * @module
+ */
+// ── Error codes ───────────────────────────────────────────────────────────
+export const NetValidationCode = {
+    // ── Structural errors ────────────────────────────────────────────────
+    /** Net has zero node connections (floating). */
+    NetFloating: 'NET_FLOATING',
+    /** Two or more nets share the same name. */
+    NetDuplicateName: 'NET_DUPLICATE_NAME',
+    /** Two different nets connect to the same device pin. */
+    NetAccidentalShort: 'NET_ACCIDENTAL_SHORT',
+    // ── Missing topology ─────────────────────────────────────────────────
+    /** No net with type=Power exists. */
+    NetMissingPower: 'NET_MISSING_POWER',
+    /** No net with type=Ground exists. */
+    NetMissingGround: 'NET_MISSING_GROUND',
+    /** A hierarchical port (Interface) has no matching net. */
+    NetMissingHierarchicalPort: 'NET_MISSING_HIERARCHICAL_PORT',
+    /** A required device pin has no net connection. */
+    NetUnconnectedRequiredPin: 'NET_UNCONNECTED_REQUIRED_PIN',
+    // ── Cross-sheet consistency ──────────────────────────────────────────
+    /** Cross-sheet interface pin references don't match. */
+    NetInconsistentCrossSheet: 'NET_INCONSISTENT_CROSS_SHEET',
+    // ── Naming conventions ───────────────────────────────────────────────
+    /** Net name violates analog/digital rail naming conventions. */
+    NetNamingConvention: 'NET_NAMING_CONVENTION',
+    /** Net associated with AC/high-voltage lacks protective naming. */
+    NetProtectedDomain: 'NET_PROTECTED_DOMAIN',
+    // ── General ──────────────────────────────────────────────────────────
+    /** Validation could not be completed due to an internal error. */
+    NetValidationInternal: 'NET_VALIDATION_INTERNAL',
+};
+// ── Factory ───────────────────────────────────────────────────────────────
+/**
+ * Create a single net validation issue.
+ */
+export function netValidationIssue(code, message, opts) {
+    return {
+        code,
+        message,
+        severity: opts?.severity ?? 'error',
+        path: opts?.path,
+        netName: opts?.netName,
+        componentRef: opts?.componentRef,
+        pin: opts?.pin,
+        remediationHint: opts?.remediationHint ?? '',
+        details: opts?.details,
+    };
+}
+/**
+ * Convenience: create an error-severity issue.
+ */
+export function netError(code, message, opts) {
+    return netValidationIssue(code, message, { ...opts, severity: 'error' });
+}
+/**
+ * Convenience: create a warning-severity issue.
+ */
+export function netWarning(code, message, opts) {
+    return netValidationIssue(code, message, { ...opts, severity: 'warning' });
+}
+//# sourceMappingURL=errors.js.map

package/dist/net-validation/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/net-validation/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6EAA6E;AAE7E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,wEAAwE;IAExE,gDAAgD;IAChD,WAAW,EAAE,cAAc;IAC3B,4CAA4C;IAC5C,gBAAgB,EAAE,oBAAoB;IACtC,yDAAyD;IACzD,kBAAkB,EAAE,sBAAsB;IAE1C,wEAAwE;IAExE,qCAAqC;IACrC,eAAe,EAAE,mBAAmB;IACpC,sCAAsC;IACtC,gBAAgB,EAAE,oBAAoB;IACtC,2DAA2D;IAC3D,0BAA0B,EAAE,+BAA+B;IAC3D,mDAAmD;IACnD,yBAAyB,EAAE,8BAA8B;IAEzD,wEAAwE;IAExE,wDAAwD;IACxD,yBAAyB,EAAE,8BAA8B;IAEzD,wEAAwE;IAExE,gEAAgE;IAChE,mBAAmB,EAAE,uBAAuB;IAC5C,mEAAmE;IACnE,kBAAkB,EAAE,sBAAsB;IAE1C,wEAAwE;IAExE,kEAAkE;IAClE,qBAAqB,EAAE,yBAAyB;CACxC,CAAC;AA+CX,6EAA6E;AAE7E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAuB,EACvB,OAAe,EACf,IAQC;IAED,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,OAAO;QACnC,IAAI,EAAE,IAAI,EAAE,IAAI;QAChB,OAAO,EAAE,IAAI,EAAE,OAAO;QACtB,YAAY,EAAE,IAAI,EAAE,YAAY;QAChC,GAAG,EAAE,IAAI,EAAE,GAAG;QACd,eAAe,EAAE,IAAI,EAAE,eAAe,IAAI,EAAE;QAC5C,OAAO,EAAE,IAAI,EAAE,OAAO;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAuB,EACvB,OAAe,EACf,IAAiE;IAEjE,OAAO,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAuB,EACvB,OAAe,EACf,IAAiE;IAEjE,OAAO,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/net-validation/fixtures.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Net validation — sample fixture data for tests.
+ *
+ * @module
+ */
+import type { NetValidationEntry, DeviceValidationEntry, InterfaceValidationEntry, NetValidationInput } from './schema.js';
+export declare const VALID_NETS: NetValidationEntry[];
+export declare const VALID_DEVICES: DeviceValidationEntry[];
+export declare const VALID_INPUT: NetValidationInput;
+export declare const FLOATING_NET: NetValidationEntry[];
+export declare const FLOATING_INPUT: NetValidationInput;
+export declare const DUPLICATE_NAME_NETS: NetValidationEntry[];
+export declare const DUPLICATE_NAME_INPUT: NetValidationInput;
+export declare const SHORT_NETS: NetValidationEntry[];
+export declare const SHORT_INPUT: NetValidationInput;
+export declare const NO_POWER_NETS: NetValidationEntry[];
+export declare const NO_POWER_INPUT: NetValidationInput;
+export declare const NO_GROUND_NETS: NetValidationEntry[];
+export declare const NO_GROUND_INPUT: NetValidationInput;
+export declare const MISSING_PORT_INTERFACES: InterfaceValidationEntry[];
+export declare const MISSING_PORT_NETS: NetValidationEntry[];
+export declare const MISSING_PORT_INPUT: NetValidationInput;
+/** Nets that avoid U1 so U1 appears unconnected. */
+export declare const UNCONNECTED_DEVICE_NETS: NetValidationEntry[];
+export declare const UNCONNECTED_DEVICES: DeviceValidationEntry[];
+export declare const UNCONNECTED_DEVICE_INPUT: NetValidationInput;
+export declare const CROSS_SHEET_INTERFACES: InterfaceValidationEntry[];
+export declare const MISMATCHED_CROSS_SHEET_INTERFACES: InterfaceValidationEntry[];
+export declare const CROSS_SHEET_INPUT: NetValidationInput;
+export declare const MISMATCHED_CROSS_SHEET_INPUT: NetValidationInput;
+export declare const BAD_POWER_NAME_NETS: NetValidationEntry[];
+export declare const BAD_POWER_NAME_INPUT: NetValidationInput;
+export declare const BAD_GROUND_NAME_NETS: NetValidationEntry[];
+export declare const BAD_GROUND_NAME_INPUT: NetValidationInput;
+export declare const HV_GENERIC_NAME_NETS: NetValidationEntry[];
+export declare const HV_GENERIC_NAME_INPUT: NetValidationInput;
+export declare const HV_MIXED_DOMAIN_NETS: NetValidationEntry[];
+export declare const HV_MIXED_DOMAIN_INPUT: NetValidationInput;

package/dist/net-validation/fixtures.js

@@ -0,0 +1,215 @@
+/**
+ * Net validation — sample fixture data for tests.
+ *
+ * @module
+ */
+// ── Valid design ───────────────────────────────────────────────────────────
+export const VALID_NETS = [
+    {
+        id: 'net-1',
+        name: '3V3',
+        type: 'power',
+        nodes: [
+            { deviceRef: 'U1', pin: '1' },
+            { deviceRef: 'R1', pin: '1' },
+        ],
+    },
+    {
+        id: 'net-2',
+        name: 'GND',
+        type: 'ground',
+        nodes: [
+            { deviceRef: 'U1', pin: '2' },
+            { deviceRef: 'R1', pin: '2' },
+            { deviceRef: 'C1', pin: '2' },
+        ],
+    },
+    {
+        id: 'net-3',
+        name: 'I2C_SCL',
+        type: 'signal',
+        nodes: [
+            { deviceRef: 'U1', pin: '3' },
+            { deviceRef: 'U2', pin: '1' },
+        ],
+    },
+    {
+        id: 'net-4',
+        name: 'I2C_SDA',
+        type: 'signal',
+        nodes: [
+            { deviceRef: 'U1', pin: '4' },
+            { deviceRef: 'U2', pin: '2' },
+        ],
+    },
+    {
+        id: 'net-5',
+        name: 'nRST',
+        type: 'signal',
+        nodes: [
+            { deviceRef: 'U1', pin: '5' },
+            { deviceRef: 'U2', pin: '3' },
+        ],
+    },
+    { id: 'net-6', name: 'CLK_32K', type: 'signal', nodes: [{ deviceRef: 'U1', pin: '6' }] },
+];
+export const VALID_DEVICES = [
+    { id: 'U1', ref: 'U1', category: 'microcontroller' },
+    { id: 'U2', ref: 'U2', category: 'sensor' },
+    { id: 'R1', ref: 'R1', category: 'passive' },
+    { id: 'C1', ref: 'C1', category: 'passive' },
+];
+export const VALID_INPUT = {
+    nets: VALID_NETS,
+    devices: VALID_DEVICES,
+};
+// ── Floating net ───────────────────────────────────────────────────────────
+export const FLOATING_NET = [
+    { id: 'n1', name: '3V3', type: 'power', nodes: [{ deviceRef: 'U1', pin: '1' }] },
+    { id: 'n2', name: 'FLOAT', type: 'signal', nodes: [] }, // ← floating
+    { id: 'n3', name: 'GND', type: 'ground', nodes: [{ deviceRef: 'U1', pin: '2' }] },
+];
+export const FLOATING_INPUT = {
+    nets: FLOATING_NET,
+};
+// ── Duplicate name ─────────────────────────────────────────────────────────
+export const DUPLICATE_NAME_NETS = [
+    { id: 'n1', name: '3V3', type: 'power', nodes: [{ deviceRef: 'U1', pin: '1' }] },
+    { id: 'n2', name: '3V3', type: 'power', nodes: [{ deviceRef: 'U2', pin: '1' }] }, // ← duplicate
+    { id: 'n3', name: 'GND', type: 'ground', nodes: [{ deviceRef: 'U1', pin: '2' }] },
+];
+export const DUPLICATE_NAME_INPUT = {
+    nets: DUPLICATE_NAME_NETS,
+};
+// ── Accidental short ───────────────────────────────────────────────────────
+export const SHORT_NETS = [
+    { id: 'n1', name: 'NET_A', type: 'signal', nodes: [{ deviceRef: 'U1', pin: '1' }] },
+    { id: 'n2', name: 'NET_B', type: 'signal', nodes: [{ deviceRef: 'U1', pin: '1' }] }, // ← same pin!
+    { id: 'n3', name: 'GND', type: 'ground', nodes: [{ deviceRef: 'U1', pin: '2' }] },
+];
+export const SHORT_INPUT = {
+    nets: SHORT_NETS,
+};
+// ── Missing power / ground ─────────────────────────────────────────────────
+export const NO_POWER_NETS = [
+    { id: 'n1', name: 'SIG', type: 'signal', nodes: [{ deviceRef: 'U1', pin: '1' }] },
+    { id: 'n2', name: 'GND', type: 'ground', nodes: [{ deviceRef: 'U1', pin: '2' }] },
+];
+export const NO_POWER_INPUT = { nets: NO_POWER_NETS };
+export const NO_GROUND_NETS = [
+    { id: 'n1', name: '3V3', type: 'power', nodes: [{ deviceRef: 'U1', pin: '1' }] },
+    { id: 'n2', name: 'SIG', type: 'signal', nodes: [{ deviceRef: 'U1', pin: '3' }] },
+];
+export const NO_GROUND_INPUT = { nets: NO_GROUND_NETS };
+// ── Missing hierarchical port ──────────────────────────────────────────────
+export const MISSING_PORT_INTERFACES = [
+    {
+        id: 'intf-1',
+        name: 'EXTERNAL',
+        pinout: [
+            { pin: '1', signal: 'EXT_CLK' },
+            { pin: '2', signal: 'EXT_DATA' },
+        ],
+    },
+];
+export const MISSING_PORT_NETS = [
+    { id: 'n1', name: '3V3', type: 'power', nodes: [{ deviceRef: 'U1', pin: '1' }] },
+    { id: 'n2', name: 'GND', type: 'ground', nodes: [{ deviceRef: 'U1', pin: '2' }] },
+];
+export const MISSING_PORT_INPUT = {
+    nets: MISSING_PORT_NETS,
+    interfaces: MISSING_PORT_INTERFACES,
+};
+// ── Unconnected device ─────────────────────────────────────────────────────
+/** Nets that avoid U1 so U1 appears unconnected. */
+export const UNCONNECTED_DEVICE_NETS = [
+    { id: 'n1', name: '3V3', type: 'power', nodes: [{ deviceRef: 'U2', pin: '1' }] },
+    {
+        id: 'n2',
+        name: 'GND',
+        type: 'ground',
+        nodes: [
+            { deviceRef: 'U2', pin: '2' },
+            { deviceRef: 'R1', pin: '2' },
+        ],
+    },
+];
+export const UNCONNECTED_DEVICES = [
+    { id: 'R1', ref: 'R1', category: 'passive' },
+    { id: 'U1', ref: 'U1', category: 'microcontroller' }, // ← no pin connections
+];
+export const UNCONNECTED_DEVICE_INPUT = {
+    nets: UNCONNECTED_DEVICE_NETS,
+    devices: UNCONNECTED_DEVICES,
+};
+// ── Inconsistent cross-sheet interfaces ────────────────────────────────────
+export const CROSS_SHEET_INTERFACES = [
+    {
+        id: 'sheet1-port',
+        name: 'BUS_A',
+        pinout: [
+            { pin: '1', signal: 'DATA' },
+            { pin: '2', signal: 'CLK' },
+        ],
+    },
+    {
+        id: 'sheet2-port',
+        name: 'BUS_A',
+        pinout: [
+            { pin: '1', signal: 'DATA' },
+            { pin: '2', signal: 'CLK' },
+        ],
+    },
+];
+export const MISMATCHED_CROSS_SHEET_INTERFACES = [
+    {
+        id: 'sheet1-port',
+        name: 'BUS_A',
+        pinout: [
+            { pin: '1', signal: 'DATA' },
+            { pin: '2', signal: 'CLK' },
+        ],
+    },
+    {
+        id: 'sheet2-port',
+        name: 'BUS_A',
+        pinout: [
+            { pin: '1', signal: 'DATA' },
+            { pin: '2', signal: 'STROBE' },
+        ],
+    }, // ← mismatched
+];
+export const CROSS_SHEET_INPUT = {
+    nets: VALID_NETS,
+    interfaces: CROSS_SHEET_INTERFACES,
+};
+export const MISMATCHED_CROSS_SHEET_INPUT = {
+    nets: VALID_NETS,
+    interfaces: MISMATCHED_CROSS_SHEET_INTERFACES,
+};
+// ── Naming convention violations ───────────────────────────────────────────
+export const BAD_POWER_NAME_NETS = [
+    { id: 'n1', name: 'MY_RAIL', type: 'power', nodes: [{ deviceRef: 'U1', pin: '1' }] }, // ← should be like "3V3", "VCC"
+    { id: 'n2', name: 'GND', type: 'ground', nodes: [{ deviceRef: 'U1', pin: '2' }] },
+];
+export const BAD_POWER_NAME_INPUT = { nets: BAD_POWER_NAME_NETS };
+export const BAD_GROUND_NAME_NETS = [
+    { id: 'n1', name: '3V3', type: 'power', nodes: [{ deviceRef: 'U1', pin: '1' }] },
+    { id: 'n2', name: 'RET', type: 'ground', nodes: [{ deviceRef: 'U1', pin: '2' }] }, // ← non-standard ground name
+];
+export const BAD_GROUND_NAME_INPUT = { nets: BAD_GROUND_NAME_NETS };
+// ── Protected domain violations ────────────────────────────────────────────
+export const HV_GENERIC_NAME_NETS = [
+    { id: 'n1', name: '3V3', type: 'power', nodes: [{ deviceRef: 'U1', pin: '1' }] },
+    { id: 'n2', name: 'GND', type: 'ground', nodes: [{ deviceRef: 'U1', pin: '2' }] },
+    { id: 'n3', name: 'L', type: 'signal', nodes: [{ deviceRef: 'U1', pin: '3' }] }, // ← 'L' alone is a generic name in HV context
+];
+export const HV_GENERIC_NAME_INPUT = { nets: HV_GENERIC_NAME_NETS };
+// ── Mixed HV+digital domain ────────────────────────────────────────────────
+export const HV_MIXED_DOMAIN_NETS = [
+    { id: 'n1', name: '3V3', type: 'power', nodes: [{ deviceRef: 'U1', pin: '1' }] },
+    { id: 'n2', name: 'GND', type: 'ground', nodes: [{ deviceRef: 'U1', pin: '2' }] },
+    { id: 'n3', name: 'HV_CLK', type: 'signal', nodes: [{ deviceRef: 'U1', pin: '3' }] }, // ← HV + CLK = mixed domain (safety hazard)
+];
+export const HV_MIXED_DOMAIN_INPUT = { nets: HV_MIXED_DOMAIN_NETS };
+//# sourceMappingURL=fixtures.js.map

package/dist/net-validation/fixtures.js.map

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

package/dist/net-validation/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Net validation — public API barrel.
+ *
+ * @module
+ */
+export { NetValidationCode, netValidationIssue, netError, netWarning } from './errors.js';
+export type { NetValidationCode as NetValidationCodeType, NetValidationIssue, NetValidationResult, } from './errors.js';
+export { NetDomain, NET_DOMAIN_PATTERNS, NET_TYPE_EXPECTED_DOMAIN, RESERVED_NET_NAMES, REQUIRED_POWER_NETS, REQUIRED_GROUND_NETS, } from './schema.js';
+export type { NetValidationEntry, DeviceValidationEntry, InterfaceValidationEntry, NetValidationInput, } from './schema.js';
+export { validateNets, validateNetsOrThrow } from './validation.js';

package/dist/net-validation/index.js

@@ -0,0 +1,9 @@
+/**
+ * Net validation — public API barrel.
+ *
+ * @module
+ */
+export { NetValidationCode, netValidationIssue, netError, netWarning } from './errors.js';
+export { NetDomain, NET_DOMAIN_PATTERNS, NET_TYPE_EXPECTED_DOMAIN, RESERVED_NET_NAMES, REQUIRED_POWER_NETS, REQUIRED_GROUND_NETS, } from './schema.js';
+export { validateNets, validateNetsOrThrow } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/net-validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/net-validation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO1F,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAQrB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/net-validation/schema.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Net validation — schema types and naming convention definitions.
+ *
+ * Defines the input contract for net validation functions and the
+ * convention sets used to classify net names into analog, digital,
+ * power, ground, and high-voltage domains.
+ *
+ * @module
+ */
+/**
+ * Electrical domain inferred from a net name.
+ *
+ * Used by naming-convention rules to detect misclassifications
+ * (e.g. an analog signal connected to a digital rail).
+ */
+export declare enum NetDomain {
+    /** General-purpose analogue signal (e.g. "SENSE", "FB", "VREF"). */
+    Analog = "analog",
+    /** Digital signal, bus, or protocol (e.g. "I2C_SCL", "UART_TXD"). */
+    Digital = "digital",
+    /** Power rail or voltage supply (e.g. "3V3", "VIN", "VCC"). */
+    Power = "power",
+    /** Ground or return (e.g. "GND", "AGND", "DGND", "PGND"). */
+    Ground = "ground",
+    /** AC mains or high-voltage domain (e.g. "L", "N", "HV_BULK"). */
+    HighVoltage = "high-voltage",
+    /** Clock or timing signal (e.g. "CLK_32K", "MCO"). */
+    Clock = "clock",
+    /** Reset or control signal (e.g. "nRST", "EN", "PWR_ON"). */
+    Control = "control",
+    /** Unclassified or custom. */
+    Other = "other"
+}
+/**
+ * Naming convention pattern sets used to classify a net name into a domain.
+ *
+ * Each entry is a list of **case-insensitive** substrings / regex patterns
+ * that, when matched against a net name, assign it to the corresponding
+ * {@link NetDomain}.
+ */
+export declare const NET_DOMAIN_PATTERNS: Record<Exclude<NetDomain, NetDomain.Other>, RegExp[]>;
+/**
+ * Net names that are reserved for specific purposes and should not be
+ * reassigned to other signal types.
+ */
+export declare const RESERVED_NET_NAMES: Set<string>;
+/**
+ * Minimum set of power nets that a complete design should contain
+ * (case-insensitive matching).
+ */
+export declare const REQUIRED_POWER_NETS: Set<string>;
+/**
+ * Minimum set of ground nets that a complete design should contain.
+ */
+export declare const REQUIRED_GROUND_NETS: Set<string>;
+/**
+ * Map from NetType to expected naming convention domain.
+ * A net with a given NetType should have a name matching the
+ * corresponding domain(s).
+ */
+export declare const NET_TYPE_EXPECTED_DOMAIN: Record<string, NetDomain[]>;
+/**
+ * A minimal net representation for validation purposes.
+ *
+ * This is intentionally decoupled from the full CircuitIR NetSchema
+ * so that validation can operate on net data from any source
+ * (CircuitIR, EasyEDA bridge, hand-authored test data).
+ */
+export interface NetValidationEntry {
+    /** Unique net identifier. */
+    id: string;
+    /** Human-readable net name (e.g. "3V3", "I2C_SCL", "GND"). */
+    name: string;
+    /** Net type classification. */
+    type: 'power' | 'signal' | 'ground';
+    /** Connected device pins, may be empty for floating nets. */
+    nodes: Array<{
+        deviceRef: string;
+        pin: string;
+    }>;
+}
+/**
+ * A minimal device representation for validation.
+ */
+export interface DeviceValidationEntry {
+    /** Device identifier (matches deviceRef in net nodes). */
+    id: string;
+    /** Reference designator (e.g. "U1", "R3"). */
+    ref: string;
+    /** Functional category for determining required pins. */
+    category?: string;
+}
+/**
+ * A hierarchical port / interface for cross-sheet validation.
+ */
+export interface InterfaceValidationEntry {
+    /** Interface identifier. */
+    id: string;
+    /** Interface / port name. */
+    name: string;
+    /** Pins on this interface. */
+    pinout: Array<{
+        pin: string;
+        signal: string;
+        type?: string;
+    }>;
+}
+/**
+ * Complete input to the net validation function.
+ */
+export interface NetValidationInput {
+    /** Nets to validate. */
+    nets: NetValidationEntry[];
+    /** Optional device list for unconnected-pin checks. */
+    devices?: DeviceValidationEntry[];
+    /** Optional interface list for cross-sheet checks. */
+    interfaces?: InterfaceValidationEntry[];
+}