@zendir/ui 0.5.0 → 0.6.0

package/dist/react/types.d.ts

@@ -59,7 +59,7 @@ export interface SpacecraftPosition {
     /** Orbital inclination in degrees */
     inclination?: number;
     /** Health/operational status using AstroUXDS 6-level system */
-    status?: 'off' | 'standby' | 'normal' | 'caution' | 'serious' | 'critical';
+    status?: "off" | "standby" | "normal" | "caution" | "serious" | "critical";
 }
 export interface Spacecraft {
     id: string;
@@ -67,7 +67,7 @@ export interface Spacecraft {
     noradId?: number;
     type?: string;
     /** Status using AstroUXDS 6-level system */
-    status?: 'off' | 'standby' | 'normal' | 'caution' | 'serious' | 'critical';
+    status?: "off" | "standby" | "normal" | "caution" | "serious" | "critical";
 }
 export interface GroundStation {
     id: string;
@@ -257,7 +257,7 @@ export interface AttitudeData {
     /** Target direction vector [x, y, z] */
     targetDirection?: [number, number, number];
 }
-export type PointingMode = 'nadir' | 'sun' | 'target' | 'inertial' | 'velocity';
+export type PointingMode = "nadir" | "sun" | "target" | "inertial" | "velocity";
 export interface EclipseInfo {
     inEclipse: boolean;
     timeToEclipse: number;
@@ -307,7 +307,7 @@ export interface ThermalData {
 export interface ThrusterStatus {
     id: string;
     name: string;
-    status: 'ready' | 'firing' | 'disabled' | 'error';
+    status: "ready" | "firing" | "disabled" | "error";
     fuelFlow?: number;
 }
 export interface PropulsionSummary {
@@ -324,7 +324,7 @@ export interface ReactionWheelData {
     /** Display name (e.g. "RW-X", "RW-1") */
     name: string;
     /** Mounted axis */
-    axis: 'X' | 'Y' | 'Z' | 'skew';
+    axis: "X" | "Y" | "Z" | "skew";
     /** Current stored angular momentum in N·m·s */
     momentumNms: number;
     /** Maximum momentum capacity in N·m·s */
@@ -334,7 +334,7 @@ export interface ReactionWheelData {
     /** Maximum wheel speed in RPM */
     maxSpeedRpm: number;
     /** Operational status */
-    status: 'nominal' | 'saturated' | 'desaturating' | 'off' | 'error';
+    status: "nominal" | "saturated" | "desaturating" | "off" | "error";
     /** Power consumption in Watts */
     powerW?: number;
     /** Bearing temperature in °C */
@@ -373,9 +373,9 @@ export interface ThrusterFireEvent {
     /** Burn duration in seconds */
     durationSeconds: number;
     /** Event type */
-    type: 'impulsive' | 'finite' | 'continuous';
+    type: "impulsive" | "finite" | "continuous";
 }
-export type PlanetId = 'sun' | 'mercury' | 'venus' | 'earth' | 'moon' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto';
+export type PlanetId = "sun" | "mercury" | "venus" | "earth" | "moon" | "mars" | "jupiter" | "saturn" | "uranus" | "neptune" | "pluto";
 export interface PlanetInfo {
     id: PlanetId;
     name: string;

package/dist/react/types.js

@@ -1,58 +1,158 @@
+//#region src/react/types.ts
+/**
+* Estimate orbital period from altitude (simplified)
+*/
 function estimateOrbitalPeriod(altitudeKm) {
-  const earthRadiusKm = 6371;
-  const mu = 398600.4418;
-  const semiMajorAxis = earthRadiusKm + altitudeKm;
-  const period = 2 * Math.PI * Math.sqrt(Math.pow(semiMajorAxis, 3) / mu);
-  return period / 60;
+	const earthRadiusKm = 6371;
+	const mu = 398600.4418;
+	const semiMajorAxis = earthRadiusKm + altitudeKm;
+	return 2 * Math.PI * Math.sqrt(Math.pow(semiMajorAxis, 3) / mu) / 60;
 }
+/**
+* Estimate orbital velocity from altitude (simplified)
+*/
 function estimateOrbitalVelocity(altitudeKm) {
-  const earthRadiusKm = 6371;
-  const mu = 398600.4418;
-  const radius = earthRadiusKm + altitudeKm;
-  return Math.sqrt(mu / radius);
+	const earthRadiusKm = 6371;
+	const mu = 398600.4418;
+	const radius = earthRadiusKm + altitudeKm;
+	return Math.sqrt(mu / radius);
 }
+/**
+* Convert AU to kilometers
+*/
 function auToKm(au) {
-  return au * 1495978707e-1;
+	return au * 149597870.7;
 }
+/**
+* Normalize planet name to PlanetId
+*/
 function normalizePlanetName(name) {
-  const normalized = name.toLowerCase().trim();
-  const validPlanets = [
-    "sun",
-    "mercury",
-    "venus",
-    "earth",
-    "moon",
-    "mars",
-    "jupiter",
-    "saturn",
-    "uranus",
-    "neptune",
-    "pluto"
-  ];
-  return validPlanets.includes(normalized) ? normalized : null;
+	const normalized = name.toLowerCase().trim();
+	return [
+		"sun",
+		"mercury",
+		"venus",
+		"earth",
+		"moon",
+		"mars",
+		"jupiter",
+		"saturn",
+		"uranus",
+		"neptune",
+		"pluto"
+	].includes(normalized) ? normalized : null;
 }
+/**
+* Get planet info by ID
+*/
 function getPlanet(id) {
-  return PLANETS.find((p) => p.id === id);
+	return PLANETS.find((p) => p.id === id);
 }
-const PLANETS = [
-  { id: "sun", name: "Sun", radius: 696340, mass: 1989e27, semiMajorAxis: 0, orbitalPeriod: 0, color: "#ffcc00" },
-  { id: "mercury", name: "Mercury", radius: 2439.7, mass: 33011e19, semiMajorAxis: 0.387, orbitalPeriod: 88, color: "#b5b5b5" },
-  { id: "venus", name: "Venus", radius: 6051.8, mass: 48675e20, semiMajorAxis: 0.723, orbitalPeriod: 225, color: "#e6c87a" },
-  { id: "earth", name: "Earth", radius: 6371, mass: 5972e21, semiMajorAxis: 1, orbitalPeriod: 365, color: "#4da6ff" },
-  { id: "moon", name: "Moon", radius: 1737.4, mass: 7342e19, semiMajorAxis: 257e-5, orbitalPeriod: 27.3, color: "#c0c0c0" },
-  { id: "mars", name: "Mars", radius: 3389.5, mass: 64171e19, semiMajorAxis: 1.524, orbitalPeriod: 687, color: "#e07b4a" },
-  { id: "jupiter", name: "Jupiter", radius: 69911, mass: 18982e23, semiMajorAxis: 5.203, orbitalPeriod: 4333, color: "#d8ca9d" },
-  { id: "saturn", name: "Saturn", radius: 58232, mass: 56834e22, semiMajorAxis: 9.537, orbitalPeriod: 10759, color: "#f4d59e" },
-  { id: "uranus", name: "Uranus", radius: 25362, mass: 8681e22, semiMajorAxis: 19.19, orbitalPeriod: 30687, color: "#b3e0e6" },
-  { id: "neptune", name: "Neptune", radius: 24622, mass: 102413e21, semiMajorAxis: 30.07, orbitalPeriod: 60190, color: "#5b7fff" },
-  { id: "pluto", name: "Pluto", radius: 1188.3, mass: 1303e19, semiMajorAxis: 39.48, orbitalPeriod: 90560, color: "#c9b79c" }
+/**
+* Planet data (simplified)
+*/
+var PLANETS = [
+	{
+		id: "sun",
+		name: "Sun",
+		radius: 696340,
+		mass: 1989e27,
+		semiMajorAxis: 0,
+		orbitalPeriod: 0,
+		color: "#ffcc00"
+	},
+	{
+		id: "mercury",
+		name: "Mercury",
+		radius: 2439.7,
+		mass: 33011e19,
+		semiMajorAxis: .387,
+		orbitalPeriod: 88,
+		color: "#b5b5b5"
+	},
+	{
+		id: "venus",
+		name: "Venus",
+		radius: 6051.8,
+		mass: 48675e20,
+		semiMajorAxis: .723,
+		orbitalPeriod: 225,
+		color: "#e6c87a"
+	},
+	{
+		id: "earth",
+		name: "Earth",
+		radius: 6371,
+		mass: 5972e21,
+		semiMajorAxis: 1,
+		orbitalPeriod: 365,
+		color: "#4da6ff"
+	},
+	{
+		id: "moon",
+		name: "Moon",
+		radius: 1737.4,
+		mass: 7342e19,
+		semiMajorAxis: .00257,
+		orbitalPeriod: 27.3,
+		color: "#c0c0c0"
+	},
+	{
+		id: "mars",
+		name: "Mars",
+		radius: 3389.5,
+		mass: 64171e19,
+		semiMajorAxis: 1.524,
+		orbitalPeriod: 687,
+		color: "#e07b4a"
+	},
+	{
+		id: "jupiter",
+		name: "Jupiter",
+		radius: 69911,
+		mass: 18982e23,
+		semiMajorAxis: 5.203,
+		orbitalPeriod: 4333,
+		color: "#d8ca9d"
+	},
+	{
+		id: "saturn",
+		name: "Saturn",
+		radius: 58232,
+		mass: 56834e22,
+		semiMajorAxis: 9.537,
+		orbitalPeriod: 10759,
+		color: "#f4d59e"
+	},
+	{
+		id: "uranus",
+		name: "Uranus",
+		radius: 25362,
+		mass: 8681e22,
+		semiMajorAxis: 19.19,
+		orbitalPeriod: 30687,
+		color: "#b3e0e6"
+	},
+	{
+		id: "neptune",
+		name: "Neptune",
+		radius: 24622,
+		mass: 102413e21,
+		semiMajorAxis: 30.07,
+		orbitalPeriod: 60190,
+		color: "#5b7fff"
+	},
+	{
+		id: "pluto",
+		name: "Pluto",
+		radius: 1188.3,
+		mass: 1303e19,
+		semiMajorAxis: 39.48,
+		orbitalPeriod: 90560,
+		color: "#c9b79c"
+	}
 ];
-export {
-  PLANETS,
-  auToKm,
-  estimateOrbitalPeriod,
-  estimateOrbitalVelocity,
-  getPlanet,
-  normalizePlanetName
-};
-//# sourceMappingURL=types.js.map
+//#endregion
+export { PLANETS, auToKm, estimateOrbitalPeriod, estimateOrbitalVelocity, getPlanet, normalizePlanetName };
+
+//# sourceMappingURL=types.js.map

package/dist/react/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/react/types.ts"],"sourcesContent":["/**\r\n * @zendir/ui - Local Type Definitions\r\n *\r\n * UI-domain types (`Quaternion`, `Vector3D`, `PointingMode`, etc.) used by\r\n * the visualization components. These live in `@zendir/ui` because they\r\n * describe what the UI renders — they are NOT shipped by `zendir-ts`,\r\n * which is REST-only and intentionally minimal.\r\n *\r\n * Helpers like `estimateOrbitalPeriod` / `estimateOrbitalVelocity` are\r\n * pure client-side approximations used for quick UI estimates; for\r\n * physics-accurate values, fetch the real properties from the engine\r\n * via `client.getProperties(...)`.\r\n */\r\n\r\n// =============================================================================\r\n// Category / Group Primitive\r\n// =============================================================================\r\n\r\n/**\r\n * A named, colored data category — the SDK's shared concept for any secondary\r\n * grouping dimension (teams, squads, subsystems, mission phases, etc.).\r\n *\r\n * Components that support category-aware coloring accept `CategoryDef` arrays\r\n * and/or a `categoryId` field on individual data items. The `CategoryPalette`\r\n * utility resolves ids → colors/labels consistently across an entire dashboard.\r\n *\r\n * @example\r\n * const categories: CategoryDef[] = [\r\n *   { id: 'alpha', label: 'Team Alpha', color: '#2dccff' },\r\n *   { id: 'bravo', label: 'Team Bravo', color: '#fce83a' },\r\n * ];\r\n */\r\nexport interface CategoryDef {\r\n  /** Stable unique identifier (string or numeric) */\r\n  id: string | number;\r\n  /** Human-readable display name */\r\n  label: string;\r\n  /** CSS color used for visual accents (stripes, rings, swatches, series lines) */\r\n  color: string;\r\n  /** Optional icon name from the Astro icon set */\r\n  icon?: string;\r\n  /** Arbitrary metadata for app-specific needs */\r\n  meta?: Record<string, unknown>;\r\n}\r\n\r\n// =============================================================================\r\n// Spacecraft Types\r\n// =============================================================================\r\n\r\nexport interface SpacecraftPosition {\r\n  /** Optional spacecraft id (when combined with Spacecraft) */\r\n  id?: string;\r\n  /** Optional display name */\r\n  name?: string;\r\n  /** Latitude in degrees (-90 to 90) */\r\n  latitude: number;\r\n  /** Longitude in degrees (-180 to 180) */\r\n  longitude: number;\r\n  /** Altitude in kilometers */\r\n  altitude: number;\r\n  /** Velocity in km/s */\r\n  velocity?: number;\r\n  /** Heading in degrees */\r\n  heading?: number;\r\n  /** Timestamp */\r\n  timestamp?: string;\r\n  /** Orbit type (e.g. LEO, GEO) */\r\n  orbitType?: string;\r\n  /** Orbital inclination in degrees */\r\n  inclination?: number;\r\n  /** Health/operational status using AstroUXDS 6-level system */\r\n  status?: 'off' | 'standby' | 'normal' | 'caution' | 'serious' | 'critical';\r\n}\r\n\r\nexport interface Spacecraft {\r\n  id: string;\r\n  name: string;\r\n  noradId?: number;\r\n  type?: string;\r\n  /** Status using AstroUXDS 6-level system */\r\n  status?: 'off' | 'standby' | 'normal' | 'caution' | 'serious' | 'critical';\r\n}\r\n\r\n// =============================================================================\r\n// Ground Station Types\r\n// =============================================================================\r\n\r\nexport interface GroundStation {\r\n  id: string;\r\n  name: string;\r\n  latitude: number;\r\n  longitude: number;\r\n  elevation?: number;\r\n  /** Minimum elevation angle for visibility (degrees) */\r\n  minElevation?: number;\r\n  network?: string;\r\n}\r\n\r\nexport interface GroundTrackPoint {\r\n  latitude: number;\r\n  longitude: number;\r\n  altitude: number;\r\n  timestamp: string;\r\n}\r\n\r\n// =============================================================================\r\n// Layer Definition (shared by 2D map + 3D viewer panels)\r\n// =============================================================================\r\n\r\n/**\r\n * Developer-defined toggle in a Layers panel. The component that owns the\r\n * panel only renders the toggle UI — it does NOT render the layer's\r\n * content. The consumer app listens to the panel's `onChange` and\r\n * renders/hides its own overlay accordingly.\r\n *\r\n * Used by both `<GroundTrackMap />` (2D map overlays) and the upcoming\r\n * `<LayerControlPanel />` for the 3D viewer.\r\n */\r\nexport interface LayerDef {\r\n  /** Unique identifier (e.g. 'heatmap', 'coverage', 'spacecraft'). */\r\n  id: string;\r\n  /** Display label in the Layers panel. */\r\n  label: string;\r\n  /** Whether the layer is on by default (default true). */\r\n  defaultEnabled?: boolean;\r\n  /** Optional grouping bucket for the panel ('overlays', 'objects', etc.). */\r\n  category?: string;\r\n}\r\n\r\n/**\r\n * @deprecated Use `LayerDef`. Alias kept for backward compatibility with\r\n * existing `<GroundTrackMap />` consumers.\r\n */\r\nexport type MapLayerDef = LayerDef;\r\n\r\n// =============================================================================\r\n// Access / Contact Types\r\n// =============================================================================\r\n\r\nexport interface AccessData {\r\n  stationId: string;\r\n  stationName: string;\r\n  spacecraftId: string;\r\n  aos: string; // Acquisition of Signal - ISO timestamp\r\n  los: string; // Loss of Signal - ISO timestamp\r\n  maxElevation: number;\r\n  azimuthAos?: number;\r\n  azimuthLos?: number;\r\n  /** Whether link is currently accessible */\r\n  isAccessible?: boolean;\r\n  /** Current elevation angle (degrees) */\r\n  elevation?: number;\r\n  /** Current azimuth (degrees) */\r\n  azimuth?: number;\r\n  /** Slant range in km */\r\n  slantRange?: number;\r\n  /** Signal strength 0-100 */\r\n  signalStrength?: number;\r\n  /** Link budget details */\r\n  linkBudget?: {\r\n    receivedPower?: number;\r\n    snr?: number;\r\n    dataRate?: number;\r\n  };\r\n}\r\n\r\nexport interface AccessWindow {\r\n  aos: string;\r\n  los: string;\r\n  maxElevation: number;\r\n  stationId: string;\r\n  /** Start time (ISO or ms) */\r\n  startTime?: string | number;\r\n  /** Duration in seconds */\r\n  duration?: number;\r\n}\r\n\r\n// =============================================================================\r\n// Telemetry Types\r\n// =============================================================================\r\n\r\nexport interface TelemetryData {\r\n  timestamp: string;\r\n  subsystems: {\r\n    power?: {\r\n      status: string;\r\n      batteryLevel?: number;\r\n      solarArrayOutput?: number;\r\n      voltage?: number;\r\n      solarGeneration?: number;\r\n      consumption?: number;\r\n    };\r\n    thermal?: {\r\n      status: string;\r\n      cpuTemp?: number;\r\n      batteryTemp?: number;\r\n    };\r\n    comms?: {\r\n      status: string;\r\n      signalStrength?: number;\r\n      dataRate?: number;\r\n      downlinkRate?: number;\r\n      transmitterStatus?: string;\r\n      packetsQueued?: number;\r\n      bytesTransmitted?: number;\r\n      packetsTransmitted?: number;\r\n    };\r\n    attitude?: {\r\n      status: string;\r\n      pointingError?: number;\r\n      eulerAngles?: EulerAngles;\r\n      targetMode?: string;\r\n    };\r\n  };\r\n  /** Health status (convenience alias / extended) */\r\n  health?: {\r\n    status?: string;\r\n    anomalies?: Array<{ id: string; message: string; severity?: string }>;\r\n  };\r\n  /** Power (convenience alias for subsystems.power / extended) */\r\n  power?: {\r\n    status?: string;\r\n    batteryLevel?: number;\r\n    solarArrayOutput?: number;\r\n    voltage?: number;\r\n    solarGeneration?: number;\r\n    consumption?: number;\r\n  };\r\n  /** Attitude (convenience alias / extended) */\r\n  attitude?: {\r\n    status?: string;\r\n    eulerAngles?: EulerAngles;\r\n    targetMode?: string;\r\n    pointingError?: number;\r\n  };\r\n  /** Communications (convenience alias / extended) */\r\n  communications?: {\r\n    status?: string;\r\n    signalStrength?: number;\r\n    dataRate?: number;\r\n    downlinkRate?: number;\r\n    transmitterStatus?: string;\r\n    packetsQueued?: number;\r\n    bytesTransmitted?: number;\r\n    packetsTransmitted?: number;\r\n  };\r\n  alerts?: Array<{\r\n    id: string;\r\n    severity: string;\r\n    message: string;\r\n    timestamp: string;\r\n  }>;\r\n}\r\n\r\n// =============================================================================\r\n// Orbital Types\r\n// =============================================================================\r\n\r\nexport interface OrbitalElements {\r\n  semiMajorAxis: number;\r\n  eccentricity: number;\r\n  inclination: number;\r\n  raan: number; // Right Ascension of Ascending Node\r\n  argumentOfPerigee: number;\r\n  trueAnomaly: number;\r\n  period?: number;\r\n  epoch?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Attitude Types\r\n// =============================================================================\r\n\r\nexport interface Quaternion {\r\n  x: number;\r\n  y: number;\r\n  z: number;\r\n  w: number;\r\n}\r\n\r\nexport interface EulerAngles {\r\n  roll: number;\r\n  pitch: number;\r\n  yaw: number;\r\n}\r\n\r\nexport interface AngularVelocity {\r\n  x: number;\r\n  y: number;\r\n  z: number;\r\n}\r\n\r\nexport interface AttitudeData {\r\n  quaternion: Quaternion;\r\n  eulerAngles: EulerAngles;\r\n  angularVelocity: AngularVelocity;\r\n  targetMode?: string;\r\n  /** Pointing error in degrees */\r\n  pointingError?: number;\r\n  /** Target direction vector [x, y, z] */\r\n  targetDirection?: [number, number, number];\r\n}\r\n\r\nexport type PointingMode = 'nadir' | 'sun' | 'target' | 'inertial' | 'velocity';\r\n\r\n// =============================================================================\r\n// Eclipse Types\r\n// =============================================================================\r\n\r\nexport interface EclipseInfo {\r\n  inEclipse: boolean;\r\n  timeToEclipse: number; // seconds\r\n  eclipseDuration: number; // seconds\r\n  sunlightDuration: number; // seconds\r\n  /** Umbra duration in seconds */\r\n  umbraDuration?: number;\r\n  /** Penumbra duration in seconds */\r\n  penumbraDuration?: number;\r\n  /** Seconds until sunlight (when in eclipse) */\r\n  timeToSunlight?: number;\r\n}\r\n\r\n// =============================================================================\r\n// Link Budget Types\r\n// =============================================================================\r\n\r\nexport interface DetailedLinkBudget {\r\n  spacecraftId: string;\r\n  groundStationId: string;\r\n  frequency: number;\r\n  eirp: number;\r\n  pathLoss: number;\r\n  atmosphericLoss: number;\r\n  receiverGain: number;\r\n  systemNoiseTemp: number;\r\n  cnoRequired: number;\r\n  cnoActual: number;\r\n  margin: number;\r\n  dataRate: number;\r\n}\r\n\r\n// =============================================================================\r\n// Thermal Types\r\n// =============================================================================\r\n\r\nexport interface ThermalZone {\r\n  id: string;\r\n  name: string;\r\n  temperature: number;\r\n  minLimit: number;\r\n  maxLimit: number;\r\n}\r\n\r\nexport interface ThermalData {\r\n  timestamp: string;\r\n  zones: ThermalZone[];\r\n  averageTemp: number;\r\n  hottest: { zone: string; temp: number };\r\n  coldest: { zone: string; temp: number };\r\n}\r\n\r\n// =============================================================================\r\n// Propulsion Types\r\n// =============================================================================\r\n\r\nexport interface ThrusterStatus {\r\n  id: string;\r\n  name: string;\r\n  status: 'ready' | 'firing' | 'disabled' | 'error';\r\n  fuelFlow?: number;\r\n}\r\n\r\nexport interface PropulsionSummary {\r\n  fuelRemaining: number;\r\n  fuelCapacity: number;\r\n  thrusterStatus: ThrusterStatus[];\r\n  deltaVRemaining: number;\r\n  deltaVUsed: number;\r\n  lastManeuver?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Reaction Wheel / Momentum Types\r\n// =============================================================================\r\n\r\nexport interface ReactionWheelData {\r\n  /** Unique wheel identifier */\r\n  id: string;\r\n  /** Display name (e.g. \"RW-X\", \"RW-1\") */\r\n  name: string;\r\n  /** Mounted axis */\r\n  axis: 'X' | 'Y' | 'Z' | 'skew';\r\n  /** Current stored angular momentum in N·m·s */\r\n  momentumNms: number;\r\n  /** Maximum momentum capacity in N·m·s */\r\n  maxMomentumNms: number;\r\n  /** Current wheel speed in RPM */\r\n  speedRpm: number;\r\n  /** Maximum wheel speed in RPM */\r\n  maxSpeedRpm: number;\r\n  /** Operational status */\r\n  status: 'nominal' | 'saturated' | 'desaturating' | 'off' | 'error';\r\n  /** Power consumption in Watts */\r\n  powerW?: number;\r\n  /** Bearing temperature in °C */\r\n  temperatureC?: number;\r\n}\r\n\r\n/** LVLH (Local Vertical Local Horizontal) frame vector */\r\nexport interface LVLHVector {\r\n  /** Radial component (local vertical, positive away from Earth) */\r\n  radial: number;\r\n  /** In-track component (along velocity vector) */\r\n  inTrack: number;\r\n  /** Cross-track component (normal to orbital plane) */\r\n  crossTrack: number;\r\n}\r\n\r\n/** Time-stamped LVLH state for trajectory plotting */\r\nexport interface LVLHState {\r\n  /** Timestamp in milliseconds */\r\n  time: number;\r\n  /** Position in LVLH frame (km) */\r\n  position: LVLHVector;\r\n  /** Velocity in LVLH frame (km/s) */\r\n  velocity: LVLHVector;\r\n}\r\n\r\n/** Thruster firing event */\r\nexport interface ThrusterFireEvent {\r\n  /** Event timestamp in milliseconds */\r\n  time: number;\r\n  /** Thruster ID */\r\n  thrusterId: string;\r\n  /** Display name */\r\n  name: string;\r\n  /** Delta-V magnitude in m/s */\r\n  deltaVMs: number;\r\n  /** Delta-V direction in LVLH frame (unit vector) */\r\n  deltaVDirection?: LVLHVector;\r\n  /** Burn duration in seconds */\r\n  durationSeconds: number;\r\n  /** Event type */\r\n  type: 'impulsive' | 'finite' | 'continuous';\r\n}\r\n\r\n// =============================================================================\r\n// Planet Types\r\n// =============================================================================\r\n\r\nexport type PlanetId = \r\n  | 'sun' \r\n  | 'mercury' \r\n  | 'venus' \r\n  | 'earth' \r\n  | 'moon' \r\n  | 'mars' \r\n  | 'jupiter' \r\n  | 'saturn' \r\n  | 'uranus' \r\n  | 'neptune' \r\n  | 'pluto';\r\n\r\nexport interface PlanetInfo {\r\n  id: PlanetId;\r\n  name: string;\r\n  radius: number; // km\r\n  /** @deprecated Use radius */\r\n  radiusKm?: number;\r\n  mass: number; // kg\r\n  semiMajorAxis: number; // AU\r\n  /** Distance from Sun in AU (alias for semiMajorAxis) */\r\n  distanceFromSunAU?: number;\r\n  orbitalPeriod: number; // Earth days\r\n  color: string;\r\n}\r\n\r\n// =============================================================================\r\n// Utility Functions (fallbacks when SDK not available)\r\n// =============================================================================\r\n\r\n/**\r\n * Estimate orbital period from altitude (simplified)\r\n */\r\nexport function estimateOrbitalPeriod(altitudeKm: number): number {\r\n  const earthRadiusKm = 6371;\r\n  const mu = 398600.4418; // km³/s² - Earth's gravitational parameter\r\n  const semiMajorAxis = earthRadiusKm + altitudeKm;\r\n  const period = 2 * Math.PI * Math.sqrt(Math.pow(semiMajorAxis, 3) / mu);\r\n  return period / 60; // Return in minutes\r\n}\r\n\r\n/**\r\n * Estimate orbital velocity from altitude (simplified)\r\n */\r\nexport function estimateOrbitalVelocity(altitudeKm: number): number {\r\n  const earthRadiusKm = 6371;\r\n  const mu = 398600.4418; // km³/s²\r\n  const radius = earthRadiusKm + altitudeKm;\r\n  return Math.sqrt(mu / radius); // km/s\r\n}\r\n\r\n/**\r\n * Convert AU to kilometers\r\n */\r\nexport function auToKm(au: number): number {\r\n  return au * 149597870.7;\r\n}\r\n\r\n/**\r\n * Normalize planet name to PlanetId\r\n */\r\nexport function normalizePlanetName(name: string): PlanetId | null {\r\n  const normalized = name.toLowerCase().trim();\r\n  const validPlanets: PlanetId[] = [\r\n    'sun', 'mercury', 'venus', 'earth', 'moon', \r\n    'mars', 'jupiter', 'saturn', 'uranus', 'neptune', 'pluto'\r\n  ];\r\n  return validPlanets.includes(normalized as PlanetId) \r\n    ? (normalized as PlanetId) \r\n    : null;\r\n}\r\n\r\n/**\r\n * Get planet info by ID\r\n */\r\nexport function getPlanet(id: PlanetId): PlanetInfo | undefined {\r\n  return PLANETS.find(p => p.id === id);\r\n}\r\n\r\n/**\r\n * Planet data (simplified)\r\n */\r\nexport const PLANETS: PlanetInfo[] = [\r\n  { id: 'sun', name: 'Sun', radius: 696340, mass: 1.989e30, semiMajorAxis: 0, orbitalPeriod: 0, color: '#ffcc00' },\r\n  { id: 'mercury', name: 'Mercury', radius: 2439.7, mass: 3.3011e23, semiMajorAxis: 0.387, orbitalPeriod: 88, color: '#b5b5b5' },\r\n  { id: 'venus', name: 'Venus', radius: 6051.8, mass: 4.8675e24, semiMajorAxis: 0.723, orbitalPeriod: 225, color: '#e6c87a' },\r\n  { id: 'earth', name: 'Earth', radius: 6371, mass: 5.972e24, semiMajorAxis: 1.0, orbitalPeriod: 365, color: '#4da6ff' },\r\n  { id: 'moon', name: 'Moon', radius: 1737.4, mass: 7.342e22, semiMajorAxis: 0.00257, orbitalPeriod: 27.3, color: '#c0c0c0' },\r\n  { id: 'mars', name: 'Mars', radius: 3389.5, mass: 6.4171e23, semiMajorAxis: 1.524, orbitalPeriod: 687, color: '#e07b4a' },\r\n  { id: 'jupiter', name: 'Jupiter', radius: 69911, mass: 1.8982e27, semiMajorAxis: 5.203, orbitalPeriod: 4333, color: '#d8ca9d' },\r\n  { id: 'saturn', name: 'Saturn', radius: 58232, mass: 5.6834e26, semiMajorAxis: 9.537, orbitalPeriod: 10759, color: '#f4d59e' },\r\n  { id: 'uranus', name: 'Uranus', radius: 25362, mass: 8.6810e25, semiMajorAxis: 19.19, orbitalPeriod: 30687, color: '#b3e0e6' },\r\n  { id: 'neptune', name: 'Neptune', radius: 24622, mass: 1.02413e26, semiMajorAxis: 30.07, orbitalPeriod: 60190, color: '#5b7fff' },\r\n  { id: 'pluto', name: 'Pluto', radius: 1188.3, mass: 1.303e22, semiMajorAxis: 39.48, orbitalPeriod: 90560, color: '#c9b79c' },\r\n];\r\n"],"names":[],"mappings":"AAoeO,SAAS,sBAAsB,YAA4B;AAChE,QAAM,gBAAgB;AACtB,QAAM,KAAK;AACX,QAAM,gBAAgB,gBAAgB;AACtC,QAAM,SAAS,IAAI,KAAK,KAAK,KAAK,KAAK,KAAK,IAAI,eAAe,CAAC,IAAI,EAAE;AACtE,SAAO,SAAS;AAClB;AAKO,SAAS,wBAAwB,YAA4B;AAClE,QAAM,gBAAgB;AACtB,QAAM,KAAK;AACX,QAAM,SAAS,gBAAgB;AAC/B,SAAO,KAAK,KAAK,KAAK,MAAM;AAC9B;AAKO,SAAS,OAAO,IAAoB;AACzC,SAAO,KAAK;AACd;AAKO,SAAS,oBAAoB,MAA+B;AACjE,QAAM,aAAa,KAAK,YAAA,EAAc,KAAA;AACtC,QAAM,eAA2B;AAAA,IAC/B;AAAA,IAAO;AAAA,IAAW;AAAA,IAAS;AAAA,IAAS;AAAA,IACpC;AAAA,IAAQ;AAAA,IAAW;AAAA,IAAU;AAAA,IAAU;AAAA,IAAW;AAAA,EAAA;AAEpD,SAAO,aAAa,SAAS,UAAsB,IAC9C,aACD;AACN;AAKO,SAAS,UAAU,IAAsC;AAC9D,SAAO,QAAQ,KAAK,CAAA,MAAK,EAAE,OAAO,EAAE;AACtC;AAKO,MAAM,UAAwB;AAAA,EACnC,EAAE,IAAI,OAAO,MAAM,OAAO,QAAQ,QAAQ,MAAM,SAAU,eAAe,GAAG,eAAe,GAAG,OAAO,UAAA;AAAA,EACrG,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,QAAQ,MAAM,UAAW,eAAe,OAAO,eAAe,IAAI,OAAO,UAAA;AAAA,EACnH,EAAE,IAAI,SAAS,MAAM,SAAS,QAAQ,QAAQ,MAAM,UAAW,eAAe,OAAO,eAAe,KAAK,OAAO,UAAA;AAAA,EAChH,EAAE,IAAI,SAAS,MAAM,SAAS,QAAQ,MAAM,MAAM,SAAU,eAAe,GAAK,eAAe,KAAK,OAAO,UAAA;AAAA,EAC3G,EAAE,IAAI,QAAQ,MAAM,QAAQ,QAAQ,QAAQ,MAAM,SAAU,eAAe,QAAS,eAAe,MAAM,OAAO,UAAA;AAAA,EAChH,EAAE,IAAI,QAAQ,MAAM,QAAQ,QAAQ,QAAQ,MAAM,UAAW,eAAe,OAAO,eAAe,KAAK,OAAO,UAAA;AAAA,EAC9G,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,OAAO,MAAM,UAAW,eAAe,OAAO,eAAe,MAAM,OAAO,UAAA;AAAA,EACpH,EAAE,IAAI,UAAU,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAW,eAAe,OAAO,eAAe,OAAO,OAAO,UAAA;AAAA,EACnH,EAAE,IAAI,UAAU,MAAM,UAAU,QAAQ,OAAO,MAAM,SAAW,eAAe,OAAO,eAAe,OAAO,OAAO,UAAA;AAAA,EACnH,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,OAAO,MAAM,WAAY,eAAe,OAAO,eAAe,OAAO,OAAO,UAAA;AAAA,EACtH,EAAE,IAAI,SAAS,MAAM,SAAS,QAAQ,QAAQ,MAAM,SAAU,eAAe,OAAO,eAAe,OAAO,OAAO,UAAA;AACnH;"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/react/types.ts"],"sourcesContent":["/**\n * @zendir/ui - Local Type Definitions\n *\n * UI-domain types (`Quaternion`, `Vector3D`, `PointingMode`, etc.) used by\n * the visualization components. These live in `@zendir/ui` because they\n * describe what the UI renders — they are NOT shipped by `zendir-ts`,\n * which is REST-only and intentionally minimal.\n *\n * Helpers like `estimateOrbitalPeriod` / `estimateOrbitalVelocity` are\n * pure client-side approximations used for quick UI estimates; for\n * physics-accurate values, fetch the real properties from the engine\n * via `client.getProperties(...)`.\n */\n\n// =============================================================================\n// Category / Group Primitive\n// =============================================================================\n\n/**\n * A named, colored data category — the SDK's shared concept for any secondary\n * grouping dimension (teams, squads, subsystems, mission phases, etc.).\n *\n * Components that support category-aware coloring accept `CategoryDef` arrays\n * and/or a `categoryId` field on individual data items. The `CategoryPalette`\n * utility resolves ids → colors/labels consistently across an entire dashboard.\n *\n * @example\n * const categories: CategoryDef[] = [\n *   { id: 'alpha', label: 'Team Alpha', color: '#2dccff' },\n *   { id: 'bravo', label: 'Team Bravo', color: '#fce83a' },\n * ];\n */\nexport interface CategoryDef {\n  /** Stable unique identifier (string or numeric) */\n  id: string | number;\n  /** Human-readable display name */\n  label: string;\n  /** CSS color used for visual accents (stripes, rings, swatches, series lines) */\n  color: string;\n  /** Optional icon name from the Astro icon set */\n  icon?: string;\n  /** Arbitrary metadata for app-specific needs */\n  meta?: Record<string, unknown>;\n}\n\n// =============================================================================\n// Spacecraft Types\n// =============================================================================\n\nexport interface SpacecraftPosition {\n  /** Optional spacecraft id (when combined with Spacecraft) */\n  id?: string;\n  /** Optional display name */\n  name?: string;\n  /** Latitude in degrees (-90 to 90) */\n  latitude: number;\n  /** Longitude in degrees (-180 to 180) */\n  longitude: number;\n  /** Altitude in kilometers */\n  altitude: number;\n  /** Velocity in km/s */\n  velocity?: number;\n  /** Heading in degrees */\n  heading?: number;\n  /** Timestamp */\n  timestamp?: string;\n  /** Orbit type (e.g. LEO, GEO) */\n  orbitType?: string;\n  /** Orbital inclination in degrees */\n  inclination?: number;\n  /** Health/operational status using AstroUXDS 6-level system */\n  status?: \"off\" | \"standby\" | \"normal\" | \"caution\" | \"serious\" | \"critical\";\n}\n\nexport interface Spacecraft {\n  id: string;\n  name: string;\n  noradId?: number;\n  type?: string;\n  /** Status using AstroUXDS 6-level system */\n  status?: \"off\" | \"standby\" | \"normal\" | \"caution\" | \"serious\" | \"critical\";\n}\n\n// =============================================================================\n// Ground Station Types\n// =============================================================================\n\nexport interface GroundStation {\n  id: string;\n  name: string;\n  latitude: number;\n  longitude: number;\n  elevation?: number;\n  /** Minimum elevation angle for visibility (degrees) */\n  minElevation?: number;\n  network?: string;\n}\n\nexport interface GroundTrackPoint {\n  latitude: number;\n  longitude: number;\n  altitude: number;\n  timestamp: string;\n}\n\n// =============================================================================\n// Layer Definition (shared by 2D map + 3D viewer panels)\n// =============================================================================\n\n/**\n * Developer-defined toggle in a Layers panel. The component that owns the\n * panel only renders the toggle UI — it does NOT render the layer's\n * content. The consumer app listens to the panel's `onChange` and\n * renders/hides its own overlay accordingly.\n *\n * Used by both `<GroundTrackMap />` (2D map overlays) and the upcoming\n * `<LayerControlPanel />` for the 3D viewer.\n */\nexport interface LayerDef {\n  /** Unique identifier (e.g. 'heatmap', 'coverage', 'spacecraft'). */\n  id: string;\n  /** Display label in the Layers panel. */\n  label: string;\n  /** Whether the layer is on by default (default true). */\n  defaultEnabled?: boolean;\n  /** Optional grouping bucket for the panel ('overlays', 'objects', etc.). */\n  category?: string;\n}\n\n/**\n * @deprecated Use `LayerDef`. Alias kept for backward compatibility with\n * existing `<GroundTrackMap />` consumers.\n */\nexport type MapLayerDef = LayerDef;\n\n// =============================================================================\n// Access / Contact Types\n// =============================================================================\n\nexport interface AccessData {\n  stationId: string;\n  stationName: string;\n  spacecraftId: string;\n  aos: string; // Acquisition of Signal - ISO timestamp\n  los: string; // Loss of Signal - ISO timestamp\n  maxElevation: number;\n  azimuthAos?: number;\n  azimuthLos?: number;\n  /** Whether link is currently accessible */\n  isAccessible?: boolean;\n  /** Current elevation angle (degrees) */\n  elevation?: number;\n  /** Current azimuth (degrees) */\n  azimuth?: number;\n  /** Slant range in km */\n  slantRange?: number;\n  /** Signal strength 0-100 */\n  signalStrength?: number;\n  /** Link budget details */\n  linkBudget?: {\n    receivedPower?: number;\n    snr?: number;\n    dataRate?: number;\n  };\n}\n\nexport interface AccessWindow {\n  aos: string;\n  los: string;\n  maxElevation: number;\n  stationId: string;\n  /** Start time (ISO or ms) */\n  startTime?: string | number;\n  /** Duration in seconds */\n  duration?: number;\n}\n\n// =============================================================================\n// Telemetry Types\n// =============================================================================\n\nexport interface TelemetryData {\n  timestamp: string;\n  subsystems: {\n    power?: {\n      status: string;\n      batteryLevel?: number;\n      solarArrayOutput?: number;\n      voltage?: number;\n      solarGeneration?: number;\n      consumption?: number;\n    };\n    thermal?: {\n      status: string;\n      cpuTemp?: number;\n      batteryTemp?: number;\n    };\n    comms?: {\n      status: string;\n      signalStrength?: number;\n      dataRate?: number;\n      downlinkRate?: number;\n      transmitterStatus?: string;\n      packetsQueued?: number;\n      bytesTransmitted?: number;\n      packetsTransmitted?: number;\n    };\n    attitude?: {\n      status: string;\n      pointingError?: number;\n      eulerAngles?: EulerAngles;\n      targetMode?: string;\n    };\n  };\n  /** Health status (convenience alias / extended) */\n  health?: {\n    status?: string;\n    anomalies?: Array<{ id: string; message: string; severity?: string }>;\n  };\n  /** Power (convenience alias for subsystems.power / extended) */\n  power?: {\n    status?: string;\n    batteryLevel?: number;\n    solarArrayOutput?: number;\n    voltage?: number;\n    solarGeneration?: number;\n    consumption?: number;\n  };\n  /** Attitude (convenience alias / extended) */\n  attitude?: {\n    status?: string;\n    eulerAngles?: EulerAngles;\n    targetMode?: string;\n    pointingError?: number;\n  };\n  /** Communications (convenience alias / extended) */\n  communications?: {\n    status?: string;\n    signalStrength?: number;\n    dataRate?: number;\n    downlinkRate?: number;\n    transmitterStatus?: string;\n    packetsQueued?: number;\n    bytesTransmitted?: number;\n    packetsTransmitted?: number;\n  };\n  alerts?: Array<{\n    id: string;\n    severity: string;\n    message: string;\n    timestamp: string;\n  }>;\n}\n\n// =============================================================================\n// Orbital Types\n// =============================================================================\n\nexport interface OrbitalElements {\n  semiMajorAxis: number;\n  eccentricity: number;\n  inclination: number;\n  raan: number; // Right Ascension of Ascending Node\n  argumentOfPerigee: number;\n  trueAnomaly: number;\n  period?: number;\n  epoch?: string;\n}\n\n// =============================================================================\n// Attitude Types\n// =============================================================================\n\nexport interface Quaternion {\n  x: number;\n  y: number;\n  z: number;\n  w: number;\n}\n\nexport interface EulerAngles {\n  roll: number;\n  pitch: number;\n  yaw: number;\n}\n\nexport interface AngularVelocity {\n  x: number;\n  y: number;\n  z: number;\n}\n\nexport interface AttitudeData {\n  quaternion: Quaternion;\n  eulerAngles: EulerAngles;\n  angularVelocity: AngularVelocity;\n  targetMode?: string;\n  /** Pointing error in degrees */\n  pointingError?: number;\n  /** Target direction vector [x, y, z] */\n  targetDirection?: [number, number, number];\n}\n\nexport type PointingMode = \"nadir\" | \"sun\" | \"target\" | \"inertial\" | \"velocity\";\n\n// =============================================================================\n// Eclipse Types\n// =============================================================================\n\nexport interface EclipseInfo {\n  inEclipse: boolean;\n  timeToEclipse: number; // seconds\n  eclipseDuration: number; // seconds\n  sunlightDuration: number; // seconds\n  /** Umbra duration in seconds */\n  umbraDuration?: number;\n  /** Penumbra duration in seconds */\n  penumbraDuration?: number;\n  /** Seconds until sunlight (when in eclipse) */\n  timeToSunlight?: number;\n}\n\n// =============================================================================\n// Link Budget Types\n// =============================================================================\n\nexport interface DetailedLinkBudget {\n  spacecraftId: string;\n  groundStationId: string;\n  frequency: number;\n  eirp: number;\n  pathLoss: number;\n  atmosphericLoss: number;\n  receiverGain: number;\n  systemNoiseTemp: number;\n  cnoRequired: number;\n  cnoActual: number;\n  margin: number;\n  dataRate: number;\n}\n\n// =============================================================================\n// Thermal Types\n// =============================================================================\n\nexport interface ThermalZone {\n  id: string;\n  name: string;\n  temperature: number;\n  minLimit: number;\n  maxLimit: number;\n}\n\nexport interface ThermalData {\n  timestamp: string;\n  zones: ThermalZone[];\n  averageTemp: number;\n  hottest: { zone: string; temp: number };\n  coldest: { zone: string; temp: number };\n}\n\n// =============================================================================\n// Propulsion Types\n// =============================================================================\n\nexport interface ThrusterStatus {\n  id: string;\n  name: string;\n  status: \"ready\" | \"firing\" | \"disabled\" | \"error\";\n  fuelFlow?: number;\n}\n\nexport interface PropulsionSummary {\n  fuelRemaining: number;\n  fuelCapacity: number;\n  thrusterStatus: ThrusterStatus[];\n  deltaVRemaining: number;\n  deltaVUsed: number;\n  lastManeuver?: string;\n}\n\n// =============================================================================\n// Reaction Wheel / Momentum Types\n// =============================================================================\n\nexport interface ReactionWheelData {\n  /** Unique wheel identifier */\n  id: string;\n  /** Display name (e.g. \"RW-X\", \"RW-1\") */\n  name: string;\n  /** Mounted axis */\n  axis: \"X\" | \"Y\" | \"Z\" | \"skew\";\n  /** Current stored angular momentum in N·m·s */\n  momentumNms: number;\n  /** Maximum momentum capacity in N·m·s */\n  maxMomentumNms: number;\n  /** Current wheel speed in RPM */\n  speedRpm: number;\n  /** Maximum wheel speed in RPM */\n  maxSpeedRpm: number;\n  /** Operational status */\n  status: \"nominal\" | \"saturated\" | \"desaturating\" | \"off\" | \"error\";\n  /** Power consumption in Watts */\n  powerW?: number;\n  /** Bearing temperature in °C */\n  temperatureC?: number;\n}\n\n/** LVLH (Local Vertical Local Horizontal) frame vector */\nexport interface LVLHVector {\n  /** Radial component (local vertical, positive away from Earth) */\n  radial: number;\n  /** In-track component (along velocity vector) */\n  inTrack: number;\n  /** Cross-track component (normal to orbital plane) */\n  crossTrack: number;\n}\n\n/** Time-stamped LVLH state for trajectory plotting */\nexport interface LVLHState {\n  /** Timestamp in milliseconds */\n  time: number;\n  /** Position in LVLH frame (km) */\n  position: LVLHVector;\n  /** Velocity in LVLH frame (km/s) */\n  velocity: LVLHVector;\n}\n\n/** Thruster firing event */\nexport interface ThrusterFireEvent {\n  /** Event timestamp in milliseconds */\n  time: number;\n  /** Thruster ID */\n  thrusterId: string;\n  /** Display name */\n  name: string;\n  /** Delta-V magnitude in m/s */\n  deltaVMs: number;\n  /** Delta-V direction in LVLH frame (unit vector) */\n  deltaVDirection?: LVLHVector;\n  /** Burn duration in seconds */\n  durationSeconds: number;\n  /** Event type */\n  type: \"impulsive\" | \"finite\" | \"continuous\";\n}\n\n// =============================================================================\n// Planet Types\n// =============================================================================\n\nexport type PlanetId =\n  | \"sun\"\n  | \"mercury\"\n  | \"venus\"\n  | \"earth\"\n  | \"moon\"\n  | \"mars\"\n  | \"jupiter\"\n  | \"saturn\"\n  | \"uranus\"\n  | \"neptune\"\n  | \"pluto\";\n\nexport interface PlanetInfo {\n  id: PlanetId;\n  name: string;\n  radius: number; // km\n  /** @deprecated Use radius */\n  radiusKm?: number;\n  mass: number; // kg\n  semiMajorAxis: number; // AU\n  /** Distance from Sun in AU (alias for semiMajorAxis) */\n  distanceFromSunAU?: number;\n  orbitalPeriod: number; // Earth days\n  color: string;\n}\n\n// =============================================================================\n// Utility Functions (fallbacks when SDK not available)\n// =============================================================================\n\n/**\n * Estimate orbital period from altitude (simplified)\n */\nexport function estimateOrbitalPeriod(altitudeKm: number): number {\n  const earthRadiusKm = 6371;\n  const mu = 398600.4418; // km³/s² - Earth's gravitational parameter\n  const semiMajorAxis = earthRadiusKm + altitudeKm;\n  const period = 2 * Math.PI * Math.sqrt(Math.pow(semiMajorAxis, 3) / mu);\n  return period / 60; // Return in minutes\n}\n\n/**\n * Estimate orbital velocity from altitude (simplified)\n */\nexport function estimateOrbitalVelocity(altitudeKm: number): number {\n  const earthRadiusKm = 6371;\n  const mu = 398600.4418; // km³/s²\n  const radius = earthRadiusKm + altitudeKm;\n  return Math.sqrt(mu / radius); // km/s\n}\n\n/**\n * Convert AU to kilometers\n */\nexport function auToKm(au: number): number {\n  return au * 149597870.7;\n}\n\n/**\n * Normalize planet name to PlanetId\n */\nexport function normalizePlanetName(name: string): PlanetId | null {\n  const normalized = name.toLowerCase().trim();\n  const validPlanets: PlanetId[] = [\n    \"sun\",\n    \"mercury\",\n    \"venus\",\n    \"earth\",\n    \"moon\",\n    \"mars\",\n    \"jupiter\",\n    \"saturn\",\n    \"uranus\",\n    \"neptune\",\n    \"pluto\",\n  ];\n  return validPlanets.includes(normalized as PlanetId)\n    ? (normalized as PlanetId)\n    : null;\n}\n\n/**\n * Get planet info by ID\n */\nexport function getPlanet(id: PlanetId): PlanetInfo | undefined {\n  return PLANETS.find((p) => p.id === id);\n}\n\n/**\n * Planet data (simplified)\n */\nexport const PLANETS: PlanetInfo[] = [\n  {\n    id: \"sun\",\n    name: \"Sun\",\n    radius: 696340,\n    mass: 1.989e30,\n    semiMajorAxis: 0,\n    orbitalPeriod: 0,\n    color: \"#ffcc00\",\n  },\n  {\n    id: \"mercury\",\n    name: \"Mercury\",\n    radius: 2439.7,\n    mass: 3.3011e23,\n    semiMajorAxis: 0.387,\n    orbitalPeriod: 88,\n    color: \"#b5b5b5\",\n  },\n  {\n    id: \"venus\",\n    name: \"Venus\",\n    radius: 6051.8,\n    mass: 4.8675e24,\n    semiMajorAxis: 0.723,\n    orbitalPeriod: 225,\n    color: \"#e6c87a\",\n  },\n  {\n    id: \"earth\",\n    name: \"Earth\",\n    radius: 6371,\n    mass: 5.972e24,\n    semiMajorAxis: 1.0,\n    orbitalPeriod: 365,\n    color: \"#4da6ff\",\n  },\n  {\n    id: \"moon\",\n    name: \"Moon\",\n    radius: 1737.4,\n    mass: 7.342e22,\n    semiMajorAxis: 0.00257,\n    orbitalPeriod: 27.3,\n    color: \"#c0c0c0\",\n  },\n  {\n    id: \"mars\",\n    name: \"Mars\",\n    radius: 3389.5,\n    mass: 6.4171e23,\n    semiMajorAxis: 1.524,\n    orbitalPeriod: 687,\n    color: \"#e07b4a\",\n  },\n  {\n    id: \"jupiter\",\n    name: \"Jupiter\",\n    radius: 69911,\n    mass: 1.8982e27,\n    semiMajorAxis: 5.203,\n    orbitalPeriod: 4333,\n    color: \"#d8ca9d\",\n  },\n  {\n    id: \"saturn\",\n    name: \"Saturn\",\n    radius: 58232,\n    mass: 5.6834e26,\n    semiMajorAxis: 9.537,\n    orbitalPeriod: 10759,\n    color: \"#f4d59e\",\n  },\n  {\n    id: \"uranus\",\n    name: \"Uranus\",\n    radius: 25362,\n    mass: 8.681e25,\n    semiMajorAxis: 19.19,\n    orbitalPeriod: 30687,\n    color: \"#b3e0e6\",\n  },\n  {\n    id: \"neptune\",\n    name: \"Neptune\",\n    radius: 24622,\n    mass: 1.02413e26,\n    semiMajorAxis: 30.07,\n    orbitalPeriod: 60190,\n    color: \"#5b7fff\",\n  },\n  {\n    id: \"pluto\",\n    name: \"Pluto\",\n    radius: 1188.3,\n    mass: 1.303e22,\n    semiMajorAxis: 39.48,\n    orbitalPeriod: 90560,\n    color: \"#c9b79c\",\n  },\n];\n"],"mappings":";;;;AAoeA,SAAgB,sBAAsB,YAA4B;CAChE,MAAM,gBAAgB;CACtB,MAAM,KAAK;CACX,MAAM,gBAAgB,gBAAgB;CAEtC,OADe,IAAI,KAAK,KAAK,KAAK,KAAK,KAAK,IAAI,eAAe,CAAC,IAAI,EAAE,IACtD;AAClB;;;;AAKA,SAAgB,wBAAwB,YAA4B;CAClE,MAAM,gBAAgB;CACtB,MAAM,KAAK;CACX,MAAM,SAAS,gBAAgB;CAC/B,OAAO,KAAK,KAAK,KAAK,MAAM;AAC9B;;;;AAKA,SAAgB,OAAO,IAAoB;CACzC,OAAO,KAAK;AACd;;;;AAKA,SAAgB,oBAAoB,MAA+B;CACjE,MAAM,aAAa,KAAK,YAAY,CAAC,CAAC,KAAK;CAc3C,OAAO;EAZL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAEK,CAAA,CAAa,SAAS,UAAsB,IAC9C,aACD;AACN;;;;AAKA,SAAgB,UAAU,IAAsC;CAC9D,OAAO,QAAQ,MAAM,MAAM,EAAE,OAAO,EAAE;AACxC;;;;AAKA,IAAa,UAAwB;CACnC;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;CACA;EACE,IAAI;EACJ,MAAM;EACN,QAAQ;EACR,MAAM;EACN,eAAe;EACf,eAAe;EACf,OAAO;CACT;AACF"}

package/dist/react/utils/categoryPalette.d.ts

@@ -1,5 +1,4 @@
 import { CategoryDef } from '../types';
-
 export declare class CategoryPalette {
     /** Registered categories (insertion order) */
     private readonly _defs;

package/dist/react/utils/categoryPalette.js

@@ -1,104 +1,93 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-const DEFAULT_FALLBACK_PALETTE = [
-  "#3E3CFF",
-  // Zendir Electric
-  "#9D70FF",
-  // Zendir Purple
-  "#6B69FF",
-  // Electric 20 % lighter
-  "#B48DFF",
-  // Purple 20 % lighter
-  "#3548C0",
-  // Prussian Blue lighter
-  "#9997FF",
-  // Electric 35 % lighter
-  "#C9A8FF",
-  // Purple 35 % lighter
-  "#1B2DA0",
-  // Prussian Blue
-  "#3230CC",
-  // Electric 20 % darker
-  "#7E5ACC",
-  // Purple 20 % darker
-  "#4A5FD6"
-  // Prussian Blue lightest
+//#region src/react/utils/categoryPalette.ts
+/**
+* Default fallback palette — Astro-compliant data-viz colors.
+* Used when a category has no explicit color or when an unknown id is
+* encountered at runtime (auto-assignment by insertion order).
+*/
+var DEFAULT_FALLBACK_PALETTE = [
+	"#3E3CFF",
+	"#9D70FF",
+	"#6B69FF",
+	"#B48DFF",
+	"#3548C0",
+	"#9997FF",
+	"#C9A8FF",
+	"#1B2DA0",
+	"#3230CC",
+	"#7E5ACC",
+	"#4A5FD6"
 ];
-class CategoryPalette {
-  /**
-   * @param categories - Initial category definitions (id, label, color).
-   * @param fallbackPalette - Optional custom palette for auto-assigned unknowns.
-   *   Defaults to the Astro UXDS–compliant Zendir data-viz palette.
-   */
-  constructor(categories = [], fallbackPalette) {
-    /** Registered categories (insertion order) */
-    __publicField(this, "_defs");
-    /** Auto-assigned colors for ids not in the initial set */
-    __publicField(this, "_autoColors");
-    /** Fallback palette used for auto-assignment */
-    __publicField(this, "_fallback");
-    /** Counter for round-robin auto-assignment */
-    __publicField(this, "_autoIndex");
-    this._defs = /* @__PURE__ */ new Map();
-    this._autoColors = /* @__PURE__ */ new Map();
-    this._fallback = fallbackPalette ?? DEFAULT_FALLBACK_PALETTE;
-    this._autoIndex = 0;
-    for (const cat of categories) {
-      this._defs.set(String(cat.id), cat);
-    }
-  }
-  /** All registered categories (in insertion order). */
-  get all() {
-    return [...this._defs.values()];
-  }
-  /** Number of registered categories. */
-  get size() {
-    return this._defs.size;
-  }
-  /** Returns the full definition for a registered id, or `undefined`. */
-  getCategory(id) {
-    return this._defs.get(String(id));
-  }
-  /** Returns `true` if the id was registered in the constructor. */
-  has(id) {
-    return this._defs.has(String(id));
-  }
-  /**
-   * Resolve a color for any id.
-   * - Registered ids → their explicit `color`.
-   * - Unknown ids → stable auto-assigned color from the fallback palette
-   *   (same id always gets the same color within this palette instance).
-   */
-  getColor(id) {
-    const key = String(id);
-    const def = this._defs.get(key);
-    if (def) return def.color;
-    let auto = this._autoColors.get(key);
-    if (!auto) {
-      auto = this._fallback[this._autoIndex % this._fallback.length];
-      this._autoColors.set(key, auto);
-      this._autoIndex++;
-    }
-    return auto;
-  }
-  /**
-   * Resolve a label for any id.
-   * Registered ids → their `label`; unknown ids → the stringified id.
-   */
-  getLabel(id) {
-    var _a;
-    return ((_a = this._defs.get(String(id))) == null ? void 0 : _a.label) ?? String(id);
-  }
-  /**
-   * Convert a `CategoryDef` array to a palette instance.
-   * Convenience factory — identical to `new CategoryPalette(defs)`.
-   */
-  static from(defs, fallbackPalette) {
-    return new CategoryPalette(defs, fallbackPalette);
-  }
-}
-export {
-  CategoryPalette
+var CategoryPalette = class CategoryPalette {
+	/** Registered categories (insertion order) */
+	_defs;
+	/** Auto-assigned colors for ids not in the initial set */
+	_autoColors;
+	/** Fallback palette used for auto-assignment */
+	_fallback;
+	/** Counter for round-robin auto-assignment */
+	_autoIndex;
+	/**
+	* @param categories - Initial category definitions (id, label, color).
+	* @param fallbackPalette - Optional custom palette for auto-assigned unknowns.
+	*   Defaults to the Astro UXDS–compliant Zendir data-viz palette.
+	*/
+	constructor(categories = [], fallbackPalette) {
+		this._defs = /* @__PURE__ */ new Map();
+		this._autoColors = /* @__PURE__ */ new Map();
+		this._fallback = fallbackPalette ?? DEFAULT_FALLBACK_PALETTE;
+		this._autoIndex = 0;
+		for (const cat of categories) this._defs.set(String(cat.id), cat);
+	}
+	/** All registered categories (in insertion order). */
+	get all() {
+		return [...this._defs.values()];
+	}
+	/** Number of registered categories. */
+	get size() {
+		return this._defs.size;
+	}
+	/** Returns the full definition for a registered id, or `undefined`. */
+	getCategory(id) {
+		return this._defs.get(String(id));
+	}
+	/** Returns `true` if the id was registered in the constructor. */
+	has(id) {
+		return this._defs.has(String(id));
+	}
+	/**
+	* Resolve a color for any id.
+	* - Registered ids → their explicit `color`.
+	* - Unknown ids → stable auto-assigned color from the fallback palette
+	*   (same id always gets the same color within this palette instance).
+	*/
+	getColor(id) {
+		const key = String(id);
+		const def = this._defs.get(key);
+		if (def) return def.color;
+		let auto = this._autoColors.get(key);
+		if (!auto) {
+			auto = this._fallback[this._autoIndex % this._fallback.length];
+			this._autoColors.set(key, auto);
+			this._autoIndex++;
+		}
+		return auto;
+	}
+	/**
+	* Resolve a label for any id.
+	* Registered ids → their `label`; unknown ids → the stringified id.
+	*/
+	getLabel(id) {
+		return this._defs.get(String(id))?.label ?? String(id);
+	}
+	/**
+	* Convert a `CategoryDef` array to a palette instance.
+	* Convenience factory — identical to `new CategoryPalette(defs)`.
+	*/
+	static from(defs, fallbackPalette) {
+		return new CategoryPalette(defs, fallbackPalette);
+	}
 };
-//# sourceMappingURL=categoryPalette.js.map
+//#endregion
+export { CategoryPalette };
+
+//# sourceMappingURL=categoryPalette.js.map

package/dist/react/utils/categoryPalette.js.map

@@ -1 +1 @@
-{"version":3,"file":"categoryPalette.js","sources":["../../../src/react/utils/categoryPalette.ts"],"sourcesContent":["/**\r\n * @zendir/ui — CategoryPalette\r\n *\r\n * A lightweight utility that maps category ids to stable colors and labels.\r\n * Designed for dashboards where multiple components (Timeline, Map, Charts,\r\n * DataTable) should share a consistent visual identity for the same\r\n * grouping dimension — teams, squads, subsystems, mission phases, etc.\r\n *\r\n * @example\r\n * ```ts\r\n * import { CategoryPalette } from '@zendir/ui';\r\n *\r\n * const palette = new CategoryPalette([\r\n *   { id: 'alpha', label: 'Team Alpha', color: '#2dccff' },\r\n *   { id: 'bravo', label: 'Team Bravo', color: '#fce83a' },\r\n * ]);\r\n *\r\n * palette.getColor('alpha');       // '#2dccff'\r\n * palette.getLabel('alpha');       // 'Team Alpha'\r\n * palette.getColor('unknown-id');  // auto-assigned from fallback palette\r\n * ```\r\n */\r\n\r\nimport type { CategoryDef } from '../types';\r\n\r\n/**\r\n * Default fallback palette — Astro-compliant data-viz colors.\r\n * Used when a category has no explicit color or when an unknown id is\r\n * encountered at runtime (auto-assignment by insertion order).\r\n */\r\nconst DEFAULT_FALLBACK_PALETTE: readonly string[] = [\r\n  '#3E3CFF', // Zendir Electric\r\n  '#9D70FF', // Zendir Purple\r\n  '#6B69FF', // Electric 20 % lighter\r\n  '#B48DFF', // Purple 20 % lighter\r\n  '#3548C0', // Prussian Blue lighter\r\n  '#9997FF', // Electric 35 % lighter\r\n  '#C9A8FF', // Purple 35 % lighter\r\n  '#1B2DA0', // Prussian Blue\r\n  '#3230CC', // Electric 20 % darker\r\n  '#7E5ACC', // Purple 20 % darker\r\n  '#4A5FD6', // Prussian Blue lightest\r\n];\r\n\r\nexport class CategoryPalette {\r\n  /** Registered categories (insertion order) */\r\n  private readonly _defs: Map<string, CategoryDef>;\r\n  /** Auto-assigned colors for ids not in the initial set */\r\n  private readonly _autoColors: Map<string, string>;\r\n  /** Fallback palette used for auto-assignment */\r\n  private readonly _fallback: readonly string[];\r\n  /** Counter for round-robin auto-assignment */\r\n  private _autoIndex: number;\r\n\r\n  /**\r\n   * @param categories - Initial category definitions (id, label, color).\r\n   * @param fallbackPalette - Optional custom palette for auto-assigned unknowns.\r\n   *   Defaults to the Astro UXDS–compliant Zendir data-viz palette.\r\n   */\r\n  constructor(\r\n    categories: CategoryDef[] = [],\r\n    fallbackPalette?: string[],\r\n  ) {\r\n    this._defs = new Map();\r\n    this._autoColors = new Map();\r\n    this._fallback = fallbackPalette ?? DEFAULT_FALLBACK_PALETTE;\r\n    this._autoIndex = 0;\r\n\r\n    for (const cat of categories) {\r\n      this._defs.set(String(cat.id), cat);\r\n    }\r\n  }\r\n\r\n  /** All registered categories (in insertion order). */\r\n  get all(): CategoryDef[] {\r\n    return [...this._defs.values()];\r\n  }\r\n\r\n  /** Number of registered categories. */\r\n  get size(): number {\r\n    return this._defs.size;\r\n  }\r\n\r\n  /** Returns the full definition for a registered id, or `undefined`. */\r\n  getCategory(id: string | number): CategoryDef | undefined {\r\n    return this._defs.get(String(id));\r\n  }\r\n\r\n  /** Returns `true` if the id was registered in the constructor. */\r\n  has(id: string | number): boolean {\r\n    return this._defs.has(String(id));\r\n  }\r\n\r\n  /**\r\n   * Resolve a color for any id.\r\n   * - Registered ids → their explicit `color`.\r\n   * - Unknown ids → stable auto-assigned color from the fallback palette\r\n   *   (same id always gets the same color within this palette instance).\r\n   */\r\n  getColor(id: string | number): string {\r\n    const key = String(id);\r\n    const def = this._defs.get(key);\r\n    if (def) return def.color;\r\n\r\n    let auto = this._autoColors.get(key);\r\n    if (!auto) {\r\n      auto = this._fallback[this._autoIndex % this._fallback.length];\r\n      this._autoColors.set(key, auto);\r\n      this._autoIndex++;\r\n    }\r\n    return auto;\r\n  }\r\n\r\n  /**\r\n   * Resolve a label for any id.\r\n   * Registered ids → their `label`; unknown ids → the stringified id.\r\n   */\r\n  getLabel(id: string | number): string {\r\n    return this._defs.get(String(id))?.label ?? String(id);\r\n  }\r\n\r\n  /**\r\n   * Convert a `CategoryDef` array to a palette instance.\r\n   * Convenience factory — identical to `new CategoryPalette(defs)`.\r\n   */\r\n  static from(defs: CategoryDef[], fallbackPalette?: string[]): CategoryPalette {\r\n    return new CategoryPalette(defs, fallbackPalette);\r\n  }\r\n}\r\n"],"names":[],"mappings":";;;AA8BA,MAAM,2BAA8C;AAAA,EAClD;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AACF;AAEO,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAe3B,YACE,aAA4B,CAAA,GAC5B,iBACA;AAhBe;AAAA;AAEA;AAAA;AAEA;AAAA;AAET;AAAA;AAWN,SAAK,4BAAY,IAAA;AACjB,SAAK,kCAAkB,IAAA;AACvB,SAAK,YAAY,mBAAmB;AACpC,SAAK,aAAa;AAElB,eAAW,OAAO,YAAY;AAC5B,WAAK,MAAM,IAAI,OAAO,IAAI,EAAE,GAAG,GAAG;AAAA,IACpC;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,MAAqB;AACvB,WAAO,CAAC,GAAG,KAAK,MAAM,QAAQ;AAAA,EAChC;AAAA;AAAA,EAGA,IAAI,OAAe;AACjB,WAAO,KAAK,MAAM;AAAA,EACpB;AAAA;AAAA,EAGA,YAAY,IAA8C;AACxD,WAAO,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC;AAAA,EAClC;AAAA;AAAA,EAGA,IAAI,IAA8B;AAChC,WAAO,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAS,IAA6B;AACpC,UAAM,MAAM,OAAO,EAAE;AACrB,UAAM,MAAM,KAAK,MAAM,IAAI,GAAG;AAC9B,QAAI,YAAY,IAAI;AAEpB,QAAI,OAAO,KAAK,YAAY,IAAI,GAAG;AACnC,QAAI,CAAC,MAAM;AACT,aAAO,KAAK,UAAU,KAAK,aAAa,KAAK,UAAU,MAAM;AAC7D,WAAK,YAAY,IAAI,KAAK,IAAI;AAC9B,WAAK;AAAA,IACP;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAS,IAA6B;AAvFxC;AAwFI,aAAO,UAAK,MAAM,IAAI,OAAO,EAAE,CAAC,MAAzB,mBAA4B,UAAS,OAAO,EAAE;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,KAAK,MAAqB,iBAA6C;AAC5E,WAAO,IAAI,gBAAgB,MAAM,eAAe;AAAA,EAClD;AACF;"}
+{"version":3,"file":"categoryPalette.js","names":[],"sources":["../../../src/react/utils/categoryPalette.ts"],"sourcesContent":["/**\n * @zendir/ui — CategoryPalette\n *\n * A lightweight utility that maps category ids to stable colors and labels.\n * Designed for dashboards where multiple components (Timeline, Map, Charts,\n * DataTable) should share a consistent visual identity for the same\n * grouping dimension — teams, squads, subsystems, mission phases, etc.\n *\n * @example\n * ```ts\n * import { CategoryPalette } from '@zendir/ui';\n *\n * const palette = new CategoryPalette([\n *   { id: 'alpha', label: 'Team Alpha', color: '#2dccff' },\n *   { id: 'bravo', label: 'Team Bravo', color: '#fce83a' },\n * ]);\n *\n * palette.getColor('alpha');       // '#2dccff'\n * palette.getLabel('alpha');       // 'Team Alpha'\n * palette.getColor('unknown-id');  // auto-assigned from fallback palette\n * ```\n */\n\nimport type { CategoryDef } from \"../types\";\n\n/**\n * Default fallback palette — Astro-compliant data-viz colors.\n * Used when a category has no explicit color or when an unknown id is\n * encountered at runtime (auto-assignment by insertion order).\n */\nconst DEFAULT_FALLBACK_PALETTE: readonly string[] = [\n  \"#3E3CFF\", // Zendir Electric\n  \"#9D70FF\", // Zendir Purple\n  \"#6B69FF\", // Electric 20 % lighter\n  \"#B48DFF\", // Purple 20 % lighter\n  \"#3548C0\", // Prussian Blue lighter\n  \"#9997FF\", // Electric 35 % lighter\n  \"#C9A8FF\", // Purple 35 % lighter\n  \"#1B2DA0\", // Prussian Blue\n  \"#3230CC\", // Electric 20 % darker\n  \"#7E5ACC\", // Purple 20 % darker\n  \"#4A5FD6\", // Prussian Blue lightest\n];\n\nexport class CategoryPalette {\n  /** Registered categories (insertion order) */\n  private readonly _defs: Map<string, CategoryDef>;\n  /** Auto-assigned colors for ids not in the initial set */\n  private readonly _autoColors: Map<string, string>;\n  /** Fallback palette used for auto-assignment */\n  private readonly _fallback: readonly string[];\n  /** Counter for round-robin auto-assignment */\n  private _autoIndex: number;\n\n  /**\n   * @param categories - Initial category definitions (id, label, color).\n   * @param fallbackPalette - Optional custom palette for auto-assigned unknowns.\n   *   Defaults to the Astro UXDS–compliant Zendir data-viz palette.\n   */\n  constructor(categories: CategoryDef[] = [], fallbackPalette?: string[]) {\n    this._defs = new Map();\n    this._autoColors = new Map();\n    this._fallback = fallbackPalette ?? DEFAULT_FALLBACK_PALETTE;\n    this._autoIndex = 0;\n\n    for (const cat of categories) {\n      this._defs.set(String(cat.id), cat);\n    }\n  }\n\n  /** All registered categories (in insertion order). */\n  get all(): CategoryDef[] {\n    return [...this._defs.values()];\n  }\n\n  /** Number of registered categories. */\n  get size(): number {\n    return this._defs.size;\n  }\n\n  /** Returns the full definition for a registered id, or `undefined`. */\n  getCategory(id: string | number): CategoryDef | undefined {\n    return this._defs.get(String(id));\n  }\n\n  /** Returns `true` if the id was registered in the constructor. */\n  has(id: string | number): boolean {\n    return this._defs.has(String(id));\n  }\n\n  /**\n   * Resolve a color for any id.\n   * - Registered ids → their explicit `color`.\n   * - Unknown ids → stable auto-assigned color from the fallback palette\n   *   (same id always gets the same color within this palette instance).\n   */\n  getColor(id: string | number): string {\n    const key = String(id);\n    const def = this._defs.get(key);\n    if (def) return def.color;\n\n    let auto = this._autoColors.get(key);\n    if (!auto) {\n      auto = this._fallback[this._autoIndex % this._fallback.length];\n      this._autoColors.set(key, auto);\n      this._autoIndex++;\n    }\n    return auto;\n  }\n\n  /**\n   * Resolve a label for any id.\n   * Registered ids → their `label`; unknown ids → the stringified id.\n   */\n  getLabel(id: string | number): string {\n    return this._defs.get(String(id))?.label ?? String(id);\n  }\n\n  /**\n   * Convert a `CategoryDef` array to a palette instance.\n   * Convenience factory — identical to `new CategoryPalette(defs)`.\n   */\n  static from(\n    defs: CategoryDef[],\n    fallbackPalette?: string[],\n  ): CategoryPalette {\n    return new CategoryPalette(defs, fallbackPalette);\n  }\n}\n"],"mappings":";;;;;;AA8BA,IAAM,2BAA8C;CAClD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,IAAa,kBAAb,MAAa,gBAAgB;;CAE3B;;CAEA;;CAEA;;CAEA;;;;;;CAOA,YAAY,aAA4B,CAAC,GAAG,iBAA4B;EACtE,KAAK,wBAAQ,IAAI,IAAI;EACrB,KAAK,8BAAc,IAAI,IAAI;EAC3B,KAAK,YAAY,mBAAmB;EACpC,KAAK,aAAa;EAElB,KAAK,MAAM,OAAO,YAChB,KAAK,MAAM,IAAI,OAAO,IAAI,EAAE,GAAG,GAAG;CAEtC;;CAGA,IAAI,MAAqB;EACvB,OAAO,CAAC,GAAG,KAAK,MAAM,OAAO,CAAC;CAChC;;CAGA,IAAI,OAAe;EACjB,OAAO,KAAK,MAAM;CACpB;;CAGA,YAAY,IAA8C;EACxD,OAAO,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC;CAClC;;CAGA,IAAI,IAA8B;EAChC,OAAO,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC;CAClC;;;;;;;CAQA,SAAS,IAA6B;EACpC,MAAM,MAAM,OAAO,EAAE;EACrB,MAAM,MAAM,KAAK,MAAM,IAAI,GAAG;EAC9B,IAAI,KAAK,OAAO,IAAI;EAEpB,IAAI,OAAO,KAAK,YAAY,IAAI,GAAG;EACnC,IAAI,CAAC,MAAM;GACT,OAAO,KAAK,UAAU,KAAK,aAAa,KAAK,UAAU;GACvD,KAAK,YAAY,IAAI,KAAK,IAAI;GAC9B,KAAK;EACP;EACA,OAAO;CACT;;;;;CAMA,SAAS,IAA6B;EACpC,OAAO,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC,EAAE,SAAS,OAAO,EAAE;CACvD;;;;;CAMA,OAAO,KACL,MACA,iBACiB;EACjB,OAAO,IAAI,gBAAgB,MAAM,eAAe;CAClD;AACF"}