@smartnet360/svelte-components 0.0.119 → 0.0.121

package/dist/apps/antenna-tools/utils/chart-engines/polar-area-utils.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Antenna Tools - Polar Area Chart Utilities
+ * Utility functions for creating Plotly polar area charts
+ */
+import type { Antenna } from '../../types';
+export interface PolarAreaTraceData {
+    r: number[];
+    theta: number[];
+    type: 'scatterpolar';
+    mode: 'lines';
+    fill: 'toself';
+    name: string;
+    line: {
+        color: string;
+        width: number;
+    };
+    fillcolor: string;
+    opacity: number;
+    hovertemplate?: string;
+}
+/**
+ * Convert antenna pattern to Plotly polar area trace data
+ */
+export declare function convertAntennaPatternToArea(pattern: number[], name: string, baseColor: string, opacity?: number, mechanicalTilt?: number, gainOffset?: number): PolarAreaTraceData;
+/**
+ * Get area colors with appropriate transparency
+ */
+export declare function getAreaColors(electricalTilt: number, mechanicalTilt: number, baseColor: string): {
+    line: string;
+    fill: string;
+};
+/**
+ * Create polar area chart data for antenna patterns
+ */
+export declare function createPolarAreaChartData(selectedAntenna: Antenna | null, selectedAntenna2: Antenna | null, viewMode: 'single' | 'compare', showHorizontalPatterns: boolean, showVerticalPatterns: boolean, ant1ElectricalTilt: number, ant1MechanicalTilt: number, ant2ElectricalTilt: number, ant2MechanicalTilt: number, patternDisplayMode?: 'normalized' | 'gain-adjusted'): PolarAreaTraceData[];
+/**
+ * Create Plotly layout for polar area charts
+ */
+export declare function createPolarAreaLayout(title: string): {
+    title: {
+        text: string;
+        font: {
+            size: number;
+            color: string;
+        };
+        x: number;
+        xanchor: string;
+    };
+    polar: {
+        radialaxis: {
+            visible: boolean;
+            range: number[];
+            tickfont: {
+                size: number;
+                color: string;
+            };
+            gridcolor: string;
+            linecolor: string;
+            tickmode: string;
+            tick0: number;
+            dtick: number;
+            ticksuffix: string;
+        };
+        angularaxis: {
+            visible: boolean;
+            tickfont: {
+                size: number;
+                color: string;
+            };
+            gridcolor: string;
+            linecolor: string;
+            direction: string;
+            period: number;
+            rotation: number;
+            ticksuffix: string;
+        };
+        bgcolor: string;
+    };
+    margin: {
+        t: number;
+        r: number;
+        b: number;
+        l: number;
+    };
+    height: number;
+    paper_bgcolor: string;
+    plot_bgcolor: string;
+    legend: {
+        orientation: string;
+        x: number;
+        y: number;
+        xanchor: string;
+    };
+};

package/dist/apps/antenna-tools/utils/chart-engines/polar-area-utils.js

@@ -0,0 +1,151 @@
+/**
+ * Antenna Tools - Polar Area Chart Utilities
+ * Utility functions for creating Plotly polar area charts
+ */
+/**
+ * Convert antenna pattern to Plotly polar area trace data
+ */
+export function convertAntennaPatternToArea(pattern, name, baseColor, opacity = 0.6, mechanicalTilt = 0, gainOffset = 0) {
+    // Convert attenuation to dB (negate values) and apply gain offset
+    let processedPattern = pattern.map(value => -value + gainOffset);
+    // Apply mechanical tilt by shifting the pattern
+    if (mechanicalTilt !== 0) {
+        const shiftedPattern = new Array(360).fill(0);
+        for (let i = 0; i < 360; i++) {
+            const sourceIndex = (i - mechanicalTilt + 360) % 360;
+            shiftedPattern[i] = processedPattern[sourceIndex] || 0;
+        }
+        processedPattern = shiftedPattern;
+    }
+    // Generate theta values (0-359 degrees) with proper rotation
+    const theta = [];
+    const r = [];
+    for (let i = 0; i < pattern.length; i++) {
+        let angle = i;
+        // Apply rotation to point antenna patterns to 0 degrees (North/up)
+        if (name.includes('Vertical')) {
+            angle = (i + 0) % 360; // Vertical patterns point to 0° (North/up)
+        }
+        else {
+            angle = (i + 270) % 360; // Rotate horizontal patterns 270° (or -90°) to point North
+        }
+        theta.push(angle);
+        r.push(processedPattern[i]);
+    }
+    // Close the area by adding the first point at the end
+    theta.push(theta[0]);
+    r.push(r[0]);
+    // Create semi-transparent fill color
+    const fillColor = baseColor.replace('rgb', 'rgba').replace(')', `, ${opacity})`);
+    return {
+        r,
+        theta,
+        type: 'scatterpolar',
+        mode: 'lines',
+        fill: 'toself',
+        name,
+        line: {
+            color: baseColor,
+            width: 2
+        },
+        fillcolor: fillColor,
+        opacity: 1, // Set to 1 since we control opacity via fillcolor
+        hovertemplate: '%{theta} <br>%{r:.2f} dB<extra></extra>'
+    };
+}
+/**
+ * Get area colors with appropriate transparency
+ */
+export function getAreaColors(electricalTilt, mechanicalTilt, baseColor) {
+    return {
+        line: baseColor,
+        fill: baseColor.replace('rgb', 'rgba').replace(')', ', 0.3)')
+    };
+}
+/**
+ * Create polar area chart data for antenna patterns
+ */
+export function createPolarAreaChartData(selectedAntenna, selectedAntenna2, viewMode, showHorizontalPatterns, showVerticalPatterns, ant1ElectricalTilt, ant1MechanicalTilt, ant2ElectricalTilt, ant2MechanicalTilt, patternDisplayMode = 'normalized') {
+    const data = [];
+    // Calculate gain offsets for gain-adjusted display mode
+    let ant1GainOffset = 0;
+    let ant2GainOffset = 0;
+    if (patternDisplayMode === 'gain-adjusted' && viewMode === 'compare') {
+        const ant1Gain = selectedAntenna?.gain_dBd || 0;
+        const ant2Gain = selectedAntenna2?.gain_dBd || 0;
+        const maxGain = Math.max(ant1Gain, ant2Gain);
+        // Offset both antennas relative to the highest gain antenna
+        ant1GainOffset = ant1Gain - maxGain;
+        ant2GainOffset = ant2Gain - maxGain;
+    }
+    // Create antenna 1 pattern data based on visibility settings
+    if (selectedAntenna) {
+        if (showHorizontalPatterns) {
+            const horizontalData1 = convertAntennaPatternToArea(selectedAntenna.pattern || [], 'Antenna 1 - Horizontal', 'rgb(0, 102, 204)', 0.4, ant1MechanicalTilt, ant1GainOffset);
+            data.push(horizontalData1);
+        }
+        if (showVerticalPatterns) {
+            const verticalData1 = convertAntennaPatternToArea(selectedAntenna.vertical_pattern || [], 'Antenna 1 - Vertical', 'rgb(0, 61, 122)', 0.3, ant1MechanicalTilt, ant1GainOffset);
+            data.push(verticalData1);
+        }
+    }
+    // Add second antenna if in compare mode and antenna 2 is selected
+    if (viewMode === 'compare' && selectedAntenna2) {
+        if (showHorizontalPatterns) {
+            const horizontalData2 = convertAntennaPatternToArea(selectedAntenna2.pattern || [], 'Antenna 2 - Horizontal', 'rgb(255, 215, 0)', 0.4, ant2MechanicalTilt, ant2GainOffset);
+            data.push(horizontalData2);
+        }
+        if (showVerticalPatterns) {
+            const verticalData2 = convertAntennaPatternToArea(selectedAntenna2.vertical_pattern || [], 'Antenna 2 - Vertical', 'rgb(230, 194, 0)', 0.3, ant2MechanicalTilt, ant2GainOffset);
+            data.push(verticalData2);
+        }
+    }
+    return data;
+}
+/**
+ * Create Plotly layout for polar area charts
+ */
+export function createPolarAreaLayout(title) {
+    return {
+        title: {
+            text: title,
+            font: { size: 16, color: '#212529' },
+            x: 0.5,
+            xanchor: 'center'
+        },
+        polar: {
+            radialaxis: {
+                visible: true,
+                range: [-70, 0],
+                tickfont: { size: 10, color: '#6c757d' },
+                gridcolor: 'rgba(108, 117, 125, 0.3)',
+                linecolor: 'rgba(108, 117, 125, 0.5)',
+                tickmode: 'linear',
+                tick0: -70,
+                dtick: 10,
+                ticksuffix: ' dB'
+            },
+            angularaxis: {
+                visible: true,
+                tickfont: { size: 11, color: '#495057' },
+                gridcolor: 'rgba(108, 117, 125, 0.2)',
+                linecolor: 'rgba(108, 117, 125, 0.4)',
+                direction: 'clockwise',
+                period: 360,
+                rotation: 0,
+                ticksuffix: '°'
+            },
+            bgcolor: 'rgba(248, 249, 250, 0.5)'
+        },
+        margin: { t: 60, r: 40, b: 60, l: 40 },
+        height: 600,
+        paper_bgcolor: 'rgba(255, 255, 255, 0.95)',
+        plot_bgcolor: 'rgba(248, 249, 250, 0.3)',
+        legend: {
+            orientation: 'h',
+            x: 0.5,
+            y: -0.1,
+            xanchor: 'center'
+        }
+    };
+}

package/dist/apps/antenna-tools/utils/chart-engines/polar-line-utils.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Antenna Tools - Polar Line Chart Utilities
+ * Utility functions for creating Plotly polar line charts
+ */
+import type { Antenna } from '../../types';
+export interface PolarLineTraceData {
+    r: number[];
+    theta: number[];
+    type: 'scatterpolar';
+    mode: 'lines';
+    name: string;
+    line: {
+        color: string;
+        width: number;
+        dash: string;
+    };
+    hovertemplate?: string;
+}
+/**
+ * Convert antenna pattern to Plotly polar line trace data
+ */
+export declare function convertAntennaPatternToLine(pattern: number[], name: string, color: string, width?: number, mechanicalTilt?: number, gainOffset?: number): PolarLineTraceData;
+/**
+ * Get fixed line color (no dynamic changes)
+ */
+export declare function getLineColor(electricalTilt: number, mechanicalTilt: number, baseColor: string): string;
+/**
+ * Get fixed line width (no dynamic changes)
+ */
+export declare function getLineWidth(electricalTilt: number, mechanicalTilt: number): number;
+/**
+ * Create polar line chart data for antenna patterns
+ */
+export declare function createPolarLineChartData(selectedAntenna: Antenna | null, selectedAntenna2: Antenna | null, viewMode: 'single' | 'compare', showHorizontalPatterns: boolean, showVerticalPatterns: boolean, ant1ElectricalTilt: number, ant1MechanicalTilt: number, ant2ElectricalTilt: number, ant2MechanicalTilt: number, patternDisplayMode?: 'normalized' | 'gain-adjusted'): PolarLineTraceData[];
+/**
+ * Create Plotly layout for polar line charts
+ */
+export declare function createPolarLineLayout(title: string): {
+    title: {
+        text: string;
+        font: {
+            size: number;
+            color: string;
+        };
+        x: number;
+        xanchor: string;
+    };
+    polar: {
+        radialaxis: {
+            visible: boolean;
+            range: number[];
+            tickfont: {
+                size: number;
+                color: string;
+            };
+            gridcolor: string;
+            linecolor: string;
+            tickmode: string;
+            tick0: number;
+            dtick: number;
+            ticksuffix: string;
+        };
+        angularaxis: {
+            visible: boolean;
+            tickfont: {
+                size: number;
+                color: string;
+            };
+            gridcolor: string;
+            linecolor: string;
+            direction: string;
+            period: number;
+            rotation: number;
+            ticksuffix: string;
+        };
+        bgcolor: string;
+    };
+    margin: {
+        t: number;
+        r: number;
+        b: number;
+        l: number;
+    };
+    height: number;
+    paper_bgcolor: string;
+    plot_bgcolor: string;
+    legend: {
+        orientation: string;
+        x: number;
+        y: number;
+        xanchor: string;
+    };
+};

package/dist/apps/antenna-tools/utils/chart-engines/polar-line-utils.js

@@ -0,0 +1,139 @@
+/**
+ * Antenna Tools - Polar Line Chart Utilities
+ * Utility functions for creating Plotly polar line charts
+ */
+/**
+ * Convert antenna pattern to Plotly polar line trace data
+ */
+export function convertAntennaPatternToLine(pattern, name, color, width = 2, mechanicalTilt = 0, gainOffset = 0) {
+    // Convert attenuation to dB (negate values) and apply gain offset
+    let processedPattern = pattern.map(value => -value + gainOffset);
+    // Apply mechanical tilt by shifting the pattern
+    if (mechanicalTilt !== 0) {
+        const shiftedPattern = new Array(360).fill(0);
+        for (let i = 0; i < 360; i++) {
+            const sourceIndex = (i - mechanicalTilt + 360) % 360;
+            shiftedPattern[i] = processedPattern[sourceIndex] || 0;
+        }
+        processedPattern = shiftedPattern;
+    }
+    // Generate theta values (0-359 degrees) with proper rotation to point to 0 degrees
+    const theta = Array.from({ length: pattern.length }, (_, i) => {
+        if (name.includes('Vertical')) {
+            return (i + 0) % 360; // Vertical patterns point to 0° (North/up)
+        }
+        return (i + 270) % 360; // Rotate horizontal patterns 270° (or -90°) to point North
+    });
+    return {
+        r: processedPattern,
+        theta,
+        type: 'scatterpolar',
+        mode: 'lines',
+        name,
+        line: {
+            color,
+            width,
+            dash: 'solid' // Always solid lines
+        },
+        hovertemplate: '%{theta} <br>%{r:.2f} dB<extra></extra>'
+    };
+}
+/**
+ * Get fixed line color (no dynamic changes)
+ */
+export function getLineColor(electricalTilt, mechanicalTilt, baseColor) {
+    return baseColor; // Always return base color
+}
+/**
+ * Get fixed line width (no dynamic changes)
+ */
+export function getLineWidth(electricalTilt, mechanicalTilt) {
+    return 2; // Always return fixed width
+}
+/**
+ * Create polar line chart data for antenna patterns
+ */
+export function createPolarLineChartData(selectedAntenna, selectedAntenna2, viewMode, showHorizontalPatterns, showVerticalPatterns, ant1ElectricalTilt, ant1MechanicalTilt, ant2ElectricalTilt, ant2MechanicalTilt, patternDisplayMode = 'normalized') {
+    const data = [];
+    // Calculate gain offsets for gain-adjusted display mode
+    let ant1GainOffset = 0;
+    let ant2GainOffset = 0;
+    if (patternDisplayMode === 'gain-adjusted' && viewMode === 'compare') {
+        const ant1Gain = selectedAntenna?.gain_dBd || 0;
+        const ant2Gain = selectedAntenna2?.gain_dBd || 0;
+        const maxGain = Math.max(ant1Gain, ant2Gain);
+        // Offset both antennas relative to the highest gain antenna
+        ant1GainOffset = ant1Gain - maxGain;
+        ant2GainOffset = ant2Gain - maxGain;
+    }
+    // Create antenna 1 pattern data based on visibility settings
+    if (selectedAntenna) {
+        if (showHorizontalPatterns) {
+            const horizontalData1 = convertAntennaPatternToLine(selectedAntenna.pattern || [], 'Antenna 1 - Horizontal', getLineColor(ant1ElectricalTilt, ant1MechanicalTilt, '#0066cc'), getLineWidth(ant1ElectricalTilt, ant1MechanicalTilt), ant1MechanicalTilt, ant1GainOffset);
+            data.push(horizontalData1);
+        }
+        if (showVerticalPatterns) {
+            const verticalData1 = convertAntennaPatternToLine(selectedAntenna.vertical_pattern || [], 'Antenna 1 - Vertical', getLineColor(ant1ElectricalTilt, ant1MechanicalTilt, '#003d7a'), getLineWidth(ant1ElectricalTilt, ant1MechanicalTilt), ant1MechanicalTilt, ant1GainOffset);
+            data.push(verticalData1);
+        }
+    }
+    // Add second antenna if in compare mode and antenna 2 is selected
+    if (viewMode === 'compare' && selectedAntenna2) {
+        if (showHorizontalPatterns) {
+            const horizontalData2 = convertAntennaPatternToLine(selectedAntenna2.pattern || [], 'Antenna 2 - Horizontal', getLineColor(ant2ElectricalTilt, ant2MechanicalTilt, '#ffd700'), getLineWidth(ant2ElectricalTilt, ant2MechanicalTilt), ant2MechanicalTilt, ant2GainOffset);
+            data.push(horizontalData2);
+        }
+        if (showVerticalPatterns) {
+            const verticalData2 = convertAntennaPatternToLine(selectedAntenna2.vertical_pattern || [], 'Antenna 2 - Vertical', getLineColor(ant2ElectricalTilt, ant2MechanicalTilt, '#e6c200'), getLineWidth(ant2ElectricalTilt, ant2MechanicalTilt), ant2MechanicalTilt, ant2GainOffset);
+            data.push(verticalData2);
+        }
+    }
+    return data;
+}
+/**
+ * Create Plotly layout for polar line charts
+ */
+export function createPolarLineLayout(title) {
+    return {
+        title: {
+            text: title,
+            font: { size: 16, color: '#212529' },
+            x: 0.5,
+            xanchor: 'center'
+        },
+        polar: {
+            radialaxis: {
+                visible: true,
+                range: [-70, 0],
+                tickfont: { size: 10, color: '#6c757d' },
+                gridcolor: 'rgba(108, 117, 125, 0.3)',
+                linecolor: 'rgba(108, 117, 125, 0.5)',
+                tickmode: 'linear',
+                tick0: -70,
+                dtick: 10,
+                ticksuffix: ' dB'
+            },
+            angularaxis: {
+                visible: true,
+                tickfont: { size: 11, color: '#495057' },
+                gridcolor: 'rgba(108, 117, 125, 0.2)',
+                linecolor: 'rgba(108, 117, 125, 0.4)',
+                direction: 'clockwise',
+                period: 360,
+                rotation: 0,
+                ticksuffix: '°'
+            },
+            bgcolor: 'rgba(248, 249, 250, 0.5)'
+        },
+        margin: { t: 60, r: 40, b: 60, l: 40 },
+        height: 600,
+        paper_bgcolor: 'rgba(255, 255, 255, 0.95)',
+        plot_bgcolor: 'rgba(248, 249, 250, 0.3)',
+        legend: {
+            orientation: 'h',
+            x: 0.5,
+            y: -0.1,
+            xanchor: 'center'
+        }
+    };
+}

package/dist/apps/antenna-tools/utils/db-utils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Antenna Tools - Database Utilities
+ * CRUD operations for antenna data with automatic purge on import
+ */
+import type { Antenna, RawAntenna } from '../types';
+import { type PurgeStats } from '../band-config';
+/**
+ * Load all antennas from database
+ */
+export declare function loadAntennas(): Promise<Antenna[]>;
+/**
+ * Import result with purge statistics
+ */
+export interface ImportResult {
+    success: boolean;
+    purgeStats: PurgeStats;
+    error?: string;
+}
+/**
+ * Save raw antennas to database with automatic purge
+ *
+ * This is the main import function:
+ * 1. Takes raw antennas (with actual MHz frequencies)
+ * 2. Purges to keep only one per band (closest to center)
+ * 3. Saves purged antennas to database
+ *
+ * @param rawAntennas - Antennas parsed from MSI files
+ * @returns Import result with purge statistics
+ */
+export declare function saveAntennasWithPurge(rawAntennas: RawAntenna[]): Promise<ImportResult>;
+/**
+ * Save antennas directly (without purge) - for pre-purged data
+ */
+export declare function saveAntennas(antennaData: Antenna[]): Promise<void>;
+/**
+ * Import from JSON file (expects pre-purged data)
+ */
+export declare function importFromJson(jsonFile: File): Promise<Antenna[]>;
+/**
+ * Export all antennas to JSON file download
+ */
+export declare function exportAntennas(): Promise<void>;
+/**
+ * Clear all antenna data from database
+ */
+export declare function clearAllAntennas(): Promise<void>;
+/**
+ * Check if data has been imported before
+ */
+export declare function hasImportedData(): boolean;