@joewinke/jatui 0.1.19 → 0.1.20

package/src/lib/index.ts

@@ -2,6 +2,31 @@
 export { railNav, createRailNav, cycle } from './actions/railNav';
 export type { RailNavOptions, RailNavController } from './actions/railNav';
 
+// Components — Session primitives (from JAT IDE, jat-jj79f.16 G1)
+export { default as LinkedColumns } from './components/linked-columns/LinkedColumns.svelte';
+export type { ColumnLink } from './components/linked-columns/LinkedColumns.svelte';
+
+export { default as ChapterTimeline } from './components/replay/ChapterTimeline.svelte';
+export type { ChapterBlock } from './components/replay/ChapterTimeline.svelte';
+
+// Data models — Session transcript (from JAT IDE, jat-jj79f.16 G1)
+export {
+	buildLinkedSession,
+	buildLinkedSessionFromWork,
+	rawTypeToState,
+	sampleLinkedSession,
+	SAMPLE_TRANSCRIPT_LINES,
+} from './components/session-nav/transcriptModel';
+export type {
+	ItemKind,
+	TranscriptItem,
+	FileTouchedEntry,
+	SignalNode,
+	LinkedSession,
+	WorkBlockClient,
+	WorkTranscriptItemClient,
+} from './components/session-nav/transcriptModel';
+
 // Components — Universal
 export { default as UserAvatar } from './components/UserAvatar.svelte';
 export { default as SidebarUserFooter } from './components/SidebarUserFooter.svelte';
@@ -353,3 +378,25 @@ export type {
 	AnnotationThread,
 	AnnotationCallbacks,
 } from './types/annotation';
+
+// Components — Keyboard Navigation
+export { default as KeyboardShortcutsOverlay } from './components/KeyboardShortcutsOverlay.svelte';
+export type {
+	KeyboardShortcut,
+	SectionEntry as KeyboardShortcutSectionEntry,
+	ShortcutSection as KeyboardShortcutSection,
+} from './components/KeyboardShortcutsOverlay.svelte';
+
+// Components — Google Maps (DispatchMap fork + location primitives)
+export { default as MapView } from './components/MapView.svelte';
+export { default as LocationMap } from './components/LocationMap.svelte';
+export { default as GPSTracker } from './components/GPSTracker.svelte';
+export type { MapJob, MapAgent } from './types/maps';
+
+// Utilities — Google Maps loader
+export {
+	loadGoogleMapsAPI,
+	isGoogleMapsLoaded,
+	isPlacesLoaded,
+	isGeometryLoaded,
+} from './utils/googleMapsLoader';

package/src/lib/types/googleMaps.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Minimal ambient declarations for Google Maps JS API loaded at runtime.
+ * Prevents "Property 'google' does not exist on Window" TS errors.
+ * Components using the Google Maps API operate with `any` for advanced
+ * marker types until @types/google.maps is added as a dev dependency.
+ */
+
+declare namespace google {
+	namespace maps {
+		class Map {
+			constructor(el: HTMLElement, options: object);
+			fitBounds(bounds: any): void;
+			getZoom(): number | undefined;
+			setZoom(zoom: number): void;
+			setCenter(center: object): void;
+		}
+		class InfoWindow {
+			constructor(options: object);
+			open(map: any, marker: any): void;
+		}
+		class Circle {
+			constructor(options: object);
+			setMap(map: any): void;
+		}
+		class LatLngBounds {
+			extend(position: object): void;
+		}
+		const MapTypeId: { ROADMAP: string };
+		const event: {
+			addListener(instance: any, event: string, fn: () => void): any;
+			removeListener(listener: any): void;
+			clearInstanceListeners(instance: any): void;
+		};
+		namespace marker {
+			class AdvancedMarkerElement {
+				constructor(options: object);
+				map: any;
+				position: any;
+				addListener(event: string, fn: () => void): void;
+			}
+		}
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		const places: any;
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		const geometry: any;
+	}
+}
+
+interface Window {
+	google?: typeof google;
+}

package/src/lib/types/maps.ts

@@ -0,0 +1,43 @@
+/**
+ * Types for MapView, LocationMap, and GPSTracker components.
+ */
+
+export interface MapJob {
+	id: string;
+	status: string;
+	type?: string;
+	priority?: string;
+	description?: string;
+	scheduled_at?: string;
+	customer?: {
+		name?: string;
+		phone?: string;
+	};
+	location?: {
+		address?: string;
+		latitude?: number;
+		longitude?: number;
+	};
+}
+
+export interface MapAgent {
+	id: string;
+	name: string;
+	email?: string;
+	avatarUrl?: string;
+	status?: string;
+	capacity?: string;
+	specializations?: string[];
+	vehicle?: { name?: string };
+	/** Most recent GPS fix */
+	location?: {
+		latitude?: number;
+		longitude?: number;
+		age_seconds?: number;
+	};
+	/** Active dispatches used as fallback location */
+	dispatches?: Array<{
+		job_id: string;
+		status: string;
+	}>;
+}

package/src/lib/utils/googleMapsLoader.ts

@@ -0,0 +1,84 @@
+/**
+ * Centralized Google Maps API loader for jatui.
+ *
+ * Prevents multiple script loads and ensures all required libraries are available.
+ * Pass the API key explicitly — jatui is SvelteKit-agnostic (no $env imports).
+ *
+ * Usage:
+ *   await loadGoogleMapsAPI({ apiKey: 'YOUR_KEY', libraries: ['marker', 'geometry'] })
+ *   if (isGoogleMapsLoaded()) { ... }
+ */
+
+interface LoadOptions {
+	apiKey: string;
+	libraries?: string[];
+}
+
+let loadPromise: Promise<void> | null = null;
+let isLoaded = false;
+
+export async function loadGoogleMapsAPI(options: LoadOptions): Promise<void> {
+	if (typeof window === 'undefined') return;
+
+	const { apiKey, libraries = [] } = options;
+
+	if (!apiKey) {
+		console.warn('googleMapsLoader: No API key provided');
+		return;
+	}
+
+	// If already loaded and all required libraries are available, return
+	if (isLoaded && window.google?.maps) {
+		const allLibrariesAvailable = libraries.every((lib) => {
+			switch (lib) {
+				case 'places':
+					return window.google?.maps?.places;
+				case 'geometry':
+					return window.google?.maps?.geometry;
+				default:
+					return true;
+			}
+		});
+		if (allLibrariesAvailable) return;
+	}
+
+	// If already loading, return the existing promise
+	if (loadPromise) return loadPromise;
+
+	// Combine default libraries with requested ones
+	const allLibraries = Array.from(new Set(['geometry', 'places', 'marker', ...libraries]));
+
+	loadPromise = new Promise<void>((resolve, reject) => {
+		const script = document.createElement('script');
+		script.src = `https://maps.googleapis.com/maps/api/js?key=${apiKey}&libraries=${allLibraries.join(',')}`;
+		script.async = true;
+		script.defer = true;
+
+		script.onload = () => {
+			isLoaded = true;
+			loadPromise = null;
+			resolve();
+		};
+
+		script.onerror = (error) => {
+			loadPromise = null;
+			reject(error);
+		};
+
+		document.head.appendChild(script);
+	});
+
+	return loadPromise;
+}
+
+export function isGoogleMapsLoaded(): boolean {
+	return isLoaded && !!window.google?.maps;
+}
+
+export function isPlacesLoaded(): boolean {
+	return isGoogleMapsLoaded() && !!window.google?.maps?.places;
+}
+
+export function isGeometryLoaded(): boolean {
+	return isGoogleMapsLoaded() && !!window.google?.maps?.geometry;
+}