@geolonia/maps-core 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Geolonia Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,135 @@
+# @geolonia/maps-core
+
+Core library for Geolonia Maps. Extends [MapLibre GL JS](https://maplibre.org/) with Geolonia Maps platform integration.
+
+Designed to be side-effect-free and DOM-independent, serving as the shared foundation for downstream packages such as maps-embed and maps-react.
+
+## Install
+
+```bash
+npm install @geolonia/maps-core maplibre-gl
+```
+
+`maplibre-gl` is a peer dependency.
+
+## Usage
+
+```typescript
+import 'maplibre-gl/dist/maplibre-gl.css';
+import '@geolonia/maps-core/css';
+import { GeoloniaMap } from '@geolonia/maps-core';
+
+const map = new GeoloniaMap({
+  container: '#map',
+  apiKey: 'YOUR-API-KEY',
+  style: 'geolonia/basic-v2',
+  center: [139.7671, 35.6812],
+  zoom: 14,
+});
+```
+
+### Using External Styles Without API Key
+
+```typescript
+const map = new GeoloniaMap({
+  container: '#map',
+  style: 'https://tile.openstreetmap.jp/styles/osm-bright/style.json',
+  center: [139.7671, 35.6812],
+  zoom: 14,
+});
+```
+
+Geolonia API key is only required when using Geolonia's hosted styles and tiles.
+
+## API
+
+### `GeoloniaMap`
+
+Extends `maplibregl.Map`. Accepts `GeoloniaMapOptions`.
+
+```typescript
+const map = new GeoloniaMap({
+  container: '#map',           // HTMLElement or CSS selector
+  apiKey: 'YOUR-API-KEY',      // Geolonia API key
+  style: 'geolonia/basic-v2',  // Style name or URL
+  center: [139.77, 35.68],     // [lng, lat]
+  zoom: 12,
+
+  // All optional
+  lang: 'auto',                 // 'ja' | 'en' | 'auto'
+  stage: 'v1',                  // 'dev' | 'v1'
+  marker: true,                 // Show default marker at center
+  markerColor: '#E4402F',
+  openPopup: false,             // Auto-open marker popup
+  customMarker: '#my-marker',   // CSS selector for custom marker element
+  customMarkerOffset: [0, -15],
+  loader: true,                 // Loading animation
+  gestureHandling: true,        // Gesture control on scrollable pages
+  navigationControl: true,      // true | false | 'top-right' etc.
+  geolocateControl: false,
+  fullscreenControl: false,
+  scaleControl: false,
+  geoloniaControl: true,        // Geolonia logo
+  geojson: 'https://example.com/data.geojson',
+  cluster: true,
+  clusterColor: '#ff0000',
+  simpleVector: 'my-tileset',   // Vector tile URL or tileset ID
+  '3d': false,
+});
+```
+
+### `GeoloniaMarker`
+
+Extends `maplibregl.Marker` with Geolonia's default marker style.
+
+```typescript
+import { GeoloniaMarker } from '@geolonia/maps-core';
+
+new GeoloniaMarker({ color: '#0066FF' })
+  .setLngLat([139.77, 35.68])
+  .addTo(map);
+```
+
+### `SimpleStyle`
+
+GeoJSON visualization based on [simplestyle-spec](https://github.com/mapbox/simplestyle-spec).
+
+```typescript
+import { SimpleStyle } from '@geolonia/maps-core';
+
+const ss = new SimpleStyle(geojson, { cluster: true });
+ss.addTo(map).fitBounds();
+```
+
+### `keyring`
+
+API key and stage management.
+
+```typescript
+import { keyring } from '@geolonia/maps-core';
+
+keyring.setApiKey('YOUR-API-KEY');
+keyring.setStage('v1');
+```
+
+## Related Packages
+
+| Package | Description |
+|---------|-------------|
+| `@geolonia/maps-embed` | HTML `data-*` attribute map embedding |
+| `@geolonia/maps-react` | React components |
+
+## Development
+
+```bash
+npm install
+npm run build     # ESM + CJS + DTS
+npm run test      # Vitest unit tests
+npm run e2e       # Playwright E2E tests
+npm run lint      # Biome
+npm run dev       # Vite dev server (example/)
+```
+
+## License
+
+MIT