foam-habits 1.0.0

package/README.md

@@ -0,0 +1,179 @@
+# foam-habits
+
+A terminal habit tracker that reads from [Foam](https://foambubble.github.io/foam/) daily notes and displays a GitHub-style heatmap.
+
+```
+Foam Habits / Last 28 Days
+
+               Dec                      Jan
+Habit          05    12    19    25     01
+
+💪 Gym         ░░░░░█░░░░░░░░░░░░░░░░░░░░░█ (1 day)
+💧 Drink water ░░░░░░░░░░░░░░░░░░░░░░░░░░░▓ (0 days)
+📖 Study       ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (0 days)
+🧘 Meditation  ░░░░░░░░░░░░░░░░░░░░░░░░░░░█ (1 day)
+🤸 Mobility    ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (0 days)
+```
+
+## Prerequisites
+
+- Node.js >= 16
+
+## Installation
+
+```bash
+# Run without installing
+npx foam-habits
+
+# Or install globally
+npm install -g foam-habits
+```
+
+## Configuration
+
+Create a `.foam/habits.yaml` file in your Foam workspace root:
+
+```yaml
+habits:
+  Gym:
+    emoji: 💪
+
+  Drink water:
+    emoji: 💧
+    goal: 4L
+
+  Study:
+    emoji: 📖
+    goal: 30min
+    threshold: 0.8 # Consider done at 80% (24min)
+
+  Meditation:
+    emoji: 🧘
+
+  Mobility:
+    emoji: 🤸
+```
+
+### Habit Options
+
+| Option      | Type   | Default  | Description                                                 |
+| ----------- | ------ | -------- | ----------------------------------------------------------- |
+| `emoji`     | string | required | Emoji displayed next to habit name                          |
+| `goal`      | string | -        | Target value with unit (e.g., `"4L"`, `"30min"`, `"2.5km"`) |
+| `threshold` | number | `1.0`    | Percentage (0.0-1.0) of goal to consider habit "done"       |
+
+**Boolean habits** (no goal): Present = complete. Just log the habit name.
+
+**Quantitative habits** (with goal): Track progress toward a target. The value is compared against the goal.
+
+## Journal Format
+
+The tool automatically detects your journal folder from `.foam/templates/daily-note.md`. Falls back to `journal/` if not found.
+
+In your daily notes (`journal/YYYY-MM-DD.md`), add a `## Habits` section:
+
+```markdown
+# 2025-01-01
+
+## Habits
+
+- Gym
+- Drink water: 3.5L
+- Meditation
+
+## Notes
+
+Today was productive...
+```
+
+### Entry Format
+
+- **Boolean habit**: Just the habit name (e.g., `- Gym`)
+- **Quantitative habit**: Name followed by colon and value (e.g., `- Drink water: 3.5L`)
+
+The habit name matching is case-insensitive.
+
+## Usage
+
+```bash
+# From your Foam workspace root
+foam-habits
+
+# Show last 2 weeks
+foam-habits --weeks 2
+
+# Show current month
+foam-habits --current-month
+
+# Or use npx without installing
+npx foam-habits --weeks 4
+```
+
+### Options
+
+| Option            | Alias | Default | Description                                |
+| ----------------- | ----- | ------- | ------------------------------------------ |
+| `--weeks`         | `-w`  | `4`     | Number of weeks to display                 |
+| `--current-month` | `-m`  | `false` | Show current month instead of last N weeks |
+| `--help`          | `-h`  | -       | Show help                                  |
+
+## Heatmap Legend
+
+| Symbol | Color  | Meaning                                |
+| ------ | ------ | -------------------------------------- |
+| `░`    | dim    | Not done                               |
+| `▒`    | red    | Low progress (<50% of threshold)       |
+| `▓`    | yellow | Partial progress (50-99% of threshold) |
+| `█`    | green  | Complete (meets threshold)             |
+
+## Streaks
+
+The streak counter shows consecutive days of completion, counting backwards from today. A streak is maintained when the habit meets the threshold requirement each day.
+
+When a streak exceeds 7 days, a fire emoji appears for extra motivation.
+
+## Tips
+
+1. **Use thresholds** for flexibility. Set `threshold: 0.8` to consider a habit done at 80% of the goal.
+
+2. **Keep habits simple**. Boolean habits (no goal) are great for habits you just want to track presence/absence.
+
+3. **Run from workspace root**. The tool looks for `.foam/habits.yaml` and `journal/` in the current directory.
+
+## Development
+
+```bash
+git clone https://github.com/olavocarvalho/foam-habits.git
+cd foam-habits
+npm install
+npm run build
+npm test        # Run 42 unit tests
+npm run dev     # Watch mode
+```
+
+## Roadmap
+
+- [ ] **Habit start date**: Differentiate between days when a habit wasn't tracked yet vs days when it was skipped. Add optional `start-date` config:
+  ```yaml
+  habits:
+    Gym:
+      emoji: 💪
+      start-date: 2025-01-01 # Days before this show as " " instead of "░"
+  ```
+  This prevents old days from appearing as "missed" when you add a new habit.
+
+- [ ] **Configurable color palette**: Allow customizing colors in `habits.yaml`:
+  ```yaml
+  theme:
+    complete: green
+    partial: yellow
+    low: red
+    title: cyan
+  ```
+  Support both ANSI color names (theme-adaptive) and hex codes (exact colors).
+
+- [ ] **Charts for quantitative habits**: Display line/bar charts for non-boolean habits using [ink-chart](https://github.com/pppp606/ink-chart). Show trends over time for habits like water intake, study minutes, etc.
+
+## License
+
+MIT

package/dist/app.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { type ViewArgs } from './lib/schemas.js';
+type Props = ViewArgs;
+export default function App({ weeks, currentMonth }: Props): React.JSX.Element;
+export {};

package/dist/app.js

@@ -0,0 +1,39 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import Heatmap from './components/Heatmap.js';
+import Warnings from './components/Warnings.js';
+import { useHabitData } from './hooks/useHabitData.js';
+import { PALETTE } from './lib/palette.js';
+export default function App({ weeks, currentMonth }) {
+    const { habits, dates, warnings, loading, error } = useHabitData({
+        weeks,
+        currentMonth,
+    });
+    let content;
+    if (error) {
+        content = (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { color: PALETTE.red },
+                "Error: ",
+                error.message)));
+    }
+    else if (loading) {
+        content = (React.createElement(Box, null,
+            React.createElement(Text, { color: PALETTE.title },
+                React.createElement(Spinner, { type: "dots" })),
+            React.createElement(Text, null, " Scanning journal entries...")));
+    }
+    else if (habits.length === 0) {
+        content = (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { color: PALETTE.yellow }, "No habits configured in .foam/habits.yaml")));
+    }
+    else {
+        content = (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Warnings, { warnings: warnings }),
+            React.createElement(Heatmap, { habits: habits, dates: dates, weeks: weeks, currentMonth: currentMonth })));
+    }
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Text, null, " "),
+        content,
+        React.createElement(Text, null, " ")));
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import React from 'react';
+import { render } from 'ink';
+import meow from 'meow';
+import App from './app.js';
+const cli = meow(`
+	Usage
+	  $ foam-habits [options]
+
+	Options
+	  --weeks, -w       Number of weeks to display (default: 4)
+	  --current-month   Show current month only
+	  --help            Show this help
+
+	Examples
+	  $ foam-habits
+	  $ foam-habits --weeks 12
+	  $ foam-habits --current-month
+`, {
+    importMeta: import.meta,
+    flags: {
+        weeks: {
+            type: 'number',
+            shortFlag: 'w',
+            default: 4,
+        },
+        currentMonth: {
+            type: 'boolean',
+            default: false,
+        },
+    },
+});
+render(React.createElement(App, { weeks: cli.flags.weeks, currentMonth: cli.flags.currentMonth }));

package/dist/components/Cell.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+type CompletionLevel = 0 | 1 | 2 | 3;
+type Props = {
+    level: CompletionLevel;
+};
+export default function Cell({ level }: Props): React.JSX.Element;
+export {};

package/dist/components/Cell.js

@@ -0,0 +1,19 @@
+import React from 'react';
+import { Text } from 'ink';
+import { PALETTE } from '../lib/palette.js';
+const SYMBOLS = {
+    0: '░', // Not done
+    1: '▒', // Low (<50%)
+    2: '▓', // Partial (50-79%)
+    3: '█', // Complete (80%+)
+};
+const COLORS = {
+    0: PALETTE.dimmed,
+    1: PALETTE.red,
+    2: PALETTE.yellow,
+    3: PALETTE.green,
+};
+export default function Cell({ level }) {
+    const color = COLORS[level];
+    return React.createElement(Text, { color: color }, SYMBOLS[level]);
+}

package/dist/components/HabitRow.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { type HabitData } from '../lib/schemas.js';
+type Props = {
+    habit: HabitData;
+    dates: string[];
+    nameWidth: number;
+};
+export default function HabitRow({ habit, dates, nameWidth }: Props): React.JSX.Element;
+export {};

package/dist/components/HabitRow.js

@@ -0,0 +1,31 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+import Cell from './Cell.js';
+import { PALETTE } from '../lib/palette.js';
+import { getCompletionLevel } from '../lib/tracker.js';
+import { truncateVisual, stripVariationSelectors } from '../lib/string-utils.js';
+export default function HabitRow({ habit, dates, nameWidth }) {
+    const streakLabel = habit.streak === 1 ? 'day' : 'days';
+    const showFire = habit.streak > 7;
+    const displayName = truncateVisual(habit.name, nameWidth);
+    // Strip variation selectors for consistent emoji width across terminals
+    const emoji = stripVariationSelectors(habit.emoji);
+    return (React.createElement(Box, null,
+        React.createElement(Box, { minWidth: 3 },
+            React.createElement(Text, null, emoji)),
+        React.createElement(Box, { minWidth: nameWidth + 1 },
+            React.createElement(Text, null, displayName)),
+        React.createElement(Box, null, dates.map(date => {
+            const value = habit.entries[date];
+            const level = getCompletionLevel(value, habit.goal, habit.threshold);
+            return React.createElement(Cell, { key: date, level: level });
+        })),
+        React.createElement(Box, { marginLeft: 1 },
+            React.createElement(Text, { color: PALETTE.dimmed },
+                "(",
+                habit.streak,
+                " ",
+                streakLabel,
+                ")"),
+            showFire && React.createElement(Text, null, " \uD83D\uDD25"))));
+}

package/dist/components/Header.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+type Props = {
+    dates: string[];
+    nameWidth: number;
+    weeks: number;
+    currentMonth: boolean;
+};
+export default function Header({ dates, nameWidth, weeks, currentMonth }: Props): React.JSX.Element;
+export {};

package/dist/components/Header.js

@@ -0,0 +1,65 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+import { format, parseISO } from 'date-fns';
+import { PALETTE } from '../lib/palette.js';
+import { padEndVisual } from '../lib/string-utils.js';
+export default function Header({ dates, nameWidth, weeks, currentMonth }) {
+    const habitLabel = padEndVisual('Habit', nameWidth);
+    const labelColumnWidth = 3 + nameWidth + 1; // emoji (3) + name + space
+    // Track months and build header lines
+    const seenMonths = new Set();
+    // Build month line and day line
+    // Month labels appear at start of each month
+    // Day numbers (2-digit) appear at month starts + every 7 days + last day
+    let monthLine = '';
+    let dayLine = '';
+    dates.forEach((date, index) => {
+        const parsed = parseISO(date);
+        const monthKey = format(parsed, 'yyyy-MM');
+        const day = format(parsed, 'dd'); // 2-digit day (01, 02, ... 31)
+        const monthAbbr = format(parsed, 'MMM');
+        const isFirstOfMonth = !seenMonths.has(monthKey);
+        if (isFirstOfMonth) {
+            seenMonths.add(monthKey);
+        }
+        // Decide what to show at this position
+        const showDayLabel = isFirstOfMonth || index === dates.length - 1 || (index + 1) % 7 === 0;
+        // Month line: show month abbrev at first of each month
+        if (isFirstOfMonth) {
+            // Pad to current position if needed
+            while (monthLine.length < index) {
+                monthLine += ' ';
+            }
+            monthLine += monthAbbr;
+        }
+        // Day line: show 2-digit day at key positions
+        if (showDayLabel) {
+            // Pad to current position if needed
+            while (dayLine.length < index) {
+                dayLine += ' ';
+            }
+            dayLine += day;
+        }
+    });
+    // Pad lines to match dates length
+    while (monthLine.length < dates.length) {
+        monthLine += ' ';
+    }
+    while (dayLine.length < dates.length) {
+        dayLine += ' ';
+    }
+    return (React.createElement(Box, { flexDirection: "column", marginBottom: 1 },
+        React.createElement(Box, { marginBottom: 1 },
+            React.createElement(Text, { bold: true, color: PALETTE.title }, "Foam Habits"),
+            React.createElement(Text, { color: PALETTE.dimmed }, currentMonth
+                ? ` / ${dates[0] ? format(parseISO(dates[0]), 'MMMM yyyy') : ''}`
+                : ` / Last ${weeks * 7} Days`)),
+        React.createElement(Box, null,
+            React.createElement(Box, { minWidth: labelColumnWidth },
+                React.createElement(Text, null, " ")),
+            React.createElement(Text, { color: PALETTE.dimmed }, monthLine)),
+        React.createElement(Box, null,
+            React.createElement(Box, { minWidth: labelColumnWidth },
+                React.createElement(Text, { color: PALETTE.dimmed }, habitLabel)),
+            React.createElement(Text, { color: PALETTE.dimmed }, dayLine))));
+}

package/dist/components/Heatmap.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { type HabitData } from '../lib/schemas.js';
+type Props = {
+    habits: HabitData[];
+    dates: string[];
+    weeks: number;
+    currentMonth: boolean;
+};
+export default function Heatmap({ habits, dates, weeks, currentMonth }: Props): React.JSX.Element;
+export {};

package/dist/components/Heatmap.js

@@ -0,0 +1,14 @@
+import React from 'react';
+import { Box } from 'ink';
+import Header from './Header.js';
+import HabitRow from './HabitRow.js';
+const MAX_NAME_WIDTH = 12;
+const MIN_NAME_WIDTH = 5;
+export default function Heatmap({ habits, dates, weeks, currentMonth }) {
+    // Calculate the max habit name width for alignment (capped at MAX_NAME_WIDTH)
+    const longestName = Math.max(...habits.map(h => h.name.length), MIN_NAME_WIDTH);
+    const nameWidth = Math.min(longestName, MAX_NAME_WIDTH);
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Header, { dates: dates, nameWidth: nameWidth, weeks: weeks, currentMonth: currentMonth }),
+        habits.map(habit => (React.createElement(HabitRow, { key: habit.name, habit: habit, dates: dates, nameWidth: nameWidth })))));
+}

package/dist/components/Warnings.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+type Props = {
+    warnings: string[];
+};
+export default function Warnings({ warnings }: Props): React.JSX.Element | null;
+export {};

package/dist/components/Warnings.js

@@ -0,0 +1,10 @@
+import { Box, Static, Text } from 'ink';
+import React from 'react';
+import { PALETTE } from '../lib/palette.js';
+export default function Warnings({ warnings }) {
+    if (warnings.length === 0) {
+        return null;
+    }
+    return (React.createElement(Static, { items: warnings }, (warning, index) => (React.createElement(Box, { key: index },
+        React.createElement(Text, { color: PALETTE.yellow }, warning)))));
+}

package/dist/hooks/useHabitData.d.ts

@@ -0,0 +1,9 @@
+import { type HabitData, type ViewArgs } from '../lib/schemas.js';
+export type UseHabitDataResult = {
+    habits: HabitData[];
+    dates: string[];
+    warnings: string[];
+    loading: boolean;
+    error: Error | undefined;
+};
+export declare function useHabitData(args: ViewArgs): UseHabitDataResult;

package/dist/hooks/useHabitData.js

@@ -0,0 +1,33 @@
+import { useState, useEffect } from 'react';
+import { loadConfig, getRootDir } from '../lib/config.js';
+import { parseJournals } from '../lib/parser.js';
+import { aggregateHabits, getDateRange } from '../lib/tracker.js';
+export function useHabitData(args) {
+    const [habits, setHabits] = useState([]);
+    const [dates, setDates] = useState([]);
+    const [warnings, setWarnings] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState();
+    useEffect(() => {
+        try {
+            // Load config
+            const config = loadConfig();
+            const rootDir = getRootDir();
+            // Parse journal files
+            const { entries, warnings: parseWarnings } = parseJournals(rootDir, config);
+            // Get date range for display
+            const dateRange = getDateRange(args);
+            // Aggregate habit data
+            const habitData = aggregateHabits(entries, config, dateRange);
+            setHabits(habitData);
+            setDates(dateRange);
+            setWarnings(parseWarnings);
+            setLoading(false);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setLoading(false);
+        }
+    }, [args.weeks, args.currentMonth]);
+    return { habits, dates, warnings, loading, error };
+}

package/dist/lib/__tests__/parser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/__tests__/parser.test.js

@@ -0,0 +1,171 @@
+import test from 'ava';
+import { extractHabitsSection, parseHabitEntries, parseFolderFromTemplate, } from '../parser.js';
+const mockConfig = {
+    habits: {
+        Gym: { emoji: '💪', threshold: 1.0 },
+        'Drink water': { emoji: '💧', goal: '4L', threshold: 1.0 },
+        Study: { emoji: '📖', goal: '30min', threshold: 1.0 },
+        Meditation: { emoji: '🧘', threshold: 1.0 },
+    },
+};
+// extractHabitsSection tests
+test('extractHabitsSection: extracts habits section', t => {
+    const content = `# 2025-01-01
+
+## Habits
+
+- Gym
+- Drink water: 3L
+
+## Notes
+
+Some notes here.`;
+    const result = extractHabitsSection(content);
+    t.truthy(result);
+    t.true(result.includes('- Gym'));
+    t.true(result.includes('- Drink water: 3L'));
+    t.false(result.includes('Some notes'));
+});
+test('extractHabitsSection: handles "Habit" singular', t => {
+    const content = `## Habit
+
+- Gym`;
+    const result = extractHabitsSection(content);
+    t.truthy(result);
+    t.true(result.includes('- Gym'));
+});
+test('extractHabitsSection: case insensitive header', t => {
+    const content = `## HABITS
+
+- Gym`;
+    const result = extractHabitsSection(content);
+    t.truthy(result);
+    t.true(result.includes('- Gym'));
+});
+test('extractHabitsSection: returns undefined when no habits section', t => {
+    const content = `# 2025-01-01
+
+## Notes
+
+Some notes here.`;
+    const result = extractHabitsSection(content);
+    t.is(result, undefined);
+});
+test('extractHabitsSection: stops at next section', t => {
+    const content = `## Habits
+
+- Gym
+
+## Other Section
+
+- Something else`;
+    const result = extractHabitsSection(content);
+    t.truthy(result);
+    t.true(result.includes('- Gym'));
+    t.false(result.includes('Something else'));
+});
+// parseHabitEntries tests
+test('parseHabitEntries: parses boolean habit', t => {
+    const { entries, warnings } = parseHabitEntries('- Gym', '2025-01-01', mockConfig, '2025-01-01.md');
+    t.is(entries.length, 1);
+    t.is(entries[0].name, 'gym');
+    t.is(entries[0].value, 1);
+    t.is(entries[0].date, '2025-01-01');
+    t.is(warnings.length, 0);
+});
+test('parseHabitEntries: parses habit with value', t => {
+    const { entries, warnings } = parseHabitEntries('- Drink water: 3.5L', '2025-01-01', mockConfig, '2025-01-01.md');
+    t.is(entries.length, 1);
+    t.is(entries[0].name, 'drink water');
+    t.is(entries[0].value, 3.5);
+    t.is(warnings.length, 0);
+});
+test('parseHabitEntries: parses multiple habits', t => {
+    const section = `- Gym
+- Drink water: 4L
+- Meditation`;
+    const { entries, warnings } = parseHabitEntries(section, '2025-01-01', mockConfig, '2025-01-01.md');
+    t.is(entries.length, 3);
+    t.is(entries[0].name, 'gym');
+    t.is(entries[1].name, 'drink water');
+    t.is(entries[1].value, 4);
+    t.is(entries[2].name, 'meditation');
+    t.is(warnings.length, 0);
+});
+test('parseHabitEntries: warns on unknown habit', t => {
+    const { entries, warnings } = parseHabitEntries('- Unknown habit', '2025-01-01', mockConfig, '2025-01-01.md');
+    t.is(entries.length, 0);
+    t.is(warnings.length, 1);
+    t.true(warnings[0].includes('Unknown habit'));
+});
+test('parseHabitEntries: case insensitive habit matching', t => {
+    const { entries } = parseHabitEntries('- GYM', '2025-01-01', mockConfig, '2025-01-01.md');
+    t.is(entries.length, 1);
+    t.is(entries[0].name, 'gym');
+});
+test('parseHabitEntries: handles asterisk list marker', t => {
+    const { entries } = parseHabitEntries('* Gym', '2025-01-01', mockConfig, '2025-01-01.md');
+    t.is(entries.length, 1);
+    t.is(entries[0].name, 'gym');
+});
+test('parseHabitEntries: ignores non-list lines', t => {
+    const section = `Some text
+- Gym
+More text`;
+    const { entries } = parseHabitEntries(section, '2025-01-01', mockConfig, '2025-01-01.md');
+    t.is(entries.length, 1);
+});
+test('parseHabitEntries: extracts integer value', t => {
+    const { entries } = parseHabitEntries('- Study: 45min', '2025-01-01', mockConfig, '2025-01-01.md');
+    t.is(entries[0].value, 45);
+});
+// parseFolderFromTemplate tests
+test('parseFolderFromTemplate: extracts folder from standard template', t => {
+    const content = `---
+foam_template:
+  filepath: "/journal/\${FOAM_DATE_YEAR}-\${FOAM_DATE_MONTH}-\${FOAM_DATE_DATE}.md"
+  description: "Daily note template"
+---
+# Content here`;
+    t.is(parseFolderFromTemplate(content), 'journal');
+});
+test('parseFolderFromTemplate: extracts folder without leading slash', t => {
+    const content = `---
+foam_template:
+  filepath: "notes/daily/\${FOAM_DATE}.md"
+---`;
+    t.is(parseFolderFromTemplate(content), 'notes/daily');
+});
+test('parseFolderFromTemplate: handles nested folders', t => {
+    const content = `---
+foam_template:
+  filepath: "/notes/journal/daily/\${FOAM_DATE}.md"
+---`;
+    t.is(parseFolderFromTemplate(content), 'notes/journal/daily');
+});
+test('parseFolderFromTemplate: handles quoted filepath', t => {
+    const content = `---
+foam_template:
+  filepath: '/diary/\${FOAM_DATE}.md'
+---`;
+    t.is(parseFolderFromTemplate(content), 'diary');
+});
+test('parseFolderFromTemplate: returns undefined for missing frontmatter', t => {
+    const content = `# Just a regular markdown file
+No frontmatter here`;
+    t.is(parseFolderFromTemplate(content), undefined);
+});
+test('parseFolderFromTemplate: returns undefined for missing filepath', t => {
+    const content = `---
+foam_template:
+  description: "No filepath here"
+---`;
+    t.is(parseFolderFromTemplate(content), undefined);
+});
+test('parseFolderFromTemplate: returns undefined for filename-only pattern', t => {
+    const content = `---
+foam_template:
+  filepath: "\${FOAM_DATE}.md"
+---`;
+    t.is(parseFolderFromTemplate(content), undefined);
+});

package/dist/lib/__tests__/schemas.test.d.ts

@@ -0,0 +1 @@
+export {};