@noteplanco/noteplan-mcp 1.1.1

package/dist/tools/ui.js

@@ -0,0 +1,137 @@
+// AppleScript-based UI control tools for NotePlan
+import { z } from 'zod';
+import { escapeAppleScript, runAppleScript, APP_NAME } from '../utils/applescript.js';
+// --- Schemas ---
+export const openNoteSchema = z.object({
+    title: z.string().optional().describe('Title of the note to open'),
+    filename: z.string().optional().describe('Filename of the note to open'),
+    inNewWindow: z.boolean().optional().default(false).describe('Open in a new window'),
+    inSplitView: z.boolean().optional().default(false).describe('Open in split view'),
+});
+export const openTodaySchema = z.object({});
+export const searchNotesSchema = z.object({
+    query: z.string().describe('Search text'),
+});
+export const runPluginSchema = z.object({
+    pluginId: z.string().describe('Plugin ID'),
+    command: z.string().describe('Command name'),
+    arguments: z.string().optional().describe('JSON arguments string'),
+});
+export const reloadPluginsSchema = z.object({});
+export const openViewSchema = z.object({
+    name: z.string().describe('Name of the view to open'),
+});
+export const toggleSidebarSchema = z.object({});
+export const closePluginWindowSchema = z.object({
+    windowID: z.string().optional().describe('Window ID to close (exact match)'),
+    title: z.string().optional().describe('Window title to close (case-insensitive match). Omit both windowID and title to close all plugin windows.'),
+});
+export const listPluginWindowsSchema = z.object({});
+// --- Implementations ---
+export function openNote(args) {
+    const { title, filename, inNewWindow, inSplitView } = openNoteSchema.parse(args);
+    if (!title && !filename) {
+        return { success: false, message: 'Either title or filename is required' };
+    }
+    let params = '';
+    if (title) {
+        params += ` titled "${escapeAppleScript(title)}"`;
+    }
+    if (filename) {
+        params += ` at path "${escapeAppleScript(filename)}"`;
+    }
+    if (inNewWindow) {
+        params += ' in new window true';
+    }
+    if (inSplitView) {
+        params += ' in split view true';
+    }
+    params += ' in background true';
+    const script = `tell application "${APP_NAME}" to showNote${params}`;
+    runAppleScript(script);
+    return { success: true, message: `Opened note${title ? ` "${title}"` : ` (${filename})`}` };
+}
+export function openToday(_args) {
+    const script = `tell application "${APP_NAME}" to openToday`;
+    runAppleScript(script);
+    return { success: true, message: "Opened today's note" };
+}
+export function searchNotes(args) {
+    const { query } = searchNotesSchema.parse(args);
+    const script = `tell application "${APP_NAME}" to searchNotes for "${escapeAppleScript(query)}" in background true`;
+    runAppleScript(script);
+    return { success: true, message: `Searching for "${query}"` };
+}
+export function runPlugin(args) {
+    const { pluginId, command, arguments: pluginArgs } = runPluginSchema.parse(args);
+    let params = `with id "${escapeAppleScript(pluginId)}" with command "${escapeAppleScript(command)}"`;
+    if (pluginArgs) {
+        params += ` with arguments "${escapeAppleScript(pluginArgs)}"`;
+    }
+    const script = `tell application "${APP_NAME}" to executePlugin ${params}`;
+    runAppleScript(script);
+    return { success: true, message: `Ran plugin ${pluginId} command "${command}"` };
+}
+export function reloadPlugins(_args) {
+    const script = `tell application "${APP_NAME}" to reloadPlugins`;
+    runAppleScript(script);
+    return { success: true, message: 'Plugins reloaded' };
+}
+export function openView(args) {
+    const { name } = openViewSchema.parse(args);
+    const script = `tell application "${APP_NAME}" to openView named "${escapeAppleScript(name)}"`;
+    runAppleScript(script);
+    return { success: true, message: `Opened view "${name}"` };
+}
+export function toggleSidebar(_args) {
+    const script = `tell application "${APP_NAME}" to toggleSidebar`;
+    runAppleScript(script);
+    return { success: true, message: 'Sidebar toggled' };
+}
+export function closePluginWindow(args) {
+    const { windowID, title } = closePluginWindowSchema.parse(args);
+    let params = '';
+    if (windowID) {
+        params = ` with id "${escapeAppleScript(windowID)}"`;
+    }
+    else if (title) {
+        params = ` titled "${escapeAppleScript(title)}"`;
+    }
+    const script = `tell application "${APP_NAME}" to closePluginWindow${params}`;
+    const result = runAppleScript(script);
+    // NotePlan currently returns "true" regardless of whether a window was closed.
+    // Parse the result for future-proofing in case NotePlan adds proper return values.
+    const closed = result !== 'false';
+    if (windowID) {
+        return { success: closed, message: closed ? `Closed plugin window "${windowID}"` : `No plugin window found with ID "${windowID}"` };
+    }
+    else if (title) {
+        return {
+            success: closed,
+            message: closed ? `Closed plugin window titled "${title}"` : `No plugin window found titled "${title}"`,
+        };
+    }
+    return { success: closed, message: closed ? 'Closed all plugin windows' : 'No plugin windows were open' };
+}
+export function listPluginWindows(_args) {
+    let raw;
+    try {
+        raw = runAppleScript(`tell application "${APP_NAME}" to listPluginWindows`, 15_000);
+    }
+    catch (e) {
+        return { success: false, error: `Failed to list plugin windows: ${e.message}` };
+    }
+    let windows;
+    try {
+        windows = JSON.parse(raw);
+    }
+    catch {
+        return { success: false, error: 'Failed to parse plugin windows list from NotePlan' };
+    }
+    return {
+        success: true,
+        count: windows.length,
+        windows,
+    };
+}
+//# sourceMappingURL=ui.js.map

package/dist/tools/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/tools/ui.ts"],"names":[],"mappings":"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"}

package/dist/utils/applescript.d.ts

@@ -0,0 +1,5 @@
+export declare const APPLESCRIPT_TIMEOUT_MS = 15000;
+export declare const APP_NAME = "NotePlan";
+export declare function escapeAppleScript(str: string): string;
+export declare function runAppleScript(script: string, timeoutMs?: number): string;
+//# sourceMappingURL=applescript.d.ts.map

package/dist/utils/applescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.d.ts","sourceRoot":"","sources":["../../src/utils/applescript.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,QAAQ,aAAa,CAAC;AAEnC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAyB,GAAG,MAAM,CAczF"}

package/dist/utils/applescript.js

@@ -0,0 +1,27 @@
+// Shared AppleScript utilities for NotePlan MCP tools
+import { execFileSync } from 'child_process';
+export const APPLESCRIPT_TIMEOUT_MS = 15_000;
+export const APP_NAME = 'NotePlan';
+export function escapeAppleScript(str) {
+    return str
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/[\x00-\x1f]/g, ' ');
+}
+export function runAppleScript(script, timeoutMs = APPLESCRIPT_TIMEOUT_MS) {
+    try {
+        return execFileSync('osascript', ['-e', script], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: timeoutMs,
+        }).trim();
+    }
+    catch (error) {
+        if (error.killed) {
+            throw new Error('AppleScript timed out');
+        }
+        const stderr = (error.stderr || '').trim();
+        throw new Error(stderr || error.message || 'AppleScript execution failed');
+    }
+}
+//# sourceMappingURL=applescript.js.map

package/dist/utils/applescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.js","sourceRoot":"","sources":["../../src/utils/applescript.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AAEnC,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,GAAG;SACP,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,SAAS,GAAG,sBAAsB;IAC/E,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;YAC/C,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,8BAA8B,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/utils/confirmation-tokens.d.ts

@@ -0,0 +1,19 @@
+type ConfirmationContext = {
+    tool: string;
+    target: string;
+    action: string;
+};
+type ConfirmationFailureReason = 'missing' | 'invalid' | 'expired' | 'mismatch';
+export type ConfirmationValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: ConfirmationFailureReason;
+};
+export declare function issueConfirmationToken(context: ConfirmationContext, ttlMs?: number): {
+    confirmationToken: string;
+    confirmationExpiresAt: string;
+};
+export declare function validateAndConsumeConfirmationToken(token: unknown, context: ConfirmationContext): ConfirmationValidationResult;
+export {};
+//# sourceMappingURL=confirmation-tokens.d.ts.map

package/dist/utils/confirmation-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation-tokens.d.ts","sourceRoot":"","sources":["../../src/utils/confirmation-tokens.ts"],"names":[],"mappings":"AAIA,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAOF,KAAK,yBAAyB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEhF,MAAM,MAAM,4BAA4B,GACpC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAwBrD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,SAA8B,GAClC;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAA;CAAE,CAW9D;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,mBAAmB,GAC3B,4BAA4B,CA+B9B"}

package/dist/utils/confirmation-tokens.js

@@ -0,0 +1,58 @@
+import { randomUUID } from 'crypto';
+const DEFAULT_CONFIRMATION_TTL_MS = 10 * 60 * 1000;
+const confirmationStore = new Map();
+function normalize(value) {
+    return value.trim().toLowerCase();
+}
+function normalizeContext(context) {
+    return {
+        tool: normalize(context.tool),
+        target: normalize(context.target),
+        action: normalize(context.action),
+    };
+}
+function cleanupExpired(nowMs) {
+    for (const [token, stored] of confirmationStore.entries()) {
+        if (stored.expiresAt <= nowMs) {
+            confirmationStore.delete(token);
+        }
+    }
+}
+export function issueConfirmationToken(context, ttlMs = DEFAULT_CONFIRMATION_TTL_MS) {
+    const token = randomUUID();
+    const expiresAtMs = Date.now() + ttlMs;
+    confirmationStore.set(token, {
+        context: normalizeContext(context),
+        expiresAt: expiresAtMs,
+    });
+    return {
+        confirmationToken: token,
+        confirmationExpiresAt: new Date(expiresAtMs).toISOString(),
+    };
+}
+export function validateAndConsumeConfirmationToken(token, context) {
+    if (typeof token !== 'string' || token.trim().length === 0) {
+        return { ok: false, reason: 'missing' };
+    }
+    const nowMs = Date.now();
+    cleanupExpired(nowMs);
+    const stored = confirmationStore.get(token);
+    if (!stored) {
+        return { ok: false, reason: 'invalid' };
+    }
+    if (stored.expiresAt <= nowMs) {
+        confirmationStore.delete(token);
+        return { ok: false, reason: 'expired' };
+    }
+    const expected = normalizeContext(context);
+    const matches = stored.context.tool === expected.tool &&
+        stored.context.target === expected.target &&
+        stored.context.action === expected.action;
+    if (!matches) {
+        confirmationStore.delete(token);
+        return { ok: false, reason: 'mismatch' };
+    }
+    confirmationStore.delete(token);
+    return { ok: true };
+}
+//# sourceMappingURL=confirmation-tokens.js.map

package/dist/utils/confirmation-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation-tokens.js","sourceRoot":"","sources":["../../src/utils/confirmation-tokens.ts"],"names":[],"mappings":"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"}

package/dist/utils/date-filters.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parse flexible date strings like "today", "yesterday", "this week"
+ * Returns a Date object representing the start of the period
+ */
+export declare function parseFlexibleDateFilter(input: string): Date | null;
+/**
+ * Check if a date falls within the specified range
+ */
+export declare function isDateInRange(date: Date | undefined, after?: Date | null, before?: Date | null): boolean;
+/**
+ * Get the end date for a period filter (for "before" comparisons)
+ * For example, "this week" should include all of today
+ */
+export declare function getFilterEndDate(input: string): Date | null;
+//# sourceMappingURL=date-filters.d.ts.map

package/dist/utils/date-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-filters.d.ts","sourceRoot":"","sources":["../../src/utils/date-filters.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAqDlE;AASD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,EACnB,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GACnB,OAAO,CAKT;AAcD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAiC3D"}

package/dist/utils/date-filters.js

@@ -0,0 +1,129 @@
+// Date filtering utilities for search
+import { getFirstDayOfWeekCached } from '../noteplan/preferences.js';
+/**
+ * Get the start of the week for a given date, respecting NotePlan's firstDayOfWeek setting
+ * @param date The reference date
+ * @param firstDayOfWeek 0 = Sunday, 1 = Monday, ..., 6 = Saturday
+ */
+function getStartOfWeek(date, firstDayOfWeek) {
+    const day = date.getDay(); // 0 = Sunday, 1 = Monday, etc.
+    // Calculate days to subtract to get to the first day of the week
+    const daysToSubtract = (day - firstDayOfWeek + 7) % 7;
+    const weekStart = new Date(date);
+    weekStart.setDate(date.getDate() - daysToSubtract);
+    return startOfDay(weekStart);
+}
+/**
+ * Parse flexible date strings like "today", "yesterday", "this week"
+ * Returns a Date object representing the start of the period
+ */
+export function parseFlexibleDateFilter(input) {
+    const lower = input.toLowerCase().trim();
+    const now = new Date();
+    switch (lower) {
+        case 'today':
+            return startOfDay(now);
+        case 'yesterday':
+            return startOfDay(new Date(now.getTime() - 24 * 60 * 60 * 1000));
+        case 'this week': {
+            const firstDayOfWeek = getFirstDayOfWeekCached();
+            return getStartOfWeek(now, firstDayOfWeek);
+        }
+        case 'last week': {
+            const firstDayOfWeek = getFirstDayOfWeekCached();
+            const thisWeekStart = getStartOfWeek(now, firstDayOfWeek);
+            const lastWeekStart = new Date(thisWeekStart);
+            lastWeekStart.setDate(lastWeekStart.getDate() - 7);
+            return lastWeekStart;
+        }
+        case 'this month':
+            return new Date(now.getFullYear(), now.getMonth(), 1);
+        case 'last month':
+            return new Date(now.getFullYear(), now.getMonth() - 1, 1);
+        case 'this year':
+            return new Date(now.getFullYear(), 0, 1);
+        case 'last year':
+            return new Date(now.getFullYear() - 1, 0, 1);
+        default:
+            // Try ISO date parse (YYYY-MM-DD)
+            const isoMatch = input.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+            if (isoMatch) {
+                return new Date(parseInt(isoMatch[1]), parseInt(isoMatch[2]) - 1, parseInt(isoMatch[3]));
+            }
+            // Try YYYYMMDD format
+            const yyyymmdd = input.match(/^(\d{4})(\d{2})(\d{2})$/);
+            if (yyyymmdd) {
+                return new Date(parseInt(yyyymmdd[1]), parseInt(yyyymmdd[2]) - 1, parseInt(yyyymmdd[3]));
+            }
+            // Try general Date parse
+            const parsed = new Date(input);
+            return isNaN(parsed.getTime()) ? null : parsed;
+    }
+}
+/**
+ * Get the start of a day (midnight)
+ */
+function startOfDay(date) {
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate());
+}
+/**
+ * Check if a date falls within the specified range
+ */
+export function isDateInRange(date, after, before) {
+    if (!date)
+        return false;
+    if (after && date < after)
+        return false;
+    if (before && date > before)
+        return false;
+    return true;
+}
+/**
+ * Get the end of the week for a given date, respecting NotePlan's firstDayOfWeek setting
+ * @param date The reference date
+ * @param firstDayOfWeek 0 = Sunday, 1 = Monday, ..., 6 = Saturday
+ */
+function getEndOfWeek(date, firstDayOfWeek) {
+    const weekStart = getStartOfWeek(date, firstDayOfWeek);
+    const weekEnd = new Date(weekStart);
+    weekEnd.setDate(weekStart.getDate() + 6); // Week is 7 days, end is start + 6
+    return endOfDay(weekEnd);
+}
+/**
+ * Get the end date for a period filter (for "before" comparisons)
+ * For example, "this week" should include all of today
+ */
+export function getFilterEndDate(input) {
+    const lower = input.toLowerCase().trim();
+    const now = new Date();
+    switch (lower) {
+        case 'today':
+            return endOfDay(now);
+        case 'yesterday':
+            return endOfDay(new Date(now.getTime() - 24 * 60 * 60 * 1000));
+        case 'this week': {
+            const firstDayOfWeek = getFirstDayOfWeekCached();
+            return getEndOfWeek(now, firstDayOfWeek);
+        }
+        case 'last week': {
+            const firstDayOfWeek = getFirstDayOfWeekCached();
+            const thisWeekStart = getStartOfWeek(now, firstDayOfWeek);
+            const lastWeekStart = new Date(thisWeekStart);
+            lastWeekStart.setDate(lastWeekStart.getDate() - 7);
+            return getEndOfWeek(lastWeekStart, firstDayOfWeek);
+        }
+        case 'this month':
+            return new Date(now.getFullYear(), now.getMonth() + 1, 0, 23, 59, 59, 999);
+        case 'last month':
+            return new Date(now.getFullYear(), now.getMonth(), 0, 23, 59, 59, 999);
+        default:
+            return null;
+    }
+}
+/**
+ * Get the end of a day (23:59:59.999)
+ */
+function endOfDay(date) {
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate(), 23, 59, 59, 999);
+}
+//# sourceMappingURL=date-filters.js.map

package/dist/utils/date-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-filters.js","sourceRoot":"","sources":["../../src/utils/date-filters.ts"],"names":[],"mappings":"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"}

package/dist/utils/date-utils.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Get today's date in YYYYMMDD format
+ */
+export declare function getTodayDateString(): string;
+/**
+ * Format a Date object to YYYYMMDD string
+ */
+export declare function formatDateString(date: Date): string;
+/**
+ * Parse YYYYMMDD string to Date object
+ */
+export declare function parseDateString(dateStr: string): Date | null;
+/**
+ * Get the calendar note filename for a date
+ * Returns path like Calendar/2024/20240115.md
+ */
+export declare function getCalendarNotePath(dateStr: string): string;
+/**
+ * Get the weekly note filename for a date
+ * Returns path like Calendar/2024/2024-W03.md
+ */
+export declare function getWeeklyNotePath(date: Date): string;
+/**
+ * Get ISO week number for a date
+ */
+export declare function getWeekNumber(date: Date): number;
+/**
+ * Get ISO week year for a date (can differ from calendar year at year boundaries)
+ * For example: Dec 30, 2024 is in Week 1 of 2025
+ */
+export declare function getISOWeekYear(date: Date): number;
+/**
+ * Get both ISO week number and year
+ */
+export declare function getISOWeek(date: Date): {
+    week: number;
+    year: number;
+};
+/**
+ * Get week number respecting a custom first day of week
+ * @param date The date to get the week for
+ * @param firstDayOfWeek 0 = Sunday, 1 = Monday, ..., 6 = Saturday
+ * @returns Week number and year
+ *
+ * Week 1 is defined as the week containing January 1
+ */
+export declare function getWeekWithFirstDay(date: Date, firstDayOfWeek: number): {
+    week: number;
+    year: number;
+};
+/**
+ * Get week number and year respecting NotePlan's firstDayOfWeek preference
+ */
+export declare function getWeekRespectingPreference(date: Date): {
+    week: number;
+    year: number;
+};
+/**
+ * Parse a date input string that could be:
+ * - YYYYMMDD
+ * - YYYY-MM-DD
+ * - today
+ * - tomorrow
+ * - yesterday
+ */
+export declare function parseFlexibleDate(input: string): string;
+/**
+ * Format a date string for display
+ */
+export declare function formatDateForDisplay(dateStr: string): string;
+/**
+ * Check if a filename is a calendar note
+ */
+export declare function isCalendarNoteFilename(filename: string): boolean;
+/**
+ * Extract date from calendar note filename
+ */
+export declare function extractDateFromFilename(filename: string): string | null;
+/**
+ * Calendar note types
+ */
+export type CalendarNoteType = 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+/**
+ * Get the type of calendar note from its filename
+ */
+export declare function getCalendarNoteType(filename: string): CalendarNoteType | null;
+/**
+ * Get the monthly note filename for a date
+ * Returns path like Calendar/2024/2024-01.md
+ */
+export declare function getMonthlyNotePath(date: Date, hasYearSubfolders?: boolean): string;
+/**
+ * Get the quarterly note filename for a date
+ * Returns path like Calendar/2024/2024-Q1.md
+ */
+export declare function getQuarterlyNotePath(date: Date, hasYearSubfolders?: boolean): string;
+/**
+ * Get the yearly note filename for a date
+ * Returns path like Calendar/2024/2024.md
+ */
+export declare function getYearlyNotePath(date: Date, hasYearSubfolders?: boolean): string;
+/**
+ * Get a date range for a period
+ */
+export declare function getDateRange(period: 'today' | 'yesterday' | 'this-week' | 'last-week' | 'this-month' | 'last-month' | string, customStart?: string, customEnd?: string): {
+    start: Date;
+    end: Date;
+};
+/**
+ * Generate all dates in a range
+ */
+export declare function getDatesInRange(start: Date, end: Date): Date[];
+//# sourceMappingURL=date-utils.d.ts.map

package/dist/utils/date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../src/utils/date-utils.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAM5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKrE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,cAAc,EAAE,MAAM,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmDhC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAGtF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiCvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBvE;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEvF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAO7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,iBAAiB,GAAE,OAAc,GAAG,MAAM,CAKxF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,iBAAiB,GAAE,OAAc,GAAG,MAAM,CAK1F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,iBAAiB,GAAE,OAAc,GAAG,MAAM,CAIvF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,EAChG,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,CAsD5B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,EAAE,CAU9D"}