@mrck-labs/vanaheim-shared 0.1.1 → 0.2.0

package/README.md

@@ -1,6 +1,8 @@
 # @mrck-labs/vanaheim-shared
 
-Shared types, constants, and utilities for Vanaheim apps.
+> Shared types, constants, utilities, and state management for the Vanaheim ecosystem
+
+This package provides common code used by both **Vanaheim Desktop** (Electron) and **MobileHorizon** (React Native/Expo).
 
 ## Installation
 
@@ -8,22 +10,172 @@ Shared types, constants, and utilities for Vanaheim apps.
 npm install @mrck-labs/vanaheim-shared
 ```
 
-## Usage
+**Peer Dependencies:**
+
+- `jotai` (optional) - Required only if using the `/atoms` module
+
+## Modules
+
+### Types (`/types`)
+
+Database entity types matching the Supabase schema:
+
+```typescript
+import type {
+  // Focus
+  FocusSession,
+  NewFocusSession,
+  FocusCategory,
+  FocusSessionFilters,
+
+  // Expenses & Income
+  Expense,
+  NewExpense,
+  ExpenseCategory,
+  Income,
+  NewIncome,
+  IncomeCategory,
+
+  // Health
+  HealthHabit,
+  HealthCategory,
+  HealthCompletion,
+
+  // And more...
+} from "@mrck-labs/vanaheim-shared/types";
+```
+
+### Constants (`/constants`)
+
+Shared constants and enums:
+
+```typescript
+import {
+  CURRENCIES, // ['CHF', 'USD', 'EUR', 'PLN']
+  CURRENCY_SYMBOLS, // { CHF: 'CHF', USD: '$', ... }
+  FREQUENCIES, // ['monthly', 'yearly', '6-monthly', ...]
+  DEFAULT_FOCUS_DURATIONS, // [15, 25, 30, 45, 60, 90]
+  FOCUS_STATUS, // ['active', 'completed', 'abandoned']
+  SETTING_KEYS,
+  API_URLS,
+} from "@mrck-labs/vanaheim-shared/constants";
+```
+
+### Utilities (`/utils`)
+
+Common utility functions:
+
+```typescript
+import {
+  formatTime, // (seconds) => "02:05"
+  formatTotalTime, // (seconds) => "1h 30m"
+  formatCurrency, // (amount, currency) => "CHF 1'234.56"
+  formatRelativeTime, // (dateStr) => "2h ago"
+  generateId, // () => UUID v4
+  truncate, // (str, maxLength) => "Hello..."
+} from "@mrck-labs/vanaheim-shared/utils";
+```
+
+### Query Keys (`/query`)
 
-### Main Export
+Centralized TanStack Query cache key factory:
 
 ```typescript
-import /* your exports */ "@mrck-labs/vanaheim-shared";
+import { queryKeys } from "@mrck-labs/vanaheim-shared/query";
+
+// In query hooks
+useQuery({ queryKey: queryKeys.focusSessions.today() });
+useQuery({ queryKey: queryKeys.expenses.list({ isActive: true }) });
+
+// Invalidating
+queryClient.invalidateQueries({ queryKey: queryKeys.focusSessions.all });
+```
+
+**Covered modules:** `expenses`, `expenseCategories`, `expensePayments`, `incomes`, `incomeCategories`, `incomePayments`, `exchangeRates`, `focusSessions`, `focusCategories`, `settings`, `lieuDays`, `efLinks`, `bankConnections`, `bankTransactions`, `healthCategories`, `healthHabits`, `healthCompletions`, `healthStats`, `promptCategories`, `promptLabels`, `prompts`, `trainingActivities`, `trainingSessions`, `plannedSessions`, `races`, `trainingStats`, `strava`, `journalEntries`, `journalData`, `chatConversations`, `chatMessages`, `googleCalendar`, `linear`
+
+### Focus Atoms (`/atoms`)
+
+Jotai atoms for focus timer state management:
+
+```typescript
+import {
+  // Types
+  type TimerStatus, // 'idle' | 'running' | 'paused' | 'completed'
+  type ActiveSession,
+
+  // Core atoms
+  timerStatusAtom,
+  targetSecondsAtom,
+  elapsedSecondsAtom,
+  activeSessionAtom,
+
+  // Derived atoms
+  remainingSecondsAtom,
+  progressAtom, // 0 to 1
+  progressPercentAtom, // 0 to 100
+  formattedRemainingAtom, // "24:59"
+  formattedElapsedAtom, // "00:01"
+} from "@mrck-labs/vanaheim-shared/atoms";
+```
+
+### Date Utilities (`/date`)
+
+Comprehensive date manipulation:
+
+```typescript
+import {
+  // Core
+  getTodayString, // "2024-12-16"
+  parseLocalDate, // Avoids timezone issues
+  formatDateString, // Date => "2024-12-16"
+
+  // Checks
+  isToday,
+  isOverdue,
+  isDueSoon, // Within N days
+
+  // Arithmetic
+  addDays,
+  subtractDays,
+  getYesterdayString,
+  getTomorrowString,
+
+  // ISO helpers (for DB queries)
+  getStartOfDayISO,
+  getEndOfDayISO,
+
+  // Week utilities
+  getWeekStartString,
+  getWeekEndString,
+  formatWeekRange,
+
+  // Display formatting
+  formatFullDate, // "Monday, December 15, 2024"
+  formatDateHeader, // "Today" | "Tomorrow" | "Overdue"
+  formatRelativeDueDate, // "Due in 3 days"
+} from "@mrck-labs/vanaheim-shared/date";
+```
+
+## Usage in Projects
+
+### Vanaheim Desktop
+
+```typescript
+// src/lib/queryClient.ts
+export { queryKeys } from '@mrck-labs/vanaheim-shared/query'
+
+// src/atoms/focus.ts
+export { timerStatusAtom, ... } from '@mrck-labs/vanaheim-shared/atoms'
 ```
 
-### Subpath Exports
+### MobileHorizon
 
 ```typescript
-// Types only
-import /* types */ "@mrck-labs/vanaheim-shared/types";
+// src/hooks/queries/useFocusQueries.ts
+import { queryKeys } from '@mrck-labs/vanaheim-shared/query'
 
-// Utils only
-import /* utils */ "@mrck-labs/vanaheim-shared/utils";
+// src/atoms/focus.ts
+export { timerStatusAtom, ... } from '@mrck-labs/vanaheim-shared/atoms'
 ```
 
 ## Development
@@ -47,7 +199,7 @@ npm run clean
 
 ## Release
 
-This package uses [changesets](https://github.com/changesets/changesets) for version management and releases.
+This package uses [changesets](https://github.com/changesets/changesets) for version management.
 
 See [RELEASE_GUIDE.md](./RELEASE_GUIDE.md) for detailed release instructions.
 

package/dist/atoms/index.d.mts

@@ -0,0 +1,92 @@
+import * as jotai from 'jotai';
+
+/**
+ * Focus Timer Atoms
+ *
+ * Shared Jotai atoms for focus timer state management.
+ * Used by both desktop and mobile apps.
+ *
+ * These atoms manage in-memory timer state that syncs with
+ * the database via TanStack Query.
+ *
+ * @example
+ * import { timerStatusAtom, targetSecondsAtom } from '@mrck-labs/vanaheim-shared/atoms'
+ * import { useAtom, useAtomValue } from 'jotai'
+ *
+ * const [status, setStatus] = useAtom(timerStatusAtom)
+ * const remaining = useAtomValue(remainingSecondsAtom)
+ */
+/**
+ * Timer status values
+ */
+type TimerStatus = 'idle' | 'running' | 'paused' | 'completed';
+/**
+ * Active focus session info (in-memory during timer run)
+ * This is separate from the database FocusSession type
+ */
+interface ActiveSession {
+    id: string;
+    title: string;
+    categoryId: string | null;
+    targetMinutes: number;
+    startedAt?: string;
+}
+/**
+ * Current timer status
+ * - idle: No timer running
+ * - running: Timer actively counting
+ * - paused: Timer paused
+ * - completed: Timer finished (target reached)
+ */
+declare const timerStatusAtom: jotai.PrimitiveAtom<TimerStatus> & {
+    init: TimerStatus;
+};
+/**
+ * Target duration in seconds
+ * Default: 25 minutes (Pomodoro)
+ */
+declare const targetSecondsAtom: jotai.PrimitiveAtom<number> & {
+    init: number;
+};
+/**
+ * Elapsed seconds since timer started
+ */
+declare const elapsedSecondsAtom: jotai.PrimitiveAtom<number> & {
+    init: number;
+};
+/**
+ * Currently active session info (in-memory during timer run)
+ */
+declare const activeSessionAtom: jotai.PrimitiveAtom<ActiveSession | null> & {
+    init: ActiveSession | null;
+};
+/**
+ * Remaining seconds (target - elapsed)
+ * Always returns 0 or positive
+ */
+declare const remainingSecondsAtom: jotai.Atom<number>;
+/**
+ * Progress as a ratio (0 to 1)
+ * 0 = just started, 1 = completed
+ *
+ * Note: Desktop previously used 0-100 (percentage).
+ * If you need percentage, multiply by 100.
+ */
+declare const progressAtom: jotai.Atom<number>;
+/**
+ * Formatted remaining time (MM:SS)
+ * @example "24:59", "00:30"
+ */
+declare const formattedRemainingAtom: jotai.Atom<string>;
+/**
+ * Formatted elapsed time (MM:SS)
+ * @example "00:01", "25:00"
+ */
+declare const formattedElapsedAtom: jotai.Atom<string>;
+/**
+ * Progress as percentage (0 to 100)
+ * Convenience atom for desktop compatibility
+ */
+declare const progressPercentAtom: jotai.Atom<number>;
+
+export { type ActiveSession, type TimerStatus, activeSessionAtom, elapsedSecondsAtom, formattedElapsedAtom, formattedRemainingAtom, progressAtom, progressPercentAtom, remainingSecondsAtom, targetSecondsAtom, timerStatusAtom };

package/dist/atoms/index.d.ts

@@ -0,0 +1,92 @@
+import * as jotai from 'jotai';
+
+/**
+ * Focus Timer Atoms
+ *
+ * Shared Jotai atoms for focus timer state management.
+ * Used by both desktop and mobile apps.
+ *
+ * These atoms manage in-memory timer state that syncs with
+ * the database via TanStack Query.
+ *
+ * @example
+ * import { timerStatusAtom, targetSecondsAtom } from '@mrck-labs/vanaheim-shared/atoms'
+ * import { useAtom, useAtomValue } from 'jotai'
+ *
+ * const [status, setStatus] = useAtom(timerStatusAtom)
+ * const remaining = useAtomValue(remainingSecondsAtom)
+ */
+/**
+ * Timer status values
+ */
+type TimerStatus = 'idle' | 'running' | 'paused' | 'completed';
+/**
+ * Active focus session info (in-memory during timer run)
+ * This is separate from the database FocusSession type
+ */
+interface ActiveSession {
+    id: string;
+    title: string;
+    categoryId: string | null;
+    targetMinutes: number;
+    startedAt?: string;
+}
+/**
+ * Current timer status
+ * - idle: No timer running
+ * - running: Timer actively counting
+ * - paused: Timer paused
+ * - completed: Timer finished (target reached)
+ */
+declare const timerStatusAtom: jotai.PrimitiveAtom<TimerStatus> & {
+    init: TimerStatus;
+};
+/**
+ * Target duration in seconds
+ * Default: 25 minutes (Pomodoro)
+ */
+declare const targetSecondsAtom: jotai.PrimitiveAtom<number> & {
+    init: number;
+};
+/**
+ * Elapsed seconds since timer started
+ */
+declare const elapsedSecondsAtom: jotai.PrimitiveAtom<number> & {
+    init: number;
+};
+/**
+ * Currently active session info (in-memory during timer run)
+ */
+declare const activeSessionAtom: jotai.PrimitiveAtom<ActiveSession | null> & {
+    init: ActiveSession | null;
+};
+/**
+ * Remaining seconds (target - elapsed)
+ * Always returns 0 or positive
+ */
+declare const remainingSecondsAtom: jotai.Atom<number>;
+/**
+ * Progress as a ratio (0 to 1)
+ * 0 = just started, 1 = completed
+ *
+ * Note: Desktop previously used 0-100 (percentage).
+ * If you need percentage, multiply by 100.
+ */
+declare const progressAtom: jotai.Atom<number>;
+/**
+ * Formatted remaining time (MM:SS)
+ * @example "24:59", "00:30"
+ */
+declare const formattedRemainingAtom: jotai.Atom<string>;
+/**
+ * Formatted elapsed time (MM:SS)
+ * @example "00:01", "25:00"
+ */
+declare const formattedElapsedAtom: jotai.Atom<string>;
+/**
+ * Progress as percentage (0 to 100)
+ * Convenience atom for desktop compatibility
+ */
+declare const progressPercentAtom: jotai.Atom<number>;
+
+export { type ActiveSession, type TimerStatus, activeSessionAtom, elapsedSecondsAtom, formattedElapsedAtom, formattedRemainingAtom, progressAtom, progressPercentAtom, remainingSecondsAtom, targetSecondsAtom, timerStatusAtom };

package/dist/atoms/index.js

@@ -0,0 +1,82 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/atoms/index.ts
+var atoms_exports = {};
+__export(atoms_exports, {
+  activeSessionAtom: () => activeSessionAtom,
+  elapsedSecondsAtom: () => elapsedSecondsAtom,
+  formattedElapsedAtom: () => formattedElapsedAtom,
+  formattedRemainingAtom: () => formattedRemainingAtom,
+  progressAtom: () => progressAtom,
+  progressPercentAtom: () => progressPercentAtom,
+  remainingSecondsAtom: () => remainingSecondsAtom,
+  targetSecondsAtom: () => targetSecondsAtom,
+  timerStatusAtom: () => timerStatusAtom
+});
+module.exports = __toCommonJS(atoms_exports);
+
+// src/atoms/focus.ts
+var import_jotai = require("jotai");
+
+// src/utils/formatters.ts
+function formatTime(seconds) {
+  const mins = Math.floor(seconds / 60);
+  const secs = seconds % 60;
+  return `${mins.toString().padStart(2, "0")}:${secs.toString().padStart(2, "0")}`;
+}
+
+// src/atoms/focus.ts
+var timerStatusAtom = (0, import_jotai.atom)("idle");
+var targetSecondsAtom = (0, import_jotai.atom)(25 * 60);
+var elapsedSecondsAtom = (0, import_jotai.atom)(0);
+var activeSessionAtom = (0, import_jotai.atom)(null);
+var remainingSecondsAtom = (0, import_jotai.atom)((get) => {
+  const target = get(targetSecondsAtom);
+  const elapsed = get(elapsedSecondsAtom);
+  return Math.max(0, target - elapsed);
+});
+var progressAtom = (0, import_jotai.atom)((get) => {
+  const target = get(targetSecondsAtom);
+  const elapsed = get(elapsedSecondsAtom);
+  if (target === 0) return 0;
+  return Math.min(1, elapsed / target);
+});
+var formattedRemainingAtom = (0, import_jotai.atom)((get) => {
+  return formatTime(get(remainingSecondsAtom));
+});
+var formattedElapsedAtom = (0, import_jotai.atom)((get) => {
+  return formatTime(get(elapsedSecondsAtom));
+});
+var progressPercentAtom = (0, import_jotai.atom)((get) => {
+  return get(progressAtom) * 100;
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  activeSessionAtom,
+  elapsedSecondsAtom,
+  formattedElapsedAtom,
+  formattedRemainingAtom,
+  progressAtom,
+  progressPercentAtom,
+  remainingSecondsAtom,
+  targetSecondsAtom,
+  timerStatusAtom
+});
+//# sourceMappingURL=index.js.map

package/dist/atoms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/atoms/index.ts","../../src/atoms/focus.ts","../../src/utils/formatters.ts"],"sourcesContent":["/**\n * Atoms Index\n *\n * Re-exports all shared Jotai atoms.\n */\n\nexport * from './focus'\n\n","/**\n * Focus Timer Atoms\n *\n * Shared Jotai atoms for focus timer state management.\n * Used by both desktop and mobile apps.\n *\n * These atoms manage in-memory timer state that syncs with\n * the database via TanStack Query.\n *\n * @example\n * import { timerStatusAtom, targetSecondsAtom } from '@mrck-labs/vanaheim-shared/atoms'\n * import { useAtom, useAtomValue } from 'jotai'\n *\n * const [status, setStatus] = useAtom(timerStatusAtom)\n * const remaining = useAtomValue(remainingSecondsAtom)\n */\n\nimport { atom } from 'jotai'\nimport { formatTime } from '../utils/formatters'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Timer status values\n */\nexport type TimerStatus = 'idle' | 'running' | 'paused' | 'completed'\n\n/**\n * Active focus session info (in-memory during timer run)\n * This is separate from the database FocusSession type\n */\nexport interface ActiveSession {\n  id: string\n  title: string\n  categoryId: string | null\n  targetMinutes: number\n  startedAt?: string // Optional - used by mobile for elapsed calculation\n}\n\n// ============================================================================\n// Core Timer Atoms\n// ============================================================================\n\n/**\n * Current timer status\n * - idle: No timer running\n * - running: Timer actively counting\n * - paused: Timer paused\n * - completed: Timer finished (target reached)\n */\nexport const timerStatusAtom = atom<TimerStatus>('idle')\n\n/**\n * Target duration in seconds\n * Default: 25 minutes (Pomodoro)\n */\nexport const targetSecondsAtom = atom<number>(25 * 60)\n\n/**\n * Elapsed seconds since timer started\n */\nexport const elapsedSecondsAtom = atom<number>(0)\n\n/**\n * Currently active session info (in-memory during timer run)\n */\nexport const activeSessionAtom = atom<ActiveSession | null>(null)\n\n// ============================================================================\n// Derived Timer Atoms (computed, read-only)\n// ============================================================================\n\n/**\n * Remaining seconds (target - elapsed)\n * Always returns 0 or positive\n */\nexport const remainingSecondsAtom = atom((get) => {\n  const target = get(targetSecondsAtom)\n  const elapsed = get(elapsedSecondsAtom)\n  return Math.max(0, target - elapsed)\n})\n\n/**\n * Progress as a ratio (0 to 1)\n * 0 = just started, 1 = completed\n *\n * Note: Desktop previously used 0-100 (percentage).\n * If you need percentage, multiply by 100.\n */\nexport const progressAtom = atom((get) => {\n  const target = get(targetSecondsAtom)\n  const elapsed = get(elapsedSecondsAtom)\n  if (target === 0) return 0\n  return Math.min(1, elapsed / target)\n})\n\n/**\n * Formatted remaining time (MM:SS)\n * @example \"24:59\", \"00:30\"\n */\nexport const formattedRemainingAtom = atom((get) => {\n  return formatTime(get(remainingSecondsAtom))\n})\n\n/**\n * Formatted elapsed time (MM:SS)\n * @example \"00:01\", \"25:00\"\n */\nexport const formattedElapsedAtom = atom((get) => {\n  return formatTime(get(elapsedSecondsAtom))\n})\n\n/**\n * Progress as percentage (0 to 100)\n * Convenience atom for desktop compatibility\n */\nexport const progressPercentAtom = atom((get) => {\n  return get(progressAtom) * 100\n})\n\n","/**\n * Formatting Utilities\n *\n * Pure functions for formatting data.\n */\n\n/**\n * Format seconds into MM:SS format\n * @example formatTime(125) => \"02:05\"\n */\nexport function formatTime(seconds: number): string {\n  const mins = Math.floor(seconds / 60)\n  const secs = seconds % 60\n  return `${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`\n}\n\n/**\n * Format seconds into human-readable total time\n * @example formatTotalTime(3700) => \"1h 1m\"\n * @example formatTotalTime(1800) => \"30m\"\n */\nexport function formatTotalTime(seconds: number): string {\n  const hours = Math.floor(seconds / 3600)\n  const mins = Math.floor((seconds % 3600) / 60)\n  if (hours > 0) {\n    return `${hours}h ${mins}m`\n  }\n  return `${mins}m`\n}\n\n/**\n * Format a number as currency\n * Uses Swiss German locale for authentic Swiss formatting (apostrophe as thousands separator)\n * @example formatCurrency(1234.56, 'CHF') => \"CHF 1'234.56\"\n */\nexport function formatCurrency(\n  amount: number,\n  currency: string,\n  locale: string = 'de-CH'\n): string {\n  return new Intl.NumberFormat(locale, {\n    style: 'currency',\n    currency,\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  }).format(amount)\n}\n\n/**\n * Format a date as relative time (e.g., \"2h ago\", \"3d ago\")\n */\nexport function formatRelativeTime(dateStr: string): string {\n  const date = new Date(dateStr)\n  const now = new Date()\n  const diffMs = now.getTime() - date.getTime()\n  const diffMins = Math.floor(diffMs / 60000)\n  const diffHours = Math.floor(diffMins / 60)\n  const diffDays = Math.floor(diffHours / 24)\n\n  if (diffMins < 1) return 'Just now'\n  if (diffMins < 60) return `${diffMins}m ago`\n  if (diffHours < 24) return `${diffHours}h ago`\n  if (diffDays < 7) return `${diffDays}d ago`\n  return date.toLocaleDateString()\n}\n\n/**\n * Format a date string to a readable format\n * @example formatDate('2024-01-15') => \"Jan 15, 2024\"\n */\nexport function formatDate(\n  dateStr: string,\n  options: Intl.DateTimeFormatOptions = {\n    month: 'short',\n    day: 'numeric',\n    year: 'numeric',\n  }\n): string {\n  return new Date(dateStr).toLocaleDateString('en-US', options)\n}\n\n/**\n * Format a due date with context (Today, Tomorrow, Overdue, etc.)\n */\nexport function formatDueDate(dueDate: string | null): {\n  text: string\n  isOverdue: boolean\n} {\n  if (!dueDate) return { text: '', isOverdue: false }\n\n  const due = new Date(dueDate)\n  const today = new Date()\n  today.setHours(0, 0, 0, 0)\n\n  const tomorrow = new Date(today)\n  tomorrow.setDate(tomorrow.getDate() + 1)\n\n  const dueDay = new Date(due)\n  dueDay.setHours(0, 0, 0, 0)\n\n  const isOverdue = dueDay < today\n\n  if (dueDay.getTime() === today.getTime()) {\n    return { text: 'Today', isOverdue: false }\n  } else if (dueDay.getTime() === tomorrow.getTime()) {\n    return { text: 'Tomorrow', isOverdue: false }\n  } else if (isOverdue) {\n    const daysAgo = Math.ceil(\n      (today.getTime() - dueDay.getTime()) / (1000 * 60 * 60 * 24)\n    )\n    return { text: `${daysAgo}d overdue`, isOverdue: true }\n  } else {\n    return {\n      text: due.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }),\n      isOverdue: false,\n    }\n  }\n}\n\n/**\n * Truncate a string with ellipsis\n * @example truncate(\"Hello World\", 5) => \"Hello...\"\n */\nexport function truncate(str: string, maxLength: number): string {\n  if (str.length <= maxLength) return str\n  return str.slice(0, maxLength) + '...'\n}\n\n/**\n * Extract repo name from GitHub URL\n * @example getRepoName(\"https://github.com/owner/repo\") => \"owner/repo\"\n */\nexport function getRepoName(url: string): string {\n  const match = url.match(/github\\.com\\/(.+)$/)\n  return match ? match[1] : url\n}\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACiBA,mBAAqB;;;ACPd,SAAS,WAAW,SAAyB;AAClD,QAAM,OAAO,KAAK,MAAM,UAAU,EAAE;AACpC,QAAM,OAAO,UAAU;AACvB,SAAO,GAAG,KAAK,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC;AAChF;;;ADsCO,IAAM,sBAAkB,mBAAkB,MAAM;AAMhD,IAAM,wBAAoB,mBAAa,KAAK,EAAE;AAK9C,IAAM,yBAAqB,mBAAa,CAAC;AAKzC,IAAM,wBAAoB,mBAA2B,IAAI;AAUzD,IAAM,2BAAuB,mBAAK,CAAC,QAAQ;AAChD,QAAM,SAAS,IAAI,iBAAiB;AACpC,QAAM,UAAU,IAAI,kBAAkB;AACtC,SAAO,KAAK,IAAI,GAAG,SAAS,OAAO;AACrC,CAAC;AASM,IAAM,mBAAe,mBAAK,CAAC,QAAQ;AACxC,QAAM,SAAS,IAAI,iBAAiB;AACpC,QAAM,UAAU,IAAI,kBAAkB;AACtC,MAAI,WAAW,EAAG,QAAO;AACzB,SAAO,KAAK,IAAI,GAAG,UAAU,MAAM;AACrC,CAAC;AAMM,IAAM,6BAAyB,mBAAK,CAAC,QAAQ;AAClD,SAAO,WAAW,IAAI,oBAAoB,CAAC;AAC7C,CAAC;AAMM,IAAM,2BAAuB,mBAAK,CAAC,QAAQ;AAChD,SAAO,WAAW,IAAI,kBAAkB,CAAC;AAC3C,CAAC;AAMM,IAAM,0BAAsB,mBAAK,CAAC,QAAQ;AAC/C,SAAO,IAAI,YAAY,IAAI;AAC7B,CAAC;","names":[]}

package/dist/atoms/index.mjs

@@ -0,0 +1,47 @@
+// src/atoms/focus.ts
+import { atom } from "jotai";
+
+// src/utils/formatters.ts
+function formatTime(seconds) {
+  const mins = Math.floor(seconds / 60);
+  const secs = seconds % 60;
+  return `${mins.toString().padStart(2, "0")}:${secs.toString().padStart(2, "0")}`;
+}
+
+// src/atoms/focus.ts
+var timerStatusAtom = atom("idle");
+var targetSecondsAtom = atom(25 * 60);
+var elapsedSecondsAtom = atom(0);
+var activeSessionAtom = atom(null);
+var remainingSecondsAtom = atom((get) => {
+  const target = get(targetSecondsAtom);
+  const elapsed = get(elapsedSecondsAtom);
+  return Math.max(0, target - elapsed);
+});
+var progressAtom = atom((get) => {
+  const target = get(targetSecondsAtom);
+  const elapsed = get(elapsedSecondsAtom);
+  if (target === 0) return 0;
+  return Math.min(1, elapsed / target);
+});
+var formattedRemainingAtom = atom((get) => {
+  return formatTime(get(remainingSecondsAtom));
+});
+var formattedElapsedAtom = atom((get) => {
+  return formatTime(get(elapsedSecondsAtom));
+});
+var progressPercentAtom = atom((get) => {
+  return get(progressAtom) * 100;
+});
+export {
+  activeSessionAtom,
+  elapsedSecondsAtom,
+  formattedElapsedAtom,
+  formattedRemainingAtom,
+  progressAtom,
+  progressPercentAtom,
+  remainingSecondsAtom,
+  targetSecondsAtom,
+  timerStatusAtom
+};
+//# sourceMappingURL=index.mjs.map

package/dist/atoms/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/atoms/focus.ts","../../src/utils/formatters.ts"],"sourcesContent":["/**\n * Focus Timer Atoms\n *\n * Shared Jotai atoms for focus timer state management.\n * Used by both desktop and mobile apps.\n *\n * These atoms manage in-memory timer state that syncs with\n * the database via TanStack Query.\n *\n * @example\n * import { timerStatusAtom, targetSecondsAtom } from '@mrck-labs/vanaheim-shared/atoms'\n * import { useAtom, useAtomValue } from 'jotai'\n *\n * const [status, setStatus] = useAtom(timerStatusAtom)\n * const remaining = useAtomValue(remainingSecondsAtom)\n */\n\nimport { atom } from 'jotai'\nimport { formatTime } from '../utils/formatters'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Timer status values\n */\nexport type TimerStatus = 'idle' | 'running' | 'paused' | 'completed'\n\n/**\n * Active focus session info (in-memory during timer run)\n * This is separate from the database FocusSession type\n */\nexport interface ActiveSession {\n  id: string\n  title: string\n  categoryId: string | null\n  targetMinutes: number\n  startedAt?: string // Optional - used by mobile for elapsed calculation\n}\n\n// ============================================================================\n// Core Timer Atoms\n// ============================================================================\n\n/**\n * Current timer status\n * - idle: No timer running\n * - running: Timer actively counting\n * - paused: Timer paused\n * - completed: Timer finished (target reached)\n */\nexport const timerStatusAtom = atom<TimerStatus>('idle')\n\n/**\n * Target duration in seconds\n * Default: 25 minutes (Pomodoro)\n */\nexport const targetSecondsAtom = atom<number>(25 * 60)\n\n/**\n * Elapsed seconds since timer started\n */\nexport const elapsedSecondsAtom = atom<number>(0)\n\n/**\n * Currently active session info (in-memory during timer run)\n */\nexport const activeSessionAtom = atom<ActiveSession | null>(null)\n\n// ============================================================================\n// Derived Timer Atoms (computed, read-only)\n// ============================================================================\n\n/**\n * Remaining seconds (target - elapsed)\n * Always returns 0 or positive\n */\nexport const remainingSecondsAtom = atom((get) => {\n  const target = get(targetSecondsAtom)\n  const elapsed = get(elapsedSecondsAtom)\n  return Math.max(0, target - elapsed)\n})\n\n/**\n * Progress as a ratio (0 to 1)\n * 0 = just started, 1 = completed\n *\n * Note: Desktop previously used 0-100 (percentage).\n * If you need percentage, multiply by 100.\n */\nexport const progressAtom = atom((get) => {\n  const target = get(targetSecondsAtom)\n  const elapsed = get(elapsedSecondsAtom)\n  if (target === 0) return 0\n  return Math.min(1, elapsed / target)\n})\n\n/**\n * Formatted remaining time (MM:SS)\n * @example \"24:59\", \"00:30\"\n */\nexport const formattedRemainingAtom = atom((get) => {\n  return formatTime(get(remainingSecondsAtom))\n})\n\n/**\n * Formatted elapsed time (MM:SS)\n * @example \"00:01\", \"25:00\"\n */\nexport const formattedElapsedAtom = atom((get) => {\n  return formatTime(get(elapsedSecondsAtom))\n})\n\n/**\n * Progress as percentage (0 to 100)\n * Convenience atom for desktop compatibility\n */\nexport const progressPercentAtom = atom((get) => {\n  return get(progressAtom) * 100\n})\n\n","/**\n * Formatting Utilities\n *\n * Pure functions for formatting data.\n */\n\n/**\n * Format seconds into MM:SS format\n * @example formatTime(125) => \"02:05\"\n */\nexport function formatTime(seconds: number): string {\n  const mins = Math.floor(seconds / 60)\n  const secs = seconds % 60\n  return `${mins.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`\n}\n\n/**\n * Format seconds into human-readable total time\n * @example formatTotalTime(3700) => \"1h 1m\"\n * @example formatTotalTime(1800) => \"30m\"\n */\nexport function formatTotalTime(seconds: number): string {\n  const hours = Math.floor(seconds / 3600)\n  const mins = Math.floor((seconds % 3600) / 60)\n  if (hours > 0) {\n    return `${hours}h ${mins}m`\n  }\n  return `${mins}m`\n}\n\n/**\n * Format a number as currency\n * Uses Swiss German locale for authentic Swiss formatting (apostrophe as thousands separator)\n * @example formatCurrency(1234.56, 'CHF') => \"CHF 1'234.56\"\n */\nexport function formatCurrency(\n  amount: number,\n  currency: string,\n  locale: string = 'de-CH'\n): string {\n  return new Intl.NumberFormat(locale, {\n    style: 'currency',\n    currency,\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  }).format(amount)\n}\n\n/**\n * Format a date as relative time (e.g., \"2h ago\", \"3d ago\")\n */\nexport function formatRelativeTime(dateStr: string): string {\n  const date = new Date(dateStr)\n  const now = new Date()\n  const diffMs = now.getTime() - date.getTime()\n  const diffMins = Math.floor(diffMs / 60000)\n  const diffHours = Math.floor(diffMins / 60)\n  const diffDays = Math.floor(diffHours / 24)\n\n  if (diffMins < 1) return 'Just now'\n  if (diffMins < 60) return `${diffMins}m ago`\n  if (diffHours < 24) return `${diffHours}h ago`\n  if (diffDays < 7) return `${diffDays}d ago`\n  return date.toLocaleDateString()\n}\n\n/**\n * Format a date string to a readable format\n * @example formatDate('2024-01-15') => \"Jan 15, 2024\"\n */\nexport function formatDate(\n  dateStr: string,\n  options: Intl.DateTimeFormatOptions = {\n    month: 'short',\n    day: 'numeric',\n    year: 'numeric',\n  }\n): string {\n  return new Date(dateStr).toLocaleDateString('en-US', options)\n}\n\n/**\n * Format a due date with context (Today, Tomorrow, Overdue, etc.)\n */\nexport function formatDueDate(dueDate: string | null): {\n  text: string\n  isOverdue: boolean\n} {\n  if (!dueDate) return { text: '', isOverdue: false }\n\n  const due = new Date(dueDate)\n  const today = new Date()\n  today.setHours(0, 0, 0, 0)\n\n  const tomorrow = new Date(today)\n  tomorrow.setDate(tomorrow.getDate() + 1)\n\n  const dueDay = new Date(due)\n  dueDay.setHours(0, 0, 0, 0)\n\n  const isOverdue = dueDay < today\n\n  if (dueDay.getTime() === today.getTime()) {\n    return { text: 'Today', isOverdue: false }\n  } else if (dueDay.getTime() === tomorrow.getTime()) {\n    return { text: 'Tomorrow', isOverdue: false }\n  } else if (isOverdue) {\n    const daysAgo = Math.ceil(\n      (today.getTime() - dueDay.getTime()) / (1000 * 60 * 60 * 24)\n    )\n    return { text: `${daysAgo}d overdue`, isOverdue: true }\n  } else {\n    return {\n      text: due.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }),\n      isOverdue: false,\n    }\n  }\n}\n\n/**\n * Truncate a string with ellipsis\n * @example truncate(\"Hello World\", 5) => \"Hello...\"\n */\nexport function truncate(str: string, maxLength: number): string {\n  if (str.length <= maxLength) return str\n  return str.slice(0, maxLength) + '...'\n}\n\n/**\n * Extract repo name from GitHub URL\n * @example getRepoName(\"https://github.com/owner/repo\") => \"owner/repo\"\n */\nexport function getRepoName(url: string): string {\n  const match = url.match(/github\\.com\\/(.+)$/)\n  return match ? match[1] : url\n}\n\n"],"mappings":";AAiBA,SAAS,YAAY;;;ACPd,SAAS,WAAW,SAAyB;AAClD,QAAM,OAAO,KAAK,MAAM,UAAU,EAAE;AACpC,QAAM,OAAO,UAAU;AACvB,SAAO,GAAG,KAAK,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC;AAChF;;;ADsCO,IAAM,kBAAkB,KAAkB,MAAM;AAMhD,IAAM,oBAAoB,KAAa,KAAK,EAAE;AAK9C,IAAM,qBAAqB,KAAa,CAAC;AAKzC,IAAM,oBAAoB,KAA2B,IAAI;AAUzD,IAAM,uBAAuB,KAAK,CAAC,QAAQ;AAChD,QAAM,SAAS,IAAI,iBAAiB;AACpC,QAAM,UAAU,IAAI,kBAAkB;AACtC,SAAO,KAAK,IAAI,GAAG,SAAS,OAAO;AACrC,CAAC;AASM,IAAM,eAAe,KAAK,CAAC,QAAQ;AACxC,QAAM,SAAS,IAAI,iBAAiB;AACpC,QAAM,UAAU,IAAI,kBAAkB;AACtC,MAAI,WAAW,EAAG,QAAO;AACzB,SAAO,KAAK,IAAI,GAAG,UAAU,MAAM;AACrC,CAAC;AAMM,IAAM,yBAAyB,KAAK,CAAC,QAAQ;AAClD,SAAO,WAAW,IAAI,oBAAoB,CAAC;AAC7C,CAAC;AAMM,IAAM,uBAAuB,KAAK,CAAC,QAAQ;AAChD,SAAO,WAAW,IAAI,kBAAkB,CAAC;AAC3C,CAAC;AAMM,IAAM,sBAAsB,KAAK,CAAC,QAAQ;AAC/C,SAAO,IAAI,YAAY,IAAI;AAC7B,CAAC;","names":[]}