@zendir/ui 0.1.0

package/dist/react/core/propertyConfig.js

@@ -0,0 +1,399 @@
+const PROPERTY_PRESETS = {
+  // === Power System ===
+  battery: {
+    label: "Battery",
+    icon: "battery-full",
+    unit: "%",
+    precision: 1,
+    category: "power",
+    // Low values are bad for battery (use *Low thresholds)
+    thresholds: { criticalLow: 10, seriousLow: 20, cautionLow: 30 },
+    description: "Battery state of charge"
+  },
+  voltage: {
+    label: "Voltage",
+    icon: "propulsion-power",
+    unit: "V",
+    precision: 2,
+    category: "power",
+    thresholds: { criticalLow: 24, cautionLow: 26 },
+    description: "Bus voltage"
+  },
+  current: {
+    label: "Current",
+    icon: "propulsion-power",
+    unit: "A",
+    precision: 2,
+    category: "power",
+    description: "Current draw"
+  },
+  power: {
+    label: "Power",
+    icon: "propulsion-power",
+    unit: "W",
+    precision: 1,
+    category: "power",
+    description: "Power consumption or generation"
+  },
+  solarPower: {
+    label: "Solar",
+    icon: "solar",
+    unit: "W",
+    precision: 1,
+    category: "power",
+    description: "Solar array output"
+  },
+  load: {
+    label: "Load",
+    icon: "propulsion-power",
+    unit: "W",
+    precision: 1,
+    category: "power",
+    description: "Power load"
+  },
+  // === Thermal ===
+  temperature: {
+    label: "Temperature",
+    icon: "thermal",
+    unit: "°C",
+    precision: 1,
+    category: "thermal",
+    thresholds: { critical: 80, serious: 70, caution: 60, cautionLow: -20, criticalLow: -40 },
+    description: "Component temperature"
+  },
+  heater: {
+    label: "Heater",
+    icon: "thermal",
+    unit: "",
+    category: "thermal",
+    description: "Heater status"
+  },
+  // === Attitude ===
+  roll: {
+    label: "Roll",
+    icon: "explore",
+    unit: "°",
+    precision: 2,
+    category: "attitude",
+    thresholds: { critical: 45, caution: 30 },
+    description: "Roll angle"
+  },
+  pitch: {
+    label: "Pitch",
+    icon: "explore",
+    unit: "°",
+    precision: 2,
+    category: "attitude",
+    thresholds: { critical: 45, caution: 30 },
+    description: "Pitch angle"
+  },
+  yaw: {
+    label: "Yaw",
+    icon: "explore",
+    unit: "°",
+    precision: 2,
+    category: "attitude",
+    thresholds: { critical: 45, caution: 30 },
+    description: "Yaw angle"
+  },
+  pointingError: {
+    label: "Pointing error",
+    icon: "explore",
+    unit: "°",
+    precision: 3,
+    category: "attitude",
+    thresholds: { critical: 1, serious: 0.5, caution: 0.1 },
+    description: "Attitude pointing error"
+  },
+  angularVelocity: {
+    label: "Angular velocity",
+    icon: "explore",
+    unit: "°/s",
+    precision: 3,
+    category: "attitude",
+    thresholds: { critical: 5, caution: 2 },
+    description: "Rotation rate"
+  },
+  // === Communications ===
+  signalStrength: {
+    label: "Signal",
+    icon: "antenna-receive",
+    unit: "dBm",
+    precision: 1,
+    category: "communications",
+    thresholds: { criticalLow: -100, cautionLow: -85 },
+    description: "Received signal strength"
+  },
+  dataRate: {
+    label: "Data rate",
+    icon: "antenna-transmit",
+    unit: "Mbps",
+    precision: 2,
+    category: "communications",
+    description: "Communication data rate"
+  },
+  packetLoss: {
+    label: "Packet loss",
+    icon: "netcom",
+    unit: "%",
+    precision: 2,
+    category: "communications",
+    thresholds: { critical: 10, serious: 5, caution: 1 },
+    description: "Communication packet loss rate"
+  },
+  snr: {
+    label: "SNR",
+    icon: "antenna",
+    unit: "dB",
+    precision: 1,
+    category: "communications",
+    thresholds: { criticalLow: 5, cautionLow: 10 },
+    description: "Signal-to-noise ratio"
+  },
+  queue: {
+    label: "Queue",
+    icon: "netcom",
+    unit: "pkts",
+    precision: 0,
+    category: "communications",
+    thresholds: { critical: 1e3, caution: 500 },
+    description: "Packet queue depth"
+  },
+  // === Propulsion ===
+  fuelLevel: {
+    label: "Fuel",
+    icon: "propulsion-power",
+    unit: "%",
+    precision: 1,
+    category: "propulsion",
+    thresholds: { critical: 5, serious: 10, caution: 20 },
+    description: "Propellant remaining"
+  },
+  deltaV: {
+    label: "Delta-V",
+    icon: "propulsion-power",
+    unit: "m/s",
+    precision: 1,
+    category: "propulsion",
+    description: "Available delta-V budget"
+  },
+  thrustLevel: {
+    label: "Thrust",
+    icon: "propulsion-power",
+    unit: "N",
+    precision: 2,
+    category: "propulsion",
+    description: "Current thrust output"
+  },
+  // === Navigation ===
+  altitude: {
+    label: "Altitude",
+    icon: "altitude",
+    unit: "km",
+    precision: 1,
+    category: "orbital",
+    thresholds: { criticalLow: 200, cautionLow: 250 },
+    description: "Orbital altitude"
+  },
+  velocity: {
+    label: "Velocity",
+    icon: "altitude",
+    unit: "km/s",
+    precision: 3,
+    category: "orbital",
+    description: "Orbital velocity"
+  },
+  inclination: {
+    label: "Inclination",
+    icon: "altitude",
+    unit: "°",
+    precision: 2,
+    category: "orbital",
+    description: "Orbital inclination"
+  },
+  eccentricity: {
+    label: "Eccentricity",
+    icon: "altitude",
+    unit: "",
+    precision: 6,
+    category: "orbital",
+    description: "Orbital eccentricity"
+  },
+  // === Payload ===
+  payloadStatus: {
+    label: "Payload",
+    icon: "payload",
+    unit: "",
+    category: "payload",
+    description: "Payload operational status"
+  },
+  storageUsed: {
+    label: "Storage",
+    icon: "hardware",
+    unit: "%",
+    precision: 1,
+    category: "payload",
+    thresholds: { critical: 95, serious: 90, caution: 80 },
+    description: "Onboard storage usage"
+  },
+  // === Health ===
+  cpuUsage: {
+    label: "CPU",
+    icon: "processor",
+    unit: "%",
+    precision: 1,
+    category: "health",
+    thresholds: { critical: 95, serious: 85, caution: 75 },
+    description: "Processor utilization"
+  },
+  memoryUsage: {
+    label: "Memory",
+    icon: "processor",
+    unit: "%",
+    precision: 1,
+    category: "health",
+    thresholds: { critical: 95, serious: 85, caution: 75 },
+    description: "Memory utilization"
+  },
+  uptime: {
+    label: "Uptime",
+    icon: "mission",
+    unit: "s",
+    precision: 0,
+    category: "health",
+    description: "System uptime"
+  },
+  // === General ===
+  count: {
+    label: "Count",
+    icon: "list",
+    unit: "",
+    precision: 0,
+    category: "general",
+    description: "Item count"
+  },
+  percentage: {
+    label: "Percentage",
+    icon: "info",
+    unit: "%",
+    precision: 1,
+    category: "general",
+    description: "Percentage value"
+  },
+  duration: {
+    label: "Duration",
+    icon: "schedule",
+    unit: "s",
+    precision: 0,
+    category: "general",
+    description: "Time duration"
+  }
+};
+const CATEGORY_ICONS = {
+  power: "propulsion-power",
+  thermal: "thermal",
+  attitude: "explore",
+  communications: "antenna",
+  propulsion: "propulsion-power",
+  navigation: "gps-fixed",
+  payload: "payload",
+  health: "favorite",
+  orbital: "altitude",
+  general: "info"
+};
+const CATEGORY_LABELS = {
+  power: "Power",
+  thermal: "Thermal",
+  attitude: "Attitude",
+  communications: "Communications",
+  propulsion: "Propulsion",
+  navigation: "Navigation",
+  payload: "Payload",
+  health: "Health",
+  orbital: "Orbital",
+  general: "General"
+};
+function getPropertyConfig(key) {
+  const preset = PROPERTY_PRESETS[key];
+  if (preset) {
+    return preset;
+  }
+  return {
+    label: formatPropertyLabel(key),
+    icon: "info",
+    unit: "",
+    precision: 2,
+    category: "general",
+    description: key
+  };
+}
+function formatPropertyLabel(key) {
+  const words = key.replace(/([A-Z])/g, " $1").replace(/[_-]/g, " ").trim().toLowerCase();
+  return words.charAt(0).toUpperCase() + words.slice(1);
+}
+function deriveStatus(value, thresholds) {
+  if (value === void 0 || value === null || !Number.isFinite(value)) {
+    return "off";
+  }
+  if (!thresholds) {
+    return "normal";
+  }
+  if (thresholds.critical !== void 0 && value >= thresholds.critical) {
+    return "critical";
+  }
+  if (thresholds.serious !== void 0 && value >= thresholds.serious) {
+    return "serious";
+  }
+  if (thresholds.caution !== void 0 && value >= thresholds.caution) {
+    return "caution";
+  }
+  if (thresholds.criticalLow !== void 0 && value <= thresholds.criticalLow) {
+    return "critical";
+  }
+  if (thresholds.seriousLow !== void 0 && value <= thresholds.seriousLow) {
+    return "serious";
+  }
+  if (thresholds.cautionLow !== void 0 && value <= thresholds.cautionLow) {
+    return "caution";
+  }
+  return "normal";
+}
+function deriveBatteryStatus(level) {
+  if (level === void 0 || level === null) return "off";
+  if (level <= 10) return "critical";
+  if (level <= 20) return "serious";
+  if (level <= 30) return "caution";
+  return "normal";
+}
+function formatPropertyValue(value, config) {
+  if (value === void 0 || value === null || !Number.isFinite(value)) {
+    return "--";
+  }
+  if (config.format) {
+    return config.format(value);
+  }
+  const precision = config.precision ?? 2;
+  const formatted = value.toFixed(precision);
+  const unit = config.unit ?? "";
+  return unit ? `${formatted}${unit.startsWith("°") || unit.startsWith("%") ? "" : " "}${unit}` : formatted;
+}
+function createPropertyConfig(baseKey, overrides) {
+  const base = getPropertyConfig(baseKey);
+  return { ...base, ...overrides };
+}
+function getPropertiesByCategory(category) {
+  return Object.entries(PROPERTY_PRESETS).filter(([_, config]) => config.category === category).map(([key, config]) => ({ key, config }));
+}
+export {
+  CATEGORY_ICONS,
+  CATEGORY_LABELS,
+  PROPERTY_PRESETS,
+  createPropertyConfig,
+  deriveBatteryStatus,
+  deriveStatus,
+  formatPropertyLabel,
+  formatPropertyValue,
+  getPropertiesByCategory,
+  getPropertyConfig
+};
+//# sourceMappingURL=propertyConfig.js.map

package/dist/react/core/propertyConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propertyConfig.js","sources":["../../../src/react/core/propertyConfig.ts"],"sourcesContent":["/**\n * @zendir/ui - Property Configuration System\n * \n * Enterprise-grade property-to-icon/status/unit mapping system.\n * Provides automatic icon, status, and formatting for common telemetry properties.\n * \n * AstroUXDS Compliance:\n * - Uses official Astro icon names\n * - Status colors per AstroUXDS status system\n * - Dual-coding (color + shape) for accessibility\n * \n * Features:\n * - Auto-derive status from value + thresholds\n * - Contextual icons for space operations properties\n * - Unit formatting with SI prefixes\n * - Extensible configuration\n * \n * @example\n * ```tsx\n * import { getPropertyConfig, deriveStatus, PROPERTY_PRESETS } from '@zendir/ui';\n * \n * // Get config for a known property\n * const tempConfig = getPropertyConfig('temperature');\n * // { icon: 'thermal', unit: '°C', thresholds: { caution: 60, critical: 80 }, ... }\n * \n * // Derive status from value\n * const status = deriveStatus(75, tempConfig.thresholds);\n * // 'caution'\n * ```\n */\n\nimport type { StatusLevel } from '../utils';\nimport type { AstroIconName } from './AstroIcon';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Threshold configuration for automatic status derivation\n * Values are compared: value >= threshold triggers that status (high thresholds)\n * or value <= threshold triggers that status (low thresholds)\n */\nexport interface StatusThresholds {\n  /** Value at or above which status becomes 'critical' (high is bad) */\n  critical?: number;\n  /** Value at or above which status becomes 'serious' (high is bad) */\n  serious?: number;\n  /** Value at or above which status becomes 'caution' (high is bad) */\n  caution?: number;\n  /** Value at or below which status becomes 'caution' (low is bad) */\n  cautionLow?: number;\n  /** Value at or below which status becomes 'serious' (low is bad) */\n  seriousLow?: number;\n  /** Value at or below which status becomes 'critical' (low is bad) */\n  criticalLow?: number;\n}\n\n/**\n * Complete property configuration\n */\nexport interface PropertyConfig {\n  /** Display name (sentence case per AstroUXDS) */\n  label: string;\n  /** Astro icon name */\n  icon: AstroIconName;\n  /** Unit of measurement */\n  unit?: string;\n  /** Precision for number formatting */\n  precision?: number;\n  /** Status thresholds for auto-derivation */\n  thresholds?: StatusThresholds;\n  /** Category for grouping */\n  category?: PropertyCategory;\n  /** Description for tooltips */\n  description?: string;\n  /** Format function override */\n  format?: (value: number) => string;\n}\n\n/**\n * Property categories for organization\n */\nexport type PropertyCategory = \n  | 'power'\n  | 'thermal'\n  | 'attitude'\n  | 'communications'\n  | 'propulsion'\n  | 'navigation'\n  | 'payload'\n  | 'health'\n  | 'orbital'\n  | 'general';\n\n/**\n * Property key - either a preset name or custom string\n */\nexport type PropertyKey = keyof typeof PROPERTY_PRESETS | (string & {});\n\n// =============================================================================\n// Property Presets\n// =============================================================================\n\n/**\n * Predefined property configurations for common space operations telemetry\n * \n * These provide sensible defaults that can be overridden per-use.\n */\nexport const PROPERTY_PRESETS = {\n  // === Power System ===\n  battery: {\n    label: 'Battery',\n    icon: 'battery-full' as AstroIconName,\n    unit: '%',\n    precision: 1,\n    category: 'power' as PropertyCategory,\n    // Low values are bad for battery (use *Low thresholds)\n    thresholds: { criticalLow: 10, seriousLow: 20, cautionLow: 30 },\n    description: 'Battery state of charge',\n  },\n  voltage: {\n    label: 'Voltage',\n    icon: 'propulsion-power' as AstroIconName,\n    unit: 'V',\n    precision: 2,\n    category: 'power' as PropertyCategory,\n    thresholds: { criticalLow: 24, cautionLow: 26 },\n    description: 'Bus voltage',\n  },\n  current: {\n    label: 'Current',\n    icon: 'propulsion-power' as AstroIconName,\n    unit: 'A',\n    precision: 2,\n    category: 'power' as PropertyCategory,\n    description: 'Current draw',\n  },\n  power: {\n    label: 'Power',\n    icon: 'propulsion-power' as AstroIconName,\n    unit: 'W',\n    precision: 1,\n    category: 'power' as PropertyCategory,\n    description: 'Power consumption or generation',\n  },\n  solarPower: {\n    label: 'Solar',\n    icon: 'solar' as AstroIconName,\n    unit: 'W',\n    precision: 1,\n    category: 'power' as PropertyCategory,\n    description: 'Solar array output',\n  },\n  load: {\n    label: 'Load',\n    icon: 'propulsion-power' as AstroIconName,\n    unit: 'W',\n    precision: 1,\n    category: 'power' as PropertyCategory,\n    description: 'Power load',\n  },\n\n  // === Thermal ===\n  temperature: {\n    label: 'Temperature',\n    icon: 'thermal' as AstroIconName,\n    unit: '°C',\n    precision: 1,\n    category: 'thermal' as PropertyCategory,\n    thresholds: { critical: 80, serious: 70, caution: 60, cautionLow: -20, criticalLow: -40 },\n    description: 'Component temperature',\n  },\n  heater: {\n    label: 'Heater',\n    icon: 'thermal' as AstroIconName,\n    unit: '',\n    category: 'thermal' as PropertyCategory,\n    description: 'Heater status',\n  },\n\n  // === Attitude ===\n  roll: {\n    label: 'Roll',\n    icon: 'explore' as AstroIconName,\n    unit: '°',\n    precision: 2,\n    category: 'attitude' as PropertyCategory,\n    thresholds: { critical: 45, caution: 30 },\n    description: 'Roll angle',\n  },\n  pitch: {\n    label: 'Pitch',\n    icon: 'explore' as AstroIconName,\n    unit: '°',\n    precision: 2,\n    category: 'attitude' as PropertyCategory,\n    thresholds: { critical: 45, caution: 30 },\n    description: 'Pitch angle',\n  },\n  yaw: {\n    label: 'Yaw',\n    icon: 'explore' as AstroIconName,\n    unit: '°',\n    precision: 2,\n    category: 'attitude' as PropertyCategory,\n    thresholds: { critical: 45, caution: 30 },\n    description: 'Yaw angle',\n  },\n  pointingError: {\n    label: 'Pointing error',\n    icon: 'explore' as AstroIconName,\n    unit: '°',\n    precision: 3,\n    category: 'attitude' as PropertyCategory,\n    thresholds: { critical: 1.0, serious: 0.5, caution: 0.1 },\n    description: 'Attitude pointing error',\n  },\n  angularVelocity: {\n    label: 'Angular velocity',\n    icon: 'explore' as AstroIconName,\n    unit: '°/s',\n    precision: 3,\n    category: 'attitude' as PropertyCategory,\n    thresholds: { critical: 5.0, caution: 2.0 },\n    description: 'Rotation rate',\n  },\n\n  // === Communications ===\n  signalStrength: {\n    label: 'Signal',\n    icon: 'antenna-receive' as AstroIconName,\n    unit: 'dBm',\n    precision: 1,\n    category: 'communications' as PropertyCategory,\n    thresholds: { criticalLow: -100, cautionLow: -85 },\n    description: 'Received signal strength',\n  },\n  dataRate: {\n    label: 'Data rate',\n    icon: 'antenna-transmit' as AstroIconName,\n    unit: 'Mbps',\n    precision: 2,\n    category: 'communications' as PropertyCategory,\n    description: 'Communication data rate',\n  },\n  packetLoss: {\n    label: 'Packet loss',\n    icon: 'netcom' as AstroIconName,\n    unit: '%',\n    precision: 2,\n    category: 'communications' as PropertyCategory,\n    thresholds: { critical: 10, serious: 5, caution: 1 },\n    description: 'Communication packet loss rate',\n  },\n  snr: {\n    label: 'SNR',\n    icon: 'antenna' as AstroIconName,\n    unit: 'dB',\n    precision: 1,\n    category: 'communications' as PropertyCategory,\n    thresholds: { criticalLow: 5, cautionLow: 10 },\n    description: 'Signal-to-noise ratio',\n  },\n  queue: {\n    label: 'Queue',\n    icon: 'netcom' as AstroIconName,\n    unit: 'pkts',\n    precision: 0,\n    category: 'communications' as PropertyCategory,\n    thresholds: { critical: 1000, caution: 500 },\n    description: 'Packet queue depth',\n  },\n\n  // === Propulsion ===\n  fuelLevel: {\n    label: 'Fuel',\n    icon: 'propulsion-power' as AstroIconName,\n    unit: '%',\n    precision: 1,\n    category: 'propulsion' as PropertyCategory,\n    thresholds: { critical: 5, serious: 10, caution: 20 },\n    description: 'Propellant remaining',\n  },\n  deltaV: {\n    label: 'Delta-V',\n    icon: 'propulsion-power' as AstroIconName,\n    unit: 'm/s',\n    precision: 1,\n    category: 'propulsion' as PropertyCategory,\n    description: 'Available delta-V budget',\n  },\n  thrustLevel: {\n    label: 'Thrust',\n    icon: 'propulsion-power' as AstroIconName,\n    unit: 'N',\n    precision: 2,\n    category: 'propulsion' as PropertyCategory,\n    description: 'Current thrust output',\n  },\n\n  // === Navigation ===\n  altitude: {\n    label: 'Altitude',\n    icon: 'altitude' as AstroIconName,\n    unit: 'km',\n    precision: 1,\n    category: 'orbital' as PropertyCategory,\n    thresholds: { criticalLow: 200, cautionLow: 250 },\n    description: 'Orbital altitude',\n  },\n  velocity: {\n    label: 'Velocity',\n    icon: 'altitude' as AstroIconName,\n    unit: 'km/s',\n    precision: 3,\n    category: 'orbital' as PropertyCategory,\n    description: 'Orbital velocity',\n  },\n  inclination: {\n    label: 'Inclination',\n    icon: 'altitude' as AstroIconName,\n    unit: '°',\n    precision: 2,\n    category: 'orbital' as PropertyCategory,\n    description: 'Orbital inclination',\n  },\n  eccentricity: {\n    label: 'Eccentricity',\n    icon: 'altitude' as AstroIconName,\n    unit: '',\n    precision: 6,\n    category: 'orbital' as PropertyCategory,\n    description: 'Orbital eccentricity',\n  },\n\n  // === Payload ===\n  payloadStatus: {\n    label: 'Payload',\n    icon: 'payload' as AstroIconName,\n    unit: '',\n    category: 'payload' as PropertyCategory,\n    description: 'Payload operational status',\n  },\n  storageUsed: {\n    label: 'Storage',\n    icon: 'hardware' as AstroIconName,\n    unit: '%',\n    precision: 1,\n    category: 'payload' as PropertyCategory,\n    thresholds: { critical: 95, serious: 90, caution: 80 },\n    description: 'Onboard storage usage',\n  },\n\n  // === Health ===\n  cpuUsage: {\n    label: 'CPU',\n    icon: 'processor' as AstroIconName,\n    unit: '%',\n    precision: 1,\n    category: 'health' as PropertyCategory,\n    thresholds: { critical: 95, serious: 85, caution: 75 },\n    description: 'Processor utilization',\n  },\n  memoryUsage: {\n    label: 'Memory',\n    icon: 'processor' as AstroIconName,\n    unit: '%',\n    precision: 1,\n    category: 'health' as PropertyCategory,\n    thresholds: { critical: 95, serious: 85, caution: 75 },\n    description: 'Memory utilization',\n  },\n  uptime: {\n    label: 'Uptime',\n    icon: 'mission' as AstroIconName,\n    unit: 's',\n    precision: 0,\n    category: 'health' as PropertyCategory,\n    description: 'System uptime',\n  },\n\n  // === General ===\n  count: {\n    label: 'Count',\n    icon: 'list' as AstroIconName,\n    unit: '',\n    precision: 0,\n    category: 'general' as PropertyCategory,\n    description: 'Item count',\n  },\n  percentage: {\n    label: 'Percentage',\n    icon: 'info' as AstroIconName,\n    unit: '%',\n    precision: 1,\n    category: 'general' as PropertyCategory,\n    description: 'Percentage value',\n  },\n  duration: {\n    label: 'Duration',\n    icon: 'schedule' as AstroIconName,\n    unit: 's',\n    precision: 0,\n    category: 'general' as PropertyCategory,\n    description: 'Time duration',\n  },\n} as const satisfies Record<string, PropertyConfig>;\n\n// =============================================================================\n// Category Icons (for section headers)\n// =============================================================================\n\nexport const CATEGORY_ICONS: Record<PropertyCategory, AstroIconName> = {\n  power: 'propulsion-power',\n  thermal: 'thermal',\n  attitude: 'explore',\n  communications: 'antenna',\n  propulsion: 'propulsion-power',\n  navigation: 'gps-fixed',\n  payload: 'payload',\n  health: 'favorite',\n  orbital: 'altitude',\n  general: 'info',\n};\n\nexport const CATEGORY_LABELS: Record<PropertyCategory, string> = {\n  power: 'Power',\n  thermal: 'Thermal',\n  attitude: 'Attitude',\n  communications: 'Communications',\n  propulsion: 'Propulsion',\n  navigation: 'Navigation',\n  payload: 'Payload',\n  health: 'Health',\n  orbital: 'Orbital',\n  general: 'General',\n};\n\n// =============================================================================\n// Utility Functions\n// =============================================================================\n\n/**\n * Get property configuration by key\n * Returns preset config or a default config for unknown properties\n */\nexport function getPropertyConfig(key: PropertyKey): PropertyConfig {\n  const preset = PROPERTY_PRESETS[key as keyof typeof PROPERTY_PRESETS];\n  if (preset) {\n    return preset;\n  }\n\n  // Return default config for unknown properties\n  return {\n    label: formatPropertyLabel(key),\n    icon: 'info',\n    unit: '',\n    precision: 2,\n    category: 'general',\n    description: key,\n  };\n}\n\n/**\n * Format a property key into a display label (sentence case)\n */\nexport function formatPropertyLabel(key: string): string {\n  // Handle camelCase → Sentence case\n  const words = key\n    .replace(/([A-Z])/g, ' $1')\n    .replace(/[_-]/g, ' ')\n    .trim()\n    .toLowerCase();\n  return words.charAt(0).toUpperCase() + words.slice(1);\n}\n\n/**\n * Derive status level from a value and thresholds\n * \n * @param value - Current value\n * @param thresholds - Status thresholds\n * @returns StatusLevel\n * \n * @example\n * ```tsx\n * deriveStatus(75, { caution: 60, critical: 80 }) // 'caution'\n * deriveStatus(25, { criticalLow: 10, cautionLow: 30 }) // 'caution'\n * deriveStatus(50, { caution: 60, critical: 80 }) // 'normal'\n * ```\n */\nexport function deriveStatus(\n  value: number | undefined | null,\n  thresholds?: StatusThresholds\n): StatusLevel {\n  if (value === undefined || value === null || !Number.isFinite(value)) {\n    return 'off';\n  }\n\n  if (!thresholds) {\n    return 'normal';\n  }\n\n  // Check high thresholds (value >= threshold is bad)\n  if (thresholds.critical !== undefined && value >= thresholds.critical) {\n    return 'critical';\n  }\n  if (thresholds.serious !== undefined && value >= thresholds.serious) {\n    return 'serious';\n  }\n  if (thresholds.caution !== undefined && value >= thresholds.caution) {\n    return 'caution';\n  }\n\n  // Check low thresholds (value <= threshold is bad)\n  if (thresholds.criticalLow !== undefined && value <= thresholds.criticalLow) {\n    return 'critical';\n  }\n  if (thresholds.seriousLow !== undefined && value <= thresholds.seriousLow) {\n    return 'serious';\n  }\n  if (thresholds.cautionLow !== undefined && value <= thresholds.cautionLow) {\n    return 'caution';\n  }\n\n  return 'normal';\n}\n\n/**\n * Derive status for battery specifically (low is bad)\n */\nexport function deriveBatteryStatus(level: number | undefined): StatusLevel {\n  if (level === undefined || level === null) return 'off';\n  if (level <= 10) return 'critical';\n  if (level <= 20) return 'serious';\n  if (level <= 30) return 'caution';\n  return 'normal';\n}\n\n/**\n * Format a value with its property config\n */\nexport function formatPropertyValue(\n  value: number | undefined | null,\n  config: PropertyConfig\n): string {\n  if (value === undefined || value === null || !Number.isFinite(value)) {\n    return '--';\n  }\n\n  if (config.format) {\n    return config.format(value);\n  }\n\n  const precision = config.precision ?? 2;\n  const formatted = value.toFixed(precision);\n  const unit = config.unit ?? '';\n  \n  return unit ? `${formatted}${unit.startsWith('°') || unit.startsWith('%') ? '' : ' '}${unit}` : formatted;\n}\n\n/**\n * Create a custom property config by merging with a preset\n */\nexport function createPropertyConfig(\n  baseKey: PropertyKey,\n  overrides: Partial<PropertyConfig>\n): PropertyConfig {\n  const base = getPropertyConfig(baseKey);\n  return { ...base, ...overrides };\n}\n\n/**\n * Get all properties in a category\n */\nexport function getPropertiesByCategory(category: PropertyCategory): Array<{ key: string; config: PropertyConfig }> {\n  return Object.entries(PROPERTY_PRESETS)\n    .filter(([_, config]) => config.category === category)\n    .map(([key, config]) => ({ key, config }));\n}\n"],"names":[],"mappings":"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"}

package/dist/react/hooks/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @zendir/ui - React Hooks
+ *
+ * Hooks for integrating with Zendir SDK and space operations.
+ */
+export { useZendirSession } from './useZendirSession';
+export type { UseZendirSessionOptions, UseZendirSessionResult } from './useZendirSession';
+export { useTelemetry } from './useTelemetry';
+export type { UseTelemetryOptions, UseTelemetryResult } from './useTelemetry';
+export { useSpacecraftPosition } from './useSpacecraftPosition';
+export type { UseSpacecraftPositionOptions, UseSpacecraftPositionResult } from './useSpacecraftPosition';
+export { useCompactMode } from './useCompactMode';
+export type { UseCompactModeOptions, UseCompactModeResult } from './useCompactMode';
+export { useSimulationTime } from './useSimulationTime';
+export type { SimulationTimeState, UseSimulationTimeOptions } from './useSimulationTime';
+export { useSimulationPlayback } from './useSimulationPlayback';
+export type { SimulationPlaybackState, UseSimulationPlaybackOptions, UseSimulationPlaybackResult, } from './useSimulationPlayback';
+export { useAccessWindows, createDemoAccessWindows } from './useAccessWindows';
+export type { AccessWindow, AccessWindowsState, UseAccessWindowsOptions } from './useAccessWindows';
+export { useLiveSelection } from './useLiveSelection';
+export type { UseLiveSelectionOptions, UseLiveSelectionResult } from './useLiveSelection';

package/dist/react/hooks/useAccessWindows.d.ts

@@ -0,0 +1,66 @@
+import { TimerConfig } from '../astro/MissionClock';
+
+export interface AccessWindow {
+    /** Start time (AOS) */
+    startTime: Date;
+    /** End time (LOS) */
+    endTime: Date;
+    /** Duration in seconds */
+    duration: number;
+    /** Maximum elevation during pass (degrees) */
+    maxElevation: number;
+    /** Time of maximum elevation (TCA) */
+    tcaTime?: Date;
+    /** Ground station ID */
+    groundStationId: string;
+    /** Ground station name */
+    groundStationName: string;
+}
+export interface AccessWindowsState {
+    /** Currently active pass (if any) */
+    currentPass: AccessWindow | null;
+    /** Next upcoming pass */
+    nextPass: AccessWindow | null;
+    /** All upcoming passes */
+    upcomingPasses: AccessWindow[];
+    /** Whether currently in a pass */
+    isInPass: boolean;
+    /** Current elevation (degrees, if in pass) */
+    currentElevation: number | null;
+    /** Current azimuth (degrees, if in pass) */
+    currentAzimuth: number | null;
+    /** Time until next AOS (seconds) */
+    timeToAOS: number | null;
+    /** Time until LOS (seconds, if in pass) */
+    timeToLOS: number | null;
+    /** Timer config for AOS (for MissionClock) */
+    aosTimer: TimerConfig | null;
+    /** Timer config for LOS (for MissionClock) */
+    losTimer: TimerConfig | null;
+    /** Timer config for TCA (for MissionClock) */
+    tcaTimer: TimerConfig | null;
+    /** Whether connected to SDK */
+    isConnected: boolean;
+    /** Whether SDK is available */
+    isSdkAvailable: boolean;
+    /** Error message if any */
+    error: string | null;
+}
+export interface UseAccessWindowsOptions {
+    /** Spacecraft ID to track */
+    spacecraftId?: string;
+    /** Ground station ID (or 'all' for all stations) */
+    groundStationId?: string;
+    /** Update interval in milliseconds (default: 1000) */
+    updateInterval?: number;
+    /** Number of passes to fetch (default: 5) */
+    passCount?: number;
+    /** Manual access windows (for demo/testing) */
+    manualWindows?: AccessWindow[];
+}
+export declare function useAccessWindows(options?: UseAccessWindowsOptions): AccessWindowsState;
+/**
+ * Generate demo access windows for testing
+ */
+export declare function createDemoAccessWindows(count?: number): AccessWindow[];
+export default useAccessWindows;

package/dist/react/hooks/useCompactMode.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @zendir/ui - useCompactMode Hook
+ *
+ * Provides compact mode functionality for data cards with:
+ * - Hover-to-expand behavior
+ * - Click-to-pin (stays expanded until clicked again)
+ * - Keyboard accessibility (Enter/Space to toggle pin)
+ * - Reduced motion support
+ * - Integration with DisplaySettingsContext for global compact mode
+ *
+ * Priority for compact mode:
+ * 1. Explicit `compact` prop (if provided)
+ * 2. Global compact mode from DisplaySettingsContext
+ * 3. Default: false
+ *
+ * Usage:
+ * ```tsx
+ * const { expanded, isPinned, handlers, transitionDuration } = useCompactMode({
+ *   compact: true, // Optional - if omitted, uses global setting
+ *   defaultExpanded: false,
+ *   onPinChange: (pinned) => {},
+ * });
+ *
+ * return (
+ *   <div {...handlers}>
+ *     {expanded ? <FullContent /> : <CompactContent />}
+ *   </div>
+ * );
+ * ```
+ */
+/**
+ * Options for useCompactMode hook
+ */
+export interface UseCompactModeOptions {
+    /** Whether compact mode is enabled */
+    compact?: boolean;
+    /** Start in expanded (pinned) state */
+    defaultExpanded?: boolean;
+    /** Callback when pin state changes */
+    onPinChange?: (isPinned: boolean) => void;
+}
+/**
+ * Result from useCompactMode hook
+ */
+export interface UseCompactModeResult {
+    /** Whether the component should render in expanded state */
+    expanded: boolean;
+    /** Whether the component is pinned (clicked to stay expanded) */
+    isPinned: boolean;
+    /** Whether the component is being hovered */
+    isHovered: boolean;
+    /** Whether compact mode is active */
+    isCompact: boolean;
+    /** Event handlers to spread on the container element */
+    handlers: {
+        onMouseEnter: () => void;
+        onMouseLeave: () => void;
+        onClick: () => void;
+        onKeyDown: (e: React.KeyboardEvent) => void;
+        tabIndex: number;
+        role: string;
+        'aria-expanded': boolean;
+    };
+    /** Transition duration respecting reduced motion */
+    transitionDuration: string;
+    /** Toggle the pinned state programmatically */
+    togglePin: () => void;
+    /** Set pinned state programmatically */
+    setPin: (pinned: boolean) => void;
+}
+/**
+ * Hook for managing compact mode state and interactions
+ *
+ * Provides hover-to-expand and click-to-pin functionality with
+ * full keyboard accessibility and reduced motion support.
+ *
+ * Priority for compact mode:
+ * 1. Explicit `compact` prop (if provided)
+ * 2. Global compact mode from DisplaySettingsContext
+ * 3. Default: false
+ */
+export declare function useCompactMode(options?: UseCompactModeOptions): UseCompactModeResult;

package/dist/react/hooks/useCompactMode.js

@@ -0,0 +1,62 @@
+import { useState, useCallback, useMemo } from "react";
+import { useDisplaySettingsOptional } from "../context/DisplaySettingsContext.js";
+import { useTheme } from "../theme/ThemeProvider.js";
+function useCompactMode(options = {}) {
+  const { compact: compactProp, defaultExpanded = false, onPinChange } = options;
+  const { prefersReducedMotion } = useTheme();
+  const displaySettings = useDisplaySettingsOptional();
+  const compact = compactProp ?? (displaySettings == null ? void 0 : displaySettings.compactMode) ?? false;
+  const [isHovered, setIsHovered] = useState(false);
+  const [isPinned, setIsPinned] = useState(defaultExpanded);
+  const transitionDuration = prefersReducedMotion ? "0ms" : "200ms";
+  const expanded = !compact || isPinned || isHovered;
+  const togglePin = useCallback(() => {
+    const newPinned = !isPinned;
+    setIsPinned(newPinned);
+    onPinChange == null ? void 0 : onPinChange(newPinned);
+  }, [isPinned, onPinChange]);
+  const setPin = useCallback((pinned) => {
+    setIsPinned(pinned);
+    onPinChange == null ? void 0 : onPinChange(pinned);
+  }, [onPinChange]);
+  const onMouseEnter = useCallback(() => {
+    setIsHovered(true);
+  }, []);
+  const onMouseLeave = useCallback(() => {
+    setIsHovered(false);
+  }, []);
+  const onClick = useCallback(() => {
+    if (compact) {
+      togglePin();
+    }
+  }, [compact, togglePin]);
+  const onKeyDown = useCallback((e) => {
+    if (compact && (e.key === "Enter" || e.key === " ")) {
+      e.preventDefault();
+      togglePin();
+    }
+  }, [compact, togglePin]);
+  const handlers = useMemo(() => ({
+    onMouseEnter,
+    onMouseLeave,
+    onClick,
+    onKeyDown,
+    tabIndex: compact ? 0 : -1,
+    role: compact ? "button" : "article",
+    "aria-expanded": expanded
+  }), [onMouseEnter, onMouseLeave, onClick, onKeyDown, compact, expanded]);
+  return {
+    expanded,
+    isPinned,
+    isHovered,
+    isCompact: compact,
+    handlers,
+    transitionDuration,
+    togglePin,
+    setPin
+  };
+}
+export {
+  useCompactMode
+};
+//# sourceMappingURL=useCompactMode.js.map