copperhead 0.8.1 → 0.10.0

package/dist/kicad/score.js

@@ -0,0 +1,261 @@
+import { readSheetGeometry } from './sexp.js';
+import { checkLegibility } from './legibility.js';
+const DEFAULT_WEIGHTS = {
+    'wire-crossings': 10,
+    'wire-bends': 5,
+    'wire-length': 5,
+    'label-to-wire-ratio': 5,
+    'group-cohesion': 10,
+    'flow-direction': 10,
+    utilization: 10,
+    'axis-alignment': 10,
+    'spacing-uniformity': 10,
+    'straight-wire-ratio': 5,
+    'label-alignment': 5,
+    'whitespace-balance': 10,
+    'pair-symmetry': 5,
+};
+/** Composite is capped this far below the Tier A floor when errors exist. */
+const DEFAULT_FLOOR = 85;
+const ERROR_CAP = 40;
+/** Top-edge spread (mm) within which two group boxes count as the same row. */
+const ROW_BAND = 12;
+const PAPER = {
+    A5: { w: 210, h: 148 },
+    A4: { w: 297, h: 210 },
+    A3: { w: 420, h: 297 },
+    A2: { w: 594, h: 420 },
+    A1: { w: 841, h: 594 },
+    A0: { w: 1189, h: 841 },
+};
+const segLen = (s) => Math.hypot(s.x2 - s.x1, s.y2 - s.y1);
+const isVert = (s) => s.x1 === s.x2;
+function properCrossing(a, b) {
+    // orthogonal proper crossing (interiors intersect); shared endpoints are joins
+    const [v, h] = isVert(a) && !isVert(b) ? [a, b] : !isVert(a) && isVert(b) ? [b, a] : [null, null];
+    if (!v || !h)
+        return false;
+    const [hy, vx] = [h.y1, v.x1];
+    const [hx1, hx2] = [Math.min(h.x1, h.x2), Math.max(h.x1, h.x2)];
+    const [vy1, vy2] = [Math.min(v.y1, v.y2), Math.max(v.y1, v.y2)];
+    return vx > hx1 + 0.01 && vx < hx2 - 0.01 && hy > vy1 + 0.01 && hy < vy2 - 0.01;
+}
+export async function scoreSchematic(rootSch, opts = {}) {
+    const sheets = await readSheetGeometry(rootSch);
+    const legibility = await checkLegibility(rootSch, {
+        docsDir: opts.docsDir ?? null,
+        ...(opts.config ? { config: opts.config } : {}),
+    });
+    return scoreFromGeometry(sheets, legibility, opts.config);
+}
+export function scoreFromGeometry(sheets, legibility, config) {
+    const weights = { ...DEFAULT_WEIGHTS };
+    for (const [k, v] of Object.entries(config?.score?.weights ?? {})) {
+        if (k in weights && typeof v === 'number' && Number.isFinite(v) && v >= 0)
+            weights[k] = v;
+    }
+    // Sanitized like the weights above: a floor of 0 (or a non-number) would
+    // push the error cap `min(ERROR_CAP, floor - 1)` negative or NaN.
+    const rawFloor = config?.score?.floor;
+    const floor = typeof rawFloor === 'number' && Number.isFinite(rawFloor) && rawFloor >= 1 ? rawFloor : DEFAULT_FLOOR;
+    // ---- collect geometry across sheets ----
+    const segs = sheets.flatMap((s) => s.wires);
+    const labels = sheets.flatMap((s) => s.labels);
+    const realSyms = sheets.flatMap((s) => s.symbols.filter((y) => !y.isPower).map((y) => ({ ...y, sheet: s.sheetName })));
+    // wire crossings
+    let crossings = 0;
+    for (let i = 0; i < segs.length; i++) {
+        for (let j = i + 1; j < segs.length; j++)
+            if (properCrossing(segs[i], segs[j]))
+                crossings++;
+    }
+    // bends: points where exactly two segments of different orientation meet
+    const ends = new Map();
+    for (const s of segs) {
+        for (const [x, y] of [[s.x1, s.y1], [s.x2, s.y2]]) {
+            const k = `${x},${y}`;
+            ends.set(k, [...(ends.get(k) ?? []), s]);
+        }
+    }
+    let bends = 0;
+    for (const list of ends.values()) {
+        if (list.length === 2 && isVert(list[0]) !== isVert(list[1]))
+            bends++;
+    }
+    const totalLen = segs.reduce((s, w) => s + segLen(w), 0);
+    // group cohesion: same-name label pairs, mean anchor distance vs sheet diagonal
+    const byName = new Map();
+    for (const l of labels)
+        byName.set(l.name, [...(byName.get(l.name) ?? []), { x: l.x, y: l.y }]);
+    const paper = PAPER[sheets[0]?.paper.name ?? 'A4'] ?? PAPER.A4;
+    const diag = Math.hypot(paper.w, paper.h);
+    const pairDists = [];
+    for (const pts of byName.values()) {
+        for (let i = 0; i < pts.length; i++) {
+            for (let j = i + 1; j < pts.length; j++)
+                pairDists.push(Math.hypot(pts[i].x - pts[j].x, pts[i].y - pts[j].y));
+        }
+    }
+    const meanPair = pairDists.length ? pairDists.reduce((a, b) => a + b, 0) / pairDists.length : 0;
+    // flow-direction: cross-group label nets should connect adjacent groups in
+    // reading order; a hop across intervening groups reads as against-the-flow
+    // wiring
+    const rects = sheets.flatMap((s) => s.rectangles.map((r) => ({
+        minX: Math.min(r.x1, r.x2),
+        maxX: Math.max(r.x1, r.x2),
+        minY: Math.min(r.y1, r.y2),
+        maxY: Math.max(r.y1, r.y2),
+    })));
+    // Reading order is rows first, then left-to-right within a row. Ordering by
+    // minX alone was correct only while every group sat in one band; on a sheet
+    // whose groups wrap onto several rows it interleaves row 2 back into row 1
+    // and reports flow violations for a drawing that reads perfectly.
+    const byRow = [...rects].sort((a, b) => a.minY - b.minY || a.minX - b.minX);
+    const rows = [];
+    for (const r of byRow) {
+        const row = rows[rows.length - 1];
+        // Rows are separated by a group box height; members of one row share a top
+        // edge to within a symbol cell, so a generous band still cannot merge two.
+        if (row && r.minY - row[0].minY <= ROW_BAND)
+            row.push(r);
+        else
+            rows.push([r]);
+    }
+    const ordered = rows.flatMap((row) => [...row].sort((a, b) => a.minX - b.minX));
+    const groupIdx = (x, y) => ordered.findIndex((r) => x > r.minX && x < r.maxX && y > r.minY && y < r.maxY);
+    /** Which wrapped row a point falls in; -1 when it is in no group box. */
+    const rowIdx = (x, y) => rows.findIndex((row) => row.some((r) => x > r.minX && x < r.maxX && y > r.minY && y < r.maxY));
+    let crossNets = 0;
+    let flowViolations = 0;
+    for (const pts of byName.values()) {
+        const gs = [...new Set(pts.map((p) => groupIdx(p.x, p.y)).filter((g) => g >= 0))];
+        if (gs.length > 1) {
+            crossNets++;
+            if (Math.max(...gs) - Math.min(...gs) > 1)
+                flowViolations++;
+        }
+    }
+    // utilization + whitespace balance over the first sheet's usable frame
+    const items = [
+        ...realSyms.map((s) => ({ minX: s.at.x - 2, minY: s.at.y - 2, maxX: s.at.x + 2, maxY: s.at.y + 2 })),
+        ...rects,
+    ];
+    const content = items.length
+        ? items.reduce((a, b) => ({
+            minX: Math.min(a.minX, b.minX),
+            minY: Math.min(a.minY, b.minY),
+            maxX: Math.max(a.maxX, b.maxX),
+            maxY: Math.max(a.maxY, b.maxY),
+        }))
+        : null;
+    const usable = { minX: 10, minY: 10, maxX: paper.w - 10, maxY: paper.h - 10 - 30 };
+    const usableArea = (usable.maxX - usable.minX) * (usable.maxY - usable.minY);
+    const utilization = content
+        ? Math.min(1, ((content.maxX - content.minX) * (content.maxY - content.minY)) / usableArea)
+        : 0;
+    const centroidOff = content
+        ? Math.hypot((content.minX + content.maxX) / 2 - (usable.minX + usable.maxX) / 2, (content.minY + content.maxY) / 2 - (usable.minY + usable.maxY) / 2) / (diag / 2)
+        : 1;
+    // axis alignment: symbols sharing an origin axis with at least one other
+    const sharesAxis = (i) => realSyms.some((o, j) => j !== i && (Math.abs(o.at.x - realSyms[i].at.x) < 0.01 || Math.abs(o.at.y - realSyms[i].at.y) < 0.01));
+    const axisAligned = realSyms.length > 1 ? realSyms.filter((_, i) => sharesAxis(i)).length / realSyms.length : 1;
+    // spacing uniformity: variance of consecutive gaps within shared-x columns
+    const cols = new Map();
+    for (const s of realSyms) {
+        // Keyed by row as well as x: a column is a vertical run the eye reads as
+        // one stack. Once groups wrap, two symbols in different rows can share an x
+        // while sitting a whole row apart, and treating that jump as a "gap" pushes
+        // the coefficient of variation — and the score — off a cliff.
+        const k = `${s.sheet}:${Math.round(s.at.x * 100)}:${rowIdx(s.at.x, s.at.y)}`;
+        cols.set(k, [...(cols.get(k) ?? []), s.at.y]);
+    }
+    const gapCVs = [];
+    for (const ys of cols.values()) {
+        if (ys.length < 3)
+            continue;
+        ys.sort((a, b) => a - b);
+        const gaps = ys.slice(1).map((y, i) => y - ys[i]);
+        const mean = gaps.reduce((a, b) => a + b, 0) / gaps.length;
+        const sd = Math.sqrt(gaps.reduce((a, g) => a + (g - mean) ** 2, 0) / gaps.length);
+        gapCVs.push(mean > 0 ? sd / mean : 0);
+    }
+    const spacingUniformity = gapCVs.length ? Math.max(0, 1 - gapCVs.reduce((a, b) => a + b, 0) / gapCVs.length) : 1;
+    // pair symmetry: same-libId+value symbols in one group aligned on a shared axis
+    const pairKeys = new Map();
+    for (const s of realSyms) {
+        const g = groupIdx(s.at.x, s.at.y);
+        const k = `${g}:${s.libId}:${s.value}`;
+        pairKeys.set(k, [...(pairKeys.get(k) ?? []), { x: s.at.x, y: s.at.y }]);
+    }
+    let pairs = 0;
+    let symmetric = 0;
+    for (const pts of pairKeys.values()) {
+        if (pts.length < 2)
+            continue;
+        for (let i = 0; i < pts.length; i++) {
+            for (let j = i + 1; j < pts.length; j++) {
+                pairs++;
+                if (Math.abs(pts[i].x - pts[j].x) < 0.01 || Math.abs(pts[i].y - pts[j].y) < 0.01)
+                    symmetric++;
+            }
+        }
+    }
+    const pairSymmetry = pairs ? symmetric / pairs : 1;
+    const horizLabels = labels.length
+        ? labels.filter((l) => Math.abs(l.rot % 180) !== 90).length / labels.length
+        : 1;
+    const straightRatio = segs.length ? Math.max(0, 1 - bends / segs.length) : 1;
+    const labelRatio = segs.length ? labels.length / segs.length : labels.length ? 1 : 0;
+    // ---- normalize to [0,1] goodness and compose ----
+    const raw = {
+        'wire-crossings': { raw: crossings, score: 1 / (1 + crossings) },
+        'wire-bends': { raw: bends, score: 1 / (1 + bends / 8) },
+        'wire-length': { raw: totalLen, score: 1 / (1 + totalLen / (4 * diag)) },
+        'label-to-wire-ratio': { raw: labelRatio, score: labelRatio <= 1.5 ? 1 : 1.5 / labelRatio },
+        'group-cohesion': { raw: meanPair, score: pairDists.length ? Math.max(0, 1 - meanPair / diag) : 1 },
+        'flow-direction': { raw: flowViolations, score: crossNets ? 1 - flowViolations / crossNets : 1 },
+        utilization: { raw: utilization, score: Math.min(1, utilization / 0.5) },
+        'axis-alignment': { raw: axisAligned, score: axisAligned },
+        'spacing-uniformity': { raw: spacingUniformity, score: spacingUniformity },
+        'straight-wire-ratio': { raw: straightRatio, score: straightRatio },
+        'label-alignment': { raw: horizLabels, score: horizLabels },
+        'whitespace-balance': { raw: centroidOff, score: Math.max(0, 1 - centroidOff) },
+        'pair-symmetry': { raw: pairSymmetry, score: pairSymmetry },
+    };
+    const totalWeight = Object.values(weights).reduce((a, b) => a + b, 0) || 1;
+    const metrics = Object.entries(raw).map(([name, m]) => ({
+        name,
+        raw: m.raw,
+        score: m.score,
+        weight: weights[name],
+        contribution: (100 * weights[name] * m.score) / totalWeight,
+    }));
+    let composite = metrics.reduce((a, m) => a + m.contribution, 0);
+    let cap = null;
+    if (legibility.counts.error > 0) {
+        const capValue = Math.min(ERROR_CAP, floor - 1);
+        if (composite > capValue) {
+            cap = {
+                appliedAt: capValue,
+                reason: `${legibility.counts.error} error-severity legibility finding(s) cap the composite below the known-good floor (${floor})`,
+            };
+            composite = capValue;
+        }
+    }
+    return {
+        composite: Math.round(composite * 100) / 100,
+        metrics,
+        cap,
+        legibility: legibility.counts,
+    };
+}
+export function formatScore(report) {
+    const lines = [`score: ${report.composite}/100`];
+    if (report.cap)
+        lines.push(`  cap: ${report.cap.appliedAt} — ${report.cap.reason}`);
+    for (const m of report.metrics) {
+        lines.push(`  ${m.name}: raw ${Math.round(m.raw * 10000) / 10000}, score ${Math.round(m.score * 1000) / 1000}, weight ${m.weight}, contributes ${Math.round(m.contribution * 100) / 100}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=score.js.map

package/dist/kicad/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/kicad/score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAmC,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAyB,MAAM,iBAAiB,CAAC;AA+BzE,MAAM,eAAe,GAA2B;IAC9C,gBAAgB,EAAE,EAAE;IACpB,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,CAAC;IAChB,qBAAqB,EAAE,CAAC;IACxB,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,EAAE;IACpB,WAAW,EAAE,EAAE;IACf,gBAAgB,EAAE,EAAE;IACpB,oBAAoB,EAAE,EAAE;IACxB,qBAAqB,EAAE,CAAC;IACxB,iBAAiB,EAAE,CAAC;IACpB,oBAAoB,EAAE,EAAE;IACxB,eAAe,EAAE,CAAC;CACnB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,+EAA+E;AAC/E,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB,MAAM,KAAK,GAA6C;IACtD,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;IACtB,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;IACtB,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;IACtB,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;IACtB,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;IACtB,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE;CACxB,CAAC;AASF,MAAM,MAAM,GAAG,CAAC,CAAM,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;AACxE,MAAM,MAAM,GAAG,CAAC,CAAM,EAAW,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;AAElD,SAAS,cAAc,CAAC,CAAM,EAAE,CAAM;IACpC,+EAA+E;IAC/E,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC;AAClF,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,OAAqB,EAAE;IAC3E,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE;QAChD,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,OAAO,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAuB,EACvB,UAA4B,EAC5B,MAA6B;IAE7B,MAAM,OAAO,GAAG,EAAE,GAAG,eAAe,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5F,CAAC;IACD,yEAAyE;IACzE,kEAAkE;IAClE,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC;IAEpH,2CAA2C;IAC3C,MAAM,IAAI,GAAU,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACpC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAC/E,CAAC;IAEF,iBAAiB;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,CAAC,CAAE,CAAC;gBAAE,SAAS,EAAE,CAAC;IAChG,CAAC;IAED,yEAAyE;IACzE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAiB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAU,EAAE,CAAC;YAC3D,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;YAAE,KAAK,EAAE,CAAC;IAC1E,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEzD,gFAAgF;IAChF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChG,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAG,CAAC;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhG,2EAA2E;IAC3E,2EAA2E;IAC3E,SAAS;IACT,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAC1B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAC1B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAC1B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;KAC3B,CAAC,CAAC,CAAC,CAAC;IACL,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,kEAAkE;IAClE,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAqB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClC,2EAA2E;QAC3E,2EAA2E;QAC3E,IAAI,GAAG,IAAI,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC,IAAI,IAAI,QAAQ;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;YACrD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAChD,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACjF,yEAAyE;IACzE,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAC9C,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjG,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClB,SAAS,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC;gBAAE,cAAc,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,MAAM,KAAK,GAAa;QACtB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpG,GAAG,KAAK;KACT,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM;QAC1B,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;SAC/B,CAAC,CAAC;QACL,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;IACnF,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,OAAO;QACzB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC;QAC3F,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,WAAW,GAAG,OAAO;QACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CACR,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EACnE,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CACpE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC,CAAC;IAEN,yEAAyE;IACzE,MAAM,UAAU,GAAG,CAAC,CAAS,EAAW,EAAE,CACxC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACnI,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhH,2EAA2E;IAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,yEAAyE;QACzE,4EAA4E;QAC5E,4EAA4E;QAC5E,8DAA8D;QAC9D,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC/B,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC5B,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3D,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAClF,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjH,gFAAgF;IAChF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACvC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,KAAK,EAAE,CAAC;gBACR,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,IAAI;oBAAE,SAAS,EAAE,CAAC;YACpG,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM;QAC/B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;QAC3E,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAErF,oDAAoD;IACpD,MAAM,GAAG,GAAmD;QAC1D,gBAAgB,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE;QAChE,YAAY,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE;QACxD,aAAa,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE;QACxE,qBAAqB,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,UAAU,EAAE;QAC3F,gBAAgB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;QACnG,gBAAgB,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE;QAChG,WAAW,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,GAAG,CAAC,EAAE;QACxE,gBAAgB,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;QAC1D,oBAAoB,EAAE,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE;QAC1E,qBAAqB,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;QACnE,iBAAiB,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;QAC3D,oBAAoB,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE;QAC/E,eAAe,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;KAC5D,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAkB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,IAAI;QACJ,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,OAAO,CAAC,IAAI,CAAE;QACtB,YAAY,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,IAAI,CAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,WAAW;KAC7D,CAAC,CAAC,CAAC;IACJ,IAAI,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAEhE,IAAI,GAAG,GAAuB,IAAI,CAAC;IACnC,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,SAAS,GAAG,QAAQ,EAAE,CAAC;YACzB,GAAG,GAAG;gBACJ,SAAS,EAAE,QAAQ;gBACnB,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,uFAAuF,KAAK,GAAG;aAClI,CAAC;YACF,SAAS,GAAG,QAAQ,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG;QAC5C,OAAO;QACP,GAAG;QACH,UAAU,EAAE,UAAU,CAAC,MAAM;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,MAAM,KAAK,GAAG,CAAC,UAAU,MAAM,CAAC,SAAS,MAAM,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACpF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,CAAC,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,iBAAiB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAC/K,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/kicad/sexp.js

@@ -14,7 +14,11 @@ export function parseSexp(text) {
             let s = '';
             while (j < text.length && text[j] !== '"') {
                 if (text[j] === '\\' && j + 1 < text.length) {
-                    s += text[j + 1];
+                    // KiCad writes multi-line text as `\n` (and tabs as `\t`) inside the
+                    // quoted atom; mapping the escape to the literal letter would give
+                    // the legibility width model a one-line `line1nline2` string.
+                    const e = text[j + 1];
+                    s += e === 'n' ? '\n' : e === 't' ? '\t' : e;
                     j += 2;
                 }
                 else {
@@ -98,7 +102,10 @@ async function loadSheets(rootSch) {
     await load(rootSch, '/');
     return out;
 }
-/** Pin definitions per lib symbol name, in symbol coordinates. */
+/** Pin definitions per lib symbol name, in symbol coordinates. Each pin
+ * carries the unit of the `_<unit>_<style>` child it was defined in (0 for
+ * the common unit); de Morgan alternates (style ≥ 2) are skipped so a pin is
+ * recorded once. */
 function libPinDefs(root) {
     const map = new Map();
     const libs = child(root, 'lib_symbols');
@@ -109,9 +116,17 @@ function libPinDefs(root) {
         if (!name)
             continue;
         const pins = [];
-        const walk = (n) => {
+        const walk = (n, unit) => {
             if (!isList(n))
                 return;
+            if (tag(n) === 'symbol') {
+                const m = /_(\d+)_(\d+)$/.exec(atomAt(n, 1) ?? '');
+                if (m) {
+                    if (Number(m[2]) >= 2)
+                        return; // de Morgan alternate body style
+                    unit = Number(m[1]);
+                }
+            }
             if (tag(n) === 'pin') {
                 const at = child(n, 'at');
                 const num = atomAt(child(n, 'number'), 1);
@@ -122,17 +137,26 @@ function libPinDefs(root) {
                         name: pinName ?? '~',
                         x: parseFloat(atomAt(at, 1) ?? '0'),
                         y: parseFloat(atomAt(at, 2) ?? '0'),
+                        unit,
                     });
                 }
             }
             for (const c of n)
-                walk(c);
+                walk(c, unit);
         };
-        walk(sym);
+        walk(sym, 0);
         map.set(name, pins);
     }
     return map;
 }
+/** The pins a PLACED instance actually shows: its own unit's plus the common
+ * unit's. A single-unit symbol keeps every pin (they are all unit ≤ 1). */
+export function pinsOfUnit(defs, unit) {
+    const multi = defs.some((p) => p.unit >= 2);
+    if (!multi)
+        return defs;
+    return defs.filter((p) => p.unit === 0 || p.unit === unit);
+}
 /** Symbol-space → schematic-space transform (schematic Y grows downward). */
 export function pinAbsolute(symAt, mirror, pin) {
     let px = pin.x;
@@ -189,19 +213,37 @@ function symbolsOf(sheet) {
                     rot: parseFloat(atomAt(at, 3) ?? '0'),
                 },
                 uuid: atomAt(child(s, 'uuid'), 1) ?? '',
+                unit: parseInt(atomAt(child(s, 'unit'), 1) ?? '1', 10) || 1,
             },
         });
     }
     return out;
 }
-const isPowerSymbol = (libId) => libId.startsWith('power:');
+function collectPowerSymbols(sheets) {
+    const set = new Set();
+    for (const sheet of sheets) {
+        const libs = child(sheet.root, 'lib_symbols');
+        if (!libs)
+            continue;
+        for (const sym of children(libs, 'symbol')) {
+            const name = atomAt(sym, 1);
+            const p = child(sym, 'power');
+            if (name && p !== undefined && atomAt(p, 1) !== 'no') {
+                set.add(name);
+            }
+        }
+    }
+    return set;
+}
+const isPowerSymbol = (libId, powerSyms) => libId.startsWith('power:') || powerSyms.has(libId);
 /** One row per real component (power symbols excluded), across all sheets. */
 export async function listSymbols(rootSch) {
     const sheets = await loadSheets(rootSch);
+    const powerSyms = collectPowerSymbols(sheets);
     const out = [];
     for (const sheet of sheets) {
         for (const { sym } of symbolsOf(sheet)) {
-            if (!isPowerSymbol(sym.libId))
+            if (!isPowerSymbol(sym.libId, powerSyms))
                 out.push(sym);
         }
     }
@@ -210,6 +252,7 @@ export async function listSymbols(rootSch) {
 /** All net names visible via labels and power symbols, across all sheets. */
 export async function listNets(rootSch) {
     const sheets = await loadSheets(rootSch);
+    const powerSyms = collectPowerSymbols(sheets);
     const names = new Set();
     for (const sheet of sheets) {
         for (const kind of ['label', 'global_label', 'hierarchical_label']) {
@@ -220,12 +263,217 @@ export async function listNets(rootSch) {
             }
         }
         for (const { sym } of symbolsOf(sheet)) {
-            if (isPowerSymbol(sym.libId))
+            if (isPowerSymbol(sym.libId, powerSyms))
                 names.add(sym.value);
         }
     }
     return [...names].sort();
 }
+const num = (n, idx, fallback = 0) => {
+    const v = atomAt(n, idx);
+    return v === undefined ? fallback : parseFloat(v);
+};
+function effectsOf(node) {
+    const effects = child(node, 'effects');
+    const font = effects ? child(effects, 'font') : undefined;
+    const size = font ? child(font, 'size') : undefined;
+    // hidden: legacy bare `hide` atom, or v9 `(hide yes)`
+    const hideNode = effects ? child(effects, 'hide') : undefined;
+    const hidden = (effects?.some((c) => c === 'hide') ?? false) || (hideNode !== undefined && atomAt(hideNode, 1) !== 'no');
+    return { height: size ? num(size, 1, 1.27) : 1.27, hidden };
+}
+function libBodyBounds(root) {
+    const map = new Map();
+    const libs = child(root, 'lib_symbols');
+    if (!libs)
+        return map;
+    for (const sym of children(libs, 'symbol')) {
+        const name = atomAt(sym, 1);
+        if (!name)
+            continue;
+        /** Union across the whole symbol under `name`, per-unit union (common
+         * graphics included) under `name#<unit>` — a placed unit of a multi-unit
+         * symbol draws only its own unit's graphics, so measuring it with the
+         * package union would size every instance like the whole gate pack. */
+        const perUnit = new Map();
+        let b = null;
+        const grow = (prev, x, y) => {
+            if (!prev)
+                return { minX: x, minY: y, maxX: x, maxY: y };
+            prev.minX = Math.min(prev.minX, x);
+            prev.minY = Math.min(prev.minY, y);
+            prev.maxX = Math.max(prev.maxX, x);
+            prev.maxY = Math.max(prev.maxY, y);
+            return prev;
+        };
+        const walk = (n, unit) => {
+            if (!isList(n))
+                return;
+            const t = tag(n);
+            if (t === 'symbol') {
+                const m = /_(\d+)_(\d+)$/.exec(atomAt(n, 1) ?? '');
+                if (m) {
+                    if (Number(m[2]) >= 2)
+                        return; // de Morgan alternate body style
+                    unit = Number(m[1]);
+                }
+            }
+            const extend = (x, y) => {
+                b = grow(b, x, y);
+                if (unit !== null)
+                    perUnit.set(unit, grow(perUnit.get(unit) ?? null, x, y));
+            };
+            if (t === 'rectangle') {
+                const s = child(n, 'start');
+                const e = child(n, 'end');
+                extend(num(s, 1), num(s, 2));
+                extend(num(e, 1), num(e, 2));
+            }
+            else if (t === 'circle') {
+                const c = child(n, 'center');
+                const r = num(child(n, 'radius'), 1);
+                extend(num(c, 1) - r, num(c, 2) - r);
+                extend(num(c, 1) + r, num(c, 2) + r);
+            }
+            else if (t === 'arc') {
+                for (const part of ['start', 'mid', 'end']) {
+                    const p = child(n, part);
+                    if (p)
+                        extend(num(p, 1), num(p, 2));
+                }
+            }
+            else if (t === 'polyline') {
+                for (const xy of children(child(n, 'pts') ?? [], 'xy'))
+                    extend(num(xy, 1), num(xy, 2));
+            }
+            // pin/text graphics are deliberately excluded from the body box (design C2)
+            if (t !== 'pin' && t !== 'text')
+                for (const c of n)
+                    walk(c, unit);
+        };
+        walk(sym, null);
+        map.set(name, b);
+        const common = perUnit.get(0) ?? null;
+        for (const [unit, ub] of perUnit) {
+            if (unit === 0)
+                continue;
+            const merged = ub && common
+                ? {
+                    minX: Math.min(ub.minX, common.minX),
+                    minY: Math.min(ub.minY, common.minY),
+                    maxX: Math.max(ub.maxX, common.maxX),
+                    maxY: Math.max(ub.maxY, common.maxY),
+                }
+                : (ub ?? (common ? { ...common } : null));
+            map.set(`${name}#${unit}`, merged);
+        }
+    }
+    return map;
+}
+function textItemsOf(sym) {
+    const out = [];
+    for (const p of children(sym, 'property')) {
+        const key = atomAt(p, 1);
+        if (key !== 'Reference' && key !== 'Value')
+            continue;
+        const at = child(p, 'at');
+        const fx = effectsOf(p);
+        out.push({
+            text: atomAt(p, 2) ?? '',
+            x: num(at, 1),
+            y: num(at, 2),
+            rot: num(at, 3),
+            height: fx.height,
+            hidden: fx.hidden,
+        });
+    }
+    return out;
+}
+/**
+ * Everything the legibility checker needs to see per sheet, extracted read-only.
+ * Never serializes and never mutates the file.
+ */
+export async function readSheetGeometry(rootSch) {
+    const sheets = await loadSheets(rootSch);
+    const powerSyms = collectPowerSymbols(sheets);
+    return sheets.map((sheet) => {
+        const paperNode = child(sheet.root, 'paper');
+        const paperName = atomAt(paperNode, 1) ?? null;
+        const portrait = paperNode?.includes('portrait') ?? false;
+        const explicitW = num(paperNode, 2, NaN);
+        const explicitH = num(paperNode, 3, NaN);
+        const tb = child(sheet.root, 'title_block');
+        const tbField = (name) => (tb ? (atomAt(child(tb, name), 1) ?? '') : '');
+        const wires = [];
+        for (const w of children(sheet.root, 'wire')) {
+            const pts = children(child(w, 'pts') ?? [], 'xy');
+            for (let i = 1; i < pts.length; i++) {
+                wires.push({ x1: num(pts[i - 1], 1), y1: num(pts[i - 1], 2), x2: num(pts[i], 1), y2: num(pts[i], 2) });
+            }
+        }
+        const labels = [];
+        for (const kind of ['label', 'global_label', 'hierarchical_label']) {
+            for (const l of children(sheet.root, kind)) {
+                const at = child(l, 'at');
+                const effects = child(l, 'effects');
+                const justify = effects ? child(effects, 'justify') : undefined;
+                labels.push({
+                    name: atomAt(l, 1) ?? '',
+                    kind,
+                    x: num(at, 1),
+                    y: num(at, 2),
+                    rot: num(at, 3),
+                    height: effectsOf(l).height,
+                    justify: justify?.some((c) => c === 'right') ? 'right' : justify?.some((c) => c === 'left') ? 'left' : null,
+                });
+            }
+        }
+        const texts = children(sheet.root, 'text').map((t) => {
+            const at = child(t, 'at');
+            const fx = effectsOf(t);
+            return { text: atomAt(t, 1) ?? '', x: num(at, 1), y: num(at, 2), rot: num(at, 3), height: fx.height, hidden: fx.hidden };
+        });
+        const rectangles = children(sheet.root, 'rectangle').map((r) => {
+            const s = child(r, 'start');
+            const e = child(r, 'end');
+            const stroke = child(r, 'stroke');
+            return {
+                x1: num(s, 1),
+                y1: num(s, 2),
+                x2: num(e, 1),
+                y2: num(e, 2),
+                strokeType: atomAt(child(stroke ?? [], 'type'), 1) ?? 'default',
+            };
+        });
+        return {
+            filePath: sheet.filePath,
+            sheetName: sheet.sheetName,
+            paper: {
+                name: paperName,
+                width: Number.isNaN(explicitW) ? null : explicitW,
+                height: Number.isNaN(explicitH) ? null : explicitH,
+                portrait,
+            },
+            titleBlock: tb ? { title: tbField('title'), date: tbField('date'), rev: tbField('rev') } : null,
+            symbols: symbolsOf(sheet).map(({ sym, mirror, node }) => ({
+                ref: sym.ref,
+                libId: sym.libId,
+                value: sym.value,
+                at: sym.at,
+                mirror,
+                isPower: isPowerSymbol(sym.libId, powerSyms),
+                unit: sym.unit,
+                props: textItemsOf(node),
+            })),
+            wires,
+            labels,
+            texts,
+            rectangles,
+            libBounds: libBodyBounds(sheet.root),
+            libPins: libPinDefs(sheet.root),
+        };
+    });
+}
 /**
  * Geometric connectivity per sheet: pins, labels, and wire endpoints that share
  * coordinates (or are joined by wires) form a group; a group's net name comes
@@ -234,6 +482,7 @@ export async function listNets(rootSch) {
  */
 export async function pinNets(rootSch) {
     const sheets = await loadSheets(rootSch);
+    const powerSyms = collectPowerSymbols(sheets);
     const out = [];
     for (const sheet of sheets) {
         const pinDefs = libPinDefs(sheet.root);
@@ -261,12 +510,15 @@ export async function pinNets(rootSch) {
         }
         const symPins = [];
         for (const { sym, mirror } of symbolsOf(sheet)) {
-            const defs = pinDefs.get(sym.libId) ?? [];
+            // a placed unit of a multi-unit symbol shows only its own unit's pins;
+            // resolving the whole package at each instance would invent phantom
+            // connection points at every other unit's coordinates
+            const defs = pinsOfUnit(pinDefs.get(sym.libId) ?? [], sym.unit);
             for (const pin of defs) {
                 const abs = pinAbsolute(sym.at, mirror, pin);
                 const k = key(abs.x, abs.y);
                 uf.find(k);
-                if (isPowerSymbol(sym.libId)) {
+                if (isPowerSymbol(sym.libId, powerSyms)) {
                     netNameAt.set(k, sym.value);
                 }
                 else {