@vessel-dsp/core 0.6.29 → 0.6.31

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.6.29";
+export declare const VERSION = "0.6.31";
 export type { CreateComponentArgs, DocumentCommand, EditorCommand, EditorState, TidyLayoutOptions, } from "./editor";
 export { applyDocumentCommand, applyEditorCommand, buildComponent, canRedo, canUndo, createEditorState, resetEditorState, tidyDocumentLayout, } from "./editor";
 export type { AnyCircuitElement, AnyCircuitElementInput, CircuitJson, CircuitJsonElement, CircuitJsonExport, CircuitJsonExportOptions, CircuitJsonExportTarget, CircuitJsonSchemaValidationIssue, CircuitJsonSchemaValidationResult, CircuitJsonSourceComponent, CircuitJsonSourceNet, CircuitJsonSourcePort, CircuitJsonSourceTrace, ParseCircuitJsonDocumentOptions, } from "./formats/circuit-json/serializer";
@@ -8,6 +8,10 @@ export { convertCircuitDocumentFile, convertCircuitDocumentFileWithReport, detec
 export { INTERCHANGE_CONTRACT_VERSION } from "./formats/interchange/contract";
 export { AMBIGUOUS_POTENTIOMETER_END_TOKENS, POTENTIOMETER_TERMINAL_ROLE_ALIASES, POTENTIOMETER_TERMINAL_ROLES, classifyPotentiometerTerminalRole, resolveDocumentPotentiometerTerminalRoles, resolvePotentiometerTerminalRoles, } from "./model/terminal-roles";
 export type { PotentiometerTerminalRole, PotentiometerTerminalRoleResolution, PotentiometerTerminalRoleVerdict, } from "./model/terminal-roles";
+export { POTENTIOMETER_TAPERS, SUPERSEDED_TAPER_PROPERTY_KEYS, TAPER_PROPERTY_KEY, classifyTaper, collectTaperIssues, } from "./model/taper";
+export type { PotentiometerTaper, TaperIssue, TaperVerdict } from "./model/taper";
+export { componentDevices, deviceTerminalRoles, validateComponentDevices, } from "./model/devices";
+export type { DeviceValidationIssue, ResolvedComponentDevice } from "./model/devices";
 export { AMBIGUOUS_DEVICE_TERMINAL_TOKENS, DEVICE_TERMINAL_ROLES, TERMINAL_ROLES_BY_KIND, collectTerminalRoleWarnings, isLegalTerminalRole, terminalRolesFor, SUFFIXABLE_DEVICE_TERMINAL_ROLES, classifyDeviceTerminalRole, isRoledDeviceKind, resolveComponentTerminalRoles, } from "./model/device-terminal-roles";
 export type { DeviceTerminalRole, DeviceTerminalRoleVerdict, RoledDeviceKind, TerminalRole, } from "./model/device-terminal-roles";
 export type { InterchangeTopologyParseResult } from "./formats/interchange/parser";
@@ -29,7 +33,7 @@ export { isParsedQuantity, isPropertyObject, propertyBooleanValue, propertyNumer
 export { parseQuantity } from "./model/quantity";
 export type { TracePlausibilityOptions } from "./model/trace-plausibility";
 export { traceConnectivityCompleteness, validateAudioTopologyWarnings, validatePreferredValues, validateRcCornerHeuristic, validateTracePlausibility, validateTraceStructure, } from "./model/trace-plausibility";
-export type { BoardApplicability, BoardEdgeTerminal, BoardFamily, BoardFootprint, BoardFootprintCatalog, BoardFootprintPlacement, BoardHole, BoardKind, BoardNet, BoardNetlist, BoardNetMember, BoardNetRef, BoardPlacedPad, BoardRealization, BoardReview, BoardRoute, BoardSourceCircuitHash, BoardSubtype, BuildBom, BuildBomItem, BuildBomRef, BuildBomRefKind, BuildCompleteness, BuildIntent, BuildPartProfile, BuildPartProfileCatalog, BuildScope, CabinetDimensionsM, CabinetDriverLoadout, CabinetEnclosure, CabinetEnclosureProfile, CabinetEnclosureType, CabinetPort, CanonicalCircuitNetRef, CircuitDocument, CircuitDocumentBehaviorFirmwareArtifactType, CircuitDocumentBehaviorFirmwareOwner, CircuitDocumentBehaviorFirmwareRef, CircuitDocumentBehaviorFirmwareSourceVisibility, CircuitDocumentBehaviorFirmwareStatus, CircuitDocumentBehaviorRole, CircuitDocumentBehaviorRoleKind, CircuitDocumentDevice, CircuitDocumentDeviceKind, CircuitPower, CircuitPowerCoverage, CircuitPowerDomain, CircuitPowerGroundPolarity, CircuitPowerRailBinding, CircuitPowerRailDerivation, CircuitPowerRailRole, CircuitPowerSourceKind, Component, ComponentKind, ComponentTerminalRef, ControlApplicabilityPredicate, ControlContext, ControlGroup, ControlGroupMember, ControlInterface, ControlInterfaceAssignmentHint, ControlInterfaceBinding, ControlInterfaceConnector, ControlInterfacePolarity, ControlInterfaceRole, ControlOutput, ControlOutputSwitchMode, DeviceInterface, DeviceInterfaceAudioBinding, DeviceInterfaceBinding, DeviceInterfaceControl, DeviceInterfaceControlKind, DocumentAmpAppearance, DocumentAppearance, DocumentAppearanceLabel, DocumentAppearanceMaterial, DocumentMetadata, DocumentSource, DocumentStompboxAppearance, KnownPhysicalProfile, MechanicalBuildMetadata, MicrophoneAcousticCoupling, MicrophoneElectrical, MicrophoneTransducer, MicrophoneTransducerPrinciple, MicrophoneTransducerProfile, MillimeterRect, OffBoardSignalRef, OffBoardWireAttributes, OffBoardWiringConnection, OffBoardWiringCoverage, OffBoardWiringEndpoint, OffBoardWiringEndpointKind, OffBoardWiringHarness, OffBoardWiringHarnessStatus, OffBoardWiringPlan, PanelColumnOrder, PanelControlKind, PanelControlPlacement, PanelElementBinding, PanelElementPhysicalPlacement, PanelElementPlacement, PanelFace, PanelFaceGeometry, PanelGridIndexing, PanelGridLayout, PanelGridPosition, PanelPlacementMetadata, PanelRowOrder, ParsedQuantity, PhysicalProfileBase, PhysicalProfileIdentity, Point, ProfileResponseRef, PropertyObject, PropertyValue, Rotation, SimulationProfile, SimulationProfileCatalog, SpeakerDriverGeometry, SpeakerDriverProfile, SpeakerDriverSmallSignal, Terminal, VdspBuildDataObject, VdspBuildDataScalar, VdspBuildDataValue, Warning, Wire, } from "./model/types";
+export type { BoardApplicability, BoardEdgeTerminal, BoardFamily, BoardFootprint, BoardFootprintCatalog, BoardFootprintPlacement, BoardHole, BoardKind, BoardNet, BoardNetlist, BoardNetMember, BoardNetRef, BoardPlacedPad, BoardRealization, BoardReview, BoardRoute, BoardSourceCircuitHash, BoardSubtype, BuildBom, BuildBomItem, BuildBomRef, BuildBomRefKind, BuildCompleteness, BuildIntent, BuildPartProfile, BuildPartProfileCatalog, BuildScope, CabinetDimensionsM, CabinetDriverLoadout, CabinetEnclosure, CabinetEnclosureProfile, CabinetEnclosureType, CabinetPort, CanonicalCircuitNetRef, CircuitDocument, CircuitDocumentBehaviorFirmwareArtifactType, CircuitDocumentBehaviorFirmwareOwner, CircuitDocumentBehaviorFirmwareRef, CircuitDocumentBehaviorFirmwareSourceVisibility, CircuitDocumentBehaviorFirmwareStatus, CircuitDocumentBehaviorRole, CircuitDocumentBehaviorRoleKind, CircuitDocumentDevice, CircuitDocumentDeviceKind, CircuitPower, CircuitPowerCoverage, CircuitPowerDomain, CircuitPowerGroundPolarity, CircuitPowerRailBinding, CircuitPowerRailDerivation, CircuitPowerRailRole, CircuitPowerSourceKind, Component, ComponentDevice, ComponentKind, ComponentTerminalRef, ControlApplicabilityPredicate, ControlContext, ControlGroup, ControlGroupMember, ControlInterface, ControlInterfaceAssignmentHint, ControlInterfaceBinding, ControlInterfaceConnector, ControlInterfacePolarity, ControlInterfaceRole, ControlOutput, ControlOutputSwitchMode, DeviceInterface, DeviceInterfaceAudioBinding, DeviceInterfaceBinding, DeviceInterfaceControl, DeviceInterfaceControlKind, DocumentAmpAppearance, DocumentAppearance, DocumentAppearanceLabel, DocumentAppearanceMaterial, DocumentMetadata, DocumentSource, DocumentStompboxAppearance, KnownPhysicalProfile, MechanicalBuildMetadata, MicrophoneAcousticCoupling, MicrophoneElectrical, MicrophoneTransducer, MicrophoneTransducerPrinciple, MicrophoneTransducerProfile, MillimeterRect, OffBoardSignalRef, OffBoardWireAttributes, OffBoardWiringConnection, OffBoardWiringCoverage, OffBoardWiringEndpoint, OffBoardWiringEndpointKind, OffBoardWiringHarness, OffBoardWiringHarnessStatus, OffBoardWiringPlan, PanelColumnOrder, PanelControlKind, PanelControlPlacement, PanelElementBinding, PanelElementPhysicalPlacement, PanelElementPlacement, PanelFace, PanelFaceGeometry, PanelGridIndexing, PanelGridLayout, PanelGridPosition, PanelPlacementMetadata, PanelRowOrder, ParsedQuantity, PhysicalProfileBase, PhysicalProfileIdentity, Point, ProfileResponseRef, PropertyObject, PropertyValue, Rotation, SimulationProfile, SimulationProfileCatalog, SpeakerDriverGeometry, SpeakerDriverProfile, SpeakerDriverSmallSignal, Terminal, VdspBuildDataObject, VdspBuildDataScalar, VdspBuildDataValue, Warning, Wire, } from "./model/types";
 export { EMPTY_DOCUMENT } from "./model/types";
 export type { ControlRole, DocumentValidationContext, DocumentValidationRule, PropertyRule, QuantityRule, StringRule, ValidateDocumentOptions, ValidateSourceRuntimeBoundaryOptions, ValidationCode, ValidationIssue, ValidationSeverity, } from "./model/validation";
 export { CONTROL_ROLE_VALUES, createSourceRuntimeBoundaryRule, getRulesForKind, hasErrors, validateComponent, validateDocument, validateSourceRuntimeBoundary, } from "./model/validation";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,9 +1,11 @@
-export const VERSION = "0.6.29";
+export const VERSION = "0.6.31";
 export { applyDocumentCommand, applyEditorCommand, buildComponent, canRedo, canUndo, createEditorState, resetEditorState, tidyDocumentLayout, } from "./editor/index.js";
 export { parseCircuitJsonDocument, serializeCircuitJsonDocument, validateCircuitJsonDocument, } from "./formats/circuit-json/serializer.js";
 export { convertCircuitDocumentFile, convertCircuitDocumentFileWithReport, detectCircuitDocumentFileFormat, detectCircuitFormat, isVdspFilename, parseCircuitDocument, parseCircuitDocumentFile, parseVdspCircuitDocument, parseVdspCircuitDocumentWithTopology, serializeCircuitDocumentFile, serializeVdspCircuitDocument, validateVdspCircuitDocumentSchema, vdspFileExtension, vdspFilenameFromName, } from "./formats/document.js";
 export { INTERCHANGE_CONTRACT_VERSION } from "./formats/interchange/contract.js";
 export { AMBIGUOUS_POTENTIOMETER_END_TOKENS, POTENTIOMETER_TERMINAL_ROLE_ALIASES, POTENTIOMETER_TERMINAL_ROLES, classifyPotentiometerTerminalRole, resolveDocumentPotentiometerTerminalRoles, resolvePotentiometerTerminalRoles, } from "./model/terminal-roles.js";
+export { POTENTIOMETER_TAPERS, SUPERSEDED_TAPER_PROPERTY_KEYS, TAPER_PROPERTY_KEY, classifyTaper, collectTaperIssues, } from "./model/taper.js";
+export { componentDevices, deviceTerminalRoles, validateComponentDevices, } from "./model/devices.js";
 export { AMBIGUOUS_DEVICE_TERMINAL_TOKENS, DEVICE_TERMINAL_ROLES, TERMINAL_ROLES_BY_KIND, collectTerminalRoleWarnings, isLegalTerminalRole, terminalRolesFor, SUFFIXABLE_DEVICE_TERMINAL_ROLES, classifyDeviceTerminalRole, isRoledDeviceKind, resolveComponentTerminalRoles, } from "./model/device-terminal-roles.js";
 export { parseInterchangeYaml, parseInterchangeYamlWithTopology, } from "./formats/interchange/parser.js";
 export { serializeInterchangeYaml } from "./formats/interchange/serializer.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAShC,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,OAAO,EACP,OAAO,EACP,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,UAAU,CAAC;AAiBlB,OAAO,EACN,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,GAC3B,MAAM,mCAAmC,CAAC;AAiB3C,OAAO,EACN,0BAA0B,EAC1B,oCAAoC,EACpC,+BAA+B,EAC/B,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,oCAAoC,EACpC,4BAA4B,EAC5B,4BAA4B,EAC5B,iCAAiC,EACjC,iBAAiB,EACjB,oBAAoB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EACN,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,iCAAiC,EACjC,yCAAyC,EACzC,iCAAiC,GACjC,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EACN,gCAAgC,EAChC,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,gBAAgB,EAChB,gCAAgC,EAChC,0BAA0B,EAC1B,iBAAiB,EACjB,6BAA6B,GAC7B,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EACN,oBAAoB,EACpB,gCAAgC,GAChC,MAAM,8BAA8B,CAAC;AAKtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM/E,OAAO,EACN,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,+BAA+B,GAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACN,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,GACtB,MAAM,4BAA4B,CAAC;AAmIpC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAc/C,OAAO,EACN,mBAAmB,EACnB,+BAA+B,EAC/B,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,6BAA6B,GAC7B,MAAM,oBAAoB,CAAC;AAkC5B,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,MAAM,EACN,oBAAoB,EACpB,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,GACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACN,yBAAyB,EACzB,wBAAwB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACN,YAAY,EACZ,eAAe,EACf,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAexE,OAAO,EACN,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,EAChB,8BAA8B,EAC9B,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/model/devices.d.ts

@@ -0,0 +1,55 @@
+import type { Component, ComponentKind } from "./types";
+/** A device with its defaults resolved: `kind` filled in, terminals as declared. */
+export type ResolvedComponentDevice = Readonly<{
+    id: string;
+    kind: ComponentKind;
+    /** Terminal names, in declaration order. Order carries no meaning; a law binds by role. */
+    terminals: readonly string[];
+}>;
+/**
+ * Every device in a component, with defaults resolved.
+ *
+ * A component that declares no `devices` yields exactly one, whose id is the component's own,
+ * whose kind is the component's, and which uses every terminal. That is the overwhelming majority
+ * of components, and it is a default rather than a special case: a caller never branches on
+ * whether the list was written down.
+ */
+export declare function componentDevices(component: Component): readonly ResolvedComponentDevice[];
+/**
+ * The role each of a device's terminals declares, keyed by terminal name.
+ *
+ * This is the binding a device law reads. Scoped to one device on purpose: a dual op-amp declares
+ * two of every signal role across its package, and only inside a device is the read unambiguous.
+ * A terminal the device names but the component does not declare, or one carrying no role, is
+ * absent from the map rather than guessed at -- `validateComponentDevices` is what reports it.
+ */
+export declare function deviceTerminalRoles(component: Component, device: ResolvedComponentDevice): ReadonlyMap<string, string>;
+/**
+ * One problem with a declared device list.
+ *
+ * `error` is a malformed declaration -- it refers to a terminal that does not exist, names a
+ * device twice, or claims a role the device's kind cannot carry. `warning` is a well-formed
+ * declaration that may still be incomplete: a terminal belonging to no device is either
+ * decorative or an omission, and the document cannot tell core which.
+ */
+export type DeviceValidationIssue = Readonly<{
+    code: string;
+    severity: "error" | "warning";
+    message: string;
+    componentId: string;
+}>;
+/**
+ * Whether a declared device list is well-formed.
+ *
+ * **Errors are the document's; the sufficiency of a device's roles is not checked here.** How
+ * many plates a rectifier law needs, or whether an op-amp may run without its supplies declared,
+ * is the consuming law's question, and encoding one law's expectations in the format would make
+ * the format wrong for the next law. What this checks is that the declaration refers to things
+ * that exist, does not name the same device twice, and does not claim a role the kind cannot
+ * carry.
+ *
+ * A terminal in no device is a **warning**: it is either decorative (a shield, an unwired lug) or
+ * an omission, and the document cannot tell core which.
+ */
+export declare function validateComponentDevices(component: Component): readonly DeviceValidationIssue[];
+//# sourceMappingURL=devices.d.ts.map

package/dist/model/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../src/model/devices.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,oFAAoF;AACpF,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,2FAA2F;IAC3F,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,SAAS,GAClB,SAAS,uBAAuB,EAAE,CAgBpC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,uBAAuB,GAC7B,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAY7B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,SAAS,GAClB,SAAS,qBAAqB,EAAE,CAgFlC"}

package/dist/model/devices.js

@@ -0,0 +1,140 @@
+// Reading a component's devices, and validating a declared device list.
+//
+// A component models a schematic symbol -- a package -- and a package may hold several devices.
+// `Component.devices` states the split; omitting it means the component is one device. Every
+// consumer should read through `componentDevices()` so the two shapes are one shape, because the
+// alternative is what this construct exists to end: each consumer reconstructing the split from
+// terminal names.
+//
+// See `docs/device-construct-design.md`.
+import { isLegalTerminalRole, terminalRolesFor } from "./device-terminal-roles.js";
+/**
+ * Every device in a component, with defaults resolved.
+ *
+ * A component that declares no `devices` yields exactly one, whose id is the component's own,
+ * whose kind is the component's, and which uses every terminal. That is the overwhelming majority
+ * of components, and it is a default rather than a special case: a caller never branches on
+ * whether the list was written down.
+ */
+export function componentDevices(component) {
+    const declared = component.devices;
+    if (declared === undefined || declared.length === 0) {
+        return [
+            {
+                id: component.id,
+                kind: component.kind,
+                terminals: component.terminals.map((terminal) => terminal.name),
+            },
+        ];
+    }
+    return declared.map((device) => ({
+        id: device.id,
+        kind: device.kind ?? component.kind,
+        terminals: device.terminals,
+    }));
+}
+/**
+ * The role each of a device's terminals declares, keyed by terminal name.
+ *
+ * This is the binding a device law reads. Scoped to one device on purpose: a dual op-amp declares
+ * two of every signal role across its package, and only inside a device is the read unambiguous.
+ * A terminal the device names but the component does not declare, or one carrying no role, is
+ * absent from the map rather than guessed at -- `validateComponentDevices` is what reports it.
+ */
+export function deviceTerminalRoles(component, device) {
+    const byName = new Map(component.terminals.map((terminal) => [terminal.name, terminal]));
+    const roles = new Map();
+    for (const name of device.terminals) {
+        const role = byName.get(name)?.role;
+        if (role !== undefined) {
+            roles.set(name, role);
+        }
+    }
+    return roles;
+}
+/**
+ * Whether a declared device list is well-formed.
+ *
+ * **Errors are the document's; the sufficiency of a device's roles is not checked here.** How
+ * many plates a rectifier law needs, or whether an op-amp may run without its supplies declared,
+ * is the consuming law's question, and encoding one law's expectations in the format would make
+ * the format wrong for the next law. What this checks is that the declaration refers to things
+ * that exist, does not name the same device twice, and does not claim a role the kind cannot
+ * carry.
+ *
+ * A terminal in no device is a **warning**: it is either decorative (a shield, an unwired lug) or
+ * an omission, and the document cannot tell core which.
+ */
+export function validateComponentDevices(component) {
+    const warnings = [];
+    const declaredNames = new Set(component.terminals.map((terminal) => terminal.name));
+    const seenDeviceIds = new Set();
+    const claimed = new Set();
+    for (const device of component.devices ?? []) {
+        if (seenDeviceIds.has(device.id)) {
+            warnings.push({
+                code: "component-device-id-duplicate",
+                severity: "error",
+                message: `device "${device.id}" is declared more than once`,
+                componentId: component.id,
+            });
+        }
+        seenDeviceIds.add(device.id);
+        if (device.terminals.length === 0) {
+            warnings.push({
+                code: "component-device-empty",
+                severity: "error",
+                message: `device "${device.id}" names no terminals`,
+                componentId: component.id,
+            });
+        }
+        const kind = device.kind ?? component.kind;
+        const seenInDevice = new Set();
+        for (const name of device.terminals) {
+            if (!declaredNames.has(name)) {
+                warnings.push({
+                    code: "component-device-terminal-unknown",
+                    severity: "error",
+                    message: `device "${device.id}" names terminal "${name}", which this component does not declare`,
+                    componentId: component.id,
+                });
+                continue;
+            }
+            if (seenInDevice.has(name)) {
+                warnings.push({
+                    code: "component-device-terminal-repeated",
+                    severity: "error",
+                    message: `device "${device.id}" names terminal "${name}" twice`,
+                    componentId: component.id,
+                });
+            }
+            seenInDevice.add(name);
+            claimed.add(name);
+            // A role legal for the package may be illegal for a device of a different kind --
+            // an optocoupler's `led` device cannot carry a `wiper`.
+            const role = component.terminals.find((terminal) => terminal.name === name)?.role;
+            if (role !== undefined && !isLegalTerminalRole(kind, role)) {
+                warnings.push({
+                    code: "component-device-role-illegal",
+                    severity: "error",
+                    message: `device "${device.id}" is a ${kind} and uses terminal "${name}", whose role "${role}" a ${kind} cannot carry; legal roles: ${terminalRolesFor(kind).join(", ") || "(none)"}`,
+                    componentId: component.id,
+                });
+            }
+        }
+    }
+    if ((component.devices ?? []).length > 0) {
+        for (const name of declaredNames) {
+            if (!claimed.has(name)) {
+                warnings.push({
+                    code: "component-device-terminal-orphaned",
+                    severity: "warning",
+                    message: `terminal "${name}" belongs to no device, so nothing executes it`,
+                    componentId: component.id,
+                });
+            }
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=devices.js.map

package/dist/model/devices.js.map

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

package/dist/model/taper.d.ts

@@ -0,0 +1,64 @@
+import type { Component } from "./types";
+/**
+ * The resistance laws a potentiometer track may follow.
+ *
+ * **Spellings are taken from `KnobTaper` in `panel/types.ts`, which shipped first.** That enum is
+ * published API with consumers in `control-ui` and panel extraction, and it already names three
+ * of these laws `linear`, `log` and `reverse-log`. Defining a second spelling for the same fact
+ * here -- `logarithmic` was the first draft -- would have created exactly the two-vocabularies
+ * drift this work exists to remove, inside the same package. The corpus writes `Logarithmic`, so
+ * it is the corpus that backfills; a published enum with consumers is the stronger constraint.
+ *
+ * `log` is the law audio parts also print as "audio", and `reverse-log` the one printed as
+ * "reverse audio", "anti-log" or "negative log". Those are synonyms rather than spellings, so
+ * they are not accepted: a document naming one is a document to correct.
+ *
+ * `custom` is a real, distinct curve with no published form -- a wah's Hot Potz, a Boss G or W
+ * taper. It says "there is a law here and it is none of the above", which is true where
+ * inventing `log` would not be.
+ *
+ * **`unknown` is deliberately absent**, though `KnobTaper` carries it. A panel knob's `taper` is
+ * a required field, so that model needs a value for "not stated"; a component property can simply
+ * be omitted, and absence is the honest way to say the source did not mark the pot.
+ */
+export type PotentiometerTaper = "linear" | "log" | "reverse-log" | "reverse-linear" | "s-curve" | "stepped" | "custom";
+export declare const POTENTIOMETER_TAPERS: readonly PotentiometerTaper[];
+/** The canonical property key. `Sweep` states the same fact and is superseded. */
+export declare const TAPER_PROPERTY_KEY = "Taper";
+/** Superseded keys that state the same fact as {@link TAPER_PROPERTY_KEY}. */
+export declare const SUPERSEDED_TAPER_PROPERTY_KEYS: readonly string[];
+export type TaperVerdict = {
+    readonly status: "canonical";
+    readonly taper: PotentiometerTaper;
+}
+/** The value states that no taper is known. Fix: omit the property. */
+ | {
+    readonly status: "absence";
+}
+/** The value names a package or a range, not a law. */
+ | {
+    readonly status: "not-a-law";
+}
+/** Anything else, including manufacturer letter codes. */
+ | {
+    readonly status: "unrecognized";
+};
+/** Classify one declared taper value. */
+export declare function classifyTaper(value: string): TaperVerdict;
+export type TaperIssue = Readonly<{
+    code: string;
+    severity: "error" | "warning";
+    message: string;
+    componentId: string;
+}>;
+/**
+ * Report a component's taper declaration against the vocabulary.
+ *
+ * Every verdict is a **warning**, not an error, for the reason the terminal-role work settled: a
+ * required vocabulary that refused every document written before it existed would refuse the whole
+ * corpus. The counts are the backfill's remaining work, and each message says what the fix is,
+ * because "unrecognized" alone does not distinguish a letter code from a provenance note from a
+ * package name.
+ */
+export declare function collectTaperIssues(component: Component): readonly TaperIssue[];
+//# sourceMappingURL=taper.d.ts.map

package/dist/model/taper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taper.d.ts","sourceRoot":"","sources":["../../src/model/taper.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,kBAAkB,GAC3B,QAAQ,GACR,KAAK,GACL,aAAa,GACb,gBAAgB,GAChB,SAAS,GACT,SAAS,GACT,QAAQ,CAAC;AAEZ,eAAO,MAAM,oBAAoB,EAAE,SAAS,kBAAkB,EAQ7D,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAAc,CAAC;AAuB3E,MAAM,MAAM,YAAY,GACrB;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE;AACtE,uEAAuE;GACrE;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE;AAChC,uDAAuD;GACrD;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE;AAClC,0DAA0D;GACxD;IAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAevC,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAQzD;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAQH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,SAAS,GAClB,SAAS,UAAU,EAAE,CAyDvB"}

package/dist/model/taper.js

@@ -0,0 +1,160 @@
+// A potentiometer's taper: the resistance law along its track, and the values that state it.
+//
+// **Why this needs a vocabulary.** Taper is audible -- it is how a knob's travel maps to its
+// effect -- and the corpus states it three incompatible ways across *two* keys. Measured over 142
+// documents and 609 potentiometers:
+//
+//   `Taper`  264 declarations, 30 distinct values
+//   `Sweep`  397 declarations, 16 distinct values
+//   both on the same component: 57
+//
+// Those 57 are the proof that the two keys are one fact: `Taper: B` sits beside `Sweep: Linear`
+// 26 times, `Taper: A` beside `Sweep: Logarithmic` 8 times, `Taper: C` beside
+// `Sweep: ReverseLogarithmic` or `ReverseAudio` 7 times. One is the manufacturer's letter code,
+// the other the law's English name. **`Taper` is the canonical key and `Sweep` is superseded.**
+//
+// **The canonical values are the law, not the notation, and letter codes are deliberately not
+// accepted.** `A`, `B` and `C` are manufacturer markings whose meaning is a convention rather
+// than a definition -- the mapping above is the Japanese/Alps convention this corpus happens to
+// use, and it is not universal. Reading a printed marking as a law would be exactly the inference
+// this format is removing elsewhere. The marking is source provenance and belongs in a source
+// property beside the rest of what the part is printed with; the law goes here.
+//
+// **Three classes of existing value are not tapers at all**, and `classifyTaper` reports them
+// separately because the fix differs:
+//
+//   provenance   `source-unmarked`, `Unknown`, `not-visible`, `source-unspecified` -- these say
+//                the source did not state a taper. The fix is to omit the property, not to
+//                invent a value for absence.
+//   form factor  `trim`/`Trim` -- a trimmer is a physical package, not a resistance law. A trim
+//                pot still has a taper, usually linear, and this value states neither.
+//   range        `0..1` -- a travel range, not a law.
+import { normalizeToken } from "./tokens.js";
+export const POTENTIOMETER_TAPERS = [
+    "linear",
+    "log",
+    "reverse-log",
+    "reverse-linear",
+    "s-curve",
+    "stepped",
+    "custom",
+];
+/** The canonical property key. `Sweep` states the same fact and is superseded. */
+export const TAPER_PROPERTY_KEY = "Taper";
+/** Superseded keys that state the same fact as {@link TAPER_PROPERTY_KEY}. */
+export const SUPERSEDED_TAPER_PROPERTY_KEYS = ["Sweep"];
+/**
+ * Values that state the *absence* of a taper rather than a taper.
+ *
+ * A source that does not mark its pots is a real and common situation, and the honest declaration
+ * is no `Taper` property at all. A magic value for absence is worse than absence: a consumer must
+ * then know that `Unknown` is not a law, which is the kind of tribal knowledge a typed vocabulary
+ * exists to remove.
+ */
+const ABSENCE_VALUES = new Set([
+    "unknown",
+    "source-unmarked",
+    "source-marked",
+    "source-unspecified",
+    "not-visible",
+    "unspecified",
+    "none",
+]);
+/** Values naming a physical package or a travel range rather than a resistance law. */
+const NOT_A_LAW_VALUES = new Set(["trim", "0..1"]);
+/**
+ * Normalize a declared taper to the canonical token shape.
+ *
+ * Beyond `normalizeToken`'s case and separator folding, a word boundary written as CamelCase is
+ * split: `ReverseLogarithmic` and `reverse-logarithmic` are the same word sequence joined two
+ * ways, so accepting both is normalization rather than aliasing. What is *not* normalized is a
+ * synonym -- `Audio` names the same law as `logarithmic` under a different word, and accepting it
+ * would be the accommodation this vocabulary exists to avoid.
+ */
+function normalizeTaperToken(value) {
+    return normalizeToken(value.replace(/([a-z0-9])([A-Z])/g, "$1-$2"));
+}
+/** Classify one declared taper value. */
+export function classifyTaper(value) {
+    const token = normalizeTaperToken(value);
+    if (POTENTIOMETER_TAPERS.includes(token)) {
+        return { status: "canonical", taper: token };
+    }
+    if (ABSENCE_VALUES.has(token))
+        return { status: "absence" };
+    if (NOT_A_LAW_VALUES.has(token))
+        return { status: "not-a-law" };
+    return { status: "unrecognized" };
+}
+const TAPER_BEARING_KINDS = new Set([
+    "potentiometer",
+    "variable-resistor",
+    "rheostat",
+]);
+/**
+ * Report a component's taper declaration against the vocabulary.
+ *
+ * Every verdict is a **warning**, not an error, for the reason the terminal-role work settled: a
+ * required vocabulary that refused every document written before it existed would refuse the whole
+ * corpus. The counts are the backfill's remaining work, and each message says what the fix is,
+ * because "unrecognized" alone does not distinguish a letter code from a provenance note from a
+ * package name.
+ */
+export function collectTaperIssues(component) {
+    if (!TAPER_BEARING_KINDS.has(component.kind))
+        return [];
+    const issues = [];
+    const properties = component.properties;
+    for (const key of SUPERSEDED_TAPER_PROPERTY_KEYS) {
+        if (properties[key] !== undefined) {
+            issues.push({
+                code: "taper-property-superseded",
+                severity: "warning",
+                message: `property "${key}" states the same fact as "${TAPER_PROPERTY_KEY}"; declare the taper law under "${TAPER_PROPERTY_KEY}" only`,
+                componentId: component.id,
+            });
+        }
+    }
+    const declared = properties[TAPER_PROPERTY_KEY];
+    if (declared === undefined)
+        return issues;
+    if (typeof declared !== "string") {
+        issues.push({
+            code: "taper-not-a-string",
+            severity: "warning",
+            message: `property "${TAPER_PROPERTY_KEY}" must be one of: ${POTENTIOMETER_TAPERS.join(", ")}`,
+            componentId: component.id,
+        });
+        return issues;
+    }
+    const verdict = classifyTaper(declared);
+    switch (verdict.status) {
+        case "canonical":
+            return issues;
+        case "absence":
+            issues.push({
+                code: "taper-states-absence",
+                severity: "warning",
+                message: `"${declared}" says no taper is known rather than naming a law; omit the "${TAPER_PROPERTY_KEY}" property instead`,
+                componentId: component.id,
+            });
+            return issues;
+        case "not-a-law":
+            issues.push({
+                code: "taper-not-a-law",
+                severity: "warning",
+                message: `"${declared}" names a package or a travel range, not a resistance law; a trimmer still has a taper, and this states neither`,
+                componentId: component.id,
+            });
+            return issues;
+        default:
+            issues.push({
+                code: "taper-unrecognized",
+                severity: "warning",
+                message: `"${declared}" is not a taper law. A manufacturer letter code is a printed marking whose meaning is a convention, not a definition -- record it as source provenance and declare the law here, one of: ${POTENTIOMETER_TAPERS.join(", ")}`,
+                componentId: component.id,
+            });
+            return issues;
+    }
+}
+//# sourceMappingURL=taper.js.map

package/dist/model/taper.js.map

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

package/dist/model/types.d.ts

@@ -60,14 +60,58 @@ export type CircuitDocumentBehaviorRole = Readonly<{
     kind: CircuitDocumentBehaviorRoleKind;
     firmwareRef?: CircuitDocumentBehaviorFirmwareRef;
 }>;
+/**
+ * One device inside a component's package.
+ *
+ * A component models a schematic **symbol**, which may hold several devices: a dual rectifier is
+ * two diodes on one cathode, a dual op-amp two amplifiers on one supply pair, an optocoupler an
+ * LED beside a photoresistor. Consumers need the devices, and before this construct each one
+ * reconstructed the split by parsing terminal names.
+ *
+ * See `docs/device-construct-design.md` for the survey this is built from and for the two cases
+ * that are *not* uses of it: transformer windings and switch poles both group the terminals of a
+ * single device, which is the opposite claim.
+ */
+export type ComponentDevice = Readonly<{
+    /** Unique within its component. Addressable as `<componentId>.<deviceId>`. */
+    id: string;
+    /**
+     * This device's law. Omitted means the component's own `kind`, which is the common case; an
+     * optocoupler is why it can differ, holding an `led` and a `variable-resistor`.
+     */
+    kind?: ComponentKind;
+    /**
+     * The component terminals this device uses, by `name`.
+     *
+     * By name rather than index or position: a name is already unique within its component -- the
+     * `nodes` ledger addresses pins as `<componentId>.<name>` and core refuses duplicates -- so a
+     * name is a sufficient reference, and stating membership here is what an index could not do.
+     *
+     * A terminal may appear in several devices. The shared cathode of a dual rectifier and the
+     * shared supplies of a dual op-amp are the ordinary case, not an exception.
+     *
+     * Order carries no meaning. A device binds by the `role` its terminals declare, and the
+     * ambiguity a role could not resolve existed only across the whole package.
+     */
+    terminals: readonly string[];
+}>;
 export type Component = Readonly<{
     id: string;
+    /** What this package primarily is, and the default `kind` of every device inside it. */
     kind: ComponentKind;
     name: string;
     origin: Point;
     rotation: Rotation;
     flipped: boolean;
     terminals: readonly Terminal[];
+    /**
+     * The devices this package contains.
+     *
+     * Omitted means exactly one device, of the component's `kind`, using all its terminals --
+     * which is what nearly every component is, and why declaring it is not required. Use
+     * `componentDevices()` to read either shape uniformly.
+     */
+    devices?: readonly ComponentDevice[];
     properties: Readonly<Record<string, PropertyValue>>;
     sourceTypeName: string | null;
 }>;