@sudobility/screenwriter_types 0.1.1

package/CLAUDE.md

@@ -0,0 +1,50 @@
+# screenwriter_types
+
+Shared TypeScript types and Zod v4 schemas for Fadewright (frontend and backend). Platform-free ESM: no DOM, no Node built-ins, no clock reads. Consumers import from the package root only (plus `/test` for fixtures).
+
+## Stack
+
+TypeScript, Zod v4, Vitest, Bun. Depends on `@sudobility/writing_core` for ids, `DOCUMENT_KINDS` and `TemplateCategory`; `@sudobility/types` (B17, resolved from npm like any ordinary dependency — a stable, general-purpose types package, not a sibling under co-development) for the generic consumables shapes `src/credits/` re-exports.
+
+## Structure
+
+- `src/api/` envelope (`successResponse`, `errorResponse`, `API_ERROR_CODES`, `ERROR_STATUS`, `Paginated`), `cursorQuerySchema`, `API_ROUTES`
+- `src/ids/` re-exports from writing_core
+- `src/tenancy/`, `projects/`, `me/`, `templates/`, `versions/`, `commands/` DTOs and request schemas. `tenancy/` also holds the role/permission matrix (`PERMISSION_MIN_ROLE`, `ROLE_PERMISSIONS`, `hasPermission`, `roleAtLeast`, `maxRole`, `minRole`, `requiredRoleFor`; spec 05 §5.2)
+- `src/sharing/` (B8) workspace/member/invitation/grant/share-link/lock DTOs and Zod request schemas (spec 05 §5.4, §6.2-6.4, §8.3)
+- `src/ai/` spec 06 AI: `AI_TASKS`, `AI_LIMITS`, model-output Zod schemas per ShapeShyft endpoint (`AI_ENDPOINT_OUTPUT_SCHEMAS`, all-required and closed so `z.toJSONSchema` gives the stored endpoint schema), `CoverageReport`, job and suggestion-set DTOs. (B17) `AI_CONSENT_VERSION`, consent/estimate/activity/report DTOs, `suggestionDecideSchema`
+- `src/credits/` (B17) a thin re-export of `@sudobility/types`' generic consumables shapes (the ledger itself is `@sudobility/consumables_service`'s, never redefined here) plus `CreditProduct` and the purchase-handoff request/response (spec 05 §6.20-6.21)
+- `src/reads/` (B10) `?source=` schemas (`sourceParamSchema`, `docSourceSchema`), entity/tag/note/beat/bin/revision/change/stats/shot read DTOs (`EntityUsage`...), locator types (`ResolveResult`) and search schemas/hits
+- `src/reports/` (B10) `REPORT_KINDS` (18), `REPORT_DEFS` (options and columns per kind, until writing_core owns them: spec 09 R25), `parseReportOptions`, `ReportResult`/`ReportTable`, `reportToCsv`
+- `src/packets/` (B10) `scenePacketSchema`, `characterPacketSchema`, `locationPacketSchema`, `shotPacketSchema` (spec 11 §7; what MCP consumes) and `packetQuerySchema`
+- `src/account/` (B13) `userPreferencesSchema` (closed at the top level, `USER_PREFERENCES_VERSION`, `baseUpdatedAt` PUT variant), dictionary, macro, writing session/stats/goal, `documentViewStateSchema` (`my-state`), account delete/export DTOs and limits
+- `src/lifecycle/` (B14) project folders (`FOLDER_MAX_DEPTH` 8), purge/duplicate/move/apply-template DTOs, trash and workspace-documents queries (`TRASH_RETENTION_DAYS` 30, `TrashItem`), Shared Bin (`ProjectBinItem`, 2 MiB cap), `WorkspaceDefaults` (+ `baseUpdatedAt` PUT), contacts, and the job input schemas (`project.duplicate`, `doc.applyTemplate`, `template.thumbnail`, `system.purge`). `templates/` also holds template create/version/update/import/export DTOs (`TEMPLATE_FILE_FORMATS`, `.fwtemplate` envelope constants); `projects/` has `PROJECT_KINDS`, `documentLabelsSchema` and `DocumentListQuery.order`
+- `src/io/` (B16) upload/import/export/watermark DTOs: `uploadStateRequestSchema`, `importCreateSchema` (`targetProjectId` xor `templateTarget`), `importOverSchema`, `importOptionsSchema`, `exportCreateSchema`, `exportCombinedSchema`, `batchWatermarkSchema`, `watermarkLookupSchema`, job input schemas (`import.*`, `doc.importOver`, `export.*`/`watermark.batch`), `JOB_IMPORT_FORMATS`/`JOB_EXPORT_FORMATS` (what writing_formats has), `EXPORT_CODE_PREFIX` `FWX-`; `templateImportByIdSchema` is in `templates/`
+- `src/sync/` spec 03 frame schemas, message codes, close codes; `permissions.ts` the commenter write matrix as data (`COMMENTER_WRITABLE_KEYS`, `isCommenterMark`, `markPermissionsFor`)
+- `src/public/` (B18, spec 05 §6.21, §6.24) `PublicConfig`, `NamesDbEntry`/`NamesDbResponse`, `DeepHealthResponse`, `WatermarkedDownloadInfo`, `purchaseHandoffRedeemSchema`, `telemetryRequestSchema`/`telemetryEventSchema`/`clientErrorReportSchema`
+- `src/admin/` (B18, spec 05 §6.23) `AdminUserLookup`, `adminJobListQuerySchema` (a hand-written `AdminJobListQuery` interface sits beside it — `z.input<>` of the `.extend()`-derived schema resolved `limit` to `{}` under this repo's tsconfig for reasons not fully tracked down; avoided rather than chased), `adminJobKindPatchSchema`, `AdminJobKind`, `adminJobRefundSchema`, `AdminUserPurgeResponse` (documents why the route is a bounded schedule-and-revoke, not a real data purge)
+- `src/test/` fixture factories (`makeWorkspace`, `makeProject`, `makeDocumentMeta`, `makeSnapshotSummary`)
+- `src/index.ts` the barrel
+
+## Commands
+
+```bash
+bun install
+bunx tsc --noEmit      # typecheck
+bunx vitest run        # smoke tests (never `bun test`)
+bun run lint
+```
+
+## Local-path rule (no publishing)
+
+`@sudobility/writing_core` resolves by path to the sibling repo: `tsconfig.json` `paths` and a `vitest.config.ts` alias both point at `../writing_core/src/index.ts`. Do not publish or bump versions. `bun run build` does not work in this mode (writing_core sits outside `rootDir`); downstream repos import `src` directly by path.
+
+## Notes
+
+- Envelope is `{success, data}` or `{success:false, error, code, details?}`, with no timestamp (no clock in this package).
+- `ping` and `pong` share message code 4.
+- Spec source: screenwriter_plans specs 05 (§1.1, §6, §10, §12) and 03 (§2).
+
+## Related
+
+`writing_core`, `screenwriter_api`, `screenwriter_client`, `screenwriter_lib`, `screenwriter_plans`

package/README.md

@@ -0,0 +1,34 @@
+# @sudobility/screenwriter_types
+
+Shared TypeScript types and Zod schemas for the Fadewright screenwriting app, used by both the frontend and the backend.
+
+## Contents
+
+- API envelope helpers, error codes, cursor pagination, and a route table
+- Workspace, project, document, template, version and snapshot types
+- Request schemas (projects, documents, snapshots, commands, `/me`)
+- Sync WebSocket frame schemas and close codes
+- Fixture factories under `@sudobility/screenwriter_types/test`
+
+## Usage
+
+```ts
+import { successResponse, errorResponse, documentCreateSchema } from '@sudobility/screenwriter_types';
+
+const body = documentCreateSchema.parse({ title: 'Draft', kind: 'script' });
+return successResponse(body);
+```
+
+## Development
+
+```bash
+bun install
+bunx tsc --noEmit
+bunx vitest run
+```
+
+This package currently resolves `@sudobility/writing_core` from a sibling checkout by path and is not published.
+
+## License
+
+BUSL-1.1

package/dist/account/index.d.ts

@@ -0,0 +1,440 @@
+import { z } from 'zod';
+/**
+ * Account and per-user data (slice B13; spec 05 §6.1, §6.1.1, §6.26, §8.1, §17).
+ * Everything here belongs to one user: preferences, spelling dictionary, macros, writing sessions, stats, goals, the
+ * per-document view state (`my-state`) and stars. All are user-only routes (an API key gets 403 `API_KEY_FORBIDDEN`),
+ * except the macro list, which a key may read.
+ */
+export declare const USER_PREFERENCES_VERSION = 1;
+/** Serialised size cap of `PUT /me/preferences` (`LIMIT_EXCEEDED`). */
+export declare const USER_PREFERENCES_MAX_BYTES: number;
+export declare const AUTOCORRECT_MAX_PAIRS = 5000;
+export declare const RECENT_SEARCHES_MAX = 20;
+export declare const DEVICE_CLASSES: readonly ["phone", "tablet", "desktop"];
+export type DeviceClass = (typeof DEVICE_CLASSES)[number];
+/**
+ * `UserPreferences`: one JSON document per user, closed at the top level (an unknown top-level key is `VALIDATION`),
+ * open inside each section. `version` is `USER_PREFERENCES_VERSION`; a higher version from a newer client is stored as is.
+ */
+export declare const userPreferencesSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    appearance: z.ZodOptional<z.ZodObject<{
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            system: "system";
+            dark: "dark";
+        }>>;
+        pageTheme: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            paper: "paper";
+            night: "night";
+            midnight: "midnight";
+            sepia: "sepia";
+        }>>;
+        custom: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        density: z.ZodOptional<z.ZodString>;
+        largeIcons: z.ZodOptional<z.ZodBoolean>;
+        reducedMotion: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    editor: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    deviceClasses: z.ZodOptional<z.ZodObject<{
+        phone: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        tablet: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        desktop: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    }, z.core.$strict>>;
+    keymap: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodOptional<z.ZodEnum<{
+            fadewright: "fadewright";
+            finalDraft: "finalDraft";
+            fadeIn: "fadeIn";
+        }>>;
+        overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+        byPlatform: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    }, z.core.$loose>>;
+    autocorrect: z.ZodOptional<z.ZodObject<{
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        pairs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    language: z.ZodOptional<z.ZodObject<{
+        scriptDefault: z.ZodOptional<z.ZodString>;
+        installedDictionaries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        ignoreLists: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        lookups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    tableRead: z.ZodOptional<z.ZodObject<{
+        narratorVoiceByLanguage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{}, z.core.$loose>>>;
+        rate: z.ZodOptional<z.ZodNumber>;
+        actors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+    toolbar: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    recentSearches: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    revisionColourSets: z.ZodOptional<z.ZodArray<z.ZodObject<{}, z.core.$loose>>>;
+    offline: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strict>;
+export type UserPreferences = z.output<typeof userPreferencesSchema>;
+export type UserPreferencesInput = z.input<typeof userPreferencesSchema>;
+export declare const USER_PREFERENCES_KEYS: readonly ["version", "appearance", "editor", "deviceClasses", "keymap", "autocorrect", "language", "tableRead", "toolbar", "recentSearches", "revisionColourSets", "offline"];
+/** `GET /me/preferences` (and `details.current` of a `STALE_WRITE`): the document plus its optimistic-concurrency token. */
+export type UserPreferencesResponse = UserPreferences & {
+    updatedAt: string;
+};
+/** `PUT /me/preferences`: a whole-document replace; `baseUpdatedAt` is the `updatedAt` of the last GET/PUT. */
+export declare const userPreferencesPutSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    appearance: z.ZodOptional<z.ZodObject<{
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            system: "system";
+            dark: "dark";
+        }>>;
+        pageTheme: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            paper: "paper";
+            night: "night";
+            midnight: "midnight";
+            sepia: "sepia";
+        }>>;
+        custom: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        density: z.ZodOptional<z.ZodString>;
+        largeIcons: z.ZodOptional<z.ZodBoolean>;
+        reducedMotion: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    editor: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    deviceClasses: z.ZodOptional<z.ZodObject<{
+        phone: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        tablet: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        desktop: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    }, z.core.$strict>>;
+    keymap: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodOptional<z.ZodEnum<{
+            fadewright: "fadewright";
+            finalDraft: "finalDraft";
+            fadeIn: "fadeIn";
+        }>>;
+        overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+        byPlatform: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    }, z.core.$loose>>;
+    autocorrect: z.ZodOptional<z.ZodObject<{
+        options: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        pairs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    language: z.ZodOptional<z.ZodObject<{
+        scriptDefault: z.ZodOptional<z.ZodString>;
+        installedDictionaries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        ignoreLists: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        lookups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    tableRead: z.ZodOptional<z.ZodObject<{
+        narratorVoiceByLanguage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{}, z.core.$loose>>>;
+        rate: z.ZodOptional<z.ZodNumber>;
+        actors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+    toolbar: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    recentSearches: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    revisionColourSets: z.ZodOptional<z.ZodArray<z.ZodObject<{}, z.core.$loose>>>;
+    offline: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    baseUpdatedAt: z.ZodString;
+}, z.core.$strict>;
+export type UserPreferencesPutRequest = z.input<typeof userPreferencesPutSchema>;
+export interface UserPreferencesPutResponse {
+    updatedAt: string;
+}
+export declare const DICTIONARY_MAX_WORDS = 50000;
+export declare const dictionaryUpdateSchema: z.ZodObject<{
+    add: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    remove: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type DictionaryUpdateRequest = z.infer<typeof dictionaryUpdateSchema>;
+export interface DictionaryResponse {
+    words: string[];
+}
+export interface DictionaryUpdateResponse {
+    count: number;
+}
+export declare const USER_MACRO_MAX = 500;
+export declare const MACRO_TRIGGER_KINDS: readonly ["shortcut", "alias"];
+/** Create: every option defaulted. */
+declare const macroOptionsSchema: z.ZodObject<{
+    smartReplace: z.ZodDefault<z.ZodBoolean>;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+    wordOnly: z.ZodDefault<z.ZodBoolean>;
+    matchCase: z.ZodDefault<z.ZodBoolean>;
+    activeInStyles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const userMacroSchema: z.ZodObject<{
+    name: z.ZodString;
+    trigger: z.ZodObject<{
+        kind: z.ZodEnum<{
+            shortcut: "shortcut";
+            alias: "alias";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    insertText: z.ZodString;
+    setElementStyle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nextElementStyle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    options: z.ZodPrefault<z.ZodObject<{
+        smartReplace: z.ZodDefault<z.ZodBoolean>;
+        confirm: z.ZodDefault<z.ZodBoolean>;
+        wordOnly: z.ZodDefault<z.ZodBoolean>;
+        matchCase: z.ZodDefault<z.ZodBoolean>;
+        activeInStyles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UserMacroCreateRequest = z.input<typeof userMacroSchema>;
+/** `PATCH /me/macros/:mid`: any subset; `options` and `trigger` merge into the stored ones. */
+export declare const userMacroPatchSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    trigger: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodOptional<z.ZodEnum<{
+            shortcut: "shortcut";
+            alias: "alias";
+        }>>;
+        value: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    insertText: z.ZodOptional<z.ZodString>;
+    setElementStyle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nextElementStyle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    options: z.ZodOptional<z.ZodObject<{
+        smartReplace: z.ZodOptional<z.ZodBoolean>;
+        confirm: z.ZodOptional<z.ZodBoolean>;
+        wordOnly: z.ZodOptional<z.ZodBoolean>;
+        matchCase: z.ZodOptional<z.ZodBoolean>;
+        activeInStyles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UserMacroPatchRequest = z.input<typeof userMacroPatchSchema>;
+export interface UserMacro {
+    id: string;
+    name: string;
+    trigger: {
+        kind: (typeof MACRO_TRIGGER_KINDS)[number];
+        value: string;
+    };
+    insertText: string;
+    setElementStyle: string | null;
+    nextElementStyle: string | null;
+    options: z.output<typeof macroOptionsSchema>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DeleteResponse {
+    deleted: true;
+}
+export declare const WRITING_GOAL_KINDS: readonly ["wordsPerDay", "pagesPerDay", "minutesPerDay", "wordsPerWeek", "documentTarget"];
+export type WritingGoalKind = (typeof WRITING_GOAL_KINDS)[number];
+export declare const WRITING_GOALS_MAX = 50;
+export declare const WRITING_STATS_GRANULARITIES: readonly ["day", "week", "month", "year"];
+export type WritingStatsGranularity = (typeof WRITING_STATS_GRANULARITIES)[number];
+/**
+ * `POST /me/writing-sessions`. `clientSessionId` is the row id (`wss_...`, made by the client) and makes the upload
+ * idempotent: a repeat is accepted and changes nothing, so a device may retry and may upload offline sessions later.
+ */
+export declare const writingSessionSchema: z.ZodObject<{
+    clientSessionId: z.ZodString;
+    documentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    startedAt: z.ZodISODateTime;
+    endedAt: z.ZodISODateTime;
+    activeSeconds: z.ZodNumber;
+    wordsAdded: z.ZodNumber;
+    wordsRemoved: z.ZodNumber;
+    netPagesEighths: z.ZodNumber;
+    sprint: z.ZodOptional<z.ZodObject<{
+        targetWords: z.ZodOptional<z.ZodNumber>;
+        targetMinutes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WritingSessionRequest = z.input<typeof writingSessionSchema>;
+export interface WritingSessionResponse {
+    accepted: true;
+}
+/** `GET /me/writing-stats`: dates are calendar days in the user's time zone (`users.time_zone`). Defaults: the last 30 days by day. */
+export declare const writingStatsQuerySchema: z.ZodObject<{
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    granularity: z.ZodDefault<z.ZodEnum<{
+        day: "day";
+        week: "week";
+        month: "month";
+        year: "year";
+    }>>;
+    documentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type WritingStatsQuery = z.input<typeof writingStatsQuerySchema>;
+export interface WritingStatsBucket {
+    /** `YYYY-MM-DD`: the first day of the day/week (Monday)/month/year, in the user's time zone. */
+    start: string;
+    wordsAdded: number;
+    wordsRemoved: number;
+    /** `netPagesEighths / 8`. */
+    netPages: number;
+    activeSeconds: number;
+}
+/** A day counts when the user added words on it (over all documents, in their time zone). Today does not break a streak until it ends. */
+export interface StreakSummary {
+    current: number;
+    longest: number;
+    /** `YYYY-MM-DD` of the latest day with words, or null. */
+    lastActiveDate: string | null;
+    activeToday: boolean;
+}
+export interface WritingStats {
+    buckets: WritingStatsBucket[];
+    streak: StreakSummary;
+}
+export declare const writingGoalInputSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        wordsPerDay: "wordsPerDay";
+        pagesPerDay: "pagesPerDay";
+        minutesPerDay: "minutesPerDay";
+        wordsPerWeek: "wordsPerWeek";
+        documentTarget: "documentTarget";
+    }>;
+    documentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    target: z.ZodNumber;
+    daysOfWeek: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    idleTimeoutSec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** `PUT /me/writing-goals`: the whole list. A goal missing from it is deleted; one without `id` is created. `daysOfWeek`: 0 = Sunday. */
+/** No `.max` here on purpose: more than `WRITING_GOALS_MAX` is 409 `LIMIT_EXCEEDED` from the server, not `VALIDATION`. */
+export declare const writingGoalsPutSchema: z.ZodObject<{
+    goals: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            wordsPerDay: "wordsPerDay";
+            pagesPerDay: "pagesPerDay";
+            minutesPerDay: "minutesPerDay";
+            wordsPerWeek: "wordsPerWeek";
+            documentTarget: "documentTarget";
+        }>;
+        documentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        target: z.ZodNumber;
+        daysOfWeek: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        idleTimeoutSec: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WritingGoalsPutRequest = z.input<typeof writingGoalsPutSchema>;
+export interface WritingGoal {
+    id: string;
+    kind: WritingGoalKind;
+    documentId: string | null;
+    target: number;
+    daysOfWeek: number[] | null;
+    idleTimeoutSec: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare const ACCOUNT_DELETE_CONFIRM = "DELETE";
+export declare const accountDeleteSchema: z.ZodObject<{
+    confirm: z.ZodLiteral<"DELETE">;
+}, z.core.$strip>;
+export type AccountDeleteRequest = z.infer<typeof accountDeleteSchema>;
+export interface AccountDeleteResponse {
+    deletionScheduledFor: string;
+}
+export interface AccountRestoreResponse {
+    restored: true;
+}
+/** `account.export` job input: none. The output is `fadewright-export.zip`. */
+export declare const accountExportInputSchema: z.ZodDefault<z.ZodObject<{}, z.core.$strip>>;
+export declare const ACCOUNT_EXPORT_FILENAME = "fadewright-export.zip";
+export declare const DOCUMENT_VIEW_STATE_MAX_BYTES: number;
+/**
+ * Cross-device view state of one document for one user: Navigator tabs and columns, split layout, view mode and zoom per
+ * device class. Caret, selection, undo history and the Beat Board viewport stay device-local. Every key optional: the
+ * client merges per top-level key.
+ */
+export declare const documentViewStateSchema: z.ZodObject<{
+    navigator: z.ZodOptional<z.ZodObject<{
+        tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{}, z.core.$loose>>>;
+        activeTab: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+    layout: z.ZodOptional<z.ZodObject<{
+        split: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>;
+        panes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    views: z.ZodOptional<z.ZodObject<{
+        phone: z.ZodOptional<z.ZodObject<{
+            view: z.ZodOptional<z.ZodString>;
+            zoom: z.ZodOptional<z.ZodNumber>;
+            invisibles: z.ZodOptional<z.ZodBoolean>;
+            ruler: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        tablet: z.ZodOptional<z.ZodObject<{
+            view: z.ZodOptional<z.ZodString>;
+            zoom: z.ZodOptional<z.ZodNumber>;
+            invisibles: z.ZodOptional<z.ZodBoolean>;
+            ruler: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        desktop: z.ZodOptional<z.ZodObject<{
+            view: z.ZodOptional<z.ZodString>;
+            zoom: z.ZodOptional<z.ZodNumber>;
+            invisibles: z.ZodOptional<z.ZodBoolean>;
+            ruler: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DocumentViewState = z.output<typeof documentViewStateSchema>;
+/** `GET /documents/:did/my-state`: `{}` until first saved, then the state plus `updatedAt`. */
+export type DocumentViewStateResponse = DocumentViewState & {
+    updatedAt?: string;
+};
+/** `PUT`: the whole state; `baseUpdatedAt` is the `updatedAt` last read (null or absent when the GET returned `{}`). */
+export declare const documentViewStatePutSchema: z.ZodObject<{
+    navigator: z.ZodOptional<z.ZodObject<{
+        tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{}, z.core.$loose>>>;
+        activeTab: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+    layout: z.ZodOptional<z.ZodObject<{
+        split: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>;
+        panes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    views: z.ZodOptional<z.ZodObject<{
+        phone: z.ZodOptional<z.ZodObject<{
+            view: z.ZodOptional<z.ZodString>;
+            zoom: z.ZodOptional<z.ZodNumber>;
+            invisibles: z.ZodOptional<z.ZodBoolean>;
+            ruler: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        tablet: z.ZodOptional<z.ZodObject<{
+            view: z.ZodOptional<z.ZodString>;
+            zoom: z.ZodOptional<z.ZodNumber>;
+            invisibles: z.ZodOptional<z.ZodBoolean>;
+            ruler: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        desktop: z.ZodOptional<z.ZodObject<{
+            view: z.ZodOptional<z.ZodString>;
+            zoom: z.ZodOptional<z.ZodNumber>;
+            invisibles: z.ZodOptional<z.ZodBoolean>;
+            ruler: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$strict>>;
+    baseUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type DocumentViewStatePutRequest = z.input<typeof documentViewStatePutSchema>;
+export interface DocumentViewStatePutResponse {
+    updatedAt: string;
+}
+export interface StarResponse {
+    starred: boolean;
+}
+export {};