easyeda-mcp-pro 1.8.0 → 1.9.0

package/dist/design-rules/trace-current-review.js

@@ -0,0 +1,144 @@
+import { calculateTraceWidth } from './trace-width.js';
+const THERMAL_LIMITATIONS = [
+    'IPC-2221 empirical estimate, not an IPC-2152 calculation or validated thermal limit.',
+    'Copper weight is nominal: finished minimum plated copper thickness can differ.',
+    'Actual temperature depends on board material/thickness, copper planes, adjacent heat, airflow and duty cycle.',
+    'Via transitions, plane connections and local neck-downs require separate review.',
+    'Fabricator trace/space capability and electrical thermal adequacy are different checks.',
+];
+const INPUT_UNITS = {
+    currentA: 'A',
+    temperatureRiseC: '°C',
+    copperWeightOz: 'oz/ft²',
+    traceWidthMm: 'mm',
+    neckDownWidthMm: 'mm',
+    manufacturerMinWidthMm: 'mm',
+};
+function hasCompleteModelInput(input) {
+    return (input.currentA !== undefined &&
+        input.temperatureRiseC !== undefined &&
+        input.layer !== undefined &&
+        input.copperWeightOz !== undefined);
+}
+function thermalFinding(estimate, narrowest) {
+    if (estimate === undefined) {
+        return {
+            id: 'THERMAL_ESTIMATE',
+            status: 'UNKNOWN',
+            message: 'Current, temperature rise, layer and copper weight must all be supplied.',
+        };
+    }
+    if (narrowest === undefined) {
+        return {
+            id: 'THERMAL_ESTIMATE',
+            status: 'UNKNOWN',
+            message: 'Only a reference width was calculated; actual routed width was not supplied.',
+        };
+    }
+    if (narrowest < estimate) {
+        return {
+            id: 'THERMAL_ESTIMATE',
+            status: 'WARNING',
+            message: 'Supplied width is below the IPC-2221 empirical estimate; review current path and thermal design.',
+        };
+    }
+    return {
+        id: 'THERMAL_ESTIMATE',
+        status: 'UNKNOWN',
+        message: 'Supplied width meets the empirical reference, but thermal adequacy is not verified.',
+    };
+}
+function fabricationFinding(input) {
+    const { traceWidthMm, neckDownWidthMm, manufacturerMinWidthMm } = input;
+    const narrowest = traceWidthMm === undefined
+        ? undefined
+        : Math.min(traceWidthMm, neckDownWidthMm ?? traceWidthMm);
+    if (manufacturerMinWidthMm === undefined || narrowest === undefined) {
+        return {
+            id: 'FABRICATION_WIDTH',
+            status: 'UNKNOWN',
+            message: 'No verified manufacturer minimum or complete routed geometry is available.',
+        };
+    }
+    if (narrowest < manufacturerMinWidthMm) {
+        return {
+            id: 'FABRICATION_WIDTH',
+            status: 'WARNING',
+            message: 'Supplied routed width is below the supplied fabricator trace-width minimum.',
+        };
+    }
+    return {
+        id: 'FABRICATION_WIDTH',
+        status: 'UNKNOWN',
+        message: 'The supplied trace width meets the claimed fabricator minimum, but the process was not verified.',
+    };
+}
+function validateReviewInput(input) {
+    for (const field of [
+        'currentA',
+        'temperatureRiseC',
+        'copperWeightOz',
+        'traceWidthMm',
+        'neckDownWidthMm',
+        'manufacturerMinWidthMm',
+    ]) {
+        const value = input[field];
+        if (value !== undefined && (!Number.isFinite(value) || value <= 0)) {
+            throw new Error(field + ' must be a finite positive number');
+        }
+    }
+}
+export function reviewTraceCurrent(input) {
+    validateReviewInput(input);
+    const estimate = hasCompleteModelInput(input)
+        ? calculateTraceWidth({
+            currentA: input.currentA,
+            temperatureRiseC: input.temperatureRiseC,
+            layer: input.layer,
+            copperWeightOz: input.copperWeightOz,
+        }).traceWidthMm
+        : undefined;
+    // Width of a single straight segment is not proof of the entire current path.
+    const narrowest = input.traceWidthMm === undefined
+        ? undefined
+        : Math.min(input.traceWidthMm, input.neckDownWidthMm ?? input.traceWidthMm);
+    const findings = [
+        thermalFinding(estimate, narrowest),
+        fabricationFinding(input),
+        {
+            id: 'ROUTE_GEOMETRY',
+            status: 'UNKNOWN',
+            message: input.neckDownWidthMm === undefined
+                ? 'The narrowest actual segment has not been established by live EasyEDA routing measurements.'
+                : 'The supplied neck-down is not verified against the complete native route.',
+        },
+        {
+            id: 'VIA_BOTTLENECK',
+            status: 'UNKNOWN',
+            message: 'No verified via barrel/transition geometry or parallel-current evidence is available.',
+        },
+    ];
+    const limitations = [
+        ...THERMAL_LIMITATIONS,
+        input.environment === 'vacuum'
+            ? 'Vacuum thermal conditions are not covered by this empirical lookup.'
+            : input.environment === 'forced-air'
+                ? 'Forced airflow was supplied as context but is not modeled by this lookup.'
+                : input.environment === undefined || input.environment === 'unspecified'
+                    ? 'Ambient conditions were not specified.'
+                    : 'Still-air assumptions have not been validated against the actual enclosure.',
+    ];
+    return {
+        status: findings.some(({ status }) => status === 'WARNING') ? 'WARNING' : 'UNKNOWN',
+        method: 'IPC2221_EMPIRICAL_REFERENCE',
+        evidence: 'caller_supplied_unverified',
+        source: 'IPC-2221 empirical current-versus-conductor-area equation; see IPC-2152 for thermal design guidance.',
+        inputs: input,
+        inputUnits: INPUT_UNITS,
+        ...(estimate === undefined ? {} : { estimatedMinimumWidthMm: estimate }),
+        ...(narrowest === undefined ? {} : { suppliedNarrowestWidthMm: narrowest }),
+        findings,
+        limitations,
+    };
+}
+//# sourceMappingURL=trace-current-review.js.map

package/dist/design-rules/trace-current-review.js.map

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

package/dist/design-rules/trace-width.d.ts

@@ -10,16 +10,17 @@
  * layer) conductors or 0.024 for internal conductors.
  *
  * This is an estimate, not a certified value: the curve does not model adjacent-trace
- * heating, via/plane proximity, forced airflow, or altitude. IPC-2152 supersedes
- * IPC-2221 with more conservative guidance for dense modern boards. Verify against
- * your fabricator's process and cross-check with IPC-2152 for safety-critical or
- * high-reliability current paths.
+ * heating, via/plane proximity, forced airflow, or altitude. IPC-2152 provides
+ * measured thermal guidance for a wider range of PCB conditions, not universally
+ * more conservative estimates. Verify against the actual fabrication process and
+ * thermal guidance for safety-critical and high-reliability current paths.
  *
  * @module
  */
 export type ConductorLayer = 'external' | 'internal';
 /** Standard copper thickness in mils per oz/ft² of copper weight (1oz ≈ 1.378 mils / 34.8 µm). */
 export declare const COPPER_THICKNESS_MILS_PER_OZ = 1.378;
+export declare const TRACE_WIDTH_METHOD: "IPC2221_EMPIRICAL_REFERENCE";
 export interface TraceWidthInput {
     /** Required current-carrying capacity, in amps. */
     currentA: number;
@@ -38,6 +39,18 @@ export interface TraceWidthResult {
     k: number;
     source: string;
     caveat: string;
+    method: typeof TRACE_WIDTH_METHOD;
+    inputs: TraceWidthInput;
+    units: {
+        currentA: 'A';
+        temperatureRiseC: '°C';
+        copperWeightOz: 'oz/ft²';
+        traceWidthMm: 'mm';
+        traceWidthMils: 'mil';
+        copperThicknessMils: 'mil';
+        requiredAreaMils2: 'mil²';
+    };
+    limitations: string[];
 }
 /** Compute the minimum trace width for a given current, temperature rise, layer, and copper weight. */
 export declare function calculateTraceWidth(input: TraceWidthInput): TraceWidthResult;
@@ -53,6 +66,15 @@ export interface MaxCurrentResult {
     maxCurrentA: number;
     source: string;
     caveat: string;
+    method: typeof TRACE_WIDTH_METHOD;
+    inputs: MaxCurrentInput;
+    units: {
+        maxCurrentA: 'A';
+        traceWidthMils: 'mil';
+        temperatureRiseC: '°C';
+        copperWeightOz: 'oz/ft²';
+    };
+    limitations: string[];
 }
 /** Reverse lookup: the maximum current a given trace width can carry under the same model. */
 export declare function calculateMaxCurrent(input: MaxCurrentInput): MaxCurrentResult;

package/dist/design-rules/trace-width.js

@@ -10,10 +10,10 @@
  * layer) conductors or 0.024 for internal conductors.
  *
  * This is an estimate, not a certified value: the curve does not model adjacent-trace
- * heating, via/plane proximity, forced airflow, or altitude. IPC-2152 supersedes
- * IPC-2221 with more conservative guidance for dense modern boards. Verify against
- * your fabricator's process and cross-check with IPC-2152 for safety-critical or
- * high-reliability current paths.
+ * heating, via/plane proximity, forced airflow, or altitude. IPC-2152 provides
+ * measured thermal guidance for a wider range of PCB conditions, not universally
+ * more conservative estimates. Verify against the actual fabrication process and
+ * thermal guidance for safety-critical and high-reliability current paths.
  *
  * @module
  */
@@ -24,9 +24,15 @@ const K_INTERNAL = 0.024;
 /** Standard copper thickness in mils per oz/ft² of copper weight (1oz ≈ 1.378 mils / 34.8 µm). */
 export const COPPER_THICKNESS_MILS_PER_OZ = 1.378;
 const IPC2221_SOURCE = 'IPC-2221 (formerly MIL-STD-275): I = k·ΔT^0.44·A^0.725';
+export const TRACE_WIDTH_METHOD = 'IPC2221_EMPIRICAL_REFERENCE';
+const TRACE_WIDTH_LIMITATIONS = [
+    'Empirical IPC-2221 estimate only; not measured PCB or IPC-2152 thermal output.',
+    'Nominal copper weight does not verify finished copper thickness.',
+    'Copper planes, airflow, via bottlenecks, neck-downs and neighboring heat are not modeled.',
+];
 const IPC2221_CAVEAT = 'Estimate only — does not model adjacent-trace heating, via/plane proximity, or airflow. ' +
-    'Verify against your fabricator process; cross-check with IPC-2152 for dense or ' +
-    'high-reliability boards.';
+    'IPC-2152 includes board stackup, copper planes, environment and thermal coupling; ' +
+    'it is not uniformly more conservative. Validate the board and fabrication process.';
 function kFor(layer) {
     return layer === 'external' ? K_EXTERNAL : K_INTERNAL;
 }
@@ -34,19 +40,22 @@ function round(value, decimals) {
     const factor = 10 ** decimals;
     return Math.round(value * factor) / factor;
 }
+function assertPositiveFinite(name, value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(name + ' must be a finite positive number');
+    }
+}
 /** Compute the minimum trace width for a given current, temperature rise, layer, and copper weight. */
 export function calculateTraceWidth(input) {
     const { currentA, temperatureRiseC, layer, copperWeightOz } = input;
-    if (!(currentA > 0))
-        throw new Error('currentA must be a positive number');
-    if (!(temperatureRiseC > 0))
-        throw new Error('temperatureRiseC must be a positive number');
-    if (!(copperWeightOz > 0))
-        throw new Error('copperWeightOz must be a positive number');
+    assertPositiveFinite('currentA', currentA);
+    assertPositiveFinite('temperatureRiseC', temperatureRiseC);
+    assertPositiveFinite('copperWeightOz', copperWeightOz);
     const k = kFor(layer);
     const areaMils2 = Math.pow(currentA / (k * Math.pow(temperatureRiseC, 0.44)), 1 / 0.725);
     const thicknessMils = copperWeightOz * COPPER_THICKNESS_MILS_PER_OZ;
     const widthMils = areaMils2 / thicknessMils;
+    assertPositiveFinite('computedTraceWidthMils', widthMils);
     return {
         requiredAreaMils2: round(areaMils2, 3),
         copperThicknessMils: round(thicknessMils, 3),
@@ -55,25 +64,44 @@ export function calculateTraceWidth(input) {
         k,
         source: IPC2221_SOURCE,
         caveat: IPC2221_CAVEAT,
+        method: TRACE_WIDTH_METHOD,
+        inputs: { ...input },
+        units: {
+            currentA: 'A',
+            temperatureRiseC: '°C',
+            copperWeightOz: 'oz/ft²',
+            traceWidthMm: 'mm',
+            traceWidthMils: 'mil',
+            copperThicknessMils: 'mil',
+            requiredAreaMils2: 'mil²',
+        },
+        limitations: [...TRACE_WIDTH_LIMITATIONS],
     };
 }
 /** Reverse lookup: the maximum current a given trace width can carry under the same model. */
 export function calculateMaxCurrent(input) {
     const { traceWidthMils, temperatureRiseC, layer, copperWeightOz } = input;
-    if (!(traceWidthMils > 0))
-        throw new Error('traceWidthMils must be a positive number');
-    if (!(temperatureRiseC > 0))
-        throw new Error('temperatureRiseC must be a positive number');
-    if (!(copperWeightOz > 0))
-        throw new Error('copperWeightOz must be a positive number');
+    assertPositiveFinite('traceWidthMils', traceWidthMils);
+    assertPositiveFinite('temperatureRiseC', temperatureRiseC);
+    assertPositiveFinite('copperWeightOz', copperWeightOz);
     const k = kFor(layer);
     const thicknessMils = copperWeightOz * COPPER_THICKNESS_MILS_PER_OZ;
     const areaMils2 = traceWidthMils * thicknessMils;
     const maxCurrentA = k * Math.pow(temperatureRiseC, 0.44) * Math.pow(areaMils2, 0.725);
+    assertPositiveFinite('computedMaxCurrentA', maxCurrentA);
     return {
         maxCurrentA: round(maxCurrentA, 3),
         source: IPC2221_SOURCE,
         caveat: IPC2221_CAVEAT,
+        method: TRACE_WIDTH_METHOD,
+        inputs: { ...input },
+        units: {
+            maxCurrentA: 'A',
+            traceWidthMils: 'mil',
+            temperatureRiseC: '°C',
+            copperWeightOz: 'oz/ft²',
+        },
+        limitations: [...TRACE_WIDTH_LIMITATIONS],
     };
 }
 //# sourceMappingURL=trace-width.js.map

package/dist/design-rules/trace-width.js.map

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

package/dist/engineering-review/report.d.ts

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+import type { PcbConstraintInput } from '../pcb-constraints/types.js';
+/** Evidence report only; never an electrical or manufacturing sign-off. */
+export declare const reviewStatusSchema: z.ZodEnum<{
+    UNKNOWN: "UNKNOWN";
+    WARNING: "WARNING";
+    PASS: "PASS";
+    FAIL: "FAIL";
+    NOT_APPLICABLE: "NOT_APPLICABLE";
+}>;
+export declare const engineeringReviewSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    overall_status: z.ZodEnum<{
+        UNKNOWN: "UNKNOWN";
+        WARNING: "WARNING";
+        PASS: "PASS";
+        FAIL: "FAIL";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>;
+    pcb_context: z.ZodEnum<{
+        unverified: "unverified";
+        observed: "observed";
+    }>;
+    runtime: z.ZodObject<{
+        bridge_connected: z.ZodBoolean;
+        registry_mismatch: z.ZodNullable<z.ZodBoolean>;
+        extension_version_mismatch: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strip>;
+    groups: z.ZodObject<{
+        blocking: z.ZodArray<z.ZodString>;
+        advisories: z.ZodArray<z.ZodString>;
+        unknowns: z.ZodArray<z.ZodString>;
+        passed: z.ZodArray<z.ZodString>;
+        not_applicable: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    source_version: z.ZodObject<{
+        easyeda: z.ZodNullable<z.ZodString>;
+        extension: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    observations: z.ZodArray<z.ZodObject<{
+        method: z.ZodString;
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            observed: "observed";
+            not_run: "not_run";
+        }>;
+        guidance: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    input_evidence: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        source: z.ZodString;
+        quality: z.ZodEnum<{
+            unavailable: "unavailable";
+            measured: "measured";
+            supplied: "supplied";
+            unverified: "unverified";
+        }>;
+        unit: z.ZodOptional<z.ZodString>;
+        age: z.ZodEnum<{
+            unverified: "unverified";
+            current_request: "current_request";
+        }>;
+        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, z.core.$strip>>;
+    findings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        rule_id: z.ZodString;
+        rule_revision: z.ZodString;
+        requirement_source: z.ZodString;
+        scope: z.ZodString;
+        status: z.ZodEnum<{
+            UNKNOWN: "UNKNOWN";
+            WARNING: "WARNING";
+            PASS: "PASS";
+            FAIL: "FAIL";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>;
+        severity: z.ZodEnum<{
+            info: "info";
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        remediation: z.ZodString;
+        confidence: z.ZodEnum<{
+            unverified: "unverified";
+            observed: "observed";
+            derived: "derived";
+        }>;
+        evidence_fields: z.ZodArray<z.ZodString>;
+        affected_entities: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        PASS: z.ZodNumber;
+        FAIL: z.ZodNumber;
+        WARNING: z.ZodNumber;
+        UNKNOWN: z.ZodNumber;
+        NOT_APPLICABLE: z.ZodNumber;
+    }, z.core.$strip>;
+    human_review_required: z.ZodArray<z.ZodString>;
+    engineering_sign_off: z.ZodLiteral<false>;
+}, z.core.$strip>;
+export type EngineeringReview = z.infer<typeof engineeringReviewSchema>;
+export type ReviewFinding = EngineeringReview['findings'][number];
+export type ReviewObservation = EngineeringReview['observations'][number];
+type ReviewBuildInput = {
+    projectId: string;
+    boardData: PcbConstraintInput;
+    observations: ReviewObservation[];
+    bridgeConnected: boolean;
+    registryMismatch?: boolean;
+    extensionVersionMismatch?: boolean;
+    sourceChangedDuringRead?: boolean;
+    easyedaVersion?: string;
+    extensionVersion?: string;
+    evidenceMode: 'native' | 'supplied';
+};
+export declare function buildEngineeringReview(input: ReviewBuildInput): EngineeringReview;
+export {};