things-api 0.7.0 → 0.9.0

package/dist/cli/commands/reads.d.ts

@@ -1,56 +1,15 @@
 /**
- * Read-only list commands. Each renders a compact human table (UUIDs always
- * shown — agents and humans both need stable references) or a --json envelope.
+ * Read-only list commands: option/description wiring per view, delegating to
+ * the read driver (../read-driver.ts) for envelope/output and to the pure
+ * renderers (../render.ts) for human lines. Each command renders a compact
+ * human table (UUIDs always shown — agents and humans both need stable
+ * references) or a --json envelope.
  */
-import type { Command } from "commander";
-import { type ThingsClient } from "../../client.ts";
-import { type ListItem, type SidebarSection } from "../../read/views.ts";
-interface GlobalReadOpts {
-    json?: boolean;
-    db?: string;
-}
-export declare function withClient(opts: GlobalReadOpts, kind: string, fn: (client: ThingsClient) => unknown, render: (data: never) => string[]): void;
-export interface FormatOpts {
-    /**
-     * Render a grouped project TITLE row: bold+underlined title, no type
-     * marker — the styling carries the type (the GUI's project-header look).
-     */
-    projectTitle?: boolean;
-    /** Container uuids already implied by surrounding output — their context suffix is dropped. */
-    suppressProject?: string | null;
-    suppressArea?: string | null;
-}
+import { type Command } from "commander";
 /**
- * One item line: `<uuid-prefix>  <marker> [meta …] <title> #tags (container)`.
- * Human output shows a SHORTENED uuid prefix (every command accepts unique
- * prefixes >= 6 chars); `uuidWidth` is the display length from
- * uuidDisplayWidth — never below 8 so a copied prefix stays unique across
- * the whole database, not just the rendered list. Tags follow the title
- * (`#`-prefixed, space-separated), mirroring the GUI. Exactly one space
- * separates every following token; meta tokens colorize on a TTY only
- * (../style.ts) — piped output stays plain. `--json` always carries full
- * uuids.
+ * Foreground the Things app on a resource via its share URI. A GUI action
+ * on this Mac — NOT headless; the shared implementation behind every
+ * `open` command. Returns the URI it launched.
  */
-export declare function formatItem(item: ListItem, uuidWidth?: number, opts?: FormatOpts): string;
-/**
- * Display width for a list's uuid column: the shortest prefix that is
- * unique WITHIN the list, floored at UUID_DISPLAY_MIN (list-local
- * uniqueness at 2–3 chars would still collide database-wide).
- */
-export declare function uuidDisplayWidth(items: Array<{
-    uuid: string;
-}>): number;
-/**
- * Sidebar-grouped views (anytime/someday), rendered the way the GUI reads:
- * the area-less block headerless first, then one `── <area> ──` header per
- * area; inside a section, loose to-dos first, then each project GROUP — a
- * blank line, the project's bold+underlined title row, then its members.
- * Container names implied by the grouping are not repeated on member rows
- * (an area header covers its rows; a project title row covers the to-dos
- * beneath it — a clustered child whose project row is absent, e.g. under a
- * tag filter, keeps its `(project)` suffix). `star` prefixes each item line
- * with the Today-membership star.
- */
-export declare function renderSections(sections: SidebarSection[], star?: boolean): string[];
+export declare function openInThings(uuid: string): string;
 export declare function registerReadCommands(program: Command): void;
-export {};