@joewinke/jatui 0.1.19 → 0.1.21

package/src/lib/components/KeyboardShortcutsOverlay.svelte

@@ -0,0 +1,296 @@
+<script lang="ts">
+	/**
+	 * KeyboardShortcutsOverlay — press `?` to toggle a modal listing the
+	 * keyboard shortcuts available on the current page. Press `?` again or
+	 * `Escape` to dismiss. Input/contenteditable fields and Ctrl/Meta/Alt
+	 * combos are ignored so the shortcut never interferes with typing.
+	 *
+	 * Usage:
+	 *
+	 *   <KeyboardShortcutsOverlay shortcuts={[
+	 *     { key: 'j / ↓', description: 'Focus next item' },
+	 *     { key: 'k / ↑', description: 'Focus previous item' },
+	 *     { key: 'Enter', description: 'Open detail' },
+	 *   ]} />
+	 */
+
+	export interface KeyboardShortcut {
+		key: string;
+		description: string;
+	}
+
+	export interface SectionEntry {
+		key: string;
+		description: string;
+		/** Optional oklch color to tint the key badge — used for legend entries */
+		color?: string;
+	}
+
+	export interface ShortcutSection {
+		title: string;
+		shortcuts: SectionEntry[];
+	}
+
+	let {
+		shortcuts = [],
+		sections,
+		title = 'Keyboard Shortcuts',
+		open = $bindable(false)
+	}: {
+		shortcuts?: KeyboardShortcut[];
+		/**
+		 * Optional grouped sections (e.g. mode-specific shortcut tables for
+		 * /inbox: list / detail / compose). When provided, takes
+		 * precedence over the flat `shortcuts` prop.
+		 */
+		sections?: ShortcutSection[];
+		title?: string;
+		open?: boolean;
+	} = $props();
+
+	let isOpen = $state(open);
+
+	$effect(() => {
+		isOpen = open;
+	});
+	$effect(() => {
+		open = isOpen;
+	});
+
+	function isTypingTarget(target: EventTarget | null): boolean {
+		if (!(target instanceof HTMLElement)) return false;
+		const tag = target.tagName;
+		if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') return true;
+		return target.isContentEditable;
+	}
+
+	function onKeydown(e: KeyboardEvent) {
+		if (e.ctrlKey || e.metaKey || e.altKey) return;
+
+		if (e.key === '?') {
+			// `?` is always Shift+/. Don't trigger while typing — would swallow the char.
+			if (isTypingTarget(e.target)) return;
+			e.preventDefault();
+			isOpen = !isOpen;
+			return;
+		}
+
+		if (isOpen && e.key === 'Escape') {
+			e.preventDefault();
+			isOpen = false;
+		}
+	}
+
+	$effect(() => {
+		window.addEventListener('keydown', onKeydown);
+		return () => window.removeEventListener('keydown', onKeydown);
+	});
+</script>
+
+{#if isOpen}
+	<div
+		class="kso-backdrop"
+		role="presentation"
+		onclick={() => (isOpen = false)}
+	>
+		<div
+			class="kso-panel animate-scale-in"
+			role="dialog"
+			aria-modal="true"
+			aria-label={title}
+			onclick={(e) => e.stopPropagation()}
+			onkeydown={(e) => e.stopPropagation()}
+			tabindex="-1"
+		>
+			<div class="kso-header">
+				<h2 class="kso-title">{title}</h2>
+				<button
+					type="button"
+					class="kso-close"
+					onclick={() => (isOpen = false)}
+					aria-label="Close keyboard shortcuts"
+				>
+					×
+				</button>
+			</div>
+			<div class="kso-list">
+				{#if sections && sections.length > 0}
+					{#each sections as section, sIdx (section.title + '::' + sIdx)}
+						<div class="kso-section-title">{section.title}</div>
+						{#each section.shortcuts as { key, description, color }, i (section.title + '::' + key + '::' + i)}
+							<div class="kso-row">
+								<kbd
+									class="kso-key"
+									style={color
+										? `color:${color};border-color:color-mix(in oklch,${color} 50%,oklch(0.35 0.02 250));background:color-mix(in oklch,${color} 12%,oklch(0.25 0.02 250))`
+										: ''}
+								>
+									{key}
+								</kbd>
+								<span class="kso-description">{description}</span>
+							</div>
+						{/each}
+					{/each}
+				{:else}
+					{#each shortcuts as { key, description }, i (key + '::' + i)}
+						<div class="kso-row">
+							<kbd class="kso-key">{key}</kbd>
+							<span class="kso-description">{description}</span>
+						</div>
+					{/each}
+				{/if}
+				<div class="kso-row kso-row-meta">
+					<kbd class="kso-key">?</kbd>
+					<span class="kso-description">Toggle this overlay</span>
+				</div>
+				<div class="kso-row kso-row-meta">
+					<kbd class="kso-key">Esc</kbd>
+					<span class="kso-description">Close overlay</span>
+				</div>
+			</div>
+		</div>
+	</div>
+{/if}
+
+<style>
+	.kso-backdrop {
+		position: fixed;
+		inset: 0;
+		background: oklch(0 0 0 / 0.6);
+		backdrop-filter: blur(2px);
+		z-index: 60;
+		display: flex;
+		align-items: center;
+		justify-content: center;
+		padding: 1.5rem;
+		animation: kso-fade 0.15s ease-out;
+	}
+
+	.kso-panel {
+		background: oklch(0.18 0.02 250);
+		border: 1px solid oklch(0.30 0.03 250);
+		border-radius: 0.75rem;
+		box-shadow: 0 20px 60px oklch(0 0 0 / 0.6);
+		max-width: 34rem;
+		width: 100%;
+		max-height: 80vh;
+		overflow: hidden;
+		display: flex;
+		flex-direction: column;
+	}
+
+	.kso-header {
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
+		padding: 0.9rem 1.25rem;
+		border-bottom: 1px solid oklch(0.25 0.02 250);
+		flex-shrink: 0;
+	}
+
+	.kso-title {
+		font-size: 0.95rem;
+		font-weight: 600;
+		color: oklch(0.92 0.02 250);
+		margin: 0;
+		letter-spacing: 0.01em;
+	}
+
+	.kso-close {
+		background: transparent;
+		border: none;
+		color: oklch(0.65 0.02 250);
+		font-size: 1.5rem;
+		line-height: 1;
+		cursor: pointer;
+		padding: 0.15rem 0.5rem;
+		border-radius: 0.35rem;
+		transition:
+			background 0.12s ease,
+			color 0.12s ease;
+	}
+
+	.kso-close:hover {
+		color: oklch(0.94 0.02 250);
+		background: oklch(0.25 0.02 250);
+	}
+
+	.kso-list {
+		padding: 0.75rem 1.25rem 1.25rem;
+		display: flex;
+		flex-direction: column;
+		gap: 0.3rem;
+		overflow-y: auto;
+	}
+
+	.kso-row {
+		display: flex;
+		align-items: center;
+		gap: 1rem;
+		padding: 0.4rem 0.25rem;
+	}
+
+	.kso-section-title {
+		font-size: 0.7rem;
+		text-transform: uppercase;
+		letter-spacing: 0.08em;
+		color: oklch(0.62 0.05 240);
+		padding: 0.55rem 0.25rem 0.2rem;
+		border-bottom: 1px solid oklch(0.25 0.02 250);
+		margin-top: 0.25rem;
+	}
+
+	.kso-section-title:first-of-type {
+		margin-top: 0;
+		padding-top: 0.1rem;
+	}
+
+	.kso-row-meta {
+		opacity: 0.7;
+		border-top: 1px dashed oklch(0.25 0.02 250);
+		margin-top: 0.25rem;
+		padding-top: 0.5rem;
+	}
+
+	.kso-row-meta:not(:first-of-type) {
+		border-top: none;
+		margin-top: 0;
+	}
+
+	.kso-key {
+		font-family: ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+		font-size: 0.78rem;
+		background: oklch(0.25 0.02 250);
+		border: 1px solid oklch(0.35 0.02 250);
+		border-bottom-width: 2px;
+		border-radius: 0.35rem;
+		padding: 0.18rem 0.55rem;
+		min-width: 3.25rem;
+		text-align: center;
+		color: oklch(0.93 0.02 250);
+		flex-shrink: 0;
+		white-space: nowrap;
+	}
+
+	.kso-description {
+		font-size: 0.85rem;
+		color: oklch(0.78 0.02 250);
+		line-height: 1.35;
+	}
+
+	@keyframes kso-fade {
+		from {
+			opacity: 0;
+		}
+		to {
+			opacity: 1;
+		}
+	}
+
+	@media (prefers-reduced-motion: reduce) {
+		.kso-backdrop,
+		.kso-panel {
+			animation: none !important;
+		}
+	}
+</style>

package/src/lib/components/LocationMap.svelte

@@ -0,0 +1,186 @@
+<script lang="ts">
+	/**
+	 * LocationMap — single-location Google Maps embed with a pulsing dot marker.
+	 *
+	 * Shows the current GPS position on a map. While waiting for coords, renders
+	 * a "Waiting for GPS signal…" placeholder.
+	 *
+	 * API key is passed explicitly — jatui has no $env dependency.
+	 *
+	 * Usage:
+	 *
+	 *   <LocationMap
+	 *     apiKey={PUBLIC_GOOGLE_MAPS_API_KEY}
+	 *     latitude={coords.latitude}
+	 *     longitude={coords.longitude}
+	 *     accuracy={coords.accuracy}
+	 *   />
+	 *
+	 * Ported from flush technician/LocationMap (190L) — steelbridge fork capture (jst-e0d1u.4).
+	 */
+	import { onMount, onDestroy } from 'svelte';
+	import { loadGoogleMapsAPI, isGoogleMapsLoaded } from '../utils/googleMapsLoader';
+
+	interface Props {
+		apiKey: string;
+		latitude?: number;
+		longitude?: number;
+		accuracy?: number;
+		showAccuracyCircle?: boolean;
+		height?: string;
+	}
+
+	let {
+		apiKey,
+		latitude,
+		longitude,
+		accuracy,
+		showAccuracyCircle = true,
+		height = '200px'
+	}: Props = $props();
+
+	let mapContainer: HTMLElement;
+	let map: google.maps.Map;
+	let marker: any;
+	let accuracyCircle: google.maps.Circle;
+	let AdvancedMarkerElement: any;
+
+	onMount(async () => {
+		if (!apiKey) {
+			console.warn('LocationMap: No Google Maps API key provided');
+			return;
+		}
+		try {
+			await loadGoogleMapsAPI({ apiKey, libraries: ['marker'] });
+			if (isGoogleMapsLoaded() && window.google?.maps?.marker) {
+				AdvancedMarkerElement = window.google.maps.marker.AdvancedMarkerElement;
+				initializeMap();
+			}
+		} catch (e) {
+			console.warn('LocationMap: Failed to load Google Maps API', e);
+		}
+	});
+
+	onDestroy(() => {
+		if (marker) marker.map = null;
+		if (accuracyCircle) accuracyCircle.setMap(null);
+	});
+
+	function initializeMap() {
+		const position = { lat: latitude ?? 26.3683, lng: longitude ?? -80.1289 };
+
+		map = new google.maps.Map(mapContainer, {
+			zoom: 16,
+			center: position,
+			mapId: 'jatui-location-map',
+			disableDefaultUI: true,
+			zoomControl: true,
+			mapTypeControl: false,
+			streetViewControl: false,
+			fullscreenControl: false
+		});
+
+		updateMarker();
+	}
+
+	function updateMarker() {
+		if (!map || !AdvancedMarkerElement) return;
+
+		const position = { lat: latitude ?? 26.3683, lng: longitude ?? -80.1289 };
+
+		if (marker) marker.map = null;
+
+		const el = document.createElement('div');
+		el.className = 'lm-current-location';
+		el.innerHTML = '<div class="lm-pulse-ring"></div><div class="lm-dot"></div>';
+
+		marker = new AdvancedMarkerElement({
+			position,
+			map,
+			content: el,
+			title: 'Current location'
+		});
+
+		if (accuracyCircle) accuracyCircle.setMap(null);
+
+		if (showAccuracyCircle && accuracy) {
+			accuracyCircle = new google.maps.Circle({
+				strokeColor: '#4285F4',
+				strokeOpacity: 0.8,
+				strokeWeight: 1,
+				fillColor: '#4285F4',
+				fillOpacity: 0.2,
+				map,
+				center: position,
+				radius: accuracy
+			});
+		}
+
+		map.setCenter(position);
+	}
+
+	$effect(() => {
+		if (map && latitude && longitude) updateMarker();
+	});
+</script>
+
+<div
+	class="relative rounded-lg overflow-hidden border border-base-300"
+	style="height: {height}"
+>
+	<div bind:this={mapContainer} class="w-full h-full"></div>
+
+	{#if !latitude || !longitude}
+		<div class="absolute inset-0 flex items-center justify-center bg-base-200">
+			<div class="text-center">
+				<div class="loading loading-spinner loading-md text-primary"></div>
+				<p class="text-sm mt-2 text-base-content/70">Waiting for GPS signal…</p>
+			</div>
+		</div>
+	{/if}
+</div>
+
+<style>
+	:global(.lm-current-location) {
+		position: relative;
+		width: 20px;
+		height: 20px;
+	}
+
+	:global(.lm-dot) {
+		position: absolute;
+		top: 50%;
+		left: 50%;
+		transform: translate(-50%, -50%);
+		width: 12px;
+		height: 12px;
+		background-color: #4285f4;
+		border: 2px solid white;
+		border-radius: 50%;
+		box-shadow: 0 2px 4px rgba(0, 0, 0, 0.3);
+	}
+
+	:global(.lm-pulse-ring) {
+		position: absolute;
+		top: 50%;
+		left: 50%;
+		transform: translate(-50%, -50%);
+		width: 20px;
+		height: 20px;
+		background-color: #4285f4;
+		border-radius: 50%;
+		opacity: 0.3;
+		animation: lm-pulse 2s infinite;
+	}
+
+	@keyframes lm-pulse {
+		0% {
+			transform: translate(-50%, -50%) scale(1);
+			opacity: 0.3;
+		}
+		100% {
+			transform: translate(-50%, -50%) scale(3);
+			opacity: 0;
+		}
+	}
+</style>