driverge-mcp 0.0.0 → 0.0.1

package/dist/pdf/prose-commands.js

@@ -0,0 +1,90 @@
+// L4c generalization (Phase 4) — a role-based, high-precision TEXT pass for
+// command-set devices whose commands are only ever named in running prose
+// rather than tabulated (e.g. the Aosong DHT20's "sending the measurement
+// command 0xAC"). The Sensirion-shaped tabulated extractor (extractCommands in
+// command.ts) misses these entirely, so this runs as a fallback when that one
+// finds nothing. A sentence yields a command only when it carries BOTH a
+// command cue ("command" / "send(ing)") AND a role keyword (trigger/
+// measurement/measure, status, reset) — so a bare hex mention (an I2C
+// address, an unrelated register, a status-equality check) is never mistaken
+// for a command. Reliable > complete: this never invents a name or code that
+// isn't anchored by both signals.
+//
+// Phase 4b: after the commands are found, extractCrc (command.ts) is run over
+// the same pages and — if it resolves both poly and init (incl. the
+// polynomial-expression and "initial value" prose forms DHT20 uses) — the CRC
+// is attached to the measurement-role command only, mirroring the gating
+// extractCommands already applies via isDataReturning/isMeasurement. See
+// wiki: command-set-interface, cross-vendor-coverage-scorecard.
+import { extractCrc } from "./command.js";
+const joinText = (pages) => pages
+    .map((p) => p.text)
+    .join(" ")
+    .replace(/\s+/g, " ");
+/** A hex command/byte token, e.g. "0xAC". */
+const CODE = /0x([0-9a-f]{2,4})\b/gi;
+/** A command cue: the sentence is *doing* something with a command. */
+const CUE = /\bcommand\b|\bsend(?:ing)?\b/i;
+/** Ordered role list — first match in this order wins. */
+const ROLES = [
+    { re: /\btrigger\b|\bmeasurement\b|\bmeasure\b/i, name: "trigger_measurement" },
+    { re: /\bstatus\b/i, name: "status" },
+    { re: /\breset\b/i, name: "soft_reset" },
+];
+const upperCode = (hex) => "0x" + hex.toUpperCase();
+/** L4c fallback — extract commands that are only ever named in prose. */
+export function extractProseCommands(pages) {
+    const text = joinText(pages);
+    const sentences = text.split(/\.\s+/);
+    const byCode = new Map();
+    const byName = new Map();
+    let last;
+    for (const sentence of sentences) {
+        const codes = [...sentence.matchAll(CODE)];
+        // Param sentence: "parameter" + >=2 hex bytes -> attach to the previous
+        // command and never itself emit a new one.
+        if (/\bparameter\b/i.test(sentence) && codes.length >= 2) {
+            if (last && !last.params) {
+                last.params = [upperCode(codes[0][1]), upperCode(codes[1][1])];
+            }
+            continue;
+        }
+        if (codes.length === 0 || !CUE.test(sentence))
+            continue;
+        const role = ROLES.find((r) => r.re.test(sentence));
+        if (!role)
+            continue;
+        // Code nearest the cue: the cue may be re-used by different command
+        // mentions within a sentence, so anchor to the closest hex token.
+        const cueIndex = CUE.exec(sentence)?.index ?? 0;
+        let nearest = codes[0];
+        let nearestDist = Math.abs((nearest.index ?? 0) - cueIndex);
+        for (const m of codes) {
+            const dist = Math.abs((m.index ?? 0) - cueIndex);
+            if (dist < nearestDist) {
+                nearest = m;
+                nearestDist = dist;
+            }
+        }
+        const code = upperCode(nearest[1]);
+        const existing = byCode.get(code) ?? byName.get(role.name);
+        if (existing) {
+            last = existing;
+            continue;
+        }
+        const command = { name: role.name, code };
+        byCode.set(code, command);
+        byName.set(role.name, command);
+        last = command;
+    }
+    const commands = [...byCode.values()].sort((a, b) => a.code.localeCompare(b.code));
+    const crc = extractCrc(pages);
+    if (crc) {
+        for (const c of commands) {
+            if (/measurement/i.test(c.name))
+                c.crc = crc;
+        }
+    }
+    return commands;
+}
+//# sourceMappingURL=prose-commands.js.map

package/dist/pdf/prose-commands.js.map

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

package/dist/pdf/st-bit-layout.d.ts

@@ -0,0 +1,3 @@
+import type { BitField, PageContent } from "./types.js";
+/** Map each ST register acronym to its bit fields (msb-first, deduped). */
+export declare function findStBitFields(pages: PageContent[]): Map<string, BitField[]>;

package/dist/pdf/st-bit-layout.js

@@ -0,0 +1,238 @@
+// L4a (ST bit-layout path) — extract per-register bit fields from ST's
+// two-stacked-table register format (Section 9 "Register description" of
+// datasheets such as the LSM6DSRX): a "Table N. <ACRONYM> register" bit-layout
+// table (one row of exactly 8 per-bit columns, leftmost = bit7, values either
+// a field-label fragment or a reserved "0"/"1" with a footnote superscript)
+// sits directly above a "Table N+1. <ACRONYM> register description" table
+// whose left column (x≈102) carries the canonical field names, e.g.
+// "ODR_XL[3:0]", "LPF2_XL_EN". Multi-bit fields render as per-bit indexed
+// labels (ODR_XL3 ODR_XL2 ...), one per column, and a label may wrap across
+// 2-3 vertical rows within a column. This adapter reconstructs the bit
+// position of each canonical name by rebuilding the per-bit label from the
+// bracket's own index space and looking it up in the layout table — the
+// bracket range need not equal the field's physical bit position (see
+// FIFO_CTRL2's UNCOPTR_RATE_[1:0]). Deterministic and narrow by design:
+// prefer reliable partial coverage over guessing at layouts this doesn't
+// recognize. Feeds assembleDatasheet's generic-fallback branch only (the
+// specialized BME280/Microchip/TI adapters never call this). See wiki:
+// st-bit-layout, generic-register-table.
+import { centerX, clusterRows } from "./table.js";
+// Any table title, used only to bound regions (the floor under a description
+// table may be an unrelated title, e.g. "Table 50. Accelerometer ODR
+// selection").
+const TABLE_TITLE = /^Table\s+[\d.\-–]+\./;
+// "Table 48. CTRL1_XL register" — must NOT match "... register description"
+// (anchored at the end).
+const LAYOUT_TITLE = /Table\s+[\d.\-–]+\.\s+([A-Z][A-Z0-9_]+)\s+register$/;
+// "Table 49. CTRL1_XL register description".
+const DESC_TITLE = /Table\s+[\d.\-–]+\.\s+([A-Z][A-Z0-9_]+)\s+register description$/;
+// Footnote markers within the bit-layout region: a bare ordinal ("1.") or a
+// bare superscript ("(1)"). Both are dropped before column assignment; a
+// superscript glued onto a label (defense in depth) is stripped later too.
+const FOOTNOTE_MARKER = /^\d+\.$/;
+const BARE_SUPERSCRIPT = /^\(\d+\)$/;
+const SUPERSCRIPT = /\(\d+\)/g;
+// A canonical field name from the description table's left column:
+// "ODR_XL[3:0]", "FS[1:0]_XL", "LPF2_XL_EN", "WTM8".
+const CANONICAL_NAME = /^[A-Z][A-Z0-9_]*(\[\d+:\d+\])?[A-Z0-9_]*$/;
+// A bracketed field name split into its prefix/hi/lo/suffix.
+const BRACKET = /^([A-Z0-9_]*)\[(\d+):(\d+)\]([A-Z0-9_]*)$/;
+// The description table's left column sits close to the region's leftmost
+// edge (x≈102); prose starts well to the right (x≈196+).
+const LEFT_COLUMN_TOLERANCE = 40;
+// The bit row occupies a narrow vertical band; anything further below (e.g. a
+// footnote sentence) is excluded even if it slipped past the token filter.
+const BIT_ROW_BAND = 22;
+// A register's description table is sometimes the last thing on its page —
+// no further `Table N.` title follows to floor the region, so it would
+// otherwise run all the way down into the page's running footer (a document
+// ID + revision + page number, isolated from real content by a wide gap).
+// Real table/prose rows are packed within ~15-25 units of each other; a gap
+// this much larger marks the page-margin boundary.
+const CONTENT_GAP = 60;
+/** Classify each title row on a page (top-to-bottom, per `clusterRows`). */
+function findTitleEvents(page) {
+    const events = [];
+    for (const row of clusterRows(page.items)) {
+        const joined = row.items.map((it) => it.str).join(" ");
+        if (!TABLE_TITLE.test(joined))
+            continue;
+        const desc = DESC_TITLE.exec(joined);
+        if (desc) {
+            events.push({ type: "desc", acronym: desc[1], y: row.y });
+            continue;
+        }
+        const layout = LAYOUT_TITLE.exec(joined);
+        if (layout) {
+            events.push({ type: "layout", acronym: layout[1], y: row.y });
+            continue;
+        }
+        events.push({ type: "other", y: row.y });
+    }
+    return events;
+}
+/** Build bit -> label from the bit-layout table's region. */
+function buildBitMap(items) {
+    const tokens = items.filter((it) => {
+        const s = it.str.trim();
+        if (!s || /\s/.test(s))
+            return false;
+        if (FOOTNOTE_MARKER.test(s) || BARE_SUPERSCRIPT.test(s))
+            return false;
+        return true;
+    });
+    if (tokens.length === 0)
+        return new Map();
+    const topY = Math.max(...tokens.map((it) => it.y));
+    const bitRow = tokens.filter((it) => it.y > topY - BIT_ROW_BAND);
+    if (bitRow.length === 0)
+        return new Map();
+    const centers = bitRow.map((it) => centerX(it));
+    const minC = Math.min(...centers);
+    const maxC = Math.max(...centers);
+    const colW = (maxC - minC) / 7 || 1;
+    const byBit = new Map();
+    for (const it of bitRow) {
+        const raw = Math.round((centerX(it) - minC) / colW);
+        const bit = Math.min(7, Math.max(0, 7 - raw));
+        const list = byBit.get(bit);
+        if (list)
+            list.push(it);
+        else
+            byBit.set(bit, [it]);
+    }
+    const bitMap = new Map();
+    for (const [bit, list] of byBit) {
+        const label = list
+            .slice()
+            .sort((a, b) => b.y - a.y)
+            .map((it) => it.str.trim())
+            .join("")
+            .replace(SUPERSCRIPT, "");
+        if (label === "0" || label === "1")
+            continue; // reserved
+        bitMap.set(bit, label);
+    }
+    return bitMap;
+}
+/** Canonical field names from the description table's left column. */
+function canonicalNames(items) {
+    // Restrict to identifier-shaped tokens first, then derive the left column's
+    // x from THOSE alone. The floor bounding this region is the next `Table N.`
+    // title, which in the real datasheet can trail past the description
+    // table's actual end into the next register's subsection heading/intro
+    // prose (e.g. "9.2 PIN_CTRL (02h)" at x≈42) — computing the left edge from
+    // every item in the region would let that stray heading (never
+    // identifier-shaped) drag the reference point away from the true x≈102
+    // name column. Distinguish the name column from the prose column by the
+    // item's own left edge, not its centerX — a long field name (e.g.
+    // "UNCOPTR_RATE_[1:0]") still starts flush at x≈102 even though its center
+    // drifts well past a fixed offset from the region's leftmost edge.
+    const candidates = items.filter((it) => CANONICAL_NAME.test(it.str.trim()));
+    if (candidates.length === 0)
+        return [];
+    const minLeftX = Math.min(...candidates.map((it) => it.x));
+    const names = [];
+    for (const it of candidates) {
+        if (Math.abs(it.x - minLeftX) > LEFT_COLUMN_TOLERANCE)
+            continue;
+        names.push(it.str.trim());
+    }
+    return names;
+}
+/**
+ * The lowest y still considered part of the description table's real content
+ * when no further title bounds it on the page (see `CONTENT_GAP`).
+ */
+function contentFloor(page, descTitleY) {
+    const rows = clusterRows(page.items)
+        .filter((r) => r.y < descTitleY)
+        .sort((a, b) => b.y - a.y);
+    let prevY = descTitleY;
+    for (const row of rows) {
+        if (prevY - row.y > CONTENT_GAP)
+            return row.y;
+        prevY = row.y;
+    }
+    return -Infinity;
+}
+/** Clean a bracket's prefix+suffix concatenation into a field name. */
+function cleanName(raw) {
+    return raw.replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+}
+/** Resolve one canonical name to its bit field via the layout's bit map. */
+function correlate(name, bitMap) {
+    const bracket = BRACKET.exec(name);
+    if (bracket) {
+        const [, prefix, hiStr, loStr, suffix] = bracket;
+        const hi = Number(hiStr);
+        const lo = Number(loStr);
+        const bits = [];
+        for (let idx = lo; idx <= hi; idx++) {
+            const label = `${prefix}${idx}${suffix}`;
+            let found;
+            for (const [bit, lbl] of bitMap) {
+                if (lbl === label) {
+                    found = bit;
+                    break;
+                }
+            }
+            if (found === undefined)
+                return undefined;
+            bits.push(found);
+        }
+        return {
+            name: cleanName(prefix + suffix),
+            msb: Math.max(...bits),
+            lsb: Math.min(...bits),
+        };
+    }
+    for (const [bit, lbl] of bitMap) {
+        if (lbl === name)
+            return { name, msb: bit, lsb: bit };
+    }
+    return undefined;
+}
+/** Map each ST register acronym to its bit fields (msb-first, deduped). */
+export function findStBitFields(pages) {
+    const out = new Map();
+    for (const page of pages) {
+        const events = findTitleEvents(page);
+        for (let i = 0; i < events.length; i++) {
+            const layoutEvt = events[i];
+            if (layoutEvt.type !== "layout")
+                continue;
+            const descEvt = events[i + 1];
+            if (!descEvt ||
+                descEvt.type !== "desc" ||
+                descEvt.acronym !== layoutEvt.acronym) {
+                continue;
+            }
+            const nextEvt = events[i + 2];
+            const floor = nextEvt ? nextEvt.y : contentFloor(page, descEvt.y);
+            const layoutItems = page.items.filter((it) => it.y > descEvt.y && it.y < layoutEvt.y);
+            const descItems = page.items.filter((it) => it.y > floor && it.y < descEvt.y);
+            const bitMap = buildBitMap(layoutItems);
+            const names = canonicalNames(descItems);
+            const seen = new Set();
+            const fields = [];
+            for (const name of names) {
+                const field = correlate(name, bitMap);
+                if (!field)
+                    continue;
+                const key = `${field.msb}:${field.lsb}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                fields.push(field);
+            }
+            if (fields.length === 0)
+                continue;
+            fields.sort((a, b) => b.msb - a.msb);
+            if (!out.has(layoutEvt.acronym))
+                out.set(layoutEvt.acronym, fields);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=st-bit-layout.js.map

package/dist/pdf/st-bit-layout.js.map

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

package/dist/pdf/ti-field-descriptions.d.ts

@@ -0,0 +1,10 @@
+import type { BitField, PageContent } from "./types.js";
+/** A register's extracted bit-field detail. */
+export interface FieldTable {
+    /** 8/16/32, from the highest bit index seen (RESERVED bits included). */
+    width: number;
+    /** Named (non-RESERVED) fields, msb-first. */
+    bitFields: BitField[];
+}
+/** Map each register acronym to its Field Descriptions detail (width + fields). */
+export declare function findTiFieldDescriptions(pages: PageContent[]): Map<string, FieldTable>;

package/dist/pdf/ti-field-descriptions.js

@@ -0,0 +1,87 @@
+// L4a (TI bit-field path) — extract per-register bit fields from Texas
+// Instruments' "Register Field Descriptions" tables (e.g. TMAG5170). These sit
+// separately from the register-summary table parsed by ti-register-map: each is
+// titled "Table 7-N. <ACRONYM> Register Field Descriptions" and lists one field
+// per row as `Bit | Field | Type | Reset | Description`, where Bit is a single
+// index ("15") or a range ("14-12"). Bits reach 15, so these are 16-bit registers.
+// Returns acronym -> bit fields, which ti-register-map merges into its summary.
+// See wiki: register-width, generic-register-table.
+import { centerX, clusterRows } from "./table.js";
+// "Table 7-6. DEVICE_CONFIG Register Field Descriptions" (+ optional "(continued)").
+const TITLE = /Table\s+[\d.\-–]+\.\s+([A-Z][A-Z0-9_]+)\s+Register Field Descriptions/;
+// A Bit cell: a single index or an "msb-lsb" span.
+const BIT = /^(\d{1,2})(?:-(\d{1,2}))?$/;
+// The Bit column sits at the far left (x≈76); enum-continuation rows start at the
+// Description column (x≈308), so this bound rejects them.
+const BIT_X_MAX = 100;
+// A TI field acronym (CONV_AVG, T_CH_EN, RESERVED). Rejects footer text like
+// "Submit Document Feedback" whose page-number cell can masquerade as a Bit value.
+const FIELD_NAME = /^[A-Z][A-Z0-9_]*$/;
+/** A field row → its bit field, or undefined if the row isn't one. */
+function fieldFromRow(row) {
+    const cells = [...row.items].sort((a, b) => a.x - b.x);
+    const bitCell = cells[0];
+    const nameCell = cells[1];
+    if (!bitCell || !nameCell || centerX(bitCell) > BIT_X_MAX)
+        return undefined;
+    const m = BIT.exec(bitCell.str.trim());
+    if (!m)
+        return undefined;
+    const hi = Number(m[1]);
+    const lo = m[2] !== undefined ? Number(m[2]) : hi;
+    const msb = Math.max(hi, lo);
+    // A register bit can't exceed 31 (a "34" is a footer page number, not a bit).
+    if (msb > 31)
+        return undefined;
+    const name = nameCell.str.trim();
+    if (!FIELD_NAME.test(name))
+        return undefined;
+    return { name, msb, lsb: Math.min(hi, lo) };
+}
+const widthFor = (maxBit) => maxBit >= 16 ? 32 : maxBit >= 8 ? 16 : 8;
+/** Map each register acronym to its Field Descriptions detail (width + fields). */
+export function findTiFieldDescriptions(pages) {
+    const acc = new Map();
+    for (const page of pages) {
+        // Require the field-descriptions title on the page (TI repeats it, even on
+        // "(continued)" pages), so unrelated pages with a stray left-column number
+        // never contribute fields.
+        let current;
+        for (const row of clusterRows(page.items)) {
+            const title = TITLE.exec(row.items.map((it) => it.str).join(" "));
+            if (title) {
+                current = title[1];
+                if (!acc.has(current)) {
+                    acc.set(current, { maxBit: -1, bitFields: [], seen: new Set() });
+                }
+                continue;
+            }
+            if (!current)
+                continue;
+            const field = fieldFromRow(row);
+            if (!field)
+                continue;
+            const entry = acc.get(current);
+            if (!entry)
+                continue;
+            // RESERVED bits still count toward the register width, but aren't emitted.
+            entry.maxBit = Math.max(entry.maxBit, field.msb);
+            if (/^reserved$/i.test(field.name))
+                continue;
+            const key = `${field.msb}:${field.lsb}`;
+            if (entry.seen.has(key))
+                continue;
+            entry.seen.add(key);
+            entry.bitFields.push(field);
+        }
+    }
+    const out = new Map();
+    for (const [acronym, entry] of acc) {
+        if (entry.bitFields.length === 0)
+            continue;
+        entry.bitFields.sort((a, b) => b.msb - a.msb);
+        out.set(acronym, { width: widthFor(entry.maxBit), bitFields: entry.bitFields });
+    }
+    return out;
+}
+//# sourceMappingURL=ti-field-descriptions.js.map

package/dist/pdf/ti-field-descriptions.js.map

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

package/dist/pdf/ti-register-map.d.ts

@@ -0,0 +1,5 @@
+import type { PageContent, RegisterTable } from "./types.js";
+/** Parse the Table 7-4 fragment on a single page (rows below its header). */
+export declare function parseTiRegisterMap(page: PageContent): RegisterTable | undefined;
+/** Accumulate the (possibly page-continued) TI register-summary table. */
+export declare function findTiRegisterMap(pages: PageContent[]): RegisterTable | undefined;

package/dist/pdf/ti-register-map.js

@@ -0,0 +1,84 @@
+// L4a (TI register path) — extract Texas Instruments' register-summary table.
+//
+// TI datasheets (e.g. TMAG5170) don't use a single BME280/Microchip-style bit
+// table; they list registers in a plain "Register Map" summary table
+// ("Table 7-4. … Registers": Offset | Acronym | Register Name | Section) and put
+// the bit fields in separate per-register sections. This adapter parses that
+// summary — enough to produce a validated register list (name = acronym,
+// address = the offset) that codegen turns into address #defines. Bit-field
+// extraction from the per-register tables is a separate, 16-bit-aware follow-up.
+import { findTiFieldDescriptions } from "./ti-field-descriptions.js";
+import { clusterRows } from "./table.js";
+const OFFSET = /^([0-9A-Fa-f]{1,2})h$/; // bare hex + "h": "0h", "8h", "10h"
+const ACRONYM = /^[A-Z][A-Z0-9_]+$/; // register acronym: DEVICE_CONFIG, X_CH_RESULT
+const norm = (s) => s.toLowerCase().replace(/\s+/g, "");
+function isHeader(row) {
+    const cells = row.items.map((it) => norm(it.str));
+    return cells.includes("offset") && cells.includes("acronym");
+}
+/** "0h"/"Ah"/"10h" -> "0x00"/"0x0A"/"0x10". */
+function normalizeAddress(raw) {
+    const m = OFFSET.exec(raw);
+    return m ? `0x${m[1].toUpperCase().padStart(2, "0")}` : raw;
+}
+/** Parse the Table 7-4 fragment on a single page (rows below its header). */
+export function parseTiRegisterMap(page) {
+    const rows = clusterRows(page.items);
+    const header = rows.find(isHeader);
+    if (!header)
+        return undefined;
+    const below = rows.filter((r) => r.y < header.y).sort((a, b) => b.y - a.y);
+    const registers = [];
+    for (const row of below) {
+        const toks = row.items.map((it) => it.str.trim()).filter(Boolean);
+        // A register row is `<offset> <ACRONYM> …`. Anything else (prose, the
+        // "0h = 1x …" bit-value decoys whose 2nd token is "=") ends the table.
+        if (toks.length < 2 || !OFFSET.test(toks[0]) || !ACRONYM.test(toks[1])) {
+            break;
+        }
+        registers.push({
+            name: toks[1],
+            address: normalizeAddress(toks[0]),
+            reset: "",
+            bitFields: [],
+        });
+    }
+    return { page: page.index, registers };
+}
+/** Accumulate the (possibly page-continued) TI register-summary table. */
+export function findTiRegisterMap(pages) {
+    let firstPage;
+    const registers = [];
+    const seen = new Set();
+    for (const page of pages) {
+        const frag = parseTiRegisterMap(page);
+        if (frag && frag.registers.length > 0) {
+            if (firstPage === undefined)
+                firstPage = frag.page;
+            for (const r of frag.registers) {
+                if (!seen.has(r.address)) {
+                    seen.add(r.address);
+                    registers.push(r);
+                }
+            }
+        }
+        else if (firstPage !== undefined) {
+            break; // the summary table ended on the previous page
+        }
+    }
+    if (firstPage === undefined)
+        return undefined;
+    // Enrich the summary with per-register bit fields from the separate "Register
+    // Field Descriptions" tables (16-bit registers — see ti-field-descriptions and
+    // register-width). Registers without a field table stay address-only (width 8).
+    const detail = findTiFieldDescriptions(pages);
+    for (const r of registers) {
+        const table = detail.get(r.name);
+        if (table) {
+            r.width = table.width;
+            r.bitFields = table.bitFields;
+        }
+    }
+    return { page: firstPage, registers };
+}
+//# sourceMappingURL=ti-register-map.js.map

package/dist/pdf/ti-register-map.js.map

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

package/dist/pdf/types.d.ts

@@ -19,7 +19,15 @@ export interface PageContent {
     /** Whitespace-normalized concatenation of the page's text runs. */
     text: string;
     items: PositionedText[];
-    /** Whether the page paints a raster image (a "scanned" signal). */
+    /**
+     * Whether the page paints a raster image (a "scanned" signal).
+     *
+     * Lazily computed: only meaningful for sparse-text pages, i.e. exactly
+     * the pages classifyPage() consults it for (textLength < MIN_TEXT_CHARS).
+     * On a text-rich page this is always `false`, regardless of whether the
+     * page actually paints an image — the extractor skips the operator-list
+     * walk there because nothing reads the value.
+     */
     hasImage: boolean;
 }
 /** Minimal per-page signal the classifier needs — kept PDF-free so it is pure. */
@@ -36,9 +44,9 @@ export type PageMap = Record<string, number[]>;
 /** One bit field within a register, positioned by absolute bit index. */
 export interface BitField {
     name: string;
-    /** Most-significant bit index within the register (0-7). */
+    /** Most-significant bit index within the register (0 .. width-1). */
     msb: number;
-    /** Least-significant bit index within the register (0-7). */
+    /** Least-significant bit index within the register (0 .. width-1). */
     lsb: number;
 }
 /** A single register row reconstructed from a memory-map table. */
@@ -48,8 +56,12 @@ export interface Register {
     address: string;
     /** Verbatim reset/default cell, e.g. "0x00", "0x60", "individual". */
     reset: string;
+    /** Register width in bits (8/16/32); absent ⇒ 8. Bounds bit-field indices/reset. */
+    width?: number;
     bitFields: BitField[];
 }
+/** Register width in bits, defaulting to 8 when unspecified. */
+export declare function registerWidth(r: Register): number;
 /** The register map extracted from one table. */
 export interface RegisterTable {
     /** 1-based page the table was found on. */

package/dist/pdf/types.js

@@ -1,3 +1,6 @@
 // Shared types for the PDF parsing pipeline (L1 format detection + L2 page map).
-export {};
+/** Register width in bits, defaulting to 8 when unspecified. */
+export function registerWidth(r) {
+    return r.width ?? 8;
+}
 //# sourceMappingURL=types.js.map

package/dist/pdf/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pdf/types.ts"],"names":[],"mappings":"AAAA,iFAAiF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pdf/types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAyEjF,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,CAAW;IACvC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AACtB,CAAC"}