@todu/core 0.1.0

package/dist/browser.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Browser-safe exports from @todu/core.
+ *
+ * Excludes modules that depend on Node.js APIs:
+ * - config.ts (node:os, node:path)
+ * - schedule.ts (node:crypto)
+ * - validation.ts (imports schedule.ts)
+ *
+ * Use this entry point in Electron renderer and other browser contexts.
+ */
+export * from "./constants.js";
+export * from "./schema.js";
+export * from "./types.js";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/browser.js

@@ -0,0 +1,14 @@
+/**
+ * Browser-safe exports from @todu/core.
+ *
+ * Excludes modules that depend on Node.js APIs:
+ * - config.ts (node:os, node:path)
+ * - schedule.ts (node:crypto)
+ * - validation.ts (imports schedule.ts)
+ *
+ * Use this entry point in Electron renderer and other browser contexts.
+ */
+export * from "./constants.js";
+export * from "./schema.js";
+export * from "./types.js";
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,44 @@
+export declare const DEFAULT_CONFIG_DIR: string;
+export declare const DEFAULT_CONFIG_FILE: string;
+export declare const DEFAULT_DATA_DIR: string;
+export interface ToduFileConfig {
+    /** Path to data directory (absolute or relative to config file) */
+    data_dir?: string;
+}
+/**
+ * Resolve config file path.
+ *
+ * Priority:
+ * 1. Explicit override (e.g. --config flag)
+ * 2. TODU_CONFIG env var
+ * 3. Default: ~/.config/todu/config.yaml
+ */
+export declare function resolveConfigPath(override?: string): string;
+/**
+ * Resolve the data directory path.
+ *
+ * Priority:
+ * 1. TODU_DATA_DIR env var (for tests / backward compat)
+ * 2. data_dir from config file (resolved relative to config file location)
+ * 3. Default: ~/.config/todu/data
+ */
+export declare function resolveDataDir(configPath: string, config: ToduFileConfig): string;
+/**
+ * Describe where each resolved value came from.
+ * Useful for `todu config show` and debugging.
+ */
+export declare function resolveConfigSources(configOverride?: string, config?: ToduFileConfig): {
+    configPath: string;
+    configSource: string;
+    dataDir: string;
+    dataDirSource: string;
+};
+/**
+ * Resolve storage path using env vars and defaults.
+ *
+ * For clients that don't parse config files (e.g. Electron).
+ * Checks TODU_DATA_DIR env var, then falls back to default.
+ * If a config file with data_dir is needed, use resolveDataDir instead.
+ */
+export declare function resolveStoragePath(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAC7E,eAAO,MAAM,mBAAmB,QAA+C,CAAC;AAChF,eAAO,MAAM,gBAAgB,QAAwC,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAcjF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,cAAc,GACtB;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,CAwBA;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C"}

package/dist/config.js

@@ -0,0 +1,94 @@
+import os from "node:os";
+import path from "node:path";
+// ============================================================================
+// Shared configuration resolution
+//
+// Single source of truth for config and data directory paths.
+// Used by CLI, Electron, and any future client.
+//
+// This module handles path resolution only. Config file parsing (YAML)
+// stays in the CLI package which has the yaml dependency.
+// ============================================================================
+export const DEFAULT_CONFIG_DIR = path.join(os.homedir(), ".config", "todu");
+export const DEFAULT_CONFIG_FILE = path.join(DEFAULT_CONFIG_DIR, "config.yaml");
+export const DEFAULT_DATA_DIR = path.join(DEFAULT_CONFIG_DIR, "data");
+/**
+ * Resolve config file path.
+ *
+ * Priority:
+ * 1. Explicit override (e.g. --config flag)
+ * 2. TODU_CONFIG env var
+ * 3. Default: ~/.config/todu/config.yaml
+ */
+export function resolveConfigPath(override) {
+    if (override)
+        return path.resolve(override);
+    if (process.env.TODU_CONFIG)
+        return path.resolve(process.env.TODU_CONFIG);
+    return DEFAULT_CONFIG_FILE;
+}
+/**
+ * Resolve the data directory path.
+ *
+ * Priority:
+ * 1. TODU_DATA_DIR env var (for tests / backward compat)
+ * 2. data_dir from config file (resolved relative to config file location)
+ * 3. Default: ~/.config/todu/data
+ */
+export function resolveDataDir(configPath, config) {
+    // Env var takes precedence (backward compat, tests)
+    if (process.env.TODU_DATA_DIR) {
+        return path.resolve(process.env.TODU_DATA_DIR);
+    }
+    // Config file data_dir
+    if (config.data_dir) {
+        const configDir = path.dirname(configPath);
+        return path.resolve(configDir, config.data_dir);
+    }
+    // Default
+    return DEFAULT_DATA_DIR;
+}
+/**
+ * Describe where each resolved value came from.
+ * Useful for `todu config show` and debugging.
+ */
+export function resolveConfigSources(configOverride, config) {
+    const configPath = resolveConfigPath(configOverride);
+    let configSource;
+    if (configOverride) {
+        configSource = "--config flag";
+    }
+    else if (process.env.TODU_CONFIG) {
+        configSource = "TODU_CONFIG env var";
+    }
+    else {
+        configSource = "default";
+    }
+    const resolvedConfig = config ?? {};
+    const dataDir = resolveDataDir(configPath, resolvedConfig);
+    let dataDirSource;
+    if (process.env.TODU_DATA_DIR) {
+        dataDirSource = "TODU_DATA_DIR env var";
+    }
+    else if (resolvedConfig.data_dir) {
+        dataDirSource = `config file (${configPath})`;
+    }
+    else {
+        dataDirSource = "default";
+    }
+    return { configPath, configSource, dataDir, dataDirSource };
+}
+/**
+ * Resolve storage path using env vars and defaults.
+ *
+ * For clients that don't parse config files (e.g. Electron).
+ * Checks TODU_DATA_DIR env var, then falls back to default.
+ * If a config file with data_dir is needed, use resolveDataDir instead.
+ */
+export function resolveStoragePath() {
+    if (process.env.TODU_DATA_DIR) {
+        return path.resolve(process.env.TODU_DATA_DIR);
+    }
+    return DEFAULT_DATA_DIR;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+/** Automerge document ID for the catalog (stable, well-known) */
+export declare const CATALOG_DOC_KEY = "todu-catalog";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,eAAe,iBAAiB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,3 @@
+/** Automerge document ID for the catalog (stable, well-known) */
+export const CATALOG_DOC_KEY = "todu-catalog";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./config.js";
+export * from "./constants.js";
+export * from "./schedule.js";
+export * from "./schema.js";
+export * from "./types.js";
+export * from "./validation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./config.js";
+export * from "./constants.js";
+export * from "./schedule.js";
+export * from "./schema.js";
+export * from "./types.js";
+export * from "./validation.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/schedule.d.ts

@@ -0,0 +1,39 @@
+import type { TaskId } from "./types.js";
+import { type ValidationError } from "./types.js";
+/**
+ * Generate a deterministic task ID from a template/habit ID and a date.
+ * Same inputs always produce the same output, across all devices.
+ *
+ * Used to prevent duplicate task generation when multiple devices
+ * process the same recurring template independently.
+ */
+export declare function generateScheduledTaskId(templateId: string, date: string): TaskId;
+/**
+ * Validate an RRULE string at the format level.
+ * This is a lightweight check for @todu/core (no RRULE library dependency).
+ * Full parsing and occurrence calculation happens in @todu/engine.
+ *
+ * Checks:
+ * - Must contain FREQ= with an allowed frequency
+ * - No sub-daily frequencies (HOURLY, MINUTELY, SECONDLY)
+ * - Only known RRULE parts
+ */
+export declare function validateRRule(rule: string): ValidationError | null;
+/**
+ * Validate a date string is in YYYY-MM-DD format and represents a real date.
+ */
+export declare function validateDateString(field: string, value: string): ValidationError | null;
+/**
+ * Validate a timezone string is a valid IANA timezone.
+ */
+export declare function validateTimezone(timezone: string): ValidationError | null;
+/**
+ * Validate a complete ScheduleDefinition.
+ */
+export declare function validateScheduleDefinition(schedule: {
+    rule: string;
+    timezone: string;
+    startDate: string;
+    endDate?: string;
+}): ValidationError | null;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../src/schedule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AAMpB;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhF;AAMD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA0ClE;AAQD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAavF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAOzE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,eAAe,GAAG,IAAI,CAqBzB"}

package/dist/schedule.js

@@ -0,0 +1,114 @@
+import crypto from "node:crypto";
+import { ALLOWED_FREQUENCIES, createTaskId, validationError, } from "./types.js";
+// ============================================================================
+// Deterministic ID generation
+// ============================================================================
+/**
+ * Generate a deterministic task ID from a template/habit ID and a date.
+ * Same inputs always produce the same output, across all devices.
+ *
+ * Used to prevent duplicate task generation when multiple devices
+ * process the same recurring template independently.
+ */
+export function generateScheduledTaskId(templateId, date) {
+    const hash = crypto.createHash("sha256").update(`${templateId}|${date}`).digest("hex");
+    return createTaskId(`sched-${hash.slice(0, 12)}`);
+}
+// ============================================================================
+// RRULE validation (basic format checks — no library dependency)
+// ============================================================================
+/**
+ * Validate an RRULE string at the format level.
+ * This is a lightweight check for @todu/core (no RRULE library dependency).
+ * Full parsing and occurrence calculation happens in @todu/engine.
+ *
+ * Checks:
+ * - Must contain FREQ= with an allowed frequency
+ * - No sub-daily frequencies (HOURLY, MINUTELY, SECONDLY)
+ * - Only known RRULE parts
+ */
+export function validateRRule(rule) {
+    if (!rule || rule.trim().length === 0) {
+        return validationError("schedule", "RRULE is required");
+    }
+    const parts = rule.split(";");
+    let foundFreq = false;
+    for (const part of parts) {
+        const [key, value] = part.split("=", 2);
+        if (!key || !value) {
+            return validationError("schedule", `Invalid RRULE part: ${part}`);
+        }
+        const upperKey = key.toUpperCase();
+        if (upperKey === "FREQ") {
+            foundFreq = true;
+            const upperValue = value.toUpperCase();
+            // Reject sub-daily frequencies
+            if (upperValue === "HOURLY" || upperValue === "MINUTELY" || upperValue === "SECONDLY") {
+                return validationError("schedule", `Sub-daily frequency "${upperValue}" is not supported. Use DAILY, WEEKLY, MONTHLY, or YEARLY.`);
+            }
+            if (!ALLOWED_FREQUENCIES.includes(upperValue)) {
+                return validationError("schedule", `Invalid frequency: ${upperValue}. Must be one of: ${ALLOWED_FREQUENCIES.join(", ")}`);
+            }
+        }
+    }
+    if (!foundFreq) {
+        return validationError("schedule", "RRULE must contain FREQ=");
+    }
+    return null;
+}
+// ============================================================================
+// Date format validation
+// ============================================================================
+const DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * Validate a date string is in YYYY-MM-DD format and represents a real date.
+ */
+export function validateDateString(field, value) {
+    if (!DATE_REGEX.test(value)) {
+        return validationError(field, `Invalid date format: ${value} (expected YYYY-MM-DD)`);
+    }
+    // Verify it's a real date (e.g., reject 2026-02-30)
+    const [year, month, day] = value.split("-").map(Number);
+    const date = new Date(year, month - 1, day);
+    if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
+        return validationError(field, `Invalid date: ${value}`);
+    }
+    return null;
+}
+/**
+ * Validate a timezone string is a valid IANA timezone.
+ */
+export function validateTimezone(timezone) {
+    try {
+        Intl.DateTimeFormat(undefined, { timeZone: timezone });
+        return null;
+    }
+    catch {
+        return validationError("timezone", `Invalid timezone: ${timezone}`);
+    }
+}
+/**
+ * Validate a complete ScheduleDefinition.
+ */
+export function validateScheduleDefinition(schedule) {
+    const ruleError = validateRRule(schedule.rule);
+    if (ruleError)
+        return ruleError;
+    const tzError = validateTimezone(schedule.timezone);
+    if (tzError)
+        return tzError;
+    const startError = validateDateString("startDate", schedule.startDate);
+    if (startError)
+        return startError;
+    if (schedule.endDate !== undefined) {
+        const endError = validateDateString("endDate", schedule.endDate);
+        if (endError)
+            return endError;
+        // endDate must be after startDate
+        if (schedule.endDate <= schedule.startDate) {
+            return validationError("endDate", "End date must be after start date");
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=schedule.js.map

package/dist/schedule.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,82 @@
+import type { Habit, HabitEntry, HabitId, Label, Note, Project, ProjectId, RecurringTemplate, Settings, Task } from "./types.js";
+/**
+ * Catalog document (one per todu instance).
+ * Contains all small/bounded data: projects, labels, habits, settings,
+ * recurring templates, and external system registrations.
+ */
+export interface CatalogDocument {
+    /** Schema version for migration support */
+    version: number;
+    /** All projects */
+    projects: Project[];
+    /** All labels */
+    labels: Label[];
+    /**
+     * Map of projectId → Automerge document ID for that project's task list.
+     * Populated when the first task is created in a project.
+     */
+    taskListDocIds: Record<string, string>;
+    /** Automerge document ID for the notes document */
+    notesDocId?: string;
+    /** Recurring task templates */
+    recurringTemplates: RecurringTemplate[];
+    /** Habit definitions */
+    habits: Habit[];
+    /** Map of habitId → Automerge document ID for that habit's log */
+    habitLogDocIds: Record<string, string>;
+    /** Application settings */
+    settings: Settings;
+}
+/**
+ * Task list document (one per project).
+ * Contains task metadata only — no descriptions or heavy content.
+ * Each task is ~200 bytes, so a project with 1000 tasks ≈ 200KB.
+ */
+export interface TaskListDocument {
+    /** Project this task list belongs to */
+    projectId: ProjectId;
+    /** Task metadata entries */
+    tasks: Task[];
+    /**
+     * Map of taskId → Automerge document ID for that task's detail doc.
+     * Loaded on demand when task.get() is called.
+     */
+    detailDocIds: Record<string, string>;
+}
+/**
+ * Task detail document (one per task).
+ * Contains the description and any heavy content.
+ * Loaded on demand, not during list operations.
+ */
+export interface TaskDetailDocument {
+    /** The task this detail belongs to */
+    taskId: string;
+    /** Full task description (markdown) */
+    description: string;
+}
+/**
+ * Notes document (one global).
+ * Contains all notes — standalone journal entries and entity-attached notes.
+ * Each note is ~200B, so thousands fit comfortably.
+ */
+export interface NotesDocument {
+    /** All notes */
+    notes: Note[];
+}
+/**
+ * Habit log document (one per habit).
+ * Contains check-in entries keyed by date for deterministic multi-device merging.
+ */
+export interface HabitLogDocument {
+    /** Which habit this log belongs to */
+    habitId: string;
+    /** Check-in entries keyed by date (YYYY-MM-DD) */
+    entries: Record<string, HabitEntry>;
+}
+export declare const SCHEMA_VERSION = 1;
+export declare function createEmptyCatalog(): CatalogDocument;
+export declare function createTaskListDocument(projectId: ProjectId): TaskListDocument;
+export declare function createTaskDetailDocument(taskId: string, description: string): TaskDetailDocument;
+export declare function createNotesDocument(): NotesDocument;
+export declare function createHabitLogDocument(habitId: HabitId): HabitLogDocument;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,OAAO,EACP,KAAK,EACL,IAAI,EACJ,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACL,MAAM,YAAY,CAAC;AAMpB;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,mBAAmB;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEpB,iBAAiB;IACjB,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,+BAA+B;IAC/B,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IAExC,wBAAwB;IACxB,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB,oEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,CAAC;CAIpB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,SAAS,EAAE,SAAS,CAAC;IAErB,4BAA4B;IAC5B,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACrC;AAMD,eAAO,MAAM,cAAc,IAAI,CAAC;AAMhC,wBAAgB,kBAAkB,IAAI,eAAe,CAapD;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAM7E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAKhG;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAInD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAKzE"}

package/dist/schema.js

@@ -0,0 +1,46 @@
+// ============================================================================
+// Schema version
+// ============================================================================
+export const SCHEMA_VERSION = 1;
+// ============================================================================
+// Factory functions
+// ============================================================================
+export function createEmptyCatalog() {
+    return {
+        version: SCHEMA_VERSION,
+        projects: [],
+        labels: [],
+        taskListDocIds: {},
+        recurringTemplates: [],
+        habits: [],
+        habitLogDocIds: {},
+        settings: {
+            schemaVersion: SCHEMA_VERSION,
+        },
+    };
+}
+export function createTaskListDocument(projectId) {
+    return {
+        projectId,
+        tasks: [],
+        detailDocIds: {},
+    };
+}
+export function createTaskDetailDocument(taskId, description) {
+    return {
+        taskId,
+        description,
+    };
+}
+export function createNotesDocument() {
+    return {
+        notes: [],
+    };
+}
+export function createHabitLogDocument(habitId) {
+    return {
+        habitId,
+        entries: {},
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AA+GA,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,GAAoB;IACpD,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;QACV,cAAc,EAAE,EAAE;QAClB,kBAAkB,EAAE,EAAE;QACtB,MAAM,EAAE,EAAE;QACV,cAAc,EAAE,EAAE;QAClB,QAAQ,EAAE;YACR,aAAa,EAAE,cAAc;SAC9B;KACF,CAAC;AAAA,CACH;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAoB,EAAoB;IAC7E,OAAO;QACL,SAAS;QACT,KAAK,EAAE,EAAE;QACT,YAAY,EAAE,EAAE;KACjB,CAAC;AAAA,CACH;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,WAAmB,EAAsB;IAChG,OAAO;QACL,MAAM;QACN,WAAW;KACZ,CAAC;AAAA,CACH;AAED,MAAM,UAAU,mBAAmB,GAAkB;IACnD,OAAO;QACL,KAAK,EAAE,EAAE;KACV,CAAC;AAAA,CACH;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAoB;IACzE,OAAO;QACL,OAAO;QACP,OAAO,EAAE,EAAE;KACZ,CAAC;AAAA,CACH"}