@jibone/todotxt-core 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -133,6 +133,7 @@ await todos.createdAfter("2024-01-01"); // TodoRecord[]
133
133
  await todos.notProject("Garden"); // TodoRecord[]
134
134
  await todos.count(); // number
135
135
  await todos.first(); // TodoRecord | undefined
136
+ await todos.summary(); // TodoSummary
136
137
  ```
137
138
 
138
139
  Filters compose, so they can be combined in any order:
@@ -293,6 +294,57 @@ await todos.sortBy("priority").first(); // first (A) task
293
294
  await todos.project("Missing").first(); // undefined
294
295
  ```
295
296
 
297
+ ### Aggregates and counts
298
+
299
+ `summary()` returns top-level totals plus per-name counts in one query, and
300
+ `countsByProject()` / `countsByContext()` return the per-name counts alone:
301
+
302
+ ```ts
303
+ const summary = await todos.summary();
304
+ // {
305
+ // total: 19, pending: 12, completed: 7,
306
+ // projects: [
307
+ // { name: "GarageSale", counts: { pending: 3, completed: 1, total: 4 } },
308
+ // { name: "Garden", counts: { pending: 2, completed: 0, total: 2 } },
309
+ // { name: "Moving", counts: { pending: 1, completed: 1, total: 2 } },
310
+ // { name: "OpenSource", counts: { pending: 2, completed: 2, total: 4 } },
311
+ // { name: "TodoTxt", counts: { pending: 2, completed: 2, total: 4 } },
312
+ // { name: "TodoTxtTouch", counts: { pending: 0, completed: 1, total: 1 } },
313
+ // ],
314
+ // contexts: [
315
+ // { name: "archive", counts: { pending: 0, completed: 2, total: 2 } },
316
+ // { name: "computer", counts: { pending: 2, completed: 2, total: 4 } },
317
+ // { name: "errands", counts: { pending: 2, completed: 1, total: 3 } },
318
+ // { name: "github", counts: { pending: 1, completed: 2, total: 3 } },
319
+ // { name: "hardware", counts: { pending: 2, completed: 0, total: 2 } },
320
+ // { name: "home", counts: { pending: 3, completed: 1, total: 4 } },
321
+ // { name: "phone", counts: { pending: 2, completed: 1, total: 3 } },
322
+ // ],
323
+ // }
324
+
325
+ await todos.countsByProject(); // summary.projects on its own
326
+ await todos.countsByContext(); // summary.contexts on its own
327
+ ```
328
+
329
+ Aggregates respect filter chains, so they can be scoped like any other query:
330
+
331
+ ```ts
332
+ await todos.pending().summary(); // pending records only
333
+ await todos.project("GarageSale").summary(); // one project's dashboard
334
+ ```
335
+
336
+ The counting rules:
337
+
338
+ - A record tagged with several names counts once per name, so per-name
339
+ totals do **not** sum to the top-level `total`: multi-tag records make the
340
+ sum larger and untagged records make it smaller.
341
+ - Names are unique and alphabetically sorted, matching `projects()` and
342
+ `contexts()`. Completed-only records still contribute their names; use
343
+ `pending().summary()` (or `pending().countsByProject()`) to count pending
344
+ work only.
345
+ - `sortBy` steps are ignored, like the name plucks.
346
+ - Aggregates load through the cache like every other query.
347
+
296
348
  ### Case-insensitive matching
297
349
 
298
350
  Name matching is exact by default. Change the default for a whole client, or
@@ -351,6 +403,72 @@ logged as `error`; the other levels are reserved for the write APIs. Logging is
351
403
  best-effort: a logger that throws or rejects never breaks a read or query. See
352
404
  `examples/todo-logger.ts`.
353
405
 
406
+ Warnings are also available without a logger, as data; see
407
+ [Warnings and errors as data](#warnings-and-errors-as-data).
408
+
409
+ ## Warnings and errors as data
410
+
411
+ `onWarning` callbacks and the [logger](#logging) are not the only way to learn
412
+ what was wrong with a file. `parseDocumentResult` returns the same records as
413
+ `parseDocument` plus the warnings and line counts as data:
414
+
415
+ ```ts
416
+ import { parseDocumentResult } from "@jibone/todotxt-core";
417
+
418
+ const result = parseDocumentResult(contents);
419
+ // {
420
+ // records: TodoRecord[],
421
+ // warnings: [
422
+ // { code: "invalid-date", message: "...", line: 3, meta: { ... } },
423
+ // { code: "duplicate-metadata-key", message: "...", line: 4, meta: { ... } },
424
+ // ],
425
+ // lineCount: 4, // physical lines; a trailing newline adds none
426
+ // skippedLines: 1, // blank or whitespace-only lines
427
+ // }
428
+ ```
429
+
430
+ Warnings appear in document order with 1-based physical line numbers.
431
+ `lineCount` counts physical lines — a single trailing newline ends the last
432
+ line instead of starting an empty one, and the empty input has no lines.
433
+ `skippedLines` counts the blank and whitespace-only lines the parser ignored.
434
+ Warnings are still forwarded to `options.onWarning` when supplied.
435
+
436
+ Clients expose the same data without hooks. `warnings()` returns the warnings
437
+ of the most recent successful read:
438
+
439
+ ```ts
440
+ const records = await todos.all();
441
+ const warnings = todos.warnings();
442
+ // ParseWarning[] in document order, or [] after a clean read.
443
+ ```
444
+
445
+ It is an additional access path: the [logger](#logging) still receives the
446
+ same warnings. The returned array and its warnings are copies, so callers may
447
+ mutate them freely. A read that fails leaves the previous read's warnings in
448
+ place, and `warnings()` returns `[]` before the first read.
449
+
450
+ ### Read errors
451
+
452
+ Rejections from the `read` hook stay promise rejections. When the rejected
453
+ value is already an `Error` — including filesystem errors with a `code` such
454
+ as `ENOENT` — it propagates untouched, so existing error-code checks keep
455
+ working. A hook that rejects with anything else (a thrown string, a plain
456
+ object) is wrapped in a `TodoReadError` with the original value on `cause`:
457
+
458
+ ```ts
459
+ import { TodoReadError } from "@jibone/todotxt-core";
460
+
461
+ try {
462
+ await todos.all();
463
+ } catch (error) {
464
+ if (error instanceof TodoReadError) {
465
+ // The read hook rejected with a non-Error value.
466
+ console.error(error.cause);
467
+ }
468
+ // A real Error (including fs errors with .code) arrives untouched.
469
+ }
470
+ ```
471
+
354
472
  ## Parser
355
473
 
356
474
  The parser also works without the client wrapper:
@@ -366,9 +484,11 @@ const records = parseDocument(contents);
366
484
  original line unless [source metadata](#source-metadata) is enabled. Dates must
367
485
  be real calendar dates in `YYYY-MM-DD` form; a shape-valid but nonexistent date
368
486
  such as `2011-99-99` is treated as text and reported as an `invalid-date`
369
- warning. Collect warnings by passing `onWarning` in a `ParseOptions` object;
370
- passing the handler directly as the second argument is deprecated but still
371
- supported. The full rule-by-rule interpretation is documented in
487
+ warning. Collect warnings by passing `onWarning` in a `ParseOptions` object, or
488
+ get them back as data with
489
+ [`parseDocumentResult`](#warnings-and-errors-as-data); passing the handler
490
+ directly as the second argument is deprecated but still supported. The full
491
+ rule-by-rule interpretation is documented in
372
492
  [How todotxt-core parses todo.txt](https://github.com/jibone/todotxt-core/blob/master/docs/todo-txt-rules.md).
373
493
 
374
494
  Writing is not implemented yet. The `write` hook is optional for now and will
@@ -382,10 +502,12 @@ bun examples/todo-project.ts
382
502
  bun examples/todo-context.ts
383
503
  bun examples/todo-cross.ts
384
504
  bun examples/todo-logger.ts
505
+ bun examples/todo-warnings.ts
385
506
  bun examples/todo-try.ts
386
507
  bun examples/todo-source.ts
387
508
  bun examples/todo-filters.ts
388
509
  bun examples/todo-sort.ts
510
+ bun examples/todo-summary.ts
389
511
  ```
390
512
 
391
513
  Each format rule also has a runnable example:
package/dist/index.d.ts CHANGED
@@ -52,6 +52,29 @@ interface ParseOptions {
52
52
  /** Receives parse warnings. */
53
53
  onWarning?: ParseWarningHandler;
54
54
  }
55
+ /**
56
+ * The outcome of parsing a whole todo.txt document.
57
+ *
58
+ * Returned by {@link parseDocumentResult}. {@link parseDocument} returns the
59
+ * {@link ParseResult.records} alone.
60
+ */
61
+ interface ParseResult {
62
+ /** Every non-empty line parsed into a {@link TodoRecord}. */
63
+ records: TodoRecord[];
64
+ /**
65
+ * Every warning from the document, in document order, annotated with the
66
+ * 1-based physical line number.
67
+ */
68
+ warnings: ParseWarning[];
69
+ /**
70
+ * Number of physical lines in the input. A single trailing newline ends
71
+ * the last line rather than starting an empty one, and the empty input has
72
+ * no lines.
73
+ */
74
+ lineCount: number;
75
+ /** Lines skipped because they were blank or whitespace-only. */
76
+ skippedLines: number;
77
+ }
55
78
  /**
56
79
  * Callbacks supplied by the consumer.
57
80
  *
@@ -161,6 +184,51 @@ interface TodoMatchOptions {
161
184
  /** Compare case-sensitively (or, for search, insensitively) for this call. */
162
185
  caseSensitive?: boolean;
163
186
  }
187
+ /**
188
+ * Pending/completed/total counts for one bucket of records.
189
+ *
190
+ * `total` is always `pending + completed`.
191
+ */
192
+ interface TodoCount {
193
+ /** Records that are not completed. */
194
+ pending: number;
195
+ /** Records marked completed. */
196
+ completed: number;
197
+ /** Every record in the bucket. */
198
+ total: number;
199
+ }
200
+ /**
201
+ * One named bucket with its counts, from the aggregate query methods.
202
+ *
203
+ * The name is the project or context exactly as parsed, without the `+` or
204
+ * `@` prefix and with its original casing.
205
+ */
206
+ interface TodoNameCount {
207
+ /** Project or context name from the matching records. */
208
+ name: string;
209
+ /** Counts over the matching records that carry the name. */
210
+ counts: TodoCount;
211
+ }
212
+ /**
213
+ * Result of {@link TodoQuery.summary}: totals for the matching records plus
214
+ * per-name counts.
215
+ *
216
+ * Per-name totals count multi-tag records once per name, so they do not sum
217
+ * to the top-level `total` when multi-tag records or untagged records
218
+ * exist.
219
+ */
220
+ interface TodoSummary {
221
+ /** Every record matching the query. */
222
+ total: number;
223
+ /** Matching records that are not completed. */
224
+ pending: number;
225
+ /** Matching records that are completed. */
226
+ completed: number;
227
+ /** Per-project counts over the matching records. */
228
+ projects: TodoNameCount[];
229
+ /** Per-context counts over the matching records. */
230
+ contexts: TodoNameCount[];
231
+ }
164
232
  /**
165
233
  * A lazy query over parsed todo records.
166
234
  *
@@ -171,6 +239,8 @@ interface TodoMatchOptions {
171
239
  * `project(["A", "B"])` matches either name while `project("A").project("B")`
172
240
  * requires both. {@link TodoQuery.projects} and {@link TodoQuery.contexts}
173
241
  * are terminal plucks that resolve to unique, alphabetically sorted names;
242
+ * {@link TodoQuery.summary}, {@link TodoQuery.countsByProject}, and
243
+ * {@link TodoQuery.countsByContext} are terminal aggregates; and
174
244
  * {@link TodoQuery.count} and {@link TodoQuery.first} are terminal shortcuts.
175
245
  */
176
246
  interface TodoQuery extends PromiseLike<TodoRecord[]> {
@@ -251,6 +321,30 @@ interface TodoQuery extends PromiseLike<TodoRecord[]> {
251
321
  projects: () => Promise<string[]>;
252
322
  /** Unique context names in the current result, alphabetically sorted. */
253
323
  contexts: () => Promise<string[]>;
324
+ /**
325
+ * Aggregate counts for the records matching this query.
326
+ *
327
+ * `total`, `pending`, and `completed` count matching records, while
328
+ * `projects` and `contexts` count each matching record once per distinct
329
+ * name it carries, so a record tagged `+A +B` adds one to each name.
330
+ * Per-name totals therefore do not sum to the top-level `total` when
331
+ * multi-tag records or untagged records exist. Names are unique, keep
332
+ * their original casing, and sort alphabetically like
333
+ * {@link TodoQuery.projects}; completed-only records still contribute
334
+ * their names. A `sortBy` step is ignored, and the summary loads through
335
+ * the cache like every other query.
336
+ */
337
+ summary: () => Promise<TodoSummary>;
338
+ /**
339
+ * Unique project names in the current result with their counts; see
340
+ * {@link TodoQuery.summary} for the counting rules.
341
+ */
342
+ countsByProject: () => Promise<TodoNameCount[]>;
343
+ /**
344
+ * Unique context names in the current result with their counts; see
345
+ * {@link TodoQuery.summary} for the counting rules.
346
+ */
347
+ countsByContext: () => Promise<TodoNameCount[]>;
254
348
  /** Number of records in the current result; equal to `(await query).length`. */
255
349
  count: () => Promise<number>;
256
350
  /**
@@ -264,6 +358,16 @@ interface TodoQuery extends PromiseLike<TodoRecord[]> {
264
358
  interface TodoTxtClient {
265
359
  /** Read fresh todo.txt contents, replace the cache, and return every record. */
266
360
  all: () => Promise<TodoRecord[]>;
361
+ /**
362
+ * Warnings from the most recent successful read, in document order.
363
+ *
364
+ * Empty before the first read and after a read without warnings. A failed
365
+ * read leaves the previous read's warnings in place. The returned array and
366
+ * its warnings are copies, so callers may mutate them without affecting
367
+ * later calls. A `logger`, when supplied, still receives warnings as they
368
+ * are found; this is an additional access path, not a replacement.
369
+ */
370
+ warnings: () => ParseWarning[];
267
371
  /** Query only records that are not completed, using the cached snapshot. */
268
372
  pending: () => TodoQuery;
269
373
  /** Query only records that are completed, using the cached snapshot. */
@@ -306,6 +410,12 @@ interface TodoTxtClient {
306
410
  projects: () => Promise<string[]>;
307
411
  /** List unique context names from the cached snapshot, alphabetically sorted. */
308
412
  contexts: () => Promise<string[]>;
413
+ /** Aggregate counts for the cached snapshot; see {@link TodoQuery.summary}. */
414
+ summary: () => Promise<TodoSummary>;
415
+ /** Per-project counts for the cached snapshot; see {@link TodoQuery.countsByProject}. */
416
+ countsByProject: () => Promise<TodoNameCount[]>;
417
+ /** Per-context counts for the cached snapshot; see {@link TodoQuery.countsByContext}. */
418
+ countsByContext: () => Promise<TodoNameCount[]>;
309
419
  }
310
420
  /**
311
421
  * Create a todo.txt client backed by consumer-supplied file hooks.
@@ -314,8 +424,12 @@ interface TodoTxtClient {
314
424
  * producing the file contents and `options.write` will be used by the write
315
425
  * APIs once they are implemented. `options.logger` is optional and silent by
316
426
  * default; when supplied, it receives read lifecycle and parse warning
317
- * diagnostics. With `options.includeSource`, every record also carries the
318
- * 1-based `line` number and the exact `raw` line it was parsed from. With
427
+ * diagnostics. Warnings from the most recent read are also available as data
428
+ * through {@link TodoTxtClient.warnings}. A `read` hook rejection propagates
429
+ * untouched when the rejected value is an `Error`; any other value is wrapped
430
+ * in a {@link TodoReadError} that carries the original on `cause`. With
431
+ * `options.includeSource`, every record also carries the 1-based `line` number
432
+ * and the exact `raw` line it was parsed from. With
319
433
  * `options.caseSensitive: false`, project and context matching compares
320
434
  * names through `toLowerCase()`; the default is exact matching.
321
435
  *
@@ -326,12 +440,27 @@ interface TodoTxtClient {
326
440
  *
327
441
  * Every line is parsed into a {@link TodoRecord} when the cache is populated.
328
442
  * Filters such as {@link TodoQuery.pending} and {@link TodoQuery.project}
329
- * operate on that array of JSON records, and plucks such as
330
- * {@link TodoQuery.projects} return unique, alphabetically sorted names.
331
- * Returned records are copies, so callers may mutate them without affecting the
332
- * cache.
443
+ * operate on that array of JSON records, plucks such as
444
+ * {@link TodoQuery.projects} return unique, alphabetically sorted names, and
445
+ * aggregates such as {@link TodoQuery.summary} count pending and completed
446
+ * records per name. Returned records are copies, so callers may mutate them
447
+ * without affecting the cache.
333
448
  */
334
449
  export declare function createTodoTxt(options: TodoClientOptions): TodoTxtClient;
450
+ /**
451
+ * Thrown when a consumer-supplied read hook rejects with a value that is not
452
+ * an `Error`.
453
+ *
454
+ * Rejections that are already `Error` instances — including filesystem errors
455
+ * with a `code` such as `ENOENT` — propagate untouched, so existing
456
+ * error-code checks keep working. Anything else, such as a thrown string or a
457
+ * plain object, is wrapped; the original value is available on `cause`.
458
+ */
459
+ export declare class TodoReadError extends Error {
460
+ /** The value the read hook rejected with. */
461
+ readonly cause: unknown;
462
+ constructor(message: string, cause: unknown);
463
+ }
335
464
  /**
336
465
  * Parse a single todo.txt line directly into a JSON-friendly {@link TodoRecord}.
337
466
  *
@@ -370,4 +499,19 @@ export declare function parseLine(line: string, onWarning: ParseWarningHandler):
370
499
  export declare function parseDocument(contents: string, options?: ParseOptions): TodoRecord[];
371
500
  /** @deprecated Pass {@link ParseOptions} with `onWarning` instead. */
372
501
  export declare function parseDocument(contents: string, onWarning: ParseWarningHandler): TodoRecord[];
373
- export type { LogLevel, MaybePromise, ParseOptions, ParseWarning, ParseWarningHandler, TodoClientOptions, TodoFileHooks, TodoHooks, TodoLogger, TodoMatchOptions, TodoQuery, TodoRecord, TodoSortDirection, TodoSortField, TodoTxtClient };
502
+ /**
503
+ * Parse the contents of a todo.txt file, returning records, warnings, and
504
+ * line counts as data.
505
+ *
506
+ * The records are exactly what {@link parseDocument} returns. The
507
+ * {@link ParseResult} additionally carries every warning in document order
508
+ * (annotated with the 1-based physical line number), the number of physical
509
+ * lines, and how many of them were blank or whitespace-only. A single
510
+ * trailing newline ends the last line rather than starting an empty one, and
511
+ * the empty input has no lines.
512
+ *
513
+ * Warnings are also forwarded to `options.onWarning` when supplied, so this
514
+ * composes with existing warning handling.
515
+ */
516
+ export declare function parseDocumentResult(contents: string, options?: ParseOptions): ParseResult;
517
+ export type { LogLevel, MaybePromise, ParseOptions, ParseResult, ParseWarning, ParseWarningHandler, TodoClientOptions, TodoCount, TodoFileHooks, TodoHooks, TodoLogger, TodoMatchOptions, TodoNameCount, TodoQuery, TodoRecord, TodoSortDirection, TodoSortField, TodoSummary, TodoTxtClient };
package/dist/index.js CHANGED
@@ -19,6 +19,22 @@ function cloneRecord(todo) {
19
19
  function cloneRecords(records) {
20
20
  return records.map(cloneRecord);
21
21
  }
22
+ // src/errors.ts
23
+ /**
24
+ * Thrown when a consumer-supplied read hook rejects with a value that is not
25
+ * an `Error`.
26
+ *
27
+ * Rejections that are already `Error` instances — including filesystem errors
28
+ * with a `code` such as `ENOENT` — propagate untouched, so existing
29
+ * error-code checks keep working. Anything else, such as a thrown string or a
30
+ * plain object, is wrapped; the original value is available on `cause`.
31
+ */
32
+ var TodoReadError = class extends Error {
33
+ constructor(message, cause) {
34
+ super(message, { cause });
35
+ this.name = "TodoReadError";
36
+ }
37
+ };
22
38
  // src/date.ts
23
39
  const DATE_SHAPE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
24
40
  const DAYS_IN_MONTH = [
@@ -212,22 +228,68 @@ function parseLine(line, onWarningOrOptions) {
212
228
  }
213
229
  return record;
214
230
  }
215
- function parseDocument(contents, onWarningOrOptions) {
216
- const { includeSource, onWarning } = normalizeParseOptions(onWarningOrOptions);
231
+ /**
232
+ * Shared document parser behind {@link parseDocument} and
233
+ * {@link parseDocumentResult}.
234
+ *
235
+ * Warnings are always collected, in document order and annotated with their
236
+ * 1-based physical line number, and forwarded to the consumer's `onWarning`
237
+ * when one is supplied. A single trailing newline ends the last line rather
238
+ * than starting an empty one, so it adds neither a line nor a skipped line.
239
+ */
240
+ function parseDocumentCore(contents, options) {
241
+ const { includeSource, onWarning } = options;
242
+ const segments = contents.split(/\r?\n/);
243
+ const lines = contents === "" ? [] : contents.endsWith("\n") ? segments.slice(0, -1) : segments;
217
244
  const records = [];
245
+ const warnings = [];
246
+ let skippedLines = 0;
218
247
  let lineNumber = 0;
219
- for (const line of contents.split(/\r?\n/)) {
248
+ for (const line of lines) {
220
249
  lineNumber += 1;
221
- if (line.trim() !== "") records.push(parseLine(line, {
250
+ if (line.trim() === "") {
251
+ skippedLines += 1;
252
+ continue;
253
+ }
254
+ records.push(parseLine(line, {
222
255
  includeSource,
223
256
  line: lineNumber,
224
- onWarning: onWarning ? (warning) => onWarning({
225
- ...warning,
226
- line: lineNumber
227
- }) : void 0
257
+ onWarning: (warning) => {
258
+ const annotated = {
259
+ ...warning,
260
+ line: lineNumber
261
+ };
262
+ warnings.push(annotated);
263
+ onWarning?.(annotated);
264
+ }
228
265
  }));
229
266
  }
230
- return records;
267
+ return {
268
+ records,
269
+ warnings,
270
+ lineCount: lines.length,
271
+ skippedLines
272
+ };
273
+ }
274
+ function parseDocument(contents, onWarningOrOptions) {
275
+ return parseDocumentCore(contents, normalizeParseOptions(onWarningOrOptions)).records;
276
+ }
277
+ /**
278
+ * Parse the contents of a todo.txt file, returning records, warnings, and
279
+ * line counts as data.
280
+ *
281
+ * The records are exactly what {@link parseDocument} returns. The
282
+ * {@link ParseResult} additionally carries every warning in document order
283
+ * (annotated with the 1-based physical line number), the number of physical
284
+ * lines, and how many of them were blank or whitespace-only. A single
285
+ * trailing newline ends the last line rather than starting an empty one, and
286
+ * the empty input has no lines.
287
+ *
288
+ * Warnings are also forwarded to `options.onWarning` when supplied, so this
289
+ * composes with existing warning handling.
290
+ */
291
+ function parseDocumentResult(contents, options) {
292
+ return parseDocumentCore(contents, normalizeParseOptions(options));
231
293
  }
232
294
  // src/query.ts
233
295
  function uniqueSorted(values) {
@@ -337,12 +399,69 @@ function pluckNames(load, state, pick) {
337
399
  sort: void 0
338
400
  }).then((records) => uniqueSorted(records.flatMap(pick)));
339
401
  }
402
+ /**
403
+ * Count pending/completed/total per unique name over `records`.
404
+ *
405
+ * Each record contributes at most once per name, so a record tagged
406
+ * `+A +A` counts `A` once. Names keep their original casing and sort
407
+ * like the name plucks, so buckets line up with `projects()`/`contexts()`.
408
+ */
409
+ function countNames(records, pick) {
410
+ const buckets = /* @__PURE__ */ new Map();
411
+ for (const record of records) for (const name of new Set(pick(record))) {
412
+ const bucket = buckets.get(name);
413
+ if (bucket === void 0) buckets.set(name, {
414
+ pending: record.completed ? 0 : 1,
415
+ completed: record.completed ? 1 : 0,
416
+ total: 1
417
+ });
418
+ else if (record.completed) {
419
+ bucket.completed += 1;
420
+ bucket.total += 1;
421
+ } else {
422
+ bucket.pending += 1;
423
+ bucket.total += 1;
424
+ }
425
+ }
426
+ return [...buckets].map(([name, counts]) => ({
427
+ name,
428
+ counts
429
+ })).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
430
+ }
340
431
  function resolveCount(load, state) {
341
432
  return resolveRaw(load, {
342
433
  ...state,
343
434
  sort: void 0
344
435
  }).then((records) => records.length);
345
436
  }
437
+ /**
438
+ * Aggregate the current result into a summary.
439
+ *
440
+ * Sorting never applies to aggregates; they count records, not order them.
441
+ */
442
+ async function resolveSummary(load, state) {
443
+ const records = await resolveRaw(load, {
444
+ ...state,
445
+ sort: void 0
446
+ });
447
+ let pending = 0;
448
+ let completed = 0;
449
+ for (const record of records) if (record.completed) completed += 1;
450
+ else pending += 1;
451
+ return {
452
+ total: records.length,
453
+ pending,
454
+ completed,
455
+ projects: countNames(records, (todo) => todo.projects),
456
+ contexts: countNames(records, (todo) => todo.contexts)
457
+ };
458
+ }
459
+ function resolveCountsBy(load, state, pick) {
460
+ return resolveRaw(load, {
461
+ ...state,
462
+ sort: void 0
463
+ }).then((records) => countNames(records, pick));
464
+ }
346
465
  async function resolveFirst(load, state) {
347
466
  const first = (await resolveRaw(load, state))[0];
348
467
  return first === void 0 ? void 0 : cloneRecord(first);
@@ -440,6 +559,9 @@ function createTodoQuery(load, state = {
440
559
  }),
441
560
  projects: () => pluckNames(load, state, (todo) => todo.projects),
442
561
  contexts: () => pluckNames(load, state, (todo) => todo.contexts),
562
+ summary: () => resolveSummary(load, state),
563
+ countsByProject: () => resolveCountsBy(load, state, (todo) => todo.projects),
564
+ countsByContext: () => resolveCountsBy(load, state, (todo) => todo.contexts),
443
565
  count: () => resolveCount(load, state),
444
566
  first: () => resolveFirst(load, state),
445
567
  then: (onfulfilled, onrejected) => resolveRecords(load, state).then(onfulfilled, onrejected)
@@ -453,8 +575,12 @@ function createTodoQuery(load, state = {
453
575
  * producing the file contents and `options.write` will be used by the write
454
576
  * APIs once they are implemented. `options.logger` is optional and silent by
455
577
  * default; when supplied, it receives read lifecycle and parse warning
456
- * diagnostics. With `options.includeSource`, every record also carries the
457
- * 1-based `line` number and the exact `raw` line it was parsed from. With
578
+ * diagnostics. Warnings from the most recent read are also available as data
579
+ * through {@link TodoTxtClient.warnings}. A `read` hook rejection propagates
580
+ * untouched when the rejected value is an `Error`; any other value is wrapped
581
+ * in a {@link TodoReadError} that carries the original on `cause`. With
582
+ * `options.includeSource`, every record also carries the 1-based `line` number
583
+ * and the exact `raw` line it was parsed from. With
458
584
  * `options.caseSensitive: false`, project and context matching compares
459
585
  * names through `toLowerCase()`; the default is exact matching.
460
586
  *
@@ -465,13 +591,15 @@ function createTodoQuery(load, state = {
465
591
  *
466
592
  * Every line is parsed into a {@link TodoRecord} when the cache is populated.
467
593
  * Filters such as {@link TodoQuery.pending} and {@link TodoQuery.project}
468
- * operate on that array of JSON records, and plucks such as
469
- * {@link TodoQuery.projects} return unique, alphabetically sorted names.
470
- * Returned records are copies, so callers may mutate them without affecting the
471
- * cache.
594
+ * operate on that array of JSON records, plucks such as
595
+ * {@link TodoQuery.projects} return unique, alphabetically sorted names, and
596
+ * aggregates such as {@link TodoQuery.summary} count pending and completed
597
+ * records per name. Returned records are copies, so callers may mutate them
598
+ * without affecting the cache.
472
599
  */
473
600
  function createTodoTxt(options) {
474
601
  let cache;
602
+ let lastWarnings = [];
475
603
  let inFlight;
476
604
  let generation = 0;
477
605
  const logger = options.logger;
@@ -485,7 +613,14 @@ function createTodoTxt(options) {
485
613
  const readFresh = async () => {
486
614
  const currentGeneration = ++generation;
487
615
  log("debug", "Reading todo file");
488
- const records = parseDocument(await options.read(), {
616
+ let contents;
617
+ try {
618
+ contents = await options.read();
619
+ } catch (cause) {
620
+ if (cause instanceof Error) throw cause;
621
+ throw new TodoReadError("The read hook rejected with a non-Error value.", cause);
622
+ }
623
+ const result = parseDocumentResult(contents, {
489
624
  includeSource: options.includeSource,
490
625
  onWarning: (warning) => {
491
626
  log("warn", warning.message, {
@@ -495,8 +630,12 @@ function createTodoTxt(options) {
495
630
  });
496
631
  }
497
632
  });
633
+ const records = result.records;
498
634
  log("debug", "Parsed todo file", { records: records.length });
499
- if (currentGeneration === generation) cache = records;
635
+ if (currentGeneration === generation) {
636
+ cache = records;
637
+ lastWarnings = result.warnings;
638
+ }
500
639
  return records;
501
640
  };
502
641
  const refresh = () => {
@@ -513,12 +652,17 @@ function createTodoTxt(options) {
513
652
  return refresh();
514
653
  };
515
654
  const all = async () => cloneRecords(await refresh());
655
+ const warnings = () => lastWarnings.map((warning) => ({
656
+ ...warning,
657
+ meta: { ...warning.meta }
658
+ }));
516
659
  const query = createTodoQuery(loadCached, {
517
660
  filters: [],
518
661
  caseSensitive: options.caseSensitive ?? true
519
662
  });
520
663
  return {
521
664
  all,
665
+ warnings,
522
666
  pending: query.pending,
523
667
  completed: query.completed,
524
668
  project: query.project,
@@ -537,9 +681,12 @@ function createTodoTxt(options) {
537
681
  count: query.count,
538
682
  first: query.first,
539
683
  projects: query.projects,
540
- contexts: query.contexts
684
+ contexts: query.contexts,
685
+ summary: query.summary,
686
+ countsByProject: query.countsByProject,
687
+ countsByContext: query.countsByContext
541
688
  };
542
689
  }
543
- export { createTodoTxt, parseDocument, parseLine };
690
+ export { TodoReadError, createTodoTxt, parseDocument, parseDocumentResult, parseLine };
544
691
 
545
692
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../src/clone.ts","../src/date.ts","../src/metadata.ts","../src/parse.ts","../src/query.ts","../src/client.ts"],"sourcesContent":["import type { TodoRecord } from \"./types.ts\";\n\n/** Copy a record so callers cannot mutate the client's cached snapshot. */\nexport function cloneRecord(todo: TodoRecord): TodoRecord {\n const copy: TodoRecord = {\n completed: todo.completed,\n priority: todo.priority,\n completedAt: todo.completedAt,\n createdAt: todo.createdAt,\n description: todo.description,\n projects: [...todo.projects],\n contexts: [...todo.contexts],\n data: { ...todo.data },\n };\n\n if (todo.line !== undefined) {\n copy.line = todo.line;\n }\n\n if (todo.raw !== undefined) {\n copy.raw = todo.raw;\n }\n\n return copy;\n}\n\n/** Copy every record in `records`. */\nexport function cloneRecords(records: readonly TodoRecord[]): TodoRecord[] {\n return records.map(cloneRecord);\n}\n","const DATE_SHAPE_PATTERN = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];\n\nfunction isLeapYear(year: number): boolean {\n return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;\n}\n\n/**\n * True when `value` is a real calendar date in `YYYY-MM-DD` form.\n *\n * The check is purely arithmetic so it does not depend on the host timezone and\n * does not let JavaScript's `Date` roll invalid values over (for example,\n * `2011-02-30` must not become March 2).\n */\nexport function isValidDate(value: string): boolean {\n const match = DATE_SHAPE_PATTERN.exec(value);\n if (!match) {\n return false;\n }\n\n const year = Number(match[1]);\n const month = Number(match[2]);\n const day = Number(match[3]);\n\n if (month < 1 || month > 12 || day < 1) {\n return false;\n }\n\n const maxDay =\n month === 2 && isLeapYear(year) ? 29 : (DAYS_IN_MONTH[month - 1] ?? 0);\n\n return day <= maxDay;\n}\n","import type { ParseWarningHandler } from \"./types.ts\";\n\nconst EXTENSION_PATTERN = /^([^:\\s]+):([^:\\s]+)$/;\n\n/** Metadata collected from a task's text. */\nexport interface TodoMetadata {\n projects: string[];\n contexts: string[];\n data: Record<string, string>;\n}\n\n/** Everything derived from a task's text in one token pass. */\nexport interface TodoText extends TodoMetadata {\n description: string;\n}\n\nfunction tokenize(text: string): string[] {\n const trimmed = text.trim();\n if (trimmed === \"\") {\n return [];\n }\n\n return trimmed.split(/\\s+/);\n}\n\n/**\n * True when a whitespace-delimited token is inline metadata.\n *\n * Inline metadata is a project (`+name`), a context (`@name`), or a\n * `key:value` extension. Bare `+`/`@` tokens and values containing another\n * colon are not metadata.\n */\nexport function isMetadataToken(token: string): boolean {\n if (token.startsWith(\"+\") && token.length > 1) {\n return true;\n }\n\n if (token.startsWith(\"@\") && token.length > 1) {\n return true;\n }\n\n return EXTENSION_PATTERN.test(token);\n}\n\n/**\n * Collect a task's description, projects, contexts, and extensions in one pass.\n *\n * Previous versions tokenized the text once for metadata and again to strip it;\n * doing both here keeps parsing to a single split per line.\n *\n * When a `key:value` key is repeated, `onWarning` receives a\n * `duplicate-metadata-key` warning and the last value wins.\n */\nexport function parseText(\n text: string,\n onWarning?: ParseWarningHandler,\n): TodoText {\n const projects: string[] = [];\n const contexts: string[] = [];\n const data: Record<string, string> = {};\n const descriptionTokens: string[] = [];\n\n for (const token of tokenize(text)) {\n if (token.startsWith(\"+\") && token.length > 1) {\n projects.push(token.slice(1));\n continue;\n }\n\n if (token.startsWith(\"@\") && token.length > 1) {\n contexts.push(token.slice(1));\n continue;\n }\n\n const extension = EXTENSION_PATTERN.exec(token);\n const key = extension?.[1];\n const value = extension?.[2];\n if (key !== undefined && value !== undefined) {\n if (Object.hasOwn(data, key)) {\n onWarning?.({\n code: \"duplicate-metadata-key\",\n message: `Duplicate metadata key \"${key}\"; the last value wins.`,\n meta: { key, previousValue: data[key], value },\n });\n }\n\n data[key] = value;\n continue;\n }\n\n descriptionTokens.push(token);\n }\n\n return {\n description: descriptionTokens.join(\" \"),\n projects,\n contexts,\n data,\n };\n}\n\n/** Collect projects, contexts, and extensions from task text. */\nexport function parseMetadata(text: string): TodoMetadata {\n const { projects, contexts, data } = parseText(text);\n return { projects, contexts, data };\n}\n\n/**\n * Remove inline metadata from task text.\n *\n * Remaining tokens are rejoined with single spaces, so repeated whitespace can\n * be normalized.\n */\nexport function stripMetadata(text: string): string {\n return parseText(text).description;\n}\n","import { isValidDate } from \"./date.ts\";\nimport { parseText } from \"./metadata.ts\";\nimport type {\n ParseOptions,\n ParseWarningHandler,\n TodoRecord,\n} from \"./types.ts\";\n\nconst PRIORITY_PATTERN = /^\\(([A-Z])\\) /;\nconst LEADING_DATE_PATTERN = /^(\\d{4}-\\d{2}-\\d{2})(?: |$)/;\n\ntype LeadingDate =\n | { kind: \"absent\"; rest: string }\n | { kind: \"valid\"; date: string; rest: string }\n | { kind: \"invalid\"; value: string; rest: string };\n\n/**\n * Inspect a `YYYY-MM-DD` token at the start of `input`.\n *\n * A value with the right shape that does not exist on the calendar is reported\n * as `invalid`. In that case `rest` is the original input, so callers leave the\n * token in the description instead of consuming it.\n */\nfunction takeLeadingDate(input: string): LeadingDate {\n const match = LEADING_DATE_PATTERN.exec(input);\n if (!match) {\n return { kind: \"absent\", rest: input };\n }\n\n const date = match[1];\n if (date === undefined) {\n return { kind: \"absent\", rest: input };\n }\n\n if (!isValidDate(date)) {\n return { kind: \"invalid\", value: date, rest: input };\n }\n\n return { kind: \"valid\", date, rest: input.slice(match[0]!.length) };\n}\n\nfunction warnInvalidDate(\n value: string,\n field: \"completedAt\" | \"createdAt\",\n onWarning?: ParseWarningHandler,\n): void {\n const label = field === \"completedAt\" ? \"completion\" : \"creation\";\n\n onWarning?.({\n code: \"invalid-date\",\n message: `Invalid ${label} date \"${value}\"; treating it as text.`,\n meta: { value, field },\n });\n}\n\n/**\n * Accept either a {@link ParseWarningHandler} (deprecated) or\n * {@link ParseOptions} as the second argument.\n */\nfunction normalizeParseOptions(\n onWarningOrOptions?: ParseWarningHandler | ParseOptions,\n): ParseOptions {\n if (typeof onWarningOrOptions === \"function\") {\n return { onWarning: onWarningOrOptions };\n }\n\n return onWarningOrOptions ?? {};\n}\n\n/** Remove one trailing `\\r`, so `raw` has no carriage return for CRLF input. */\nfunction stripTrailingCarriageReturn(line: string): string {\n return line.endsWith(\"\\r\") ? line.slice(0, -1) : line;\n}\n\n/**\n * Parse a single todo.txt line directly into a JSON-friendly {@link TodoRecord}.\n *\n * The parser follows the todo.txt format rules:\n *\n * - Completed tasks start with `x `, optionally followed by a completion date\n * and then a creation date.\n * - Incomplete tasks may start with an `(A)`–`(Z)` priority and an optional\n * creation date.\n * - Dates must be real calendar dates in `YYYY-MM-DD` form. A shape-valid but\n * nonexistent date is treated as text.\n * - Projects, contexts, and `key:value` metadata may appear anywhere in the\n * remaining text.\n *\n * Recoverable issues are reported to `options.onWarning` when supplied;\n * parsing still produces a record.\n *\n * With `options.includeSource`, the record carries `raw` (the exact input\n * line, minus a trailing `\\r`) and `line` (the number supplied via\n * `options.line`, when given).\n */\nexport function parseLine(\n line: string,\n options?: ParseOptions,\n): TodoRecord;\n/** @deprecated Pass {@link ParseOptions} with `onWarning` instead. */\nexport function parseLine(\n line: string,\n onWarning: ParseWarningHandler,\n): TodoRecord;\nexport function parseLine(\n line: string,\n onWarningOrOptions?: ParseWarningHandler | ParseOptions,\n): TodoRecord {\n const options = normalizeParseOptions(onWarningOrOptions);\n let rest = line;\n let completed = false;\n let priority: string | null = null;\n let completedAt: string | null = null;\n let createdAt: string | null = null;\n\n if (rest.startsWith(\"x \")) {\n completed = true;\n rest = rest.slice(2);\n\n const completedDate = takeLeadingDate(rest);\n if (completedDate.kind === \"valid\") {\n completedAt = completedDate.date;\n rest = completedDate.rest;\n\n const createdDate = takeLeadingDate(rest);\n if (createdDate.kind === \"valid\") {\n createdAt = createdDate.date;\n rest = createdDate.rest;\n } else if (createdDate.kind === \"invalid\") {\n warnInvalidDate(createdDate.value, \"createdAt\", options.onWarning);\n }\n } else if (completedDate.kind === \"invalid\") {\n // The same token cannot also be a creation date, so only warn once.\n warnInvalidDate(completedDate.value, \"completedAt\", options.onWarning);\n }\n } else {\n const priorityMatch = PRIORITY_PATTERN.exec(rest);\n if (priorityMatch) {\n priority = priorityMatch[1]!;\n rest = rest.slice(priorityMatch[0]!.length);\n }\n\n const createdDate = takeLeadingDate(rest);\n if (createdDate.kind === \"valid\") {\n createdAt = createdDate.date;\n rest = createdDate.rest;\n } else if (createdDate.kind === \"invalid\") {\n warnInvalidDate(createdDate.value, \"createdAt\", options.onWarning);\n }\n }\n\n const text = rest.trim();\n const { description, projects, contexts, data } = parseText(\n text,\n options.onWarning,\n );\n\n const record: TodoRecord = {\n completed,\n priority,\n completedAt,\n createdAt,\n description,\n projects,\n contexts,\n data,\n };\n\n if (options.includeSource) {\n if (options.line !== undefined) {\n record.line = options.line;\n }\n\n record.raw = stripTrailingCarriageReturn(line);\n }\n\n return record;\n}\n\n/**\n * Parse the contents of a todo.txt file.\n *\n * Lines are split on `\\n` or `\\r\\n`; blank and whitespace-only lines are\n * skipped. Every remaining line becomes a {@link TodoRecord}. Warnings are\n * annotated with the 1-based physical line number.\n *\n * With `options.includeSource`, every record carries `raw` (the exact line,\n * minus a trailing `\\r`) and `line` (the 1-based physical line number,\n * counting blank lines).\n */\nexport function parseDocument(\n contents: string,\n options?: ParseOptions,\n): TodoRecord[];\n/** @deprecated Pass {@link ParseOptions} with `onWarning` instead. */\nexport function parseDocument(\n contents: string,\n onWarning: ParseWarningHandler,\n): TodoRecord[];\nexport function parseDocument(\n contents: string,\n onWarningOrOptions?: ParseWarningHandler | ParseOptions,\n): TodoRecord[] {\n const { includeSource, onWarning } = normalizeParseOptions(onWarningOrOptions);\n const records: TodoRecord[] = [];\n let lineNumber = 0;\n\n for (const line of contents.split(/\\r?\\n/)) {\n lineNumber += 1;\n\n if (line.trim() !== \"\") {\n records.push(\n parseLine(line, {\n includeSource,\n line: lineNumber,\n onWarning: onWarning\n ? (warning) => onWarning({ ...warning, line: lineNumber })\n : undefined,\n }),\n );\n }\n }\n\n return records;\n}\n","import { cloneRecord, cloneRecords } from \"./clone.ts\";\nimport { isValidDate } from \"./date.ts\";\nimport type { TodoRecord } from \"./types.ts\";\n\n/** A predicate applied to every record in a query. */\nexport type TodoFilter = (todo: TodoRecord) => boolean;\n\n/** Loads and parses every todo.txt record. */\nexport type LoadRecords = () => Promise<TodoRecord[]>;\n\n/** Fields that {@link TodoQuery.sortBy} can order results by. */\nexport type TodoSortField =\n | \"priority\"\n | \"createdAt\"\n | \"completedAt\"\n | \"description\"\n | \"due\";\n\n/** Sort direction for {@link TodoQuery.sortBy}. Default: `\"asc\"`. */\nexport type TodoSortDirection = \"asc\" | \"desc\";\n\n/**\n * Per-call matching options.\n *\n * `caseSensitive` overrides the client-level default for one call. The default\n * differs per method: project and context matching is exact and case-sensitive\n * unless the option says otherwise, while search is case-insensitive unless the\n * option says otherwise.\n */\nexport interface TodoMatchOptions {\n /** Compare case-sensitively (or, for search, insensitively) for this call. */\n caseSensitive?: boolean;\n}\n\n/** One ordering step appended by {@link TodoQuery.sortBy}. */\nexport interface TodoSortSpec {\n field: TodoSortField;\n direction: TodoSortDirection;\n}\n\n/** Internal query state: AND-composed filters plus one optional sort step. */\nexport interface TodoQueryState {\n filters: TodoFilter[];\n sort?: TodoSortSpec;\n /**\n * Client-level default for name matching. Search is unaffected: it stays\n * case-insensitive by default no matter what this says.\n */\n caseSensitive: boolean;\n}\n\n/**\n * A lazy query over parsed todo records.\n *\n * Filters return a new query and perform no IO. Awaiting a query resolves\n * through the supplied loader; the client caches parsed records, so only the\n * first query reads the file. Filters compose with AND: every predicate added\n * to the chain must match. Array arguments are OR within a single call, so\n * `project([\"A\", \"B\"])` matches either name while `project(\"A\").project(\"B\")`\n * requires both. {@link TodoQuery.projects} and {@link TodoQuery.contexts}\n * are terminal plucks that resolve to unique, alphabetically sorted names;\n * {@link TodoQuery.count} and {@link TodoQuery.first} are terminal shortcuts.\n */\nexport interface TodoQuery extends PromiseLike<TodoRecord[]> {\n /** Only records that are not completed. */\n pending: () => TodoQuery;\n /** Only records that are completed. */\n completed: () => TodoQuery;\n /**\n * Only records tagged with the project `name`.\n *\n * An array matches any listed name (OR); repeated calls require every name\n * (AND). An empty array matches nothing. Matching is exact and\n * case-sensitive unless the client-level `caseSensitive` option or the\n * per-call override says otherwise; case-insensitive comparison uses\n * `toLowerCase()`, which is not full Unicode case folding.\n */\n project: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Only records tagged with the context `name`; see {@link TodoQuery.project}. */\n context: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /**\n * Only records not tagged with the project `name`.\n *\n * An array excludes every listed name; an empty array excludes nothing.\n * This is not a replacement for `pending()`/`completed()`.\n */\n notProject: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Only records not tagged with the context `name`; see {@link TodoQuery.notProject}. */\n notContext: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /**\n * Only records with priority `letter`.\n *\n * Matching is exact against the uppercase letter the parser stores, so\n * `priority(\"a\")` matches nothing. An array matches any listed letter.\n */\n priority: (letter: string | string[]) => TodoQuery;\n /**\n * Only records whose description contains `text` as a substring.\n *\n * Case-insensitive by default, independently of the client-level matching\n * option. Only `description` is searched; projects, contexts, and metadata\n * have their own filters.\n */\n search: (text: string, options?: TodoMatchOptions) => TodoQuery;\n /**\n * Only records with the metadata `key`.\n *\n * With a `value`, the record's value must match it exactly.\n */\n meta: (key: string, value?: string) => TodoQuery;\n /** Only records that have the metadata `key`, whatever its value. */\n hasMeta: (key: string) => TodoQuery;\n /**\n * Only records created strictly after `date`.\n *\n * The argument must be a real calendar date in `YYYY-MM-DD` form; anything\n * else throws a `TypeError` when the query is built, before any IO.\n * Records without a creation date never match.\n */\n createdAfter: (date: string) => TodoQuery;\n /** Only records created strictly before `date`; see {@link TodoQuery.createdAfter}. */\n createdBefore: (date: string) => TodoQuery;\n /** Only records completed strictly after `date`; see {@link TodoQuery.createdAfter}. */\n completedAfter: (date: string) => TodoQuery;\n /** Only records completed strictly before `date`; see {@link TodoQuery.createdAfter}. */\n completedBefore: (date: string) => TodoQuery;\n /**\n * Sort the filtered records by `field`; default direction is `\"asc\"`.\n *\n * The sort is stable: records with equal keys keep file order. Missing\n * values (`null` priorities or dates, and missing or invalid `due` values)\n * sort last in both directions; `\"desc\"` reverses only the value\n * comparison, never the missing-value placement. Calling `sortBy` twice\n * keeps only the last call. Description ordering uses `localeCompare`, so\n * it follows the host locale for equal-ignoring-case ties.\n */\n sortBy: (field: TodoSortField, direction?: TodoSortDirection) => TodoQuery;\n /** Unique project names in the current result, alphabetically sorted. */\n projects: () => Promise<string[]>;\n /** Unique context names in the current result, alphabetically sorted. */\n contexts: () => Promise<string[]>;\n /** Number of records in the current result; equal to `(await query).length`. */\n count: () => Promise<number>;\n /**\n * The first record of the filtered (and sorted) result, or `undefined`\n * when nothing matches. The record is a copy, so mutating it cannot affect\n * the client's cache.\n */\n first: () => Promise<TodoRecord | undefined>;\n}\n\nfunction uniqueSorted(values: string[]): string[] {\n return [...new Set(values)].sort();\n}\n\nfunction toArray(value: string | string[]): string[] {\n return Array.isArray(value) ? value : [value];\n}\n\n/**\n * Build a name-matching predicate for projects or contexts.\n *\n * Case-insensitive comparison normalizes both sides with `toLowerCase()`,\n * which is deterministic across machines and locales but not full Unicode\n * case folding. `invert` turns the predicate into a negation filter.\n */\nfunction nameFilter(\n pick: (todo: TodoRecord) => string[],\n names: string[],\n caseSensitive: boolean,\n invert: boolean,\n): TodoFilter {\n const wanted = caseSensitive\n ? names\n : names.map((name) => name.toLowerCase());\n\n const matches = (todo: TodoRecord): boolean =>\n pick(todo).some((value) =>\n wanted.includes(caseSensitive ? value : value.toLowerCase()),\n );\n\n return invert ? (todo) => !matches(todo) : matches;\n}\n\n/**\n * Validate a date-filter argument at query-build time.\n *\n * Invalid arguments throw instead of silently matching nothing, so a typo in\n * a bound cannot hide behind an empty result.\n */\nfunction requireValidDate(date: string, method: string): string {\n if (!isValidDate(date)) {\n throw new TypeError(\n `${method}() expected a real calendar date in YYYY-MM-DD form, got \"${date}\".`,\n );\n }\n\n return date;\n}\n\n/**\n * Build a date-comparison predicate on a record date field.\n *\n * Records with `null` dates never match; validated `YYYY-MM-DD` values\n * compare correctly as plain strings.\n */\nfunction dateFilter(\n field: \"createdAt\" | \"completedAt\",\n date: string,\n method: string,\n keep: (recordDate: string, bound: string) => boolean,\n): TodoFilter {\n const bound = requireValidDate(date, method);\n\n return (todo) => {\n const recordDate = todo[field];\n return recordDate !== null && keep(recordDate, bound);\n };\n}\n\n/** Read `data.due` when it is a real calendar date; otherwise `null`. */\nfunction dueDateOf(todo: TodoRecord): string | null {\n const due = todo.data[\"due\"];\n return due !== undefined && isValidDate(due) ? due : null;\n}\n\ntype NullableSortField = Exclude<TodoSortField, \"description\">;\n\n/** Extract the nullable sort key for every field except `description`. */\nfunction sortKey(todo: TodoRecord, field: NullableSortField): string | null {\n switch (field) {\n case \"priority\":\n return todo.priority;\n case \"createdAt\":\n return todo.createdAt;\n case \"completedAt\":\n return todo.completedAt;\n case \"due\":\n return dueDateOf(todo);\n }\n}\n\n/**\n * Compare nullable keys with missing values last in both directions.\n *\n * `desc` negates only the value comparison, never the missing-value\n * placement; equal keys compare as `0` so the stable sort keeps file order.\n */\nfunction compareNullableKeys(\n a: string | null,\n b: string | null,\n direction: TodoSortDirection,\n): number {\n if (a === null) {\n return b === null ? 0 : 1;\n }\n\n if (b === null) {\n return -1;\n }\n\n const result = a < b ? -1 : a > b ? 1 : 0;\n return direction === \"asc\" ? result : -result;\n}\n\n/** Build the sort comparator for one ordering step. */\nfunction makeComparator(\n spec: TodoSortSpec,\n): (a: TodoRecord, b: TodoRecord) => number {\n if (spec.field === \"description\") {\n return (a, b) => {\n const result = a.description.localeCompare(b.description);\n return spec.direction === \"asc\" ? result : -result;\n };\n }\n\n const field: NullableSortField = spec.field;\n\n return (a, b) =>\n compareNullableKeys(\n sortKey(a, field),\n sortKey(b, field),\n spec.direction,\n );\n}\n\n/**\n * Sort in place and return the same array.\n *\n * `Array#sort` is stable, so records with equal keys keep file order.\n */\nfunction applySort(records: TodoRecord[], sort: TodoSortSpec): TodoRecord[] {\n return records.sort(makeComparator(sort));\n}\n\n/**\n * Load, filter, and sort records without cloning them.\n *\n * The returned array is safe to sort because it is always a fresh copy when\n * a sort step exists; without one the loader's own array is returned as-is.\n */\nasync function resolveRaw(\n load: LoadRecords,\n state: TodoQueryState,\n): Promise<TodoRecord[]> {\n const records = await load();\n\n if (state.sort === undefined) {\n if (state.filters.length === 0) {\n return records;\n }\n\n return records.filter((record) =>\n state.filters.every((filter) => filter(record)),\n );\n }\n\n // Never sort the loader's array in place: the client's cache must keep\n // file order for later queries.\n const matches =\n state.filters.length === 0\n ? records.slice()\n : records.filter((record) =>\n state.filters.every((filter) => filter(record)),\n );\n\n return applySort(matches, state.sort);\n}\n\nasync function resolveRecords(\n load: LoadRecords,\n state: TodoQueryState,\n): Promise<TodoRecord[]> {\n return cloneRecords(await resolveRaw(load, state));\n}\n\nfunction pluckNames(\n load: LoadRecords,\n state: TodoQueryState,\n pick: (todo: TodoRecord) => string[],\n): Promise<string[]> {\n // Sorting never applies to name plucks; they alphabetize themselves.\n return resolveRaw(load, { ...state, sort: undefined }).then((records) =>\n uniqueSorted(records.flatMap(pick)),\n );\n}\n\nfunction resolveCount(\n load: LoadRecords,\n state: TodoQueryState,\n): Promise<number> {\n return resolveRaw(load, { ...state, sort: undefined }).then(\n (records) => records.length,\n );\n}\n\nasync function resolveFirst(\n load: LoadRecords,\n state: TodoQueryState,\n): Promise<TodoRecord | undefined> {\n const first = (await resolveRaw(load, state))[0];\n return first === undefined ? undefined : cloneRecord(first);\n}\n\n/**\n * Create a lazy query over the records loaded by `load`.\n *\n * Each filter method appends a predicate, so chained calls compose with AND,\n * while array arguments match any listed value. `sortBy` appends an ordering\n * step instead of a predicate; the last `sortBy` call wins. For example,\n * `pending().completed()` matches nothing, while\n * `project(\"Work\").pending()` matches pending records in `Work`, and\n * `pending().sortBy(\"priority\")` lists them A first.\n */\nexport function createTodoQuery(\n load: LoadRecords,\n state: TodoQueryState = { filters: [], caseSensitive: true },\n): TodoQuery {\n const nameOptions = (options?: TodoMatchOptions): boolean =>\n options?.caseSensitive ?? state.caseSensitive;\n\n return {\n pending: () =>\n createTodoQuery(load, {\n ...state,\n filters: [...state.filters, (todo) => !todo.completed],\n }),\n completed: () =>\n createTodoQuery(load, {\n ...state,\n filters: [...state.filters, (todo) => todo.completed],\n }),\n project: (name, options) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n nameFilter(\n (todo) => todo.projects,\n toArray(name),\n nameOptions(options),\n false,\n ),\n ],\n }),\n context: (name, options) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n nameFilter(\n (todo) => todo.contexts,\n toArray(name),\n nameOptions(options),\n false,\n ),\n ],\n }),\n notProject: (name, options) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n nameFilter(\n (todo) => todo.projects,\n toArray(name),\n nameOptions(options),\n true,\n ),\n ],\n }),\n notContext: (name, options) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n nameFilter(\n (todo) => todo.contexts,\n toArray(name),\n nameOptions(options),\n true,\n ),\n ],\n }),\n priority: (letter) => {\n const letters = toArray(letter);\n\n return createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n (todo) => todo.priority !== null && letters.includes(todo.priority),\n ],\n });\n },\n search: (text, options) => {\n const caseSensitive = options?.caseSensitive ?? false;\n const needle = caseSensitive ? text : text.toLowerCase();\n\n return createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n (todo) => {\n const haystack = caseSensitive\n ? todo.description\n : todo.description.toLowerCase();\n return haystack.includes(needle);\n },\n ],\n });\n },\n meta: (key, value) => {\n const filter: TodoFilter =\n value === undefined\n ? (todo) => Object.hasOwn(todo.data, key)\n : (todo) => todo.data[key] === value;\n\n return createTodoQuery(load, { ...state, filters: [...state.filters, filter] });\n },\n hasMeta: (key) =>\n createTodoQuery(load, {\n ...state,\n filters: [...state.filters, (todo) => Object.hasOwn(todo.data, key)],\n }),\n createdAfter: (date) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n dateFilter(\"createdAt\", date, \"createdAfter\", (a, b) => a > b),\n ],\n }),\n createdBefore: (date) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n dateFilter(\"createdAt\", date, \"createdBefore\", (a, b) => a < b),\n ],\n }),\n completedAfter: (date) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n dateFilter(\"completedAt\", date, \"completedAfter\", (a, b) => a > b),\n ],\n }),\n completedBefore: (date) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n dateFilter(\"completedAt\", date, \"completedBefore\", (a, b) => a < b),\n ],\n }),\n sortBy: (field, direction = \"asc\") =>\n createTodoQuery(load, { ...state, sort: { field, direction } }),\n projects: () => pluckNames(load, state, (todo) => todo.projects),\n contexts: () => pluckNames(load, state, (todo) => todo.contexts),\n count: () => resolveCount(load, state),\n first: () => resolveFirst(load, state),\n then: (onfulfilled, onrejected) =>\n resolveRecords(load, state).then(onfulfilled, onrejected),\n };\n}\n","import { cloneRecords } from \"./clone.ts\";\nimport { parseDocument } from \"./parse.ts\";\nimport { createTodoQuery } from \"./query.ts\";\nimport type {\n TodoMatchOptions,\n TodoQuery,\n TodoSortDirection,\n TodoSortField,\n} from \"./query.ts\";\nimport type {\n TodoClientOptions,\n TodoLogger,\n TodoRecord,\n} from \"./types.ts\";\n\n/** The read interface returned by {@link createTodoTxt}. */\nexport interface TodoTxtClient {\n /** Read fresh todo.txt contents, replace the cache, and return every record. */\n all: () => Promise<TodoRecord[]>;\n /** Query only records that are not completed, using the cached snapshot. */\n pending: () => TodoQuery;\n /** Query only records that are completed, using the cached snapshot. */\n completed: () => TodoQuery;\n /**\n * Query records tagged with the project `name`, using the cache.\n *\n * An array matches any listed name; see {@link TodoQuery.project}.\n */\n project: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Query records tagged with the context `name`; see {@link TodoQuery.project}. */\n context: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Query records not tagged with the project `name`; see {@link TodoQuery.notProject}. */\n notProject: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Query records not tagged with the context `name`; see {@link TodoQuery.notProject}. */\n notContext: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Query records with the priority `letter`; see {@link TodoQuery.priority}. */\n priority: (letter: string | string[]) => TodoQuery;\n /** Query records whose description contains `text`; see {@link TodoQuery.search}. */\n search: (text: string, options?: TodoMatchOptions) => TodoQuery;\n /** Query records with the metadata `key`; see {@link TodoQuery.meta}. */\n meta: (key: string, value?: string) => TodoQuery;\n /** Query records that have the metadata `key`; see {@link TodoQuery.hasMeta}. */\n hasMeta: (key: string) => TodoQuery;\n /** Query records created strictly after `date`; see {@link TodoQuery.createdAfter}. */\n createdAfter: (date: string) => TodoQuery;\n /** Query records created strictly before `date`; see {@link TodoQuery.createdAfter}. */\n createdBefore: (date: string) => TodoQuery;\n /** Query records completed strictly after `date`; see {@link TodoQuery.createdAfter}. */\n completedAfter: (date: string) => TodoQuery;\n /** Query records completed strictly before `date`; see {@link TodoQuery.createdAfter}. */\n completedBefore: (date: string) => TodoQuery;\n /** Sort the whole cached snapshot; see {@link TodoQuery.sortBy}. */\n sortBy: (field: TodoSortField, direction?: TodoSortDirection) => TodoQuery;\n /** Count records in the cached snapshot; see {@link TodoQuery.count}. */\n count: () => Promise<number>;\n /** First record of the cached snapshot; see {@link TodoQuery.first}. */\n first: () => Promise<TodoRecord | undefined>;\n /** List unique project names from the cached snapshot, alphabetically sorted. */\n projects: () => Promise<string[]>;\n /** List unique context names from the cached snapshot, alphabetically sorted. */\n contexts: () => Promise<string[]>;\n}\n\n/**\n * Create a todo.txt client backed by consumer-supplied file hooks.\n *\n * The library performs no IO of its own: `options.read` is responsible for\n * producing the file contents and `options.write` will be used by the write\n * APIs once they are implemented. `options.logger` is optional and silent by\n * default; when supplied, it receives read lifecycle and parse warning\n * diagnostics. With `options.includeSource`, every record also carries the\n * 1-based `line` number and the exact `raw` line it was parsed from. With\n * `options.caseSensitive: false`, project and context matching compares\n * names through `toLowerCase()`; the default is exact matching.\n *\n * Parsed records are cached in memory per client. The first query loads and\n * parses the file; later queries reuse that snapshot. {@link TodoTxtClient.all}\n * always reads fresh contents and replaces the cache, so it can be used to\n * refresh after the underlying file changes.\n *\n * Every line is parsed into a {@link TodoRecord} when the cache is populated.\n * Filters such as {@link TodoQuery.pending} and {@link TodoQuery.project}\n * operate on that array of JSON records, and plucks such as\n * {@link TodoQuery.projects} return unique, alphabetically sorted names.\n * Returned records are copies, so callers may mutate them without affecting the\n * cache.\n */\nexport function createTodoTxt(options: TodoClientOptions): TodoTxtClient {\n let cache: TodoRecord[] | undefined;\n let inFlight: Promise<TodoRecord[]> | undefined;\n let generation = 0;\n\n const logger = options.logger;\n\n const log: TodoLogger = (level, message, meta) => {\n if (!logger) {\n return;\n }\n\n try {\n const result = logger(level, message, meta);\n\n if (\n result &&\n typeof (result as PromiseLike<unknown>).then === \"function\"\n ) {\n void Promise.resolve(result).catch(() => {});\n }\n } catch {\n // Logging is best-effort and must never break reads or queries.\n }\n };\n\n const readFresh = async (): Promise<TodoRecord[]> => {\n const currentGeneration = ++generation;\n\n log(\"debug\", \"Reading todo file\");\n const contents = await options.read();\n const records = parseDocument(contents, {\n includeSource: options.includeSource,\n onWarning: (warning) => {\n log(\"warn\", warning.message, {\n ...warning.meta,\n code: warning.code,\n line: warning.line,\n });\n },\n });\n log(\"debug\", \"Parsed todo file\", { records: records.length });\n\n if (currentGeneration === generation) {\n cache = records;\n }\n\n return records;\n };\n\n const refresh = (): Promise<TodoRecord[]> => {\n const promise = readFresh();\n inFlight = promise;\n\n void promise\n .finally(() => {\n if (inFlight === promise) {\n inFlight = undefined;\n }\n })\n .catch(() => {});\n\n return promise;\n };\n\n const loadCached = (): Promise<TodoRecord[]> => {\n if (inFlight) {\n return inFlight;\n }\n\n if (cache) {\n return Promise.resolve(cache);\n }\n\n return refresh();\n };\n\n const all = async (): Promise<TodoRecord[]> =>\n cloneRecords(await refresh());\n\n const query = createTodoQuery(loadCached, {\n filters: [],\n caseSensitive: options.caseSensitive ?? true,\n });\n\n return {\n all,\n pending: query.pending,\n completed: query.completed,\n project: query.project,\n context: query.context,\n notProject: query.notProject,\n notContext: query.notContext,\n priority: query.priority,\n search: query.search,\n meta: query.meta,\n hasMeta: query.hasMeta,\n createdAfter: query.createdAfter,\n createdBefore: query.createdBefore,\n completedAfter: query.completedAfter,\n completedBefore: query.completedBefore,\n sortBy: query.sortBy,\n count: query.count,\n first: query.first,\n projects: query.projects,\n contexts: query.contexts,\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/clone.ts","../src/errors.ts","../src/date.ts","../src/metadata.ts","../src/parse.ts","../src/query.ts","../src/client.ts"],"sourcesContent":["import type { TodoRecord } from \"./types.ts\";\n\n/** Copy a record so callers cannot mutate the client's cached snapshot. */\nexport function cloneRecord(todo: TodoRecord): TodoRecord {\n const copy: TodoRecord = {\n completed: todo.completed,\n priority: todo.priority,\n completedAt: todo.completedAt,\n createdAt: todo.createdAt,\n description: todo.description,\n projects: [...todo.projects],\n contexts: [...todo.contexts],\n data: { ...todo.data },\n };\n\n if (todo.line !== undefined) {\n copy.line = todo.line;\n }\n\n if (todo.raw !== undefined) {\n copy.raw = todo.raw;\n }\n\n return copy;\n}\n\n/** Copy every record in `records`. */\nexport function cloneRecords(records: readonly TodoRecord[]): TodoRecord[] {\n return records.map(cloneRecord);\n}\n","/**\n * Thrown when a consumer-supplied read hook rejects with a value that is not\n * an `Error`.\n *\n * Rejections that are already `Error` instances — including filesystem errors\n * with a `code` such as `ENOENT` — propagate untouched, so existing\n * error-code checks keep working. Anything else, such as a thrown string or a\n * plain object, is wrapped; the original value is available on `cause`.\n */\nexport class TodoReadError extends Error {\n /** The value the read hook rejected with. */\n declare readonly cause: unknown;\n\n constructor(message: string, cause: unknown) {\n super(message, { cause });\n this.name = \"TodoReadError\";\n }\n}\n","const DATE_SHAPE_PATTERN = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];\n\nfunction isLeapYear(year: number): boolean {\n return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;\n}\n\n/**\n * True when `value` is a real calendar date in `YYYY-MM-DD` form.\n *\n * The check is purely arithmetic so it does not depend on the host timezone and\n * does not let JavaScript's `Date` roll invalid values over (for example,\n * `2011-02-30` must not become March 2).\n */\nexport function isValidDate(value: string): boolean {\n const match = DATE_SHAPE_PATTERN.exec(value);\n if (!match) {\n return false;\n }\n\n const year = Number(match[1]);\n const month = Number(match[2]);\n const day = Number(match[3]);\n\n if (month < 1 || month > 12 || day < 1) {\n return false;\n }\n\n const maxDay =\n month === 2 && isLeapYear(year) ? 29 : (DAYS_IN_MONTH[month - 1] ?? 0);\n\n return day <= maxDay;\n}\n","import type { ParseWarningHandler } from \"./types.ts\";\n\nconst EXTENSION_PATTERN = /^([^:\\s]+):([^:\\s]+)$/;\n\n/** Metadata collected from a task's text. */\nexport interface TodoMetadata {\n projects: string[];\n contexts: string[];\n data: Record<string, string>;\n}\n\n/** Everything derived from a task's text in one token pass. */\nexport interface TodoText extends TodoMetadata {\n description: string;\n}\n\nfunction tokenize(text: string): string[] {\n const trimmed = text.trim();\n if (trimmed === \"\") {\n return [];\n }\n\n return trimmed.split(/\\s+/);\n}\n\n/**\n * True when a whitespace-delimited token is inline metadata.\n *\n * Inline metadata is a project (`+name`), a context (`@name`), or a\n * `key:value` extension. Bare `+`/`@` tokens and values containing another\n * colon are not metadata.\n */\nexport function isMetadataToken(token: string): boolean {\n if (token.startsWith(\"+\") && token.length > 1) {\n return true;\n }\n\n if (token.startsWith(\"@\") && token.length > 1) {\n return true;\n }\n\n return EXTENSION_PATTERN.test(token);\n}\n\n/**\n * Collect a task's description, projects, contexts, and extensions in one pass.\n *\n * Previous versions tokenized the text once for metadata and again to strip it;\n * doing both here keeps parsing to a single split per line.\n *\n * When a `key:value` key is repeated, `onWarning` receives a\n * `duplicate-metadata-key` warning and the last value wins.\n */\nexport function parseText(\n text: string,\n onWarning?: ParseWarningHandler,\n): TodoText {\n const projects: string[] = [];\n const contexts: string[] = [];\n const data: Record<string, string> = {};\n const descriptionTokens: string[] = [];\n\n for (const token of tokenize(text)) {\n if (token.startsWith(\"+\") && token.length > 1) {\n projects.push(token.slice(1));\n continue;\n }\n\n if (token.startsWith(\"@\") && token.length > 1) {\n contexts.push(token.slice(1));\n continue;\n }\n\n const extension = EXTENSION_PATTERN.exec(token);\n const key = extension?.[1];\n const value = extension?.[2];\n if (key !== undefined && value !== undefined) {\n if (Object.hasOwn(data, key)) {\n onWarning?.({\n code: \"duplicate-metadata-key\",\n message: `Duplicate metadata key \"${key}\"; the last value wins.`,\n meta: { key, previousValue: data[key], value },\n });\n }\n\n data[key] = value;\n continue;\n }\n\n descriptionTokens.push(token);\n }\n\n return {\n description: descriptionTokens.join(\" \"),\n projects,\n contexts,\n data,\n };\n}\n\n/** Collect projects, contexts, and extensions from task text. */\nexport function parseMetadata(text: string): TodoMetadata {\n const { projects, contexts, data } = parseText(text);\n return { projects, contexts, data };\n}\n\n/**\n * Remove inline metadata from task text.\n *\n * Remaining tokens are rejoined with single spaces, so repeated whitespace can\n * be normalized.\n */\nexport function stripMetadata(text: string): string {\n return parseText(text).description;\n}\n","import { isValidDate } from \"./date.ts\";\nimport { parseText } from \"./metadata.ts\";\nimport type {\n ParseOptions,\n ParseResult,\n ParseWarning,\n ParseWarningHandler,\n TodoRecord,\n} from \"./types.ts\";\n\nconst PRIORITY_PATTERN = /^\\(([A-Z])\\) /;\nconst LEADING_DATE_PATTERN = /^(\\d{4}-\\d{2}-\\d{2})(?: |$)/;\n\ntype LeadingDate =\n | { kind: \"absent\"; rest: string }\n | { kind: \"valid\"; date: string; rest: string }\n | { kind: \"invalid\"; value: string; rest: string };\n\n/**\n * Inspect a `YYYY-MM-DD` token at the start of `input`.\n *\n * A value with the right shape that does not exist on the calendar is reported\n * as `invalid`. In that case `rest` is the original input, so callers leave the\n * token in the description instead of consuming it.\n */\nfunction takeLeadingDate(input: string): LeadingDate {\n const match = LEADING_DATE_PATTERN.exec(input);\n if (!match) {\n return { kind: \"absent\", rest: input };\n }\n\n const date = match[1];\n if (date === undefined) {\n return { kind: \"absent\", rest: input };\n }\n\n if (!isValidDate(date)) {\n return { kind: \"invalid\", value: date, rest: input };\n }\n\n return { kind: \"valid\", date, rest: input.slice(match[0]!.length) };\n}\n\nfunction warnInvalidDate(\n value: string,\n field: \"completedAt\" | \"createdAt\",\n onWarning?: ParseWarningHandler,\n): void {\n const label = field === \"completedAt\" ? \"completion\" : \"creation\";\n\n onWarning?.({\n code: \"invalid-date\",\n message: `Invalid ${label} date \"${value}\"; treating it as text.`,\n meta: { value, field },\n });\n}\n\n/**\n * Accept either a {@link ParseWarningHandler} (deprecated) or\n * {@link ParseOptions} as the second argument.\n */\nfunction normalizeParseOptions(\n onWarningOrOptions?: ParseWarningHandler | ParseOptions,\n): ParseOptions {\n if (typeof onWarningOrOptions === \"function\") {\n return { onWarning: onWarningOrOptions };\n }\n\n return onWarningOrOptions ?? {};\n}\n\n/** Remove one trailing `\\r`, so `raw` has no carriage return for CRLF input. */\nfunction stripTrailingCarriageReturn(line: string): string {\n return line.endsWith(\"\\r\") ? line.slice(0, -1) : line;\n}\n\n/**\n * Parse a single todo.txt line directly into a JSON-friendly {@link TodoRecord}.\n *\n * The parser follows the todo.txt format rules:\n *\n * - Completed tasks start with `x `, optionally followed by a completion date\n * and then a creation date.\n * - Incomplete tasks may start with an `(A)`–`(Z)` priority and an optional\n * creation date.\n * - Dates must be real calendar dates in `YYYY-MM-DD` form. A shape-valid but\n * nonexistent date is treated as text.\n * - Projects, contexts, and `key:value` metadata may appear anywhere in the\n * remaining text.\n *\n * Recoverable issues are reported to `options.onWarning` when supplied;\n * parsing still produces a record.\n *\n * With `options.includeSource`, the record carries `raw` (the exact input\n * line, minus a trailing `\\r`) and `line` (the number supplied via\n * `options.line`, when given).\n */\nexport function parseLine(\n line: string,\n options?: ParseOptions,\n): TodoRecord;\n/** @deprecated Pass {@link ParseOptions} with `onWarning` instead. */\nexport function parseLine(\n line: string,\n onWarning: ParseWarningHandler,\n): TodoRecord;\nexport function parseLine(\n line: string,\n onWarningOrOptions?: ParseWarningHandler | ParseOptions,\n): TodoRecord {\n const options = normalizeParseOptions(onWarningOrOptions);\n let rest = line;\n let completed = false;\n let priority: string | null = null;\n let completedAt: string | null = null;\n let createdAt: string | null = null;\n\n if (rest.startsWith(\"x \")) {\n completed = true;\n rest = rest.slice(2);\n\n const completedDate = takeLeadingDate(rest);\n if (completedDate.kind === \"valid\") {\n completedAt = completedDate.date;\n rest = completedDate.rest;\n\n const createdDate = takeLeadingDate(rest);\n if (createdDate.kind === \"valid\") {\n createdAt = createdDate.date;\n rest = createdDate.rest;\n } else if (createdDate.kind === \"invalid\") {\n warnInvalidDate(createdDate.value, \"createdAt\", options.onWarning);\n }\n } else if (completedDate.kind === \"invalid\") {\n // The same token cannot also be a creation date, so only warn once.\n warnInvalidDate(completedDate.value, \"completedAt\", options.onWarning);\n }\n } else {\n const priorityMatch = PRIORITY_PATTERN.exec(rest);\n if (priorityMatch) {\n priority = priorityMatch[1]!;\n rest = rest.slice(priorityMatch[0]!.length);\n }\n\n const createdDate = takeLeadingDate(rest);\n if (createdDate.kind === \"valid\") {\n createdAt = createdDate.date;\n rest = createdDate.rest;\n } else if (createdDate.kind === \"invalid\") {\n warnInvalidDate(createdDate.value, \"createdAt\", options.onWarning);\n }\n }\n\n const text = rest.trim();\n const { description, projects, contexts, data } = parseText(\n text,\n options.onWarning,\n );\n\n const record: TodoRecord = {\n completed,\n priority,\n completedAt,\n createdAt,\n description,\n projects,\n contexts,\n data,\n };\n\n if (options.includeSource) {\n if (options.line !== undefined) {\n record.line = options.line;\n }\n\n record.raw = stripTrailingCarriageReturn(line);\n }\n\n return record;\n}\n\n/**\n * Shared document parser behind {@link parseDocument} and\n * {@link parseDocumentResult}.\n *\n * Warnings are always collected, in document order and annotated with their\n * 1-based physical line number, and forwarded to the consumer's `onWarning`\n * when one is supplied. A single trailing newline ends the last line rather\n * than starting an empty one, so it adds neither a line nor a skipped line.\n */\nfunction parseDocumentCore(\n contents: string,\n options: ParseOptions,\n): ParseResult {\n const { includeSource, onWarning } = options;\n const segments = contents.split(/\\r?\\n/);\n const lines =\n contents === \"\"\n ? []\n : contents.endsWith(\"\\n\")\n ? segments.slice(0, -1)\n : segments;\n\n const records: TodoRecord[] = [];\n const warnings: ParseWarning[] = [];\n let skippedLines = 0;\n let lineNumber = 0;\n\n for (const line of lines) {\n lineNumber += 1;\n\n if (line.trim() === \"\") {\n skippedLines += 1;\n continue;\n }\n\n records.push(\n parseLine(line, {\n includeSource,\n line: lineNumber,\n onWarning: (warning) => {\n const annotated = { ...warning, line: lineNumber };\n warnings.push(annotated);\n onWarning?.(annotated);\n },\n }),\n );\n }\n\n return { records, warnings, lineCount: lines.length, skippedLines };\n}\n\n/**\n * Parse the contents of a todo.txt file.\n *\n * Lines are split on `\\n` or `\\r\\n`; blank and whitespace-only lines are\n * skipped. Every remaining line becomes a {@link TodoRecord}. Warnings are\n * annotated with the 1-based physical line number.\n *\n * With `options.includeSource`, every record carries `raw` (the exact line,\n * minus a trailing `\\r`) and `line` (the 1-based physical line number,\n * counting blank lines).\n */\nexport function parseDocument(\n contents: string,\n options?: ParseOptions,\n): TodoRecord[];\n/** @deprecated Pass {@link ParseOptions} with `onWarning` instead. */\nexport function parseDocument(\n contents: string,\n onWarning: ParseWarningHandler,\n): TodoRecord[];\nexport function parseDocument(\n contents: string,\n onWarningOrOptions?: ParseWarningHandler | ParseOptions,\n): TodoRecord[] {\n return parseDocumentCore(\n contents,\n normalizeParseOptions(onWarningOrOptions),\n ).records;\n}\n\n/**\n * Parse the contents of a todo.txt file, returning records, warnings, and\n * line counts as data.\n *\n * The records are exactly what {@link parseDocument} returns. The\n * {@link ParseResult} additionally carries every warning in document order\n * (annotated with the 1-based physical line number), the number of physical\n * lines, and how many of them were blank or whitespace-only. A single\n * trailing newline ends the last line rather than starting an empty one, and\n * the empty input has no lines.\n *\n * Warnings are also forwarded to `options.onWarning` when supplied, so this\n * composes with existing warning handling.\n */\nexport function parseDocumentResult(\n contents: string,\n options?: ParseOptions,\n): ParseResult {\n return parseDocumentCore(contents, normalizeParseOptions(options));\n}\n","import { cloneRecord, cloneRecords } from \"./clone.ts\";\nimport { isValidDate } from \"./date.ts\";\nimport type { TodoRecord } from \"./types.ts\";\n\n/** A predicate applied to every record in a query. */\nexport type TodoFilter = (todo: TodoRecord) => boolean;\n\n/** Loads and parses every todo.txt record. */\nexport type LoadRecords = () => Promise<TodoRecord[]>;\n\n/** Fields that {@link TodoQuery.sortBy} can order results by. */\nexport type TodoSortField =\n | \"priority\"\n | \"createdAt\"\n | \"completedAt\"\n | \"description\"\n | \"due\";\n\n/** Sort direction for {@link TodoQuery.sortBy}. Default: `\"asc\"`. */\nexport type TodoSortDirection = \"asc\" | \"desc\";\n\n/**\n * Per-call matching options.\n *\n * `caseSensitive` overrides the client-level default for one call. The default\n * differs per method: project and context matching is exact and case-sensitive\n * unless the option says otherwise, while search is case-insensitive unless the\n * option says otherwise.\n */\nexport interface TodoMatchOptions {\n /** Compare case-sensitively (or, for search, insensitively) for this call. */\n caseSensitive?: boolean;\n}\n\n/** One ordering step appended by {@link TodoQuery.sortBy}. */\nexport interface TodoSortSpec {\n field: TodoSortField;\n direction: TodoSortDirection;\n}\n\n/**\n * Pending/completed/total counts for one bucket of records.\n *\n * `total` is always `pending + completed`.\n */\nexport interface TodoCount {\n /** Records that are not completed. */\n pending: number;\n /** Records marked completed. */\n completed: number;\n /** Every record in the bucket. */\n total: number;\n}\n\n/**\n * One named bucket with its counts, from the aggregate query methods.\n *\n * The name is the project or context exactly as parsed, without the `+` or\n * `@` prefix and with its original casing.\n */\nexport interface TodoNameCount {\n /** Project or context name from the matching records. */\n name: string;\n /** Counts over the matching records that carry the name. */\n counts: TodoCount;\n}\n\n/**\n * Result of {@link TodoQuery.summary}: totals for the matching records plus\n * per-name counts.\n *\n * Per-name totals count multi-tag records once per name, so they do not sum\n * to the top-level `total` when multi-tag records or untagged records\n * exist.\n */\nexport interface TodoSummary {\n /** Every record matching the query. */\n total: number;\n /** Matching records that are not completed. */\n pending: number;\n /** Matching records that are completed. */\n completed: number;\n /** Per-project counts over the matching records. */\n projects: TodoNameCount[];\n /** Per-context counts over the matching records. */\n contexts: TodoNameCount[];\n}\n\n/** Internal query state: AND-composed filters plus one optional sort step. */\nexport interface TodoQueryState {\n filters: TodoFilter[];\n sort?: TodoSortSpec;\n /**\n * Client-level default for name matching. Search is unaffected: it stays\n * case-insensitive by default no matter what this says.\n */\n caseSensitive: boolean;\n}\n\n/**\n * A lazy query over parsed todo records.\n *\n * Filters return a new query and perform no IO. Awaiting a query resolves\n * through the supplied loader; the client caches parsed records, so only the\n * first query reads the file. Filters compose with AND: every predicate added\n * to the chain must match. Array arguments are OR within a single call, so\n * `project([\"A\", \"B\"])` matches either name while `project(\"A\").project(\"B\")`\n * requires both. {@link TodoQuery.projects} and {@link TodoQuery.contexts}\n * are terminal plucks that resolve to unique, alphabetically sorted names;\n * {@link TodoQuery.summary}, {@link TodoQuery.countsByProject}, and\n * {@link TodoQuery.countsByContext} are terminal aggregates; and\n * {@link TodoQuery.count} and {@link TodoQuery.first} are terminal shortcuts.\n */\nexport interface TodoQuery extends PromiseLike<TodoRecord[]> {\n /** Only records that are not completed. */\n pending: () => TodoQuery;\n /** Only records that are completed. */\n completed: () => TodoQuery;\n /**\n * Only records tagged with the project `name`.\n *\n * An array matches any listed name (OR); repeated calls require every name\n * (AND). An empty array matches nothing. Matching is exact and\n * case-sensitive unless the client-level `caseSensitive` option or the\n * per-call override says otherwise; case-insensitive comparison uses\n * `toLowerCase()`, which is not full Unicode case folding.\n */\n project: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Only records tagged with the context `name`; see {@link TodoQuery.project}. */\n context: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /**\n * Only records not tagged with the project `name`.\n *\n * An array excludes every listed name; an empty array excludes nothing.\n * This is not a replacement for `pending()`/`completed()`.\n */\n notProject: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Only records not tagged with the context `name`; see {@link TodoQuery.notProject}. */\n notContext: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /**\n * Only records with priority `letter`.\n *\n * Matching is exact against the uppercase letter the parser stores, so\n * `priority(\"a\")` matches nothing. An array matches any listed letter.\n */\n priority: (letter: string | string[]) => TodoQuery;\n /**\n * Only records whose description contains `text` as a substring.\n *\n * Case-insensitive by default, independently of the client-level matching\n * option. Only `description` is searched; projects, contexts, and metadata\n * have their own filters.\n */\n search: (text: string, options?: TodoMatchOptions) => TodoQuery;\n /**\n * Only records with the metadata `key`.\n *\n * With a `value`, the record's value must match it exactly.\n */\n meta: (key: string, value?: string) => TodoQuery;\n /** Only records that have the metadata `key`, whatever its value. */\n hasMeta: (key: string) => TodoQuery;\n /**\n * Only records created strictly after `date`.\n *\n * The argument must be a real calendar date in `YYYY-MM-DD` form; anything\n * else throws a `TypeError` when the query is built, before any IO.\n * Records without a creation date never match.\n */\n createdAfter: (date: string) => TodoQuery;\n /** Only records created strictly before `date`; see {@link TodoQuery.createdAfter}. */\n createdBefore: (date: string) => TodoQuery;\n /** Only records completed strictly after `date`; see {@link TodoQuery.createdAfter}. */\n completedAfter: (date: string) => TodoQuery;\n /** Only records completed strictly before `date`; see {@link TodoQuery.createdAfter}. */\n completedBefore: (date: string) => TodoQuery;\n /**\n * Sort the filtered records by `field`; default direction is `\"asc\"`.\n *\n * The sort is stable: records with equal keys keep file order. Missing\n * values (`null` priorities or dates, and missing or invalid `due` values)\n * sort last in both directions; `\"desc\"` reverses only the value\n * comparison, never the missing-value placement. Calling `sortBy` twice\n * keeps only the last call. Description ordering uses `localeCompare`, so\n * it follows the host locale for equal-ignoring-case ties.\n */\n sortBy: (field: TodoSortField, direction?: TodoSortDirection) => TodoQuery;\n /** Unique project names in the current result, alphabetically sorted. */\n projects: () => Promise<string[]>;\n /** Unique context names in the current result, alphabetically sorted. */\n contexts: () => Promise<string[]>;\n /**\n * Aggregate counts for the records matching this query.\n *\n * `total`, `pending`, and `completed` count matching records, while\n * `projects` and `contexts` count each matching record once per distinct\n * name it carries, so a record tagged `+A +B` adds one to each name.\n * Per-name totals therefore do not sum to the top-level `total` when\n * multi-tag records or untagged records exist. Names are unique, keep\n * their original casing, and sort alphabetically like\n * {@link TodoQuery.projects}; completed-only records still contribute\n * their names. A `sortBy` step is ignored, and the summary loads through\n * the cache like every other query.\n */\n summary: () => Promise<TodoSummary>;\n /**\n * Unique project names in the current result with their counts; see\n * {@link TodoQuery.summary} for the counting rules.\n */\n countsByProject: () => Promise<TodoNameCount[]>;\n /**\n * Unique context names in the current result with their counts; see\n * {@link TodoQuery.summary} for the counting rules.\n */\n countsByContext: () => Promise<TodoNameCount[]>;\n /** Number of records in the current result; equal to `(await query).length`. */\n count: () => Promise<number>;\n /**\n * The first record of the filtered (and sorted) result, or `undefined`\n * when nothing matches. The record is a copy, so mutating it cannot affect\n * the client's cache.\n */\n first: () => Promise<TodoRecord | undefined>;\n}\n\nfunction uniqueSorted(values: string[]): string[] {\n return [...new Set(values)].sort();\n}\n\nfunction toArray(value: string | string[]): string[] {\n return Array.isArray(value) ? value : [value];\n}\n\n/**\n * Build a name-matching predicate for projects or contexts.\n *\n * Case-insensitive comparison normalizes both sides with `toLowerCase()`,\n * which is deterministic across machines and locales but not full Unicode\n * case folding. `invert` turns the predicate into a negation filter.\n */\nfunction nameFilter(\n pick: (todo: TodoRecord) => string[],\n names: string[],\n caseSensitive: boolean,\n invert: boolean,\n): TodoFilter {\n const wanted = caseSensitive\n ? names\n : names.map((name) => name.toLowerCase());\n\n const matches = (todo: TodoRecord): boolean =>\n pick(todo).some((value) =>\n wanted.includes(caseSensitive ? value : value.toLowerCase()),\n );\n\n return invert ? (todo) => !matches(todo) : matches;\n}\n\n/**\n * Validate a date-filter argument at query-build time.\n *\n * Invalid arguments throw instead of silently matching nothing, so a typo in\n * a bound cannot hide behind an empty result.\n */\nfunction requireValidDate(date: string, method: string): string {\n if (!isValidDate(date)) {\n throw new TypeError(\n `${method}() expected a real calendar date in YYYY-MM-DD form, got \"${date}\".`,\n );\n }\n\n return date;\n}\n\n/**\n * Build a date-comparison predicate on a record date field.\n *\n * Records with `null` dates never match; validated `YYYY-MM-DD` values\n * compare correctly as plain strings.\n */\nfunction dateFilter(\n field: \"createdAt\" | \"completedAt\",\n date: string,\n method: string,\n keep: (recordDate: string, bound: string) => boolean,\n): TodoFilter {\n const bound = requireValidDate(date, method);\n\n return (todo) => {\n const recordDate = todo[field];\n return recordDate !== null && keep(recordDate, bound);\n };\n}\n\n/** Read `data.due` when it is a real calendar date; otherwise `null`. */\nfunction dueDateOf(todo: TodoRecord): string | null {\n const due = todo.data[\"due\"];\n return due !== undefined && isValidDate(due) ? due : null;\n}\n\ntype NullableSortField = Exclude<TodoSortField, \"description\">;\n\n/** Extract the nullable sort key for every field except `description`. */\nfunction sortKey(todo: TodoRecord, field: NullableSortField): string | null {\n switch (field) {\n case \"priority\":\n return todo.priority;\n case \"createdAt\":\n return todo.createdAt;\n case \"completedAt\":\n return todo.completedAt;\n case \"due\":\n return dueDateOf(todo);\n }\n}\n\n/**\n * Compare nullable keys with missing values last in both directions.\n *\n * `desc` negates only the value comparison, never the missing-value\n * placement; equal keys compare as `0` so the stable sort keeps file order.\n */\nfunction compareNullableKeys(\n a: string | null,\n b: string | null,\n direction: TodoSortDirection,\n): number {\n if (a === null) {\n return b === null ? 0 : 1;\n }\n\n if (b === null) {\n return -1;\n }\n\n const result = a < b ? -1 : a > b ? 1 : 0;\n return direction === \"asc\" ? result : -result;\n}\n\n/** Build the sort comparator for one ordering step. */\nfunction makeComparator(\n spec: TodoSortSpec,\n): (a: TodoRecord, b: TodoRecord) => number {\n if (spec.field === \"description\") {\n return (a, b) => {\n const result = a.description.localeCompare(b.description);\n return spec.direction === \"asc\" ? result : -result;\n };\n }\n\n const field: NullableSortField = spec.field;\n\n return (a, b) =>\n compareNullableKeys(\n sortKey(a, field),\n sortKey(b, field),\n spec.direction,\n );\n}\n\n/**\n * Sort in place and return the same array.\n *\n * `Array#sort` is stable, so records with equal keys keep file order.\n */\nfunction applySort(records: TodoRecord[], sort: TodoSortSpec): TodoRecord[] {\n return records.sort(makeComparator(sort));\n}\n\n/**\n * Load, filter, and sort records without cloning them.\n *\n * The returned array is safe to sort because it is always a fresh copy when\n * a sort step exists; without one the loader's own array is returned as-is.\n */\nasync function resolveRaw(\n load: LoadRecords,\n state: TodoQueryState,\n): Promise<TodoRecord[]> {\n const records = await load();\n\n if (state.sort === undefined) {\n if (state.filters.length === 0) {\n return records;\n }\n\n return records.filter((record) =>\n state.filters.every((filter) => filter(record)),\n );\n }\n\n // Never sort the loader's array in place: the client's cache must keep\n // file order for later queries.\n const matches =\n state.filters.length === 0\n ? records.slice()\n : records.filter((record) =>\n state.filters.every((filter) => filter(record)),\n );\n\n return applySort(matches, state.sort);\n}\n\nasync function resolveRecords(\n load: LoadRecords,\n state: TodoQueryState,\n): Promise<TodoRecord[]> {\n return cloneRecords(await resolveRaw(load, state));\n}\n\nfunction pluckNames(\n load: LoadRecords,\n state: TodoQueryState,\n pick: (todo: TodoRecord) => string[],\n): Promise<string[]> {\n // Sorting never applies to name plucks; they alphabetize themselves.\n return resolveRaw(load, { ...state, sort: undefined }).then((records) =>\n uniqueSorted(records.flatMap(pick)),\n );\n}\n\n/**\n * Count pending/completed/total per unique name over `records`.\n *\n * Each record contributes at most once per name, so a record tagged\n * `+A +A` counts `A` once. Names keep their original casing and sort\n * like the name plucks, so buckets line up with `projects()`/`contexts()`.\n */\nfunction countNames(\n records: TodoRecord[],\n pick: (todo: TodoRecord) => string[],\n): TodoNameCount[] {\n const buckets = new Map<string, TodoCount>();\n\n for (const record of records) {\n for (const name of new Set(pick(record))) {\n const bucket = buckets.get(name);\n\n if (bucket === undefined) {\n buckets.set(name, {\n pending: record.completed ? 0 : 1,\n completed: record.completed ? 1 : 0,\n total: 1,\n });\n } else if (record.completed) {\n bucket.completed += 1;\n bucket.total += 1;\n } else {\n bucket.pending += 1;\n bucket.total += 1;\n }\n }\n }\n\n return [...buckets]\n .map(([name, counts]) => ({ name, counts }))\n .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));\n}\n\nfunction resolveCount(\n load: LoadRecords,\n state: TodoQueryState,\n): Promise<number> {\n return resolveRaw(load, { ...state, sort: undefined }).then(\n (records) => records.length,\n );\n}\n\n/**\n * Aggregate the current result into a summary.\n *\n * Sorting never applies to aggregates; they count records, not order them.\n */\nasync function resolveSummary(\n load: LoadRecords,\n state: TodoQueryState,\n): Promise<TodoSummary> {\n const records = await resolveRaw(load, { ...state, sort: undefined });\n let pending = 0;\n let completed = 0;\n\n for (const record of records) {\n if (record.completed) {\n completed += 1;\n } else {\n pending += 1;\n }\n }\n\n return {\n total: records.length,\n pending,\n completed,\n projects: countNames(records, (todo) => todo.projects),\n contexts: countNames(records, (todo) => todo.contexts),\n };\n}\n\nfunction resolveCountsBy(\n load: LoadRecords,\n state: TodoQueryState,\n pick: (todo: TodoRecord) => string[],\n): Promise<TodoNameCount[]> {\n // Sorting never applies to aggregates; they count records, not order them.\n return resolveRaw(load, { ...state, sort: undefined }).then((records) =>\n countNames(records, pick),\n );\n}\n\nasync function resolveFirst(\n load: LoadRecords,\n state: TodoQueryState,\n): Promise<TodoRecord | undefined> {\n const first = (await resolveRaw(load, state))[0];\n return first === undefined ? undefined : cloneRecord(first);\n}\n\n/**\n * Create a lazy query over the records loaded by `load`.\n *\n * Each filter method appends a predicate, so chained calls compose with AND,\n * while array arguments match any listed value. `sortBy` appends an ordering\n * step instead of a predicate; the last `sortBy` call wins. For example,\n * `pending().completed()` matches nothing, while\n * `project(\"Work\").pending()` matches pending records in `Work`, and\n * `pending().sortBy(\"priority\")` lists them A first.\n */\nexport function createTodoQuery(\n load: LoadRecords,\n state: TodoQueryState = { filters: [], caseSensitive: true },\n): TodoQuery {\n const nameOptions = (options?: TodoMatchOptions): boolean =>\n options?.caseSensitive ?? state.caseSensitive;\n\n return {\n pending: () =>\n createTodoQuery(load, {\n ...state,\n filters: [...state.filters, (todo) => !todo.completed],\n }),\n completed: () =>\n createTodoQuery(load, {\n ...state,\n filters: [...state.filters, (todo) => todo.completed],\n }),\n project: (name, options) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n nameFilter(\n (todo) => todo.projects,\n toArray(name),\n nameOptions(options),\n false,\n ),\n ],\n }),\n context: (name, options) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n nameFilter(\n (todo) => todo.contexts,\n toArray(name),\n nameOptions(options),\n false,\n ),\n ],\n }),\n notProject: (name, options) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n nameFilter(\n (todo) => todo.projects,\n toArray(name),\n nameOptions(options),\n true,\n ),\n ],\n }),\n notContext: (name, options) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n nameFilter(\n (todo) => todo.contexts,\n toArray(name),\n nameOptions(options),\n true,\n ),\n ],\n }),\n priority: (letter) => {\n const letters = toArray(letter);\n\n return createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n (todo) => todo.priority !== null && letters.includes(todo.priority),\n ],\n });\n },\n search: (text, options) => {\n const caseSensitive = options?.caseSensitive ?? false;\n const needle = caseSensitive ? text : text.toLowerCase();\n\n return createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n (todo) => {\n const haystack = caseSensitive\n ? todo.description\n : todo.description.toLowerCase();\n return haystack.includes(needle);\n },\n ],\n });\n },\n meta: (key, value) => {\n const filter: TodoFilter =\n value === undefined\n ? (todo) => Object.hasOwn(todo.data, key)\n : (todo) => todo.data[key] === value;\n\n return createTodoQuery(load, { ...state, filters: [...state.filters, filter] });\n },\n hasMeta: (key) =>\n createTodoQuery(load, {\n ...state,\n filters: [...state.filters, (todo) => Object.hasOwn(todo.data, key)],\n }),\n createdAfter: (date) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n dateFilter(\"createdAt\", date, \"createdAfter\", (a, b) => a > b),\n ],\n }),\n createdBefore: (date) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n dateFilter(\"createdAt\", date, \"createdBefore\", (a, b) => a < b),\n ],\n }),\n completedAfter: (date) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n dateFilter(\"completedAt\", date, \"completedAfter\", (a, b) => a > b),\n ],\n }),\n completedBefore: (date) =>\n createTodoQuery(load, {\n ...state,\n filters: [\n ...state.filters,\n dateFilter(\"completedAt\", date, \"completedBefore\", (a, b) => a < b),\n ],\n }),\n sortBy: (field, direction = \"asc\") =>\n createTodoQuery(load, { ...state, sort: { field, direction } }),\n projects: () => pluckNames(load, state, (todo) => todo.projects),\n contexts: () => pluckNames(load, state, (todo) => todo.contexts),\n summary: () => resolveSummary(load, state),\n countsByProject: () => resolveCountsBy(load, state, (todo) => todo.projects),\n countsByContext: () => resolveCountsBy(load, state, (todo) => todo.contexts),\n count: () => resolveCount(load, state),\n first: () => resolveFirst(load, state),\n then: (onfulfilled, onrejected) =>\n resolveRecords(load, state).then(onfulfilled, onrejected),\n };\n}\n","import { cloneRecords } from \"./clone.ts\";\nimport { TodoReadError } from \"./errors.ts\";\nimport { parseDocumentResult } from \"./parse.ts\";\nimport { createTodoQuery } from \"./query.ts\";\nimport type {\n TodoMatchOptions,\n TodoNameCount,\n TodoQuery,\n TodoSortDirection,\n TodoSortField,\n TodoSummary,\n} from \"./query.ts\";\nimport type {\n ParseWarning,\n TodoClientOptions,\n TodoLogger,\n TodoRecord,\n} from \"./types.ts\";\n\n/** The read interface returned by {@link createTodoTxt}. */\nexport interface TodoTxtClient {\n /** Read fresh todo.txt contents, replace the cache, and return every record. */\n all: () => Promise<TodoRecord[]>;\n /**\n * Warnings from the most recent successful read, in document order.\n *\n * Empty before the first read and after a read without warnings. A failed\n * read leaves the previous read's warnings in place. The returned array and\n * its warnings are copies, so callers may mutate them without affecting\n * later calls. A `logger`, when supplied, still receives warnings as they\n * are found; this is an additional access path, not a replacement.\n */\n warnings: () => ParseWarning[];\n /** Query only records that are not completed, using the cached snapshot. */\n pending: () => TodoQuery;\n /** Query only records that are completed, using the cached snapshot. */\n completed: () => TodoQuery;\n /**\n * Query records tagged with the project `name`, using the cache.\n *\n * An array matches any listed name; see {@link TodoQuery.project}.\n */\n project: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Query records tagged with the context `name`; see {@link TodoQuery.project}. */\n context: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Query records not tagged with the project `name`; see {@link TodoQuery.notProject}. */\n notProject: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Query records not tagged with the context `name`; see {@link TodoQuery.notProject}. */\n notContext: (name: string | string[], options?: TodoMatchOptions) => TodoQuery;\n /** Query records with the priority `letter`; see {@link TodoQuery.priority}. */\n priority: (letter: string | string[]) => TodoQuery;\n /** Query records whose description contains `text`; see {@link TodoQuery.search}. */\n search: (text: string, options?: TodoMatchOptions) => TodoQuery;\n /** Query records with the metadata `key`; see {@link TodoQuery.meta}. */\n meta: (key: string, value?: string) => TodoQuery;\n /** Query records that have the metadata `key`; see {@link TodoQuery.hasMeta}. */\n hasMeta: (key: string) => TodoQuery;\n /** Query records created strictly after `date`; see {@link TodoQuery.createdAfter}. */\n createdAfter: (date: string) => TodoQuery;\n /** Query records created strictly before `date`; see {@link TodoQuery.createdAfter}. */\n createdBefore: (date: string) => TodoQuery;\n /** Query records completed strictly after `date`; see {@link TodoQuery.createdAfter}. */\n completedAfter: (date: string) => TodoQuery;\n /** Query records completed strictly before `date`; see {@link TodoQuery.createdAfter}. */\n completedBefore: (date: string) => TodoQuery;\n /** Sort the whole cached snapshot; see {@link TodoQuery.sortBy}. */\n sortBy: (field: TodoSortField, direction?: TodoSortDirection) => TodoQuery;\n /** Count records in the cached snapshot; see {@link TodoQuery.count}. */\n count: () => Promise<number>;\n /** First record of the cached snapshot; see {@link TodoQuery.first}. */\n first: () => Promise<TodoRecord | undefined>;\n /** List unique project names from the cached snapshot, alphabetically sorted. */\n projects: () => Promise<string[]>;\n /** List unique context names from the cached snapshot, alphabetically sorted. */\n contexts: () => Promise<string[]>;\n /** Aggregate counts for the cached snapshot; see {@link TodoQuery.summary}. */\n summary: () => Promise<TodoSummary>;\n /** Per-project counts for the cached snapshot; see {@link TodoQuery.countsByProject}. */\n countsByProject: () => Promise<TodoNameCount[]>;\n /** Per-context counts for the cached snapshot; see {@link TodoQuery.countsByContext}. */\n countsByContext: () => Promise<TodoNameCount[]>;\n}\n\n/**\n * Create a todo.txt client backed by consumer-supplied file hooks.\n *\n * The library performs no IO of its own: `options.read` is responsible for\n * producing the file contents and `options.write` will be used by the write\n * APIs once they are implemented. `options.logger` is optional and silent by\n * default; when supplied, it receives read lifecycle and parse warning\n * diagnostics. Warnings from the most recent read are also available as data\n * through {@link TodoTxtClient.warnings}. A `read` hook rejection propagates\n * untouched when the rejected value is an `Error`; any other value is wrapped\n * in a {@link TodoReadError} that carries the original on `cause`. With\n * `options.includeSource`, every record also carries the 1-based `line` number\n * and the exact `raw` line it was parsed from. With\n * `options.caseSensitive: false`, project and context matching compares\n * names through `toLowerCase()`; the default is exact matching.\n *\n * Parsed records are cached in memory per client. The first query loads and\n * parses the file; later queries reuse that snapshot. {@link TodoTxtClient.all}\n * always reads fresh contents and replaces the cache, so it can be used to\n * refresh after the underlying file changes.\n *\n * Every line is parsed into a {@link TodoRecord} when the cache is populated.\n * Filters such as {@link TodoQuery.pending} and {@link TodoQuery.project}\n * operate on that array of JSON records, plucks such as\n * {@link TodoQuery.projects} return unique, alphabetically sorted names, and\n * aggregates such as {@link TodoQuery.summary} count pending and completed\n * records per name. Returned records are copies, so callers may mutate them\n * without affecting the cache.\n */\nexport function createTodoTxt(options: TodoClientOptions): TodoTxtClient {\n let cache: TodoRecord[] | undefined;\n let lastWarnings: ParseWarning[] = [];\n let inFlight: Promise<TodoRecord[]> | undefined;\n let generation = 0;\n\n const logger = options.logger;\n\n const log: TodoLogger = (level, message, meta) => {\n if (!logger) {\n return;\n }\n\n try {\n const result = logger(level, message, meta);\n\n if (\n result &&\n typeof (result as PromiseLike<unknown>).then === \"function\"\n ) {\n void Promise.resolve(result).catch(() => {});\n }\n } catch {\n // Logging is best-effort and must never break reads or queries.\n }\n };\n\n const readFresh = async (): Promise<TodoRecord[]> => {\n const currentGeneration = ++generation;\n\n log(\"debug\", \"Reading todo file\");\n\n let contents: string;\n try {\n contents = await options.read();\n } catch (cause) {\n // Real errors (including fs errors with a code such as ENOENT)\n // propagate untouched so existing error checks keep working; anything\n // else is wrapped so every read failure has a typed shape.\n if (cause instanceof Error) {\n throw cause;\n }\n\n throw new TodoReadError(\n \"The read hook rejected with a non-Error value.\",\n cause,\n );\n }\n\n const result = parseDocumentResult(contents, {\n includeSource: options.includeSource,\n onWarning: (warning) => {\n log(\"warn\", warning.message, {\n ...warning.meta,\n code: warning.code,\n line: warning.line,\n });\n },\n });\n const records = result.records;\n log(\"debug\", \"Parsed todo file\", { records: records.length });\n\n if (currentGeneration === generation) {\n cache = records;\n lastWarnings = result.warnings;\n }\n\n return records;\n };\n\n const refresh = (): Promise<TodoRecord[]> => {\n const promise = readFresh();\n inFlight = promise;\n\n void promise\n .finally(() => {\n if (inFlight === promise) {\n inFlight = undefined;\n }\n })\n .catch(() => {});\n\n return promise;\n };\n\n const loadCached = (): Promise<TodoRecord[]> => {\n if (inFlight) {\n return inFlight;\n }\n\n if (cache) {\n return Promise.resolve(cache);\n }\n\n return refresh();\n };\n\n const all = async (): Promise<TodoRecord[]> =>\n cloneRecords(await refresh());\n\n const warnings = (): ParseWarning[] =>\n lastWarnings.map((warning) => ({\n ...warning,\n meta: { ...warning.meta },\n }));\n\n const query = createTodoQuery(loadCached, {\n filters: [],\n caseSensitive: options.caseSensitive ?? true,\n });\n\n return {\n all,\n warnings,\n pending: query.pending,\n completed: query.completed,\n project: query.project,\n context: query.context,\n notProject: query.notProject,\n notContext: query.notContext,\n priority: query.priority,\n search: query.search,\n meta: query.meta,\n hasMeta: query.hasMeta,\n createdAfter: query.createdAfter,\n createdBefore: query.createdBefore,\n completedAfter: query.completedAfter,\n completedBefore: query.completedBefore,\n sortBy: query.sortBy,\n count: query.count,\n first: query.first,\n projects: query.projects,\n contexts: query.contexts,\n summary: query.summary,\n countsByProject: query.countsByProject,\n countsByContext: query.countsByContext,\n };\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jibone/todotxt-core",
3
- "version": "0.5.0",
3
+ "version": "0.7.0",
4
4
  "description": "Parse and query todo.txt files with runtime-agnostic file hooks.",
5
5
  "license": "MIT",
6
6
  "author": "J Shamsul Bahri",