dsh-openwrite 0.2.8

package/packages/studio-panel/lib/types/client/dto.d.ts

@@ -0,0 +1,517 @@
+/** Runtime-checked DTO boundary for the OpenWrite Studio API. */
+export type JsonRecord = Record<string, unknown>;
+export declare function asRecord(value: unknown): JsonRecord;
+export declare function unwrapData(value: unknown): JsonRecord;
+export declare function asText(value: unknown): string;
+export declare function asFiniteNumber(value: unknown): number | null;
+export declare function asInteger(value: unknown, fallback?: number): number;
+/** Server-recorded connection-test outcome on a profile (null = untested). */
+export type ModelTestRecordDto = {
+    status: 'ok' | 'failed';
+    tested_at: string;
+    latency_ms: number | null;
+    provider: string;
+    resolved_model: string;
+    error_code: string | null;
+    failed_stage: string | null;
+};
+/** Narrow one last_test record; null when absent or malformed. */
+export declare function parseTestRecord(value: unknown): ModelTestRecordDto | null;
+export type ModelProfileDto = {
+    id: string;
+    label: string;
+    provider: string;
+    model: string;
+    base_url: string;
+    api_format: string;
+    context_tokens: number;
+    max_output_tokens: number;
+    temperature: number;
+    timeout_seconds: number;
+    configured: boolean;
+    schema_version: string;
+    capabilities: {
+        chat: boolean;
+    };
+    used_by_routes: string[];
+    last_test: ModelTestRecordDto | null;
+};
+export declare function parseModelProfiles(value: unknown): ModelProfileDto[];
+export declare function parseRouteMap(value: unknown): Record<string, string>;
+/** Success payload of POST /model/test and /model/embedding/test (enveloped). */
+export type ConnectionTestResultDto = {
+    status: string;
+    provider: string;
+    model: string;
+    latency_ms: number | null;
+    tested_at: string;
+    reply: string;
+};
+export declare function parseConnectionTestResult(value: unknown): ConnectionTestResultDto;
+/** Read-only payload of POST /model/profiles/delete-preview (enveloped). */
+export type DeletePreviewDto = {
+    profile_id: string;
+    used_by_routes: string[];
+    routes_that_would_fail: string[];
+    fallback_candidates: {
+        id: string;
+        label: string;
+        configured: boolean;
+    }[];
+    resulting_routes: Record<string, string> | null;
+    deletable: boolean;
+    blocking_reasons: string[];
+};
+export declare function parseDeletePreview(value: unknown): DeletePreviewDto;
+/** Response data of POST /model/routes: the swapped map plus the change impact. */
+export type RouteImpactDto = {
+    routes: Record<string, string>;
+    changed_routes: {
+        route: string;
+        from: string;
+        to: string;
+    }[];
+    profiles_affected: string[];
+};
+export declare function parseRouteImpact(value: unknown): RouteImpactDto;
+/** Real progress units on a task (benchmark tasks report candidate/evaluation units). */
+export type TaskProgressDto = {
+    completed_units: number;
+    total_units: number;
+    ratio: number | null;
+    unit_kind: string;
+};
+export declare function parseTaskProgress(value: unknown): TaskProgressDto | null;
+/** Pointer from a finished task to its artifact (e.g. a benchmark run). */
+export type ResultRefDto = {
+    type: string;
+    id: string;
+};
+export declare function parseResultRef(value: unknown): ResultRefDto | null;
+export type ExportFormatDto = 'md' | 'txt' | 'epub';
+export type ExportPurposeDto = 'backup' | 'delivery';
+export type ExportChapterDto = {
+    chapter_id: string;
+    number: number;
+    path: string;
+    title: string;
+    writing_units: number;
+    empty: boolean;
+    revision: string;
+};
+export type ExportIssueDto = {
+    code: string;
+    message: string;
+    details: JsonRecord;
+};
+export type ExportPreflightDto = {
+    schema_version: string;
+    novel_id: string;
+    format: ExportFormatDto;
+    purpose: ExportPurposeDto;
+    can_export: boolean;
+    actual_order: string[];
+    chapters: ExportChapterDto[];
+    structure: {
+        duplicates: Record<string, string[]>;
+        missing: string[];
+        empty: string[];
+        unreadable: string[];
+    };
+    writing_units: {
+        total: number;
+        book_target: number;
+        chapter_target: number;
+        completion_ratio: number | null;
+    };
+    metadata: {
+        title: string;
+        author: string;
+        language: string;
+    };
+    reviews: {
+        missing: string[];
+        current: string[];
+        stale: string[];
+        approved: string[];
+        not_approved: string[];
+    };
+    manuscript_acceptance: {
+        status: string;
+        blocking: boolean;
+        blocking_chapters: string[];
+        needs_review: string[];
+    };
+    blockers: ExportIssueDto[];
+    warnings: ExportIssueDto[];
+    preflight_revision: string;
+};
+/** Runtime-check the stable `openwrite.export-preflight.v1` success envelope. */
+export declare function parseExportPreflight(value: unknown): ExportPreflightDto;
+export declare const IMPORT_STAGE_NAMES: readonly ["snapshot", "split", "structure_confirmed", "published", "acceptance", "reconcile", "synthesis", "complete"];
+export type ImportStageNameDto = typeof IMPORT_STAGE_NAMES[number];
+export type ImportStageDto = {
+    status: string;
+    attempts: number;
+    input_sha256: string;
+    output_sha256: string;
+    started_at: string;
+    completed_at: string;
+    error_code: string;
+};
+export type ManuscriptImportOperationDto = {
+    schema_version: string;
+    import_id: string;
+    novel_id: string;
+    status: string;
+    arc_id: string;
+    source: {
+        filename: string;
+        suffix: string;
+        bytes: number;
+        sha256: string;
+    };
+    preview_revision: string;
+    confirmed_preview_revision: string;
+    chapter_count: number;
+    writing_units: number;
+    progress: {
+        current_stage: string;
+        completed_stages: number;
+        total_stages: number;
+        published_chapters: number;
+        total_chapters: number;
+    };
+    stages: Record<ImportStageNameDto, ImportStageDto>;
+    publication: {
+        sha256: string;
+        swap_status: string;
+        committed: boolean;
+    };
+    acceptance: {
+        operation_id: string;
+        status: string;
+    };
+    synthesis_sha256: string;
+    failure: {
+        code: string;
+        stage: string;
+        recoverable: boolean;
+    } | null;
+    created_at: string;
+    updated_at: string;
+    completed_at: string;
+    discarded_at: string;
+};
+export type ManuscriptImportChapterDto = {
+    order: number;
+    chapter_id: string;
+    title: string;
+    content: string;
+    writing_units: number;
+    sha256: string;
+};
+export type ManuscriptImportPreviewDto = {
+    schema_version: string;
+    import_id: string;
+    arc_id: string;
+    source_sha256: string;
+    revision: string;
+    chapter_count: number;
+    writing_units: number;
+    chapters: ManuscriptImportChapterDto[];
+    updated_at: string;
+};
+export declare function parseManuscriptImportList(value: unknown): {
+    schema_version: string;
+    novel_id: string;
+    operations: ManuscriptImportOperationDto[];
+    counts: Record<string, number>;
+};
+export declare function parseManuscriptImportDetail(value: unknown): {
+    operation: ManuscriptImportOperationDto;
+    preview: ManuscriptImportPreviewDto | null;
+};
+export type ArchiveFileDto = {
+    path: string;
+    archive_path: string;
+    category: string;
+    sha256: string;
+    size: number;
+};
+export type ArchiveNoticeDto = {
+    path: string;
+    location: string;
+    kind: string;
+    source: string;
+    target: string;
+    source_path: string;
+    target_path: string;
+    source_paths: string[];
+    format: string;
+    value: string;
+    before: string;
+    after: string;
+    message: string;
+    reason: string;
+    state: string;
+    sha256_before: string;
+    sha256_after: string;
+    reference_count: number;
+    replacement_count: number;
+};
+export type ProjectArchivePlanDto = {
+    schema_version: string;
+    novel_id: string;
+    archive_id: string;
+    preflight_revision: string;
+    includes: {
+        roots: string[];
+        file_count: number;
+        total_size: number;
+        category_counts: Record<string, number>;
+        directories: string[];
+        files: ArchiveFileDto[];
+    };
+    excludes: {
+        rules: string[];
+        entries: ArchiveNoticeDto[];
+    };
+    missing: {
+        required: string[];
+        optional: ArchiveNoticeDto[];
+    };
+    reference_inventory: {
+        known: ArchiveNoticeDto[];
+        preserved: ArchiveNoticeDto[];
+        warnings: ArchiveNoticeDto[];
+    };
+    policies: {
+        tasks: string;
+        target: string;
+        reference_default: string;
+        reference_supported: string[];
+    };
+};
+export declare function parseProjectArchivePreflight(value: unknown): ProjectArchivePlanDto;
+export type ProjectArchiveSummaryDto = {
+    archive_id: string;
+    archive_sha256: string;
+    created_at: string;
+    file_count: number;
+    total_size: number;
+    missing_required: string[];
+    missing_optional: ArchiveNoticeDto[];
+};
+export declare function parseProjectArchiveList(value: unknown): {
+    schema_version: string;
+    novel_id: string;
+    archives: ProjectArchiveSummaryDto[];
+};
+export declare function parseProjectArchiveDetail(value: unknown): {
+    archive_sha256: string;
+    file_count: number;
+    total_size: number;
+    plan: ProjectArchivePlanDto;
+};
+export type ProjectRestorePreviewDto = {
+    archive_id: string;
+    archive_sha256: string;
+    source_novel_id: string;
+    target_novel_id: string;
+    target_root: string;
+    reference_policy: 'preserve_relative' | 'rewrite_novel_id';
+    can_restore: boolean;
+    conflicts: string[];
+    file_count: number;
+    total_size: number;
+    missing: {
+        required: string[];
+        optional: ArchiveNoticeDto[];
+    };
+    task_file_count: number;
+    task_archive_path: string;
+    auto_resume_tasks: boolean;
+    path_rewrites: ArchiveNoticeDto[];
+    rewritten_files: ArchiveNoticeDto[];
+    rewritten_references: ArchiveNoticeDto[];
+    preserved_references: ArchiveNoticeDto[];
+    reference_warnings: ArchiveNoticeDto[];
+    reference_conflicts: ArchiveNoticeDto[];
+};
+export declare function parseProjectRestorePreview(value: unknown): ProjectRestorePreviewDto;
+export type ChapterWorkEventDto = {
+    kind: string;
+    id: string;
+    status: string;
+    document_id: string;
+    path: string;
+    chapter_id: string;
+    revision: string;
+    updated_at: string;
+    writing_units_delta: number | null;
+    reason: string;
+};
+export type ReadingOrderDocumentDto = {
+    document_id: string;
+    occurrence_id: string;
+    chapter_id: string;
+    title: string;
+    path: string;
+    status: string;
+    volume_id: string;
+    writing_units: number;
+    revision: string;
+    updated_at: string;
+    reading_index: number;
+    previous_occurrence_id: string;
+    next_occurrence_id: string;
+    content: string;
+};
+export type ReadingOrderDto = {
+    schema_version: string;
+    novel_id: string;
+    revision: string;
+    mode: string;
+    mutation_allowed: boolean;
+    actual_order: string[];
+    volumes: {
+        volume_id: string;
+        title: string;
+        order: number;
+        occurrence_ids: string[];
+    }[];
+    documents: ReadingOrderDocumentDto[];
+    issues: unknown[];
+};
+export type ReadingPacketDto = {
+    schema_version: string;
+    novel_id: string;
+    revision: string;
+    anchor_document_id: string;
+    anchor_occurrence_id: string;
+    start_index: number;
+    end_index: number;
+    has_previous: boolean;
+    has_next: boolean;
+    complete: boolean;
+    documents: ReadingOrderDocumentDto[];
+    issues: unknown[];
+};
+/** Canonical reading order. Every occurrence is retained, including repeated documents. */
+export declare function parseReadingOrder(value: unknown): ReadingOrderDto;
+/** Bounded continuous-reading packet with immutable occurrence identities. */
+export declare function parseReadingPacket(value: unknown): ReadingPacketDto;
+export type DocumentChangePlanDto = {
+    applied: boolean;
+    changed: boolean;
+    status: string;
+    path: string;
+    revision: string;
+    diff: string;
+    preview_token: string;
+    undo_preview_token: string;
+    mutation_summary: {
+        execution_status: string;
+        source_revision: string;
+        result_revision: string;
+    };
+};
+/** Server-owned immutable document change preview/apply projection. */
+export declare function parseDocumentChangePlan(value: unknown): DocumentChangePlanDto;
+export type ChapterForeshadowItemDto = {
+    id: string;
+    content: string;
+    status: string;
+    weight: number;
+    layer: string;
+    planned: boolean;
+    plant_chapter_id: string;
+    reveal_chapter_id: string;
+    earliest_reveal: string;
+    source_revision: string;
+    tags: string[];
+};
+export type ChapterForeshadowBucket = 'due' | 'overdue' | 'to_plant';
+export type ChapterForeshadowingDto = {
+    due: ChapterForeshadowItemDto[];
+    overdue: ChapterForeshadowItemDto[];
+    to_plant: ChapterForeshadowItemDto[];
+    source_revision: string;
+    counts: Record<ChapterForeshadowBucket, number>;
+};
+export type ChapterWorkBriefDto = {
+    schema_version: string;
+    novel_id: string;
+    chapter_id: string;
+    document_id: string;
+    manuscript: {
+        path: string;
+        title: string;
+        save_status: string;
+        current_revision: string;
+        writing_units: number;
+        modified_at: string;
+    };
+    review: {
+        exists: boolean;
+        review_revision: string;
+        freshness_status: string;
+        stale: boolean;
+        stale_reason: string;
+        source_revision: string;
+        current_source_revision: string;
+        reviewed_at: string;
+        issue_count: number;
+        latest_closure: null | {
+            closure_id: string;
+            proposal_id: string;
+            source_review_revision: string;
+            rereview_review_revision: string;
+            applied_revision: string;
+            rereview_source_revision: string;
+            closed_at: string;
+            issue_outcomes: {
+                issue_id: string;
+                outcome: 'resolved' | 'retained';
+            }[];
+            regressions: {
+                issue_id: string;
+                outcome: 'regressed';
+                issue: unknown;
+            }[];
+        };
+    };
+    target: {
+        writing_units: number;
+        source: string;
+        actual_units: number;
+        remaining_units: number;
+        progress: number;
+    };
+    recent_edits: ChapterWorkEventDto[];
+    foreshadowing: ChapterForeshadowingDto;
+};
+/** Map OpenWrite work-brief categories onto author actions; keep no second store. */
+export declare function parseChapterForeshadowing(value: unknown): ChapterForeshadowingDto;
+export type ChapterSprintStats = {
+    targetUnits: number;
+    actualUnits: number;
+    remainingUnits: number;
+    progress: number;
+    added: number;
+    deleted: number;
+    net: number;
+    knownDeltaEvents: number;
+    unknownDeltaEvents: number;
+    aiNet: number | null;
+    humanNet: number | null;
+};
+/** Derive sprint UX from the work-brief target (source of truth) and known edit deltas. */
+export declare function chapterSprintStats(brief: ChapterWorkBriefDto): ChapterSprintStats;
+export declare function chapterForeshadowActions(brief: ChapterWorkBriefDto): {
+    bucket: ChapterForeshadowBucket;
+    item: ChapterForeshadowItemDto;
+}[];
+/** Narrow the chapter work projection used by editor CAS and activity UI. */
+export declare function parseChapterWorkBrief(value: unknown): ChapterWorkBriefDto;

package/packages/studio-panel/lib/types/client/index.d.ts

@@ -0,0 +1,4 @@
+/** Browser half: three native writing workbenches plus dsh-native chrome/tool views. */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/packages/studio-panel/lib/types/client/locales.d.ts

@@ -0,0 +1,15 @@
+/** `studio-panel` namespace dictionaries (view tab labels + panel states). */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "studio-panel";
+/** The studio-panel dictionary key set (the source of truth for both locales). */
+export type StudioPanelKey = 'view.overview' | 'view.writing' | 'view.studio' | 'view.reviewWs' | 'view.outline' | 'view.assets' | 'view.tasks' | 'view.benchmark' | 'view.models' | 'view.graph' | 'view.research' | 'view.search' | 'view.creation' | 'view.library' | 'view.operations' | 'creation.chapters' | 'creation.searchChapters' | 'creation.clearSearch' | 'creation.chaptersEmpty' | 'creation.previousChapter' | 'creation.nextChapter' | 'creation.jumpChapter' | 'creation.chapterDuplicate' | 'creation.order.loading' | 'creation.order.unavailable' | 'creation.order.refresh' | 'creation.order.invalid' | 'creation.order.missingCount' | 'creation.order.move' | 'creation.order.volume' | 'creation.order.position' | 'creation.order.positionHelp' | 'creation.order.applyMove' | 'creation.order.blocked' | 'creation.order.moveComplete' | 'creation.order.conflict' | 'creation.mode.edit' | 'creation.mode.reader' | 'creation.writing.bookProgress' | 'creation.writing.chapterTarget' | 'creation.writing.chapterProgress' | 'creation.reader.title' | 'creation.reader.readOnly' | 'creation.reader.loading' | 'creation.reader.refresh' | 'creation.reader.openEditor' | 'creation.reader.path' | 'creation.reader.documentId' | 'creation.reader.revision' | 'creation.reader.revisionUnavailable' | 'creation.showChapters' | 'creation.hideChapters' | 'creation.inspector' | 'creation.showInspector' | 'creation.hideInspector' | 'creation.editorLoading' | 'creation.documentLoading' | 'creation.inspectorLoading' | 'creation.inspectorLoadingSlow' | 'creation.empty' | 'creation.acceptance.title' | 'creation.acceptance.loading' | 'creation.acceptance.current' | 'creation.acceptance.pending' | 'creation.acceptance.drift' | 'creation.acceptance.baselinePending' | 'creation.acceptance.needsReview' | 'creation.acceptance.failed' | 'creation.acceptance.unknown' | 'creation.acceptance.unavailable' | 'creation.acceptance.currentRevision' | 'creation.acceptance.acceptedRevision' | 'creation.acceptance.operation' | 'creation.acceptance.stale' | 'creation.acceptance.refresh' | 'creation.acceptance.baseline' | 'creation.acceptance.external' | 'creation.acceptance.resume' | 'creation.acceptance.acknowledge' | 'creation.acceptance.confirmBaseline' | 'creation.acceptance.confirmExternal' | 'creation.acceptance.confirmAcknowledge' | 'creation.context' | 'creation.review' | 'creation.revisions' | 'creation.activity' | 'creation.activity.loading' | 'creation.activity.unavailable' | 'creation.activity.invalid' | 'creation.activity.target' | 'creation.activity.remaining' | 'creation.activity.sprint' | 'creation.activity.sprintAdded' | 'creation.activity.sprintDeleted' | 'creation.activity.sprintNet' | 'creation.activity.sprintRevision' | 'creation.activity.sprintSaved' | 'creation.activity.identity' | 'creation.activity.recent' | 'creation.activity.empty' | 'creation.foreshadow.title' | 'creation.foreshadow.empty' | 'creation.foreshadow.due' | 'creation.foreshadow.overdue' | 'creation.foreshadow.toPlant' | 'creation.foreshadow.open' | 'creation.foreshadow.close' | 'creation.foreshadow.plant' | 'creation.foreshadow.reveal' | 'creation.foreshadow.status' | 'creation.foreshadow.weight' | 'creation.foreshadow.layer' | 'creation.foreshadow.source' | 'creation.contextEmpty' | 'creation.context.packet' | 'creation.context.current' | 'creation.context.stale' | 'creation.context.previousStale' | 'creation.context.requestBudget' | 'creation.context.sessionBudget' | 'creation.context.outputReserve' | 'creation.context.actualUsage' | 'creation.context.reported' | 'creation.context.unavailable' | 'creation.context.sessionSeparate' | 'creation.context.retrieval' | 'creation.context.sources' | 'creation.context.protected' | 'creation.context.noSnippet' | 'creation.context.reason' | 'creation.context.missing' | 'creation.context.excluded' | 'creation.context.fullText' | 'creation.reviewEmpty' | 'creation.review.stale' | 'creation.review.casUnavailable' | 'creation.review.refreshRequired' | 'creation.review.closure' | 'creation.review.closureProposal' | 'creation.review.closureRevision' | 'creation.review.outcome.resolved' | 'creation.review.outcome.retained' | 'creation.review.outcome.regressed' | 'creation.review.selectionSummary' | 'creation.review.instruction' | 'creation.review.createRevision' | 'creation.review.rereview' | 'creation.review.revisionStarted' | 'creation.review.rereviewStarted' | 'creation.revisionsEmpty' | 'creation.history.title' | 'creation.history.snapshot' | 'creation.history.snapshotName' | 'creation.history.snapshotCreated' | 'creation.history.empty' | 'creation.history.units' | 'creation.history.loading' | 'creation.history.compare' | 'creation.history.restorePreview' | 'creation.history.closePreview' | 'creation.history.noChanges' | 'creation.history.restore' | 'creation.history.restoreConfirm' | 'creation.history.restored' | 'creation.history.previewFailed' | 'creation.history.reason.autosave' | 'creation.history.reason.manual' | 'creation.history.reason.aiRevision' | 'creation.history.reason.fullRewrite' | 'creation.history.reason.restore' | 'creation.proposals.title' | 'creation.proposals.noRationale' | 'creation.proposals.range' | 'creation.proposals.evidence' | 'creation.proposals.reviewRevision' | 'creation.proposals.sourceRevision' | 'creation.proposals.noHunks' | 'creation.proposals.originalCandidate' | 'creation.proposals.reject' | 'creation.proposals.regenerate' | 'creation.proposals.applySelected' | 'creation.proposals.appliedNeedsReview' | 'creation.proposals.sourceConflict' | 'creation.selection.title' | 'creation.selection.expand' | 'creation.selection.compress' | 'creation.selection.naturalize' | 'creation.selection.reviewFix' | 'creation.selection.working' | 'creation.selection.staged' | 'creation.selection.empty' | 'creation.selection.saveRequired' | 'creation.selection.reviewRequired' | 'creation.selection.noIssues' | 'creation.selection.annotate' | 'creation.notes.title' | 'creation.notes.note' | 'creation.notes.color' | 'creation.notes.submit' | 'creation.notes.cancel' | 'creation.notes.working' | 'creation.notes.saved' | 'creation.notes.empty' | 'creation.notes.rangeLost' | 'creation.notes.saveRequired' | 'creation.notes.locate' | 'creation.notes.resolve' | 'creation.notes.resolved' | 'creation.notes.attached' | 'creation.notes.relocated' | 'creation.notes.detached' | 'creation.notes.quote' | 'creation.notes.color.amber' | 'creation.notes.color.rose' | 'creation.notes.color.sky' | 'creation.notes.color.lime' | 'creation.notes.color.violet' | 'creation.marker.insert' | 'creation.marker.title' | 'creation.marker.purpose' | 'creation.marker.state' | 'creation.marker.relation' | 'creation.marker.field' | 'creation.marker.oldState' | 'creation.marker.newState' | 'creation.marker.source' | 'creation.marker.target' | 'creation.marker.description' | 'creation.marker.pickCharacter' | 'creation.marker.insertNow' | 'creation.marker.cancel' | 'creation.marker.empty' | 'creation.marker.newline' | 'creation.marker.reserved' | 'creation.marker.needId' | 'creation.mentions.title' | 'creation.mentions.mention' | 'creation.mentions.card' | 'creation.mentions.aliases' | 'creation.mentions.close' | 'creation.mentions.ambiguous' | 'creation.mentions.choose' | 'creation.mentions.conflict' | 'creation.mentions.noSummary' | 'creation.issues' | 'creation.changedElsewhere' | 'creation.conflict' | 'creation.reload' | 'creation.overwrite' | 'creation.discardConfirm' | 'creation.overwriteConfirm' | 'creation.closePanel' | 'creation.draft.available' | 'creation.draft.conflict' | 'creation.draft.updated' | 'creation.draft.preview' | 'creation.draft.restore' | 'creation.draft.dismiss' | 'creation.draft.unavailable' | 'creation.status.idle' | 'creation.status.loading' | 'creation.status.saved' | 'creation.status.dirty' | 'creation.status.saving' | 'creation.status.conflict' | 'creation.status.offline' | 'operations.transfer' | 'operations.transferHint' | 'operations.project' | 'operations.create.new' | 'operations.create.id' | 'operations.create.title' | 'operations.create.submit' | 'operations.create.done' | 'operations.create.failed' | 'operations.create.pickHint' | 'operations.init.hint' | 'operations.init.submit' | 'operations.cancel' | 'workspace.unbound' | 'workspace.notInitialized' | 'workspace.bind.hint' | 'workspace.bind.pick' | 'workspace.bind.failed' | 'operations.create.titleHint' | 'tool.family.status' | 'tool.family.context' | 'tool.family.manuscript' | 'tool.family.revision' | 'tool.family.task' | 'tool.family.search' | 'tool.family.asset' | 'tool.family.outline' | 'tool.running' | 'tool.failed' | 'tool.succeeded' | 'tool.openChapter' | 'turn.changed' | 'turn.partial' | 'turn.failed' | 'turn.refreshFailed' | 'turn.history' | 'turn.proposed' | 'turn.rejected' | 'turn.entityChanges' | 'turn.before' | 'turn.after' | 'turn.missing' | 'turn.truncated' | 'turn.sourceRevision' | 'turn.resultRevision' | 'turn.committed' | 'turn.trace' | 'turn.modelCalls' | 'turn.days' | 'turn.accept' | 'turn.reject' | 'turn.retry' | 'turn.undo' | 'turn.applied' | 'turn.retried' | 'turn.undone' | 'resolving' | 'loading' | 'unreachable' | 'retry' | 'refresh' | 'openExternal' | 'outline.empty' | 'outline.drafted' | 'outline.planned' | 'outline.draftedCount' | 'outline.addChild' | 'outline.addAfter' | 'outline.addVolume' | 'outline.expandAll' | 'outline.collapseAll' | 'outline.del' | 'outline.confirmDelete' | 'outline.newTitlePlaceholder' | 'outline.opConflict' | 'outline.opFailed' | 'outline.summaryEmpty' | 'tools.title' | 'tools.export' | 'tools.export.done' | 'tools.export.failed' | 'tools.export.purpose' | 'tools.export.purpose.backup' | 'tools.export.purpose.delivery' | 'tools.export.format' | 'tools.export.preflight' | 'tools.export.loading' | 'tools.export.unavailable' | 'tools.export.refresh' | 'tools.export.revision' | 'tools.export.ready' | 'tools.export.blocked' | 'tools.export.download' | 'tools.export.order' | 'tools.export.orderEmpty' | 'tools.export.units' | 'tools.export.structure' | 'tools.export.structure.duplicates' | 'tools.export.structure.missing' | 'tools.export.structure.empty' | 'tools.export.structure.unreadable' | 'tools.export.clear' | 'tools.export.writingUnits' | 'tools.export.total' | 'tools.export.bookTarget' | 'tools.export.chapterTarget' | 'tools.export.completion' | 'tools.export.metadata' | 'tools.export.metadata.title' | 'tools.export.metadata.author' | 'tools.export.metadata.language' | 'tools.export.reviews' | 'tools.export.reviews.missing' | 'tools.export.reviews.current' | 'tools.export.reviews.stale' | 'tools.export.reviews.approved' | 'tools.export.reviews.notApproved' | 'tools.export.acceptance' | 'tools.export.acceptance.blocking' | 'tools.export.acceptance.blockingState' | 'tools.export.acceptance.needsReview' | 'tools.export.status' | 'tools.export.blockers' | 'tools.export.warnings' | 'tools.export.none' | 'tools.export.stale' | 'tools.sync' | 'tools.sync.done' | 'tools.sync.failed' | 'tools.import' | 'tools.import.empty' | 'tools.import.failed' | 'tools.import.done' | 'tools.import.choose' | 'tools.import.noFile' | 'tools.import.start' | 'tools.import.startAuto' | 'tools.import.preview' | 'tools.import.plan' | 'tools.import.conflicts' | 'tools.import.force' | 'tools.import.confirm' | 'tools.import.workspace.title' | 'tools.import.workspace.ownHint' | 'tools.import.workspace.operations' | 'tools.import.workspace.empty' | 'tools.import.workspace.new' | 'tools.import.workspace.file' | 'tools.import.workspace.arc' | 'tools.import.workspace.prepare' | 'tools.import.workspace.prepared' | 'tools.import.workspace.select' | 'tools.import.workspace.chapters' | 'tools.import.workspace.structure' | 'tools.import.workspace.chapterId' | 'tools.import.workspace.chapterTitle' | 'tools.import.workspace.chapterContent' | 'tools.import.workspace.moveUp' | 'tools.import.workspace.moveDown' | 'tools.import.workspace.remove' | 'tools.import.workspace.addChapter' | 'tools.import.workspace.newChapter' | 'tools.import.workspace.saveStructure' | 'tools.import.workspace.structureSaved' | 'tools.import.workspace.confirmStructure' | 'tools.import.workspace.confirmPrompt' | 'tools.import.workspace.confirmed' | 'tools.import.workspace.run' | 'tools.import.workspace.resume' | 'tools.import.workspace.taskStarted' | 'tools.import.workspace.discard' | 'tools.import.workspace.discardPrompt' | 'tools.import.workspace.discarded' | 'tools.import.workspace.recoverable' | 'tools.import.workspace.notRecoverable' | 'tools.import.stage.snapshot' | 'tools.import.stage.split' | 'tools.import.stage.structure_confirmed' | 'tools.import.stage.published' | 'tools.import.stage.acceptance' | 'tools.import.stage.reconcile' | 'tools.import.stage.synthesis' | 'tools.import.stage.complete' | 'tools.archive.title' | 'tools.archive.hint' | 'tools.archive.failed' | 'tools.archive.preflight' | 'tools.archive.create' | 'tools.archive.created' | 'tools.archive.list' | 'tools.archive.empty' | 'tools.archive.download' | 'tools.archive.downloaded' | 'tools.archive.files' | 'tools.archive.size' | 'tools.archive.categories' | 'tools.archive.includes' | 'tools.archive.excludes' | 'tools.archive.missing' | 'tools.archive.references' | 'tools.archive.referencePlan' | 'tools.archive.restore' | 'tools.archive.targetRoot' | 'tools.archive.pickTarget' | 'tools.archive.targetNovelId' | 'tools.archive.referencePolicy' | 'tools.archive.preserveRelative' | 'tools.archive.rewriteNovelId' | 'tools.archive.previewRestore' | 'tools.archive.restoreReady' | 'tools.archive.restoreBlocked' | 'tools.archive.conflicts' | 'tools.archive.pathRewrites' | 'tools.archive.rewrittenFiles' | 'tools.archive.rewrittenReferences' | 'tools.archive.preservedReferences' | 'tools.archive.referenceWarnings' | 'tools.archive.referenceConflicts' | 'tools.archive.tasksArchived' | 'tools.archive.autoResume' | 'tools.archive.noAutoResume' | 'tools.archive.confirmRestore' | 'tools.archive.restoreConfirm' | 'tools.archive.restoreStarted' | 'tasks.cancel' | 'tasks.cancel.title' | 'tasks.cancel.confirm' | 'tasks.cancel.done' | 'tasks.cancel.failed' | 'tasks.retry' | 'tasks.retry.title' | 'tasks.retry.notRecoverable' | 'tasks.retry.done' | 'tasks.retry.failed' | 'tasks.summary.total' | 'tasks.summary.updated' | 'tasks.filter.type' | 'tasks.filter.typeAll' | 'tasks.filter.chapter' | 'tasks.filter.keyword' | 'tasks.sort.newest' | 'tasks.sort.oldest' | 'tasks.sort.toggle' | 'tasks.progress.unknown' | 'tasks.phase.unknown' | 'tasks.confirm' | 'tasks.confirm.title' | 'tasks.confirm.done' | 'tasks.confirm.failed' | 'tasks.cancel.armYes' | 'tasks.cancel.armNo' | 'tasks.list' | 'tasks.detail.open' | 'tasks.detail.close' | 'tasks.detail.copyId' | 'tasks.detail.copied' | 'tasks.detail.events' | 'tasks.detail.eventsLoading' | 'tasks.detail.eventsEmpty' | 'tasks.detail.eventsFailed' | 'tasks.field.id' | 'tasks.field.type' | 'tasks.field.status' | 'tasks.field.phase' | 'tasks.field.chapter' | 'tasks.field.progress' | 'tasks.field.attempt' | 'tasks.field.created' | 'tasks.field.started' | 'tasks.field.updated' | 'tasks.field.completed' | 'tasks.field.summary' | 'tasks.field.resultRef' | 'tasks.field.failedStage' | 'tasks.field.errorCode' | 'tasks.field.recoverable' | 'tasks.field.yes' | 'tasks.field.no' | 'tasks.failure.cancelled' | 'tasks.failure.recoverable' | 'tasks.failure.provider' | 'tasks.failure.input' | 'tasks.failure.system' | 'tasks.jump.benchmark' | 'tasks.jump.research' | 'tasks.jump.chapter' | 'tasks.jump.review' | 'tasks.jump.unavailable' | 'tasks.jump.chapterHint' | 'tasks.jump.reviewHint' | 'tasks.jump.chapterMissing' | 'research.launch' | 'research.launch.placeholder' | 'research.launch.submit' | 'research.launch.submitting' | 'research.launch.submitted' | 'research.launch.failed' | 'research.launch.hint' | 'tasks.result.toggle' | 'tasks.result.score' | 'tasks.result.issues' | 'search.preview.back' | 'search.preview.openCreation' | 'search.preview.jumpReady' | 'search.preview.identityMismatch' | 'search.preview.locatorCurrent' | 'search.preview.locatorStale' | 'search.preview.locatorUnverified' | 'search.preview.revisionUnavailable' | 'search.change.title' | 'search.change.serverOwned' | 'search.change.unavailable' | 'search.change.currentLine' | 'search.change.replacement' | 'search.change.preview' | 'search.change.previewing' | 'search.change.sourceRevision' | 'search.change.resultRevision' | 'search.change.reject' | 'search.change.confirmApply' | 'search.change.applying' | 'search.change.refreshRequired' | 'search.change.invalidApply' | 'search.change.invalidReject' | 'search.change.applied' | 'search.change.rejected' | 'search.change.refresh' | 'assets.empty' | 'assets.other' | 'assets.stages' | 'assets.aliases' | 'assets.segment.characters' | 'assets.segment.world' | 'assets.segment.progression' | 'assets.segment.references' | 'assets.segment.core' | 'assets.segment.empty' | 'assets.references.empty' | 'assets.core.empty' | 'assets.detail.loading' | 'assets.draft.restored' | 'assets.draft.unsaved' | 'assets.draft.conflict' | 'assets.detail.relations' | 'assets.detail.index' | 'assets.list.detail_refs' | 'assets.list.taboos' | 'assets.edit.linesHint' | 'assets.relation.confirmed' | 'assets.relation.registered' | 'assets.relation.incoming' | 'assets.searchPlaceholder' | 'assets.edit.open' | 'assets.edit.name' | 'assets.edit.summary' | 'assets.edit.tags' | 'assets.edit.listHint' | 'assets.edit.save' | 'assets.edit.saving' | 'assets.edit.cancel' | 'assets.edit.conflict' | 'assets.edit.conflictRefresh' | 'assets.edit.addRelation' | 'assets.edit.removeRelation' | 'assets.edit.relationTarget' | 'assets.edit.relationNote' | 'assets.edit.derivedRelations' | 'assets.edit.body' | 'assets.edit.liveLoading' | 'assets.edit.optional' | 'assets.field.tier' | 'assets.field.personality' | 'assets.field.goal' | 'assets.field.fear' | 'assets.field.appearance' | 'assets.field.voice' | 'assets.field.current_state' | 'assets.field.organization' | 'assets.field.progression_system' | 'assets.field.progression_stage' | 'assets.field.status' | 'assets.field.kind' | 'assets.field.type' | 'assets.field.subtype' | 'assets.field.state_updated_at' | 'assets.field.role' | 'assets.edit.liveFailed' | 'assets.selectHint' | 'assets.create.open' | 'assets.create.submit' | 'assets.create.idHint' | 'assets.create.tier' | 'assets.create.type' | 'assets.create.progressionKind' | 'assets.create.stages' | 'assets.create.stageId' | 'assets.create.stageName' | 'assets.create.addStage' | 'tasks.empty' | 'tasks.filter.all' | 'tasks.attempt' | 'tasks.status.pending' | 'tasks.status.running' | 'tasks.status.awaiting_confirmation' | 'tasks.status.completed' | 'tasks.status.failed' | 'tasks.status.cancelled' | 'tasks.status.interrupted' | 'tasks.phase.queued' | 'tasks.phase.reading' | 'tasks.phase.preparing' | 'tasks.phase.model' | 'tasks.phase.validating' | 'tasks.phase.committing' | 'tasks.phase.complete' | 'tasks.type.chapter_write' | 'tasks.type.chapter_review' | 'tasks.type.continuous_write' | 'tasks.type.revision' | 'tasks.type.source_operation' | 'tasks.type.reference_operation' | 'tasks.type.manuscript_import' | 'tasks.type.project_restore' | 'tasks.type.research' | 'tasks.type.model_benchmark' | 'graph.foreshadowing' | 'graph.relationships' | 'graph.nodes' | 'graph.connections' | 'graph.relayout' | 'graph.weight' | 'graph.target' | 'graph.truncated' | 'graph.validation.errors' | 'graph.empty.foreshadowing' | 'graph.empty.relationships' | 'graph.entityType' | 'graph.entityStatus' | 'graph.search' | 'graph.connectedOnly' | 'graph.neighbors' | 'graph.edgeType' | 'graph.origin' | 'graph.source' | 'graph.confirmed' | 'dag.quality' | 'dag.coverage' | 'dag.gate' | 'dag.delivery' | 'dag.current' | 'dag.stale' | 'dag.toRevision' | 'dag.toRevisionDone' | 'dag.toRevisionFailed' | 'graph.unresolved' | 'graph.kind.character' | 'graph.kind.faction' | 'graph.kind.place' | 'graph.kind.concept' | 'graph.kind.other' | 'graph.truth' | 'graph.truth.currentState' | 'graph.truth.ledger' | 'graph.truth.relationships' | 'graph.workflows' | 'graph.workflow.currentStage' | 'graph.empty.truth' | 'graph.empty.truthDoc' | 'graph.empty.workflows' | 'graph.reviewDag' | 'graph.reviewFramework' | 'graph.reviewDomains' | 'graph.reviewChecks' | 'graph.reviewCriteria' | 'graph.deliveryDag' | 'graph.filter.all' | 'graph.filter.anomaly' | 'graph.filter.blocker' | 'graph.expandChecks' | 'graph.collapseChecks' | 'graph.empty.dag' | 'benchmark.title' | 'benchmark.taskType' | 'benchmark.executionEvidence' | 'benchmark.evidence' | 'benchmark.status.skipped' | 'benchmark.status.stale' | 'benchmark.task.chapter' | 'benchmark.task.outline' | 'benchmark.task.chapterHint' | 'benchmark.task.outlineHint' | 'benchmark.planner' | 'benchmark.nextChapter' | 'benchmark.chapterWritten' | 'benchmark.chapterPlanned' | 'benchmark.chapterUnavailable' | 'benchmark.customChapter' | 'benchmark.chapterId' | 'benchmark.outlineOrigin' | 'benchmark.continueOutline' | 'benchmark.customOutlineStart' | 'benchmark.outlineStart' | 'benchmark.outlineCount' | 'benchmark.rangeFrom' | 'benchmark.rangeTo' | 'benchmark.chapterUnit' | 'benchmark.invalidRange' | 'benchmark.outlineRangeHint' | 'benchmark.earliestOutlineStart' | 'benchmark.invalidChapter' | 'benchmark.historicalChapterHint' | 'benchmark.autoDag' | 'benchmark.executedDag' | 'benchmark.dagAutomatic' | 'benchmark.afterStage' | 'benchmark.reviewScope' | 'benchmark.isolatedHint' | 'benchmark.pipelineUnavailable' | 'benchmark.actualChapters' | 'benchmark.pipelineFinished' | 'benchmark.pipelineStatus' | 'benchmark.reviewIncomplete' | 'benchmark.partialScore' | 'benchmark.reviewIncompleteHint' | 'benchmark.completeReviews' | 'benchmark.reportedCoverage' | 'benchmark.coveragePending' | 'benchmark.factsPendingTitle' | 'benchmark.factsPendingHint' | 'benchmark.selectModels' | 'benchmark.description' | 'benchmark.configure' | 'benchmark.modelHint' | 'benchmark.advanced' | 'benchmark.history' | 'benchmark.results' | 'benchmark.noProfiles' | 'benchmark.chooseModels' | 'benchmark.workload' | 'benchmark.submitting' | 'benchmark.noCandidates' | 'benchmark.noEvaluations' | 'benchmark.plannedCandidates' | 'benchmark.plannedEvaluations' | 'benchmark.task' | 'benchmark.mode' | 'benchmark.mode.framework' | 'benchmark.mode.creative' | 'benchmark.mode.unknown' | 'benchmark.reviewer' | 'benchmark.chapter' | 'benchmark.repeats' | 'benchmark.words' | 'benchmark.concurrency' | 'benchmark.run' | 'benchmark.empty' | 'benchmark.select' | 'benchmark.averageScore' | 'benchmark.output' | 'benchmark.candidate' | 'benchmark.candidates' | 'benchmark.evaluations' | 'benchmark.writer' | 'benchmark.path' | 'benchmark.status' | 'benchmark.actualWords' | 'benchmark.finishReason' | 'benchmark.error' | 'benchmark.coverage' | 'benchmark.gate' | 'benchmark.delivery' | 'benchmark.productionGate' | 'benchmark.productionGateMissing' | 'benchmark.domains' | 'benchmark.latency' | 'benchmark.usage' | 'benchmark.cost' | 'benchmark.inputTokens' | 'benchmark.outputTokens' | 'benchmark.reasoningTokens' | 'benchmark.totalTokens' | 'benchmark.actualCost' | 'benchmark.costCoverage' | 'benchmark.effectiveRate' | 'benchmark.runs' | 'benchmark.sameInputGroup' | 'benchmark.comparisonIncomplete' | 'benchmark.inputProvenance' | 'benchmark.runPhases' | 'benchmark.phase.created' | 'benchmark.phase.started' | 'benchmark.phase.completed' | 'benchmark.contextHash' | 'benchmark.comparisonKey' | 'benchmark.promptVersion' | 'benchmark.rubricVersion' | 'benchmark.blindReview' | 'benchmark.contextStrategy' | 'benchmark.manifestVersion' | 'benchmark.tokenEstimator' | 'benchmark.packetRevision' | 'benchmark.sourceRevision' | 'benchmark.estimatedTokens' | 'benchmark.characters' | 'benchmark.contextSources' | 'benchmark.sourcePresent' | 'benchmark.sourceMissing' | 'benchmark.responseIdentity' | 'models.title' | 'models.list' | 'models.editor' | 'models.new' | 'models.empty' | 'models.id' | 'models.label' | 'models.provider' | 'models.protocol.openai' | 'models.protocol.anthropic' | 'models.modelId' | 'models.baseUrl' | 'models.apiFormat' | 'models.context' | 'models.output' | 'models.credential' | 'models.embeddingProvider' | 'models.embeddingModel' | 'models.embeddingCredential' | 'models.credentialHint' | 'models.remember' | 'models.save' | 'models.chatTest' | 'models.embeddingTest' | 'models.delete' | 'models.delete.confirm' | 'models.delete.blocked' | 'models.delete.wouldFail' | 'models.test.untested' | 'models.test.ok' | 'models.test.failed' | 'models.dependencies' | 'models.dependenciesHint' | 'models.fallback' | 'models.chooseFallback' | 'models.routes' | 'models.routesSave' | 'models.saved' | 'models.deleted' | 'models.chatOk' | 'models.embeddingOk' | 'models.configured' | 'models.missing' | 'models.routesSaved' | 'models.group.basic' | 'models.group.connection' | 'models.group.generation' | 'models.group.embedding' | 'models.group.credentials' | 'models.group.routeUsage' | 'models.temperature' | 'models.timeout' | 'models.embeddingBaseUrl' | 'models.validation.required' | 'models.validation.positive' | 'models.validation.temperature' | 'models.unsavedChanges' | 'models.unsavedDiscard' | 'models.unsavedKeep' | 'models.test.loading' | 'models.usedByRoutes' | 'models.noRoutes' | 'models.delete.resultingRoutes' | 'models.embeddingEmpty' | 'models.embeddingConfigured' | 'models.embeddingMissing' | 'models.active' | 'models.inactive' | 'models.route.goethe' | 'models.route.dante' | 'models.route.chapter_write' | 'models.route.review' | 'models.route.source_extract' | 'models.route.revision' | 'models.route.search' | 'models.route.research' | 'models.routesImpact' | 'models.routesUnchanged' | 'models.routesUnassigned' | 'models.embedConfigured' | 'models.embedMissing' | 'models.capability.chat' | 'models.capability.embedding' | 'research.reports' | 'research.unavailable' | 'research.empty' | 'research.selectHint' | 'research.report.loading' | 'research.quality' | 'research.language' | 'research.filter.keyword' | 'research.filter.status' | 'research.filter.sources' | 'research.filter.all' | 'research.status.succeeded' | 'research.status.failed' | 'research.status.needsReview' | 'research.status.unknown' | 'research.sourcesAvailable' | 'research.sourcesUnavailable' | 'research.sourcesEmpty' | 'research.sources' | 'research.sourceCheck' | 'research.source.cited' | 'research.source.uncited' | 'research.exportMarkdown' | 'research.referenceOnly' | 'research.prompt' | 'research.taskId' | 'research.episodeId' | 'research.model' | 'research.searchProvider' | 'research.createdAt' | 'research.completedAt' | 'research.latency' | 'research.wordCount' | 'research.tokens' | 'research.cost' | 'research.sourcesStatus' | 'research.metrics' | 'search.placeholder' | 'search.hint' | 'search.empty' | 'search.indexed' | 'search.timeout' | 'search.scope.all' | 'search.scope.outline' | 'search.scope.core' | 'search.scope.characters' | 'search.scope.settings' | 'search.scope.continuity' | 'search.scope.chapters' | 'search.scope.sources' | 'assets.references' | 'reference.intent.reference' | 'reference.intent.continuation' | 'reference.intent.canon' | 'reference.intent.migration' | 'reference.structure.awaiting_confirmation' | 'reference.structure.confirmed' | 'reference.analysis.complete' | 'reference.analysis.pending' | 'reference.chars' | 'reference.content.loading' | 'reference.content.full' | 'review.running' | 'review.passed' | 'review.failed' | 'review.score' | 'review.issues' | 'review.suggestion' | 'review.quote' | 'review.dimension' | 'review.coverage' | 'review.gate' | 'review.delivery' | 'review.execution' | 'review.priority' | 'review.severity.critical' | 'review.severity.warning' | 'review.severity.info' | 'review.severity.blocker' | 'review.severity.high' | 'review.severity.medium' | 'review.severity.low' | 'review.priority.blocker' | 'review.priority.high' | 'review.priority.medium' | 'review.priority.low' | 'review.status.pass' | 'review.status.blocked' | 'review.status.inconclusive' | 'review.status.revise' | 'review.status.completed' | 'review.status.partial' | 'review.status.failed' | 'review.status.stale' | 'review.status.unknown' | 'review.rawTitle';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The 稿件/大纲/资产 view tab labels and panel state strings. */
+        'studio-panel': StudioPanelKey;
+    }
+}
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: Record<StudioPanelKey, string>;
+/** English dictionary. */
+export declare const en: Record<StudioPanelKey, string>;

package/packages/studio-panel/lib/types/client/manuscript-annotations.d.ts

@@ -0,0 +1,59 @@
+import { type QuoteAnchor } from './manuscript-selection.ts';
+export declare const ANNOTATION_COLORS: readonly ["amber", "rose", "sky", "lime", "violet"];
+export type AnnotationColor = (typeof ANNOTATION_COLORS)[number];
+export declare const DEFAULT_ANNOTATION_COLOR: AnnotationColor;
+export declare const ANNOTATION_COLOR_LABEL: Record<AnnotationColor, `creation.notes.color.${AnnotationColor}`>;
+export type AnnotationStatus = 'open' | 'resolved';
+export type AnnotationAnchorState = 'attached' | 'relocated' | 'detached';
+export type ManuscriptAnnotation = {
+    annotationId: string;
+    chapterId: string;
+    sourceRevision: string;
+    quote: string;
+    startHint: number;
+    endHint: number;
+    note: string;
+    status: AnnotationStatus;
+    anchorState: AnnotationAnchorState;
+    currentStart: number | null;
+    currentEnd: number | null;
+    color: AnnotationColor;
+    createdAt: string;
+    updatedAt: string;
+};
+export declare function isAnnotationColor(value: string): value is AnnotationColor;
+/** Old records without color keep amber; unknown values also default. */
+export declare function annotationColor(value: unknown): AnnotationColor;
+export declare function parseAnnotation(value: unknown): ManuscriptAnnotation | null;
+export declare function parseAnnotationList(value: unknown): ManuscriptAnnotation[];
+export declare function unsavedAnnotationGuard(dirty: boolean): 'ok' | 'save-first';
+export declare function annotationLocateLabel(anchor: QuoteAnchor | {
+    state: AnnotationAnchorState;
+}): string;
+export declare function liveAnnotationAnchor(content: string, item: ManuscriptAnnotation): QuoteAnchor;
+export declare function revalidateAnnotationRange(content: string, selection: {
+    start: number;
+    end: number;
+    text: string;
+}): {
+    start: number;
+    end: number;
+    text: string;
+} | null;
+export declare function annotateRequest(input: {
+    chapterId: string;
+    revision: string;
+    selection: {
+        start: number;
+        end: number;
+        text: string;
+    };
+    note: string;
+    color: AnnotationColor;
+}): {
+    ok: true;
+    body: Record<string, unknown>;
+} | {
+    ok: false;
+    reason: 'empty' | 'save-first';
+};