@tak-ps/cloudtak 13.78.1 → 13.79.0

package/dist/types/plugin.d.ts

@@ -195,16 +195,17 @@ export declare class PluginAPI {
         has: (uid: string) => boolean;
     };
     /**
-     * Manage the Map Status Bar
+     * Manage the floating plugin pane at the bottom centre of the map.
+     * The pane is only rendered while at least one item is registered.
      */
     get bottomBar(): {
         /**
-         * Add a component to the centre of the bottom status bar
+         * Add a component to the floating plugin pane
          * @param item The bottom bar item configuration
          */
         add: (item: BottomBarItemConfig) => void;
         /**
-         * Remove a previously registered bottom bar component by key
+         * Remove a previously registered plugin pane component by key
          * @param key The key of the item to remove
          */
         remove: (key: string) => void;

package/dist/types/src/base/profile-file.d.ts

@@ -0,0 +1,24 @@
+import { type Observable } from 'dexie';
+import { type DBProfileFile } from '../database.ts';
+import BaseInterface from './interface.ts';
+import type { BaseInterface_ListOptions } from './interface.ts';
+export type ProfileFile_ListOptions = BaseInterface_ListOptions & {
+    filter?: string;
+};
+/**
+ * Metadata for profile assets whose PMTiles archive has been downloaded to
+ * this device, so the Files menu can list them without the server
+ */
+export default class ProfileFileManager extends BaseInterface {
+    static readonly listCacheKey = "profile_file";
+    static count(): Promise<number>;
+    static liveCount(): Observable<number>;
+    static list(opts?: ProfileFile_ListOptions): Promise<DBProfileFile[]>;
+    static liveList(opts?: ProfileFile_ListOptions): Observable<DBProfileFile[]>;
+    static from(id: string): Promise<DBProfileFile | undefined>;
+    static liveFrom(id: string): Observable<DBProfileFile | undefined>;
+    static generate(file: DBProfileFile): Promise<DBProfileFile>;
+    static bulkPut(files: DBProfileFile[]): Promise<void>;
+    static update(id: string, file: Partial<DBProfileFile>): Promise<void>;
+    static delete(id: string): Promise<void>;
+}

package/dist/types/src/components/CloudTAK/Menu/MenuFilesOffline.vue.d.ts

@@ -0,0 +1,39 @@
+type __VLS_Props = {
+    overlayUrls: Set<string>;
+    isOffline: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "create-overlay": (asset: {
+        id: string;
+        created: string;
+        updated: string;
+        username: string;
+        path: string;
+        name: string;
+        iconset: null | string;
+        size: number;
+        channels: number[];
+        artifacts: {
+            ext: string;
+            size: number;
+        }[];
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onCreate-overlay"?: ((asset: {
+        id: string;
+        created: string;
+        updated: string;
+        username: string;
+        path: string;
+        name: string;
+        iconset: null | string;
+        size: number;
+        channels: number[];
+        artifacts: {
+            ext: string;
+            size: number;
+        }[];
+    }) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/src/components/CloudTAK/Menu/MenuFilesRow.vue.d.ts

@@ -3,6 +3,7 @@ type __VLS_Props = {
     asset: ProfileFile;
     currentUsername: string;
     overlayUrls: Set<string>;
+    offlineIds: Set<string>;
     rename?: {
         id: string;
         loading: boolean;
@@ -10,6 +11,21 @@ type __VLS_Props = {
     };
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    offline: (asset: {
+        id: string;
+        created: string;
+        updated: string;
+        username: string;
+        path: string;
+        name: string;
+        iconset: null | string;
+        size: number;
+        channels: number[];
+        artifacts: {
+            ext: string;
+            size: number;
+        }[];
+    }) => any;
     download: (asset: {
         id: string;
         created: string;
@@ -24,7 +40,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
             ext: string;
             size: number;
         }[];
-    }, type: "original" | "pmtiles") => any;
+    }, type: "pmtiles" | "original") => any;
     delete: (asset: {
         id: string;
         created: string;
@@ -134,6 +150,21 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     "rename-submit": () => any;
     "rename-cancel": () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onOffline?: ((asset: {
+        id: string;
+        created: string;
+        updated: string;
+        username: string;
+        path: string;
+        name: string;
+        iconset: null | string;
+        size: number;
+        channels: number[];
+        artifacts: {
+            ext: string;
+            size: number;
+        }[];
+    }) => any) | undefined;
     onDownload?: ((asset: {
         id: string;
         created: string;
@@ -148,7 +179,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
             ext: string;
             size: number;
         }[];
-    }, type: "original" | "pmtiles") => any) | undefined;
+    }, type: "pmtiles" | "original") => any) | undefined;
     onDelete?: ((asset: {
         id: string;
         created: string;

package/dist/types/src/components/CloudTAK/PluginPane.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/src/components/CloudTAK/util/OfflineDownloader.vue.d.ts

@@ -0,0 +1,39 @@
+import type { ProfileFile } from '../../../types.ts';
+type __VLS_Props = {
+    asset: ProfileFile;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    done: (asset: {
+        id: string;
+        created: string;
+        updated: string;
+        username: string;
+        path: string;
+        name: string;
+        iconset: null | string;
+        size: number;
+        channels: number[];
+        artifacts: {
+            ext: string;
+            size: number;
+        }[];
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDone?: ((asset: {
+        id: string;
+        created: string;
+        updated: string;
+        username: string;
+        path: string;
+        name: string;
+        iconset: null | string;
+        size: number;
+        channels: number[];
+        artifacts: {
+            ext: string;
+            size: number;
+        }[];
+    }) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/src/database.d.ts

@@ -1,5 +1,5 @@
 import Dexie, { type EntityTable } from 'dexie';
-import type { Feature, GroupChannel, Mission, MissionRole, MissionChange, MissionLayer, MissionLog, Contact, Server, ProfileOverlayList } from './types.ts';
+import type { Feature, GroupChannel, Mission, MissionRole, MissionChange, MissionLayer, MissionLog, Contact, Server, ProfileFile, ProfileOverlayList } from './types.ts';
 export interface DBIcon {
     /** Maplibre image id, e.g. "<iconsetUid>:<icon-path-without-extension>" */
     name: string;
@@ -74,6 +74,8 @@ export interface DBIconset {
     skip_resize: boolean;
 }
 export type DBOverlay = ProfileOverlayList["items"][number];
+/** Profile asset metadata retained for files downloaded for offline use */
+export type DBProfileFile = ProfileFile;
 export interface DBFilter {
     id: string;
     external: string;
@@ -233,6 +235,7 @@ export type DatabaseType = Dexie & {
     mission_template_log: EntityTable<DBMissionTemplateLog, 'id'>;
     kv: EntityTable<DBKV, 'key'>;
     profile: EntityTable<DBProfileConfig, 'key'>;
+    profile_file: EntityTable<DBProfileFile, 'id'>;
     config: EntityTable<DBConfig, 'key'>;
     cache: EntityTable<DBCache, 'key'>;
     contact: EntityTable<Contact, 'uid'>;

package/dist/types/src/lib/routing/main.d.ts

@@ -1,6 +1,7 @@
 import type { Map as MapLibreMap, IControl, ControlPosition } from 'maplibre-gl';
 import type { Feature, LineString, Position } from 'geojson';
 export type NavigationDirection = 'forward' | 'reverse';
+export type NavigationMode = 'route' | 'point';
 export interface NavigationState {
     /** Distance remaining along the route to the destination, in kilometers. */
     remaining: number;
@@ -14,6 +15,8 @@ export interface NavigationState {
     destination: Position;
     /** Which end of the route is the destination. */
     direction: NavigationDirection;
+    /** Whether navigating along a Route or straight-line to a Point. */
+    mode: NavigationMode;
 }
 export type RoutingControlOptions = {
     onUpdate?: (state: NavigationState | null) => void;
@@ -23,6 +26,7 @@ export declare class RoutingControl implements IControl {
     private map?;
     private container?;
     private route;
+    private destination;
     private location;
     private direction;
     private state;
@@ -35,7 +39,14 @@ export declare class RoutingControl implements IControl {
     onRemove(): void;
     getDefaultPosition(): ControlPosition;
     get active(): boolean;
+    getMode(): NavigationMode | null;
+    clear(): void;
     setRoute(route: Feature<LineString> | null): void;
+    /**
+     * Navigate straight-line to a single Point - the remaining line is redrawn
+     * from the user's current location to the destination on every update.
+     */
+    setDestination(destination: Position | null): void;
     /**
      * Rehydrate a previously persisted route from the KV store. Returns true
      * if a route was restored - the caller is responsible for re-feeding
@@ -49,6 +60,7 @@ export declare class RoutingControl implements IControl {
     setDirection(direction: NavigationDirection): void;
     reverse(): void;
     getDirection(): NavigationDirection;
+    getDestination(): Position | null;
     getState(): NavigationState | null;
     private recompute;
     private buildCollection;

package/dist/types/src/stores/map.d.ts

@@ -5,7 +5,7 @@ import BottomBarManager from './modules/bottombar.ts';
 import * as Comlink from 'comlink';
 import COT from '../base/cot.ts';
 import RoutingControl from '../lib/routing/main.ts';
-import type { NavigationState, NavigationDirection } from '../lib/routing/main.ts';
+import type { NavigationState, NavigationDirection, NavigationMode } from '../lib/routing/main.ts';
 import { LocationState } from '../utils/events.ts';
 import Overlay from '../base/overlay-class.ts';
 import Subscription from '../base/subscription.ts';
@@ -13,6 +13,7 @@ import * as mapgl from 'maplibre-gl';
 import type Atlas from '../workers/atlas.ts';
 import type { Feature } from '../types.ts';
 import type { LngLat, Point, MapGeoJSONFeature } from 'maplibre-gl';
+import type { Position as GeoJSONPosition } from 'geojson';
 export type TAKNotification = {
     type: string;
     name: string;
@@ -48,14 +49,21 @@ export declare const useMapStore: import("pinia").StoreDefinition<"cloudtak", {
         lng: number;
     } | null;
     gpsSpeed: number | null;
+    gpsAltitude: number | null;
+    gpsHeading: number | null;
+    deviceHeading: number | null;
     navigation: {
         active: boolean;
         cotId: string | null;
         callsign: string | null;
         direction: NavigationDirection;
+        mode: NavigationMode;
+        destination: GeoJSONPosition | null;
         state: NavigationState | null;
     };
     distanceUnit: string;
+    elevationUnit: string;
+    speedUnit: string;
     coordFormat: string;
     defaultPointType: string;
     manualLocationMode: boolean;
@@ -74,6 +82,7 @@ export declare const useMapStore: import("pinia").StoreDefinition<"cloudtak", {
     container?: HTMLElement;
     hasSnapping: boolean;
     hasNoChannels: boolean;
+    offlineTiles: Set<string>;
     channelChange: boolean;
     isMapLoaded: boolean;
     isMapLoadedFully: boolean;
@@ -111,6 +120,8 @@ export declare const useMapStore: import("pinia").StoreDefinition<"cloudtak", {
     routingControl: () => RoutingControl | undefined;
     syncRoutingControl: () => void;
     startNavigation: (cotId: string) => Promise<void>;
+    navigateTo: (destination: GeoJSONPosition, callsign?: string) => void;
+    commitNavigation: (control: RoutingControl, cotId: string | null, callsign?: string) => void;
     restoreNavigation: () => Promise<void>;
     stopNavigation: () => void;
     reverseNavigation: () => void;

package/dist/types/src/stores/modules/bottombar.d.ts

@@ -2,21 +2,21 @@ import type { Component, Ref } from 'vue';
 export type BottomBarItemConfig = {
     /** Unique identifier for the item */
     key: string;
-    /** Vue component rendered in the centre of the bottom status bar */
+    /** Vue component rendered in the floating plugin pane at the bottom centre of the map */
     component: Component;
 };
 /**
- * Manages plugin-registered components displayed in the centre of the map status bar
+ * Manages plugin-registered components displayed in the floating plugin pane
  */
 export default class BottomBarManager {
     pluginItems: Ref<BottomBarItemConfig[]>;
     constructor();
     /**
-     * Add a component to the centre of the bottom status bar
+     * Add a component to the floating plugin pane
      */
     addItem(item: BottomBarItemConfig): void;
     /**
-     * Remove a previously registered bottom bar component by key
+     * Remove a previously registered plugin pane component by key
      */
     removeItem(key: string): void;
 }

package/dist/types/src/stores/modules/pmtiles.d.ts

@@ -0,0 +1,6 @@
+import type { OverlayTileJSON } from '../../types.ts';
+export { offlineTileTemplate, isOfflineTileJSON } from '../../utils/offline-tiles.ts';
+export declare function invalidateOfflinePMTiles(assetId: string): void;
+export declare function offlineTileJSON(assetId: string): Promise<OverlayTileJSON>;
+export declare function setNetworkTileTemplate(assetId: string, template: string): void;
+export declare function registerPMTilesProtocol(): void;

package/dist/types/src/utils/events.d.ts

@@ -7,6 +7,8 @@ export declare enum WorkerMessageType {
     Profile_Display_Zoom = "cloudtak:profile:display:zoom",
     Profile_Icon_Rotation = "cloudtak:profile:icon:rotation",
     Profile_Distance_Unit = "cloudtak:profile:distance:unit",
+    Profile_Elevation_Unit = "cloudtak:profile:elevation:unit",
+    Profile_Speed_Unit = "cloudtak:profile:speed:unit",
     Profile_Location_Coordinates = "cloudtak:profile:location:coordinates",
     Profile_Location_Source = "cloudtak:profile:location:source",
     Feature_Archived_Added = "cloudtak:feature:archived:added",
@@ -24,6 +26,8 @@ export declare enum WorkerMessageType {
     Sync_Start = "cloudtak:sync:start",
     Sync_Complete = "cloudtak:sync:complete",
     Iconset_Change = "cloudtak:iconset:change",
+    Tiles_Downloaded = "cloudtak:tiles:downloaded",
+    Tiles_Removed = "cloudtak:tiles:removed",
     VideoWall_Ping = "cloudtak:videowall:ping",
     VideoWall_Pong = "cloudtak:videowall:pong",
     VideoWall_Refresh = "cloudtak:videowall:refresh"

package/dist/types/src/utils/offline-tiles.d.ts

@@ -0,0 +1,23 @@
+import { type Header } from 'pmtiles';
+import type { OverlayTileJSON } from '../types.ts';
+export declare const OFFLINE_TILES_DIR = "pmtiles";
+export declare const PMTILES_PROTOCOL = "cloudtak-pmtiles";
+export declare function offlineTilesFileName(assetId: string): string;
+export declare function offlineTilesSizeKey(assetId: string): string;
+export declare function profileAssetIdFromUrl(url: string | null | undefined): string | undefined;
+export declare function offlineTilesDirectory(): Promise<FileSystemDirectoryHandle>;
+export declare function offlineTilesHandle(assetId: string): Promise<FileSystemFileHandle | undefined>;
+/**
+ * A file only counts once its byte size matches the size recorded when the
+ * download completed - a crash mid-stream leaves a truncated archive behind.
+ */
+export declare function hasCompleteOfflineTiles(assetId: string): Promise<boolean>;
+export declare function offlineTileTemplate(assetId: string): string;
+export declare function isOfflineTileJSON(tilejson: {
+    tiles: string[];
+}): boolean;
+/**
+ * Mirror of the hosted tile server's TileJSON, built from the archive header
+ * and metadata so an overlay can be created without ever having been online.
+ */
+export declare function offlineTileJSON(assetId: string, header: Header, metadata: unknown): OverlayTileJSON;

package/dist/types/src/workers/atlas-tiles.d.ts

@@ -0,0 +1,11 @@
+import type Atlas from './atlas.ts';
+import type { DBProfileFile } from '../database.ts';
+export type TilesProgress = (percent: number) => void;
+export default class AtlasTiles {
+    atlas: Atlas;
+    constructor(atlas: Atlas);
+    has(assetId: string): Promise<boolean>;
+    list(): Promise<string[]>;
+    remove(assetId: string): Promise<void>;
+    download(asset: DBProfileFile, onProgress?: TilesProgress): Promise<void>;
+}

package/dist/types/src/workers/atlas.d.ts

@@ -4,6 +4,7 @@ import AtlasProfile from './atlas-profile.ts';
 import AtlasDatabase from './atlas-database.ts';
 import AtlasConnection from './atlas-connection.ts';
 import AtlasSync from './atlas-sync.ts';
+import AtlasTiles from './atlas-tiles.ts';
 export default class Atlas {
     channel: BroadcastChannel;
     token: string;
@@ -13,6 +14,7 @@ export default class Atlas {
     conn: AtlasConnection & Comlink.ProxyMarked;
     profile: AtlasProfile & Comlink.ProxyMarked;
     sync: AtlasSync & Comlink.ProxyMarked;
+    tiles: AtlasTiles & Comlink.ProxyMarked;
     constructor();
     postMessage(msg: WorkerMessage): Promise<void>;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@tak-ps/cloudtak",
     "type": "module",
-    "version": "13.78.1",
+    "version": "13.79.0",
     "types": "dist/types/plugin.d.ts",
     "files": [
         "dist/types"
@@ -93,6 +93,7 @@
         "openapi-fetch": "^0.17.0",
         "phone": "^3.1.59",
         "pinia": "^4.0.0",
+        "pmtiles": "^4.5.0",
         "rxjs": "^7.8.2",
         "sortablejs": "^1.15.2",
         "terra-draw": "^1.22.0",
@@ -114,8 +115,8 @@
         "@types/mapbox__tile-cover": "^3.0.4",
         "@types/sortablejs": "^1.15.8",
         "@vitejs/plugin-vue": "^6.0.0",
-        "@vitest/coverage-v8": "^4.1.0",
-        "@vitest/ui": "^4.1.0",
+        "@vitest/coverage-v8": "^5.0.0",
+        "@vitest/ui": "^5.0.0",
         "@vue/devtools-api": "^8.1.5",
         "@vue/test-utils": "^2.4.6",
         "@vueuse/rxjs": "^14.1.0",
@@ -129,7 +130,7 @@
         "typescript": "^6.0.0",
         "typescript-eslint": "^8.20.0",
         "vite": "^8.0.0",
-        "vitest": "^4.1.0",
+        "vitest": "^5.0.0",
         "vue-tsc": "^3.0.0-alpha.10"
     },
     "browserslist": [

package/dist/types/src/components/CloudTAK/BottomBar/BottomBarCallsign.vue.d.ts

@@ -1,12 +0,0 @@
-type __VLS_Props = {
-    mode: string;
-};
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "set-location": (...args: any[]) => void;
-    "to-location": (...args: any[]) => void;
-}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onSet-location"?: ((...args: any[]) => any) | undefined;
-    "onTo-location"?: ((...args: any[]) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default: typeof __VLS_export;
-export default _default;