@craft-native/ts-maps 0.0.92 → 0.0.95

package/dist/FilesystemTileBackend.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Filesystem-backed tile persistence for `ts-maps` `TileCache`.
+ *
+ * Wraps Craft's `fs` bridge (which transparently falls back to `node:fs`
+ * when running outside a Craft WebView) so that tile bytes for an
+ * offline region are written to an app-sandboxed directory rather than
+ * IndexedDB. Returned objects plug straight into `TileCache` via its
+ * `backend` option.
+ *
+ * Each cached tile is serialised as a single `.tsm` file containing:
+ *
+ *   magic      4 bytes    "TSMT"
+ *   version    1 byte     0x01
+ *   keyLen     4 bytes    little-endian uint32
+ *   mimeLen    4 bytes    little-endian uint32
+ *   reservedLen 4 bytes   little-endian uint32 (0)
+ *   addedAt    8 bytes    little-endian float64 (ms epoch)
+ *   reserved   8 bytes    little-endian float64 (0)
+ *   dataLen    4 bytes    little-endian uint32
+ *   key        keyLen bytes  UTF-8
+ *   mime       mimeLen bytes UTF-8
+ *   data       dataLen bytes payload
+ *
+ * Filenames are `<hash>.tsm` where `<hash>` is a 64-bit FNV-1a of the
+ * URL (two 32-bit passes with different seeds) rendered in base36. That
+ * keeps filenames short, URL-safe, and collision-resistant enough for
+ * the tile counts an offline region realistically produces.
+ *
+ * @module @craft-native/ts-maps/FilesystemTileBackend
+ */
+import type { TileCacheBackend } from 'ts-maps';
+export interface FilesystemBackendOptions {
+    /**
+     * Directory where tile files are stored. Created on first write if it
+     * doesn't exist. On Craft apps this is typically something like
+     * `app.dataDir + '/tiles'` — the caller resolves the platform-specific
+     * path and passes it in.
+     */
+    baseDir: string;
+}
+/**
+ * Construct a {@link TileCacheBackend} that persists tiles under `baseDir`.
+ * Pass the returned object to `new TileCache({ backend })` (or to the
+ * cache used by `saveOfflineRegion`).
+ */
+export declare function createFilesystemBackend(opts: FilesystemBackendOptions): TileCacheBackend;
+//# sourceMappingURL=FilesystemTileBackend.d.ts.map

package/dist/FilesystemTileBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilesystemTileBackend.d.ts","sourceRoot":"","sources":["../../../src/FilesystemTileBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAQ,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAMrD,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB;AAMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG,gBAAgB,CA+FxF"}

package/dist/MapView.d.ts

@@ -0,0 +1,91 @@
+/**
+ * `MapView` — Craft-native interactive map component backed by the
+ * ts-maps runtime. Instances are WebView-hosted; in native Craft apps
+ * the Zig core drives them via the `ts_maps` bridge namespace.
+ *
+ * @module @craft-native/ts-maps/MapView
+ */
+import type { TsMap } from 'ts-maps';
+import type { Coordinate, MapCamera, MapCircle, MapConfiguration, MapMarker, MapPolygon, MapPolyline, MapRegion } from './types.js';
+/** Subset of Craft's `ComponentProps` duplicated here to keep runtime deps minimal. */
+export interface ComponentProps {
+    /** Explicit component id — auto-generated if omitted. */
+    id?: string;
+    /** CSS class applied to the container `<div>`. */
+    className?: string;
+    /** Inline styles applied to the container. */
+    style?: Partial<CSSStyleDeclaration>;
+    /** Hidden state. */
+    hidden?: boolean;
+    /** Accessible tooltip. */
+    tooltip?: string;
+}
+/** Props accepted by {@link createMapView}. */
+export interface MapViewProps extends ComponentProps {
+    /** Map configuration; defaults to {@link defaultMapConfiguration}. */
+    configuration?: MapConfiguration;
+    /** Initial camera position; defaults to {@link defaultMapCamera}. */
+    initialCamera?: MapCamera;
+    /** Markers to render on first mount. */
+    markers?: MapMarker[];
+    /** Polylines to render on first mount. */
+    polylines?: MapPolyline[];
+    /** Polygons to render on first mount. */
+    polygons?: MapPolygon[];
+    /** Circles to render on first mount. */
+    circles?: MapCircle[];
+    /** Optional tile URL template. Defaults to OSM. */
+    tileUrl?: string;
+    /** Optional tile attribution string. */
+    tileAttribution?: string;
+    /** Called when the user taps the map background. */
+    onTap?: (coordinate: Coordinate) => void;
+    /** Called when a marker is tapped. */
+    onMarkerTap?: (markerId: number, coordinate: Coordinate) => void;
+    /** Called when the visible region changes (after the user pans/zooms). */
+    onRegionChanged?: (region: MapRegion) => void;
+    /** Called when the camera changes (zoom / bearing / pitch). */
+    onCameraChanged?: (camera: MapCamera) => void;
+}
+/** Instance returned by {@link createMapView}. */
+export interface MapViewInstance {
+    /** Unique id — also used as the bridge component id. */
+    id: string;
+    /** DOM container hosting the ts-maps canvas. */
+    container: HTMLDivElement;
+    /** Underlying ts-maps instance. */
+    map: TsMap;
+    /** Current configuration. */
+    configuration: MapConfiguration;
+    /** Move the camera. */
+    setCamera: (camera: MapCamera, animated?: boolean) => void;
+    /** Fit the viewport to a region. */
+    setRegion: (region: MapRegion, animated?: boolean) => void;
+    /** Add a marker; returns its id. */
+    addMarker: (marker: MapMarker) => number;
+    /** Remove a marker by id. */
+    removeMarker: (id: number) => boolean;
+    /** Add a polyline; returns its id. */
+    addPolyline: (polyline: MapPolyline) => number;
+    /** Add a polygon; returns its id. */
+    addPolygon: (polygon: MapPolygon) => number;
+    /** Add a circle; returns its id. */
+    addCircle: (circle: MapCircle) => number;
+    /** Fit the map to all currently-rendered markers. */
+    fitToMarkers: (paddingPercent?: number) => void;
+    /** Select a marker by id. */
+    selectMarker: (id: number) => void;
+    /** Deselect all markers. */
+    deselectAll: () => void;
+    /** Update the configuration. */
+    setConfiguration: (configuration: MapConfiguration) => void;
+    /** Detach event listeners and remove the map from the DOM. */
+    destroy: () => void;
+}
+/**
+ * Create a `MapView`. The returned {@link MapViewInstance} owns a DOM
+ * container — append it to the page yourself; this factory never mounts it
+ * for you so consumers stay in control of layout.
+ */
+export declare function createMapView(props?: MapViewProps): MapViewInstance;
+//# sourceMappingURL=MapView.d.ts.map

package/dist/MapView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapView.d.ts","sourceRoot":"","sources":["../../../src/MapView.ts"],"names":[],"mappings":"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"}

package/dist/adapters.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Pure conversion functions between Craft's Zig-mirrored map types and
+ * the runtime objects used by the ts-maps library. These are deliberately
+ * side-effect-free so they can be unit-tested without a DOM.
+ *
+ * @module @craft-native/ts-maps/adapters
+ */
+import { Circle, Marker, Polygon, Polyline } from 'ts-maps';
+import { LatLng, LatLngBounds } from 'ts-maps';
+import type { BoundingBox, Coordinate, MapCamera, MapCircle, MapMarker, MapPolygon, MapPolyline, MapRegion } from './types.js';
+/** Convert a Craft `Coordinate` to a ts-maps `LatLng`. */
+export declare function craftCoordToLatLng(coord: Coordinate): LatLng;
+/** Convert a ts-maps `LatLng` back to a Craft `Coordinate`. */
+export declare function latLngToCraftCoord(ll: LatLng): Coordinate;
+/** Convert a Craft `MapRegion` (center + span) to a ts-maps `LatLngBounds`. */
+export declare function craftRegionToBounds(region: MapRegion): LatLngBounds;
+/** Convert a Craft `BoundingBox` to a ts-maps `LatLngBounds`. */
+export declare function craftBoundingBoxToBounds(box: BoundingBox): LatLngBounds;
+/**
+ * Convert a ts-maps `LatLngBounds` back to a Craft `MapRegion`. Useful when
+ * translating `moveend` events into `regionChanged` bridge events.
+ */
+export declare function boundsToCraftRegion(bounds: LatLngBounds): MapRegion;
+/**
+ * ts-maps `setView()` / `easeTo()` option shape. Pulled out so the MapView
+ * wrapper and consumers can pass the exact object through without guessing
+ * field names.
+ */
+export interface TsMapsCameraOptions {
+    center: LatLng;
+    zoom: number;
+    bearing: number;
+    pitch: number;
+}
+/** Convert a Craft `MapCamera` to a ts-maps-style camera options object. */
+export declare function craftCameraToOptions(cam: MapCamera): TsMapsCameraOptions;
+/**
+ * Alias matching the name requested in the SDK spec. Kept distinct from
+ * `craftCameraToOptions` in case the upstream runtime ever needs a
+ * different shape for `cameraTo…` vs `…ToOptions`.
+ */
+export declare function cameraToCamera(cam: MapCamera): TsMapsCameraOptions;
+/**
+ * Convert a Craft `MapMarker` to a ts-maps `Marker`. The returned marker
+ * has not yet been added to a map — the caller is responsible for calling
+ * `marker.addTo(map)`.
+ */
+export declare function craftMarkerToMarker(m: MapMarker): Marker;
+/** Convert a Craft `MapPolyline` to a ts-maps `Polyline`. */
+export declare function craftPolylineToPolyline(pl: MapPolyline): Polyline;
+/** Convert a Craft `MapPolygon` to a ts-maps `Polygon`. */
+export declare function craftPolygonToPolygon(pg: MapPolygon): Polygon;
+/** Convert a Craft `MapCircle` to a ts-maps `Circle`. */
+export declare function craftCircleToCircle(c: MapCircle): Circle;
+/**
+ * Build a Craft `MapRegion` from the bounds of an array of coordinates.
+ * Mirrors `BoundingBox.fromCoordinates(...).toRegion()` in `maps.zig`.
+ */
+export declare function regionFromBounds(coords: Coordinate[]): MapRegion | null;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,EACV,MAAM,YAAY,CAAA;AAOnB,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE5D;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEzD;AAMD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY,CAOnE;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAKvE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAmBnE;AAMD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,GAAG,mBAAmB,CAOxE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,mBAAmB,CAElE;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAexD;AAED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,WAAW,GAAG,QAAQ,CAUjE;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAc7D;AAED,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAUxD;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,GAAG,IAAI,CAyBvE"}