foam-habits 1.0.0

package/dist/lib/tracker.js

@@ -0,0 +1,120 @@
+import { format, subDays, startOfMonth, endOfMonth, eachDayOfInterval, parseISO, isAfter, } from 'date-fns';
+import { parseGoal, } from './schemas.js';
+/**
+ * Generate date range based on view args
+ */
+export function getDateRange(args) {
+    const today = new Date();
+    let startDate;
+    let endDate = today;
+    if (args.currentMonth) {
+        startDate = startOfMonth(today);
+        endDate = endOfMonth(today);
+        // Don't show future dates
+        if (isAfter(endDate, today)) {
+            endDate = today;
+        }
+    }
+    else {
+        // Last N weeks (N * 7 days)
+        startDate = subDays(today, args.weeks * 7 - 1);
+    }
+    return eachDayOfInterval({ start: startDate, end: endDate }).map(date => format(date, 'yyyy-MM-dd'));
+}
+/**
+ * Calculate current streak for a habit
+ * Streak = consecutive days with completion, going backwards from today
+ */
+function calculateStreak(entries, goal, threshold) {
+    const today = new Date();
+    let streak = 0;
+    let currentDate = today;
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    while (true) {
+        const dateStr = format(currentDate, 'yyyy-MM-dd');
+        const value = entries[dateStr];
+        // Check if habit was completed on this day
+        const isComplete = value !== undefined && (goal === undefined || value >= goal * threshold);
+        if (!isComplete) {
+            break;
+        }
+        streak++;
+        currentDate = subDays(currentDate, 1);
+        // Safety limit
+        if (streak > 365)
+            break;
+    }
+    return streak;
+}
+/**
+ * Aggregate habit entries into HabitData for rendering
+ */
+export function aggregateHabits(entries, config, dateRange) {
+    const habits = [];
+    const today = new Date();
+    // Process each habit from config (maintains order)
+    for (const [habitKey, habitConfig] of Object.entries(config.habits)) {
+        const habitEntries = {};
+        // Find all entries for this habit
+        for (const entry of entries) {
+            if (entry.name === habitKey.toLowerCase()) {
+                const entryDate = parseISO(entry.date);
+                // Skip future dates
+                if (isAfter(entryDate, today))
+                    continue;
+                // Only include if in date range or needed for streak calculation
+                habitEntries[entry.date] = entry.value;
+            }
+        }
+        // Filter entries to only those in the display range
+        const displayEntries = {};
+        for (const date of dateRange) {
+            displayEntries[date] = habitEntries[date];
+        }
+        const threshold = habitConfig.threshold ?? 1.0;
+        // Parse goal string (e.g., "4L" -> {value: 4, unit: "L"})
+        let goalValue;
+        let goalUnit;
+        if (habitConfig.goal) {
+            const parsed = parseGoal(habitConfig.goal);
+            goalValue = parsed.value;
+            goalUnit = parsed.unit;
+        }
+        habits.push({
+            name: habitKey,
+            emoji: habitConfig.emoji,
+            goal: goalValue,
+            unit: goalUnit,
+            threshold,
+            entries: displayEntries,
+            streak: calculateStreak(habitEntries, goalValue, threshold),
+        });
+    }
+    return habits;
+}
+/**
+ * Get completion level for a single cell (0-3)
+ * 0 = not done (░), 1 = low (▒), 2 = partial (▓), 3 = complete (█)
+ */
+export function getCompletionLevel(value, goal, threshold = 1.0) {
+    if (value === undefined) {
+        return 0; // Not done
+    }
+    if (goal === undefined) {
+        // Boolean habit - present = complete
+        return 3;
+    }
+    const percentage = value / goal;
+    if (percentage >= threshold) {
+        return 3; // Complete (meets threshold)
+    }
+    // Scale partial levels relative to threshold
+    const partialThreshold = threshold * 0.625; // ~50% of the way to threshold
+    if (percentage >= partialThreshold) {
+        return 2; // Partial
+    }
+    if (percentage > 0) {
+        return 1; // Low
+    }
+    return 0; // Not done
+}

package/package.json

@@ -0,0 +1,82 @@
+{
+	"name": "foam-habits",
+	"version": "1.0.0",
+	"description": "Terminal habit tracker for Foam daily notes with GitHub-style heatmap",
+	"license": "MIT",
+	"author": "Olavo Carvalho",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/olavocarvalho/foam-habits.git"
+	},
+	"homepage": "https://github.com/olavocarvalho/foam-habits#readme",
+	"bugs": {
+		"url": "https://github.com/olavocarvalho/foam-habits/issues"
+	},
+	"keywords": [
+		"foam",
+		"habits",
+		"tracker",
+		"cli",
+		"terminal",
+		"heatmap",
+		"ink",
+		"daily-notes"
+	],
+	"bin": "dist/cli.js",
+	"type": "module",
+	"engines": {
+		"node": ">=16"
+	},
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"test": "tsc && ava",
+		"lint": "prettier --check . && xo",
+		"prepublishOnly": "npm run build && npm test"
+	},
+	"files": [
+		"dist"
+	],
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org/"
+	},
+	"dependencies": {
+		"date-fns": "^4.1.0",
+		"ink": "^4.1.0",
+		"ink-spinner": "^5.0.0",
+		"js-yaml": "^4.1.1",
+		"meow": "^11.0.0",
+		"react": "^18.2.0",
+		"string-width": "^8.1.0",
+		"zod": "^4.3.4"
+	},
+	"devDependencies": {
+		"@sindresorhus/tsconfig": "^3.0.1",
+		"@types/js-yaml": "^4.0.9",
+		"@types/react": "^18.0.32",
+		"@vdemedes/prettier-config": "^2.0.1",
+		"ava": "^5.2.0",
+		"chalk": "^5.2.0",
+		"eslint-config-xo-react": "^0.27.0",
+		"eslint-plugin-react": "^7.32.2",
+		"eslint-plugin-react-hooks": "^4.6.0",
+		"ink-testing-library": "^3.0.0",
+		"prettier": "^2.8.7",
+		"ts-node": "^10.9.1",
+		"typescript": "^5.0.3",
+		"xo": "^0.53.1"
+	},
+	"ava": {
+		"files": [
+			"dist/lib/__tests__/*.test.js"
+		]
+	},
+	"xo": {
+		"extends": "xo-react",
+		"prettier": true,
+		"rules": {
+			"react/prop-types": "off"
+		}
+	},
+	"prettier": "@vdemedes/prettier-config"
+}