driverge-mcp 0.0.0

package/dist/mcp/summary.d.ts

@@ -0,0 +1,2 @@
+import type { CacheEntry } from "./cache.js";
+export declare function buildSummary(entry: CacheEntry): Record<string, unknown>;

package/dist/mcp/summary.js

@@ -0,0 +1,36 @@
+// The compact summary analyze_datasheet returns to the model — NOT the full JSON
+// (that travels by ref via the driverge://datasheet resource). See wiki:
+// parsed-json-handoff-via-handle.
+export function buildSummary(entry) {
+    const { ref, json } = entry;
+    const counts = json.interface.kind === "register_map"
+        ? { registers: json.interface.registers.length }
+        : { commands: json.interface.commands.length };
+    const proto = json.protocol;
+    const protocolSummary = [
+        proto.bus,
+        proto.addresses?.length ? `addresses ${proto.addresses.join("/")}` : undefined,
+        proto.maxClockHz ? `max ${proto.maxClockHz} Hz` : undefined,
+    ]
+        .filter(Boolean)
+        .join(", ");
+    return {
+        ref,
+        metadata: {
+            part_number: json.metadata.part,
+            manufacturer: json.metadata.manufacturer,
+            manufacturer_confidence: json.metadata.manufacturerConfidence,
+            pdf_type: json.metadata.pdfType,
+            page_count: json.metadata.pageCount,
+        },
+        interface: { kind: json.interface.kind },
+        protocol_summary: protocolSummary,
+        counts,
+        validation: {
+            passed: json.validation.valid,
+            warnings: json.validation.warnings,
+            errors: json.validation.errors,
+        },
+    };
+}
+//# sourceMappingURL=summary.js.map

package/dist/mcp/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/mcp/summary.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,yEAAyE;AACzE,kCAAkC;AAIlC,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC5B,MAAM,MAAM,GACV,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,cAAc;QACpC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE;QAChD,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAEnD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC5B,MAAM,eAAe,GAAG;QACtB,KAAK,CAAC,GAAG;QACT,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QAC9E,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,SAAS;KAC5D;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,GAAG;QACH,QAAQ,EAAE;YACR,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YAC/B,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;YACxC,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,sBAAsB;YAC7D,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;YAC/B,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;SACpC;QACD,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;QACxC,gBAAgB,EAAE,eAAe;QACjC,MAAM;QACN,UAAU,EAAE;YACV,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC7B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ;YAClC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;SAC/B;KACF,CAAC;AACJ,CAAC"}

package/dist/pdf/analyze.d.ts

@@ -0,0 +1,4 @@
+import type { PdfAnalysis } from "./types.js";
+export declare function analyzePdf(data: Uint8Array): Promise<PdfAnalysis>;
+/** Convenience wrapper: analyze a PDF given a local file path (FR: path input). */
+export declare function analyzePdfFile(path: string): Promise<PdfAnalysis>;

package/dist/pdf/analyze.js

@@ -0,0 +1,29 @@
+// Orchestrates L1 (format detection) + L2 (page map) over a whole PDF and
+// surfaces a detect-and-warn message for scanned/mixed input (OCR is deferred).
+import { readFile } from "node:fs/promises";
+import { classifyDocument } from "./classify.js";
+import { extractPages } from "./extract.js";
+import { buildPageMap } from "./page-map.js";
+export async function analyzePdf(data) {
+    const pages = await extractPages(data);
+    const signals = pages.map((page) => ({
+        textLength: page.text.length,
+        hasImage: page.hasImage,
+    }));
+    const { type } = classifyDocument(signals);
+    const pageMap = buildPageMap(pages.map((page) => page.text));
+    const warnings = [];
+    if (type === "scanned") {
+        warnings.push("PDF appears to be scanned (little or no extractable text). OCR is not supported in v0.1.0, so parsing will be incomplete.");
+    }
+    else if (type === "mixed") {
+        warnings.push("PDF mixes text and scanned pages. Scanned pages cannot be parsed (OCR deferred to a future release).");
+    }
+    return { type, pageCount: pages.length, pageMap, pages, warnings };
+}
+/** Convenience wrapper: analyze a PDF given a local file path (FR: path input). */
+export async function analyzePdfFile(path) {
+    const buffer = await readFile(path);
+    return analyzePdf(new Uint8Array(buffer));
+}
+//# sourceMappingURL=analyze.js.map

package/dist/pdf/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/pdf/analyze.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB;IAC/C,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAEvC,MAAM,OAAO,GAAiB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjD,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;QAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC,CAAC;IACJ,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,2HAA2H,CAC5H,CAAC;IACJ,CAAC;SAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CACX,sGAAsG,CACvG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACrE,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/pdf/classify.d.ts

@@ -0,0 +1,8 @@
+import type { PageKind, PageSignal, PdfClassification } from "./types.js";
+/**
+ * Minimum extractable characters for a page to count as a real "text" page.
+ * Below this, a page carrying a raster image is treated as scanned.
+ */
+export declare const MIN_TEXT_CHARS = 16;
+export declare function classifyPage(signal: PageSignal): PageKind;
+export declare function classifyDocument(signals: PageSignal[]): PdfClassification;

package/dist/pdf/classify.js

@@ -0,0 +1,35 @@
+// L1 — PDF format detection. Pure logic over per-page signals so it can be unit
+// tested without a real PDF.
+/**
+ * Minimum extractable characters for a page to count as a real "text" page.
+ * Below this, a page carrying a raster image is treated as scanned.
+ */
+export const MIN_TEXT_CHARS = 16;
+export function classifyPage(signal) {
+    if (signal.textLength >= MIN_TEXT_CHARS)
+        return "text";
+    if (signal.hasImage)
+        return "scanned";
+    return "blank";
+}
+export function classifyDocument(signals) {
+    const pageKinds = signals.map(classifyPage);
+    // Blank pages carry no evidence either way; decide on the content pages.
+    const content = pageKinds.filter((kind) => kind !== "blank");
+    let type;
+    if (content.length === 0) {
+        // Nothing extractable anywhere — treat as scanned so the caller warns.
+        type = "scanned";
+    }
+    else if (content.every((kind) => kind === "text")) {
+        type = "text_based";
+    }
+    else if (content.every((kind) => kind === "scanned")) {
+        type = "scanned";
+    }
+    else {
+        type = "mixed";
+    }
+    return { type, pageKinds };
+}
+//# sourceMappingURL=classify.js.map

package/dist/pdf/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/pdf/classify.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6BAA6B;AAS7B;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC7C,IAAI,MAAM,CAAC,UAAU,IAAI,cAAc;QAAE,OAAO,MAAM,CAAC;IACvD,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5C,yEAAyE;IACzE,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAE7D,IAAI,IAAa,CAAC;IAClB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,uEAAuE;QACvE,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC;SAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,YAAY,CAAC;IACtB,CAAC;SAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;QACvD,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC"}

package/dist/pdf/command.d.ts

@@ -0,0 +1,12 @@
+import type { Command, Protocol } from "../schema/types.js";
+import type { PageContent } from "./types.js";
+/** L4b — bus + device addresses. */
+export declare function extractProtocol(pages: PageContent[]): Protocol;
+/** L4b — CRC parameters from the checksum section. */
+export declare function extractCrc(pages: PageContent[]): {
+    poly: string;
+    init: string;
+    width: number;
+} | undefined;
+/** L4c — extract named commands with full hex codes. */
+export declare function extractCommands(pages: PageContent[]): Command[];

package/dist/pdf/command.js

@@ -0,0 +1,96 @@
+// L4b/L4c (scoped) — text extraction for command-set devices (e.g. Sensirion
+// SHT3x): I2C protocol + CRC parameters, and the cleanly-tabulated standalone /
+// representative commands. Full split-code measurement/periodic matrices are left
+// to host-AI enumeration (hybrid philosophy). See wiki: command-set-interface.
+const joinText = (pages) => pages
+    .map((p) => p.text)
+    .join(" ")
+    .replace(/\s+/g, " ");
+const upperHex = (code) => "0x" + code.slice(2).toUpperCase();
+function normalizeName(raw) {
+    return raw
+        .trim()
+        .replace(/^(?:(?:command|hex|code)\s+)+/i, "")
+        .split(/\s+/)
+        .slice(0, 6)
+        .join(" ")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+}
+/** L4b — bus + device addresses. */
+export function extractProtocol(pages) {
+    const text = joinText(pages);
+    const bus = /\bI(?:2|²)C\b/i.test(text)
+        ? "I2C"
+        : /\bSPI\b/.test(text)
+            ? "SPI"
+            : "unknown";
+    const addresses = [];
+    // Within each "address …" window, collect every plausible 7-bit I2C address.
+    for (const ctx of text.matchAll(/address[^.]{0,60}/gi)) {
+        for (const m of ctx[0].matchAll(/0x[0-7][0-9a-f]/gi)) {
+            const addr = upperHex(m[0]);
+            const value = Number.parseInt(addr, 16);
+            if (value >= 0x08 && value <= 0x77 && !addresses.includes(addr)) {
+                addresses.push(addr);
+            }
+        }
+    }
+    return addresses.length > 0 ? { bus, addresses } : { bus };
+}
+/** L4b — CRC parameters from the checksum section. */
+export function extractCrc(pages) {
+    const text = joinText(pages);
+    const poly = /polynomial\s+(0x[0-9a-f]{2})/i.exec(text);
+    const init = /initiali[sz]ation\s+(0x[0-9a-f]{2})/i.exec(text);
+    if (!poly || !init)
+        return undefined;
+    return { poly: upperHex(poly[1]), init: upperHex(init[1]), width: 8 };
+}
+// Only patterns whose NAME is a pure run of letters/spaces are used — a digit or
+// "0x" in the span means we've crossed into the other text column, so we bail
+// rather than emit a garbled name. Reliable > complete for this scoped pass.
+const P_MINI = /hex\s+code\s+([a-z][a-z /]{1,35}?)\s+(0x[0-9a-f]{4})\s+table/gi;
+const P_EG = /e\.g\.\s*(0x[0-9a-f]{4})\s*:\s*([a-z][a-z /]{3,70})/gi;
+const P_GENCALL = /general call address\s+(0x[0-9a-f]{4})/gi;
+const P_CRC_EXAMPLE = /crc\s*\(\s*(0x[0-9a-f]{4})\s*\)/gi;
+const isDataReturning = /measurement|repeatab|periodic|status|art|fetch/i;
+const isMeasurement = /measurement|repeatab|periodic/i;
+/** L4c — extract named commands with full hex codes. */
+export function extractCommands(pages) {
+    const text = joinText(pages);
+    const crc = extractCrc(pages);
+    const excluded = new Set();
+    for (const m of text.matchAll(P_CRC_EXAMPLE))
+        excluded.add(m[1].toLowerCase());
+    // code -> name; earlier (cleaner) patterns win on collision.
+    const found = new Map();
+    const add = (rawName, rawCode) => {
+        const code = rawCode.toLowerCase();
+        if (excluded.has(code) || found.has(code))
+            return;
+        const name = normalizeName(rawName);
+        if (name)
+            found.set(code, name);
+    };
+    for (const m of text.matchAll(P_MINI))
+        add(m[1], m[2]);
+    for (const m of text.matchAll(P_EG))
+        add(m[2], m[1]);
+    for (const m of text.matchAll(P_GENCALL))
+        add("general_call_reset", m[1]);
+    const commands = [];
+    for (const [code, name] of found) {
+        const command = { name, code: upperHex(code) };
+        if (crc && isDataReturning.test(name)) {
+            command.crc = crc;
+            if (isMeasurement.test(name))
+                command.responseWords = 2;
+        }
+        commands.push(command);
+    }
+    commands.sort((a, b) => a.code.localeCompare(b.code));
+    return commands;
+}
+//# sourceMappingURL=command.js.map

package/dist/pdf/command.js.map

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

package/dist/pdf/extract.d.ts

@@ -0,0 +1,2 @@
+import type { PageContent } from "./types.js";
+export declare function extractPages(data: Uint8Array): Promise<PageContent[]>;

package/dist/pdf/extract.js

@@ -0,0 +1,47 @@
+// pdfjs-dist adapter: load a PDF and pull positioned text + an image flag from
+// every page. The legacy build is the Node-friendly entry (and ships types).
+import { getDocument, OPS } from "pdfjs-dist/legacy/build/pdf.mjs";
+const IMAGE_OPS = new Set([
+    OPS.paintImageXObject,
+    OPS.paintInlineImageXObject,
+    OPS.paintImageMaskXObject,
+]);
+export async function extractPages(data) {
+    const task = getDocument({ data });
+    const pdf = await task.promise;
+    try {
+        const pages = [];
+        for (let n = 1; n <= pdf.numPages; n++) {
+            const page = await pdf.getPage(n);
+            const textContent = await page.getTextContent();
+            const items = [];
+            for (const item of textContent.items) {
+                // TextMarkedContent entries carry no `str`; skip them.
+                if (!("str" in item))
+                    continue;
+                items.push({
+                    str: item.str,
+                    x: item.transform[4],
+                    y: item.transform[5],
+                    width: item.width,
+                    height: item.height,
+                });
+            }
+            const text = items
+                .map((i) => i.str)
+                .join(" ")
+                .replace(/\s+/g, " ")
+                .trim();
+            const opList = await page.getOperatorList();
+            const hasImage = opList.fnArray.some((fn) => IMAGE_OPS.has(fn));
+            pages.push({ index: n, text, items, hasImage });
+            page.cleanup();
+        }
+        return pages;
+    }
+    finally {
+        await pdf.cleanup();
+        await task.destroy();
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/pdf/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/pdf/extract.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6EAA6E;AAE7E,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,iCAAiC,CAAC;AAGnE,MAAM,SAAS,GAAwB,IAAI,GAAG,CAAC;IAC7C,GAAG,CAAC,iBAAiB;IACrB,GAAG,CAAC,uBAAuB;IAC3B,GAAG,CAAC,qBAAqB;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAgB;IACjD,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAkB,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAElC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAChD,MAAM,KAAK,GAAqB,EAAE,CAAC;YACnC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;gBACrC,uDAAuD;gBACvD,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC;oBAAE,SAAS;gBAC/B,KAAK,CAAC,IAAI,CAAC;oBACT,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;oBACpB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;oBACpB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,GAAG,KAAK;iBACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;iBACjB,IAAI,CAAC,GAAG,CAAC;iBACT,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;iBACpB,IAAI,EAAE,CAAC;YAEV,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAEhE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/pdf/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./types.js";
+export { MIN_TEXT_CHARS, classifyDocument, classifyPage } from "./classify.js";
+export { buildPageMap, labelPage } from "./page-map.js";
+export { extractPages } from "./extract.js";
+export { analyzePdf, analyzePdfFile } from "./analyze.js";
+export { centerX, clusterRows, type TableRow } from "./table.js";
+export { findRegisterTable, parseRegisterTable } from "./register-table.js";
+export { detectManufacturer } from "./manufacturer.js";
+export { detectPart } from "./part.js";
+export { detectInterfaceKind } from "./interface-kind.js";
+export { extractCommands, extractCrc, extractProtocol } from "./command.js";

package/dist/pdf/index.js

@@ -0,0 +1,13 @@
+// Public surface of the PDF parsing pipeline (L1 format detection + L2 page map).
+export * from "./types.js";
+export { MIN_TEXT_CHARS, classifyDocument, classifyPage } from "./classify.js";
+export { buildPageMap, labelPage } from "./page-map.js";
+export { extractPages } from "./extract.js";
+export { analyzePdf, analyzePdfFile } from "./analyze.js";
+export { centerX, clusterRows } from "./table.js";
+export { findRegisterTable, parseRegisterTable } from "./register-table.js";
+export { detectManufacturer } from "./manufacturer.js";
+export { detectPart } from "./part.js";
+export { detectInterfaceKind } from "./interface-kind.js";
+export { extractCommands, extractCrc, extractProtocol } from "./command.js";
+//# sourceMappingURL=index.js.map

package/dist/pdf/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pdf/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/pdf/interface-kind.d.ts

@@ -0,0 +1,2 @@
+import type { InterfaceKindDetection, PageContent } from "./types.js";
+export declare function detectInterfaceKind(pages: PageContent[]): InterfaceKindDetection;

package/dist/pdf/interface-kind.js

@@ -0,0 +1,46 @@
+// L3b — interface-kind classifier: register_map vs command_set. This, not the
+// manufacturer, is the primary strategy switch (routes L4a table vs L4c command).
+// See wiki: device-class-before-manufacturer, command-set-interface.
+import { findRegisterTable } from "./register-table.js";
+const REGISTER_KEYWORD = /register\s+(map|table|description|addresses?|summary)|memory\s+map/i;
+const COMMAND_KEYWORD = /command\s+word|commands?\s+(set|table|list)|list\s+of\s+commands/i;
+const CRC_KEYWORD = /crc[-\s]?\d|clock\s+stretch/i;
+export function detectInterfaceKind(pages) {
+    const text = pages.map((p) => p.text).join(" ");
+    const registerSignals = [];
+    const commandSignals = [];
+    let registerScore = 0;
+    let commandScore = 0;
+    if (findRegisterTable(pages)) {
+        registerScore += 3;
+        registerSignals.push("register-table");
+    }
+    if (REGISTER_KEYWORD.test(text)) {
+        registerScore += 2;
+        registerSignals.push("register-keyword");
+    }
+    if (COMMAND_KEYWORD.test(text)) {
+        commandScore += 2;
+        commandSignals.push("command-keyword");
+    }
+    if (CRC_KEYWORD.test(text)) {
+        commandScore += 1;
+        commandSignals.push("crc/clock-stretch");
+    }
+    if (registerScore === 0 && commandScore === 0) {
+        return { kind: "unknown", confidence: 0, signals: [] };
+    }
+    if (registerScore >= commandScore) {
+        return {
+            kind: "register_map",
+            confidence: Math.min(1, registerScore / 5),
+            signals: registerSignals,
+        };
+    }
+    return {
+        kind: "command_set",
+        confidence: Math.min(1, commandScore / 3),
+        signals: commandSignals,
+    };
+}
+//# sourceMappingURL=interface-kind.js.map

package/dist/pdf/interface-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-kind.js","sourceRoot":"","sources":["../../src/pdf/interface-kind.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kFAAkF;AAClF,qEAAqE;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,gBAAgB,GACpB,qEAAqE,CAAC;AACxE,MAAM,eAAe,GACnB,mEAAmE,CAAC;AACtE,MAAM,WAAW,GAAG,8BAA8B,CAAC;AAEnD,MAAM,UAAU,mBAAmB,CACjC,KAAoB;IAEpB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhD,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,aAAa,IAAI,CAAC,CAAC;QACnB,eAAe,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,aAAa,IAAI,CAAC,CAAC;QACnB,eAAe,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,YAAY,IAAI,CAAC,CAAC;QAClB,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,YAAY,IAAI,CAAC,CAAC;QAClB,cAAc,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,aAAa,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,aAAa,IAAI,YAAY,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC;YAC1C,OAAO,EAAE,eAAe;SACzB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC;QACzC,OAAO,EAAE,cAAc;KACxB,CAAC;AACJ,CAAC"}

package/dist/pdf/manufacturer.d.ts

@@ -0,0 +1,2 @@
+import type { ManufacturerDetection, PageContent } from "./types.js";
+export declare function detectManufacturer(pages: PageContent[]): ManufacturerDetection;

package/dist/pdf/manufacturer.js

@@ -0,0 +1,86 @@
+// L3a — manufacturer detection: deterministic layered scoring over datasheet
+// text. Strong signals (copyright, document-number, URL) outweigh the weak
+// part-prefix heuristic, so second-source collisions (PCA9555 vs TCA9555) resolve
+// correctly. Low confidence degrades gracefully to a generic adapter — it never
+// hard-fails. See wiki: manufacturer-detection, device-class-before-manufacturer.
+const VENDORS = [
+    {
+        name: "Bosch Sensortec",
+        copyright: /Bosch\s+Sensortec/i,
+        docNumber: /\bBST-[A-Z0-9]+-DS\d+/i,
+        domain: /bosch-sensortec\.com/i,
+        partPrefix: /\bBM[EPAI]\d/i,
+    },
+    {
+        name: "Microchip",
+        copyright: /Microchip\s+Technology/i,
+        docNumber: /\bDS\d{8}[A-Z]?\b/i,
+        domain: /microchip\.com/i,
+        partPrefix: /\bMCP\d/i,
+    },
+    {
+        name: "STMicroelectronics",
+        copyright: /STMicroelectronics/i,
+        docNumber: /\bDS\d{4,5}\b/i,
+        domain: /\bst\.com\b/i,
+        partPrefix: /\b(LIS|LSM|STM)\d/i,
+    },
+    {
+        name: "Texas Instruments",
+        copyright: /Texas\s+Instruments/i,
+        docNumber: /\b(SLLS|SBAS|SBOS|SNOS)\w+/i,
+        domain: /\bti\.com\b/i,
+        partPrefix: /\b(SN65|SN74|TCA|ADS)\d/i,
+    },
+    {
+        name: "NXP",
+        copyright: /NXP\s+Semiconductors/i,
+        domain: /nxp\.com/i,
+        partPrefix: /\b(PCA|PCF)\d/i,
+    },
+    {
+        name: "Sensirion",
+        copyright: /Sensirion/i,
+        domain: /sensirion\.com/i,
+        partPrefix: /\b(SHT|SCD|SGP)\d/i,
+    },
+];
+const STRONG = 3;
+const WEAK = 1;
+/** Below this, no confident vendor — fall back to generic. */
+const MIN_SCORE = 2;
+export function detectManufacturer(pages) {
+    const text = pages.map((p) => p.text).join(" ");
+    let best = { name: "generic", score: 0, signals: [] };
+    for (const vendor of VENDORS) {
+        let score = 0;
+        const signals = [];
+        if (vendor.copyright?.test(text)) {
+            score += STRONG;
+            signals.push("copyright");
+        }
+        if (vendor.docNumber?.test(text)) {
+            score += STRONG;
+            signals.push("doc-number");
+        }
+        if (vendor.domain?.test(text)) {
+            score += STRONG;
+            signals.push("url");
+        }
+        if (vendor.partPrefix?.test(text)) {
+            score += WEAK;
+            signals.push("part-prefix");
+        }
+        if (score > best.score)
+            best = { name: vendor.name, score, signals };
+    }
+    if (best.score < MIN_SCORE) {
+        return { manufacturer: "generic", confidence: 0, signals: [] };
+    }
+    return {
+        manufacturer: best.name,
+        confidence: Math.min(1, best.score / 6),
+        signals: best.signals,
+    };
+}
+//# sourceMappingURL=manufacturer.js.map

package/dist/pdf/manufacturer.js.map

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

package/dist/pdf/page-map.d.ts

@@ -0,0 +1,5 @@
+import type { PageMap } from "./types.js";
+/** Labels detected on a single page's text. */
+export declare function labelPage(text: string): string[];
+/** Build the page map from each page's text (index 0 => page 1). */
+export declare function buildPageMap(pageTexts: string[]): PageMap;

package/dist/pdf/page-map.js

@@ -0,0 +1,52 @@
+// L2 — Page map. Labels pages by section keyword patterns so later layers do not
+// search every page blindly. Pure over page text; unit tested without a PDF.
+// Ordered, multi-word patterns to keep false positives low. Matching is over the
+// whole page's text; heading-aware refinement can come once font-size heading
+// extraction lands.
+const LABEL_PATTERNS = [
+    {
+        label: "register_map",
+        pattern: /\bregister\s+(map|description|summary|table|overview)\b|\bmemory\s+map\b/i,
+    },
+    {
+        label: "electrical_characteristics",
+        pattern: /\belectrical\s+(characteristics|specifications?)\b|\b(dc|ac)\s+characteristics\b/i,
+    },
+    {
+        label: "timing",
+        pattern: /\btiming\s+(diagram|characteristics|specifications?|requirements?|parameters?)\b/i,
+    },
+    {
+        label: "pin_description",
+        pattern: /\bpin\s+(description|configuration|assignment|function)\b|\bpin(-|\s)?out\b/i,
+    },
+    {
+        label: "absolute_maximum_ratings",
+        pattern: /\babsolute\s+maximum\s+ratings\b/i,
+    },
+    {
+        label: "commands",
+        pattern: /\bcommand\s+(set|table|description|list)\b|\blist\s+of\s+commands\b/i,
+    },
+];
+/** Labels detected on a single page's text. */
+export function labelPage(text) {
+    const labels = [];
+    for (const { label, pattern } of LABEL_PATTERNS) {
+        if (pattern.test(text))
+            labels.push(label);
+    }
+    return labels;
+}
+/** Build the page map from each page's text (index 0 => page 1). */
+export function buildPageMap(pageTexts) {
+    const map = {};
+    pageTexts.forEach((text, i) => {
+        const pageNo = i + 1;
+        for (const label of labelPage(text)) {
+            (map[label] ??= []).push(pageNo);
+        }
+    });
+    return map;
+}
+//# sourceMappingURL=page-map.js.map

package/dist/pdf/page-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-map.js","sourceRoot":"","sources":["../../src/pdf/page-map.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,6EAA6E;AAI7E,iFAAiF;AACjF,8EAA8E;AAC9E,oBAAoB;AACpB,MAAM,cAAc,GAAsD;IACxE;QACE,KAAK,EAAE,cAAc;QACrB,OAAO,EACL,2EAA2E;KAC9E;IACD;QACE,KAAK,EAAE,4BAA4B;QACnC,OAAO,EACL,mFAAmF;KACtF;IACD;QACE,KAAK,EAAE,QAAQ;QACf,OAAO,EACL,mFAAmF;KACtF;IACD;QACE,KAAK,EAAE,iBAAiB;QACxB,OAAO,EACL,8EAA8E;KACjF;IACD;QACE,KAAK,EAAE,0BAA0B;QACjC,OAAO,EAAE,mCAAmC;KAC7C;IACD;QACE,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,sEAAsE;KAChF;CACF,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,cAAc,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,SAAmB;IAC9C,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/pdf/part.d.ts

@@ -0,0 +1,3 @@
+import type { PageContent } from "./types.js";
+/** The most frequently occurring vendor part token, uppercased; "" if none. */
+export declare function detectPart(pages: PageContent[]): string;

package/dist/pdf/part.js

@@ -0,0 +1,41 @@
+// L3 (metadata) — best-effort part-number extraction. The part number recurs in
+// every page header/footer, so the most frequently matched vendor part token is
+// a strong, deterministic signal. Degrades to "" (validator then warns) rather
+// than guessing. Only used for naming/metadata — never for register geometry.
+// Full part tokens per vendor family (broader than manufacturer.ts's prefix-only
+// signals, which exist just to score a vendor). Ordered most-specific first.
+const PART_PATTERNS = [
+    /\bBM[EPAI]\d{3}\b/gi, // BME280, BMP280, BMA...
+    /\bMCP\d{4,5}[A-Z]?\b/gi, // MCP23017, MCP23S17
+    /\bSHT\d{1,2}[A-Za-z]?\b/gi, // SHT3x, SHT31
+    /\b(?:SCD|SGP)\d{2,3}[A-Za-z]?\b/gi, // SCD40, SGP30
+    /\b(?:LIS|LSM)\d[A-Z0-9]{2,}\b/gi, // LIS3DH, LSM6DS3
+    /\bSTM32[A-Z]\d[A-Z0-9]+\b/gi,
+    /\b(?:PCA|PCF)\d{3,4}[A-Z]?\b/gi, // PCA9555
+    /\b(?:TCA|SN65|SN74|ADS)\d{3,4}[A-Z]?\b/gi,
+];
+/** The most frequently occurring vendor part token, uppercased; "" if none. */
+export function detectPart(pages) {
+    const text = pages
+        .map((p) => p.text)
+        .join(" ")
+        .replace(/\s+/g, " ");
+    const counts = new Map();
+    for (const pattern of PART_PATTERNS) {
+        for (const m of text.matchAll(pattern)) {
+            const token = m[0].toUpperCase();
+            counts.set(token, (counts.get(token) ?? 0) + 1);
+        }
+    }
+    let best = "";
+    let bestCount = 0;
+    for (const [token, count] of counts) {
+        // Prefer higher frequency; break ties by the longer (more specific) token.
+        if (count > bestCount || (count === bestCount && token.length > best.length)) {
+            best = token;
+            bestCount = count;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=part.js.map

package/dist/pdf/part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"part.js","sourceRoot":"","sources":["../../src/pdf/part.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAI9E,iFAAiF;AACjF,6EAA6E;AAC7E,MAAM,aAAa,GAAsB;IACvC,qBAAqB,EAAE,yBAAyB;IAChD,wBAAwB,EAAE,qBAAqB;IAC/C,2BAA2B,EAAE,eAAe;IAC5C,mCAAmC,EAAE,eAAe;IACpD,iCAAiC,EAAE,kBAAkB;IACrD,6BAA6B;IAC7B,gCAAgC,EAAE,UAAU;IAC5C,0CAA0C;CAC3C,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC7C,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAExB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,2EAA2E;QAC3E,IAAI,KAAK,GAAG,SAAS,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7E,IAAI,GAAG,KAAK,CAAC;YACb,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/pdf/register-table.d.ts

@@ -0,0 +1,5 @@
+import type { PageContent, RegisterTable } from "./types.js";
+/** Parse a register map table from a single page, if it holds one. */
+export declare function parseRegisterTable(page: PageContent): RegisterTable | undefined;
+/** Scan pages and return the first register map table found. */
+export declare function findRegisterTable(pages: PageContent[]): RegisterTable | undefined;