v1.0.0

1.0.0 (2026-01-17)

⚠ BREAKING CHANGES

• telemetry requires POSTHOG_API_KEY env var to be set

Co-Authored-By: Claude Opus 4.5 noreply@anthropic.com

Features

• add infrastructure layer, popup, legend, formatters and presets (7e58049)

Bug Fixes

• ci: disable body-max-line-length for semantic-release compatibility (83d1685)
• ci: use gh_token for semantic-release to bypass branch protection (5485066)
• use environment variable for posthog api key (1ea2809)

v0.1.0 - Initial Release

Features

• Map3D Core: Deck.gl + MapLibre hybrid architecture for high-performance 3D maps
• Multi-Level Visualization: Support from -50m (underground) to +200m (skyscrapers)
• Layer Types: ZoningLayer, BuildingLayer, SubsurfaceLayer with GeoJSON support
• ElevationController: Programmatic control of visible elevation range
• Elevation Presets: subsurface, surface, buildings, all
• Framework Agnostic: Works with React, Vue, Angular, or Vanilla JS
• TypeScript: Full type definitions included
• Telemetry: Optional PostHog integration for anonymous usage analytics

Performance

• 60fps with 100k+ features
• Layer creation: ~2M ops/sec
• Elevation filtering: ~0.35ms for 10k features

Documentation

• README with examples for all frameworks
• ARCHITECTURE.md with technical diagrams
• LLMS.txt for AI agent integration
• Live Demo

Installation

```bash
npm install @raphaeltorquat0/map-3d-deck maplibre-gl
```

Quick Start

```typescript
import { Map3D, createZoningLayer } from '@raphaeltorquat0/map-3d-deck'

const map = new Map3D({
container: 'map',
initialViewState: {
longitude: -74.006,
latitude: 40.7128,
zoom: 12,
pitch: 45,
}
})

map.addLayer(createZoningLayer({
id: 'zoning',
data: zoningGeoJSON,
extruded: true,
}))
```