@vessel-dsp/compiler 0.18.0 → 0.19.0

package/dist/netlist.js

@@ -15,7 +15,7 @@
 // absent; geometry resolves only what neither encoding states. Geometry is used to
 // *resolve* nodes and is then discarded -- no coordinate survives into the Netlist, so no
 // later stage can accidentally derive connectivity from one.
-import { componentDevices, deviceTerminalRoles, parseInterchangeYamlWithTopology, } from "@vessel-dsp/core";
+import { TAPER_TABLE_PROPERTY_KEY, componentDevices, deviceTerminalRoles, parseInterchangeYamlWithTopology, taperTableFieldsOf, } from "@vessel-dsp/core";
 import { load as loadYaml } from "js-yaml";
 import { StageRefusal } from "./errors.js";
 import { emptyRegistry, foldToken, registryEntryFor } from "./registry.js";
@@ -570,6 +570,7 @@ function voltagePortRails(components, devices, nodeOf) {
                     : null,
                 terminalRoles: [terminalRoleToken(String(terminal.name))],
                 declaredTerminalRoles: [declaredRole(terminal)],
+                terminalPinNumbers: [terminalPinNumber(String(terminal.name))],
                 declaredWindings: null,
             },
         });
@@ -871,6 +872,7 @@ export function readNetlist(source, options) {
                 : null,
             terminalRoles: terminals.map((terminal) => terminalRoleToken(String(terminal.name))),
             declaredTerminalRoles: roles,
+            terminalPinNumbers: terminals.map((terminal) => terminalPinNumber(String(terminal.name))),
             declaredWindings: declaredWindings(component, terminals),
         });
         // **A package that states its own devices is split here, from the source.** A dual op-amp
@@ -1114,6 +1116,31 @@ export function readNetlist(source, options) {
                     "linear. An audio pot rendered linear is audible across the whole sweep.",
             });
         }
+        // A declared measured table wins over the taper kind above. The kind stays on the
+        // control as the maker's letter; the table is the law every consumer executes.
+        // An invalid table refuses the document by name (stage 1): falling back to the
+        // kind, or to linear, would play a curve the source did not state.
+        let taperTable;
+        if (owner !== undefined) {
+            const raw = owner.properties[TAPER_TABLE_PROPERTY_KEY];
+            if (raw !== undefined) {
+                try {
+                    const fields = taperTableFieldsOf({ TaperTable: raw });
+                    if (fields.taperTable !== undefined) {
+                        taperTable = {
+                            points: fields.taperTable.points.map((point) => ({
+                                position: point.position,
+                                fraction: point.fraction,
+                            })),
+                            source: fields.taperTable.source,
+                        };
+                    }
+                }
+                catch (error) {
+                    throw new NetlistError(`component ${owner.id}: ${error instanceof Error ? error.message : String(error)}`, String(owner.id), error);
+                }
+            }
+        }
         const discretePositions = discretePositionsForControl(id, owner, document, declaredDiscretePositions);
         // Only for a control a chip reads (scanned or tapped): a jack you tap into is not a
         // knob-style panel control, so its label and role come from its own declaration. Every
@@ -1176,6 +1203,7 @@ export function readNetlist(source, options) {
         return {
             id,
             taper: declaredTapers.get(id) ?? componentTaper?.taper ?? "linear",
+            ...(taperTable !== undefined ? { taperTable } : {}),
             defaultPosition,
             positions: discretePositions,
             role: declaredRoles.get(id) ??
@@ -4392,6 +4420,18 @@ function terminalRoleToken(name) {
     }
     return folded.replace(/^pin\d+/u, "");
 }
+/**
+ * A terminal's package pin number, or null where its name is not one.
+ *
+ * Whole digit strings only, compared whole downstream: `"1"` is pin 1 and `"pin1"`,
+ * `"1OUT"`, `""` are not pins (null). The one reading of a digit string is its number --
+ * no fold, no role inference -- which is what keeps this on the right side of the rule
+ * against reading authored prose.
+ */
+function terminalPinNumber(name) {
+    const trimmed = name.trim();
+    return /^\d+$/u.test(trimmed) ? trimmed : null;
+}
 /**
  * The taper a control declares for itself, or null when it declares none.
  *
@@ -5112,6 +5152,7 @@ function outputJackLoads(document, devices) {
                 declaredType: null,
                 terminalRoles: [null, null],
                 declaredTerminalRoles: [null, null],
+                terminalPinNumbers: [null, null],
                 declaredWindings: null,
             },
         });
@@ -5301,6 +5342,7 @@ function controllerPinDevice(pin, controls) {
             declaredType: null,
             terminalRoles: ["common", ...throws.map(() => "throw")],
             declaredTerminalRoles: ["common", ...throws.map(() => "throw")],
+            terminalPinNumbers: [null, ...throws.map(() => null)],
             declaredWindings: null,
         },
     };