@vessel-dsp/compiler 0.5.0 → 0.6.0

package/dist/registry-data/loader.d.ts

@@ -0,0 +1,137 @@
+import { type PartClassName } from "./schema";
+/** Where a cited value came from: printed in a datasheet, derived with the working shown,
+ * read directly from a manufacturer-published SPICE/PSpice model file, measured by the
+ * owner on the bench (generic LED / diode defaults only, until a measurement JSON exists),
+ * or provisional `community` (a published model or measurement by a named author where no
+ * better source exists; the compiler names every device that runs on one). */
+export type ParamBasis = "datasheet" | "derived" | "manufacturer-model" | "measured" | "community";
+/** What kind of published source a `community` parameter was taken from. */
+export type CommunitySourceKind = "published-spice-model" | "published-measurement";
+/**
+ * One registry parameter: the single number the engine uses, with its provenance.
+ * A datasheet's printed limits are never stored as fields; where they were used to derive
+ * the value they are quoted in `derivation` (zener typ from a min/max row) or the value is
+ * the printed TYP transcribed with its row quoted in `source` (op-amp gain-bandwidth).
+ * A `manufacturer-model` parameter is read directly from the manufacturer's own model
+ * file: `modelFileUrl` is that file's URL (one of the eight publishing manufacturers'
+ * own hosts) and `modelLine` is the exact model line the value was read from, verbatim
+ * as printed -- a `.MODEL` / `.SUBCKT` card (with its continuation lines) from a model
+ * file, or a Microsim-style `NPN (...)` line from the manufacturer's own datasheet --
+ * both quoted in `source` as well.
+ * A `measured` parameter is the owner's own bench value: `measurementInstrument` names
+ * the meter, `measurementConditions` states the supply, resistors and temperature,
+ * `measurementSampleCount` counts the pooled samples, `measurementDate` is the sitting
+ * date (YYYY-MM-DD), and `measurementEvidencePath` plus `measurementEvidenceSha256`
+ * point at the committed measurement JSON (repo-relative path, sha256 of the file) --
+ * both quoted in `source` as well. The JSON schema is
+ * `vesseldsp.junction-default-measurement.v1` (`perDevice` entries with `isEngine`,
+ * `nEngine`, `samples`, pooled over every sample, already referred to the engine's
+ * thermal voltage 0.025852 V); see `led-measurement.html` and its README.
+ * A `community` parameter is provisional (decided 2026-10-19, option B): where no
+ * datasheet, manufacturer model or owner measurement exists, a parameter may be taken
+ * from a published source found online -- a published SPICE model, or a published
+ * measurement by a named author. The record carries `sourceKind` (which of the two),
+ * `url` (the http(s) address where the source can be read), `quote` (verbatim text
+ * carrying the value), `author` (a named person or organisation, never "forum"),
+ * `retrievedDate` (the sitting date, YYYY-MM-DD), and `whyNoBetterSource` (what was
+ * searched: datasheet, manufacturer model, owner bench). An unattributed or
+ * unverifiable number is not admitted. It is provisional: adding a datasheet,
+ * manufacturer-model or measured record for the same parameter of the same part throws
+ * until the community record is removed, and the compiler names every device that runs
+ * on one (`registry-provisional-value`). An original-manufacturer datasheet hosted on
+ * a third-party site (a scan of a Mullard, Philips, Hitachi, Toshiba or Rohm sheet) is
+ * still `datasheet`, not `community`.
+ */
+export type CitedParam = {
+    /** The single number the engine uses. Must be finite. */
+    readonly value: number;
+    readonly basis: ParamBasis;
+    /** The citation: datasheet document, page and row, or the actual provenance chain. */
+    readonly source: string;
+    /** Required when `basis` is `derived`: the working, written so it can be checked. */
+    readonly derivation?: string;
+    /** Required when `basis` is `manufacturer-model`: the manufacturer model file's URL. */
+    readonly modelFileUrl?: string;
+    /** Required when `basis` is `manufacturer-model`: the exact `.MODEL` / `.SUBCKT` line. */
+    readonly modelLine?: string;
+    /** Required when `basis` is `measured`: the meter (make/model). */
+    readonly measurementInstrument?: string;
+    /** Required when `basis` is `measured`: supply, resistors, temperature. */
+    readonly measurementConditions?: string;
+    /** Required when `basis` is `measured`: pooled sample count (>= 1, integer). */
+    readonly measurementSampleCount?: number;
+    /** Required when `basis` is `measured`: sitting date, YYYY-MM-DD. */
+    readonly measurementDate?: string;
+    /** Required when `basis` is `measured`: repo-relative path of the measurement JSON. */
+    readonly measurementEvidencePath?: string;
+    /** Required when `basis` is `measured`: lowercase hex sha256 of the measurement JSON. */
+    readonly measurementEvidenceSha256?: string;
+    /** Required when `basis` is `community`: which published kind the value was taken from. */
+    readonly sourceKind?: CommunitySourceKind;
+    /** Required when `basis` is `community`: the http(s) URL where the source can be read. */
+    readonly url?: string;
+    /** Required when `basis` is `community`: verbatim text carrying the value. */
+    readonly quote?: string;
+    /** Required when `basis` is `community`: the named person or organisation behind it. */
+    readonly author?: string;
+    /** Required when `basis` is `community`: the retrieval date, YYYY-MM-DD. */
+    readonly retrievedDate?: string;
+    /** Required when `basis` is `community`: what was searched and why no better source exists. */
+    readonly whyNoBetterSource?: string;
+};
+/**
+ * One part's parameters, as data.
+ *
+ * Bin and package spellings are typed explicitly -- every spelling is a listed string,
+ * never a pattern: `partIds` holds the canonical ids and `aliases` the bin/package
+ * spellings that resolve to them. Both are matched whole and case-folded, and both share
+ * one uniqueness scope: an alias may not collide with any other entry's id or alias.
+ * Stage-1 data keeps each row's spellings exactly as the pre-registry catalog listed them
+ * (all in `partIds`); `aliases` is validated and available for stage 3's bin splits.
+ */
+export type PartDataEntry = {
+    readonly partIds: readonly string[];
+    readonly aliases?: readonly string[];
+    readonly class: PartClassName;
+    readonly params: Readonly<Record<string, CitedParam>>;
+    /** Provenance disclosures that are not a parameter: stand-ins, exceptions, caveats. */
+    readonly note?: string;
+};
+/** Validate one cited value. Returns it unchanged; throws naming the entry and parameter. */
+export declare function validateCitedParam(entryLabel: string, name: string, param: CitedParam): CitedParam;
+/**
+ * Validate a list of entries and freeze it. Throws at module load on any violation:
+ * unknown class, unknown parameter name for the class, uncited parameter, or a folded
+ * id claimed by two entries in this list. Cross-list collisions are `assemblePartData`'s
+ * beat.
+ *
+ * Two spellings in the SAME entry that fold to one id (`RD5.6JB2`, `RD5.6J B2`,
+ * `RD5.6J-B2`) are redundant, not conflicting: the pre-registry catalog lists every
+ * observed spelling explicitly, and the matcher folds them anyway. Only two entries
+ * claiming one id is a wrong answer about somebody's part.
+ */
+export declare function definePartData(entries: readonly PartDataEntry[]): readonly PartDataEntry[];
+/**
+ * Assemble the per-class lists into the one registry data set. Throws when an id or
+ * alias in one list collides with another list's -- an alias that collides with another
+ * entry is a wrong answer about somebody's part, so it refuses rather than shadowing.
+ */
+export declare function assemblePartData(lists: readonly (readonly PartDataEntry[])[]): readonly PartDataEntry[];
+/** Find an entry by exact folded id or alias. Whole folded id only; no prefix or family rule. */
+export declare function findPartData(data: readonly PartDataEntry[], partId: string): PartDataEntry | null;
+/**
+ * One provisional parameter: the registry parameter name and the community source URL
+ * the entry's value was taken from. The compiler stamps these onto `PartEntry` so a
+ * compiled device that runs on one can be named (`registry-provisional-value`) without
+ * the compiler importing any part data.
+ */
+export type CommunityProvenance = {
+    readonly name: string;
+    readonly url: string;
+};
+/**
+ * Every `community`-basis parameter in the record, with its source URL. Empty when the
+ * record holds none. The loader guarantees every community parameter carries a URL.
+ */
+export declare function communityProvenanceOf(record: PartDataEntry): readonly CommunityProvenance[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/registry-data/loader.d.ts.map

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

package/dist/registry-data/loader.js

@@ -0,0 +1,350 @@
+// The data-registry loader: cited parameters in, validated entries out, loudly.
+//
+// Every parameter is `{ value, basis, source }`: `value` is the single number the engine
+// uses, `basis` says where it came from (`datasheet`, printed as a typical or point value;
+// `derived`, with the derivation written out; `manufacturer-model`, read directly from a
+// manufacturer-published SPICE/PSpice model file; `measured`, the owner's bench value;
+// `community`, a published SPICE model or published measurement by a named author where
+// no better source exists), and `source` is the citation. An uncited
+// value is not loadable -- the loader throws, at module load, on:
+//
+// - a parameter missing `source` or `basis`;
+// - a `derived` basis with no derivation text;
+// - a `manufacturer-model` basis without the manufacturer model file URL and the exact
+//   model line it was read from (both required, validated, and quoted in `source`);
+//   the line is verbatim as the manufacturer printed it: a `.MODEL` / `.SUBCKT` card
+//   (with its continuation lines) from a model file, or a Microsim-style `NPN (...)`
+//   line from the manufacturer's own datasheet (clarified 2026-10-19: a model the
+//   manufacturer prints inside its datasheet is manufacturer-published);
+// - a `measured` basis without the owner's bench record (instrument, conditions,
+//   sample count, date, evidence path plus sha256 -- every field required, validated,
+//   and the evidence path and sha256 quoted in `source`);
+// - a `community` basis without the provisional record (source kind, http(s) URL,
+//   verbatim quote, named author, ISO retrieval date, why-no-better-source -- every
+//   field required, validated, and the URL and quote quoted in `source`);
+// - a part id whose `community` parameter clashes with a non-community record for the
+//   SAME parameter (adding a datasheet, manufacturer model or measured value forces
+//   the community record out rather than sitting beside it);
+// - model file/line fields on any other basis;
+// - a model file URL outside the manufacturer's own hosts (third-party libraries,
+//   mirrors, forums and aggregators are not manufacturer models, even when the text
+//   they carry is manufacturer-authored);
+// - measured fields on any other basis;
+// - community fields on any other basis;
+// - model file/line fields on any other basis;
+// - a parameter name that is not in the class schema;
+// - a duplicate part id or alias (folded, across the whole assembled set);
+// - an alias that collides with another entry (an id or another alias).
+//
+// The loader validates *shape and provenance*, never electrical plausibility: a finite
+// 0.35 V pump loss and a finite 30 V zener both load, and the stamping path keeps its own
+// loud checks (a half-stated swing pair still throws in `withDatasheetOutputSwing`).
+// A third-party model library (LTspice's standard files, Tina, a forum) is NOT a
+// manufacturer model and is not admitted: the file URL must be the manufacturer's own
+// publication (onsemi, Vishay, STMicroelectronics, Nexperia, Diodes Inc, TI, Analog Devices,
+// Central Semiconductor).
+import { foldPartId } from "../registry.js";
+import { CLASS_PARAM_SCHEMAS, classParamNames } from "./schema.js";
+/**
+ * Manufacturer hosts a `manufacturer-model` file URL may live on. The file must be the
+ * manufacturer's own publication: a model text carried by a third-party library, mirror,
+ * forum or aggregator is not a manufacturer model even when the text is
+ * manufacturer-authored. Matched by domain suffix, so `www.` and asset subdomains pass.
+ */
+const MANUFACTURER_MODEL_HOSTS = [
+    "onsemi.com",
+    "vishay.com",
+    "st.com",
+    "nexperia.com",
+    "diodes.com",
+    "ti.com",
+    "analog.com",
+    "centralsemi.com",
+];
+/** True when the URL's host belongs to one of the eight publishing manufacturers. */
+function isManufacturerModelHost(url) {
+    let host = "";
+    try {
+        host = new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+    return MANUFACTURER_MODEL_HOSTS.some((suffix) => host === suffix || host.endsWith(`.${suffix}`));
+}
+/** Validate one cited value. Returns it unchanged; throws naming the entry and parameter. */
+export function validateCitedParam(entryLabel, name, param) {
+    if (param.basis !== "datasheet" &&
+        param.basis !== "derived" &&
+        param.basis !== "manufacturer-model" &&
+        param.basis !== "measured" &&
+        param.basis !== "community") {
+        throw new Error(`${entryLabel}: parameter "${name}" has no basis: expected "datasheet", "derived", "manufacturer-model", "measured" or "community"`);
+    }
+    if (typeof param.value !== "number" || !Number.isFinite(param.value)) {
+        throw new Error(`${entryLabel}: parameter "${name}" has no finite value: ${String(param.value)}`);
+    }
+    if (typeof param.source !== "string" || param.source.length === 0) {
+        throw new Error(`${entryLabel}: parameter "${name}" is missing its source citation`);
+    }
+    if (param.basis === "derived" &&
+        (typeof param.derivation !== "string" || param.derivation.length === 0)) {
+        throw new Error(`${entryLabel}: parameter "${name}" has a derived basis with no derivation text`);
+    }
+    if (param.basis === "manufacturer-model") {
+        if (typeof param.modelFileUrl !== "string" ||
+            param.modelFileUrl.length === 0) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a manufacturer-model basis with no model file URL`);
+        }
+        if (!/^https?:\/\//u.test(param.modelFileUrl) ||
+            /\s/u.test(param.modelFileUrl)) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a manufacturer-model basis with a model file that is not an http(s) URL: ${param.modelFileUrl}`);
+        }
+        if (!isManufacturerModelHost(param.modelFileUrl)) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a manufacturer-model basis with a model file outside the manufacturer's own hosts: ${param.modelFileUrl}`);
+        }
+        if (typeof param.modelLine !== "string" || param.modelLine.length === 0) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a manufacturer-model basis with no model line`);
+        }
+        if (!param.source.includes(param.modelFileUrl)) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a manufacturer-model basis whose source does not quote the model file URL`);
+        }
+        if (!param.source.includes(param.modelLine.trim())) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a manufacturer-model basis whose source does not quote the model line`);
+        }
+    }
+    else {
+        if (param.modelFileUrl !== undefined || param.modelLine !== undefined) {
+            throw new Error(`${entryLabel}: parameter "${name}" states a model file/line on a "${param.basis}" basis (manufacturer-model only)`);
+        }
+    }
+    if (param.basis === "measured") {
+        if (typeof param.measurementInstrument !== "string" ||
+            param.measurementInstrument.length === 0) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a measured basis with no instrument`);
+        }
+        if (typeof param.measurementConditions !== "string" ||
+            param.measurementConditions.length === 0) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a measured basis with no conditions (supply, resistors, temperature)`);
+        }
+        if (typeof param.measurementSampleCount !== "number" ||
+            !Number.isInteger(param.measurementSampleCount) ||
+            param.measurementSampleCount < 1) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a measured basis with no sample count (integer >= 1): ${String(param.measurementSampleCount)}`);
+        }
+        if (typeof param.measurementDate !== "string" ||
+            !/^\d{4}-\d{2}-\d{2}$/u.test(param.measurementDate) ||
+            Number.isNaN(Date.parse(`${param.measurementDate}T00:00:00Z`))) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a measured basis with no date (YYYY-MM-DD): ${String(param.measurementDate)}`);
+        }
+        if (typeof param.measurementEvidencePath !== "string" ||
+            param.measurementEvidencePath.length === 0) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a measured basis with no evidence path`);
+        }
+        if (param.measurementEvidencePath.startsWith("/") ||
+            param.measurementEvidencePath.includes("..") ||
+            !param.measurementEvidencePath.endsWith(".json")) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a measured basis with an evidence path that is not a repo-relative JSON path: ${param.measurementEvidencePath}`);
+        }
+        if (typeof param.measurementEvidenceSha256 !== "string" ||
+            !/^[0-9a-f]{64}$/u.test(param.measurementEvidenceSha256)) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a measured basis with no evidence sha256 (64 lowercase hex): ${String(param.measurementEvidenceSha256)}`);
+        }
+        if (!param.source.includes(param.measurementEvidencePath)) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a measured basis whose source does not quote the evidence path`);
+        }
+        if (!param.source.includes(param.measurementEvidenceSha256)) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a measured basis whose source does not quote the evidence sha256`);
+        }
+    }
+    else {
+        if (param.measurementInstrument !== undefined ||
+            param.measurementConditions !== undefined ||
+            param.measurementSampleCount !== undefined ||
+            param.measurementDate !== undefined ||
+            param.measurementEvidencePath !== undefined ||
+            param.measurementEvidenceSha256 !== undefined) {
+            throw new Error(`${entryLabel}: parameter "${name}" states measured fields on a "${param.basis}" basis (measured only)`);
+        }
+    }
+    if (param.basis === "community") {
+        if (param.sourceKind !== "published-spice-model" &&
+            param.sourceKind !== "published-measurement") {
+            throw new Error(`${entryLabel}: parameter "${name}" has a community basis with no sourceKind: expected "published-spice-model" or "published-measurement"`);
+        }
+        if (typeof param.url !== "string" ||
+            param.url.length === 0 ||
+            !/^https?:\/\//u.test(param.url) ||
+            /\s/u.test(param.url)) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a community basis with no URL (http(s), no whitespace): ${String(param.url)}`);
+        }
+        if (typeof param.quote !== "string" || param.quote.trim().length === 0) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a community basis with no verbatim quote`);
+        }
+        if (typeof param.author !== "string" ||
+            param.author.trim().length === 0 ||
+            param.author.trim().toLowerCase() === "forum") {
+            throw new Error(`${entryLabel}: parameter "${name}" has a community basis with no named author (a person or organisation, never "forum"): ${String(param.author)}`);
+        }
+        if (typeof param.retrievedDate !== "string" ||
+            !/^\d{4}-\d{2}-\d{2}$/u.test(param.retrievedDate) ||
+            Number.isNaN(Date.parse(`${param.retrievedDate}T00:00:00Z`))) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a community basis with no retrieval date (YYYY-MM-DD): ${String(param.retrievedDate)}`);
+        }
+        if (typeof param.whyNoBetterSource !== "string" ||
+            param.whyNoBetterSource.trim().length === 0) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a community basis with no whyNoBetterSource (what was searched)`);
+        }
+        if (!param.source.includes(param.url)) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a community basis whose source does not quote the URL`);
+        }
+        if (!param.source.includes(param.quote.trim())) {
+            throw new Error(`${entryLabel}: parameter "${name}" has a community basis whose source does not quote the verbatim text`);
+        }
+    }
+    else {
+        if (param.sourceKind !== undefined ||
+            param.url !== undefined ||
+            param.quote !== undefined ||
+            param.author !== undefined ||
+            param.retrievedDate !== undefined ||
+            param.whyNoBetterSource !== undefined) {
+            throw new Error(`${entryLabel}: parameter "${name}" states community fields on a "${param.basis}" basis (community only)`);
+        }
+    }
+    return param;
+}
+/** The folded id scope of one entry: canonical ids plus aliases, in listing order. */
+function entryIds(entry) {
+    return [...entry.partIds, ...(entry.aliases ?? [])];
+}
+/**
+ * The community clash: the same parameter of one part recorded once from a provisional
+ * `community` source and once from a better source. Adding the datasheet, manufacturer
+ * model or measured record forces the community record out rather than sitting beside
+ * it, so the pair throws. Returns the clashing parameter name, or null.
+ */
+function communityClash(a, b) {
+    for (const name of Object.keys(a.params)) {
+        const pa = a.params[name];
+        const pb = b.params[name];
+        if (pa === undefined || pb === undefined)
+            continue;
+        if ((pa.basis === "community") !== (pb.basis === "community")) {
+            return name;
+        }
+    }
+    return null;
+}
+/**
+ * Validate a list of entries and freeze it. Throws at module load on any violation:
+ * unknown class, unknown parameter name for the class, uncited parameter, or a folded
+ * id claimed by two entries in this list. Cross-list collisions are `assemblePartData`'s
+ * beat.
+ *
+ * Two spellings in the SAME entry that fold to one id (`RD5.6JB2`, `RD5.6J B2`,
+ * `RD5.6J-B2`) are redundant, not conflicting: the pre-registry catalog lists every
+ * observed spelling explicitly, and the matcher folds them anyway. Only two entries
+ * claiming one id is a wrong answer about somebody's part.
+ */
+export function definePartData(entries) {
+    const seen = new Map();
+    for (const entry of entries) {
+        const label = entry.partIds.join(",") || "(no part ids)";
+        if (!(entry.class in CLASS_PARAM_SCHEMAS)) {
+            throw new Error(`${label}: unknown part class "${entry.class}"`);
+        }
+        const allowed = new Set(classParamNames(entry.class));
+        for (const [name, param] of Object.entries(entry.params)) {
+            if (!allowed.has(name)) {
+                throw new Error(`${label}: unknown parameter "${name}" for class "${entry.class}" ` +
+                    `(accepted: ${[...allowed].join(", ")})`);
+            }
+            validateCitedParam(label, name, param);
+        }
+        const ids = entryIds(entry);
+        if (ids.length === 0) {
+            throw new Error(`${label}: an entry names no part ids`);
+        }
+        // Within-entry folded duplicates are redundant spellings, not a conflict (see above).
+        const foldedHere = new Set();
+        for (const id of ids) {
+            if (typeof id !== "string" || id.length === 0) {
+                throw new Error(`${label}: an entry lists an empty part id or alias`);
+            }
+            foldedHere.add(foldPartId(id));
+        }
+        for (const folded of foldedHere) {
+            const first = seen.get(folded);
+            if (first !== undefined) {
+                const clash = communityClash(first.entry, entry);
+                if (clash !== null) {
+                    throw new Error(`${label}: duplicate part id or alias (already listed on ${first.label}) -- ` +
+                        `a community record for parameter "${clash}" clashes with a non-community ` +
+                        `record for the same parameter (adding a datasheet, manufacturer-model or ` +
+                        `measured value forces the community record out)`);
+                }
+                throw new Error(`${label}: duplicate part id or alias (already listed on ${first.label})`);
+            }
+            seen.set(folded, { label, entry });
+        }
+    }
+    return Object.freeze(entries.map((entry) => Object.freeze(entry)));
+}
+/**
+ * Assemble the per-class lists into the one registry data set. Throws when an id or
+ * alias in one list collides with another list's -- an alias that collides with another
+ * entry is a wrong answer about somebody's part, so it refuses rather than shadowing.
+ */
+export function assemblePartData(lists) {
+    const seen = new Map();
+    for (const list of lists) {
+        for (const entry of list) {
+            const label = entry.partIds.join(",") || "(no part ids)";
+            // Same within-entry tolerance as `definePartData`: redundant spellings, one entry.
+            const foldedHere = new Set(entryIds(entry).map((id) => foldPartId(id)));
+            for (const folded of foldedHere) {
+                const first = seen.get(folded);
+                if (first !== undefined) {
+                    const clash = communityClash(first.entry, entry);
+                    if (clash !== null) {
+                        throw new Error(`${label}: part id or alias collides with another entry (${first.label}) -- ` +
+                            `a community record for parameter "${clash}" clashes with a non-community ` +
+                            `record for the same parameter (adding a datasheet, manufacturer-model or ` +
+                            `measured value forces the community record out)`);
+                    }
+                    throw new Error(`${label}: part id or alias collides with another entry (${first.label})`);
+                }
+                seen.set(folded, { label, entry });
+            }
+        }
+    }
+    return Object.freeze(lists.flat());
+}
+/** Find an entry by exact folded id or alias. Whole folded id only; no prefix or family rule. */
+export function findPartData(data, partId) {
+    const folded = foldPartId(partId);
+    for (const entry of data) {
+        if (entryIds(entry).some((id) => foldPartId(id) === folded)) {
+            return entry;
+        }
+    }
+    return null;
+}
+/**
+ * Every `community`-basis parameter in the record, with its source URL. Empty when the
+ * record holds none. The loader guarantees every community parameter carries a URL.
+ */
+export function communityProvenanceOf(record) {
+    const out = [];
+    for (const [name, param] of Object.entries(record.params)) {
+        if (param.basis !== "community")
+            continue;
+        if (typeof param.url !== "string" || param.url.length === 0) {
+            throw new Error(`${record.partIds.join(",")}: community parameter "${name}" carries no URL`);
+        }
+        out.push({ name, url: param.url });
+    }
+    return out;
+}
+//# sourceMappingURL=loader.js.map

package/dist/registry-data/loader.js.map

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

package/dist/registry-data/mosfet.d.ts

@@ -0,0 +1,3 @@
+import { type PartDataEntry } from "./loader";
+export declare const mosfetRegistryRecords: readonly PartDataEntry[];
+//# sourceMappingURL=mosfet.d.ts.map

package/dist/registry-data/mosfet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mosfet.d.ts","sourceRoot":"","sources":["../../src/registry-data/mosfet.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9D,eAAO,MAAM,qBAAqB,EAAE,SAAS,aAAa,EAuCxD,CAAC"}

package/dist/registry-data/mosfet.js

@@ -0,0 +1,63 @@
+// MOSFET registry data: wave-1 discrete fill.
+//
+// One value per parameter; a parameter with no datasheet citation is not loadable, so it
+// is omitted here and the stamp falls back to the class default (never a guess):
+//
+// - `thresholdVolts`: a printed VGS(th) bin or range becomes one value by its midpoint
+//   (form 2, arithmetic -- a threshold is not a gain). A MIN-only VGS(th) with no MAX is a
+//   limit, not a range, and yields nothing.
+// - `transconductance`: the square-law Beta is NOT derived from gfs here -- gfs is a
+//   small-signal figure at one bias, a different quantity. Only a printed TYP gfs stated as
+//   the part's transconductance transcribes directly (basis `datasheet`); a MIN-only gfs
+//   yields nothing.
+// - `channelLengthModulation`, `subthresholdVolts`, gate terms: omitted for every part below.
+//   No sheet in this wave prints lambda, and the insulated gate draws no current by
+//   construction (gate zeros stand).
+//
+// This module starts empty: no vendored MOSFET sheet exists in the artifacts library, and the
+// fetched sheets land here as they are verified. See the wave-1 report for the per-part
+// verdicts.
+//
+// NOTE (method gap for later waves): a printed gfs/Yfs -- even TYP -- is a small-signal
+// transconductance at one bias, NOT the square-law Beta the shared `fet` law wants
+// (`current = beta * drive^2`). Converting one to the other needs the bias point, which is
+// a fifth derived form the owner has not approved, so gfs never transcribes here even when
+// printed. BS170 and 2N7000 therefore carry thresholdVolts only.
+import { definePartData } from "./loader.js";
+export const mosfetRegistryRecords = definePartData([
+    {
+        // transconductance omitted: the sheet's gfs TYP 200 mmhos at VDS = 10 V, ID = 250 mA
+        // is small-signal gm at one bias, not square-law Beta (see module note).
+        partIds: ["BS170"],
+        class: "mosfet",
+        params: {
+            thresholdVolts: {
+                value: 2.0,
+                basis: "datasheet",
+                source: "Fetched manufacturer sheet (no vendored copy): onsemi BS170/D, Nov 2017 Rev. 7, p2, ON " +
+                    "CHARACTERISTICS (Note 1: pulse test): 'Gate Threshold Voltage VGS(th), VDS = VGS, " +
+                    "ID = 1.0 mA: MIN 0.8 TYP 2.0 MAX 3.0 V'",
+                derivation: "Printed VGS(th) TYP 2.0 V at VDS = VGS, ID = 1.0 mA, transcribed (no midpoint: a " +
+                    "TYP is already one value). The range midpoint would be 1.9; the printed TYP wins.",
+            },
+        },
+    },
+    {
+        // transconductance omitted: the sheet's gfs is MIN-only 100 mS (a limit, not a value)
+        // and in any case small-signal gm, not square-law Beta (see module note).
+        partIds: ["2N7000"],
+        class: "mosfet",
+        params: {
+            thresholdVolts: {
+                value: 1.9,
+                basis: "derived",
+                source: "Fetched manufacturer sheet (no vendored copy): Zetex 2N7000 (now Diodes Inc), Issue 2 " +
+                    "Nov 1994, p1 table: 'Gate-Source Threshold Voltage VGS(th), ID = 1 mA, VDS = VGS: " +
+                    "MIN 0.8 MAX 3.0 V' (no TYP)",
+                derivation: "Printed VGS(th) range 0.8-3.0 V at ID = 1 mA; arithmetic midpoint (form 2, a " +
+                    "threshold is not a gain): (0.8 + 3.0) / 2 = 1.9 V.",
+            },
+        },
+    },
+]);
+//# sourceMappingURL=mosfet.js.map

package/dist/registry-data/mosfet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mosfet.js","sourceRoot":"","sources":["../../src/registry-data/mosfet.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,yFAAyF;AACzF,iFAAiF;AACjF,EAAE;AACF,uFAAuF;AACvF,2FAA2F;AAC3F,4CAA4C;AAC5C,qFAAqF;AACrF,4FAA4F;AAC5F,yFAAyF;AACzF,oBAAoB;AACpB,8FAA8F;AAC9F,oFAAoF;AACpF,qCAAqC;AACrC,EAAE;AACF,8FAA8F;AAC9F,wFAAwF;AACxF,YAAY;AACZ,EAAE;AACF,wFAAwF;AACxF,mFAAmF;AACnF,2FAA2F;AAC3F,2FAA2F;AAC3F,iEAAiE;AAEjE,OAAO,EAAE,cAAc,EAAsB,MAAM,UAAU,CAAC;AAE9D,MAAM,CAAC,MAAM,qBAAqB,GAA6B,cAAc,CAAC;IAC7E;QACC,qFAAqF;QACrF,yEAAyE;QACzE,OAAO,EAAE,CAAC,OAAO,CAAC;QAClB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE;YACP,cAAc,EAAE;gBACf,KAAK,EAAE,GAAG;gBACV,KAAK,EAAE,WAAW;gBAClB,MAAM,EACL,yFAAyF;oBACzF,oFAAoF;oBACpF,yCAAyC;gBAC1C,UAAU,EACT,mFAAmF;oBACnF,mFAAmF;aACpF;SACD;KACD;IACD;QACC,sFAAsF;QACtF,0EAA0E;QAC1E,OAAO,EAAE,CAAC,QAAQ,CAAC;QACnB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE;YACP,cAAc,EAAE;gBACf,KAAK,EAAE,GAAG;gBACV,KAAK,EAAE,SAAS;gBAChB,MAAM,EACL,wFAAwF;oBACxF,oFAAoF;oBACpF,6BAA6B;gBAC9B,UAAU,EACT,+EAA+E;oBAC/E,oDAAoD;aACrD;SACD;KACD;CACD,CAAC,CAAC"}

package/dist/registry-data/opamp.d.ts

@@ -0,0 +1,37 @@
+import type { OpampOutputSwingTranslation } from "../types";
+import { type CitedParam } from "./loader";
+/** The printed condition a swing pair was read at, and how it is carried. */
+export type OpampSwingPrinted = {
+    /** The printed row's total supply, VS+ minus VS- (30 for +-15 V). */
+    readonly supplyVolts: number;
+    readonly loadOhms: number;
+    readonly translation: OpampOutputSwingTranslation;
+    /** The printed column the figure was read from. */
+    readonly column: string;
+};
+/**
+ * Every datasheet-stated parameter for one row of part ids. A record states a
+ * gain-bandwidth product, a swing pair, or both; a record with neither is a table error.
+ * Drops are both or neither, with the printed condition exactly when the pair is.
+ */
+export type OpampRegistryRecord = {
+    readonly partIds: readonly string[];
+    readonly gainBandwidthHz?: CitedParam;
+    readonly outputSwingDropHighVolts?: CitedParam;
+    readonly outputSwingDropLowVolts?: CitedParam;
+    readonly outputSwingPrinted?: OpampSwingPrinted;
+};
+/** Validate op-amp records and freeze them. Throws at module load on any violation. */
+export declare function defineOpampRecords(records: readonly OpampRegistryRecord[]): readonly OpampRegistryRecord[];
+export declare const opampRegistryRecords: readonly OpampRegistryRecord[];
+/** Op-amp ids this catalog holds whose datasheet states no TYP gain-bandwidth figure, and why. */
+export declare const opampGainBandwidthAbsent: ReadonlyArray<{
+    readonly partIds: readonly string[];
+    readonly reason: string;
+}>;
+/** Op-amp ids this catalog holds that state no output-swing pair, and why. */
+export declare const opampOutputSwingAbsent: ReadonlyArray<{
+    readonly partIds: readonly string[];
+    readonly reason: string;
+}>;
+//# sourceMappingURL=opamp.d.ts.map

package/dist/registry-data/opamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opamp.d.ts","sourceRoot":"","sources":["../../src/registry-data/opamp.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAE5D,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE/D,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;IACtC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,UAAU,CAAC;IAC/C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,UAAU,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;CAChD,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GACrC,SAAS,mBAAmB,EAAE,CAyEhC;AAED,eAAO,MAAM,oBAAoB,EAAE,SAAS,mBAAmB,EAua7D,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,CAmGA,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,CAoGA,CAAC"}