@craft-native/ts-maps 0.0.91 → 0.0.94

package/dist/offlineRegion.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Thin Craft-specific wrapper around ts-maps' `saveOfflineRegion` that
+ * writes tile bytes to the app's sandboxed filesystem via the
+ * {@link createFilesystemBackend} adapter.
+ *
+ * Typical usage from a Craft app:
+ *
+ *   ```ts
+ *   import { saveOfflineRegionToFilesystem } from '@craft-native/ts-maps'
+ *   import { app } from 'craft-native'
+ *
+ *   await saveOfflineRegionToFilesystem({
+ *     baseDir: `${await app.dataDir()}/tiles`,
+ *     tileUrl: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png',
+ *     bounds: mapViewBounds,
+ *     zoomRange: [10, 14],
+ *   })
+ *   ```
+ *
+ * The download runs with bounded concurrency and respects `AbortSignal`,
+ * so a user canceling the region pre-cache tears the job down cleanly.
+ *
+ * @module @craft-native/ts-maps/offlineRegion
+ */
+import type { OfflineRegionResult, TileCacheOptions } from 'ts-maps';
+import { TileCache } from 'ts-maps';
+export type OfflineBoundsLike = {
+    west: number;
+    south: number;
+    east: number;
+    north: number;
+} | readonly [west: number, south: number, east: number, north: number];
+export interface OfflineProgressEmitter {
+    fire: (type: string, data?: Record<string, unknown>) => unknown;
+}
+export interface FilesystemOfflineRegionOptions {
+    /** Sandbox directory for tile files. Created on first write. */
+    baseDir: string;
+    /** Tile URL template — `{z}/{x}/{y}` placeholders are substituted. */
+    tileUrl: string;
+    bounds: OfflineBoundsLike;
+    zoomRange: [minZ: number, maxZ: number];
+    concurrency?: number;
+    signal?: AbortSignal;
+    /** Optional overrides for the `TileCache` wrapping the filesystem backend. */
+    cacheOptions?: Omit<TileCacheOptions, 'backend'>;
+}
+/**
+ * Pre-download every tile inside `bounds` across `zoomRange` and persist
+ * it to disk under `baseDir`. Returns counts of saved / cached-already /
+ * failed tiles.
+ */
+export declare function saveOfflineRegionToFilesystem(opts: FilesystemOfflineRegionOptions, emitter?: OfflineProgressEmitter): Promise<OfflineRegionResult>;
+/**
+ * Build a standalone {@link TileCache} whose persistence layer is the
+ * Craft sandbox filesystem. Useful when a map instance needs to serve
+ * pre-saved tiles at runtime (not just pre-download them).
+ */
+export declare function createFilesystemTileCache(baseDir: string, cacheOptions?: Omit<TileCacheOptions, 'backend'>): TileCache;
+//# sourceMappingURL=offlineRegion.d.ts.map

package/dist/offlineRegion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offlineRegion.d.ts","sourceRoot":"","sources":["../../../src/offlineRegion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAqB,SAAS,EAAE,MAAM,SAAS,CAAA;AAGtD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;AAEvE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAA;CAChE;AAED,MAAM,WAAW,8BAA8B;IAC7C,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,iBAAiB,CAAA;IACzB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAA;CACjD;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,8BAA8B,EACpC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAgB9B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GAC/C,SAAS,CAKX"}

package/dist/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * TypeScript mirrors of the Craft Zig map types defined in
+ * `packages/zig/src/maps.zig`. Field names match the Zig struct field names
+ * exactly so a straight `JSON.stringify` round-trips cleanly across the
+ * bridge without a renaming layer.
+ *
+ * @module @craft-native/ts-maps/types
+ */
+/**
+ * Matches `MapProvider` in `maps.zig`. String-literal union so JSON
+ * serialization emits the Zig enum tag name directly.
+ */
+export type MapProvider = 'apple_maps' | 'google_maps' | 'mapbox' | 'openstreetmap' | 'here_maps' | 'ts_maps';
+/** Matches `MapType` in `maps.zig`. */
+export type MapType = 'standard' | 'satellite' | 'hybrid' | 'terrain' | 'muted_standard' | 'satellite_flyover' | 'hybrid_flyover';
+/** Matches `UserTrackingMode` in `maps.zig`. */
+export type UserTrackingMode = 'none' | 'follow' | 'follow_with_heading';
+/** Matches `MarkerColor` in `maps.zig`. */
+export type MarkerColor = 'red' | 'green' | 'blue' | 'yellow' | 'orange' | 'purple' | 'cyan' | 'magenta';
+/** Matches `StrokePattern` in `maps.zig`. */
+export type StrokePattern = 'solid' | 'dashed' | 'dotted' | 'dash_dot';
+/** Matches `MapEvent` in `maps.zig`. */
+export type MapEvent = 'region_changed' | 'region_will_change' | 'did_finish_loading' | 'did_fail_loading' | 'annotation_selected' | 'annotation_deselected' | 'annotation_drag_started' | 'annotation_dragged' | 'annotation_drag_ended' | 'user_location_updated' | 'camera_changed' | 'tap' | 'long_press' | 'poi_selected';
+/** Matches `Coordinate` in `maps.zig`. */
+export interface Coordinate {
+    latitude: number;
+    longitude: number;
+}
+/** Matches `CoordinateSpan` in `maps.zig`. */
+export interface CoordinateSpan {
+    latitude_delta: number;
+    longitude_delta: number;
+}
+/** Matches `MapRegion` in `maps.zig`. */
+export interface MapRegion {
+    center: Coordinate;
+    span: CoordinateSpan;
+}
+/** Matches `BoundingBox` in `maps.zig`. */
+export interface BoundingBox {
+    south_west: Coordinate;
+    north_east: Coordinate;
+}
+/** Matches `MapCamera` in `maps.zig`. */
+export interface MapCamera {
+    center: Coordinate;
+    zoom: number;
+    pitch: number;
+    heading: number;
+}
+/** Matches `MapMarker` in `maps.zig`. */
+export interface MapMarker {
+    id: number;
+    coordinate: Coordinate;
+    title: string | null;
+    subtitle: string | null;
+    color: MarkerColor;
+    is_draggable: boolean;
+    is_selected: boolean;
+    custom_icon: string | null;
+    anchor_x: number;
+    anchor_y: number;
+}
+/** Matches `MapPolyline` in `maps.zig` (flattened: `coordinates` is a plain array). */
+export interface MapPolyline {
+    id: number;
+    coordinates: Coordinate[];
+    stroke_color: MarkerColor;
+    stroke_width: number;
+    stroke_pattern: StrokePattern;
+    is_geodesic: boolean;
+    z_index: number;
+}
+/** Matches `MapPolygon` in `maps.zig`. */
+export interface MapPolygon {
+    id: number;
+    exterior_ring: Coordinate[];
+    interior_rings: Coordinate[][];
+    fill_color: MarkerColor;
+    fill_opacity: number;
+    stroke_color: MarkerColor;
+    stroke_width: number;
+    z_index: number;
+}
+/** Matches `MapCircle` in `maps.zig`. */
+export interface MapCircle {
+    id: number;
+    center: Coordinate;
+    radius_meters: number;
+    fill_color: MarkerColor;
+    fill_opacity: number;
+    stroke_color: MarkerColor;
+    stroke_width: number;
+}
+/** Matches `MapConfiguration` in `maps.zig`. */
+export interface MapConfiguration {
+    provider: MapProvider;
+    map_type: MapType;
+    shows_user_location: boolean;
+    user_tracking_mode: UserTrackingMode;
+    shows_compass: boolean;
+    shows_scale: boolean;
+    shows_traffic: boolean;
+    shows_buildings: boolean;
+    is_rotate_enabled: boolean;
+    is_scroll_enabled: boolean;
+    is_zoom_enabled: boolean;
+    is_pitch_enabled: boolean;
+    min_zoom: number;
+    max_zoom: number;
+}
+/**
+ * Sensible defaults matching `MapConfiguration.defaults()` in `maps.zig`,
+ * but with the provider set to `ts_maps` — the whole point of this package.
+ */
+export declare const defaultMapConfiguration: MapConfiguration;
+/** Default camera — matches `MapCamera.init(Coordinate.zero)`. */
+export declare const defaultMapCamera: MapCamera;
+/**
+ * Hex string map for each `MarkerColor`, derived from `MarkerColor.toRGB()`
+ * in `maps.zig`. Used when passing stroke/fill colors to ts-maps.
+ */
+export declare const markerColorHex: Record<MarkerColor, string>;
+/**
+ * Dash pattern (in pixels) for each stroke pattern. Matches
+ * `StrokePattern.dashLengths()` in `maps.zig`.
+ */
+export declare const strokePatternDashes: Record<StrokePattern, number[]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,53 @@
+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/types.ts
+var defaultMapConfiguration = {
+  provider: "ts_maps",
+  map_type: "standard",
+  shows_user_location: false,
+  user_tracking_mode: "none",
+  shows_compass: true,
+  shows_scale: true,
+  shows_traffic: false,
+  shows_buildings: true,
+  is_rotate_enabled: true,
+  is_scroll_enabled: true,
+  is_zoom_enabled: true,
+  is_pitch_enabled: true,
+  min_zoom: 0,
+  max_zoom: 22
+};
+var defaultMapCamera = {
+  center: { latitude: 0, longitude: 0 },
+  zoom: 15,
+  pitch: 0,
+  heading: 0
+};
+var markerColorHex = {
+  red: "#ff3b30",
+  green: "#34c759",
+  blue: "#007aff",
+  yellow: "#ffcc00",
+  orange: "#ff9500",
+  purple: "#af52de",
+  cyan: "#32ade6",
+  magenta: "#ff2d55"
+};
+var strokePatternDashes = {
+  solid: [],
+  dashed: [10, 5],
+  dotted: [2, 2],
+  dash_dot: [10, 5, 2, 5]
+};
+export {
+  strokePatternDashes,
+  markerColorHex,
+  defaultMapConfiguration,
+  defaultMapCamera
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-native/ts-maps",
-  "version": "0.0.91",
+  "version": "0.0.94",
   "private": false,
   "type": "module",
   "description": "Craft SDK bindings for the ts-maps interactive map runtime. Provides a cross-platform MapView component backed by the MapProvider.ts_maps variant in the Zig core.",

package/LICENSE.md

@@ -1,21 +0,0 @@
-# MIT License
-
-Copyright (c) 2025 Stacks.js
-
-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.