annotation-kit 0.0.0-stage → 0.1.0

package/dist/types/client/files/selection.d.ts

@@ -0,0 +1,11 @@
+export type FileKind = 'code' | 'text' | 'markdown';
+export interface FileSelection {
+    readonly text: string;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly startColumn?: number;
+    readonly endColumn?: number;
+}
+/** A selection is accepted only when both ends belong to the same preview body. */
+export declare function readFileSelection(range: Range, root: HTMLElement, kind: FileKind): FileSelection | undefined;
+//# sourceMappingURL=selection.d.ts.map

package/dist/types/client/files/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../../src/client/files/selection.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAA;AAEnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,CA0C5G"}

package/dist/types/client/files/sheets/SheetRecovery.d.ts

@@ -0,0 +1,12 @@
+import type { PropsLocale } from '../../../host-contracts.ts';
+import { type DocumentAnnotationBridge } from '../document-workflow.ts';
+import { PageBatches } from '../pages/batches.ts';
+export declare function failedSheetPreview(root: ParentNode): {
+    host: HTMLElement;
+    address: string;
+} | undefined;
+/** The session overlay outlives a failed document body. Its UI stays inside that preview. */
+export declare function sheetRecoveryComponent(bridge: DocumentAnnotationBridge, batches: PageBatches): ({ sessionId, t }: PropsLocale<"annotations"> & {
+    sessionId: string;
+}) => import("react").JSX.Element | null;
+//# sourceMappingURL=SheetRecovery.d.ts.map

package/dist/types/client/files/sheets/SheetRecovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SheetRecovery.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/sheets/SheetRecovery.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAE7D,OAAO,EAAoB,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAMjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU;;;cAMlD;AAED,6FAA6F;AAC7F,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,EAAE,OAAO,EAAE,WAAW,IAE7D,kBAAkB,WAAW,CAAC,aAAa,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,wCAuDnG"}

package/dist/types/client/files/sheets/SheetSurface.d.ts

@@ -0,0 +1,27 @@
+import type { PropsLocale } from '../../../host-contracts.ts';
+import type { WorkbookInstance, Workbook as WorkbookComponent } from '@fortune-sheet/react';
+import type { Sheet } from '@fortune-sheet/core';
+import type { ComponentType, PropsWithoutRef, Ref, ComponentProps } from 'react';
+import { type DocumentAnnotationBridge } from '../document-workflow.ts';
+import { PageBatches } from '../pages/batches.ts';
+type Translate = PropsLocale<'annotations'>['t'];
+type WorkbookProps = ComponentProps<typeof WorkbookComponent>;
+export declare function SheetSurface({ resourceAddress: address, format, value, bridge, at: t, batches, t: excelT, Workbook, bodyCss, workbookCss }: {
+    resourceAddress: string;
+    t: PropsLocale<string>['t'];
+    Workbook: ComponentType<PropsWithoutRef<WorkbookProps> & {
+        ref?: Ref<WorkbookInstance>;
+    }>;
+    bodyCss: Record<string, string>;
+    workbookCss?: string;
+    format: 'xlsx' | 'csv';
+    value: {
+        sheets: Sheet[];
+        unsupportedFeatures: string[];
+    };
+    bridge: DocumentAnnotationBridge;
+    at: Translate;
+    batches: PageBatches;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=SheetSurface.d.ts.map

package/dist/types/client/files/sheets/SheetSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SheetSurface.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/sheets/SheetSurface.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC3F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAChF,OAAO,EAAoB,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAEzF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAQjD,KAAK,SAAS,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAA;AAChD,KAAK,aAAa,GAAG,cAAc,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAI7D,wBAAgB,YAAY,CAAC,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAgB,EAAE,EAAE;IAChJ,eAAe,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,aAAa,CAAC,GAAG;QAAE,GAAG,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAA;KAAE,CAAC,CAAC;IAChJ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IACtD,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,mBAAmB,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAC;IAAC,EAAE,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CACzJ,+BA0LA"}

package/dist/types/client/files/sheets/geometry.d.ts

@@ -0,0 +1,30 @@
+import type { Hooks, Sheet } from '@fortune-sheet/core';
+import type { SheetRange } from './snapshot.ts';
+export interface Box {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    right: number;
+    bottom: number;
+}
+export declare function clip(box: Box, bounds: Box): Box | undefined;
+export declare function union(boxes: readonly Box[]): Box | undefined;
+type Paint = Parameters<NonNullable<Hooks['afterRenderCell']>>[1];
+/** Public cell paint hooks already include zoom and frozen-pane offsets. No React internals. */
+export declare class PaintedCells {
+    private cells;
+    private columns;
+    private rows;
+    private columnStarts;
+    private rowStarts;
+    private headerLeft?;
+    private headerTop?;
+    clear(): void;
+    column(index: number, left: number, width: number, ctx: CanvasRenderingContext2D, headerHeight?: number): void;
+    row(index: number, top: number, height: number, ctx: CanvasRenderingContext2D, headerWidth?: number): void;
+    record(info: Paint, ctx: CanvasRenderingContext2D): void;
+    range(range: SheetRange, bounds: Box, frozen?: Sheet['frozen']): Box | undefined;
+}
+export {};
+//# sourceMappingURL=geometry.d.ts.map

package/dist/types/client/files/sheets/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/sheets/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,WAAW,GAAG;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAChH,wBAAgB,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,SAAS,CAI3D;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,GAAG,SAAS,CAK5D;AACD,KAAK,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEjE,gGAAgG;AAChG,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0F;IACvG,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,UAAU,CAAC,CAAQ;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,KAAK;IACL,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,wBAAwB,EAAE,YAAY,SAAK;IAMnG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,wBAAwB,EAAE,WAAW,SAAK;IAM/F,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,wBAAwB;IAUjD,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,SAAS;CAsCjF"}

package/dist/types/client/files/sheets/navigation.d.ts

@@ -0,0 +1,4 @@
+import type { SpreadsheetSnapshot } from './snapshot.ts';
+export declare function registerSpreadsheet(address: string, reveal: (snapshot: SpreadsheetSnapshot) => void): () => void;
+export declare function revealSpreadsheet(snapshot: SpreadsheetSnapshot): boolean;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/types/client/files/sheets/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/sheets/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAGxD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,cAGnG;AACD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAKxE"}

package/dist/types/client/files/sheets/snapshot.d.ts

@@ -0,0 +1,45 @@
+import type { Cell, Selection, Sheet } from '@fortune-sheet/core';
+export type CellValue = string | number | boolean | null;
+export type SheetRange = {
+    row: [number, number];
+    column: [number, number];
+};
+export type SheetCell = {
+    row: number;
+    column: number;
+    raw: CellValue;
+    display: string;
+    formula?: string;
+    cached?: CellValue;
+    format?: string;
+};
+export type SheetMerge = {
+    row: number;
+    column: number;
+    rows: number;
+    columns: number;
+};
+export interface SpreadsheetSnapshot {
+    readonly version: 3;
+    readonly id: string;
+    readonly address: string;
+    readonly kind: 'xlsx' | 'csv';
+    readonly sheet: {
+        id: string;
+        name: string;
+    };
+    readonly range: SheetRange;
+    readonly a1: string;
+    readonly cells: readonly SheetCell[];
+    readonly merges: readonly SheetMerge[];
+    readonly text: string;
+    readonly comment?: string;
+}
+export declare function columnName(column: number): string;
+export declare function rangeName(range: SheetRange): string;
+export declare function readRange(value: unknown): SheetRange | undefined;
+/** Freeze public Workbook API data as soon as the comment opens, never on Save. */
+export declare function spreadsheetSnapshot(address: string, kind: 'xlsx' | 'csv', sheet: Sheet, selection: Selection, values: (Cell | null)[][]): SpreadsheetSnapshot;
+/** Parse only the bounded, versioned public schema; ignore unrelated persisted properties. */
+export declare function readSpreadsheetSnapshot(value: Record<string, unknown>): SpreadsheetSnapshot | undefined;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/types/client/files/sheets/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/sheets/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEjE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;AACxD,MAAM,MAAM,UAAU,GAAG;IAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAA;AAC5E,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,SAAS,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AACD,MAAM,MAAM,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AACvF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAMD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjD;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAInD;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAKhE;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAC3G,MAAM,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,mBAAmB,CAoBhD;AAED,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAAG,SAAS,CA6BvG"}

package/dist/types/client/locales.d.ts

@@ -0,0 +1,148 @@
+export declare const zh: {
+    'response.title': string;
+    'response.add': string;
+    'response.placeholder': string;
+    'response.selected': string;
+    'response.source': string;
+    'response.edit': string;
+    'response.location': string;
+    'response.save': string;
+    'sheet.unavailable': string;
+    'sheet.cell': string;
+    'sheet.value': string;
+    'sheet.formula': string;
+    'sheet.raw': string;
+    'sheet.empty': string;
+    'page.request': string;
+    'page.ask': string;
+    'page.placeholder': string;
+    'page.pick': string;
+    'page.comment': string;
+    'page.edit': string;
+    'page.delete': string;
+    'page.one': string;
+    'page.many': string;
+    'page.cancel': string;
+    'page.save': string;
+    'page.send': string;
+    'page.sending': string;
+    'page.changes': string;
+    'page.submit': string;
+    'page.senderUnavailable': string;
+    'page.region': string;
+    'page.regionHint': string;
+    'page.restoring': string;
+    'page.imageMissing': string;
+    'page.officePage': string;
+    'file.one': string;
+    'file.many': string;
+    'file.selections': string;
+    'file.remove': string;
+    'file.removeAll': string;
+    'file.openSource': string;
+    'file.openFailed': string;
+    'file.sourceBlock': string;
+    'file.snapshot': string;
+    'message.expand': string;
+    'message.collapse': string;
+    'message.evidence': string;
+    adjust: string;
+    cancel: string;
+    placeholder: string;
+    annotating: string;
+    send: string;
+    'packet.one': string;
+    'packet.many': string;
+    'packet.edit': string;
+    'packet.removeAll': string;
+    annotate: string;
+    element: string;
+    region: string;
+    close: string;
+    pick: string;
+    comment: string;
+    save: string;
+    saving: string;
+    add: string;
+    adding: string;
+    delete: string;
+    noSession: string;
+    empty: string;
+    saved: string;
+    screenshot: string;
+    selection: string;
+    'packet.title': string;
+    'packet.screenshot': string;
+    'packet.done': string;
+    'packet.remove': string;
+    'file.add': string;
+    'file.adding': string;
+    'file.addTitle': string;
+    'file.openSession': string;
+    'file.addFailed': string;
+    "error.responseInvalid": string;
+    "error.responseChanged": string;
+    "error.responseUnavailable": string;
+    "error.browserNotReady": string;
+    "error.originalSession": string;
+    "error.sessionChangedSend": string;
+    "error.sessionChangedAdd": string;
+    "error.sessionChangedDocument": string;
+    "error.documentBusy": string;
+    "error.fileChanged": string;
+    "error.quickTextOnly": string;
+    "error.senderUnavailable": string;
+    "error.senderUnsupported": string;
+    "error.sessionNotReady": string;
+    "error.imageLimit": string;
+    "error.imageDraftLimit": string;
+    "error.disposed": string;
+    "error.emptyContent": string;
+    "error.fileImageMismatch": string;
+    "error.imageMismatch": string;
+    "error.imageCountMismatch": string;
+    "error.noSession": string;
+    "error.composerNotReady": string;
+    "error.composerBusy": string;
+    "error.imageServiceNotReady": string;
+    "error.imageFormat": string;
+    "error.composerImages": string;
+    "error.draftChanged": string;
+    "error.imageDraftUnsupported": string;
+    "error.imageDraftIncompatible": string;
+    "error.invalidDocument": string;
+    "error.batchLimit": string;
+    "error.batchFull": string;
+    "error.sendFailed": string;
+    "error.packetExpired": string;
+    "error.packetImageExpired": string;
+    "error.invalidSelection": string;
+    "error.selectionLimit": string;
+    "error.selectionDraft": string;
+    "error.contiguousSelection": string;
+    "error.separateRanges": string;
+    "error.selectionTooLarge": string;
+    "error.sheetNotReady": string;
+    "error.sheetUnavailable": string;
+    "error.sourceUnavailable": string;
+    "error.invalidBatch": string;
+    "error.commentRequired": string;
+    "error.imageMissing": string;
+    "error.regionUnavailable": string;
+    "error.pageNotReady": string;
+    "error.captureRegion": string;
+    "error.encodeRegion": string;
+    "error.regionTooLarge": string;
+    "error.pageImageMismatch": string;
+    "error.cancelled": string;
+    "error.imageRestoring": string;
+    "error.imageDraftLost": string;
+    "error.restoreImage": string;
+    "error.restoreAttachmentRetry": string;
+    "error.restoreAttachment": string;
+    "error.storeOpen": string;
+    "error.storeWrite": string;
+};
+export declare const en: Record<keyof typeof zh, string>;
+export type AnnotationKey = keyof typeof zh;
+//# sourceMappingURL=locales.d.ts.map

package/dist/types/client/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCd,CAAA;AACD,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,OAAO,EAAE,EAAE,MAAM,CA6B9C,CAAA;AACD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,EAAE,CAAA"}

package/dist/types/client/messages/SentAnnotations.d.ts

@@ -0,0 +1,18 @@
+import type { ReactNode } from 'react';
+import type { PropsLocale } from '../../host-contracts.ts';
+import { type FileSnapshot } from '../files/references.ts';
+import { type ResponseAnnotationSnapshot } from '../responses/references.ts';
+export interface SentAnnotationsProps<C, A> extends PropsLocale<'annotations'> {
+    content: readonly C[];
+    attachments: readonly A[];
+    fallback: ReactNode;
+    renderDefault(content: readonly C[], attachments: readonly A[]): ReactNode;
+    renderText(text: string): ReactNode;
+    imageName(attachment: A): string | undefined;
+    renderImage(attachment: A): ReactNode;
+    openFile?: (snapshot: FileSnapshot) => void | Promise<void>;
+    openResponse?: (snapshot: ResponseAnnotationSnapshot) => void | Promise<void>;
+}
+/** Annotation metadata is a display hint, never HTML, a URL to fetch, or model instructions. */
+export declare function SentAnnotations<C, A>({ content, attachments, fallback, renderDefault, renderImage, renderText, imageName, t, openFile, openResponse }: SentAnnotationsProps<C, A>): string | number | boolean | import("react").JSX.Element | Iterable<ReactNode> | null | undefined;
+//# sourceMappingURL=SentAnnotations.d.ts.map

package/dist/types/client/messages/SentAnnotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentAnnotations.d.ts","sourceRoot":"","sources":["../../../../src/client/messages/SentAnnotations.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAG1D,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAExE,OAAO,EAAoB,KAAK,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AAG9F,MAAM,WAAW,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,WAAW,CAAC,aAAa,CAAC;IAC5E,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;IACrB,WAAW,EAAE,SAAS,CAAC,EAAE,CAAA;IACzB,QAAQ,EAAE,SAAS,CAAA;IACnB,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,GAAG,SAAS,CAAA;IAC1E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,SAAS,CAAC,UAAU,EAAE,CAAC,GAAG,MAAM,GAAG,SAAS,CAAA;IAC5C,WAAW,CAAC,UAAU,EAAE,CAAC,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9E;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,oGAsDjL"}

package/dist/types/client/messages/presentation.d.ts

@@ -0,0 +1,39 @@
+/** Versioned, JSON-safe sent-message presentation. Model evidence stays in text. */
+export declare const ANNOTATION_PRESENTATION = "aione-annotations";
+export type SentAnnotation = {
+    readonly id: number;
+    readonly comment: string;
+    readonly title: string;
+    readonly url: string;
+    readonly target: string;
+    readonly screenshot: string;
+};
+export interface AnnotationPresentation {
+    readonly source: typeof ANNOTATION_PRESENTATION;
+    readonly summary: string;
+    readonly data: {
+        readonly version: 1;
+        readonly id: string;
+        readonly entries: readonly SentAnnotation[];
+    };
+}
+export interface SerializedAnnotation {
+    readonly text: string;
+    readonly presentation: AnnotationPresentation;
+}
+export declare function annotationPresentation(id: string, entries: readonly {
+    readonly id: number;
+    readonly comment: string;
+    readonly image: {
+        readonly name: string;
+    };
+    readonly selection: {
+        readonly title: string;
+        readonly url: string;
+        readonly selector?: string;
+        readonly kind: string;
+    };
+}[]): AnnotationPresentation;
+/** Only explicit v1 metadata opts in. Plain text, legacy dumps and unknown versions stay untouched. */
+export declare function readAnnotation(block: unknown): SerializedAnnotation | undefined;
+//# sourceMappingURL=presentation.d.ts.map

package/dist/types/client/messages/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../../src/client/messages/presentation.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,sBAAsB,CAAA;AAE1D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,uBAAuB,CAAA;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;KAAE,CAAA;CACzG;AACD,MAAM,WAAW,oBAAoB;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAA;CAAE;AAE9G,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS;IACnE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACxF,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACxH,EAAE,GAAG,sBAAsB,CAK3B;AAMD,uGAAuG;AACvG,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAY/E"}

package/dist/types/client/model.d.ts

@@ -0,0 +1,68 @@
+import type { BrowserSurfaceHandle } from '../shared/surface.ts';
+import type { BrowserAnnotationSelection, DesktopAnnotations } from '../shared/desktop.ts';
+import type { ComposerBridge } from '../host-contracts.ts';
+import type { AnnotationEntry } from './composer/packets.ts';
+import { type AnnotationFailure } from './errors.ts';
+export { formatAnnotations } from './composer/packets.ts';
+export interface AnnotationDraft {
+    readonly active: boolean;
+    readonly mode: 'element' | 'region';
+    readonly lease: string;
+    readonly epoch: string;
+    readonly selection?: BrowserAnnotationSelection;
+    readonly comment: string;
+    readonly saving: boolean;
+    readonly error?: AnnotationFailure;
+    readonly target?: string;
+    readonly editing?: {
+        readonly entry: AnnotationEntry;
+        readonly commit: (comment: string) => void;
+    };
+}
+export interface AnnotationState {
+    readonly drafts: Readonly<Record<string, AnnotationDraft>>;
+}
+/** Window-local snapshots. Navigation only invalidates targets not yet saved. */
+export declare class AnnotationsModel {
+    private readonly desktop;
+    private readonly composer;
+    private readonly leaseOf;
+    private state;
+    private readonly listeners;
+    private readonly surfaces;
+    private readonly operations;
+    private alive;
+    private nextId;
+    private readonly visibleMarkers;
+    private readonly pending;
+    private readonly unsubscribe;
+    constructor(desktop: DesktopAnnotations | undefined, composer: ComposerBridge, leaseOf?: (surface: BrowserSurfaceHandle) => string | undefined);
+    readonly getSnapshot: () => AnnotationState;
+    readonly subscribe: (listener: () => void) => (() => void);
+    readonly refresh: () => void;
+    available(surface: BrowserSurfaceHandle): boolean;
+    hasTarget(): boolean;
+    controls(): {
+        count: number;
+        entries: readonly AnnotationEntry[];
+        edit(id: number): void;
+        remove(id: number): void;
+        review(): void;
+        clear(): void;
+        send(): void;
+    } | undefined;
+    markerVisible(id: number): boolean;
+    readonly edit: (entry: AnnotationEntry, commit: (comment: string) => void) => boolean;
+    toggle(surface: BrowserSurfaceHandle): Promise<void>;
+    setMode(surface: BrowserSurfaceHandle, mode: 'element' | 'region'): Promise<void>;
+    setComment(surfaceId: string, comment: string): void;
+    cancel(surfaceId: string): void;
+    save(surface: BrowserSurfaceHandle): Promise<void>;
+    dispose(): void;
+    private receive;
+    private update;
+    private nextOperation;
+    private currentOperation;
+    private publish;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/types/client/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/client/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,kBAAkB,EAA0B,MAAM,sBAAsB,CAAA;AAClH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAsC,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,0BAA0B,CAAA;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;CACnG;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;CAC3D;AAID,iFAAiF;AACjF,qBAAa,gBAAgB;IAWf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAkC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAC7F,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;gBAEX,OAAO,EAAE,kBAAkB,GAAG,SAAS,EAAmB,QAAQ,EAAE,cAAc,EAC5F,OAAO,GAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,MAAM,GAAG,SAGrE;IAIH,QAAQ,CAAC,WAAW,QAAO,eAAe,CAAc;IACxD,QAAQ,CAAC,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGxD;IACD,QAAQ,CAAC,OAAO,QAAO,IAAI,CAQ1B;IACD,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO;IAGjD,SAAS,IAAI,OAAO;IACpB,QAAQ;;;;;;;;;IACR,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAElC,QAAQ,CAAC,IAAI,GAAI,OAAO,eAAe,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,KAAG,OAAO,CAQnF;IAEK,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BpD,OAAO,CAAC,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvF,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKpD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQzB,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCxD,OAAO,IAAI,IAAI;IAcf,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,MAAM;IAGd,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,OAAO;CAKhB"}

package/dist/types/client/quoted-context.d.ts

@@ -0,0 +1,3 @@
+/** Preserve source text inside a fence that the source cannot close. */
+export declare function quotedContext(text: string): string;
+//# sourceMappingURL=quoted-context.d.ts.map

package/dist/types/client/quoted-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quoted-context.d.ts","sourceRoot":"","sources":["../../../src/client/quoted-context.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlD"}

package/dist/types/client/responses/ResponseCard.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from 'react';
+import type { PropsLocale } from '../../host-contracts.ts';
+import type { ResponseAnnotationSnapshot } from './references.ts';
+export declare function ResponseCard({ items, draft, t, onOpen, onRemove, onClear, renderText }: PropsLocale<'annotations'> & {
+    readonly items: readonly ResponseAnnotationSnapshot[];
+    readonly draft?: boolean;
+    readonly onOpen?: (snapshot: ResponseAnnotationSnapshot, edit: boolean, trigger?: HTMLElement) => void | Promise<void>;
+    readonly onRemove?: (snapshot: ResponseAnnotationSnapshot) => void;
+    readonly onClear?: () => void;
+    readonly renderText?: (text: string) => ReactNode;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=ResponseCard.d.ts.map

package/dist/types/client/responses/ResponseCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseCard.d.ts","sourceRoot":"","sources":["../../../../src/client/responses/ResponseCard.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAG1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAGjE,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,KAAa,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAyB,EAAE,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG;IAC3I,QAAQ,CAAC,KAAK,EAAE,SAAS,0BAA0B,EAAE,CAAA;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,IAAI,CAAA;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAA;CAClD,sCAwBA"}

package/dist/types/client/responses/ResponseOverlay.d.ts

@@ -0,0 +1,7 @@
+import type { PropsLocale } from '../../host-contracts.ts';
+import type { ResponseController } from './controller.ts';
+export declare function ResponseOverlay({ controller, sessionId, t }: PropsLocale<'annotations'> & {
+    readonly controller: ResponseController;
+    readonly sessionId: string;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=ResponseOverlay.d.ts.map

package/dist/types/client/responses/ResponseOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseOverlay.d.ts","sourceRoot":"","sources":["../../../../src/client/responses/ResponseOverlay.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAG1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAczD,wBAAgB,eAAe,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,sCAsIjK"}

package/dist/types/client/responses/composer.d.ts

@@ -0,0 +1,11 @@
+import type { ResponseAnnotationSnapshot } from './references.ts';
+/** The persisted Composer document owns these items; no parallel window-local draft store. */
+export interface ResponseComposer {
+    read(sessionId: string): readonly ResponseAnnotationSnapshot[];
+    replace(snapshot: ResponseAnnotationSnapshot): void;
+    remove(sessionId: string, id: string): void;
+    clear(sessionId: string): void;
+    focus(sessionId: string): void;
+    open?: (snapshot: ResponseAnnotationSnapshot, edit: boolean, trigger?: HTMLElement) => Promise<void>;
+}
+//# sourceMappingURL=composer.d.ts.map

package/dist/types/client/responses/composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../../../src/client/responses/composer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAEjE,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,0BAA0B,EAAE,CAAA;IAC9D,OAAO,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAAA;IACnD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACrG"}

package/dist/types/client/responses/controller.d.ts

@@ -0,0 +1,39 @@
+import { type AnnotationFailure } from '../errors.ts';
+import type { ComposerBridge } from '../../host-contracts.ts';
+import type { ResponseAnnotationSnapshot } from './references.ts';
+import { type ResponseSelection, type ResponseSurface } from './selection.ts';
+export interface ResponseEditor {
+    readonly snapshot: ResponseAnnotationSnapshot;
+    readonly initial: boolean;
+    readonly trigger?: HTMLElement;
+}
+/** Ephemeral surface/interaction state only. All saved content lives in Composer references. */
+export declare class ResponseController {
+    readonly composer: ComposerBridge;
+    private readonly load;
+    readonly surfaces: Set<ResponseSurface>;
+    private listeners;
+    private revision;
+    private operation;
+    private disposed;
+    candidate?: ResponseSelection;
+    editor?: ResponseEditor;
+    selectedId?: string;
+    selected?: ResponseAnnotationSnapshot;
+    failure?: AnnotationFailure;
+    busy: boolean;
+    constructor(composer: ComposerBridge, load: (sessionId: string, seq: number) => Promise<void>);
+    getSnapshot: () => number;
+    subscribe: (listener: () => void) => (() => void);
+    changed: () => void;
+    register(surface: ResponseSurface): () => void;
+    select(sessionId: string): void;
+    dismiss(restoreFocus?: boolean): void;
+    add(): Promise<void>;
+    ranges(snapshot: ResponseAnnotationSnapshot): Range[];
+    open(snapshot: ResponseAnnotationSnapshot, edit: boolean, trigger?: HTMLElement): Promise<void>;
+    save(comment: string): void;
+    remove(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/types/client/responses/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../src/client/responses/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAiF,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAE5J,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAA;IAC7C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;CAC/B;AAED,gGAAgG;AAChG,qBAAa,kBAAkB;IAajB,QAAQ,CAAC,QAAQ,EAAE,cAAc;IAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;IAZpE,QAAQ,CAAC,QAAQ,uBAA6B;IAC9C,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,QAAQ,CAAQ;IACxB,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,0BAA0B,CAAA;IACrC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,IAAI,UAAQ;gBAES,QAAQ,EAAE,cAAc,EAAmB,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;IACvH,WAAW,QAAO,MAAM,CAAiB;IACzC,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAAsF;IACtI,OAAO,QAAO,IAAI,CAA0E;IAC5F,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,IAAI;IAK9C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO/B,OAAO,CAAC,YAAY,UAAQ,GAAG,IAAI;IAc7B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB1B,MAAM,CAAC,QAAQ,EAAE,0BAA0B,GAAG,KAAK,EAAE;IAQ/C,IAAI,CAAC,QAAQ,EAAE,0BAA0B,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCrG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAS3B,MAAM,IAAI,IAAI;IASd,OAAO,IAAI,IAAI;CAChB"}

package/dist/types/client/responses/references.d.ts

@@ -0,0 +1,62 @@
+import type { InputState, ReferenceInsert, TokenSpan } from '../../host-contracts.ts';
+export declare const RESPONSE_SOURCE = "aione-response-annotations";
+export declare const RESPONSE_SELECTION_BYTES: number;
+/** Offsets count UTF-16 code units in the visible text projection, not Markdown source. */
+export interface ResponseTextAnchor {
+    readonly blockIndex: number;
+    readonly start: number;
+    readonly end: number;
+    readonly prefixHash: string;
+    readonly text: string;
+}
+export interface ResponseAnnotationSnapshot {
+    readonly version: 1;
+    readonly id: string;
+    readonly sessionId: string;
+    readonly nodeKey: string;
+    readonly nodeId: string;
+    readonly turn: number;
+    readonly step: number;
+    readonly seq: number;
+    readonly text: string;
+    readonly comment: string;
+    readonly anchors: readonly ResponseTextAnchor[];
+}
+/** Reconstruct trusted fields; durable references and message metadata are untrusted input. */
+export declare function readResponseSnapshot(value: unknown): ResponseAnnotationSnapshot | undefined;
+export declare function decodeResponseReference(ref: string): ResponseAnnotationSnapshot | undefined;
+export declare function responseReference(snapshot: ResponseAnnotationSnapshot, label: string): ReferenceInsert;
+export declare function responseSelections(input: Pick<InputState, 'occurrences' | 'draftRev'>): {
+    snapshot: ResponseAnnotationSnapshot;
+    span: TokenSpan;
+    ref: string;
+}[];
+export declare function assertResponseCapacity(input: Pick<InputState, 'occurrences'>, ref: string, replacing?: string): void;
+export declare function serializeResponseReference(ref: string, signal: AbortSignal): {
+    text: string;
+    presentation: {
+        source: string;
+        summary: string;
+        data: {
+            anchors: {
+                blockIndex: number;
+                start: number;
+                end: number;
+                prefixHash: string;
+                text: string;
+            }[];
+            version: 1;
+            id: string;
+            sessionId: string;
+            nodeKey: string;
+            nodeId: string;
+            turn: number;
+            step: number;
+            seq: number;
+            text: string;
+            comment: string;
+        };
+    };
+};
+export declare function readSentResponse(block: unknown): ResponseAnnotationSnapshot | undefined;
+//# sourceMappingURL=references.d.ts.map

package/dist/types/client/responses/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/client/responses/references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAIrF,eAAO,MAAM,eAAe,+BAA+B,CAAA;AAC3D,eAAO,MAAM,wBAAwB,QAAY,CAAA;AAKjD,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAChD;AAMD,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CAiB3F;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAG3F;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,0BAA0B,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAKtG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,UAAU,CAAC;;;;IASrF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAMpH;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;;;;;;;4BA5EpD,MAAM;uBACX,MAAM;qBACR,MAAM;4BACC,MAAM;sBACZ,MAAM;;qBAIH,CAAC;gBACN,MAAM;uBACC,MAAM;qBACR,MAAM;oBACP,MAAM;kBACR,MAAM;kBACN,MAAM;iBACP,MAAM;kBACL,MAAM;qBACH,MAAM;;;EAoEzB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CAIvF"}