@atlastodo/shared 0.0.0-stage → 0.1.11-rc.5

package/dist/taskMapper.d.ts

@@ -0,0 +1,3 @@
+import { type CreateTaskInput, type Task } from "@atlastodo/client-core";
+export declare function toTask(id: string, fields: Record<string, unknown>): Task;
+export declare function taskCreateFields(input: CreateTaskInput): Record<string, unknown>;

package/dist/taskOps.d.ts

@@ -0,0 +1,49 @@
+import { type CreateTaskInput, type LocalStore, type Task } from "@atlastodo/client-core";
+/**
+ * The task rules as pure functions over a {@link LocalStore}, with no React.
+ *
+ * - `now` is injected; `timeZone` defaults to the runtime zone.
+ * - Ids come from `store.newEntityId()`, never `crypto.randomUUID()`: Hermes has no global
+ *   `crypto`, and a non-UUID entity id 422s the whole sync push batch.
+ * - Deletes are soft (`deleted_at`); a real tombstone is only issued by an explicit purge.
+ * - A locked task is read-only: every write refuses one this device cannot decrypt.
+ */
+export declare function isTaskLocked(store: LocalStore, id: string): boolean;
+export interface TaskMove {
+    section_id?: string | null;
+    sort_order?: number;
+    due_at?: number | null;
+    parent_id?: string | null;
+}
+export declare function allTasks(store: LocalStore): Task[];
+export declare function visibleTasks(store: LocalStore, tasks?: Task[]): Task[];
+export declare function archivedTasks(store: LocalStore, tasks?: Task[]): Task[];
+export declare function createTask(store: LocalStore, input: CreateTaskInput, timeZone?: string): string;
+/**
+ * Complete or reopen a task. Completing a recurring task with a due date closes this instance and
+ * spawns the next occurrence. `start_at` and absolute reminders move by the same calendar days as
+ * the due date; due-relative reminders carry over with the fire stamp reset. Reopening never spawns.
+ * Returns the spawned id (the UI needs it to undo), or `null`.
+ */
+export declare function toggleTask(store: LocalStore, task: Task, actorId?: string, now?: number, timeZone?: string): string | null;
+export declare function updateTask(store: LocalStore, task: Task, patch: Partial<Task>, actorId?: string, now?: number, timeZone?: string): boolean;
+export type RecurEditScope = "this_occurrence" | "all_occurrences";
+export declare function updateRecurringTask(store: LocalStore, task: Task, patch: Partial<Task>, scope: RecurEditScope, actorId?: string, now?: number, timeZone?: string): boolean;
+/**
+ * Advance a recurring task to its next occurrence without completing it. The due date only moves
+ * forward: an after-completion rule landing before it is a no-op. Returns whether it advanced.
+ */
+export declare function skipTask(store: LocalStore, task: Task, actorId?: string, now?: number, timeZone?: string): boolean;
+export declare function moveTask(store: LocalStore, id: string, patch: TaskMove, now?: number): boolean;
+export declare function reparentTask(store: LocalStore, allTasks: Task[], id: string, parentId: string | null, sortOrder: number, now?: number): boolean;
+export interface TaskProjectMove {
+    project_id: string | null;
+    section_id: string | null;
+    sort_order?: number;
+}
+export declare function moveTaskToProject(store: LocalStore, id: string, target: TaskProjectMove, now?: number): boolean;
+export declare function softDeleteTask(store: LocalStore, task: Task, now?: number): boolean;
+export declare function restoreTask(store: LocalStore, task: Task): boolean;
+export declare function discardTask(store: LocalStore, id: string): boolean;
+export declare function duplicateTask(store: LocalStore, task: Task, timeZone?: string): string | null;
+export declare function setTaskArchived(store: LocalStore, task: Task, archived: boolean, now?: number): boolean;

package/dist/taskSearch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Task text search: case-insensitive substring match on title or notes, ranked with `scoreMatch`
+ * to stay consistent with the command palette.
+ */
+import type { Task } from "@atlastodo/client-core";
+export interface TaskSearchHit {
+    task: Task;
+    field: "title" | "notes";
+}
+export declare const TASK_SEARCH_LIMIT = 20;
+export declare function searchTasks(tasks: Task[], query: string, limit?: number): TaskSearchHit[];

package/dist/taskTree.d.ts

@@ -0,0 +1,53 @@
+import type { Task } from "@atlastodo/client-core";
+import { type RankWrite } from "./reorder.js";
+/**
+ * The subtask tree: a flat `Task[]` as a nested render list, plus the maths for reparenting by drag.
+ *
+ * Siblings default to `sort_order` then `created_at`; a custom order must be injected as a
+ * {@link TaskTreeOrder}, since the build re-orders every level. Orphans (`parent_id` null or
+ * outside the set) render at depth 0 instead of vanishing.
+ */
+export interface TaskTreeNode {
+    task: Task;
+    depth: number;
+    children: TaskTreeNode[];
+}
+export interface FlatTaskRow {
+    task: Task;
+    depth: number;
+    hasChildren: boolean;
+    childCount: number;
+    completedChildCount: number;
+}
+export interface TaskTreeOrder {
+    compareSiblings?: (a: Task, b: Task) => number;
+    compareRoots?: (a: Task, b: Task) => number;
+}
+export declare function buildTaskTree(tasks: Task[], order?: TaskTreeOrder): TaskTreeNode[];
+export declare function flattenTree(tasks: Task[], collapsed?: ReadonlySet<string>, order?: TaskTreeOrder): FlatTaskRow[];
+export declare function rankAfterChildren(tasks: Task[], parentId: string, movedId?: string): number;
+export declare function indentTarget(tasks: Task[], id: string, allTasks?: Task[]): {
+    parent_id: string | null;
+    sort_order: number;
+    writes: RankWrite[];
+} | null;
+export declare function outdentTarget(tasks: Task[], id: string): {
+    parent_id: string | null;
+    sort_order: number;
+    writes: RankWrite[];
+} | null;
+export declare function subtreeProgress(node: TaskTreeNode): {
+    done: number;
+    total: number;
+};
+export declare function wouldCycle(tasks: Task[], movingId: string, candidateParentId: string | null): boolean;
+/**
+ * Resolve a drag over the flattened list into a reparent target. The moved row's depth is
+ * `max(aboveDepth, belowDepth)`, at most one deeper than the row above. `null` for a no-op or a cycle.
+ */
+export declare function resolveIndentTarget(rows: FlatTaskRow[], from: number, to: number): {
+    id: string;
+    parent_id: string | null;
+    sort_order: number;
+    writes: RankWrite[];
+} | null;

package/dist/theme.d.ts

@@ -0,0 +1,14 @@
+export type ThemePref = "light" | "dark" | "system";
+export type ResolvedTheme = "light" | "dark";
+export declare const DEFAULT_THEME: ThemePref;
+export declare function isThemePref(v: unknown): v is ThemePref;
+export declare function resolveTheme(pref: ThemePref, systemDark: boolean): ResolvedTheme;
+export type AccentName = "indigo" | "blue" | "violet" | "emerald" | "amber" | "rose";
+export type AccentScale = Record<50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 900 | 950, string>;
+export declare const ACCENTS: Record<AccentName, AccentScale>;
+export declare const ACCENT_NAMES: AccentName[];
+export declare const ACCENT_LABEL_KEYS: Record<AccentName, string>;
+export declare const DEFAULT_ACCENT: AccentName;
+export declare function isAccentName(v: unknown): v is AccentName;
+export declare function hexToRgbTriad(hex: string): string;
+export declare function accentVars(name: AccentName): Record<string, string>;

package/dist/toast.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Toast state: a tiny pure reducer for add/dismiss/replace, testable without React or timers. The
+ * provider owns the auto-dismiss timeout.
+ */
+export interface ToastAction {
+    label: string;
+    run: () => void;
+}
+export interface Toast {
+    id: string;
+    message: string;
+    action?: ToastAction;
+}
+export type ToastState = Toast[];
+export type ToastEvent = {
+    type: "add";
+    toast: Toast;
+} | {
+    type: "dismiss";
+    id: string;
+};
+/**
+ * Newest toast last; adding an id that already exists replaces it (so re-showing does not stack).
+ */
+export declare function toastReducer(state: ToastState, event: ToastEvent): ToastState;
+export declare const TOAST_TTL_MS = 6000;

package/dist/trash.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Trash. Deleting sets a synced `deleted_at`, recoverable for 30 days. "Delete permanently" and
+ * the sweep issue the real tombstone (`store.remove`). A trashed container's children are hidden
+ * by a read-time cascade and hard-purged with it.
+ */
+import { type EntityKind, type LocalStore } from "@atlastodo/client-core";
+export declare const TRASH_KINDS: EntityKind[];
+export declare const TRASH_RETENTION_MS: number;
+export declare function daysUntilPurge(deletedAt: number, now: number): number;
+export declare function isTrashed(fields: Record<string, unknown>): boolean;
+export declare function restoreEntity(store: LocalStore, kind: EntityKind, id: string): void;
+export declare function softDelete(store: LocalStore, kick: () => void, kind: EntityKind, id: string): () => void;
+export declare function restoreFromTrash(store: LocalStore, kick: () => void, kind: EntityKind, id: string): void;
+export declare function purge(store: LocalStore, kick: () => void, kind: EntityKind, id: string): void;
+export interface TrashItem {
+    kind: EntityKind;
+    id: string;
+    label: string;
+    deletedAt: number;
+    daysLeft: number;
+}
+export declare function listTrash(store: LocalStore, now: number): TrashItem[];
+export declare function sweepExpiredTrash(store: LocalStore, kick: () => void, now: number): number;
+export declare function purgeAllTrash(store: LocalStore, kick: () => void, now: number): number;

package/dist/views.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The app's smart lists: the always-present views that are not a project, filter or feature. Shared
+ * because the stored `default_view` preference is validated against it on every client; routing
+ * stays per app.
+ */
+export type SmartView = "today" | "upcoming" | "inbox" | "all" | "assigned" | "completed";
+export declare const SMART_VIEWS: SmartView[];
+export declare function isSmartView(value: unknown): value is SmartView;

package/dist/zonedTime.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Timezone-aware day-boundary math on `Intl.DateTimeFormat`, the single source of the instant to
+ * calendar-day mapping for smart lists, calendar and quick-add. `timeZone` defaults to the runtime's.
+ */
+export declare function isValidTimeZone(timeZone: string): boolean;
+export declare function resolveTimeZone(timeZone?: string): string;
+export interface ZonedParts {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+    weekday: number;
+}
+export declare function zonedParts(ms: number, timeZone?: string): ZonedParts;
+/**
+ * The inverse of {@link zonedParts}; an offset probe with one correction keeps it stable across
+ * DST. A wall time skipped by a DST gap resolves forward by the gap's length, as RFC 5545 does
+ * (02:30 on a spring-forward night is 03:30).
+ */
+export declare function makeInstant(year: number, month: number, day: number, hour: number, minute: number, second: number, timeZone?: string): number;
+export declare function startOfDay(ms: number, timeZone?: string): number;
+export declare const DEFAULT_DUE_HOUR = 23;
+export declare const DEFAULT_DUE_MINUTE = 59;
+export declare function endOfDay(ms: number, timeZone?: string): number;
+export declare function dayKey(ms: number, timeZone?: string): string;
+export declare function dayOffset(due: number, now: number, timeZone?: string): number;
+export declare function addDays(ms: number, n: number, timeZone?: string): number;
+export declare function shiftWallClockToZone(ms: number, fromZone: string, toZone: string): number;

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@atlastodo/shared",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.11-rc.5",
+  "description": "Atlas shared logic: the portable task rules, recurrence, quick add, filters, i18n and theme used by every Atlas client",
+  "license": "AGPL-3.0-only",
+  "homepage": "https://github.com/atlastodo/atlas-todo/tree/main/packages/shared",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atlastodo/atlas-todo.git",
+    "directory": "packages/shared"
+  },
+  "bugs": {
+    "url": "https://github.com/atlastodo/atlas-todo/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "@atlastodo/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./test-vectors/*": "./test-vectors/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "test-vectors"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "atlas": {
+    "testVectors": [
+      "filter_vectors.json",
+      "quick_add_vectors.json",
+      "recurrence_vectors.json",
+      "task_rules_vectors.json"
+    ]
+  },
+  "scripts": {
+    "build": "bun ../../scripts/build-core-package.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@atlastodo/client-core": "0.1.11-rc.5",
+    "@noble/hashes": "^2.4.0",
+    "fflate": "^0.8.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  }
+}