{"_id":"@altara/av","_rev":"4-8f9d255b9f7c9f709e4fe7350f85d9ce","name":"@altara/av","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@altara/av","version":"0.1.0","keywords":["react","autonomous-vehicles","av","self-driving","robotics","lidar","lidar-react","point-cloud","pointcloud2","three","threejs","occupancy-grid","slam","slam-map","object-detection","perception","sensor-fusion","camera-feed","radar","radar-sweep","ros2","rosbridge","telemetry","real-time","react-components","altara"],"author":{"name":"Jaya Sai Kishan Chapparam"},"license":"MIT","_id":"@altara/av@0.1.0","maintainers":[{"name":"jayachapparam","email":"cjskishan@gmail.com"}],"homepage":"https://github.com/JayaSaiKishanChapparam/altara/tree/main/packages/av#readme","bugs":{"url":"https://github.com/JayaSaiKishanChapparam/altara/issues"},"dist":{"shasum":"d6495034a46abd6e3f1f046759f7bf23865282df","tarball":"https://registry.npmjs.org/@altara/av/-/av-0.1.0.tgz","fileCount":9,"integrity":"sha512-wfdiXm5ZP/63c66IUsw0o1joxb5PGT9+4TSu0tJNXikRbeA5AkJcpN52sE9vXe6hZ5xqbodkEo+nIRqcGbfTLQ==","signatures":[{"sig":"MEYCIQCUJpYmczuQXIil4JmuzEUEVVxTFX+BPbVoXmpPsGBTeQIhAJodyXrEIK45f/1hxPguCkQVH91t6Pkuy7tFOJqVs/Fl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":451036},"main":"./dist/index.js","_from":"file:altara-av-0.1.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"lint":"eslint src --ext .ts,.tsx","test":"vitest run --passWithNoTests","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"jayachapparam","email":"cjskishan@gmail.com"},"_resolved":"/tmp/9f853aa72ac9fe2bc2698d6a6fdce2ca/altara-av-0.1.0.tgz","_integrity":"sha512-wfdiXm5ZP/63c66IUsw0o1joxb5PGT9+4TSu0tJNXikRbeA5AkJcpN52sE9vXe6hZ5xqbodkEo+nIRqcGbfTLQ==","repository":{"url":"git+https://github.com/JayaSaiKishanChapparam/altara.git","type":"git","directory":"packages/av"},"_npmVersion":"10.8.2","description":"Autonomous-vehicle React components for Altara — LiDAR point cloud (Three.js), occupancy grid, object-detection overlay, path planner, camera feed, control trace, radar sweep, perception state machine, sensor health matrix, SLAM map.","directories":{},"sideEffects":false,"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","react":"^18.3.0","three":"^0.160.0","vitest":"^1.5.0","happy-dom":"^14.7.1","react-dom":"^18.3.0","typescript":"^5.4.0","@altara/core":"0.0.2","@types/react":"^18.3.0","@types/three":"^0.160.0","@types/react-dom":"^18.3.0","@testing-library/react":"^15.0.5"},"peerDependencies":{"react":">=18.0.0","react-dom":">=18.0.0","@altara/core":"0.0.2"},"peerDependenciesMeta":{"three":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/av_0.1.0_1778262734355_0.09089743129517602","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@altara/av","version":"0.1.1","keywords":["react","autonomous-vehicles","av","self-driving","robotics","lidar","lidar-react","point-cloud","pointcloud2","three","threejs","occupancy-grid","slam","slam-map","object-detection","perception","sensor-fusion","camera-feed","radar","radar-sweep","ros2","rosbridge","telemetry","real-time","react-components","altara"],"author":{"name":"Jaya Sai Kishan Chapparam"},"license":"MIT","_id":"@altara/av@0.1.1","maintainers":[{"name":"jayachapparam","email":"cjskishan@gmail.com"}],"homepage":"https://github.com/JayaSaiKishanChapparam/altara/tree/main/packages/av#readme","bugs":{"url":"https://github.com/JayaSaiKishanChapparam/altara/issues"},"dist":{"shasum":"3c06362f655d661cd13d728c907bae59b2376513","tarball":"https://registry.npmjs.org/@altara/av/-/av-0.1.1.tgz","fileCount":9,"integrity":"sha512-KWxixQUbgUosFHPPxMHaWkwWha/vf3zeIDgc+APZm8fx6KsE8/aE61uEN+Pm0Xh6mu5X9A19dIyLQWHAby3z5g==","signatures":[{"sig":"MEUCIQDnFDFug2knp4EFMm7sIjWQc0q9SpWDWVcyDhZK+S3xQgIgN31Reg2JQw/lZW9gH4/myIkB9n8X5gt/f10mtxqv7IM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":451478},"main":"./dist/index.js","_from":"file:altara-av-0.1.1.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"lint":"eslint src --ext .ts,.tsx","test":"vitest run --passWithNoTests","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"jayachapparam","email":"cjskishan@gmail.com"},"_resolved":"/tmp/0dabd750f80f811bce2845d7ece74589/altara-av-0.1.1.tgz","_integrity":"sha512-KWxixQUbgUosFHPPxMHaWkwWha/vf3zeIDgc+APZm8fx6KsE8/aE61uEN+Pm0Xh6mu5X9A19dIyLQWHAby3z5g==","repository":{"url":"git+https://github.com/JayaSaiKishanChapparam/altara.git","type":"git","directory":"packages/av"},"_npmVersion":"10.8.2","description":"Autonomous-vehicle React components for Altara — LiDAR point cloud (Three.js), occupancy grid, object-detection overlay, path planner, camera feed, control trace, radar sweep, perception state machine, sensor health matrix, SLAM map.","directories":{},"sideEffects":false,"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","react":"^18.3.0","three":"^0.160.0","vitest":"^1.5.0","happy-dom":"^14.7.1","react-dom":"^18.3.0","typescript":"^5.4.0","@altara/core":"0.1.0","@types/react":"^18.3.0","@types/three":"^0.160.0","@types/react-dom":"^18.3.0","@testing-library/react":"^15.0.5"},"peerDependencies":{"react":">=18.0.0","react-dom":">=18.0.0","@altara/core":"^0.1.0"},"peerDependenciesMeta":{"three":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/av_0.1.1_1781725216619_0.5311085531249982","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@altara/av","version":"0.1.2","keywords":["react","autonomous-vehicles","av","self-driving","robotics","lidar","lidar-react","point-cloud","pointcloud2","three","threejs","occupancy-grid","slam","slam-map","object-detection","perception","sensor-fusion","camera-feed","radar","radar-sweep","ros2","rosbridge","telemetry","real-time","react-components","altara"],"author":{"name":"Jaya Sai Kishan Chapparam"},"license":"MIT","_id":"@altara/av@0.1.2","maintainers":[{"name":"jayachapparam","email":"cjskishan@gmail.com"}],"homepage":"https://github.com/JayaSaiKishanChapparam/altara/tree/main/packages/av#readme","bugs":{"url":"https://github.com/JayaSaiKishanChapparam/altara/issues"},"dist":{"shasum":"a42e403accc157da0f540c941b36c6e912611154","tarball":"https://registry.npmjs.org/@altara/av/-/av-0.1.2.tgz","fileCount":9,"integrity":"sha512-+OoEnQoOtRJ7nHvC//u9tvMPYRaCw5mf9K4BwxrNEIC1/Nic9ZXtef7+jtwjvNdLeL/8ZcnW/rC2dYeXATSrKQ==","signatures":[{"sig":"MEQCIFDtNJecu9elIvjId6ACM5Zy8mBecJl1BlbW92XD/xZTAiALgxAbWvx1T4xPju+CbPZ+fYimYuHcMIMxl4j2O0oG8Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":451478},"main":"./dist/index.js","_from":"file:altara-av-0.1.2.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"lint":"eslint src --ext .ts,.tsx","test":"vitest run --passWithNoTests","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"jayachapparam","email":"cjskishan@gmail.com"},"_resolved":"/tmp/1c34a66bf434bc8a45f3b7e03e5996ee/altara-av-0.1.2.tgz","_integrity":"sha512-+OoEnQoOtRJ7nHvC//u9tvMPYRaCw5mf9K4BwxrNEIC1/Nic9ZXtef7+jtwjvNdLeL/8ZcnW/rC2dYeXATSrKQ==","repository":{"url":"git+https://github.com/JayaSaiKishanChapparam/altara.git","type":"git","directory":"packages/av"},"_npmVersion":"10.8.2","description":"Autonomous-vehicle React components for Altara — LiDAR point cloud (Three.js), occupancy grid, object-detection overlay, path planner, camera feed, control trace, radar sweep, perception state machine, sensor health matrix, SLAM map.","directories":{},"sideEffects":false,"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","react":"^18.3.0","three":"^0.160.0","vitest":"^1.5.0","happy-dom":"^14.7.1","react-dom":"^18.3.0","typescript":"^5.4.0","@altara/core":"0.2.0","@types/react":"^18.3.0","@types/three":"^0.160.0","@types/react-dom":"^18.3.0","@testing-library/react":"^15.0.5"},"peerDependencies":{"react":">=18.0.0","react-dom":">=18.0.0","@altara/core":"^0.2.0"},"peerDependenciesMeta":{"three":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/av_0.1.2_1781816832980_0.7527892432581988","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@altara/av","version":"0.1.3","description":"Autonomous-vehicle React components for Altara — LiDAR point cloud (Three.js), occupancy grid, object-detection overlay, path planner, camera feed, control trace, radar sweep, perception state machine, sensor health matrix, SLAM map.","license":"MIT","type":"commonjs","author":{"name":"Jaya Sai Kishan Chapparam"},"homepage":"https://github.com/JayaSaiKishanChapparam/altara/tree/main/packages/av#readme","repository":{"type":"git","url":"git+https://github.com/JayaSaiKishanChapparam/altara.git","directory":"packages/av"},"bugs":{"url":"https://github.com/JayaSaiKishanChapparam/altara/issues"},"keywords":["react","autonomous-vehicles","av","self-driving","robotics","lidar","lidar-react","point-cloud","pointcloud2","three","threejs","occupancy-grid","slam","slam-map","object-detection","perception","sensor-fusion","camera-feed","radar","radar-sweep","ros2","rosbridge","telemetry","real-time","react-components","altara"],"main":"./dist/index.js","module":"./dist/index.mjs","types":"./dist/index.d.ts","exports":{".":{"import":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"require":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"sideEffects":false,"peerDependencies":{"@altara/core":"^0.2.0","react":">=18.0.0","react-dom":">=18.0.0"},"peerDependenciesMeta":{"three":{"optional":true}},"devDependencies":{"@testing-library/react":"^15.0.5","@types/react":"^18.3.0","@types/react-dom":"^18.3.0","@types/three":"^0.160.0","happy-dom":"^14.7.1","react":"^18.3.0","react-dom":"^18.3.0","three":"^0.160.0","tsup":"^8.0.0","typescript":"^5.4.0","vitest":"^1.5.0","@altara/core":"0.2.2"},"engines":{"node":">=20"},"scripts":{"build":"tsup && node ../../scripts/add-use-client.mjs","test":"vitest run --passWithNoTests","lint":"eslint src --ext .ts,.tsx","typecheck":"tsc --noEmit"},"_id":"@altara/av@0.1.3","_integrity":"sha512-0zFg2C5ytX4gPHG53szjzKKARv9CgLor58Gp24VTWH6dsVTvbnAKz11bEuZmDsonV4CP/sqUmy2i4MK3iHlvgw==","_resolved":"/tmp/337ed95251c9bd6195e41f9af3e0afe9/altara-av-0.1.3.tgz","_from":"file:altara-av-0.1.3.tgz","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-0zFg2C5ytX4gPHG53szjzKKARv9CgLor58Gp24VTWH6dsVTvbnAKz11bEuZmDsonV4CP/sqUmy2i4MK3iHlvgw==","shasum":"98386887441664abc6bf992b589dce3526f6da58","tarball":"https://registry.npmjs.org/@altara/av/-/av-0.1.3.tgz","fileCount":10,"unpackedSize":458707,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGM0BJ3EmI5haQCN9mLuSFHWCz3hkRnwXRmAsJglRexAAiBFG5EqizeNOrwhEk/LCcUGsOync7oAlQrSwCAGwM1WNA=="}]},"_npmUser":{"name":"jayachapparam","email":"cjskishan@gmail.com"},"directories":{},"maintainers":[{"name":"jayachapparam","email":"cjskishan@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/av_0.1.3_1787090496937_0.11229663430815684"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-08T17:52:14.270Z","modified":"2026-08-18T22:01:37.314Z","0.1.0":"2026-05-08T17:52:14.528Z","0.1.1":"2026-06-17T19:40:16.774Z","0.1.2":"2026-06-18T21:07:13.155Z","0.1.3":"2026-08-18T22:01:37.131Z"},"bugs":{"url":"https://github.com/JayaSaiKishanChapparam/altara/issues"},"author":{"name":"Jaya Sai Kishan Chapparam"},"license":"MIT","homepage":"https://github.com/JayaSaiKishanChapparam/altara/tree/main/packages/av#readme","keywords":["react","autonomous-vehicles","av","self-driving","robotics","lidar","lidar-react","point-cloud","pointcloud2","three","threejs","occupancy-grid","slam","slam-map","object-detection","perception","sensor-fusion","camera-feed","radar","radar-sweep","ros2","rosbridge","telemetry","real-time","react-components","altara"],"repository":{"type":"git","url":"git+https://github.com/JayaSaiKishanChapparam/altara.git","directory":"packages/av"},"description":"Autonomous-vehicle React components for Altara — LiDAR point cloud (Three.js), occupancy grid, object-detection overlay, path planner, camera feed, control trace, radar sweep, perception state machine, sensor health matrix, SLAM map.","maintainers":[{"name":"jayachapparam","email":"cjskishan@gmail.com"}],"readme":"# @altara/av\n\n**Autonomous-vehicle React components for Altara.** Embeddable LiDAR point-cloud renderer (Three.js), occupancy grid, object-detection overlay, path planner, camera feed, control trace, radar sweep, perception state machine, sensor health matrix, and SLAM map — for robotaxis, ADS prototypes, autonomous-shuttle dashboards, mobile-robotics monitoring, and self-driving research UIs.\n\n![LiDAR point cloud](https://raw.githubusercontent.com/JayaSaiKishanChapparam/altara/main/apps/storybook/public/gifs/av-lidar.gif)\n\n[![npm version](https://img.shields.io/npm/v/@altara/av?color=D946EF&label=npm)](https://www.npmjs.com/package/@altara/av)\n[![bundle size](https://img.shields.io/bundlephobia/minzip/@altara/av?color=378ADD&label=gzip)](https://bundlephobia.com/package/@altara/av)\n[![types included](https://img.shields.io/badge/types-included-1D9E75)](https://www.npmjs.com/package/@altara/av)\n[![license](https://img.shields.io/npm/l/@altara/av?color=888780)](https://github.com/JayaSaiKishanChapparam/altara/blob/main/LICENSE)\n\n## Install\n\n```bash\nnpm install @altara/core @altara/av\n# Three.js is required only if you use LiDARPointCloud — it's an optional peer dep:\nnpm install three\n```\n\nImport the design-token stylesheet from `@altara/core` once at your app root:\n\n```ts\nimport '@altara/core/styles.css';\n```\n\n## Quick start\n\n```tsx\nimport { AltaraProvider } from '@altara/core';\nimport { LiDARPointCloud, OccupancyGrid, ControlTrace } from '@altara/av';\n\nexport function AvDashboard() {\n return (\n \n \n \n \n \n );\n}\n```\n\n**See it live:** [Website](https://www.usealtara.dev/) · [Live demo](https://jayasaikishanchapparam.github.io/altara/demo/) · [Storybook](https://jayasaikishanchapparam.github.io/altara/storybook/)\n\n## Components\n\n| Component | Description |\n| --- | --- |\n| `LiDARPointCloud` | Three.js BufferGeometry + Points renderer. Color modes: intensity, height, return, flat. Camera presets: top, iso, follow. |\n| `OccupancyGrid` | 2D overhead occupancy-grid renderer with vehicle pose, goal marker, and planned-path overlay. |\n| `ObjectDetectionOverlay` | Bounding-box overlay with class labels + confidence scores for YOLO/SSD-style detections. |\n| `PathPlannerOverlay` | Top-down planned vs actual trajectory with deviation corridor and live cross-track-error readout. |\n| `VelocityVectorDisplay` | SVG vehicle diagram with linear-velocity arrow + angular-velocity arc. |\n| `PerceptionStateMachine` | SVG node graph of the perception pipeline with per-module status + latency. |\n| `SensorHealthMatrix` | Grid of sensor-health tiles — name, topic, expected rate, age, status. |\n| `CameraFeed` | Canvas image renderer with overlay slot (crosshair, grid, bounding box). |\n| `ControlTrace` | Three vertically stacked time-series for throttle, brake, steering. |\n| `RadarSweep` | PPI radar sweep with rotating wedge and decaying target dots. |\n| `SLAMMap` | Occupancy grid + pose-graph overlay with loop-closure highlighting. |\n\n## Showcase\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n\"Occupancy
\nOccupancyGrid\n		\n\"SLAM
\nSLAMMap\n
\n\"Radar
\nRadarSweep\n		\n\"Perception
\nPerceptionStateMachine\n
\n\"Control
\nControlTrace — throttle / brake / steering\n
\n\n## Three.js — optional\n\n`LiDARPointCloud` is the only component that needs `three`. It's loaded via dynamic `import('three')` so:\n\n- The other ten components work without `three` installed.\n- If `three` is missing when `LiDARPointCloud` mounts, the component renders a placeholder telling the user to `npm install three` — your app keeps running.\n\nThe package's tsup build externalises `three`, so you control which version your app pins.\n\n## Data sources\n\nEvery component accepts an `AltaraDataSource` from `@altara/core`. Pair with [`@altara/ros`](https://www.npmjs.com/package/@altara/ros) to wire `sensor_msgs/PointCloud2` into `LiDARPointCloud`, `nav_msgs/OccupancyGrid` into `OccupancyGrid`, and `vision_msgs/Detection2DArray` into `ObjectDetectionOverlay`. Or use [`@altara/mqtt`](https://www.npmjs.com/package/@altara/mqtt) for broker-published telemetry.\n\n## Documentation\n\n- **[📚 Storybook](https://jayasaikishanchapparam.github.io/altara/storybook/)** — open the **AV/** section for Default + variant stories per component, props in Controls, dark/light theme toggle.\n- **[🛰️ Live demo](https://jayasaikishanchapparam.github.io/altara/demo/)** — Autonomous Vehicle tab (LiDAR, occupancy grid, radar, control trace, perception).\n\nOr run them locally:\n\n```bash\ngit clone https://github.com/JayaSaiKishanChapparam/altara.git\ncd altara\npnpm install\npnpm --filter @altara/storybook storybook # http://localhost:6006\npnpm --filter @altara/demo dev # http://localhost:5173\n```\n\n## Sibling packages\n\n| Package | What it does |\n| --- | --- |\n| [`@altara/core`](https://www.npmjs.com/package/@altara/core) | Components, hooks, MQTT/mock adapters, design tokens. The starting point. |\n| [`@altara/aerospace`](https://www.npmjs.com/package/@altara/aerospace) | Flight instruments — PFD, HSI, altimeter, airspeed, VSI, engine cluster, TCAS, TAWS, FMA, fuel gauge, radio altimeter. |\n| [`@altara/ros`](https://www.npmjs.com/package/@altara/ros) | ROS2 / rosbridge adapter + typed factories for common `sensor_msgs/*` message types. |\n| [`@altara/mqtt`](https://www.npmjs.com/package/@altara/mqtt) | MQTT-over-WebSocket adapter for IoT brokers. |\n\n## Links\n\n- [Storybook (live)](https://jayasaikishanchapparam.github.io/altara/storybook/) · [Demo dashboard (live)](https://jayasaikishanchapparam.github.io/altara/demo/)\n- [GitHub repository](https://github.com/JayaSaiKishanChapparam/altara)\n- [Issue tracker](https://github.com/JayaSaiKishanChapparam/altara/issues)\n- [Discussions](https://github.com/JayaSaiKishanChapparam/altara/discussions)\n- [Three.js](https://threejs.org/) — the rendering engine behind `LiDARPointCloud`\n\n## Stability\n\n**Pre-1.0.** Every package is below `1.0.0`, and until one reaches it the public\nAPI is not considered stable:\n\n- **Patch** (`0.2.1` -> `0.2.2`) — bug fixes, docs, packaging. Safe.\n- **Minor** (`0.2.x` -> `0.3.0`) — new features, and **may include breaking\n changes**. This is the pre-1.0 semver allowance, not an accident. Pin the\n minor (`~0.2.0`) if you need that not to happen.\n- Breaking changes are always described in the package's\n [CHANGELOG](CHANGELOG.md); anything spanning packages also lands in\n [MIGRATION.md](https://github.com/JayaSaiKishanChapparam/altara/blob/main/MIGRATION.md).\n\nIn practice the component APIs have been stable since `0.1.0` and every break so\nfar has been in the adapter layer. That is a track record, not a guarantee.\n\n## License\n\nMIT — see [LICENSE](https://github.com/JayaSaiKishanChapparam/altara/blob/main/LICENSE).\n","readmeFilename":"README.md"}