@cascode/cascode-js 0.5.2

package/README.md

@@ -0,0 +1,98 @@
+# @cascode/native
+
+Synchronous Node binding for the Cascode native C ABI.
+
+This package exposes a thin N-API wrapper around the `cascode_*` exports from
+`Cascode.Native` and intentionally does not add threading or async behavior.
+
+## Install
+
+```bash
+npm install @cascode/native
+```
+
+## Runtime Requirements
+
+`@cascode/native` needs two native layers:
+
+1. Node addon (`cascode_native_addon.node`)
+2. Cascode shared library (`Cascode.Native.*`) plus runtime dependencies
+
+At runtime, `@cascode/native` resolves in this order:
+
+1. Platform package (optional dependency), for example:
+   - `@cascode/native-win32-x64`
+   - `@cascode/native-linux-x64`
+   - `@cascode/native-darwin-x64`
+   - `@cascode/native-darwin-arm64`
+2. Local development build (`editors/node/build/Release`)
+3. Local native runtime discovery:
+  - `editors/node/native/<rid>/`
+  - `<repo>/build/native/<rid>/`
+
+`CASCODE_NATIVE_LIB` always overrides discovered shared-library paths.
+
+RID examples: `win-x64`, `linux-x64`, `darwin-x64`, `darwin-arm64`.
+
+## Local Co-Development With Designer
+
+For active development across repos, point Designer at your local module path
+instead of waiting for a release:
+
+```powershell
+$env:DESIGNER_CASCODE_NATIVE_MODULE="C:\Projects\Repositories\cascode\editors\node"
+```
+
+Then in `cascode/editors/node`:
+
+```powershell
+npm ci --omit=optional
+npm run build
+```
+
+And publish local native runtime once:
+
+```powershell
+dotnet publish tools/native/Cascode.Native/Cascode.Native.csproj `
+  --configuration Release `
+  -r win-x64 `
+  -p:PublishAot=true `
+  -o build/native/win-x64
+```
+
+## Build
+
+```bash
+npm ci
+npm run build
+```
+
+## Test
+
+Publish a native library first, then run tests:
+
+```bash
+dotnet publish tools/native/Cascode.Native/Cascode.Native.csproj \
+  --configuration Release \
+  -r linux-x64 \
+  -p:PublishAot=true \
+  -o build/native/linux-x64
+
+export CASCODE_NATIVE_LIB="$PWD/build/native/linux-x64/Cascode.Native.so"
+cd editors/node
+npm test
+```
+
+Windows equivalent:
+
+```powershell
+dotnet publish tools/native/Cascode.Native/Cascode.Native.csproj `
+  --configuration Release `
+  -r win-x64 `
+  -p:PublishAot=true `
+  -o build/native/win-x64
+
+$env:CASCODE_NATIVE_LIB="$PWD\\build\\native\\win-x64\\Cascode.Native.dll"
+cd editors\node
+npm test
+```

package/binding.gyp

@@ -0,0 +1,26 @@
+{
+  "targets": [
+    {
+      "target_name": "cascode_native_addon",
+      "sources": [
+        "native/cascode_native_addon.c"
+      ],
+      "cflags": [
+        "-std=c11"
+      ],
+      "xcode_settings": {
+        "CLANG_CXX_LANGUAGE_STANDARD": "c++17"
+      },
+      "conditions": [
+        [
+          "OS==\"linux\" or OS==\"mac\"",
+          {
+            "libraries": [
+              "-ldl"
+            ]
+          }
+        ]
+      ]
+    }
+  ]
+}

package/lib/std/Bundles.cas

@@ -0,0 +1,6 @@
+library lib.std
+
+bundle Diff {
+  P : analog
+  N : analog
+}

package/lib/std/InverterLike.cas

@@ -0,0 +1,11 @@
+library lib.std;
+
+interface InverterLike {
+  port in  IN  : digital;
+  port out OUT : digital;
+  supply VDD; ground GND;
+
+  // Typical guarantees; library char{ } refines and verifies these bounds
+  ens voh(OUT) >= 0.9*VDD;
+  ens vol(OUT) <= 0.1*VDD;
+}

package/lib/std/amp/Common.cas

@@ -0,0 +1,16 @@
+library lib.std.amp
+
+interface CurrentMirrorLike {
+  input SENSE : analog
+  output TAP[0] : analog
+  connectors {
+    to DiffPairLike {
+      SENSE--OUT.N
+      TAP[0]--OUT.P
+    }
+  }
+}
+  
+interface DiffPairLike {
+  output OUT : Diff
+}

package/lib/std/amp/FullyDifferentialOpAmp.cas

@@ -0,0 +1,61 @@
+library lib.std.amp
+include lib.std.bench
+
+// Interface: Fully-differential operational amplifier.
+//
+// Binds the standard library benches for common fully-differential amplifier metrics.
+interface FullyDifferentialOpAmp {
+  supply VDD
+  ground GND
+  input IN : Diff
+  output OUT : Diff
+  input VTAIL : bias
+
+  benches {
+    bind QuiescentPower as vdd_pwr {
+      bench.PWR--dut.VDD
+      bench.RET--dut.GND
+    }
+
+    bind DiffDCBias as dc_bias {
+      bench.OUT--dut.OUT
+    }
+
+    bind DiffToDiffTransfer as transfer_bench {
+      bench.IN--dut.IN
+      bench.OUT--dut.OUT
+    }
+
+    bind DiffToDiffNoise as noise_bench {
+      bench.IN--dut.IN
+      bench.OUT--dut.OUT
+    }
+
+    bind DiffToDiffTran as tran_bench {
+      bench.IN--dut.IN
+      bench.OUT--dut.OUT
+    }
+
+    bind DiffCMRejection as cmrr_bench {
+      bench.CM--dut.IN.P
+      bench.CM--dut.IN.N
+      bench.OUT--dut.OUT
+
+      // Binding exports are adapters (not overrides): this exports a no-arg `CMRR` by forwarding to
+      // the underlying bench's `CMRR(dmGain=...)` with a default dmGain source.
+      measurements {
+        measurement CMRR : dB = base::CMRR(dmGain=transfer_bench::PassbandGain)
+      }
+    }
+
+    bind SupplyToDiffRejection as psrr_bench {
+      bench.IN--dut.IN
+      bench.PWR--dut.VDD
+      bench.OUT--dut.OUT
+
+      measurements {
+        measurement InputReferredPSRR : dB = base::InputReferredPSRR(dmGain=transfer_bench::PassbandGain)
+      }
+    }
+  }
+}

package/lib/std/amp/SingleEndedAmp.cas

@@ -0,0 +1,48 @@
+library lib.std.amp
+include lib.std.bench
+
+// Interface: Single-ended amplifier (single-ended input, single-ended output).
+//
+// Provides ports and standard bench bindings for common small-signal and time-domain metrics.
+interface SingleEndedAmp {
+  supply VDD
+  ground GND
+  input IN : analog
+  output OUT : analog
+
+  benches {
+    bind QuiescentPower as vdd_pwr {
+      bench.PWR--dut.VDD
+      bench.RET--dut.GND
+    }
+
+    bind SEDCBias as dc_bias {
+      bench.OUT--dut.OUT
+    }
+
+    bind SEToSETransfer as transfer_bench {
+      bench.IN--dut.IN
+      bench.OUT--dut.OUT
+    }
+
+    bind SEToSENoise as noise_bench {
+      bench.IN--dut.IN
+      bench.OUT--dut.OUT
+    }
+
+    bind SEToSETran as tran_bench {
+      bench.IN--dut.IN
+      bench.OUT--dut.OUT
+    }
+
+    bind SupplyToSERejectionSEInput as psrr_bench {
+      bench.IN--dut.IN
+      bench.PWR--dut.VDD
+      bench.OUT--dut.OUT
+
+      measurements {
+        measurement InputReferredPSRR : dB = base::InputReferredPSRR(dmGain=transfer_bench::PassbandGain)
+      }
+    }
+  }
+}

package/lib/std/amp/SingleEndedOpAmp.cas

@@ -0,0 +1,48 @@
+library lib.std.amp
+include lib.std.bench
+
+// Interface: Single-ended operational amplifier (differential input, single-ended output).
+// Provides ports and bench metric mappings for Amplifier metrics.
+
+interface SingleEndedOpAmp {
+  supply VDD
+  ground GND
+  input IN : Diff
+  output OUT : analog
+
+  benches {
+    bind QuiescentPower as vdd_pwr {
+      bench.PWR--dut.VDD
+      bench.RET--dut.GND
+    }
+
+    bind SEDCBias as dc_bias {
+      bench.OUT--dut.OUT
+    }
+
+    bind DiffToSETransfer as transfer_bench {
+      bench.IN--dut.IN
+      bench.OUT--dut.OUT
+    }
+
+    bind DiffToSENoise as noise_bench {
+      bench.IN--dut.IN
+      bench.OUT--dut.OUT
+    }
+
+    bind DiffToSETran as tran_bench {
+      bench.IN--dut.IN
+      bench.OUT--dut.OUT
+    }
+
+    bind SupplyToSERejection as psrr_bench {
+      bench.IN--dut.IN
+      bench.PWR--dut.VDD
+      bench.OUT--dut.OUT
+
+      measurements {
+        measurement InputReferredPSRR : dB = base::InputReferredPSRR(dmGain=transfer_bench::PassbandGain)
+      }
+    }
+  }
+}

package/lib/std/bench/DCBiasBenches.cas

@@ -0,0 +1,41 @@
+VERSION 3.1
+
+library lib.std.bench
+
+abstract bench AbstractDCBias {
+  abstract resp OUT
+
+  analysis {
+    DCAnalysis dc = new DCAnalysis()
+  }
+
+  measurements {
+    measurement OutputDCCommonMode : V {
+      return voltage(dc, OUT)
+    }
+  }
+}
+
+bench SEDCBias extends AbstractDCBias {
+  resp OUT : analog
+
+  fill { }
+
+  measurements {
+    measurement OutputDCBias : V {
+      return voltage(dc, OUT)
+    }
+  }
+}
+
+bench DiffDCBias extends AbstractDCBias {
+  resp OUT : Diff
+
+  fill { }
+
+  measurements {
+    override measurement OutputDCCommonMode : V {
+      return (voltage(dc, OUT.P) + voltage(dc, OUT.N)) / 2
+    }
+  }
+}

package/lib/std/bench/NoiseBenches.cas

@@ -0,0 +1,167 @@
+VERSION 3.1
+
+library lib.std.bench
+
+abstract bench AbstractNoise {
+  abstract stim IN
+  abstract resp OUT
+
+  analysis {
+    // ACAnalysis required for input_referred_noise to compute transfer function
+    ACAnalysis ac = new ACAnalysis(
+      space=Log,
+      samples=100,
+      start=(if constraints.HighpassBandwidth { constraints.HighpassBandwidth * 0.1 } else { 1Hz }),
+      stop=(if constraints.GainBandwidth { constraints.GainBandwidth * 10 } else { 10GHz }))
+
+    NoiseAnalysis noise_ac = new NoiseAnalysis(
+      space=Log,
+      samples=100,
+      start=(if constraints.HighpassBandwidth { constraints.HighpassBandwidth * 0.1 } else { 1Hz }),
+      stop=(if constraints.GainBandwidth { constraints.GainBandwidth * 10 } else { 10GHz }),
+      output=OUT)
+  }
+
+  measurements {
+    measurement InputReferredNoise : V/rtHz {
+      // input_referred_noise uses paired ACAnalysis to compute transfer function
+      NoiseSpectrum n_in = input_referred_noise(noise_ac, ac, IN, OUT)
+      Frequency f_spot = (if constraints.SpotNoiseFrequency { constraints.SpotNoiseFrequency } else { 1kHz })
+      return n_in.ValueAt(f_spot)
+    }
+
+    measurement IntegratedInputNoise(Frequency from, Frequency to) : Vrms {
+      NoiseSpectrum n_in = input_referred_noise(noise_ac, ac, IN, OUT)
+      return n_in.Integrate(from, to)
+    }
+
+    measurement OutputNoise : V/rtHz {
+      NoiseSpectrum n_out = noise(noise_ac, OUT)
+      Frequency f_spot = (if constraints.SpotNoiseFrequency { constraints.SpotNoiseFrequency } else { 1kHz })
+      return n_out.ValueAt(f_spot)
+    }
+  }
+}
+
+bench DiffToSENoise extends AbstractNoise {
+  stim IN : Diff
+  resp OUT : analog
+
+  fill {
+    net vcm : analog
+    net gnd : ground
+
+    GND _ = new GND() {
+      .GND--gnd
+    }
+
+    VDC commonModeVDC = new VDC(V=env.InputCommonModeRange) {
+      .P--vcm
+      .N--gnd
+    }
+
+    // Provide an AC-defined input source for ngspice noise analysis.
+    // The actual input-referred noise computation uses the paired ACAnalysis transfer function.
+    VAC acP = new VAC(A=0.5V, phase=0deg) {
+      .N--vcm
+    }
+    VAC acN = new VAC(A=0.5V, phase=180deg) {
+      .N--vcm
+    }
+
+    Impedor sourceP = new Impedor(Z=env.SourceImpedance.DiffToShunt()) { }
+    Impedor sourceN = new Impedor(Z=env.SourceImpedance.DiffToShunt()) { }
+
+    acP.P--sourceP.P
+    sourceP.N--IN.P
+
+    acN.P--sourceN.P
+    sourceN.N--IN.N
+
+    Impedor loadZ = new Impedor(Z=env.LoadImpedance) {
+      .P--OUT
+      .N--gnd
+    }
+  }
+}
+
+bench DiffToDiffNoise extends AbstractNoise {
+  stim IN : Diff
+  resp OUT : Diff
+
+  fill {
+    net vcm : analog
+    net gnd : ground
+
+    GND _ = new GND() {
+      .GND--gnd
+    }
+
+    VDC commonModeVDC = new VDC(V=env.InputCommonModeRange) {
+      .P--vcm
+      .N--gnd
+    }
+
+    // Provide an AC-defined input source for ngspice noise analysis.
+    // The actual input-referred noise computation uses the paired ACAnalysis transfer function.
+    VAC acP = new VAC(A=0.5V, phase=0deg) {
+      .N--vcm
+    }
+    VAC acN = new VAC(A=0.5V, phase=180deg) {
+      .N--vcm
+    }
+
+    Impedor sourceP = new Impedor(Z=env.SourceImpedance.DiffToShunt()) { }
+    Impedor sourceN = new Impedor(Z=env.SourceImpedance.DiffToShunt()) { }
+
+    acP.P--sourceP.P
+    sourceP.N--IN.P
+
+    acN.P--sourceN.P
+    sourceN.N--IN.N
+
+    // Differential target load. Diff benches split this to per-side shunts via DiffToShunt().
+    Impedor loadP = new Impedor(Z=env.LoadImpedance.DiffToShunt()) {
+      .P--OUT.P
+      .N--gnd
+    }
+    Impedor loadN = new Impedor(Z=env.LoadImpedance.DiffToShunt()) {
+      .P--OUT.N
+      .N--gnd
+    }
+  }
+}
+
+bench SEToSENoise extends AbstractNoise {
+  stim IN : analog
+  resp OUT : analog
+
+  fill {
+    net vcm : analog
+    net gnd : ground
+
+    GND _ = new GND() {
+      .GND--gnd
+    }
+
+    VDC biasDC = new VDC(V=env.InputCommonModeRange) {
+      .P--vcm
+      .N--gnd
+    }
+
+    // Provide an AC-defined input source for ngspice noise analysis.
+    // The actual input-referred noise computation uses the paired ACAnalysis transfer function.
+    VAC ac = new VAC(A=1V, phase=0deg) {
+      .N--vcm
+    }
+
+    Impedor sourceZ = new Impedor(Z=env.SourceImpedance) { }
+    ac.P--sourceZ.P
+    sourceZ.N--IN
+
+    Impedor loadZ = new Impedor(Z=env.LoadImpedance) {
+      .P--OUT
+      .N--gnd
+    }
+  }
+}