@joewinke/jatui 0.1.11 → 0.1.20

package/src/lib/types/templateVars.ts

@@ -0,0 +1,36 @@
+/**
+ * Template variable types — shared shape between the JST server-side registry
+ * (`src/lib/server/template-vars.ts`, `getVarsForCategory`) and the
+ * VariablePicker component.
+ *
+ * jatui cannot import the host app's `$lib/server` module (server-only), so
+ * these types are mirrored here. They are kept structurally identical to the
+ * registry's output so `getVarsForCategory(category, availableVars)` can be
+ * passed straight into `<VariablePicker groups={...} />` with no mapping —
+ * same jst↔jatui structural-compatibility pattern used by CommentThread.
+ */
+
+/** A single insertable merge variable. */
+export interface TemplateVar {
+  /**
+   * Dotted variable path inserted into the template as `{{name}}`.
+   * e.g. `contact.name`, `org.logo_url`, `total`.
+   */
+  name: string
+  /** Human label shown in the picker, e.g. "Contact name". */
+  label: string
+  /** Optional one-line help text describing the value. */
+  description?: string
+  /** Optional sample value shown as a hint, e.g. "Acme Inc.". */
+  example?: string
+}
+
+/** Variable context group, e.g. all client/org/financial/custom vars. */
+export interface TemplateVarGroup {
+  /** Stable group id — matches VarGroupId in the host app's template-vars registry. */
+  id: string
+  /** Group heading shown in the picker, e.g. "Client". */
+  label: string
+  /** Variables in this group (never empty — empty groups are omitted). */
+  vars: TemplateVar[]
+}

package/src/lib/utils/dateFormatters.ts

@@ -24,9 +24,11 @@ export function normalizeTimestamp(timestamp: string): string {
 
 /**
  * Parse a potentially non-standard timestamp into a Date object.
+ * Accepts a Date (returned by postgres.js), ISO string, or null/undefined.
  */
-export function parseTimestamp(timestamp: string | null | undefined): Date | null {
+export function parseTimestamp(timestamp: Date | string | null | undefined): Date | null {
 	if (!timestamp) return null;
+	if (timestamp instanceof Date) return isNaN(timestamp.getTime()) ? null : timestamp;
 
 	const normalized = normalizeTimestamp(timestamp);
 	const date = new Date(normalized);
@@ -38,7 +40,7 @@ export function parseTimestamp(timestamp: string | null | undefined): Date | nul
  * Format relative time (e.g., "2d", "3mo", "1y").
  * Compact format suitable for tables and compact UIs.
  */
-export function formatRelativeTime(dateStr: string | null | undefined): string {
+export function formatRelativeTime(dateStr: Date | string | null | undefined): string {
 	if (!dateStr) return '-';
 
 	const date = parseTimestamp(dateStr);
@@ -65,7 +67,7 @@ export function formatRelativeTime(dateStr: string | null | undefined): string {
 /**
  * Format full date and time for tooltips and detailed views.
  */
-export function formatFullDate(dateStr: string | null | undefined): string {
+export function formatFullDate(dateStr: Date | string | null | undefined): string {
 	if (!dateStr) return '';
 
 	const date = parseTimestamp(dateStr);
@@ -83,7 +85,7 @@ export function formatFullDate(dateStr: string | null | undefined): string {
 /**
  * Format short date for compact displays (e.g., date range picker).
  */
-export function formatShortDate(dateStr: string | null | undefined): string {
+export function formatShortDate(dateStr: Date | string | null | undefined): string {
 	if (!dateStr) return '';
 
 	const date = parseTimestamp(dateStr);
@@ -96,7 +98,7 @@ export function formatShortDate(dateStr: string | null | undefined): string {
  * Format last activity time for agent cards.
  * Shows "Just now", "Xm ago", "Xh ago", or "Xd ago".
  */
-export function formatLastActivity(timestamp: string | null | undefined): string {
+export function formatLastActivity(timestamp: Date | string | null | undefined): string {
 	if (!timestamp) return 'Never';
 
 	const date = parseTimestamp(timestamp);
@@ -117,7 +119,7 @@ export function formatLastActivity(timestamp: string | null | undefined): string
 /**
  * Format date for display (simple locale string).
  */
-export function formatDate(dateString: string | null | undefined): string {
+export function formatDate(dateString: Date | string | null | undefined): string {
 	if (!dateString) return 'N/A';
 
 	const date = parseTimestamp(dateString);
@@ -129,7 +131,7 @@ export function formatDate(dateString: string | null | undefined): string {
 /**
  * Get milliseconds since timestamp (for calculations).
  */
-export function getTimeSinceMs(timestamp: string | null | undefined): number {
+export function getTimeSinceMs(timestamp: Date | string | null | undefined): number {
 	if (!timestamp) return Infinity;
 
 	const date = parseTimestamp(timestamp);
@@ -141,14 +143,14 @@ export function getTimeSinceMs(timestamp: string | null | undefined): number {
 /**
  * Get minutes since timestamp.
  */
-export function getTimeSinceMinutes(timestamp: string | null | undefined): number {
+export function getTimeSinceMinutes(timestamp: Date | string | null | undefined): number {
 	return getTimeSinceMs(timestamp) / 60000;
 }
 
 /**
  * Check if timestamp is within a given number of minutes.
  */
-export function isWithinMinutes(timestamp: string | null | undefined, minutes: number): boolean {
+export function isWithinMinutes(timestamp: Date | string | null | undefined, minutes: number): boolean {
 	return getTimeSinceMinutes(timestamp) < minutes;
 }
 
@@ -156,7 +158,7 @@ export function isWithinMinutes(timestamp: string | null | undefined, minutes: n
  * Format date + time for detail views (e.g. "Jan 5, 2:30 PM").
  * No year — use formatFullDate when year is needed.
  */
-export function formatDateTime(dateStr: string | null | undefined): string {
+export function formatDateTime(dateStr: Date | string | null | undefined): string {
 	if (!dateStr) return '';
 	const date = parseTimestamp(dateStr);
 	if (!date) return '';

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;
+}

package/src/lib/utils/taskUtils.ts

@@ -6,17 +6,31 @@
 /**
  * DaisyUI badge class for a task status value.
  * Usage: <span class="badge {statusColor(task.status)}">...</span>
+ *
+ * Aligned to the canonical JAT TASK_STATUS palette
+ * (jat/ide/src/lib/config/statusColors.ts → TASK_STATUS_VISUALS) and the
+ * committed JST portal palette (jst/src/lib/components/portal/portalStatus.ts
+ * → TASK_BADGE) so a task renders the same semantics in JAT-style admin
+ * surfaces, the JST portal, and the JAT IDE:
+ *   open=ghost(neutral) · in_progress=info(blue) · blocked=warning(amber) ·
+ *   closed=success(green). Paused / mid-flight states (waiting, review) and
+ *   post-completion states (submitted, accepted, deployed) use the outline
+ *   variants JAT applies. Where JAT and JST agree (open/in_progress/closed/
+ *   waiting), this matches both; JAT's statusColors.ts is canonical otherwise.
  */
 export function statusColor(status: string): string {
 	switch (status) {
 		case 'open':        return 'badge-ghost';
-		case 'in_progress': return 'badge-warning';
-		case 'waiting':     return 'badge-warning badge-outline';
-		case 'blocked':     return 'badge-error badge-outline';
-		case 'submitted':   return 'badge-info';
-		case 'accepted':    return 'badge-success';
-		case 'deployed':    return 'badge-success badge-outline';
-		case 'closed':      return 'badge-neutral';
+		case 'in_progress': return 'badge-info';
+		case 'waiting':     return 'badge-info badge-outline';
+		case 'review':      return 'badge-info badge-outline';
+		case 'blocked':     return 'badge-warning';
+		case 'submitted':   return 'badge-secondary badge-outline';
+		case 'accepted':    return 'badge-success badge-outline';
+		case 'deployed':    return 'badge-primary badge-outline';
+		case 'rejected':    return 'badge-warning badge-outline';
+		case 'reopened':    return 'badge-warning badge-outline';
+		case 'closed':      return 'badge-success';
 		case 'dev':         return 'badge-ghost badge-outline';
 		default:            return 'badge-ghost';
 	}