smithkit 0.1.0 → 0.2.0

package/dist/lib/rf.js

@@ -1,74 +0,0 @@
-import { Complex } from './complex/Complex.js';
-import { SmithConstantCircle } from './SmithConstantCircle.js';
-const calcs = new SmithConstantCircle();
-function validateReference(referenceImpedanceOhms) {
-    if (!Number.isFinite(referenceImpedanceOhms) || referenceImpedanceOhms <= 0) {
-        throw new RangeError('Reference impedance must be positive and finite.');
-    }
-}
-function validateComplex(value) {
-    if (!Number.isFinite(value.re) || !Number.isFinite(value.im)) {
-        throw new RangeError('Complex components must be finite.');
-    }
-}
-function finite(value) {
-    return value && Number.isFinite(value.re) && Number.isFinite(value.im) ? value : undefined;
-}
-/** Convert Γ to physical impedance in ohms; undefined at the open circuit Γ = 1. */
-export function reflectionToImpedance(gamma, referenceImpedanceOhms = 50) {
-    validateReference(referenceImpedanceOhms);
-    validateComplex(gamma);
-    return finite(calcs.rflCoeffToImpedance(gamma)?.mul(referenceImpedanceOhms));
-}
-/** Convert physical impedance in ohms to Γ. Undefined for a singular result. */
-export function impedanceToReflection(impedanceOhms, referenceImpedanceOhms = 50) {
-    validateReference(referenceImpedanceOhms);
-    validateComplex(impedanceOhms);
-    return finite(calcs.impedanceToRflCoeff(impedanceOhms.div(referenceImpedanceOhms)));
-}
-/** Convert Γ to physical admittance in siemens; undefined at the short circuit Γ = −1. */
-export function reflectionToAdmittance(gamma, referenceImpedanceOhms = 50) {
-    validateReference(referenceImpedanceOhms);
-    validateComplex(gamma);
-    return finite(calcs.rflCoeffToAdmittance(gamma)?.div(referenceImpedanceOhms));
-}
-/** Convert physical admittance in siemens to Γ. Undefined for a singular result. */
-export function admittanceToReflection(admittanceSiemens, referenceImpedanceOhms = 50) {
-    validateReference(referenceImpedanceOhms);
-    validateComplex(admittanceSiemens);
-    return finite(calcs.admittanceToRflCoeff(admittanceSiemens.mul(referenceImpedanceOhms)));
-}
-/**
- * Read Γ without a chart or DOM. Undefined means a singular or inapplicable quantity.
- * Passive-load quantities are undefined outside |Γ| ≤ 1; exact infinite limits are retained.
- * Attenuation assumes a fully reflecting termination and is half the return loss.
- */
-export function readReflection(gamma, referenceImpedanceOhms = 50) {
-    const impedanceOhms = reflectionToImpedance(gamma, referenceImpedanceOhms);
-    const admittanceSiemens = reflectionToAdmittance(gamma, referenceImpedanceOhms);
-    const magnitude = gamma.abs();
-    const passive = magnitude <= 1;
-    const returnLossDb = -20 * Math.log10(magnitude);
-    const vswr = passive ? (1 + magnitude) / (1 - magnitude) : undefined;
-    return {
-        reflectionCoefficient: gamma,
-        impedanceOhms,
-        admittanceSiemens,
-        phaseDegrees: magnitude === 0 ? undefined : (gamma.arg() * 180) / Math.PI,
-        vswr,
-        standingWaveRatioDb: vswr === undefined ? undefined : 20 * Math.log10(vswr),
-        returnLossDb,
-        reflectionLossDb: passive ? (-10 / Math.LN10) * Math.log1p(-(magnitude ** 2)) : undefined,
-        attenuationDb: passive ? returnLossDb / 2 : undefined,
-        q: impedanceOhms && (impedanceOhms.re !== 0 || impedanceOhms.im !== 0)
-            ? Math.abs(impedanceOhms.im / impedanceOhms.re)
-            : undefined,
-        powerReflectionCoefficient: magnitude ** 2,
-        voltageReflectionCoefficientMagnitude: magnitude,
-        powerTransmissionCoefficient: passive ? 1 - magnitude ** 2 : undefined,
-        voltageTransmissionCoefficientMagnitude: gamma.add(1).abs(),
-        currentTransmissionCoefficientMagnitude: Complex.one().sub(gamma).abs(),
-        standingWavePeak: vswr === undefined ? undefined : Math.sqrt(vswr),
-        standingWaveLossCoefficient: passive ? (1 + magnitude ** 2) / (1 - magnitude ** 2) : undefined,
-    };
-}

package/dist/lib/scales/peripheralScales.d.ts

@@ -1,12 +0,0 @@
-import type { Complex } from '../complex/Complex.js';
-export interface PeripheralScale {
-    id: string;
-    title: string;
-    unit: '°' | 'λ';
-    ticks: number[];
-    major: (value: number) => boolean;
-    angle: (value: number) => number;
-    read: (gamma: Complex) => number | null;
-}
-/** A full reflection-coefficient rotation represents half a wavelength along the line. */
-export declare function peripheralScales(): PeripheralScale[];

package/dist/lib/scales/peripheralScales.js

@@ -1,49 +0,0 @@
-function phase(gamma) {
-    return gamma.re === 0 && gamma.im === 0 ? null : (Math.atan2(gamma.im, gamma.re) * 180) / Math.PI;
-}
-/** A full reflection-coefficient rotation represents half a wavelength along the line. */
-export function peripheralScales() {
-    const wavelengths = (gamma, direction) => {
-        const degrees = phase(gamma);
-        return degrees === null ? null : (0.25 + (direction * degrees) / 720 + 0.5) % 0.5;
-    };
-    return [
-        {
-            id: 'transmission-phase',
-            title: 'Transmission phase · °',
-            unit: '°',
-            ticks: Array.from({ length: 179 }, (_, i) => -89 + i),
-            major: (v) => v % 5 === 0,
-            // Project from Γ = −1 to the perimeter, not from the chart center.
-            angle: (v) => 2 * v,
-            read: (gamma) => phase({ re: 1 + gamma.re, im: gamma.im }),
-        },
-        {
-            id: 'reflection-phase',
-            title: 'Reflection phase · °',
-            unit: '°',
-            ticks: Array.from({ length: 180 }, (_, i) => -178 + i * 2),
-            major: (v) => v % 10 === 0,
-            angle: (v) => v,
-            read: phase,
-        },
-        {
-            id: 'wavelengths-load',
-            title: 'Wavelengths → load',
-            unit: 'λ',
-            ticks: Array.from({ length: 250 }, (_, i) => i / 500),
-            major: (v) => Math.round(v * 500) % 5 === 0,
-            angle: (v) => 720 * v - 180,
-            read: (gamma) => wavelengths(gamma, 1),
-        },
-        {
-            id: 'wavelengths-generator',
-            title: 'Wavelengths → generator',
-            unit: 'λ',
-            ticks: Array.from({ length: 250 }, (_, i) => i / 500),
-            major: (v) => Math.round(v * 500) % 5 === 0,
-            angle: (v) => 180 - 720 * v,
-            read: (gamma) => wavelengths(gamma, -1),
-        },
-    ];
-}

package/dist/lib/scales/radialScales.d.ts

@@ -1,12 +0,0 @@
-import type { Complex } from '../complex/Complex.js';
-export interface RadialScale {
-    id: string;
-    title: string;
-    description?: string;
-    unit: 'dB' | 'ratio';
-    read: (gamma: Complex) => number;
-    values: number[];
-    position: (value: number) => number;
-}
-/** Normalized positions along each scale, from zero to one. */
-export declare function radialScales(): RadialScale[];

package/dist/lib/scales/radialScales.js

@@ -1,109 +0,0 @@
-import { SmithConstantCircle } from '../SmithConstantCircle.js';
-/** Normalized positions along each scale, from zero to one. */
-export function radialScales() {
-    const calcs = new SmithConstantCircle();
-    return [
-        {
-            id: 'vswr',
-            unit: 'ratio',
-            read: (gamma) => calcs.rflCoeffToSwr(gamma),
-            title: 'VSWR',
-            values: [1, 1.5, 2, 3, 5, 10, Infinity],
-            position: (v) => (v === Infinity ? 1 : calcs.swrToRflCoeffEOrI(v)),
-        },
-        {
-            id: 'vswr-db',
-            unit: 'dB',
-            read: (gamma) => calcs.rflCoeffToDBS(gamma),
-            title: 'Standing-wave ratio · dB',
-            values: [0, 3, 6, 10, 15, 20, Infinity],
-            position: (v) => (v === Infinity ? 1 : calcs.dBSToAbsRflCoeff(v)),
-        },
-        {
-            id: 'return-loss',
-            unit: 'dB',
-            read: (gamma) => calcs.rflCoeffToReturnLoss(gamma),
-            title: 'Return loss · dB',
-            values: [Infinity, 20, 14, 10, 6, 3, 0],
-            position: (v) => calcs.returnLossToRflCoeffEOrI(v),
-        },
-        {
-            id: 'mismatch-loss',
-            unit: 'dB',
-            read: (gamma) => calcs.rflCoeffToMismatchLoss(gamma),
-            title: 'Reflection loss · dB',
-            description: 'Reflection loss (mismatch loss): −10 log10(1 − |Γ|²), in dB.',
-            values: [0, 0.1, 0.5, 1, 2, 4, Infinity],
-            position: (v) => calcs.mismatchLossToRflCoeffEOrI(v),
-        },
-        {
-            id: 'reflected-power',
-            unit: 'ratio',
-            read: (gamma) => calcs.rflCoeffP(gamma),
-            title: 'Power reflection coefficient',
-            description: 'Reflected power divided by incident power: |Γ|² (dimensionless).',
-            values: [0, 0.01, 0.1, 0.25, 0.5, 0.75, 1],
-            position: (v) => calcs.rflCoeffPToEOrI(v),
-        },
-        {
-            id: 'transmitted-power',
-            unit: 'ratio',
-            read: (gamma) => calcs.rflCoeffToTransmCoeffP(gamma),
-            title: 'Power transmission coefficient',
-            description: 'Net power delivered to the load divided by incident power: 1 − |Γ|² (dimensionless).',
-            values: [1, 0.99, 0.9, 0.75, 0.5, 0.25, 0],
-            position: (v) => calcs.transmCoeffPToRflCoeffEOrI(v),
-        },
-        {
-            id: 'standing-wave-loss',
-            unit: 'ratio',
-            read: (gamma) => calcs.rflCoeffToSwLossCoeff(gamma),
-            title: 'Standing-wave loss coefficient',
-            values: [1, 1.1, 1.5, 2, 3, 5, Infinity],
-            position: (v) => (v === Infinity ? 1 : calcs.swLossCoeffToRflCoeffEOrI(v)),
-        },
-        {
-            id: 'standing-wave-peak',
-            unit: 'ratio',
-            read: (gamma) => calcs.rflCoeffToSwPeakConstP(gamma),
-            title: 'Standing-wave peak · constant power',
-            values: [1, 1.2, 1.5, 2, 3, Infinity],
-            position: (v) => (v === Infinity ? 1 : calcs.swPeakConstPToRflCoeffEOrI(v)),
-        },
-        {
-            id: 'reflection-coefficient',
-            unit: 'ratio',
-            read: (gamma) => calcs.rflCoeffEOrI(gamma),
-            title: 'Reflection coefficient · |Γ|',
-            values: [0, 0.2, 0.4, 0.6, 0.8, 1],
-            position: (v) => v,
-        },
-        {
-            id: 'attenuation',
-            unit: 'dB',
-            read: (gamma) => calcs.rflCoeffToAttenuation(gamma),
-            title: 'Attenuation · dB',
-            description: 'One-way attenuation of a matched line or attenuator terminated in an open or short circuit. Not insertion loss of an arbitrary load.',
-            values: [Infinity, 10, 7, 5, 3, 1, 0],
-            position: (v) => calcs.attenuationToRflCoeff(v),
-        },
-        {
-            id: 'voltage-transmission',
-            unit: 'ratio',
-            read: (gamma) => calcs.rflCoeffToTransmCoeffEOrI(gamma),
-            title: 'Voltage transmission coefficient',
-            description: 'Voltage transmission magnitude: |1 + Γ| (dimensionless).',
-            values: [0, 0.4, 0.8, 1.2, 1.6, 2],
-            position: (v) => v / 2,
-        },
-        {
-            id: 'current-transmission',
-            unit: 'ratio',
-            read: (gamma) => calcs.rflCoeffToCurrentTransmission(gamma),
-            title: 'Current transmission coefficient',
-            description: 'Current transmission magnitude: |1 − Γ|, using the voltage reflection coefficient Γ (dimensionless).',
-            values: [0, 0.4, 0.8, 1.2, 1.6, 2],
-            position: (v) => v / 2,
-        },
-    ];
-}

package/dist/lib/shapes/Arc.d.ts

@@ -1,6 +0,0 @@
-import { Point } from './Point.js';
-export interface Arc {
-    p1: Point;
-    p2: Point;
-    r: number;
-}

package/dist/lib/shapes/Circle.d.ts

@@ -1,5 +0,0 @@
-import { Point } from './Point.js';
-export interface Circle {
-    p: Point;
-    r: number;
-}

package/dist/lib/shapes/Circle.js

@@ -1 +0,0 @@
-export {};

package/dist/lib/shapes/Line.d.ts

@@ -1,5 +0,0 @@
-import { Point } from './Point.js';
-export interface Line {
-    p1: Point;
-    p2: Point;
-}

package/dist/lib/shapes/Line.js

@@ -1 +0,0 @@
-export {};

package/dist/lib/shapes/Point.d.ts

@@ -1 +0,0 @@
-export type Point = [number, number];

package/dist/lib/shapes/Point.js

@@ -1 +0,0 @@
-export {};