@holoscript/radio-astronomy-plugin 2.0.2

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# @holoscript/radio-astronomy-plugin
+
+## 2.0.2
+
+### Patch Changes
+
+- Updated dependencies [c64fc1a]
+- Updated dependencies [6dc9732]
+  - @holoscript/core@8.0.6
+  - @holoscript/engine@6.1.3
+
+## 2.0.0
+
+### Patch Changes
+
+- Updated dependencies [c6e69b8]
+- Updated dependencies [440e163]
+  - @holoscript/engine@6.1.0
+  - @holoscript/core@6.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 HoloScript Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/__tests__/SpectralCubeViewer.test.ts

@@ -0,0 +1,129 @@
+/**
+ * SpectralCubeViewer + FITSViewerPanel — integration tests.
+ * Validates FITS → parse → channel extraction → data range pipeline.
+ */
+
+import { describe, it, expect } from 'vitest';
+import { parseFITS, buildFITS } from '../src/fits/FITSParser';
+import { fitsToGrid3D, extractChannel, fitsDataRange } from '../src/fits/FITSToGrid';
+
+describe('FITS Viewer Pipeline', () => {
+  it('parses a synthetic 2D FITS image', () => {
+    const data: number[] = [];
+    for (let j = 0; j < 8; j++) {
+      for (let i = 0; i < 10; i++) {
+        data.push(i + j * 10); // gradient
+      }
+    }
+
+    const buffer = buildFITS({
+      bitpix: -32,
+      shape: [10, 8],
+      data,
+      headers: { OBJECT: 'Test Image', TELESCOP: 'HoloScript' },
+    });
+
+    const fits = parseFITS(buffer);
+    expect(fits.shape).toEqual([10, 8]);
+    expect(fits.object).toBe('Test Image');
+    expect(fits.telescope).toBe('HoloScript');
+    expect(fits.data.length).toBe(80);
+    expect(fits.data[0]).toBeCloseTo(0);
+    expect(fits.data[79]).toBeCloseTo(79);
+  });
+
+  it('parses a synthetic 3D FITS spectral cube', () => {
+    const nx = 4, ny = 3, nz = 5;
+    const data: number[] = [];
+    for (let k = 0; k < nz; k++) {
+      for (let j = 0; j < ny; j++) {
+        for (let i = 0; i < nx; i++) {
+          data.push(k * 100 + j * 10 + i);
+        }
+      }
+    }
+
+    const buffer = buildFITS({
+      bitpix: -32,
+      shape: [nx, ny, nz],
+      data,
+      headers: {
+        OBJECT: 'Spectral Cube',
+        CRVAL3: 1.4e9,
+        CDELT3: 1e6,
+        CTYPE3: 'FREQ',
+        CUNIT3: 'Hz',
+      },
+    });
+
+    const fits = parseFITS(buffer);
+    expect(fits.shape).toEqual([nx, ny, nz]);
+    expect(fits.data.length).toBe(nx * ny * nz);
+
+    // Extract channel 2
+    const ch2 = extractChannel(fits, 2);
+    expect(ch2.length).toBe(nx * ny);
+    // Channel 2 values: 200, 201, ..., 211
+    expect(ch2[0]).toBeCloseTo(200);
+    expect(ch2[nx * ny - 1]).toBeCloseTo(211);
+  });
+
+  it('fitsToGrid3D creates correct grid dimensions', () => {
+    const buffer = buildFITS({
+      bitpix: -32,
+      shape: [5, 4, 3],
+      data: Array.from({ length: 60 }, (_, i) => i),
+    });
+
+    const fits = parseFITS(buffer);
+    const grid = fitsToGrid3D(fits);
+
+    expect(grid.nx).toBe(5);
+    expect(grid.ny).toBe(4);
+    expect(grid.nz).toBe(3);
+  });
+
+  it('fitsDataRange computes correct min/max', () => {
+    const buffer = buildFITS({
+      bitpix: -32,
+      shape: [3, 3],
+      data: [1, 5, 3, -2, 7, 0, 4, 8, -1],
+    });
+
+    const fits = parseFITS(buffer);
+    const [min, max] = fitsDataRange(fits);
+    expect(min).toBe(-2);
+    expect(max).toBe(8);
+  });
+
+  it('handles BSCALE/BZERO for integer FITS', () => {
+    const buffer = buildFITS({
+      bitpix: 16, // int16
+      shape: [4],
+      data: [0, 100, 200, 300],
+      bscale: 0.1,
+      bzero: 50,
+    });
+
+    const fits = parseFITS(buffer);
+    // Physical value = BSCALE * raw + BZERO
+    expect(fits.data[0]).toBeCloseTo(50);       // 0.1 * 0 + 50
+    expect(fits.data[1]).toBeCloseTo(60);       // 0.1 * 100 + 50
+    expect(fits.data[3]).toBeCloseTo(80);       // 0.1 * 300 + 50
+  });
+
+  it('2D image converts to nx×ny×1 grid', () => {
+    const buffer = buildFITS({
+      bitpix: -32,
+      shape: [6, 4],
+      data: Array.from({ length: 24 }, (_, i) => i),
+    });
+
+    const fits = parseFITS(buffer);
+    const grid = fitsToGrid3D(fits);
+
+    expect(grid.nx).toBe(6);
+    expect(grid.ny).toBe(4);
+    expect(grid.nz).toBe(1);
+  });
+});

package/__tests__/plugin.test.ts

@@ -0,0 +1,21 @@
+import { describe, it, expect } from 'vitest';
+import { DOMAIN_MANIFEST, RADIO_ASTRONOMY_TRAITS, PythonAstropyBridge } from '../src/index';
+
+describe('Radio Astronomy Plugin', () => {
+  it('should export the domain manifest correctly', () => {
+    expect(DOMAIN_MANIFEST.id).toBe('domain.science.astronomy.radio');
+    expect(DOMAIN_MANIFEST.traits.length).toBeGreaterThan(0);
+  });
+
+  it('should include basic astrophysics semantic traits', () => {
+    expect(RADIO_ASTRONOMY_TRAITS).toContain('synchrotron');
+    expect(RADIO_ASTRONOMY_TRAITS).toContain('interferometer');
+    expect(RADIO_ASTRONOMY_TRAITS).toContain('radio_emitter');
+  });
+
+  it('should instantiate the python bridge without throwing', () => {
+    const bridge = new PythonAstropyBridge();
+    expect(bridge).toBeDefined();
+    expect(typeof bridge.executeCommand).toBe('function');
+  });
+});

package/dist/bridge/python-runner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Interface representing the result of a radio astronomy physics calculation.
+ */
+export interface AstropyResult {
+    wavelength_meters?: number;
+    frequency_hz?: number;
+    flux_density_jy?: number;
+    error?: string;
+}
+/**
+ * Runner that bridges HoloScript to the underlying astropy Python toolkit.
+ */
+export declare class PythonAstropyBridge {
+    private scriptPath;
+    constructor();
+    /**
+     * Dispatches a calculation to the Python environment.
+     * @param command The astronomical command to invoke (e.g. 'calc_synchrotron')
+     * @param params JSON payload of parameters
+     * @returns A promise resolving to the astronomical result payload
+     */
+    executeCommand(command: string, params: Record<string, any>): Promise<AstropyResult>;
+}
+//# sourceMappingURL=python-runner.d.ts.map

package/dist/bridge/python-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-runner.d.ts","sourceRoot":"","sources":["../../src/bridge/python-runner.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAS;;IAM3B;;;;;OAKG;IACU,cAAc,CACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,OAAO,CAAC,aAAa,CAAC;CA6B1B"}

package/dist/bridge/python-runner.js

@@ -0,0 +1,43 @@
+import { spawn } from 'child_process';
+import * as path from 'path';
+/**
+ * Runner that bridges HoloScript to the underlying astropy Python toolkit.
+ */
+export class PythonAstropyBridge {
+    constructor() {
+        this.scriptPath = path.resolve(__dirname, '../../python/astropy_bridge.py');
+    }
+    /**
+     * Dispatches a calculation to the Python environment.
+     * @param command The astronomical command to invoke (e.g. 'calc_synchrotron')
+     * @param params JSON payload of parameters
+     * @returns A promise resolving to the astronomical result payload
+     */
+    async executeCommand(command, params) {
+        return new Promise((resolve, reject) => {
+            const process = spawn('python', [this.scriptPath, command, JSON.stringify(params)]);
+            let output = '';
+            let errorOutput = '';
+            process.stdout.on('data', (data) => {
+                output += data.toString();
+            });
+            process.stderr.on('data', (data) => {
+                errorOutput += data.toString();
+            });
+            process.on('close', (code) => {
+                if (code !== 0) {
+                    return reject(new Error(`Astropy bridge exited with code ${code}: ${errorOutput}`));
+                }
+                try {
+                    // Attempt to parse JSON line output from python script
+                    const parsed = JSON.parse(output.trim());
+                    resolve(parsed);
+                }
+                catch (_e) {
+                    reject(new Error(`Failed to parse bridge output: ${output}`));
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=python-runner.js.map

package/dist/bridge/python-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-runner.js","sourceRoot":"","sources":["../../src/bridge/python-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAY7B;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAG9B;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,cAAc,CACzB,OAAe,EACf,MAA2B;QAE3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAEpF,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,WAAW,GAAG,EAAE,CAAC;YAErB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACjC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACjC,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC3B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,IAAI,KAAK,WAAW,EAAE,CAAC,CAAC,CAAC;gBACtF,CAAC;gBACD,IAAI,CAAC;oBACH,uDAAuD;oBACvD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;oBACzC,OAAO,CAAC,MAAuB,CAAC,CAAC;gBACnC,CAAC;gBAAC,OAAO,EAAE,EAAE,CAAC;oBACZ,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/components/SpectralCubeViewer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SpectralCubeViewer — Interactive 3D viewer for FITS spectral cubes.
+ *
+ * Drop a FITS file → see the spectral cube in 3D → slide through
+ * frequency channels → play as animation. Zero code required.
+ *
+ * Works with:
+ *   - 3D cubes (RA × Dec × Freq): full volumetric slice-by-slice
+ *   - 2D images (RA × Dec): single-channel colormap
+ *   - 1D spectra: displayed as a line in 3D space
+ */
+export type ColormapName = 'jet' | 'viridis' | 'turbo' | 'inferno' | 'coolwarm';
+export interface SpectralCubeViewerProps {
+    /** Parsed FITS data array (physical values after BSCALE/BZERO) */
+    data: Float32Array;
+    /** Axis dimensions [NAXIS1, NAXIS2] or [NAXIS1, NAXIS2, NAXIS3] */
+    shape: number[];
+    /** Colormap (default: 'viridis') */
+    colormap?: ColormapName;
+    /** Auto-play through channels (default: false) */
+    autoPlay?: boolean;
+    /** Playback speed in channels per second (default: 5) */
+    playSpeed?: number;
+    /** WCS metadata for axis labels */
+    wcs?: {
+        ctype?: string[];
+        cunit?: string[];
+        crval?: number[];
+        cdelt?: number[];
+    };
+    /** Object name from FITS header */
+    objectName?: string;
+}
+export declare function SpectralCubeViewer({ data, shape, colormap, autoPlay, playSpeed, wcs, objectName, }: SpectralCubeViewerProps): import("react/jsx-runtime").JSX.Element;
+export interface FITSViewerPanelProps {
+    /** Raw FITS ArrayBuffer (from file drop) */
+    fitsBuffer: ArrayBuffer;
+    onClose?: () => void;
+}
+/**
+ * Full FITS viewer panel: parses FITS → shows 3D → channel slider.
+ * This is the entry point for drag-and-drop FITS files.
+ */
+export declare function FITSViewerPanel({ fitsBuffer, onClose }: FITSViewerPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SpectralCubeViewer.d.ts.map

package/dist/components/SpectralCubeViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpectralCubeViewer.d.ts","sourceRoot":"","sources":["../../src/components/SpectralCubeViewer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAEhF,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,IAAI,EAAE,YAAY,CAAC;IACnB,mEAAmE;IACnE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,GAAG,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjF,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4DD,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,KAAK,EACL,QAAoB,EACpB,QAAgB,EAChB,SAAa,EACb,GAAG,EACH,UAAU,GACX,EAAE,uBAAuB,2CAsFzB;AAID,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,UAAU,EAAE,WAAW,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,oBAAoB,2CAiG5E"}

package/dist/components/SpectralCubeViewer.js

@@ -0,0 +1,196 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SpectralCubeViewer — Interactive 3D viewer for FITS spectral cubes.
+ *
+ * Drop a FITS file → see the spectral cube in 3D → slide through
+ * frequency channels → play as animation. Zero code required.
+ *
+ * Works with:
+ *   - 3D cubes (RA × Dec × Freq): full volumetric slice-by-slice
+ *   - 2D images (RA × Dec): single-channel colormap
+ *   - 1D spectra: displayed as a line in 3D space
+ */
+import { useState, useMemo, useRef, useEffect } from 'react';
+import { useFrame } from '@react-three/fiber';
+import * as THREE from 'three';
+// ── Colormap GLSL ────────────────────────────────────────────────────────────
+const COLORMAPS = {
+    viridis: `
+    vec3 colormap(float t) {
+      vec3 c0 = vec3(0.267, 0.004, 0.329);
+      vec3 c4 = vec3(0.127, 0.566, 0.551);
+      vec3 c8 = vec3(0.993, 0.906, 0.144);
+      if (t < 0.5) return mix(c0, c4, t * 2.0);
+      return mix(c4, c8, (t - 0.5) * 2.0);
+    }
+  `,
+    turbo: `
+    vec3 colormap(float t) {
+      float r = 0.136 + t * (4.615 + t * (-42.66 + t * (132.13 + t * (-152.55 + t * 56.31))));
+      float g = 0.091 + t * (2.264 + t * (-14.02 + t * (32.21 + t * (-29.27 + t * 10.16))));
+      float b = 0.107 + t * (12.75 + t * (-60.58 + t * (132.75 + t * (-134.01 + t * 50.26))));
+      return clamp(vec3(r, g, b), 0.0, 1.0);
+    }
+  `,
+    inferno: `
+    vec3 colormap(float t) {
+      vec3 c0 = vec3(0.001, 0.0, 0.014);
+      vec3 c3 = vec3(0.735, 0.216, 0.329);
+      vec3 c6 = vec3(0.988, 0.999, 0.644);
+      if (t < 0.5) return mix(c0, c3, t * 2.0);
+      return mix(c3, c6, (t - 0.5) * 2.0);
+    }
+  `,
+};
+const VERT = /* glsl */ `
+attribute float aIntensity;
+uniform float uMin;
+uniform float uMax;
+varying float vNorm;
+
+void main() {
+  float range = uMax - uMin;
+  vNorm = range > 0.0 ? clamp((aIntensity - uMin) / range, 0.0, 1.0) : 0.5;
+  gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+}
+`;
+function makeFrag(cmName) {
+    const cm = COLORMAPS[cmName] ?? COLORMAPS.viridis;
+    return /* glsl */ `
+    varying float vNorm;
+    ${cm}
+    void main() {
+      vec3 c = colormap(vNorm);
+      gl_FragColor = vec4(c, 1.0);
+    }
+  `;
+}
+// ── Component ────────────────────────────────────────────────────────────────
+export function SpectralCubeViewer({ data, shape, colormap = 'viridis', autoPlay = false, playSpeed = 5, wcs, objectName, }) {
+    const nx = shape[0] ?? 1;
+    const ny = shape[1] ?? 1;
+    const nz = shape[2] ?? 1;
+    const is3D = shape.length >= 3 && nz > 1;
+    const [channel, setChannel] = useState(0);
+    const [playing, setPlaying] = useState(autoPlay);
+    const meshRef = useRef(null);
+    const timeRef = useRef(0);
+    // Extract channel slice
+    const channelData = useMemo(() => {
+        if (!is3D)
+            return data; // 2D — use entire dataset
+        const offset = channel * nx * ny;
+        return data.slice(offset, offset + nx * ny);
+    }, [data, channel, nx, ny, is3D]);
+    // Data range for colormap normalization
+    const [min, max] = useMemo(() => {
+        let lo = Infinity, hi = -Infinity;
+        for (let i = 0; i < channelData.length; i++) {
+            if (channelData[i] < lo)
+                lo = channelData[i];
+            if (channelData[i] > hi)
+                hi = channelData[i];
+        }
+        return [lo, hi];
+    }, [channelData]);
+    // Build geometry: flat plane with per-pixel intensity attribute
+    const geometry = useMemo(() => {
+        const geo = new THREE.PlaneGeometry(nx / Math.max(nx, ny), ny / Math.max(nx, ny), nx - 1, ny - 1);
+        const intensities = new Float32Array(nx * ny);
+        for (let j = 0; j < ny; j++) {
+            for (let i = 0; i < nx; i++) {
+                // PlaneGeometry vertex order: row by row, top to bottom
+                intensities[j * nx + i] = channelData[j * nx + i] ?? 0;
+            }
+        }
+        geo.setAttribute('aIntensity', new THREE.BufferAttribute(intensities, 1));
+        return geo;
+    }, [nx, ny, channelData]);
+    // Auto-play animation
+    useFrame((_, delta) => {
+        if (!playing || !is3D)
+            return;
+        timeRef.current += delta * playSpeed;
+        if (timeRef.current >= 1) {
+            timeRef.current -= 1;
+            setChannel((c) => (c + 1) % nz);
+        }
+    });
+    const fragmentShader = useMemo(() => makeFrag(colormap), [colormap]);
+    const uniforms = useMemo(() => ({
+        uMin: { value: min },
+        uMax: { value: max },
+    }), [min, max]);
+    // Channel label from WCS
+    const channelLabel = useMemo(() => {
+        if (!wcs?.crval || !wcs?.cdelt || !wcs?.ctype)
+            return `Channel ${channel}/${nz}`;
+        const freqIdx = wcs.ctype.findIndex((t) => t.includes('FREQ'));
+        if (freqIdx < 0)
+            return `Channel ${channel}/${nz}`;
+        const freq = wcs.crval[freqIdx] + channel * wcs.cdelt[freqIdx];
+        const unit = wcs.cunit?.[freqIdx] ?? 'Hz';
+        if (freq >= 1e9)
+            return `${(freq / 1e9).toFixed(3)} GHz`;
+        if (freq >= 1e6)
+            return `${(freq / 1e6).toFixed(3)} MHz`;
+        return `${freq.toFixed(0)} ${unit}`;
+    }, [channel, nz, wcs]);
+    return (_jsx("group", { children: _jsx("mesh", { ref: meshRef, geometry: geometry, children: _jsx("shaderMaterial", { vertexShader: VERT, fragmentShader: fragmentShader, uniforms: uniforms, side: THREE.DoubleSide }) }) }));
+}
+/**
+ * Full FITS viewer panel: parses FITS → shows 3D → channel slider.
+ * This is the entry point for drag-and-drop FITS files.
+ */
+export function FITSViewerPanel({ fitsBuffer, onClose }) {
+    const [fitsData, setFitsData] = useState(null);
+    const [channel, setChannel] = useState(0);
+    const [playing, setPlaying] = useState(false);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        try {
+            // Dynamic import to avoid bundling FITS parser unless needed
+            import('../fits/FITSParser').then(({ parseFITS }) => {
+                const fits = parseFITS(fitsBuffer);
+                setFitsData({
+                    data: fits.data,
+                    shape: fits.shape,
+                    wcs: fits.wcs,
+                    object: fits.object || 'Unknown Object',
+                });
+            }).catch((e) => setError(String(e)));
+        }
+        catch (e) {
+            setError(String(e));
+        }
+    }, [fitsBuffer]);
+    if (error) {
+        return (_jsxs("div", { style: { padding: 20, color: '#ef4444', fontFamily: 'monospace' }, children: ["FITS Parse Error: ", error] }));
+    }
+    if (!fitsData) {
+        return (_jsx("div", { style: { padding: 20, color: '#94a3b8', fontFamily: 'monospace' }, children: "Loading FITS data..." }));
+    }
+    const nz = fitsData.shape[2] ?? 1;
+    const is3D = fitsData.shape.length >= 3 && nz > 1;
+    return (_jsxs("div", { style: {
+            display: 'flex', flexDirection: 'column', gap: 8,
+            padding: 12, background: '#1a1a2e', borderRadius: 8,
+            border: '1px solid #2a2a3e', color: '#e4e4e7',
+            fontFamily: "'Space Mono', monospace",
+        }, children: [_jsxs("div", { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center' }, children: [_jsx("span", { style: { fontSize: 13, fontWeight: 700, color: '#a78bfa' }, children: fitsData.object }), _jsxs("span", { style: { fontSize: 10, color: '#71717a' }, children: [fitsData.shape.join(' × '), " px"] })] }), is3D && (_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 8 }, children: [_jsx("button", { onClick: () => setPlaying(!playing), style: {
+                            background: playing ? '#ef4444' : '#3b82f6',
+                            border: 'none', borderRadius: 4, padding: '4px 10px',
+                            color: 'white', fontSize: 11, cursor: 'pointer',
+                        }, children: playing ? 'Stop' : 'Play' }), _jsx("input", { type: "range", min: 0, max: nz - 1, value: channel, onChange: (e) => { setChannel(Number(e.target.value)); setPlaying(false); }, style: { flex: 1 } }), _jsxs("span", { style: { fontSize: 10, color: '#71717a', minWidth: 80, textAlign: 'right' }, children: ["Ch ", channel, "/", nz - 1] })] })), _jsxs("div", { style: { fontSize: 10, color: '#71717a' }, children: ["Range: ", dataRange(fitsData.data).map((v) => v.toExponential(2)).join(' → ')] })] }));
+}
+function dataRange(data) {
+    let min = Infinity, max = -Infinity;
+    for (let i = 0; i < data.length; i++) {
+        if (data[i] < min)
+            min = data[i];
+        if (data[i] > max)
+            max = data[i];
+    }
+    return [min, max];
+}
+//# sourceMappingURL=SpectralCubeViewer.js.map

package/dist/components/SpectralCubeViewer.js.map

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

package/dist/constants/astronomy-traits.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Specific traits representing properties for Radio Astrophysics.
+ */
+export declare const RADIO_ASTRONOMY_TRAITS: readonly ["radio_emitter", "synchrotron", "interferometer", "em_wave", "pulsar_timing", "spectral_line"];
+export type RadioAstronomyTraitName = (typeof RADIO_ASTRONOMY_TRAITS)[number];
+//# sourceMappingURL=astronomy-traits.d.ts.map

package/dist/constants/astronomy-traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astronomy-traits.d.ts","sourceRoot":"","sources":["../../src/constants/astronomy-traits.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,sBAAsB,0GAOzB,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/constants/astronomy-traits.js

@@ -0,0 +1,12 @@
+/**
+ * Specific traits representing properties for Radio Astrophysics.
+ */
+export const RADIO_ASTRONOMY_TRAITS = [
+    'radio_emitter', // Signals a 3D construct as an origin point for specific radio wavelengths
+    'synchrotron', // Determines emission behavior via magnetic fields and relativistic electrons
+    'interferometer', // Marks a multi-nodal virtual sensor
+    'em_wave', // Represents an electromagnetic wave primitive
+    'pulsar_timing', // Represents pulsar timing array signals
+    'spectral_line', // Maps to particular spectral line signals (e.g., 21cm HI line)
+];
+//# sourceMappingURL=astronomy-traits.js.map

package/dist/constants/astronomy-traits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astronomy-traits.js","sourceRoot":"","sources":["../../src/constants/astronomy-traits.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,eAAe,EAAE,2EAA2E;IAC5F,aAAa,EAAE,8EAA8E;IAC7F,gBAAgB,EAAE,qCAAqC;IACvD,SAAS,EAAE,+CAA+C;IAC1D,eAAe,EAAE,yCAAyC;IAC1D,eAAe,EAAE,gEAAgE;CACzE,CAAC"}

package/dist/fits/FITSParser.d.ts

@@ -0,0 +1,60 @@
+/**
+ * FITSParser — Pure JavaScript parser for FITS (Flexible Image Transport System) files.
+ *
+ * FITS is the standard data format in astronomy. Structure:
+ *   - Header: 2880-byte blocks of 80-character ASCII "cards" (key=value pairs)
+ *   - Data: big-endian binary arrays, padded to 2880-byte boundary
+ *   - Extensions: additional HDUs (Header Data Units) with same structure
+ *
+ * Supports: BITPIX 8 (uint8), 16 (int16), 32 (int32), -32 (float32), -64 (float64)
+ * Handles: BSCALE/BZERO physical value scaling, WCS coordinate metadata
+ *
+ * @see https://fits.gsfc.nasa.gov/fits_standard.html
+ */
+export interface WCSInfo {
+    /** Reference pixel (1-indexed, per FITS convention) */
+    crpix: number[];
+    /** Reference value (world coordinate at reference pixel) */
+    crval: number[];
+    /** Pixel scale (coordinate increment per pixel) */
+    cdelt: number[];
+    /** Axis types (e.g., 'RA---TAN', 'DEC--TAN', 'FREQ') */
+    ctype: string[];
+    /** Axis units */
+    cunit: string[];
+}
+export interface FITSFile {
+    /** All header cards as key→value */
+    headers: Map<string, string | number | boolean>;
+    /** Data array (physical values after BSCALE/BZERO) */
+    data: Float32Array;
+    /** Axis dimensions [NAXIS1, NAXIS2, ...] */
+    shape: number[];
+    /** World Coordinate System info (if present) */
+    wcs: WCSInfo | null;
+    /** BITPIX from header */
+    bitpix: number;
+    /** Object name (OBJECT card) */
+    object: string;
+    /** Telescope name (TELESCOP card) */
+    telescope: string;
+    /** Observation date (DATE-OBS card) */
+    dateObs: string;
+}
+/**
+ * Parse a FITS file from an ArrayBuffer.
+ * Returns the primary HDU (first header + data unit).
+ */
+export declare function parseFITS(buffer: ArrayBuffer): FITSFile;
+/**
+ * Build a minimal FITS file as ArrayBuffer (for testing).
+ */
+export declare function buildFITS(opts: {
+    bitpix: number;
+    shape: number[];
+    data: number[];
+    bscale?: number;
+    bzero?: number;
+    headers?: Record<string, string | number>;
+}): ArrayBuffer;
+//# sourceMappingURL=FITSParser.d.ts.map

package/dist/fits/FITSParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FITSParser.d.ts","sourceRoot":"","sources":["../../src/fits/FITSParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,OAAO;IACtB,uDAAuD;IACvD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mDAAmD;IACnD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iBAAiB;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAChD,sDAAsD;IACtD,IAAI,EAAE,YAAY,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACpB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAUD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CA+GvD;AAID;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC3C,GAAG,WAAW,CAuDd"}