@zendir/ui 0.2.21 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,187 @@
 # @zendir/ui
 
+## 0.3.0 
+
+**Upgrade from npm:** The latest public release on the registry is
+[0.2.21](https://www.npmjs.com/package/@zendir/ui). This **0.3.0** release
+is the next version on npm and combines the hook / 3D integration work
+with the token / `react/core/` architecture pass below.
+
+This release reframes the React hook layer around a single, well-defined
+bridge from `zendir-ts` to the live `<ZenSpace3D />` surface, and
+replaces three legacy SDK-coupled hooks with smaller, REST-aligned
+primitives. The Cesium backend gains proper sub-satellite ground-track
+alignment, and the `ZenSpace3DUtils` helper module is slimmed to only
+what the live backends actually consume. It also eliminates token drift
+hazards by consolidating literals, auto-generating `tokens.css`, and
+reorganising `react/core/` into thematic subfolders.
+
+### Features
+
+- **`useSimulationScene`** — primary integration hook
+  (`@zendir/ui/react/hooks` and `@zendir/ui/react/3d`). Bridges a
+  `zendir-ts` `ZendirClient` to `ZenSpace3D` props: fetches
+  `GetSimulationStructure` once, buckets spacecraft / ground stations /
+  planets, and polls `Position_BN_N` / `Velocity_BN_N` on a configurable
+  interval (default 2 s). Exports `SimulationSceneClient`,
+  `SimulationSceneObject`, `StructureDiag`, `PositionTickDiag`, and
+  `UseSimulationSceneResult` for typed app integration.
+- **Operator 3D surface** — the hook is intended to drive a full-screen
+  `ZenSpace3D` in host apps (e.g. `space-range-operator`
+  `/admin/3d/:containerId/:simulationId`). Feed
+  `useSimulationScene` with `containerId`, `simulationId`, and the
+  session `client`.
+- **`ZenSpace3DProps.referenceTime`** — new `Date` prop used by the
+  Cesium backend to convert ECI/J2000 positions into the Earth-Fixed
+  (ECEF) frame Cesium renders. Passing the simulation clock (sim epoch
+  + sim seconds) lines the sub-satellite point on Earth up with the
+  true ground track; omitting it falls back to wall-clock time and the
+  ground track will drift.
+- **Top-level re-exports** — `ZenSpace3D`, `useSimulationScene`, and
+  their types are now available from the main `@zendir/ui/react`
+  entry in addition to the `react/3d` and `react/hooks` subpaths.
+
+### Breaking Changes
+
+- **Removed legacy SDK hooks**: `useTelemetry`, `useSpacecraftPosition`,
+  and `useSimulationTime` no longer exist. Their
+  responsibilities are covered by `useSimulationScene` (live position /
+  velocity bucketed onto scene objects) and by the `referenceDate` /
+  `positionTickDiag` fields on its result.
+- **`useAccessWindows` is now pure client-side math**. The Zendir REST
+  API does not expose a server-side access-prediction endpoint, so the
+  hook no longer attempts to load `zendir-ts` or fetch passes. It now
+  accepts a `windows: AccessPass[]` input (compute these with your own
+  propagator / SGP4 / demo data) and returns `TimerConfig` objects for
+  `<MissionClock />`. Removed options: `spacecraftId`, `groundStationId`,
+  `passCount`. Removed result fields: `isConnected`, `isSdkAvailable`,
+  `error`. The `manualWindows` option is kept as a deprecated alias
+  for `windows` for one minor.
+- **Renames in `useAccessWindows`**: the `AccessWindow` type is now
+  `AccessPass`, and `createDemoAccessWindows` is now
+  `createDemoAccessPasses`. Update imports accordingly.
+- **`ZenSpace3DUtils` pruned to the live surface**. Unused helpers were
+  removed: `cartesianToLatLonAlt`, `cartesianToSpherical`,
+  `sphericalToCartesian`, `eciToEcef`, `calculateGMST`,
+  `dateToJulianDate`, `parseTLE`, `propagateSGP4Simple`,
+  `propagateSatellite`, `generateOrbitPath`, `isVisible`,
+  `calculateVisibilityConeGeometry`, `calculateFootprint`,
+  `generateHexGrid`, `updateHexGridCoverage`, all vector-math helpers
+  (`dot`, `cross`, `magnitude`, `normalize`, `subtract`, `add`,
+  `scale`, `distance`, `lerp`), `easeInOutCubic`, `smoothstep`,
+  `lerpColor`, `hexToRgb`, `getGradientColor`, `formatDuration`,
+  `formatDistance`, `formatVelocity`, `formatDateTime`, and the
+  constants `EARTH_MU`, `AU_KM`, `J2000_EPOCH`. Retained:
+  `EARTH_RADIUS_KM`, `DEG_TO_RAD`, `RAD_TO_DEG`, `SCENE_EARTH_RADIUS`,
+  `KM_TO_SCENE`, `latLonAltToCartesian`, `easeOutCubic`. For orbital
+  mechanics, use a dedicated library (`satellite.js` for SGP4) or
+  Cesium's built-in transforms; the Three.js path already draws
+  coverage from the explicit `SatelliteCoverage` props.
+
+### Improvements
+
+- **`useZendirSession`** — reworked container + simulation lifecycle
+  (provision container, poll until `RUNNING`, then create a simulation),
+  with a new `SessionInfo` export and `preloadZendirSdk` /
+  `isZendirSdkAvailable` utilities.
+- **`ZenSpace3D` Cesium backend** — substantial rework
+  (`ZenSpace3DCesium.tsx`) so positions streamed in J2000/ECI are
+  correctly rotated into ECEF each frame using the simulation clock,
+  keeping the orbit and its ground track visually consistent.
+- **`ZenSpace3DTypes` docs** — updated SDK-compatibility example to the
+  new `useSimulationScene` pattern and clarified that coverage geometry
+  is either explicit (`footprintPolygon` / `halfAngle`) or computed
+  locally by the viewer.
+- **`types.ts`** — clarified that UI-domain types (`Quaternion`,
+  `Vector3D`, `PointingMode`, etc.) ship with `@zendir/ui` and are not
+  provided by `zendir-ts` (which is REST-only and intentionally
+  minimal). Helpers like `estimateOrbitalPeriod` /
+  `estimateOrbitalVelocity` are documented as client-side approximations.
+- **Docs refresh** — `SDKIntegration.mdx`, `ComponentsOverview.mdx`,
+  and `Introduction.mdx` updated to reflect the `zendir-ts` rename
+  (previously `@zendir/sdk`) and the new hook surface.
+
+### Migration
+
+```tsx
+// Before (0.2.x)
+import { useTelemetry, useSpacecraftPosition, useSimulationTime } from '@zendir/ui/react/hooks';
+
+// After (0.3.0)
+import { useSimulationScene } from '@zendir/ui/react/hooks';
+
+const scene = useSimulationScene({ client, containerId, simulationId });
+// scene.satellites, scene.groundStations, scene.referenceDate, scene.positionTickDiag
+```
+
+```tsx
+// Before (0.2.x)
+import { useAccessWindows, createDemoAccessWindows, AccessWindow } from '@zendir/ui/react/hooks';
+
+const { aosTimer, losTimer } = useAccessWindows({
+  spacecraftId: 'my-sat',
+  groundStationId: 'gs-1',
+});
+
+// After (0.3.0)
+import { useAccessWindows, createDemoAccessPasses, AccessPass } from '@zendir/ui/react/hooks';
+
+const passes: AccessPass[] = computePasses(satellite, groundStation); // your propagator
+const { aosTimer, losTimer } = useAccessWindows({ windows: passes });
+```
+
+### Notes
+
+- Consumer apps that use a published tarball should depend on
+  `"@zendir/ui": "^0.3.0"`. Monorepo/local development can keep
+  `"@zendir/ui": "file:../zendir-ui"`.
+- After `npm publish` in this package, run `npm install` in consuming
+  apps to pick up 0.3.0 (no automatic push; release is manual).
+
+
+### Architecture — `core/` reorganised
+
+The 42-file flat `react/core/` folder is split into thematic subfolders:
+`inputs/`, `feedback/`, `overlays/`, `navigation/`, `data/`, `display/`,
+`widgets/` (alongside the existing `layout/`).
+
+- The `core/index.ts` barrel still exports everything by name. Consumers
+  using `import { Button } from '@zendir/ui'` or `from '@zendir/ui/react/core'`
+  are unaffected.
+- Deep imports like `from '@zendir/ui/react/core/Button'` now resolve via
+  the new path; if you have these, switch to the barrel for stability.
+
+### Theme + a11y
+
+- **JS-side `tokens.animation.*` honours `prefers-reduced-motion`.**
+  The global CSS @media rule already stripped CSS animations; this
+  extends the same behaviour to the JS-side tokens surface so animation
+  libraries (Framer Motion etc.) reading `tokens.animation.fast` get
+  collapsed values too.
+
+
+### Removed
+
+- Legacy `EarthViewer` and `SolarSystemViewer` 3D components (~1.6k LOC
+  of dead code; superseded by `ZenSpace3D`).
+- Deprecated `ChatGPTCard` alias (use `AppCard`) and `useIntrinsicHeight`
+  no-op hook (use `useMaxHeight`).
+- `scripts/build-tokens.js` (had its own duplicate token literal —
+  replaced by `build-tokens.ts` that imports from `tokens/index.ts`).
+
+### Internal
+
+- `src/react/core/` reorganised — see "Architecture" above.
+- Operator and dashboard verified working with new structure.
+- **Toolchain** — ESLint 9 flat config (`eslint.config.js`), `typescript-eslint` v8,
+  Vitest 2.1 + Vite 5.4; `npm audit fix -w @zendir/ui --legacy-peer-deps` at monorepo
+  root to clear hoisted dev CVEs without `--force` onto Vite 8. Storybook 8
+  `eslint-plugin-storybook` rules removed until Storybook 10+ (plugin v0.8 uses
+  APIs dropped in ESLint 9).
+- 284/284 tests pass; typecheck clean; build clean.
+
+---
+
 ## 0.2.21
 
 ### Improvements
@@ -164,4 +346,4 @@ Initial public release.
 - Layout primitives (Box, Flex, Grid, Stack, Container, SideNav, SidePanel)
 - Accessibility-first (WCAG 2.2 AA oriented)
 - Design tokens as JS objects and CSS custom properties
-- Optional @zendir/sdk integration with graceful fallback
+- Optional `zendir-ts` (Zendir TypeScript SDK) integration with graceful fallback

package/README.md

@@ -14,23 +14,22 @@
 </p>
 
 <p align="center">
-  <a href="#quick-start">Quick Start</a> · <a href="#components">Components</a> · <a href="#ai-integration">AI Integration</a> · <a href="#theme-system">Theming</a> · <a href="#accessibility">Accessibility</a> · <a href="https://storybook.zendir.io">Storybook</a> · <a href="CONTRIBUTING.md">Contributing</a> · <a href="SECURITY.md">Security</a> · <a href="CODE_OF_CONDUCT.md">Code of Conduct</a>
+  <a href="#quick-start">Quick Start</a> · <a href="#components">Components</a> · <a href="#ai-integration">AI Integration</a> · <a href="#theme-system">Theming</a> · <a href="#accessibility">Accessibility</a> · <a href="https://storybook.zendir.io">Storybook</a> · <a href="CONTRIBUTING.md">Contributing</a> · <a href="CODE_OF_CONDUCT.md">Code of Conduct</a>
 </p>
 
 ---
 
 ## Overview
 
-Zendir UI provides production-ready React components purpose-built for satellite telemetry, orbit visualization, mission control dashboards, and space simulation interfaces. Components follows the [Astro UX Design System](https://www.astrouxds.com/) — the industry standard for space operations software.
+React components for satellite telemetry, orbit visualisation, mission control dashboards, and space simulations. Follows the [Astro UX Design System](https://www.astrouxds.com/) used by the U.S. Space Force.
 
-**Why Zendir UI?**
+- **Astro UX-aligned** — dual-coded status indicators, classification banners, mission clocks
+- **TypeScript-first** — full type definitions
+- **Accessible** — [WCAG 2.2 AA](https://www.w3.org/TR/WCAG22/) conformant, keyboard navigable, reduced-motion aware, EAA-aligned
+- **Tree-shakeable** with optional peer dependencies
+- Works standalone or with [`zendir-ts`](https://www.npmjs.com/package/zendir-ts) for live API integration
 
-- **60+ components** — from core primitives to 3D orbit viewers
-- **Astro UX compliant** — dual-coded status indicators, classification banners, and mission clocks
-- **TypeScript-first** — full type safety with 200+ exported interfaces
-- **Accessible** — [WCAG 2.2 AA](https://www.w3.org/TR/WCAG22/) conformant, keyboard navigable, reduced motion aware, and aligned with the [European Accessibility Act](https://ec.europa.eu/social/main.jsp?catId=1202)
-- **Modular** — tree-shakeable, optional peer dependencies, zero runtime cost for unused features
-- **Framework-ready** — works standalone or with `@zendir/sdk` for live API integration
+The full component catalogue with live examples lives in [Storybook](https://storybook.zendir.io).
 
 ## Quick Start
 
@@ -41,12 +40,18 @@ npm install @zendir/ui
 ```
 
 > The SDK is optional. All TypeScript types ship with the UI library.
-> Install `@zendir/sdk` only if you need the API client.
+> Install `zendir-ts` only if you need the API client.
 >
-> **Vite / dev server:** If you do not install `@zendir/sdk`, add an alias so the optional peer resolves and the app runs (hooks will report "SDK not installed"):
+> Recent versions of `@zendir/ui` hide the SDK specifier from static
+> import-analysis, so no Vite alias is required — missing `zendir-ts` simply
+> causes hooks like `useZendirSession` to report "SDK not installed" while the
+> rest of the UI keeps working.
+>
+> **Older bundlers / strict resolvers:** if you hit "Failed to resolve import
+> 'zendir-ts'", point the optional peer at the bundled stub:
 > ```js
 > // vite.config.js
-> resolve: { alias: { '@zendir/sdk': require.resolve('@zendir/ui/sdk-stub') } }
+> resolve: { alias: { 'zendir-ts': require.resolve('@zendir/ui/sdk-stub') } }
 > ```
 
 ### Use
@@ -104,7 +109,7 @@ Foundational primitives that compose into any interface.
 | `SidePanel` | Slide-out panel with configurable position |
 | `DataTable` | Sortable, filterable data grid |
 | `Menu` / `Popover` | Context menus and floating content |
-| `ChatPanel` | AI chat interface with structured blocks, status system, and [3 LLM integration strategies](#ai-integration) |
+| `ChatPanel` | AI chat interface with structured blocks, status system, and [4 LLM integration strategies](#ai-integration) |
 
 ### Status & Monitoring
 
@@ -156,7 +161,7 @@ import { DataValue, DataValueGroup } from '@zendir/ui/react';
 </DataValueGroup>
 ```
 
-**Presets:** `battery` · `voltage` · `temperature` · `signalStrength` · `altitude` · `velocity` · `fuelLevel` · `cpuUsage` · `memoryUsage` · [and 20+ more](COMPONENTS.md)
+**Presets:** `battery` · `voltage` · `temperature` · `signalStrength` · `altitude` · `velocity` · `fuelLevel` · `cpuUsage` · `memoryUsage` · and 20+ more (see [Storybook](https://storybook.zendir.io) for the full list)
 
 ### Visualizations
 
@@ -187,11 +192,23 @@ import { PowerChart, AttitudeChart, GroundTrackMap } from '@zendir/ui/react';
 
 ### 3D Viewers
 
-Interactive Three.js-based viewers with orbital mechanics, TLE parsing, and SGP4 propagation.
+Three viewers covering the operations spectrum from full-Earth to full solar system, with optional WebGL2 (Three.js) and Cesium backends.
 
 ```tsx
-import { EarthViewer, SolarSystemViewer } from '@zendir/ui/react';
+import { ZenSpace3D, EarthViewer, SolarSystemViewer } from '@zendir/ui/react';
+
+// Unified 3D space view — Three.js by default, optional Cesium backend for
+// physically-accurate ECI/ECEF transforms and high-fidelity Earth imagery.
+// Pair with `useSimulationScene` (see SDK Integration) to render a live
+// simulation directly from a `zendir-ts` `ZendirClient`.
+<ZenSpace3D
+  satellites={satellites}
+  groundStations={groundStations}
+  satelliteCoverages={coverages}
+  referenceTime={referenceDate}
+/>
 
+// Lightweight Three.js Earth view — good for small dashboards and demos.
 <EarthViewer
   spacecraft={[{ id: 'SAT-001', name: 'Explorer-1', latitude: 45.2, longitude: -122.5, altitude: 408 }]}
   groundStations={[{ id: 'DSN-14', name: 'Goldstone', latitude: 35.4, longitude: -116.9 }]}
@@ -203,6 +220,8 @@ import { EarthViewer, SolarSystemViewer } from '@zendir/ui/react';
 <SolarSystemViewer focusedPlanet="earth" autoOrbit showLabels />
 ```
 
+Coverage geometry (footprint polygons, sensor cones, nadir lines) is rendered from explicit `SatelliteCoverage` records — see `ZenSpace3DTypes` for the full prop surface. Heavy orbital propagation (SGP4 / TLE) is intentionally **not** shipped in this package; bring your own propagator (e.g. [`satellite.js`](https://github.com/shashwatak/satellite-js)) and feed positions in via props, or use `useSimulationScene` to read live `Position_BN_N` from the engine.
+
 ### Astro UX Components
 
 Mission operations components following [Astro UX Design System](https://www.astrouxds.com/) specifications.
@@ -271,25 +290,50 @@ import { CardAccentProvider, useCardAccent } from '@zendir/ui/react';
 
 ## SDK Integration (Optional)
 
-For live API integration, add `@zendir/sdk`:
+For live API integration, add the Zendir TypeScript SDK (`zendir-ts`):
 
 ```bash
-npm install @zendir/sdk
+npm install zendir-ts
 ```
 
+`useZendirSession` provisions the container + simulation lifecycle.
+`useSimulationScene` is the canonical bridge — it polls `Position_BN_N`,
+buckets the simulation structure, and feeds props straight into `<ZenSpace3D />`.
+
 ```tsx
-import { ZendirClient } from '@zendir/sdk';
-import { SpacecraftCard, useZendirSession } from '@zendir/ui/react';
+import { useZendirSession, useSimulationScene, ZenSpace3D } from '@zendir/ui/react';
+
+function MissionControl() {
+  // Lifecycle: createContainer → waitForRunning → createSimulation
+  const { client, session, connect, disconnect, isLoading, error } =
+    useZendirSession({ apiKey: 'your-key', autoConnect: true });
 
-const client = new ZendirClient({ apiKey: 'your-key' });
+  // Live data: structure + position polling, ECI→ECEF on the Cesium backend
+  const scene = useSimulationScene({
+    client,
+    containerId: session?.containerId ?? null,
+    simulationId: session?.simulationId ?? null,
+  });
 
-function Dashboard() {
-  const { isConnected } = useZendirSession({ client });
-  // ...
+  if (error)         return <div>Error: {error}</div>;
+  if (isLoading)     return <div>Connecting…</div>;
+  if (!session)      return <button onClick={connect}>Connect</button>;
+
+  return (
+    <ZenSpace3D
+      satellites={scene.satellites}
+      groundStations={scene.groundStations}
+      referenceTime={scene.referenceDate}
+    />
+  );
 }
 ```
 
-**SDK hooks:** `useZendirSession` · `useTelemetry` · `useSpacecraftPosition` · `useAccessWindows` · `useSimulationTime`
+| Hook | Purpose |
+|---|---|
+| `useZendirSession` | Container + simulation lifecycle (`createContainer` → `waitForRunning` → `createSimulation`); `disconnect` tears down |
+| `useSimulationScene` | Bridges a `ZendirClient` to live `<ZenSpace3D />` props (satellites, ground stations, custom objects, reference time) |
+| `useAccessWindows` | Pure client-side AOS/LOS pass-timing math from a list of `AccessPass` records (no SDK call) |
 
 ---
 
@@ -470,7 +514,7 @@ function SatelliteWidget() {
 }
 ```
 
-**Enterprise features:** Error boundary (children never crash host), loading skeleton, error display with retry, Astro UX 6-level status badges with shapes, WCAG 2.1 AA ARIA labels, `maxHeight` auto-constraint, theme sync, fullscreen support. `ChatGPTCard` is still exported as a deprecated alias for backward compatibility.
+**Enterprise features:** Error boundary (children never crash host), loading skeleton, error display with retry, Astro UX 6-level status badges with shapes, WCAG 2.1 AA ARIA labels, `maxHeight` auto-constraint, theme sync, fullscreen support.
 
 ### MCP Server → ChatPanel Bridge
 
@@ -565,8 +609,6 @@ Zendir UI conforms to [**WCAG 2.2 Level AA**](https://www.w3.org/TR/WCAG22/) and
 
 Testing: [eslint-plugin-jsx-a11y](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y) in CI, [axe-core](https://storybook.js.org/addons/@storybook/addon-a11y) on all Storybook stories, manual keyboard and screen reader verification (VoiceOver, NVDA, TalkBack).
 
-For the full conformance statement with WCAG success criteria mapping and EN 301 549 clause mapping, see [**ACCESSIBILITY.md**](ACCESSIBILITY.md).
-
 Accessibility issues are treated as **P0 bugs**. [Report an issue](https://github.com/zendir-dev/zendir-ui/issues) with the `accessibility` label.
 
 ---

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * @zendir/ui - UI Components and Widgets for Zendir
  *
  * React components, Three.js visualizations, and widgets for Zendir applications.
- * All types are provided locally; install @zendir/sdk separately for API client.
+ * All types are provided locally; install `zendir-ts` separately for API client.
  */
 export * from './react/index.js';
 export * from './types/index.js';

package/dist/index.js

@@ -3,74 +3,78 @@ import { Skeleton3D, SkeletonBox, SkeletonCard, SkeletonChart, SkeletonCircle, S
 import { STATUS_COLORS, addAlpha, clamp, classNames, focusRingStyle, formatAltitude, formatCoordinate, formatCountdown, formatDataRate, formatDecibels, formatDegrees, formatDistance, formatDuration, formatFrequency, formatLatLon, formatNumber, formatPercentage, formatPower, formatTabular, formatTemperature, formatTime, formatUTC, formatVelocity, getStatusColor, getStatusFromValue, getStatusSeverity, getWorstStatus, isStatusLevel, isValidNumber, lerp, mapRange, normalizeStatus, safeAccentText, safeNumber, tabularNumsStyle, transitions, withNullSafety } from "./react/utils/index.js";
 import { useCompactMode } from "./react/hooks/useCompactMode.js";
 import { PLANETS, auToKm, estimateOrbitalPeriod, estimateOrbitalVelocity, getPlanet, normalizePlanetName } from "./react/types.js";
-import { ActivityPlanner } from "./react/core/ActivityPlanner.js";
-import { AppBar } from "./react/core/AppBar.js";
+import { ActivityPlanner } from "./react/core/widgets/ActivityPlanner.js";
+import { AppBar } from "./react/core/navigation/AppBar.js";
 import { AstroChart } from "./react/charts/unified/AstroChart.js";
 import { BREAKPOINTS, useBreakpoint } from "./react/core/layout/useBreakpoint.js";
-import { Badge } from "./react/core/Badge.js";
-import { Body1, Body2, Body3, Compact, DataText, Display1, Display2, FONT_FAMILY_MONO, FONT_FAMILY_PRIMARY, FONT_WEIGHTS, H1, H2, H3, H4, H5, H6, Label, Micro, Mono, Typography } from "./react/core/Typography.js";
+import { Badge } from "./react/core/display/Badge.js";
+import { Body1, Body2, Body3, Compact, DataText, Display1, Display2, FONT_FAMILY_MONO, FONT_FAMILY_PRIMARY, FONT_WEIGHTS, H1, H2, H3, H4, H5, H6, Label, Micro, Mono, Typography } from "./react/core/display/Typography.js";
 import { Box } from "./react/core/layout/Box.js";
-import { Button } from "./react/core/Button.js";
+import { Button } from "./react/core/inputs/Button.js";
 import { CARD_ACCENT_COLORS, CardAccentProvider, SPACE_SYSTEM_COLORS, getAccentColorOptions, getSystemAccentColor, useCardAccent } from "./react/theme/cardAccent.js";
-import { CATEGORY_ICONS, CATEGORY_LABELS, PROPERTY_PRESETS, createPropertyConfig, deriveBatteryStatus, deriveStatus, formatPropertyLabel, formatPropertyValue, getPropertiesByCategory, getPropertyConfig } from "./react/core/propertyConfig.js";
-import { CHAT_RESPONSE_JSON_PROMPT, CHAT_RESPONSE_MCP_TOOL, CHAT_RESPONSE_TOOL_SCHEMA, CHAT_RESPONSE_YAML_PROMPT, CHAT_STATUS_RULES_PROMPT, ChatPanel, createChatResponseParser, parseChatResponse, parseMcpToolResult } from "./react/core/ChatPanel.js";
-import { Capture, loadCapturePlaceholderImage, useCapture } from "./react/core/Capture.js";
-import { CardHeader } from "./react/core/CardHeader.js";
+import { CATEGORY_ICONS, CATEGORY_LABELS, PROPERTY_PRESETS, createPropertyConfig, deriveBatteryStatus, deriveStatus, formatPropertyLabel, formatPropertyValue, getPropertiesByCategory, getPropertyConfig } from "./react/core/data/propertyConfig.js";
+import { CHAT_RESPONSE_JSON_PROMPT, CHAT_RESPONSE_MCP_TOOL, CHAT_RESPONSE_TOOL_SCHEMA, CHAT_RESPONSE_YAML_PROMPT, CHAT_STATUS_RULES_PROMPT, ChatPanel, createChatResponseParser, parseChatResponse, parseMcpToolResult } from "./react/core/widgets/ChatPanel.js";
+import { Capture, loadCapturePlaceholderImage, useCapture } from "./react/core/widgets/Capture.js";
+import { CardHeader } from "./react/core/display/CardHeader.js";
 import { CategoryPalette } from "./react/utils/categoryPalette.js";
 import { CategoryProvider, useCategoryPalette, useCategoryPaletteRequired } from "./react/context/CategoryContext.js";
 import { Center } from "./react/core/layout/Center.js";
-import { Checkbox } from "./react/core/Checkbox.js";
+import { Checkbox } from "./react/core/inputs/Checkbox.js";
 import { ClassificationBanner } from "./react/astro/ClassificationBanner.js";
-import { ColorPickerPanel } from "./react/core/ColorPickerPanel.js";
-import { CommandBuilder } from "./react/core/CommandBuilder.js";
-import { ConfirmDialog, ConfirmProvider, useConfirm } from "./react/core/ConfirmDialog.js";
-import { ConnectionForm } from "./react/core/ConnectionForm.js";
-import { Container } from "./react/core/Container.js";
-import { CopyButton, useCopyToClipboard } from "./react/core/CopyButton.js";
-import { DataTable, DataTableRowDetail } from "./react/core/DataTable.js";
-import { DataValue, DataValueGroup } from "./react/core/DataValue.js";
-import { Dialog } from "./react/core/Dialog.js";
+import { ColorPickerPanel } from "./react/core/widgets/ColorPickerPanel.js";
+import { CommandBuilder } from "./react/core/widgets/CommandBuilder.js";
+import { ConfirmDialog, ConfirmProvider, useConfirm } from "./react/core/feedback/ConfirmDialog.js";
+import { ConnectionForm } from "./react/core/widgets/ConnectionForm.js";
+import { Container } from "./react/core/display/Container.js";
+import { CopyButton, useCopyToClipboard } from "./react/core/display/CopyButton.js";
+import { DataTable, DataTableRowDetail } from "./react/core/data/DataTable.js";
+import { DataValue, DataValueGroup } from "./react/core/data/DataValue.js";
+import { Dialog } from "./react/core/feedback/Dialog.js";
 import { DisplaySettingsProvider, GLASS_TINTS, PRESET_COLORS, getEffectiveCompactMode, useDisplaySettings, useDisplaySettingsOptional } from "./react/context/DisplaySettingsContext.js";
 import { Divider } from "./react/core/layout/Divider.js";
-import { FileExplorer } from "./react/core/FileExplorer.js";
+import { FileExplorer } from "./react/core/widgets/FileExplorer.js";
 import { Flex } from "./react/core/layout/Flex.js";
-import { GLASS_COLOR_OVERLAYS, GlassCard } from "./react/core/GlassCard.js";
+import { GLASS_COLOR_OVERLAYS, GlassCard } from "./react/core/display/GlassCard.js";
 import { GlobalStatusBar } from "./react/astro/GlobalStatusBar.js";
 import { Grid } from "./react/core/layout/Grid.js";
 import { GroundTrackMap } from "./react/charts/GroundTrackMap.js";
 import { HStack, Stack, VStack } from "./react/core/layout/Stack.js";
-import { HeaderIconWithStatus } from "./react/core/HeaderIconWithStatus.js";
-import { HexViewer, REGION_BORDER_COLORS, REGION_COLORS } from "./react/core/HexViewer.js";
-import { Icon, getIconNames, isValidIconName } from "./react/core/Icon.js";
-import { ImageGallery } from "./react/core/ImageGallery.js";
-import { Input } from "./react/core/Input.js";
-import { LimitsBar } from "./react/core/LimitsBar.js";
-import { LogViewer } from "./react/core/LogViewer.js";
-import { Menu, Popover } from "./react/core/Popover.js";
-import { MessageStream } from "./react/core/MessageStream.js";
+import { HeaderIconWithStatus } from "./react/core/display/HeaderIconWithStatus.js";
+import { HexViewer, REGION_BORDER_COLORS, REGION_COLORS } from "./react/core/widgets/HexViewer.js";
+import { Icon, getIconNames, isValidIconName } from "./react/core/display/Icon.js";
+import { ImageGallery } from "./react/core/widgets/ImageGallery.js";
+import { Input } from "./react/core/inputs/Input.js";
+import { LayerControlPanel } from "./react/panels/LayerControlPanel.js";
+import { LimitsBar } from "./react/core/inputs/LimitsBar.js";
+import { LogViewer } from "./react/core/widgets/LogViewer.js";
+import { Menu, Popover } from "./react/core/overlays/Popover.js";
+import { MessageStream } from "./react/core/widgets/MessageStream.js";
 import { MiniSimulationControls, SimulationControls, SimulationControlsWithClock } from "./react/astro/SimulationControls.js";
-import { MissionCalendar } from "./react/core/MissionCalendar.js";
+import { MissionCalendar } from "./react/core/widgets/MissionCalendar.js";
 import { MissionClock } from "./react/astro/MissionClock.js";
 import { MonitoringIcon } from "./react/astro/MonitoringIcon.js";
 import { Notification } from "./react/astro/Notification.js";
-import { NumberInput } from "./react/core/NumberInput.js";
-import { PacketViewer } from "./react/core/PacketViewer.js";
-import { Pagination } from "./react/core/Pagination.js";
-import { PinInput } from "./react/core/PinInput.js";
+import { NumberInput } from "./react/core/inputs/NumberInput.js";
+import { ObjectInventoryPanel, recommendedFlyDistance } from "./react/panels/ObjectInventoryPanel.js";
+import { PacketViewer } from "./react/core/widgets/PacketViewer.js";
+import { Pagination } from "./react/core/navigation/Pagination.js";
+import { PinInput } from "./react/core/inputs/PinInput.js";
 import { Progress } from "./react/astro/Progress.js";
-import { SIDENAV_HEADER_LOGO_SLOT_HEIGHT_PX, SideNav } from "./react/core/SideNav.js";
-import { Select } from "./react/core/Select.js";
-import { SidePanel } from "./react/core/SidePanel.js";
+import { SIDENAV_HEADER_LOGO_SLOT_HEIGHT_PX, SideNav } from "./react/core/navigation/SideNav.js";
+import { Select } from "./react/core/inputs/Select.js";
+import { SidePanel } from "./react/core/overlays/SidePanel.js";
 import { Spacer } from "./react/core/layout/Spacer.js";
 import { StatusIndicator } from "./react/astro/StatusIndicator.js";
-import { Tabs } from "./react/core/Tabs.js";
+import { Tabs } from "./react/core/navigation/Tabs.js";
 import { ThemeProvider, useScrollbarStyles, useTheme, useThemeTokens } from "./react/theme/ThemeProvider.js";
 import { UnifiedTimeline } from "./react/astro/UnifiedTimeline.js";
-import { ToastProvider, useToast, useToastManager } from "./react/core/Toast.js";
-import { Toggle } from "./react/core/Toggle.js";
-import { Tooltip } from "./react/core/Tooltip.js";
+import { ToastProvider, useToast, useToastManager } from "./react/core/feedback/Toast.js";
+import { Toggle } from "./react/core/inputs/Toggle.js";
+import { Tooltip } from "./react/core/overlays/Tooltip.js";
+import { ZenSpace3D } from "./react/3d/ZenSpace3D.js";
 import { ecefEulerXyzToHpr, ecefMetersToSdkPosition } from "./react/3d/CesiumCaptureSource.js";
 import { resolveResponsive, resolveSpacing } from "./react/core/layout/responsive.js";
+import { useSimulationScene } from "./react/hooks/useSimulationScene.js";
 export {
   ActivityPlanner,
   AppBar,
@@ -142,6 +146,7 @@ export {
   ImageGallery,
   Input,
   Label,
+  LayerControlPanel,
   LimitsBar,
   LogViewer,
   Menu,
@@ -154,6 +159,7 @@ export {
   Mono,
   Notification,
   NumberInput,
+  ObjectInventoryPanel,
   PLANETS,
   PRESET_COLORS,
   PROPERTY_PRESETS,
@@ -189,6 +195,7 @@ export {
   Tooltip,
   Typography,
   VStack,
+  ZenSpace3D,
   addAlpha,
   auToKm,
   clamp,
@@ -243,6 +250,7 @@ export {
   normalizeStatus,
   parseChatResponse,
   parseMcpToolResult,
+  recommendedFlyDistance,
   resolveResponsive,
   resolveSpacing,
   safeAccentText,
@@ -260,6 +268,7 @@ export {
   useDisplaySettings,
   useDisplaySettingsOptional,
   useScrollbarStyles,
+  useSimulationScene,
   useTheme,
   useThemeTokens,
   useToast,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/react/3d/CesiumCaptureSource.d.ts

@@ -1,4 +1,4 @@
-import { CaptureArgs } from '../core/Capture';
+import { CaptureArgs } from '../core/widgets/Capture';
 
 export interface CesiumCaptureSourceOptions {
     /**

package/dist/react/3d/CesiumCaptureSource.js

@@ -1,6 +1,6 @@
 import { DEG_TO_RAD, RAD_TO_DEG, EARTH_RADIUS_KM } from "./ZenSpace3DUtils.js";
 async function loadPlaceholderFallback() {
-  const { loadCapturePlaceholderImage } = await import("../core/Capture.js");
+  const { loadCapturePlaceholderImage } = await import("../core/widgets/Capture.js");
   return loadCapturePlaceholderImage();
 }
 function ecefMetersToSdkPosition(ecef) {