@zendir/ui 0.4.1 → 0.6.0

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

@@ -1,399 +1,463 @@
-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"
-  }
+//#region src/react/core/data/propertyConfig.ts
+/**
+* Predefined property configurations for common space operations telemetry
+*
+* These provide sensible defaults that can be overridden per-use.
+*/
+var PROPERTY_PRESETS = {
+	battery: {
+		label: "Battery",
+		icon: "battery-full",
+		unit: "%",
+		precision: 1,
+		category: "power",
+		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"
+	},
+	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"
+	},
+	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: .5,
+			caution: .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"
+	},
+	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"
+	},
+	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"
+	},
+	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"
+	},
+	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"
+	},
+	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"
+	},
+	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"
+var 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"
+var CATEGORY_LABELS = {
+	power: "Power",
+	thermal: "Thermal",
+	attitude: "Attitude",
+	communications: "Communications",
+	propulsion: "Propulsion",
+	navigation: "Navigation",
+	payload: "Payload",
+	health: "Health",
+	orbital: "Orbital",
+	general: "General"
 };
+/**
+* Get property configuration by key
+* Returns preset config or a default config for unknown properties
+*/
 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
-  };
+	const preset = PROPERTY_PRESETS[key];
+	if (preset) return preset;
+	return {
+		label: formatPropertyLabel(key),
+		icon: "info",
+		unit: "",
+		precision: 2,
+		category: "general",
+		description: key
+	};
 }
+/**
+* Format a property key into a display label (sentence case)
+*/
 function formatPropertyLabel(key) {
-  const words = key.replace(/([A-Z])/g, " $1").replace(/[_-]/g, " ").trim().toLowerCase();
-  return words.charAt(0).toUpperCase() + words.slice(1);
+	const words = key.replace(/([A-Z])/g, " $1").replace(/[_-]/g, " ").trim().toLowerCase();
+	return words.charAt(0).toUpperCase() + words.slice(1);
 }
+/**
+* Derive status level from a value and thresholds
+*
+* @param value - Current value
+* @param thresholds - Status thresholds
+* @returns StatusLevel
+*
+* @example
+* ```tsx
+* deriveStatus(75, { caution: 60, critical: 80 }) // 'caution'
+* deriveStatus(25, { criticalLow: 10, cautionLow: 30 }) // 'caution'
+* deriveStatus(50, { caution: 60, critical: 80 }) // 'normal'
+* ```
+*/
 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";
+	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";
 }
+/**
+* Derive status for battery specifically (low is bad)
+*/
 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";
+	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";
 }
+/**
+* Format a value with its property config
+*/
 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;
+	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;
 }
+/**
+* Create a custom property config by merging with a preset
+*/
 function createPropertyConfig(baseKey, overrides) {
-  const base = getPropertyConfig(baseKey);
-  return { ...base, ...overrides };
+	return {
+		...getPropertyConfig(baseKey),
+		...overrides
+	};
 }
+/**
+* Get all properties in a category
+*/
 function getPropertiesByCategory(category) {
-  return Object.entries(PROPERTY_PRESETS).filter(([_, config]) => config.category === category).map(([key, config]) => ({ key, config }));
+	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
+//#endregion
+export { CATEGORY_ICONS, CATEGORY_LABELS, PROPERTY_PRESETS, createPropertyConfig, deriveBatteryStatus, deriveStatus, formatPropertyLabel, formatPropertyValue, getPropertiesByCategory, getPropertyConfig };
+
+//# sourceMappingURL=propertyConfig.js.map