easyeda-mcp-pro 0.30.0 → 0.32.0

package/dist/schematic-model/audit.js

@@ -0,0 +1,331 @@
+import { z } from 'zod';
+export const ImportedAuditSeveritySchema = z.enum(['info', 'warning', 'error']);
+export const ImportedAuditFindingSchema = z.object({
+    code: z.string().min(1),
+    severity: ImportedAuditSeveritySchema,
+    message: z.string().min(1),
+    componentId: z.string().optional(),
+    componentRef: z.string().optional(),
+    netName: z.string().optional(),
+    rawNetNames: z.array(z.string()).optional(),
+    evidence: z.record(z.string(), z.unknown()).optional(),
+    suggestedAction: z.string().min(1),
+    confidence: z.enum(['high', 'medium', 'low']),
+});
+export const ImportedDesignAuditSchema = z.object({
+    schemaVersion: z.literal('imported-design-audit/v1'),
+    status: z.enum(['clean', 'review', 'blocked']),
+    readOnly: z.literal(true),
+    safeToNormalize: z.boolean(),
+    modelSummary: z.object({
+        componentCount: z.number().int().nonnegative(),
+        bomComponentCount: z.number().int().nonnegative(),
+        electricalComponentCount: z.number().int().nonnegative(),
+        netCount: z.number().int().nonnegative(),
+        importedComponentCount: z.number().int().nonnegative(),
+    }),
+    summary: z.object({
+        findingCount: z.number().int().nonnegative(),
+        errorCount: z.number().int().nonnegative(),
+        warningCount: z.number().int().nonnegative(),
+        infoCount: z.number().int().nonnegative(),
+        importedNetCount: z.number().int().nonnegative(),
+        aliasedNetCount: z.number().int().nonnegative(),
+        unannotatedComponentCount: z.number().int().nonnegative(),
+        missingFootprintCount: z.number().int().nonnegative(),
+        missingValueCount: z.number().int().nonnegative(),
+        duplicateReferenceCount: z.number().int().nonnegative(),
+        ambiguousBomCount: z.number().int().nonnegative(),
+        unresolvedExpressionCount: z.number().int().nonnegative(),
+    }),
+    findings: z.array(ImportedAuditFindingSchema),
+    normalizationPreview: z.object({
+        netAliases: z.array(z.object({
+            canonicalNetName: z.string(),
+            rawNetNames: z.array(z.string()),
+            kind: z.enum(['signal', 'power', 'ground', 'power-flag', 'unnamed']),
+            rules: z.array(z.string()),
+        })),
+        componentRepairs: z.array(z.object({
+            componentId: z.string(),
+            reference: z.string(),
+            actions: z.array(z.enum([
+                'annotate-reference',
+                'assign-footprint',
+                'assign-value',
+                'resolve-value-expression',
+                'resolve-footprint-expression',
+                'review-bom-classification',
+            ])),
+        })),
+    }),
+});
+function unresolvedExpression(value) {
+    return typeof value === 'string' && /^=\{[^{}]+\}$/.test(value.trim());
+}
+function componentRepairActions(component) {
+    const actions = [];
+    if (component.componentKind === 'part') {
+        if (!component.annotated)
+            actions.push('annotate-reference');
+        if (!component.footprint)
+            actions.push('assign-footprint');
+        if (!component.value)
+            actions.push('assign-value');
+        if (unresolvedExpression(component.value))
+            actions.push('resolve-value-expression');
+        if (unresolvedExpression(component.footprint))
+            actions.push('resolve-footprint-expression');
+    }
+    if (['unknown', 'helper'].includes(component.componentKind) &&
+        (component.reference || component.value || component.footprint)) {
+        actions.push('review-bom-classification');
+    }
+    return actions;
+}
+function findingSort(a, b) {
+    const rank = { error: 0, warning: 1, info: 2 };
+    return (rank[a.severity] - rank[b.severity] ||
+        a.code.localeCompare(b.code) ||
+        (a.componentRef ?? '').localeCompare(b.componentRef ?? '') ||
+        (a.netName ?? '').localeCompare(b.netName ?? ''));
+}
+function isAmbiguousBomPrimitive(component) {
+    return (['unknown', 'helper'].includes(component.componentKind) &&
+        Boolean(component.reference || component.value || component.footprint));
+}
+function componentFindings(component) {
+    const findings = [];
+    const isPart = component.componentKind === 'part';
+    if (isPart && !component.annotated) {
+        findings.push({
+            code: 'COMPONENT_UNANNOTATED',
+            severity: 'warning',
+            message: 'A real component does not have a stable reference designator.',
+            componentId: component.canonicalComponentId,
+            componentRef: component.reference,
+            evidence: { rawReference: component.rawReference },
+            suggestedAction: 'Assign a unique reference designator before automated reconciliation.',
+            confidence: 'high',
+        });
+    }
+    if (isPart && !component.footprint) {
+        findings.push({
+            code: 'COMPONENT_MISSING_FOOTPRINT',
+            severity: 'warning',
+            message: 'A BOM-eligible component has no resolved footprint.',
+            componentId: component.canonicalComponentId,
+            componentRef: component.reference,
+            suggestedAction: 'Assign or map the intended EasyEDA footprint.',
+            confidence: 'high',
+        });
+    }
+    if (isPart && !component.value) {
+        findings.push({
+            code: 'COMPONENT_MISSING_VALUE',
+            severity: 'warning',
+            message: 'A BOM-eligible component has no resolved value or device name.',
+            componentId: component.canonicalComponentId,
+            componentRef: component.reference,
+            suggestedAction: 'Set a value or map the imported value attribute.',
+            confidence: 'medium',
+        });
+    }
+    if (isPart && unresolvedExpression(component.value)) {
+        findings.push({
+            code: 'COMPONENT_VALUE_EXPRESSION_UNRESOLVED',
+            severity: 'warning',
+            message: 'The component value is still an unresolved metadata expression.',
+            componentId: component.canonicalComponentId,
+            componentRef: component.reference,
+            evidence: { rawValue: component.rawValue, resolvedValue: component.value },
+            suggestedAction: 'Map the referenced imported attribute to a concrete value.',
+            confidence: 'high',
+        });
+    }
+    if (isPart && unresolvedExpression(component.footprint)) {
+        findings.push({
+            code: 'COMPONENT_FOOTPRINT_EXPRESSION_UNRESOLVED',
+            severity: 'warning',
+            message: 'The component footprint is still an unresolved metadata expression.',
+            componentId: component.canonicalComponentId,
+            componentRef: component.reference,
+            evidence: { rawFootprint: component.rawFootprint, resolvedFootprint: component.footprint },
+            suggestedAction: 'Map the referenced imported attribute to a concrete footprint.',
+            confidence: 'high',
+        });
+    }
+    if (isAmbiguousBomPrimitive(component)) {
+        findings.push({
+            code: 'BOM_CLASSIFICATION_AMBIGUOUS',
+            severity: 'warning',
+            message: 'This imported primitive has part-like metadata but an ambiguous component type.',
+            componentId: component.canonicalComponentId,
+            componentRef: component.reference,
+            evidence: {
+                componentKind: component.componentKind,
+                value: component.value,
+                footprint: component.footprint,
+            },
+            suggestedAction: 'Review whether this primitive should be included in the BOM.',
+            confidence: 'medium',
+        });
+    }
+    return findings;
+}
+function duplicateReferenceFindings(components) {
+    const groups = new Map();
+    for (const component of components) {
+        if (component.componentKind !== 'part' || !component.annotated)
+            continue;
+        const key = component.reference.toUpperCase();
+        const group = groups.get(key) ?? [];
+        group.push(component);
+        groups.set(key, group);
+    }
+    const findings = [];
+    for (const group of groups.values()) {
+        if (group.length < 2)
+            continue;
+        const reference = group[0]?.reference ?? '';
+        findings.push({
+            code: 'DUPLICATE_COMPONENT_REFERENCE',
+            severity: 'error',
+            message: `Reference ${reference} is assigned to multiple BOM components.`,
+            componentRef: reference,
+            evidence: { componentIds: group.map((component) => component.canonicalComponentId) },
+            suggestedAction: 'Re-annotate the duplicate components with unique references.',
+            confidence: 'high',
+        });
+    }
+    return findings;
+}
+function netFindings(net, includeInfo) {
+    const findings = [];
+    if (net.kind === 'unnamed') {
+        findings.push({
+            code: 'NET_NAME_EMPTY',
+            severity: 'warning',
+            message: 'A net has no stable name after normalization.',
+            netName: net.canonicalNetName,
+            rawNetNames: net.rawNetNames,
+            suggestedAction: 'Assign an explicit net name or verify that the unnamed net is intentional.',
+            confidence: 'high',
+        });
+    }
+    if (includeInfo && net.imported) {
+        findings.push({
+            code: 'IMPORTED_NET_ALIAS',
+            severity: 'info',
+            message: `Imported net alias resolves to ${net.canonicalNetName}.`,
+            netName: net.canonicalNetName,
+            rawNetNames: net.rawNetNames,
+            evidence: { normalizationRules: net.normalizationRules, kind: net.kind },
+            suggestedAction: 'Review the preview before applying any display-name normalization.',
+            confidence: 'high',
+        });
+    }
+    if (includeInfo && net.rawNetNames.length > 1) {
+        findings.push({
+            code: 'NET_ALIASES_MERGED',
+            severity: 'info',
+            message: `Multiple raw names resolve to canonical net ${net.canonicalNetName}.`,
+            netName: net.canonicalNetName,
+            rawNetNames: net.rawNetNames,
+            suggestedAction: 'Confirm that the aliases represent one intended electrical net.',
+            confidence: 'medium',
+        });
+    }
+    if (includeInfo && net.kind === 'power-flag') {
+        findings.push({
+            code: 'POWER_FLAG_NET_DETECTED',
+            severity: 'info',
+            message: 'An imported power-flag helper net was detected and excluded from signal semantics.',
+            netName: net.canonicalNetName,
+            rawNetNames: net.rawNetNames,
+            suggestedAction: 'Keep it as a power assertion helper, not a user signal net.',
+            confidence: 'high',
+        });
+    }
+    return findings;
+}
+function sourceTruncatedFinding() {
+    return {
+        code: 'SOURCE_COMPONENTS_TRUNCATED',
+        severity: 'warning',
+        message: 'The live component inventory was truncated, so this audit is incomplete.',
+        suggestedAction: 'Repeat the audit with a complete component inventory before normalization.',
+        confidence: 'high',
+    };
+}
+function auditStatus(errorCount, warningCount) {
+    if (errorCount > 0)
+        return 'blocked';
+    if (warningCount > 0)
+        return 'review';
+    return 'clean';
+}
+function countFindingCodes(findings) {
+    const counts = new Map();
+    for (const finding of findings)
+        counts.set(finding.code, (counts.get(finding.code) ?? 0) + 1);
+    return counts;
+}
+export function auditImportedDesign(model, options = {}) {
+    const includeInfo = options.includeInfo ?? true;
+    const sourceTruncated = options.sourceTruncated ?? false;
+    const findings = [
+        ...model.components.flatMap(componentFindings),
+        ...duplicateReferenceFindings(model.components),
+        ...model.nets.flatMap((net) => netFindings(net, includeInfo)),
+        ...(sourceTruncated ? [sourceTruncatedFinding()] : []),
+    ];
+    findings.sort(findingSort);
+    const errorCount = findings.filter((finding) => finding.severity === 'error').length;
+    const warningCount = findings.filter((finding) => finding.severity === 'warning').length;
+    const infoCount = findings.filter((finding) => finding.severity === 'info').length;
+    const codeCounts = countFindingCodes(findings);
+    const componentRepairs = model.components
+        .map((component) => ({
+        componentId: component.canonicalComponentId,
+        reference: component.reference,
+        actions: componentRepairActions(component),
+    }))
+        .filter((repair) => repair.actions.length > 0);
+    const unresolvedExpressionCount = (codeCounts.get('COMPONENT_VALUE_EXPRESSION_UNRESOLVED') ?? 0) +
+        (codeCounts.get('COMPONENT_FOOTPRINT_EXPRESSION_UNRESOLVED') ?? 0);
+    return ImportedDesignAuditSchema.parse({
+        schemaVersion: 'imported-design-audit/v1',
+        status: auditStatus(errorCount, warningCount),
+        readOnly: true,
+        safeToNormalize: errorCount === 0 && !sourceTruncated,
+        modelSummary: model.summary,
+        summary: {
+            findingCount: findings.length,
+            errorCount,
+            warningCount,
+            infoCount,
+            importedNetCount: model.nets.filter((net) => net.imported).length,
+            aliasedNetCount: model.nets.filter((net) => net.rawNetNames.length > 1).length,
+            unannotatedComponentCount: codeCounts.get('COMPONENT_UNANNOTATED') ?? 0,
+            missingFootprintCount: codeCounts.get('COMPONENT_MISSING_FOOTPRINT') ?? 0,
+            missingValueCount: codeCounts.get('COMPONENT_MISSING_VALUE') ?? 0,
+            duplicateReferenceCount: codeCounts.get('DUPLICATE_COMPONENT_REFERENCE') ?? 0,
+            ambiguousBomCount: codeCounts.get('BOM_CLASSIFICATION_AMBIGUOUS') ?? 0,
+            unresolvedExpressionCount,
+        },
+        findings,
+        normalizationPreview: {
+            netAliases: model.nets
+                .filter((net) => net.imported || net.rawNetNames.length > 1)
+                .map((net) => ({
+                canonicalNetName: net.canonicalNetName,
+                rawNetNames: net.rawNetNames,
+                kind: net.kind,
+                rules: net.normalizationRules,
+            })),
+            componentRepairs,
+        },
+    });
+}
+//# sourceMappingURL=audit.js.map

package/dist/schematic-model/audit.js.map

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

package/dist/schematic-model/index.d.ts

@@ -0,0 +1,5 @@
+export * from './model.js';
+export * from './net-names.js';
+export * from './normalize.js';
+export * from './audit.js';
+export * from './normalization-plan.js';

package/dist/schematic-model/index.js

@@ -0,0 +1,6 @@
+export * from './model.js';
+export * from './net-names.js';
+export * from './normalize.js';
+export * from './audit.js';
+export * from './normalization-plan.js';
+//# sourceMappingURL=index.js.map

package/dist/schematic-model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schematic-model/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC"}

package/dist/schematic-model/model.d.ts

@@ -0,0 +1,206 @@
+import { z } from 'zod';
+export declare const ComponentKindSchema: z.ZodEnum<{
+    unknown: "unknown";
+    part: "part";
+    "power-symbol": "power-symbol";
+    "power-flag": "power-flag";
+    "net-label": "net-label";
+    "net-port": "net-port";
+    "sheet-frame": "sheet-frame";
+    annotation: "annotation";
+    helper: "helper";
+}>;
+export type ComponentKind = z.infer<typeof ComponentKindSchema>;
+export declare const SymbolSourceSchema: z.ZodEnum<{
+    unknown: "unknown";
+    native: "native";
+    imported: "imported";
+}>;
+export type SymbolSource = z.infer<typeof SymbolSourceSchema>;
+export declare const NetKindSchema: z.ZodEnum<{
+    signal: "signal";
+    power: "power";
+    ground: "ground";
+    "power-flag": "power-flag";
+    unnamed: "unnamed";
+}>;
+export type NetKind = z.infer<typeof NetKindSchema>;
+export declare const CanonicalNodeSchema: z.ZodObject<{
+    componentRef: z.ZodString;
+    pin: z.ZodString;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CanonicalNode = z.infer<typeof CanonicalNodeSchema>;
+export declare const CanonicalNetSchema: z.ZodObject<{
+    id: z.ZodString;
+    canonicalNetName: z.ZodString;
+    rawNetNames: z.ZodArray<z.ZodString>;
+    kind: z.ZodEnum<{
+        signal: "signal";
+        power: "power";
+        ground: "ground";
+        "power-flag": "power-flag";
+        unnamed: "unnamed";
+    }>;
+    nodes: z.ZodArray<z.ZodObject<{
+        componentRef: z.ZodString;
+        pin: z.ZodString;
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    normalizationRules: z.ZodArray<z.ZodString>;
+    imported: z.ZodBoolean;
+}, z.core.$strip>;
+export type CanonicalNet = z.infer<typeof CanonicalNetSchema>;
+export declare const CanonicalComponentSchema: z.ZodObject<{
+    canonicalComponentId: z.ZodString;
+    runtimePrimitiveId: z.ZodOptional<z.ZodString>;
+    reference: z.ZodString;
+    rawReference: z.ZodString;
+    annotated: z.ZodBoolean;
+    unit: z.ZodOptional<z.ZodString>;
+    symbolSource: z.ZodEnum<{
+        unknown: "unknown";
+        native: "native";
+        imported: "imported";
+    }>;
+    componentKind: z.ZodEnum<{
+        unknown: "unknown";
+        part: "part";
+        "power-symbol": "power-symbol";
+        "power-flag": "power-flag";
+        "net-label": "net-label";
+        "net-port": "net-port";
+        "sheet-frame": "sheet-frame";
+        annotation: "annotation";
+        helper: "helper";
+    }>;
+    bomEligible: z.ZodBoolean;
+    electricalEligible: z.ZodBoolean;
+    rawValue: z.ZodString;
+    value: z.ZodString;
+    rawFootprint: z.ZodString;
+    footprint: z.ZodString;
+    manufacturerPart: z.ZodOptional<z.ZodString>;
+    manufacturer: z.ZodOptional<z.ZodString>;
+    lcsc: z.ZodOptional<z.ZodString>;
+    datasheet: z.ZodOptional<z.ZodString>;
+    deviceName: z.ZodOptional<z.ZodString>;
+    symbolName: z.ZodOptional<z.ZodString>;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+    rotation: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CanonicalComponent = z.infer<typeof CanonicalComponentSchema>;
+export declare const ModelDiagnosticSchema: z.ZodObject<{
+    code: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        error: "error";
+        warning: "warning";
+    }>;
+    message: z.ZodString;
+    componentId: z.ZodOptional<z.ZodString>;
+    componentRef: z.ZodOptional<z.ZodString>;
+    netName: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ModelDiagnostic = z.infer<typeof ModelDiagnosticSchema>;
+export declare const SchematicDocumentSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    schematicName: z.ZodOptional<z.ZodString>;
+    pageName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SchematicDocument = z.infer<typeof SchematicDocumentSchema>;
+export declare const SchematicModelSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"schematic-model/v1">;
+    document: z.ZodObject<{
+        projectId: z.ZodOptional<z.ZodString>;
+        schematicName: z.ZodOptional<z.ZodString>;
+        pageName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    components: z.ZodArray<z.ZodObject<{
+        canonicalComponentId: z.ZodString;
+        runtimePrimitiveId: z.ZodOptional<z.ZodString>;
+        reference: z.ZodString;
+        rawReference: z.ZodString;
+        annotated: z.ZodBoolean;
+        unit: z.ZodOptional<z.ZodString>;
+        symbolSource: z.ZodEnum<{
+            unknown: "unknown";
+            native: "native";
+            imported: "imported";
+        }>;
+        componentKind: z.ZodEnum<{
+            unknown: "unknown";
+            part: "part";
+            "power-symbol": "power-symbol";
+            "power-flag": "power-flag";
+            "net-label": "net-label";
+            "net-port": "net-port";
+            "sheet-frame": "sheet-frame";
+            annotation: "annotation";
+            helper: "helper";
+        }>;
+        bomEligible: z.ZodBoolean;
+        electricalEligible: z.ZodBoolean;
+        rawValue: z.ZodString;
+        value: z.ZodString;
+        rawFootprint: z.ZodString;
+        footprint: z.ZodString;
+        manufacturerPart: z.ZodOptional<z.ZodString>;
+        manufacturer: z.ZodOptional<z.ZodString>;
+        lcsc: z.ZodOptional<z.ZodString>;
+        datasheet: z.ZodOptional<z.ZodString>;
+        deviceName: z.ZodOptional<z.ZodString>;
+        symbolName: z.ZodOptional<z.ZodString>;
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+        rotation: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    nets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        canonicalNetName: z.ZodString;
+        rawNetNames: z.ZodArray<z.ZodString>;
+        kind: z.ZodEnum<{
+            signal: "signal";
+            power: "power";
+            ground: "ground";
+            "power-flag": "power-flag";
+            unnamed: "unnamed";
+        }>;
+        nodes: z.ZodArray<z.ZodObject<{
+            componentRef: z.ZodString;
+            pin: z.ZodString;
+            x: z.ZodOptional<z.ZodNumber>;
+            y: z.ZodOptional<z.ZodNumber>;
+            source: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        normalizationRules: z.ZodArray<z.ZodString>;
+        imported: z.ZodBoolean;
+    }, z.core.$strip>>;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<{
+            info: "info";
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        componentId: z.ZodOptional<z.ZodString>;
+        componentRef: z.ZodOptional<z.ZodString>;
+        netName: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        componentCount: z.ZodNumber;
+        bomComponentCount: z.ZodNumber;
+        electricalComponentCount: z.ZodNumber;
+        netCount: z.ZodNumber;
+        importedComponentCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SchematicModel = z.infer<typeof SchematicModelSchema>;

package/dist/schematic-model/model.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+export const ComponentKindSchema = z.enum([
+    'part',
+    'power-symbol',
+    'power-flag',
+    'net-label',
+    'net-port',
+    'sheet-frame',
+    'annotation',
+    'helper',
+    'unknown',
+]);
+export const SymbolSourceSchema = z.enum(['native', 'imported', 'unknown']);
+export const NetKindSchema = z.enum(['signal', 'power', 'ground', 'power-flag', 'unnamed']);
+export const CanonicalNodeSchema = z.object({
+    componentRef: z.string(),
+    pin: z.string(),
+    x: z.number().optional(),
+    y: z.number().optional(),
+    source: z.string().optional(),
+});
+export const CanonicalNetSchema = z.object({
+    id: z.string().min(1),
+    canonicalNetName: z.string().min(1),
+    rawNetNames: z.array(z.string()).min(1),
+    kind: NetKindSchema,
+    nodes: z.array(CanonicalNodeSchema),
+    normalizationRules: z.array(z.string()),
+    imported: z.boolean(),
+});
+export const CanonicalComponentSchema = z.object({
+    canonicalComponentId: z.string().min(1),
+    runtimePrimitiveId: z.string().optional(),
+    reference: z.string(),
+    rawReference: z.string(),
+    annotated: z.boolean(),
+    unit: z.string().optional(),
+    symbolSource: SymbolSourceSchema,
+    componentKind: ComponentKindSchema,
+    bomEligible: z.boolean(),
+    electricalEligible: z.boolean(),
+    rawValue: z.string(),
+    value: z.string(),
+    rawFootprint: z.string(),
+    footprint: z.string(),
+    manufacturerPart: z.string().optional(),
+    manufacturer: z.string().optional(),
+    lcsc: z.string().optional(),
+    datasheet: z.string().optional(),
+    deviceName: z.string().optional(),
+    symbolName: z.string().optional(),
+    x: z.number().optional(),
+    y: z.number().optional(),
+    rotation: z.number().optional(),
+});
+export const ModelDiagnosticSchema = z.object({
+    code: z.string().min(1),
+    severity: z.enum(['info', 'warning', 'error']),
+    message: z.string().min(1),
+    componentId: z.string().optional(),
+    componentRef: z.string().optional(),
+    netName: z.string().optional(),
+    details: z.record(z.string(), z.unknown()).optional(),
+});
+export const SchematicDocumentSchema = z.object({
+    projectId: z.string().optional(),
+    schematicName: z.string().optional(),
+    pageName: z.string().optional(),
+});
+export const SchematicModelSchema = z.object({
+    schemaVersion: z.literal('schematic-model/v1'),
+    document: SchematicDocumentSchema,
+    components: z.array(CanonicalComponentSchema),
+    nets: z.array(CanonicalNetSchema),
+    diagnostics: z.array(ModelDiagnosticSchema),
+    summary: z.object({
+        componentCount: z.number().int().nonnegative(),
+        bomComponentCount: z.number().int().nonnegative(),
+        electricalComponentCount: z.number().int().nonnegative(),
+        netCount: z.number().int().nonnegative(),
+        importedComponentCount: z.number().int().nonnegative(),
+    }),
+});
+//# sourceMappingURL=model.js.map

package/dist/schematic-model/model.js.map

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