easyeda-mcp-pro 0.3.2 → 0.5.2

package/dist/bom-quality/adapter.js

@@ -0,0 +1,295 @@
+/**
+ * BOM quality — supplier adapter layer.
+ *
+ * Provides a common {@link SupplierAdapter} interface over each vendor
+ * client so quality checks can query any configured supplier uniformly.
+ *
+ * Each adapter:
+ *  - normalises part data into {@link SupplierQueryResult}
+ *  - records a query timestamp for provenance
+ *  - wraps transient errors with an exponential-backoff retry
+ *
+ * @module
+ */
+import { EasyEdaMcpError } from '../schemas/common.js';
+import { getLogger } from '../utils/logger.js';
+// ── Retry helper ───────────────────────────────────────────────────────────
+const RETRY_BASE_MS = 200;
+const RETRY_MAX_MS = 2_000;
+const RETRY_ATTEMPTS = 2;
+async function withRetry(label, fn, logger, attempts = RETRY_ATTEMPTS) {
+    let lastError;
+    for (let i = 0; i <= attempts; i++) {
+        try {
+            return await fn(i);
+        }
+        catch (err) {
+            lastError = err;
+            // Only retry on retryable errors (rate limits, 5xx)
+            const retryable = err instanceof EasyEdaMcpError ? err.retryable === true : true; // unknown errors are not retried
+            if (!retryable || i === attempts) {
+                throw err;
+            }
+            const delay = Math.min(RETRY_BASE_MS * 2 ** i, RETRY_MAX_MS);
+            logger.debug({ delay, attempt: i + 1, label }, 'retrying supplier query');
+            await new Promise((r) => setTimeout(r, delay));
+        }
+    }
+    throw lastError;
+}
+function toLifecycle(raw) {
+    if (typeof raw === 'boolean')
+        return raw ? 'discontinued' : 'active';
+    if (typeof raw === 'string') {
+        const lc = raw.toLowerCase();
+        if (lc === 'active' || lc === 'production')
+            return 'active';
+        if (lc.includes('discon') || lc.includes('obsolete') || lc === 'eol')
+            return 'discontinued';
+    }
+    return 'unknown';
+}
+// ── LCSC adapter ───────────────────────────────────────────────────────────
+export class LcscAdapter {
+    kind = 'lcsc';
+    displayName = 'LCSC';
+    client;
+    logger;
+    constructor(client) {
+        this.client = client;
+        this.logger = getLogger();
+    }
+    isAvailable() {
+        return this.client !== null;
+    }
+    buildFoundResult(detail, now) {
+        const unitPrice = detail.priceBreaks?.[0]?.unitPrice ??
+            (typeof detail.price === 'number'
+                ? detail.price
+                : typeof detail.price === 'string'
+                    ? parseFloat(detail.price)
+                    : undefined);
+        return {
+            supplier: 'lcsc',
+            found: true,
+            lcsc: detail.lcsc,
+            mpn: detail.manufacturer || undefined,
+            manufacturer: detail.manufacturer || undefined,
+            description: detail.description || undefined,
+            lifecycle: detail.discontinued ? 'discontinued' : 'active',
+            stock: detail.stockCount ?? detail.stock ?? 0,
+            unitPrice,
+            currency: 'USD',
+            leadTimeDays: detail.leadTime,
+            queriedAt: now,
+            confidence: 'high',
+        };
+    }
+    async queryPart(identifier) {
+        const client = this.client;
+        if (!client)
+            return null;
+        if (!identifier.lcsc && !identifier.mpn)
+            return null;
+        const lcscCode = identifier.lcsc;
+        if (!lcscCode)
+            return null; // LCSC requires an LCSC code
+        const now = new Date().toISOString();
+        try {
+            const detail = await withRetry(`lcsc.getPartDetail(${lcscCode})`, () => client.getPartDetail(lcscCode), this.logger);
+            if (!detail) {
+                return {
+                    supplier: 'lcsc',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            return this.buildFoundResult(detail, now);
+        }
+        catch (err) {
+            this.logger.warn({ err, lcscCode }, 'lcsc adapter query failed');
+            // Return an "unavailable" result rather than throwing
+            return {
+                supplier: 'lcsc',
+                found: false,
+                lifecycle: 'unknown',
+                stock: 0,
+                queriedAt: now,
+                confidence: 'low',
+            };
+        }
+    }
+}
+// ── Mouser adapter ─────────────────────────────────────────────────────────
+export class MouserAdapter {
+    kind = 'mouser';
+    displayName = 'Mouser';
+    client;
+    logger;
+    constructor(client) {
+        this.client = client;
+        this.logger = getLogger();
+    }
+    isAvailable() {
+        return this.client !== null;
+    }
+    buildFoundResult(part, now) {
+        return {
+            supplier: 'mouser',
+            found: true,
+            mpn: part.manufacturer || undefined,
+            manufacturer: part.manufacturer || undefined,
+            description: part.description || undefined,
+            lifecycle: 'active',
+            stock: part.availability ?? 0,
+            unitPrice: part.priceBreaks?.[0]?.price,
+            currency: 'USD',
+            leadTimeDays: part.leadTime ? parseInt(part.leadTime, 10) || undefined : undefined,
+            queriedAt: now,
+            confidence: 'high',
+        };
+    }
+    async queryPart(identifier) {
+        const client = this.client;
+        if (!client)
+            return null;
+        const mpn = identifier.mpn;
+        if (!mpn)
+            return null; // Mouser requires an MPN
+        const now = new Date().toISOString();
+        try {
+            const results = await withRetry(`mouser.searchByPartNumber(${mpn})`, () => client.searchByPartNumber(mpn), this.logger);
+            if (!results || results.length === 0) {
+                return {
+                    supplier: 'mouser',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            const part = results[0];
+            if (!part) {
+                return {
+                    supplier: 'mouser',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            return this.buildFoundResult(part, now);
+        }
+        catch (err) {
+            this.logger.warn({ err, mpn }, 'mouser adapter query failed');
+            return {
+                supplier: 'mouser',
+                found: false,
+                lifecycle: 'unknown',
+                stock: 0,
+                queriedAt: now,
+                confidence: 'low',
+            };
+        }
+    }
+}
+// ── DigiKey adapter ────────────────────────────────────────────────────────
+export class DigiKeyAdapter {
+    kind = 'digikey';
+    displayName = 'DigiKey';
+    client;
+    logger;
+    constructor(client) {
+        this.client = client;
+        this.logger = getLogger();
+    }
+    isAvailable() {
+        return this.client !== null;
+    }
+    buildFoundResult(part, mpn, now) {
+        return {
+            supplier: 'digikey',
+            found: true,
+            mpn: part.manufacturerPartNumber || undefined,
+            manufacturer: part.manufacturer || undefined,
+            description: part.description || undefined,
+            lifecycle: toLifecycle(part.rohsStatus), // RoHS active is a loose proxy
+            stock: part.quantityAvailable ?? 0,
+            unitPrice: part.unitPrice || undefined,
+            currency: 'USD',
+            queriedAt: now,
+            confidence: part.manufacturerPartNumber?.toLowerCase() === mpn.toLowerCase() ? 'high' : 'medium',
+        };
+    }
+    async queryPart(identifier) {
+        const client = this.client;
+        if (!client)
+            return null;
+        const mpn = identifier.mpn;
+        if (!mpn)
+            return null; // DigiKey requires MPN or keyword
+        const now = new Date().toISOString();
+        try {
+            // Use keyword search as a proxy — DigiKey doesn't expose a
+            // direct MPN-lookup endpoint in the current client.
+            const results = await withRetry(`digikey.searchByKeyword(${mpn})`, () => client.searchByKeyword(mpn), this.logger);
+            if (!results || results.length === 0) {
+                return {
+                    supplier: 'digikey',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            // Take the first result — keyword search returns best match first
+            const part = results[0];
+            if (!part) {
+                return {
+                    supplier: 'digikey',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            return this.buildFoundResult(part, mpn, now);
+        }
+        catch (err) {
+            this.logger.warn({ err, mpn }, 'digikey adapter query failed');
+            return {
+                supplier: 'digikey',
+                found: false,
+                lifecycle: 'unknown',
+                stock: 0,
+                queriedAt: now,
+                confidence: 'low',
+            };
+        }
+    }
+}
+/**
+ * Build the adapter map from a ToolContext vendors object.
+ * Each adapter wraps the corresponding vendor client (or null if disabled).
+ */
+export function createAdapters(vendors) {
+    return {
+        lcsc: new LcscAdapter(vendors.lcsc),
+        mouser: new MouserAdapter(vendors.mouser),
+        digikey: new DigiKeyAdapter(vendors.digikey),
+    };
+}
+/**
+ * Return the subset of adapters that are currently configured / available.
+ */
+export function availableAdapters(adapters) {
+    return Object.values(adapters).filter((a) => a.isAvailable());
+}
+//# sourceMappingURL=adapter.js.map

package/dist/bom-quality/adapter.js.map

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

package/dist/bom-quality/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * BOM quality — public API barrel.
+ *
+ * @module
+ */
+export type { SupplierKind, PartLifecycle, BomEntry, SupplierQueryResult, BomQualityIssueType, BomQualityIssue, BomQualityReport, BomQualityConfig, } from './types.js';
+export { DEFAULT_BOM_QUALITY_CONFIG } from './types.js';
+export type { SupplierAdapter, AdapterMap } from './adapter.js';
+export { LcscAdapter, MouserAdapter, DigiKeyAdapter, createAdapters, availableAdapters, } from './adapter.js';
+export { generateBomQualityReport } from './quality.js';

package/dist/bom-quality/index.js

@@ -0,0 +1,9 @@
+/**
+ * BOM quality — public API barrel.
+ *
+ * @module
+ */
+export { DEFAULT_BOM_QUALITY_CONFIG } from './types.js';
+export { LcscAdapter, MouserAdapter, DigiKeyAdapter, createAdapters, availableAdapters, } from './adapter.js';
+export { generateBomQualityReport } from './quality.js';
+//# sourceMappingURL=index.js.map

package/dist/bom-quality/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bom-quality/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}

package/dist/bom-quality/quality.d.ts

@@ -0,0 +1,28 @@
+/**
+ * BOM quality — report generation.
+ *
+ * Analyses BOM entries against supplier data to surface issues:
+ *  1. **Unavailable** — part not found or discontinued at any supplier.
+ *  2. **Single-source** — part found at exactly one supplier.
+ *  3. **Missing MPN** — no manufacturer part number.
+ *  4. **Missing footprint** — no package / footprint.
+ *  5. **Low stock** — stock below threshold at every supplier.
+ *
+ * @module
+ */
+import type { BomEntry, BomQualityReport, BomQualityConfig } from './types.js';
+import type { AdapterMap } from './adapter.js';
+/**
+ * Generate a BOM quality report for the given entries.
+ *
+ * For each entry the function:
+ *  1. Queries every available supplier that can handle the entry.
+ *  2. Collects supplier results (with error resilience).
+ *  3. Runs the five quality checks.
+ *  4. Returns a structured report with a summary.
+ *
+ * Supplier failures are caught gracefully — the report always succeeds
+ * (non-null), with `hasSupplierErrors` set to `true` and any affected
+ * entries marked via their issues.
+ */
+export declare function generateBomQualityReport(bomId: string, entries: BomEntry[], adapters: AdapterMap, config?: BomQualityConfig): Promise<BomQualityReport>;

package/dist/bom-quality/quality.js

@@ -0,0 +1,179 @@
+/**
+ * BOM quality — report generation.
+ *
+ * Analyses BOM entries against supplier data to surface issues:
+ *  1. **Unavailable** — part not found or discontinued at any supplier.
+ *  2. **Single-source** — part found at exactly one supplier.
+ *  3. **Missing MPN** — no manufacturer part number.
+ *  4. **Missing footprint** — no package / footprint.
+ *  5. **Low stock** — stock below threshold at every supplier.
+ *
+ * @module
+ */
+import { DEFAULT_BOM_QUALITY_CONFIG } from './types.js';
+import { availableAdapters } from './adapter.js';
+import { getLogger } from '../utils/logger.js';
+// ── Issue factory ──────────────────────────────────────────────────────────
+function issue(type, severity, reference, message, details) {
+    return { type, severity, reference, message, details };
+}
+function unavailableIssue(ref, supplier, reason) {
+    return issue('unavailable', 'error', ref, `Part not available at ${supplier}: ${reason}`, {
+        supplier,
+        reason,
+    });
+}
+function singleSourceIssue(ref, suppliers) {
+    return issue('single_source', 'warning', ref, `Part is single-sourced (only found at ${suppliers.join(', ')})`, { suppliers });
+}
+function missingMpnIssue(ref) {
+    return issue('missing_mpn', 'warning', ref, 'No manufacturer part number (MPN) specified — replaceability is limited');
+}
+function missingFootprintIssue(ref) {
+    return issue('missing_footprint', 'warning', ref, 'No footprint / package specified — PCB layout verification is not possible');
+}
+function lowStockIssue(ref, supplier, stock) {
+    return issue('low_stock', 'warning', ref, `Low stock at ${supplier}: ${stock} units`, {
+        supplier,
+        stock,
+    });
+}
+// ── Supplier query scope ───────────────────────────────────────────────────
+/**
+ * Determine which supplier identifiers to query based on what the entry has.
+ * - If an LCSC code is present, query LCSC.
+ * - If an MPN is present, query Mouser and DigiKey.
+ */
+function queryTargets(entry) {
+    const targets = [];
+    if (entry.lcsc) {
+        targets.push({ supplier: 'lcsc', identifier: { lcsc: entry.lcsc } });
+    }
+    if (entry.mpn) {
+        targets.push({ supplier: 'mouser', identifier: { mpn: entry.mpn } });
+        targets.push({ supplier: 'digikey', identifier: { mpn: entry.mpn } });
+    }
+    return targets;
+}
+// ── Supplier query helper ────────────────────────────────────────────────
+async function querySuppliersForEntry(entry, adapterByKind, _logger) {
+    const targets = queryTargets(entry);
+    const supplierData = [];
+    let hasErrors = false;
+    for (const target of targets) {
+        const adapter = adapterByKind.get(target.supplier);
+        if (!adapter)
+            continue;
+        try {
+            const result = await adapter.queryPart(target.identifier);
+            if (result) {
+                supplierData.push(result);
+                if (result.confidence === 'low')
+                    hasErrors = true;
+            }
+        }
+        catch {
+            // Should not happen (adapters catch internally), but safeguard
+            hasErrors = true;
+        }
+    }
+    return { supplierData, hasErrors, queriedCount: targets.length };
+}
+// ── Main entry point ───────────────────────────────────────────────────────
+/**
+ * Generate a BOM quality report for the given entries.
+ *
+ * For each entry the function:
+ *  1. Queries every available supplier that can handle the entry.
+ *  2. Collects supplier results (with error resilience).
+ *  3. Runs the five quality checks.
+ *  4. Returns a structured report with a summary.
+ *
+ * Supplier failures are caught gracefully — the report always succeeds
+ * (non-null), with `hasSupplierErrors` set to `true` and any affected
+ * entries marked via their issues.
+ */
+export async function generateBomQualityReport(bomId, entries, adapters, config = DEFAULT_BOM_QUALITY_CONFIG) {
+    const now = new Date().toISOString();
+    let hasSupplierErrors = false;
+    // Resolve available adapters once
+    const adapterList = availableAdapters(adapters);
+    const adapterByKind = new Map(adapterList.map((a) => [a.kind, a]));
+    const logger = getLogger();
+    const reportEntries = await Promise.all(entries.map(async (entry) => {
+        // ── 1. Query applicable suppliers ──────────────────────────────────
+        const { supplierData, hasErrors, queriedCount } = await querySuppliersForEntry(entry, adapterByKind, logger);
+        if (hasErrors)
+            hasSupplierErrors = true;
+        // ── 2. Run quality checks ──────────────────────────────────────────
+        const issues = [];
+        // Check: unavailable (not found or discontinued at any queried supplier)
+        const foundSuppliers = supplierData.filter((s) => s.found);
+        const discontinuedSuppliers = supplierData.filter((s) => s.found && s.lifecycle === 'discontinued');
+        if (supplierData.length > 0 && foundSuppliers.length === 0) {
+            // Queried at least one supplier, none had it
+            const queried = supplierData.map((s) => s.supplier).join(', ');
+            issues.push(unavailableIssue(entry.reference, queried, 'not found at any supplier'));
+        }
+        for (const ds of discontinuedSuppliers) {
+            issues.push(unavailableIssue(entry.reference, ds.supplier, 'discontinued / obsolete'));
+        }
+        // Check: single-source
+        const uniqueFoundSuppliers = [...new Set(foundSuppliers.map((s) => s.supplier))];
+        if (uniqueFoundSuppliers.length === 1 && queriedCount > 1) {
+            // Only flag single-source when we actually queried more than one supplier
+            // (i.e. the entry had identifiers for multiple suppliers)
+            issues.push(singleSourceIssue(entry.reference, uniqueFoundSuppliers));
+        }
+        // Check: missing MPN
+        if (config.requireMpn && !entry.mpn && !entry.manufacturer) {
+            issues.push(missingMpnIssue(entry.reference));
+        }
+        // Check: missing footprint
+        if (config.requireFootprint && !entry.footprint) {
+            issues.push(missingFootprintIssue(entry.reference));
+        }
+        // Check: low stock (at every found supplier)
+        if (foundSuppliers.length > 0) {
+            const allLow = foundSuppliers.every((s) => s.stock < config.lowStockThreshold);
+            if (allLow) {
+                for (const fs of foundSuppliers) {
+                    issues.push(lowStockIssue(entry.reference, fs.supplier, fs.stock));
+                }
+            }
+        }
+        return {
+            reference: entry.reference,
+            description: entry.value ?? '',
+            footprint: entry.footprint ?? '',
+            quantity: entry.quantity,
+            lcsc: entry.lcsc,
+            mpn: entry.mpn,
+            manufacturer: entry.manufacturer,
+            supplierData,
+            issues,
+        };
+    }));
+    // ── 3. Aggregate summary ────────────────────────────────────────────────
+    const allIssues = reportEntries.flatMap((e) => e.issues);
+    const summary = {
+        totalIssues: allIssues.length,
+        errors: allIssues.filter((i) => i.severity === 'error').length,
+        warnings: allIssues.filter((i) => i.severity === 'warning').length,
+        info: allIssues.filter((i) => i.severity === 'info').length,
+        unavailableCount: allIssues.filter((i) => i.type === 'unavailable').length,
+        singleSourceCount: allIssues.filter((i) => i.type === 'single_source').length,
+        missingMpnCount: allIssues.filter((i) => i.type === 'missing_mpn').length,
+        missingFootprintCount: allIssues.filter((i) => i.type === 'missing_footprint').length,
+        lowStockCount: allIssues.filter((i) => i.type === 'low_stock').length,
+    };
+    return {
+        bomId,
+        generatedAt: now,
+        totalEntries: entries.length,
+        entries: reportEntries,
+        summary,
+        hasSupplierErrors,
+    };
+}
+//# sourceMappingURL=quality.js.map

package/dist/bom-quality/quality.js.map

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

package/dist/bom-quality/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * BOM quality — core type definitions.
+ *
+ * @module
+ */
+/** Supported supplier identifiers. */
+export type SupplierKind = 'lcsc' | 'mouser' | 'digikey' | 'jlcpcb';
+/** Lifecycle / status of a part at a supplier. */
+export type PartLifecycle = 'active' | 'discontinued' | 'unknown';
+/** BOM entry as passed to quality check, extended with metadata. */
+export interface BomEntry {
+    reference: string;
+    value?: string;
+    footprint?: string;
+    lcsc?: string;
+    mpn?: string;
+    manufacturer?: string;
+    quantity: number;
+    /** Source of this entry (e.g. 'bridge', 'manual'). */
+    source: string;
+    /** ISO-8601 timestamp when this entry was obtained. */
+    fetchedAt: string;
+}
+/** Normalised result from a single supplier query. */
+export interface SupplierQueryResult {
+    supplier: SupplierKind;
+    found: boolean;
+    lcsc?: string;
+    mpn?: string;
+    manufacturer?: string;
+    description?: string;
+    lifecycle: PartLifecycle;
+    stock: number;
+    unitPrice?: number;
+    currency?: string;
+    leadTimeDays?: number;
+    /** ISO-8601 timestamp of this supplier response. */
+    queriedAt: string;
+    /** Human-readable confidence (e.g. 'high', 'medium', 'low'). */
+    confidence: 'high' | 'medium' | 'low';
+}
+/** Issue type identifiers for the BOM quality report. */
+export type BomQualityIssueType = 'unavailable' | 'single_source' | 'missing_mpn' | 'missing_footprint' | 'low_stock';
+/** A single quality issue found for a BOM entry. */
+export interface BomQualityIssue {
+    type: BomQualityIssueType;
+    severity: 'error' | 'warning' | 'info';
+    reference: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/** Complete BOM quality report. */
+export interface BomQualityReport {
+    bomId: string;
+    generatedAt: string;
+    totalEntries: number;
+    entries: Array<{
+        reference: string;
+        description: string;
+        footprint: string;
+        quantity: number;
+        lcsc?: string;
+        mpn?: string;
+        manufacturer?: string;
+        /** Supplier-specific data collected during the check. */
+        supplierData: SupplierQueryResult[];
+        issues: BomQualityIssue[];
+    }>;
+    summary: {
+        totalIssues: number;
+        errors: number;
+        warnings: number;
+        info: number;
+        unavailableCount: number;
+        singleSourceCount: number;
+        missingMpnCount: number;
+        missingFootprintCount: number;
+        lowStockCount: number;
+    };
+    /** Whether any suppliers returned errors during the check. */
+    hasSupplierErrors: boolean;
+}
+/** Configuration for BOM quality checking. */
+export interface BomQualityConfig {
+    /** Stock threshold below which a part is considered low-stock. */
+    lowStockThreshold: number;
+    /** Whether to treat a missing LCSC code as an error. */
+    requireLcsc: boolean;
+    /** Whether to treat a missing MPN as a warning. */
+    requireMpn: boolean;
+    /** Whether to treat a missing footprint as a warning. */
+    requireFootprint: boolean;
+}
+export declare const DEFAULT_BOM_QUALITY_CONFIG: BomQualityConfig;

package/dist/bom-quality/types.js

@@ -0,0 +1,12 @@
+/**
+ * BOM quality — core type definitions.
+ *
+ * @module
+ */
+export const DEFAULT_BOM_QUALITY_CONFIG = {
+    lowStockThreshold: 100,
+    requireLcsc: false,
+    requireMpn: true,
+    requireFootprint: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/bom-quality/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bom-quality/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuGH,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,iBAAiB,EAAE,GAAG;IACtB,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,IAAI;IAChB,gBAAgB,EAAE,IAAI;CACvB,CAAC"}