smithkit 0.2.0 → 0.4.0

package/dist/lib/Smith.d.ts

@@ -1,5 +1,8 @@
-import { TraceSamples } from './samples.js';
-import type { ChartLayers, PeripheralScales } from './layers.js';
+import type { SmithOptions } from './options.js';
+import type { SmithImageExportOptions } from './svg/export.js';
+import type { SmithAppearance } from './appearance/types.js';
+import type { TraceSamples } from './samples.js';
+import type { ChartLayers, GridDetail, PeripheralScales } from './layers.js';
 import type { SmithReading } from './rf/RfCalculations.js';
 import type { TraceOptions, TraceUpdateOptions, TraceInfo, MarkerSnapshot, MarkerComparison } from './measurements.js';
 export declare enum SmithEventType {
@@ -17,65 +20,47 @@ export type SmithEvent = {
     data: MarkerSnapshot;
 };
 export declare class Smith {
+    private theme;
     private referenceOhms;
-    private calcs;
-    private scalers;
-    private readonly defaultTransform;
-    private transform;
-    private zoomEnabled;
-    private applyingView;
-    private zoomBehavior;
-    private svg;
-    private resizeObserver;
-    private readonly labelLayout;
-    private container;
-    private dataContainer;
-    private markerContainer;
-    private reactanceAxis;
-    private constResistance;
-    private constReactance;
-    private constConductance;
-    private constSusceptance;
-    private constSwrCircles;
-    private constQCircles;
-    private cursor;
-    private peripheralScaleRenderer;
+    private readonly renderer;
     private data;
     private destroyed;
-    private mouseGesture;
     private nextDatasetColor;
     private nextTraceId;
     private nextMarkerId;
     private traceMetadata;
     private markerIds;
     private draggedMarkers;
-    private cursorBeforeMarkerDrag;
     private listeners;
     readonly layers: ChartLayers;
     readonly peripheralScales: PeripheralScales;
-    constructor(referenceOhms?: number);
+    constructor(options?: SmithOptions);
+    /** Apply a validated patch. Omitted fields retain their current settings. */
+    setOptions(options: SmithOptions): void;
+    private applyOptions;
+    /** Replace the appearance while retaining explicit layer styles and trace colors. */
+    setAppearance(appearance: SmithAppearance): void;
     draw(target: string | HTMLElement): void;
-    /** Export the current mounted view as standalone SVG with a transparent background. */
-    toSvg(): string;
+    /** Set the same detail level on all impedance and admittance grid layers. */
+    setGridDetail(detail: GridDetail): void;
+    /** Export the current mounted view as standalone SVG with its configured background. */
+    toSvg(options?: SmithImageExportOptions): string;
+    private validateExportOptions;
+    private exportLegend;
+    /** Export the mounted view as PNG, optionally with radial scales and a trace legend. */
+    toPng(options?: SmithImageExportOptions): Promise<Blob>;
     /** Remove this chart and release its event handlers. Safe to call more than once. */
     destroy(): void;
-    private updateViewportScale;
     private assertAlive;
-    private createScalers;
-    private cursorMove;
     private markerDragChanged;
-    private initCursor;
     /** Last cursor position. Use cursor events to detect pointer leave. */
     get cursorReading(): SmithReading;
-    private initializeZoom;
     /** Enable or disable wheel, double-click, and mouse/touch zoom/pan. Keeps the current view. */
     setZoomEnabled(enabled: boolean): void;
-    private applyView;
+    /** Enable or disable the cursor overlay and readings independently of zoom and markers. */
+    setCursorEnabled(enabled: boolean): void;
     resetView(): void;
-    private onZoom;
-    private cursorContainer;
-    private drawReactanceAxis;
-    /** Add a named trace with one initial marker. Returns a chart-local, stable ID. */
+    /** Add a named trace without markers. Use addMarker to create markers explicitly. Returns a chart-local, stable ID. */
     addTrace(values: TraceSamples, options?: TraceOptions): string;
     /** Detached metadata snapshots; IDs and marker display numbers survive removals. */
     getTraces(): TraceInfo[];