@craft-native/ts-maps 0.0.92 → 0.0.94

package/dist/bridge-protocol.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Shared protocol constants and types for the bridge between the Zig
+ * `MapView` core and the ts-maps runtime.
+ *
+ * @module @craft-native/ts-maps/bridge-protocol
+ */
+import type { Coordinate, MapCamera, MapCircle, MapConfiguration, MapMarker, MapPolygon, MapPolyline, MapRegion } from './types.js';
+/**
+ * Namespace used when emitting and listening for bridge messages. Matches
+ * the Zig enum tag for `MapProvider.ts_maps`.
+ */
+export declare const BRIDGE_NAMESPACE: 'ts_maps';
+/** Method names the Zig core can invoke on the TypeScript side. */
+export type MapBridgeMethod = 'setCamera' | 'setRegion' | 'addMarker' | 'removeMarker' | 'addPolyline' | 'addPolygon' | 'addCircle' | 'fitToMarkers' | 'selectMarker' | 'deselectAll' | 'setConfiguration';
+/**
+ * Typed request envelope. The `method` discriminates the `params` shape.
+ * The union below gives per-method type narrowing.
+ */
+export interface MapBridgeRequest {
+    method: MapBridgeMethod;
+    params: Record<string, unknown>;
+}
+/** Strongly typed request variants for each supported method. */
+export type TypedMapBridgeRequest = {
+    method: 'setCamera';
+    params: {
+        camera: MapCamera;
+        animated?: boolean;
+    };
+} | {
+    method: 'setRegion';
+    params: {
+        region: MapRegion;
+        animated?: boolean;
+    };
+} | {
+    method: 'addMarker';
+    params: {
+        marker: MapMarker;
+    };
+} | {
+    method: 'removeMarker';
+    params: {
+        id: number;
+    };
+} | {
+    method: 'addPolyline';
+    params: {
+        polyline: MapPolyline;
+    };
+} | {
+    method: 'addPolygon';
+    params: {
+        polygon: MapPolygon;
+    };
+} | {
+    method: 'addCircle';
+    params: {
+        circle: MapCircle;
+    };
+} | {
+    method: 'fitToMarkers';
+    params: {
+        padding?: number;
+    };
+} | {
+    method: 'selectMarker';
+    params: {
+        id: number;
+    };
+} | {
+    method: 'deselectAll';
+    params: Record<string, never>;
+} | {
+    method: 'setConfiguration';
+    params: {
+        configuration: MapConfiguration;
+    };
+};
+/** Events emitted by the ts-maps runtime back to the Zig core. */
+export type MapBridgeEvent = {
+    type: 'tap';
+    coordinate: Coordinate;
+} | {
+    type: 'markerTap';
+    markerId: number;
+    coordinate: Coordinate;
+} | {
+    type: 'regionChanged';
+    region: MapRegion;
+} | {
+    type: 'cameraChanged';
+    camera: MapCamera;
+};
+/**
+ * Build the full event name used on the bridge (e.g. `map:tap`).
+ * Centralized so both sides agree on the exact string.
+ */
+export declare function mapEventName(type: MapBridgeEvent['type']): string;
+//# sourceMappingURL=bridge-protocol.d.ts.map

package/dist/bridge-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-protocol.d.ts","sourceRoot":"","sources":["../../../src/bridge-protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,EACV,MAAM,YAAY,CAAA;AAEnB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAG,SAAkB,CAAA;AAElD,mEAAmE;AACnE,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,WAAW,GACX,WAAW,GACX,cAAc,GACd,aAAa,GACb,YAAY,GACZ,WAAW,GACX,cAAc,GACd,cAAc,GACd,aAAa,GACb,kBAAkB,CAAA;AAEtB;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAA;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,iEAAiE;AACjE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC1E;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC1E;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,CAAA;CAAE,GACtD;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,WAAW,CAAA;KAAE,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,CAAA;CAAE,GACzD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,CAAA;CAAE,GACtD;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE;QAAE,aAAa,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAAE,CAAA;AAE/E,kEAAkE;AAClE,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAA;AAEhD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM,CAEjE"}

package/dist/bridge-protocol.js

@@ -0,0 +1,17 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/bridge-protocol.ts
+var BRIDGE_NAMESPACE = "ts_maps";
+function mapEventName(type) {
+  return `map:${type}`;
+}
+export {
+  mapEventName,
+  BRIDGE_NAMESPACE
+};

package/dist/capabilities.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Runtime capability probe for Craft apps hosting `ts-maps` inside a
+ * WebView. The map renderer prefers WebGL2 and falls back to Canvas2D
+ * when it isn't available; this helper exposes the probe so the host
+ * app can pick the right renderer up front (and surface the decision to
+ * users on older devices).
+ *
+ * All checks are side-effect-free and safe to call during render: the
+ * probe creates a throw-away canvas, asks for the relevant context, and
+ * discards it.
+ *
+ * @module @craft-native/ts-maps/capabilities
+ */
+export interface MapRendererCapabilities {
+    /** WebGL2 context is obtainable. */
+    webgl2: boolean;
+    /** WebGL1 context is obtainable (fallback). */
+    webgl1: boolean;
+    /** `OffscreenCanvas` exists on the global scope. */
+    offscreenCanvas: boolean;
+    /** `navigator.hardwareConcurrency` — tile-worker parallelism hint. */
+    hardwareConcurrency: number;
+    /** `window.devicePixelRatio` — retina-like displays report >1. */
+    devicePixelRatio: number;
+    /** Pointer events are supported (required for the two-finger gestures). */
+    pointerEvents: boolean;
+    /** Touch events are supported (used as a pointer-event fallback). */
+    touchEvents: boolean;
+    /** Best renderer given the probe result. */
+    preferredRenderer: 'webgl' | 'canvas2d';
+}
+/**
+ * Probe the host runtime. Safe to call in any environment — when neither
+ * `window` nor `document` is available (Node / SSR) the probe returns a
+ * conservative zero-capabilities object.
+ */
+export declare function probeCapabilities(): MapRendererCapabilities;
+/**
+ * True when the probe thinks this host can run the WebGL-backed renderer
+ * comfortably. Callers typically use this to gate advanced features like
+ * fill-extrusion or hillshade on cheap older phones.
+ */
+export declare function supportsAdvancedRendering(caps?: MapRendererCapabilities): boolean;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,MAAM,EAAE,OAAO,CAAA;IACf,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAA;IACf,oDAAoD;IACpD,eAAe,EAAE,OAAO,CAAA;IACxB,sEAAsE;IACtE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAA;IACxB,2EAA2E;IAC3E,aAAa,EAAE,OAAO,CAAA;IACtB,qEAAqE;IACrE,WAAW,EAAE,OAAO,CAAA;IACpB,4CAA4C;IAC5C,iBAAiB,EAAE,OAAO,GAAG,UAAU,CAAA;CACxC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAkD3D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAGjF"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `@craft-native/ts-maps` — SDK binding that lets Craft apps render
+ * interactive maps via the in-house `ts-maps` runtime. Pairs with the
+ * `MapProvider.ts_maps` variant in `packages/zig/src/maps.zig`.
+ *
+ * Re-exports the full ts-maps public API plus Craft-native helpers
+ * (`createMapView`, type mirrors, adapters, bridge protocol).
+ *
+ * @module @craft-native/ts-maps
+ */
+export * from 'ts-maps';
+export { createMapView, type ComponentProps, type MapViewInstance, type MapViewProps, } from './MapView.js';
+export { defaultMapCamera, defaultMapConfiguration, markerColorHex, strokePatternDashes, type BoundingBox, type Coordinate, type CoordinateSpan, type MapCamera, type MapCircle, type MapConfiguration, type MapEvent, type MapMarker, type MapPolygon, type MapPolyline, type MapProvider, type MapRegion, type MapType, type MarkerColor, type StrokePattern, type UserTrackingMode, } from './types.js';
+export { boundsToCraftRegion, cameraToCamera, craftBoundingBoxToBounds, craftCameraToOptions, craftCircleToCircle, craftCoordToLatLng, craftMarkerToMarker, craftPolygonToPolygon, craftPolylineToPolyline, craftRegionToBounds, latLngToCraftCoord, regionFromBounds, type TsMapsCameraOptions, } from './adapters.js';
+export { BRIDGE_NAMESPACE, mapEventName, type MapBridgeEvent, type MapBridgeMethod, type MapBridgeRequest, type TypedMapBridgeRequest, } from './bridge-protocol.js';
+export { createFilesystemBackend, type FilesystemBackendOptions, } from './FilesystemTileBackend.js';
+export { createFilesystemTileCache, saveOfflineRegionToFilesystem, type FilesystemOfflineRegionOptions, } from './offlineRegion.js';
+export { probeCapabilities, supportsAdvancedRendering, type MapRendererCapabilities, } from './capabilities.js';
+export { createMap } from 'ts-maps';
+/**
+ * Provider tag matching `MapProvider.ts_maps` in the Zig core. Useful when
+ * building a `MapConfiguration` programmatically without magic strings.
+ */
+export declare const tsMapsProvider: 'ts_maps';
+/**
+ * Alias preserved for callers that imported the two helpers by spec name.
+ * `coordinateFromLatLng(LatLng) -> Coordinate`, `latLngFromCoordinate(Coordinate) -> LatLng`.
+ */
+export { latLngToCraftCoord as coordinateFromLatLng } from './adapters.js';
+export { craftCoordToLatLng as latLngFromCoordinate } from './adapters.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,cAAc,SAAS,CAAA;AAGvB,OAAO,EACL,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,KAAK,8BAA8B,GACpC,MAAM,oBAAoB,CAAA;AAI3B,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEnC;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAG,SAAkB,CAAA;AAEhD;;;GAGG;AACH,OAAO,EAAE,kBAAkB,IAAI,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,EAAE,kBAAkB,IAAI,oBAAoB,EAAE,MAAM,eAAe,CAAA"}