annotation-kit 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,53 @@
+import type { SessionId } from '../../host-contracts.ts';
+import type { DraftAttachmentId, InputActions, InputState, ReferenceInsert, TokenSpan } from '../../host-contracts.ts';
+import type { BrowserAnnotationSelection } from '../../shared/desktop.ts';
+import { type DraftFactory } from './attachments.ts';
+import { type SerializedAnnotation } from '../messages/presentation.ts';
+export declare const ANNOTATION_SOURCE = "aione-annotations";
+export interface AnnotationEntry {
+    readonly id: number;
+    readonly source: string;
+    readonly surfaceId?: string;
+    readonly selection: BrowserAnnotationSelection;
+    readonly comment: string;
+    readonly image: File;
+}
+export interface AnnotationPacket {
+    readonly id: string;
+    readonly sessionId: SessionId;
+    readonly label: string;
+    readonly factory: DraftFactory;
+    readonly previews: readonly string[];
+    entries: readonly AnnotationEntry[];
+    imageIds: readonly DraftAttachmentId[];
+    staged: boolean;
+}
+export declare function formatAnnotations(entries: readonly AnnotationEntry[]): string;
+/** Convert the public clipboard coordinates to the editor's atomic-chip coordinates. */
+export declare function packetSpan(input: InputState, id: string): TokenSpan | undefined;
+/** One window owns the semantic reference and its screenshot drafts together. */
+export declare class AnnotationPackets {
+    private readonly records;
+    private readonly listeners;
+    private revision;
+    opened: {
+        readonly sessionId: SessionId;
+        readonly id: string;
+    } | undefined;
+    readonly subscribe: (listener: () => void) => (() => void);
+    readonly getSnapshot: () => number;
+    private changed;
+    get(id: string): AnnotationPacket | undefined;
+    create(sessionId: SessionId, entries: readonly AnnotationEntry[], ids: readonly DraftAttachmentId[], factory: DraftFactory, label: string): AnnotationPacket;
+    reference(packet: AnnotationPacket): ReferenceInsert;
+    activate(packet: AnnotationPacket): void;
+    open(sessionId: SessionId, id: string): boolean;
+    readonly close: () => void;
+    edit(id: string, index: number, comment: string): void;
+    serialize(id: string, signal: AbortSignal): Promise<SerializedAnnotation>;
+    imageIdsFor(input: InputState | undefined): ReadonlySet<DraftAttachmentId>;
+    reconcile(sessionId: SessionId, input: InputState, actions: InputActions): void;
+    discard(id: string): void;
+    dispose(): void;
+}
+//# sourceMappingURL=packets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packets.d.ts","sourceRoot":"","sources":["../../../../src/client/composer/packets.ts"],"names":[],"mappings":"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"}

package/dist/types/client/composer/reference-presentation.d.ts

@@ -0,0 +1,4 @@
+import type { InputState } from '../../host-contracts.ts';
+/** Keep restored Lexical references behind the plugin's grouped attachment UI. */
+export declare function bindReferencePresentation(card: Element, input: Pick<InputState, 'occurrences' | 'draft'>, owns: (source: string, ref: string) => boolean): () => void;
+//# sourceMappingURL=reference-presentation.d.ts.map

package/dist/types/client/composer/reference-presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-presentation.d.ts","sourceRoot":"","sources":["../../../../src/client/composer/reference-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEzD,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,EAChD,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,GAC7C,MAAM,IAAI,CAgCZ"}

package/dist/types/client/error-copy.d.ts

@@ -0,0 +1,69 @@
+/** Stable keys for plugin-owned failures, translated at their presentation boundary. */
+export declare const errorCopy: {
+    readonly 'error.responseInvalid': readonly ["消息选区无效或超过限制，请缩小选区后重新添加。", "The response selection is invalid or exceeds the limit. Select a smaller range and add it again."];
+    readonly 'error.responseChanged': readonly ["原文已更新，请重新选择要引用的内容。", "The response changed. Select the text again."];
+    readonly 'error.responseUnavailable': readonly ["无法定位原文，保存时的选区仍可查看和发送。", "The original response could not be located. The saved selection can still be reviewed and sent."];
+    readonly 'error.browserNotReady': readonly ["浏览器页面尚未就绪。", "Browser page is not ready."];
+    readonly 'error.originalSession': readonly ["请在选择目标时的会话中添加批注", "Add the annotation in the conversation where the target was selected."];
+    readonly 'error.sessionChangedSend': readonly ["会话已切换，批注未发送", "The conversation changed. The annotation was not sent."];
+    readonly 'error.sessionChangedAdd': readonly ["会话已切换，内容未添加", "The conversation changed. The content was not added."];
+    readonly 'error.sessionChangedDocument': readonly ["会话已切换，批注未保存或发送", "The conversation changed. The annotation was not saved or sent."];
+    readonly 'error.documentBusy': readonly ["该文档的批注操作尚未完成", "An annotation operation for this document is still in progress."];
+    readonly 'error.fileChanged': readonly ["文件已切换，批注未保存或发送", "The file changed. The annotation was not saved or sent."];
+    readonly 'error.quickTextOnly': readonly ["快捷请求只支持转换后幻灯片中的文字选区", "Quick requests support only text selections in converted slides."];
+    readonly 'error.senderUnavailable': readonly ["当前会话不支持文档批注发送", "Document annotations cannot be sent in this session."];
+    readonly 'error.senderUnsupported': readonly ["当前 DSH 版本不支持文档批注发送", "This DSH version does not support sending document annotations."];
+    readonly 'error.sessionNotReady': readonly ["当前会话尚未就绪", "The conversation is not ready yet."];
+    readonly 'error.imageLimit': readonly ["截图超出附件数量或大小限制", "The screenshots exceed the attachment count or size limit."];
+    readonly 'error.imageDraftLimit': readonly ["截图超出图片附件的数量或大小限制", "The screenshots exceed the image attachment count or size limit."];
+    readonly 'error.disposed': readonly ["批注插件已卸载", "The annotations plugin has been unloaded."];
+    readonly 'error.emptyContent': readonly ["没有可添加的内容", "There is no content to add."];
+    readonly 'error.fileImageMismatch': readonly ["文件选区与截图不匹配", "The file selection does not match its screenshot."];
+    readonly 'error.imageMismatch': readonly ["批注与截图不匹配", "The annotations do not match their screenshots."];
+    readonly 'error.imageCountMismatch': readonly ["批注与截图数量不一致", "The number of annotations and screenshots does not match."];
+    readonly 'error.noSession': readonly ["请先打开一个会话", "Open a conversation first."];
+    readonly 'error.composerNotReady': readonly ["当前会话的输入框尚未就绪", "The conversation input is not ready yet."];
+    readonly 'error.composerBusy': readonly ["输入框正忙，请稍后再试", "The input is busy. Try again shortly."];
+    readonly 'error.imageServiceNotReady': readonly ["当前会话的图片附件服务尚未就绪", "The image attachment service is not ready yet."];
+    readonly 'error.imageFormat': readonly ["截图格式不受附件服务支持", "The attachment service does not support this screenshot format."];
+    readonly 'error.composerImages': readonly ["输入框暂时无法接收截图", "The input cannot accept screenshots right now."];
+    readonly 'error.draftChanged': readonly ["草稿已变化，请重试添加", "The draft changed. Try adding the selection again."];
+    readonly 'error.imageDraftUnsupported': readonly ["当前 DSH 版本不支持批注图片草稿", "This DSH version does not support annotation image drafts."];
+    readonly 'error.imageDraftIncompatible': readonly ["当前 DSH 图片草稿格式与批注插件不兼容", "The DSH image draft format is incompatible with annotations."];
+    readonly 'error.invalidDocument': readonly ["文档批注无效", "The document annotation is invalid."];
+    readonly 'error.batchLimit': readonly ["批注总量已达上限", "The annotation batch limit has been reached."];
+    readonly 'error.batchFull': readonly ["批注总量已达上限，请先发送或删除部分批注", "The annotation batch limit has been reached. Send or delete some annotations first."];
+    readonly 'error.sendFailed': readonly ["批注发送失败，请重试", "Could not send the annotations. Try again."];
+    readonly 'error.packetExpired': readonly ["批注草稿已失效，请从网页重新添加", "The annotation draft has expired. Add it again from the page."];
+    readonly 'error.packetImageExpired': readonly ["批注截图已失效，请重新添加批注", "The annotation screenshot has expired. Add the annotation again."];
+    readonly 'error.invalidSelection': readonly ["文件选区无效或超过 64 KiB，请缩小选区后重试", "The file selection is invalid or exceeds 64 KiB. Select a smaller range and try again."];
+    readonly 'error.selectionLimit': readonly ["选区总量已达上限，请先发送或移除部分选区", "The selection limit has been reached. Send or remove some selections first."];
+    readonly 'error.selectionDraft': readonly ["文件选区草稿无效，请移除并重新添加", "The file selection draft is invalid. Remove it and add it again."];
+    readonly 'error.contiguousSelection': readonly ["请选择一个连续的单元格区域", "Select one contiguous cell range."];
+    readonly 'error.separateRanges': readonly ["请选择一个连续区域；多块区域请分别批注", "Select one contiguous range. Annotate separate ranges individually."];
+    readonly 'error.selectionTooLarge': readonly ["选区超过 64 KiB，请缩小范围后重试", "The selection exceeds 64 KiB. Select a smaller range and try again."];
+    readonly 'error.sheetNotReady': readonly ["表格尚未加载，已保存的选区仍可查看", "The spreadsheet has not loaded. Saved selections are still available."];
+    readonly 'error.sheetUnavailable': readonly ["来源工作表已删除或隐藏，已保存的选区仍可查看", "The source sheet was deleted or hidden. Saved selections are still available."];
+    readonly 'error.sourceUnavailable': readonly ["无法打开来源文件或工作表，已保存的选区仍可查看", "Could not open the source file or sheet. Saved selections are still available."];
+    readonly 'error.invalidBatch': readonly ["文档批注草稿无效", "The document annotation draft is invalid."];
+    readonly 'error.commentRequired': readonly ["请输入批注", "Enter an annotation comment."];
+    readonly 'error.imageMissing': readonly ["批注截图缺失", "The annotation screenshot is missing."];
+    readonly 'error.regionUnavailable': readonly ["区域图片不可用，请重新选择该区域", "The region image is unavailable. Select the region again."];
+    readonly 'error.pageNotReady': readonly ["页面尚未渲染完成", "The page has not finished rendering."];
+    readonly 'error.captureRegion': readonly ["无法截取页面区域", "Could not capture the page region."];
+    readonly 'error.encodeRegion': readonly ["无法生成区域图片", "Could not create the region image."];
+    readonly 'error.regionTooLarge': readonly ["区域图片过大，请缩小选区", "The region image is too large. Select a smaller region."];
+    readonly 'error.pageImageMismatch': readonly ["页面选区与截图不匹配", "The page selection does not match its screenshot."];
+    readonly 'error.cancelled': readonly ["添加已取消", "Adding the selection was cancelled."];
+    readonly 'error.imageRestoring': readonly ["页面截图尚未恢复，请稍候再发送", "The page screenshot is still being restored. Wait before sending."];
+    readonly 'error.imageDraftLost': readonly ["页面截图草稿已丢失，请重新框选", "The page screenshot draft is missing. Select the region again."];
+    readonly 'error.restoreImage': readonly ["无法恢复页面截图", "Could not restore the page screenshot."];
+    readonly 'error.restoreAttachmentRetry': readonly ["无法恢复页面截图附件，请移除此引用后重新框选", "Could not restore the screenshot attachment. Remove this reference and select the region again."];
+    readonly 'error.restoreAttachment': readonly ["无法恢复页面截图附件", "Could not restore the screenshot attachment."];
+    readonly 'error.storeOpen': readonly ["无法保存页面截图草稿", "Could not save the page screenshot draft."];
+    readonly 'error.storeWrite': readonly ["页面截图草稿存储失败", "Could not store the page screenshot draft."];
+};
+export type AnnotationErrorKey = keyof typeof errorCopy;
+export declare const errorZh: Record<AnnotationErrorKey, string>;
+export declare const errorEn: Record<AnnotationErrorKey, string>;
+//# sourceMappingURL=error-copy.d.ts.map

package/dist/types/client/error-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-copy.d.ts","sourceRoot":"","sources":["../../../src/client/error-copy.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DZ,CAAA;AAEV,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,SAAS,CAAA;AACvD,eAAO,MAAM,OAAO,EAAyF,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAA;AAC/I,eAAO,MAAM,OAAO,EAAyF,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAA"}

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

@@ -0,0 +1,10 @@
+import { type AnnotationErrorKey } from './error-copy.ts';
+export declare class AnnotationError extends Error {
+    readonly key: AnnotationErrorKey;
+    constructor(key: AnnotationErrorKey, options?: ErrorOptions);
+}
+export type AnnotationFailure = Error | string;
+export declare const annotationFailure: (error: unknown) => AnnotationFailure;
+/** Keep failure identity until render so an already-visible error follows language changes. */
+export declare function annotationErrorText(error: AnnotationFailure, t: (key: AnnotationErrorKey) => string): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/client/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAElE,qBAAa,eAAgB,SAAQ,KAAK;IAC5B,QAAQ,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,YAAY;CAIrE;AAED,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,CAAA;AAC9C,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,iBAAmE,CAAA;AAEtH,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,MAAM,GAAG,MAAM,CAE5G"}

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

@@ -0,0 +1,7 @@
+import type { PropsLocale, FileActionProps } from '../../host-contracts.ts';
+import type { ComposerBridge } from '../../host-contracts.ts';
+import { type FileKind } from './selection.ts';
+type ActionProps = FileActionProps & PropsLocale<'annotations'>;
+export declare function actionComponent(kind: FileKind, bridge: ComposerBridge): ({ content, useTabInfo, t }: ActionProps) => import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=FileSelectionAction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileSelectionAction.d.ts","sourceRoot":"","sources":["../../../../src/client/files/FileSelectionAction.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAqB,KAAK,QAAQ,EAAsB,MAAM,gBAAgB,CAAA;AAIrF,KAAK,WAAW,GAAG,eAAe,GAAG,WAAW,CAAC,aAAa,CAAC,CAAA;AAW/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,IAChC,4BAA4B,WAAW,wCAmI5E"}

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

@@ -0,0 +1,14 @@
+import { type ReactNode } from 'react';
+import type { PropsLocale } from '../../host-contracts.ts';
+import { type FileSnapshot } from './references.ts';
+export declare function SelectionCard({ items, draft, initiallyOpen, onRemove, onClear, onOpen, renderImage, renderText, t }: PropsLocale<'annotations'> & {
+    items: readonly FileSnapshot[];
+    draft?: boolean;
+    initiallyOpen?: boolean;
+    onRemove?: (index: number) => void;
+    onClear?: () => void;
+    onOpen?: (item: FileSnapshot) => void | Promise<void>;
+    renderImage?: (item: FileSnapshot) => ReactNode;
+    renderText?: (text: string) => ReactNode;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=SelectionCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionCard.d.ts","sourceRoot":"","sources":["../../../../src/client/files/SelectionCard.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAIxE,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,KAAa,EAAE,aAAqB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAyB,EAAE,CAAC,EAAE,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG;IAChL,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,SAAS,CAAA;IAC/C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAA;CACzC,sCAgCA"}

package/dist/types/client/files/document-workflow.d.ts

@@ -0,0 +1,34 @@
+import type { ComposerBridge } from '../../host-contracts.ts';
+import type { DocumentAnnotationSnapshot } from './references.ts';
+import type { PageSnapshot } from './pages/snapshot.ts';
+import { PageBatches } from './pages/batches.ts';
+/** Document callers cannot insert or submit the unrelated Composer draft. */
+export type DocumentAnnotationBridge = Pick<ComposerBridge, 'targetKey' | 'subscribe' | 'sendPages'>;
+export interface DocumentScope {
+    readonly session: string;
+    readonly address: string;
+}
+export type DocumentCommit = {
+    readonly kind: 'batch';
+    readonly snapshot: DocumentAnnotationSnapshot;
+    readonly image?: File | undefined;
+} | {
+    readonly kind: 'presentation-request';
+    readonly snapshot: PageSnapshot;
+    readonly image?: never;
+};
+/** One owner for durable saves, independent sends, retries and exact-batch acknowledgement. */
+export declare class DocumentWorkflow {
+    private readonly bridge;
+    private readonly batches;
+    readonly canSend: boolean;
+    private readonly sender;
+    private readonly active;
+    constructor(bridge: DocumentAnnotationBridge, batches: PageBatches);
+    private assertScope;
+    private exclusive;
+    commit(scope: DocumentScope, request: DocumentCommit, signal: AbortSignal): Promise<void>;
+    send(scope: DocumentScope, signal: AbortSignal): Promise<void>;
+    remove(scope: DocumentScope, ids: readonly string[], signal: AbortSignal): Promise<void>;
+}
+//# sourceMappingURL=document-workflow.d.ts.map

package/dist/types/client/files/document-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-workflow.d.ts","sourceRoot":"","sources":["../../../../src/client/files/document-workflow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,6EAA6E;AAC7E,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC,CAAA;AACpG,MAAM,WAAW,aAAa;IAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACrF,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;CAAE,GAC5G;IAAE,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAEtG,+FAA+F;AAC/F,qBAAa,gBAAgB;IAKf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAA4B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJvF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAEd,MAAM,EAAE,wBAAwB,EAAmB,OAAO,EAAE,WAAW;IAKpG,OAAO,CAAC,WAAW;YAKL,SAAS;IAQjB,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW;IAczE,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW;IAc9C,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW;CAG/E"}

package/dist/types/client/files/pages/DocumentChrome.d.ts

@@ -0,0 +1,30 @@
+import { type CSSProperties, type RefObject } from 'react';
+import type { PropsLocale } from '../../../host-contracts.ts';
+type Translate = PropsLocale<'annotations'>['t'];
+export declare function RequestIcon(): import("react").JSX.Element;
+export declare function CommentEditor({ t, style, input, comment, setComment, busy, saved, direct, save, cancel, remove, optional }: {
+    t: Translate;
+    style: CSSProperties;
+    input: RefObject<HTMLTextAreaElement>;
+    comment: string;
+    setComment: (value: string) => void;
+    busy: boolean;
+    saved: boolean;
+    direct?: boolean;
+    save: () => void;
+    cancel: () => void;
+    remove: () => void;
+    optional?: boolean;
+}): import("react").JSX.Element;
+export declare function BatchControls({ t, bounds, count, busy, sendDisabled, cancel, send, review }: {
+    t: Translate;
+    bounds: DOMRect;
+    count: number;
+    busy: boolean;
+    sendDisabled: boolean;
+    cancel: () => void;
+    send: () => void;
+    review?: () => void;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=DocumentChrome.d.ts.map

package/dist/types/client/files/pages/DocumentChrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentChrome.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/pages/DocumentChrome.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAG7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAG7D,KAAK,SAAS,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAA;AAChD,wBAAgB,WAAW,gCAI1B;AACD,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAgB,EAAE,EAAE;IACnI,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/H,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAA;IACzG,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,+BAwBA;AAED,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAC5F,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,IAAI,CAAA;IACxH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB,+BAuBA"}

package/dist/types/client/files/pages/PageSelectionAction.d.ts

@@ -0,0 +1,7 @@
+import type { PropsLocale } from '../../../host-contracts.ts';
+import { type DocumentAnnotationBridge } from '../document-workflow.ts';
+import { PageBatches } from './batches.ts';
+export declare function pageActionComponent(bridge: DocumentAnnotationBridge, batches?: PageBatches): ({ absolutePath, t }: PropsLocale<"annotations"> & {
+    absolutePath: string;
+}) => import("react").JSX.Element | null;
+//# sourceMappingURL=PageSelectionAction.d.ts.map

package/dist/types/client/files/pages/PageSelectionAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageSelectionAction.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/pages/PageSelectionAction.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAoB,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAEzF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAe1C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,wBAAwB,EAAE,OAAO,cAAoB,IAE3D,qBAAqB,WAAW,CAAC,aAAa,CAAC,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,wCAmO/G"}

package/dist/types/client/files/pages/batches.d.ts

@@ -0,0 +1,21 @@
+import { type PageImageStore } from './image-store.ts';
+import type { DocumentAnnotationSnapshot } from '../references.ts';
+/** Document requests are separate from Composer drafts and scoped to session + source. */
+export declare class PageBatches {
+    private images;
+    private storage;
+    private namespace;
+    private revision;
+    private listeners;
+    constructor(images?: PageImageStore, storage?: () => Storage, namespace?: string);
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => number;
+    private key;
+    read(session: string, address: string): readonly DocumentAnnotationSnapshot[];
+    private write;
+    save(session: string, snapshot: DocumentAnnotationSnapshot, image?: File, signal?: AbortSignal): Promise<void>;
+    remove(session: string, address: string, ids: readonly string[]): Promise<void>;
+    acknowledge(session: string, address: string, sent: readonly DocumentAnnotationSnapshot[]): Promise<void>;
+    files(items: readonly DocumentAnnotationSnapshot[], signal: AbortSignal): Promise<File[]>;
+}
+//# sourceMappingURL=batches.d.ts.map

package/dist/types/client/files/pages/batches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batches.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/pages/batches.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAElE,0FAA0F;AAC1F,qBAAa,WAAW;IAGV,OAAO,CAAC,MAAM;IAAqC,OAAO,CAAC,OAAO;IAAsC,OAAO,CAAC,SAAS;IAFrI,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,SAAS,CAAwB;gBACrB,MAAM,GAAE,cAAiC,EAAU,OAAO,GAAE,MAAM,OAA4B,EAAU,SAAS,SAA2C;IAChL,SAAS,GAAI,UAAU,MAAM,IAAI,gBAAuF;IACxH,WAAW,eAAsB;IACjC,OAAO,CAAC,GAAG;IACX,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,0BAA0B,EAAE;IAY7E,OAAO,CAAC,KAAK;IAQP,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW;IAkB9F,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE;IAM/D,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,0BAA0B,EAAE;IAKzF,KAAK,CAAC,KAAK,EAAE,SAAS,0BAA0B,EAAE,EAAE,MAAM,EAAE,WAAW;CAY9E"}

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

@@ -0,0 +1,16 @@
+import type { PageRect, PageSnapshot } from './snapshot.ts';
+export type Box = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    right: number;
+    bottom: number;
+};
+export type Anchor = NonNullable<PageSnapshot['anchors']>[number];
+export declare function normalizeRect(rect: Box, page: Box): PageRect | undefined;
+export declare function pageBounds(preview: HTMLElement, page: number): DOMRect | undefined;
+export declare function rangeAnchors(range: Range, preview: HTMLElement): Anchor[];
+export declare function projectAnchors(anchors: readonly Anchor[], preview: HTMLElement): Box[];
+export declare function enclosing(boxes: readonly Box[]): Box | undefined;
+//# sourceMappingURL=geometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/pages/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC3D,MAAM,MAAM,GAAG,GAAG;IAAE,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,CAAA;AAC7G,MAAM,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AACjE,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,QAAQ,GAAG,SAAS,CAKxE;AACD,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,uBAG5D;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAgBzE;AACD,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,GAAG,EAAE,CAQtF;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,GAAG,SAAS,CAKhE"}

package/dist/types/client/files/pages/image-store.d.ts

@@ -0,0 +1,8 @@
+/** Binary draft snapshots live in IndexedDB, never in prompt text or Lexical JSON. */
+export interface PageImageStore {
+    put(key: string, file: File): Promise<void>;
+    get(key: string, name: string): Promise<File | undefined>;
+    remove(key: string): Promise<void>;
+}
+export declare function pageImageStore(databaseName?: string): PageImageStore;
+//# sourceMappingURL=image-store.d.ts.map

package/dist/types/client/files/pages/image-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-store.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/pages/image-store.ts"],"names":[],"mappings":"AACA,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAA;IACzD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAED,wBAAgB,cAAc,CAAC,YAAY,SAAmC,GAAG,cAAc,CA6B9F"}

package/dist/types/client/files/pages/images.d.ts

@@ -0,0 +1,41 @@
+import { type AnnotationFailure } from '../../errors.ts';
+import type { SessionId } from '../../../host-contracts.ts';
+import type { DraftAttachmentId, InputActions, InputState } from '../../../host-contracts.ts';
+import { type DraftFactory } from '../../composer/attachments.ts';
+import { type FileSnapshot } from '../references.ts';
+import { type PageImageStore } from './image-store.ts';
+import type { PageSnapshot } from './snapshot.ts';
+interface Entry {
+    session: SessionId;
+    snapshot: PageSnapshot;
+    ids: readonly DraftAttachmentId[];
+    factory: DraftFactory;
+    file?: File;
+    url?: string;
+    error?: AnnotationFailure;
+    staged: boolean;
+}
+/** Own screenshot admission together with its semantic reference, including undo and restoration. */
+export declare class PageImages {
+    private readonly store;
+    private entries;
+    private listeners;
+    private revision;
+    private disposed;
+    constructor(store?: PageImageStore);
+    readonly subscribe: (listener: () => void) => () => void;
+    readonly getSnapshot: () => number;
+    private changed;
+    preview(snapshot: FileSnapshot): Entry | undefined;
+    save(snapshot: PageSnapshot, file: File, signal?: AbortSignal): Promise<void>;
+    stage(session: SessionId, snapshot: PageSnapshot, file: File, factory: DraftFactory, ids: readonly DraftAttachmentId[]): void;
+    activate(id: string): void;
+    validate(snapshot: FileSnapshot): void;
+    imageIdsFor(input: InputState | undefined): Set<string>;
+    reconcile(session: SessionId, input: InputState, actions: InputActions, factory: DraftFactory): void;
+    discard(id: string): void;
+    cancel(id: string): Promise<void>;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=images.d.ts.map

package/dist/types/client/files/pages/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/pages/images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAC7F,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC9E,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,UAAU,KAAK;IACb,OAAO,EAAE,SAAS,CAAA;IAClB,QAAQ,EAAE,YAAY,CAAA;IACtB,GAAG,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACjC,OAAO,EAAE,YAAY,CAAA;IACrB,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,qGAAqG;AACrG,qBAAa,UAAU;IAKT,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,QAAQ,CAAQ;gBACK,KAAK,GAAE,cAAiC;IACrE,QAAQ,CAAC,SAAS,GAAI,UAAU,MAAM,IAAI,gBAAuF;IACjI,QAAQ,CAAC,WAAW,eAAsB;IAC1C,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ,EAAE,YAAY;IAExB,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW;IAMnE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,iBAAiB,EAAE;IAGtH,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,QAAQ,EAAE,YAAY;IAO/B,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS;IAGzC,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY;IA2C7F,OAAO,CAAC,EAAE,EAAE,MAAM;IAKZ,MAAM,CAAC,EAAE,EAAE,MAAM;IACvB,OAAO;CAKR"}

package/dist/types/client/files/pages/interaction.d.ts

@@ -0,0 +1,55 @@
+import type { AnnotationFailure } from '../../errors.ts';
+/** Mutually exclusive UI phases; a pending commit always retains its editable snapshot. */
+export type PageInteraction<Selection, Draft> = {
+    readonly phase: 'idle';
+    readonly error: AnnotationFailure;
+} | {
+    readonly phase: 'selected';
+    readonly selection: Selection;
+    readonly error: AnnotationFailure;
+} | {
+    readonly phase: 'editing';
+    readonly draft: Draft;
+    readonly comment: string;
+    readonly error: AnnotationFailure;
+} | {
+    readonly phase: 'submitting';
+    readonly operation: 'commit' | 'edit-remove';
+    readonly draft: Draft;
+    readonly comment: string;
+    readonly token: number;
+    readonly error: '';
+} | {
+    readonly phase: 'submitting';
+    readonly operation: 'batch-send' | 'batch-remove';
+    readonly token: number;
+    readonly error: '';
+    readonly draft?: never;
+    readonly comment?: never;
+};
+export type PageInteractionEvent<Selection, Draft> = {
+    readonly type: 'select';
+    readonly selection?: Selection | undefined;
+} | {
+    readonly type: 'edit';
+    readonly draft: Draft;
+    readonly comment: string;
+} | {
+    readonly type: 'comment';
+    readonly value: string;
+} | {
+    readonly type: 'cancel';
+} | {
+    readonly type: 'start';
+    readonly operation: 'commit' | 'batch-send' | 'batch-remove';
+    readonly token: number;
+} | {
+    readonly type: 'complete';
+    readonly token: number;
+} | {
+    readonly type: 'fail';
+    readonly token: number;
+    readonly error: AnnotationFailure;
+};
+export declare function pageInteraction<Selection, Draft>(state: PageInteraction<Selection, Draft>, event: PageInteractionEvent<Selection, Draft>): PageInteraction<Selection, Draft>;
+//# sourceMappingURL=interaction.d.ts.map

package/dist/types/client/files/pages/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/pages/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,2FAA2F;AAC3F,MAAM,MAAM,eAAe,CAAC,SAAS,EAAE,KAAK,IACxC;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAChG;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACjH;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAA;CAAE,GAC3K;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAErL,MAAM,MAAM,oBAAoB,CAAC,SAAS,EAAE,KAAK,IAC7C;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,YAAY,GAAG,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChH;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAExF,wBAAgB,eAAe,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAqB5K"}

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

@@ -0,0 +1,25 @@
+import type { PageRect } from './snapshot.ts';
+/** Read only PDF text-layer nodes; canvas labels and toolbar text are not evidence. */
+export declare function readPageText(range: Range, preview: HTMLElement): {
+    startPage: number;
+    endPage: number;
+    text: string;
+} | undefined;
+export declare function pageRegion(start: {
+    x: number;
+    y: number;
+}, end: {
+    x: number;
+    y: number;
+}, bounds: DOMRect): PageRect | undefined;
+/** Crop the page's existing backing pixels, excluding selection chrome and the app UI. */
+export declare function capturePageRegion(canvas: HTMLCanvasElement, rect: PageRect, key: string, signal: AbortSignal): Promise<{
+    image: {
+        key: string;
+        name: string;
+        width: number;
+        height: number;
+    };
+    file: File;
+}>;
+//# sourceMappingURL=selection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/pages/selection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW;;;;cAkB9D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAQhI;AAED,0FAA0F;AAC1F,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;;;;;;;;GAiBlH"}

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

@@ -0,0 +1,31 @@
+/** Page coordinates are normalized to the rendered page, independent of zoom. */
+export type PageRect = {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+};
+export interface PageSnapshot {
+    readonly version: 2;
+    readonly id: string;
+    readonly address: string;
+    readonly kind: 'pdf' | 'office';
+    readonly text: string;
+    readonly startPage: number;
+    readonly endPage: number;
+    readonly comment?: string;
+    readonly anchors?: readonly {
+        readonly page: number;
+        readonly rect: PageRect;
+    }[];
+    readonly region?: PageRect;
+    readonly image?: {
+        readonly key: string;
+        readonly name: string;
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export declare function isPageSnapshot(value: Record<string, unknown>): boolean;
+export declare function validPageRect(value: unknown): value is PageRect;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../../src/client/files/pages/snapshot.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAClH,MAAM,WAAW,YAAY;IAC3B,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,KAAK,GAAG,QAAQ,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,EAAE,CAAA;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAClH;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAkBtE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAM/D"}

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

@@ -0,0 +1,80 @@
+import type { InputState, ReferenceInsert, TokenSpan } from '../../host-contracts.ts';
+import type { FileKind, FileSelection } from './selection.ts';
+import { type PageSnapshot } from './pages/snapshot.ts';
+import { type SpreadsheetSnapshot } from './sheets/snapshot.ts';
+export declare const FILE_SELECTION_SOURCE = "aione-file-selections";
+export declare const MAX_SELECTION_BYTES: number;
+export interface TextSnapshot extends FileSelection {
+    readonly version: 1;
+    readonly id: string;
+    readonly address: string;
+    readonly kind: FileKind;
+}
+export type DocumentAnnotationSnapshot = PageSnapshot | SpreadsheetSnapshot;
+export type FileSnapshot = TextSnapshot | DocumentAnnotationSnapshot;
+export declare function decodeFileReference(ref: string): FileSnapshot | undefined;
+export declare function fileLocation(snapshot: FileSnapshot): string;
+export declare function filePath(snapshot: FileSnapshot): string;
+export declare function fileLabel(snapshot: FileSnapshot): string;
+/** The reference carries text and location; region pixels have a separate durable draft store. */
+export declare function fileReference(snapshot: FileSnapshot): ReferenceInsert;
+export declare function assertFileDraftCapacity(input: InputState, ref: string): void;
+export declare function serializeFileReference(ref: string, signal: AbortSignal): {
+    text: string;
+    presentation: {
+        source: string;
+        summary: string;
+        data: {
+            version: 1;
+            id: string;
+            address: string;
+            kind: FileKind;
+            text: string;
+            startLine: number;
+            endLine: number;
+            startColumn?: number;
+            endColumn?: number;
+        } | {
+            version: 2;
+            id: string;
+            address: string;
+            kind: "pdf" | "office";
+            text: string;
+            startPage: number;
+            endPage: number;
+            comment?: string;
+            anchors?: readonly {
+                readonly page: number;
+                readonly rect: import("./pages/snapshot.ts").PageRect;
+            }[];
+            region?: import("./pages/snapshot.ts").PageRect;
+            image?: {
+                readonly key: string;
+                readonly name: string;
+                readonly width: number;
+                readonly height: number;
+            };
+        } | {
+            version: 3;
+            id: string;
+            address: string;
+            kind: "xlsx" | "csv";
+            sheet: {
+                id: string;
+                name: string;
+            };
+            range: import("./sheets/snapshot.ts").SheetRange;
+            a1: string;
+            cells: readonly import("./sheets/snapshot.ts").SheetCell[];
+            merges: readonly import("./sheets/snapshot.ts").SheetMerge[];
+            text: string;
+            comment?: string;
+        };
+    };
+};
+export declare function readSentFile(block: unknown): FileSnapshot | undefined;
+export declare function selectedFiles(input: InputState): {
+    snapshot: FileSnapshot;
+    span: TokenSpan;
+}[];
+//# sourceMappingURL=references.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/client/files/references.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAErF,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvE,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAExF,eAAO,MAAM,qBAAqB,0BAA0B,CAAA;AAC5D,eAAO,MAAM,mBAAmB,QAAY,CAAA;AAK5C,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,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,QAAQ,CAAA;CACxB;AACD,MAAM,MAAM,0BAA0B,GAAG,YAAY,GAAG,mBAAmB,CAAA;AAC3E,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,0BAA0B,CAAA;AAsCpE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGzE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAI3D;AACD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEvD;AACD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAExD;AAED,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,eAAe,CAKrE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAK5E;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;;;;;;qBA5EnD,CAAC;gBACN,MAAM;qBACD,MAAM;kBACT,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuFxB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAIrE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU;;;IAS9C"}