@a3s-lab/office 0.2.2 → 0.4.0

package/dist/9787.js

@@ -0,0 +1,209 @@
+import * as __rspack_external_yjs from "yjs";
+const WORK_OFFICE_COLLABORATION_PROTOCOL = 'a3s.office.collaboration';
+const WORK_OFFICE_COLLABORATION_VERSION = 1;
+const WORK_OFFICE_COLLABORATION_NAMESPACE = 'a3s.office';
+class WorkOfficeCollaborationError extends Error {
+    code;
+    constructor(code, message){
+        super(message);
+        this.name = 'WorkOfficeCollaborationError';
+        this.code = code;
+    }
+}
+class WorkOfficeCollaborationSessionImpl {
+    artifactId;
+    kind;
+    document;
+    awareness;
+    actor;
+    mode;
+    namespace;
+    ownsDocument;
+    localOrigin;
+    #destroyed = false;
+    constructor(options){
+        this.artifactId = normalizedIdentifier(options.artifactId, 'artifact ID');
+        this.kind = normalizedArtifactKind(options.kind);
+        this.document = options.document ?? new __rspack_external_yjs.Doc();
+        this.awareness = options.awareness;
+        this.actor = options.actor ? normalizedActor(options.actor) : void 0;
+        this.mode = normalizedMode(options.mode ?? 'edit');
+        this.namespace = normalizedNamespace(options.namespace ?? WORK_OFFICE_COLLABORATION_NAMESPACE);
+        this.ownsDocument = void 0 === options.document;
+        this.localOrigin = this.createOrigin(this.actor?.kind === 'agent' ? 'agent' : this.actor?.kind === 'system' ? 'system' : 'editor');
+        assertSessionMetadata(this);
+    }
+    metadata() {
+        this.ensureActive();
+        return readWorkOfficeCollaborationMetadata(this);
+    }
+    rootName(suffix) {
+        this.ensureActive();
+        const normalized = normalizedRootSuffix(suffix);
+        return `${this.namespace}.${normalized}`;
+    }
+    createOrigin(kind, operationId) {
+        this.ensureActive();
+        const normalizedKind = normalizedOriginKind(kind);
+        return Object.freeze({
+            protocol: WORK_OFFICE_COLLABORATION_PROTOCOL,
+            kind: normalizedKind,
+            actorId: this.actor?.id,
+            operationId: void 0 === operationId ? void 0 : normalizedIdentifier(operationId, 'operation ID')
+        });
+    }
+    transact(operation, origin = this.localOrigin) {
+        this.ensureActive();
+        assertWorkOfficeCollaborationEditable(this);
+        assertWorkOfficeCollaborationOrigin(origin);
+        let result;
+        this.document.transact((transaction)=>{
+            result = operation(transaction);
+        }, origin);
+        return result;
+    }
+    destroy() {
+        if (this.#destroyed) return;
+        this.#destroyed = true;
+        if (this.ownsDocument) this.document.destroy();
+    }
+    ensureActive() {
+        if (!this.#destroyed) return;
+        throw new WorkOfficeCollaborationError('office.collaboration.session_destroyed', 'The Office collaboration session has been destroyed.');
+    }
+}
+function createWorkOfficeCollaborationSession(options) {
+    return new WorkOfficeCollaborationSessionImpl(options);
+}
+function readWorkOfficeCollaborationMetadata(session) {
+    const metadata = session.document.getMap(session.rootName('metadata'));
+    if (0 === metadata.size) {
+        if (collaborationInitializers(session).length > 0) throw new WorkOfficeCollaborationError('office.collaboration.metadata_missing', 'The shared document contains bootstrap state without Office collaboration metadata.');
+        return null;
+    }
+    const protocol = metadata.get('protocol');
+    const version = metadata.get('version');
+    const artifactId = metadata.get('artifactId');
+    const kind = metadata.get('kind');
+    const initialized = metadata.get('initialized');
+    if (protocol !== WORK_OFFICE_COLLABORATION_PROTOCOL || version !== WORK_OFFICE_COLLABORATION_VERSION || 'string' != typeof artifactId || !isWorkArtifactKind(kind) || 'boolean' != typeof initialized) throw new WorkOfficeCollaborationError('office.collaboration.metadata_invalid', 'The shared document contains invalid or unsupported Office collaboration metadata.');
+    const result = {
+        protocol,
+        version,
+        artifactId,
+        kind,
+        initialized
+    };
+    assertMetadataMatches(session, result);
+    assertBootstrapState(session, result);
+    return result;
+}
+function initializeWorkOfficeCollaborationMetadata(session) {
+    const existing = readWorkOfficeCollaborationMetadata(session);
+    if (existing) {
+        assertMetadataMatches(session, existing);
+        return existing;
+    }
+    const metadata = session.document.getMap(session.rootName('metadata'));
+    metadata.set('protocol', WORK_OFFICE_COLLABORATION_PROTOCOL);
+    metadata.set('version', WORK_OFFICE_COLLABORATION_VERSION);
+    metadata.set('artifactId', session.artifactId);
+    metadata.set('kind', session.kind);
+    metadata.set('initialized', false);
+    return {
+        protocol: WORK_OFFICE_COLLABORATION_PROTOCOL,
+        version: WORK_OFFICE_COLLABORATION_VERSION,
+        artifactId: session.artifactId,
+        kind: session.kind,
+        initialized: false
+    };
+}
+function markWorkOfficeCollaborationInitialized(session) {
+    const metadata = readWorkOfficeCollaborationMetadata(session);
+    if (!metadata) throw new WorkOfficeCollaborationError('office.collaboration.metadata_missing', 'Office collaboration metadata must be initialized before its content.');
+    assertMetadataMatches(session, metadata);
+    session.document.getMap(session.rootName('metadata')).set('initialized', true);
+}
+function registerWorkOfficeCollaborationInitializer(session) {
+    const initializers = collaborationInitializers(session);
+    if (initializers.length > 0) throw new WorkOfficeCollaborationError('office.collaboration.bootstrap_ambiguous', 'The shared document already contains an Office collaboration initializer.');
+    initializers.push([
+        `${session.document.clientID}:${session.actor?.id ?? 'anonymous'}`
+    ]);
+}
+function assertWorkOfficeCollaborationEditable(session) {
+    if ('edit' === session.mode) return;
+    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', `The '${session.mode}' collaboration mode cannot modify canonical content.`);
+}
+function assertSessionMetadata(session) {
+    readWorkOfficeCollaborationMetadata(session);
+}
+function assertBootstrapState(session, metadata) {
+    const count = collaborationInitializers(session).length;
+    if (count > 1) throw new WorkOfficeCollaborationError('office.collaboration.bootstrap_ambiguous', 'Multiple clients initialized the shared document before synchronization completed.');
+    if (metadata.initialized && 1 !== count) throw new WorkOfficeCollaborationError('office.collaboration.bootstrap_invalid', 'Initialized Office collaboration metadata must have exactly one initializer.');
+}
+function collaborationInitializers(session) {
+    return session.document.getArray(session.rootName('bootstrap.initializers'));
+}
+function assertMetadataMatches(session, metadata) {
+    if (metadata.artifactId !== session.artifactId) throw new WorkOfficeCollaborationError('office.collaboration.artifact_mismatch', `The shared document belongs to artifact '${metadata.artifactId}', not '${session.artifactId}'.`);
+    if (metadata.kind !== session.kind) throw new WorkOfficeCollaborationError('office.collaboration.kind_mismatch', `The shared document contains '${metadata.kind}' content, not '${session.kind}'.`);
+}
+function normalizedIdentifier(value, label) {
+    if ('string' != typeof value) throw new WorkOfficeCollaborationError('office.collaboration.identifier_invalid', `The ${label} must be a string containing between 1 and 256 characters.`);
+    const normalized = value.trim();
+    if (!normalized || normalized.length > 256) throw new WorkOfficeCollaborationError('office.collaboration.identifier_invalid', `The ${label} must contain between 1 and 256 characters.`);
+    return normalized;
+}
+function assertWorkOfficeCollaborationOrigin(origin) {
+    if (!origin || origin.protocol !== WORK_OFFICE_COLLABORATION_PROTOCOL) throw new WorkOfficeCollaborationError('office.collaboration.origin_invalid', 'Office collaboration transactions require a versioned collaboration origin.');
+    normalizedOriginKind(origin.kind);
+    if (void 0 !== origin.actorId) normalizedIdentifier(origin.actorId, 'origin actor ID');
+    if (void 0 !== origin.operationId) normalizedIdentifier(origin.operationId, 'operation ID');
+}
+function normalizedActor(actor) {
+    const kind = actor.kind ?? 'human';
+    if ('human' !== kind && 'agent' !== kind && 'system' !== kind) throw new WorkOfficeCollaborationError('office.collaboration.actor_invalid', `The collaboration actor kind '${String(kind)}' is invalid.`);
+    return Object.freeze({
+        id: normalizedIdentifier(actor.id, 'actor ID'),
+        name: normalizedIdentifier(actor.name, 'actor name'),
+        color: normalizedOptionalActorField(actor.color, 'color', 64),
+        avatarUrl: normalizedOptionalActorField(actor.avatarUrl, 'avatar URL', 2048),
+        kind
+    });
+}
+function normalizedOptionalActorField(value, label, maximumLength) {
+    if (void 0 === value) return;
+    if ('string' != typeof value) throw new WorkOfficeCollaborationError('office.collaboration.actor_invalid', `The collaboration actor ${label} must be a string when provided.`);
+    const normalized = value.trim();
+    if (!normalized || normalized.length > maximumLength) throw new WorkOfficeCollaborationError('office.collaboration.actor_invalid', `The collaboration actor ${label} must contain between 1 and ${maximumLength} characters.`);
+    return normalized;
+}
+function normalizedArtifactKind(value) {
+    if (isWorkArtifactKind(value)) return value;
+    throw new WorkOfficeCollaborationError('office.collaboration.kind_invalid', `The collaboration artifact kind '${String(value)}' is invalid.`);
+}
+function normalizedMode(value) {
+    if ('view' === value || 'comment' === value || 'suggest' === value || 'edit' === value) return value;
+    throw new WorkOfficeCollaborationError('office.collaboration.mode_invalid', `The collaboration mode '${String(value)}' is invalid.`);
+}
+function normalizedOriginKind(value) {
+    if ('bootstrap' === value || 'editor' === value || 'agent' === value || 'import' === value || 'system' === value) return value;
+    throw new WorkOfficeCollaborationError('office.collaboration.origin_invalid', `The collaboration origin kind '${String(value)}' is invalid.`);
+}
+function normalizedNamespace(value) {
+    const normalized = normalizedIdentifier(value, 'namespace');
+    if (!/^[a-zA-Z0-9](?:[a-zA-Z0-9._-]*[a-zA-Z0-9])?$/.test(normalized)) throw new WorkOfficeCollaborationError('office.collaboration.namespace_invalid', 'The collaboration namespace may contain only letters, digits, dots, underscores, and hyphens.');
+    return normalized;
+}
+function normalizedRootSuffix(value) {
+    if ('string' != typeof value) throw new WorkOfficeCollaborationError('office.collaboration.root_invalid', 'The collaboration root suffix must be a string.');
+    const normalized = value.trim();
+    if (!/^[a-z][a-z0-9.-]*$/.test(normalized)) throw new WorkOfficeCollaborationError('office.collaboration.root_invalid', `The collaboration root suffix '${value}' is invalid.`);
+    return normalized;
+}
+function isWorkArtifactKind(value) {
+    return 'document' === value || 'markdown' === value || 'spreadsheet' === value || 'presentation' === value || 'pdf' === value;
+}
+export { WORK_OFFICE_COLLABORATION_NAMESPACE as OFFICE_COLLABORATION_NAMESPACE, WORK_OFFICE_COLLABORATION_PROTOCOL as OFFICE_COLLABORATION_PROTOCOL, WorkOfficeCollaborationError as OfficeCollaborationError, assertWorkOfficeCollaborationEditable, assertWorkOfficeCollaborationOrigin, createWorkOfficeCollaborationSession as createOfficeCollaborationSession, initializeWorkOfficeCollaborationMetadata, markWorkOfficeCollaborationInitialized, readWorkOfficeCollaborationMetadata as readOfficeCollaborationMetadata, registerWorkOfficeCollaborationInitializer };

package/dist/core.d.ts

@@ -1,15 +1,35 @@
-export { createWorkArtifact as createArtifact, createWorkId as createOfficeId, WORK_TEMPLATES as officeTemplates, } from './internal/features/work/work-templates';
-export { createWorkArtifactBlob as createArtifactBlob, exportWorkArtifact as downloadArtifact, importWorkFile as importOfficeFile, WORK_IMPORT_ACCEPT as OFFICE_FILE_ACCEPT, workKindForFile as officeKindForFile, } from './internal/features/work/work-file-io';
-export type { WorkArtifactExportOptions as ArtifactExportOptions } from './internal/features/work/work-file-io';
-export { defaultPptxRuntimeUrl } from './internal/features/work/work-presentation-file-io';
-export { forgetWorkSourceBlob as forgetSourceBlob, readWorkSourceBlob as readSourceBlob, rememberWorkSourceBlob as registerSourceBlob, } from './internal/features/work/work-repository';
-export { exportWorkArtifactPdf as downloadArtifactPdf, type WorkPdfExportOptions as PdfExportOptions, workPdfPagesForExport as pdfPagesForExport, } from './internal/features/work/work-pdf-export';
-export { OFFICE_NOTIFICATION_EVENT, type OfficeNotification, type OfficeNotificationTone, subscribeOfficeNotifications, } from './internal/state/app-state';
-export { createWorkAgentProposalRequest as createAgentProposalRequest, WORK_AGENT_PROPOSAL_PROTOCOL as AGENT_PROPOSAL_PROTOCOL, workAgentProposalInstruction as createAgentProposalInstruction, workAgentProposalStatus as getAgentProposalStatus, } from './internal/features/work/work-agent-proposal';
+export type { WorkOfficeCollaborationActor as OfficeCollaborationActor, WorkOfficeCollaborationActorKind as OfficeCollaborationActorKind, WorkOfficeCollaborationAwareness as OfficeCollaborationAwareness, WorkOfficeCollaborationErrorCode as OfficeCollaborationErrorCode, WorkOfficeCollaborationMetadata as OfficeCollaborationMetadata, WorkOfficeCollaborationMode as OfficeCollaborationMode, WorkOfficeCollaborationOrigin as OfficeCollaborationOrigin, WorkOfficeCollaborationOriginKind as OfficeCollaborationOriginKind, WorkOfficeCollaborationSession as OfficeCollaborationSession, WorkOfficeCollaborationSessionOptions as OfficeCollaborationSessionOptions, } from './internal/collaboration/office-collaboration';
+export { createWorkOfficeCollaborationSession as createOfficeCollaborationSession, readWorkOfficeCollaborationMetadata as readOfficeCollaborationMetadata, WORK_OFFICE_COLLABORATION_NAMESPACE as OFFICE_COLLABORATION_NAMESPACE, WORK_OFFICE_COLLABORATION_PROTOCOL as OFFICE_COLLABORATION_PROTOCOL, WORK_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION, WorkOfficeCollaborationError as OfficeCollaborationError, } from './internal/collaboration/office-collaboration';
+export type { WorkOfficeCollaborationParticipant as OfficeCollaborationParticipant, WorkOfficeCollaborationPresence as OfficeCollaborationPresence, WorkOfficeCollaborationPresenceActivity as OfficeCollaborationPresenceActivity, WorkOfficeCollaborationPresenceActor as OfficeCollaborationPresenceActor, WorkOfficeCollaborationPresenceLocation as OfficeCollaborationPresenceLocation, WorkOfficeCollaborationPresenceSnapshot as OfficeCollaborationPresenceSnapshot, WorkOfficeCollaborationPresenceState as OfficeCollaborationPresenceState, WorkOfficeCollaborationPresenceUpdate as OfficeCollaborationPresenceUpdate, WorkOfficeDocumentPresenceLocation as OfficeDocumentPresenceLocation, WorkOfficeMarkdownPresenceLocation as OfficeMarkdownPresenceLocation, WorkOfficePdfPresenceLocation as OfficePdfPresenceLocation, WorkOfficePresentationPresenceLocation as OfficePresentationPresenceLocation, WorkOfficeSpreadsheetPresenceCell as OfficeSpreadsheetPresenceCell, WorkOfficeSpreadsheetPresenceLocation as OfficeSpreadsheetPresenceLocation, WorkOfficeSpreadsheetPresenceRange as OfficeSpreadsheetPresenceRange, WorkOfficeTextPresenceLocation as OfficeTextPresenceLocation, } from './internal/collaboration/office-collaboration-presence';
+export { createWorkOfficeCollaborationPresence as createOfficeCollaborationPresence, WORK_OFFICE_COLLABORATION_PRESENCE_FIELD as OFFICE_COLLABORATION_PRESENCE_FIELD, } from './internal/collaboration/office-collaboration-presence';
+export type { WorkOfficeCollaborationTransport as OfficeCollaborationTransport, WorkOfficeCollaborationTransportBinding as OfficeCollaborationTransportBinding, WorkOfficeCollaborationTransportBindingOptions as OfficeCollaborationTransportBindingOptions, WorkOfficeCollaborationTransportMessage as OfficeCollaborationTransportMessage, WorkOfficeCollaborationTransportMessageType as OfficeCollaborationTransportMessageType, } from './internal/collaboration/office-collaboration-transport';
+export { createWorkOfficeCollaborationTransportBinding as createOfficeCollaborationTransportBinding, WORK_OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES as OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES, WORK_OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES as OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES, } from './internal/collaboration/office-collaboration-transport';
+export type { WorkOfficeDocumentCollaborationBinding as OfficeDocumentCollaborationBinding, WorkOfficeDocumentCollaborationBindingOptions as OfficeDocumentCollaborationBindingOptions, WorkOfficeDocumentCollaborationChange as OfficeDocumentCollaborationChange, } from './internal/collaboration/office-document-collaboration';
+export { createWorkOfficeDocumentCollaborationBinding as createOfficeDocumentCollaborationBinding, initializeWorkOfficeDocumentCollaboration as initializeOfficeDocumentCollaboration, readWorkOfficeDocumentCollaboration as readOfficeDocumentCollaboration, workOfficeDocumentCollaborationFragment as officeDocumentCollaborationFragment, } from './internal/collaboration/office-document-collaboration';
+export type { WorkOfficeMarkdownCollaborationBinding as OfficeMarkdownCollaborationBinding, WorkOfficeMarkdownCollaborationBindingOptions as OfficeMarkdownCollaborationBindingOptions, WorkOfficeMarkdownCollaborationChange as OfficeMarkdownCollaborationChange, } from './internal/collaboration/office-markdown-collaboration';
+export { createWorkOfficeMarkdownCollaborationBinding as createOfficeMarkdownCollaborationBinding, initializeWorkOfficeMarkdownCollaboration as initializeOfficeMarkdownCollaboration, readWorkOfficeMarkdownCollaboration as readOfficeMarkdownCollaboration, replaceWorkOfficeMarkdownCollaboration as replaceOfficeMarkdownCollaboration, } from './internal/collaboration/office-markdown-collaboration';
+export type { WorkOfficePdfCollaborationBinding as OfficePdfCollaborationBinding, WorkOfficePdfCollaborationBindingOptions as OfficePdfCollaborationBindingOptions, WorkOfficePdfCollaborationChange as OfficePdfCollaborationChange, WorkPdfCollaborationAnnotation as PdfCollaborationAnnotation, WorkPdfCollaborationContent as PdfCollaborationContent, WorkPdfCollaborationDeletePagesOperation as PdfCollaborationDeletePagesOperation, WorkPdfCollaborationFormValue as PdfCollaborationFormValue, WorkPdfCollaborationPageOperation as PdfCollaborationPageOperation, WorkPdfCollaborationRect as PdfCollaborationRect, WorkPdfCollaborationRedactionProposal as PdfCollaborationRedactionProposal, WorkPdfCollaborationReorderPagesOperation as PdfCollaborationReorderPagesOperation, WorkPdfCollaborationReviewDecision as PdfCollaborationReviewDecision, WorkPdfCollaborationRotatePagesOperation as PdfCollaborationRotatePagesOperation, WorkPdfCollaborationSignatureAppearance as PdfCollaborationSignatureAppearance, WorkPdfCollaborationSignaturePlacement as PdfCollaborationSignaturePlacement, WorkPdfCollaborationSource as PdfCollaborationSource, } from './internal/collaboration/office-pdf-collaboration';
+export { assertWorkOfficePdfCollaborationSource as assertPdfCollaborationSource, createWorkOfficePdfCollaborationBinding as createOfficePdfCollaborationBinding, initializeWorkOfficePdfCollaboration as initializeOfficePdfCollaboration, readWorkOfficePdfCollaboration as readOfficePdfCollaboration, readWorkOfficePdfCollaborationSource as readOfficePdfCollaborationSource, replaceWorkOfficePdfCollaboration as replaceOfficePdfCollaboration, } from './internal/collaboration/office-pdf-collaboration';
+export { createWorkPdfCollaborationContent as createPdfCollaborationContent } from './internal/collaboration/office-pdf-collaboration-types';
+export type { WorkOfficePresentationCollaborationBinding as OfficePresentationCollaborationBinding, WorkOfficePresentationCollaborationBindingOptions as OfficePresentationCollaborationBindingOptions, WorkOfficePresentationCollaborationChange as OfficePresentationCollaborationChange, } from './internal/collaboration/office-presentation-collaboration';
+export { createWorkOfficePresentationCollaborationBinding as createOfficePresentationCollaborationBinding, initializeWorkOfficePresentationCollaboration as initializeOfficePresentationCollaboration, readWorkOfficePresentationCollaboration as readOfficePresentationCollaboration, replaceWorkOfficePresentationCollaboration as replaceOfficePresentationCollaboration, } from './internal/collaboration/office-presentation-collaboration';
+export type { WorkOfficeSpreadsheetCollaborationBinding as OfficeSpreadsheetCollaborationBinding, WorkOfficeSpreadsheetCollaborationBindingOptions as OfficeSpreadsheetCollaborationBindingOptions, WorkOfficeSpreadsheetCollaborationChange as OfficeSpreadsheetCollaborationChange, } from './internal/collaboration/office-spreadsheet-collaboration';
+export { createWorkOfficeSpreadsheetCollaborationBinding as createOfficeSpreadsheetCollaborationBinding, initializeWorkOfficeSpreadsheetCollaboration as initializeOfficeSpreadsheetCollaboration, readWorkOfficeSpreadsheetCollaboration as readOfficeSpreadsheetCollaboration, replaceWorkOfficeSpreadsheetCollaboration as replaceOfficeSpreadsheetCollaboration, } from './internal/collaboration/office-spreadsheet-collaboration';
 export type { WorkAgentProposal as AgentProposal, WorkAgentProposalApplyResult as AgentProposalApplyResult, WorkAgentProposalChange as AgentProposalChange, WorkAgentProposalConflict as AgentProposalConflict, WorkAgentProposalMessage as AgentProposalMessage, WorkAgentProposalRequest as AgentProposalRequest, WorkAgentProposalStatus as AgentProposalStatus, WorkAgentProposalTarget as AgentProposalTarget, } from './internal/features/work/work-agent-proposal';
+export { createWorkAgentProposalRequest as createAgentProposalRequest, WORK_AGENT_PROPOSAL_PROTOCOL as AGENT_PROPOSAL_PROTOCOL, workAgentProposalInstruction as createAgentProposalInstruction, workAgentProposalStatus as getAgentProposalStatus, } from './internal/features/work/work-agent-proposal';
 export type { WorkEditorAgentRequest as EditorAgentRequest } from './internal/features/work/work-agent-request';
+export type { WorkDocumentReviewConflict as DocumentReviewConflict, WorkDocumentReviewConflictEvent as DocumentReviewConflictEvent, WorkDocumentReviewConflictReason as DocumentReviewConflictReason, WorkDocumentReviewKind as DocumentReviewKind, } from './internal/features/work/work-document-review-conflicts';
 export type { WorkDocumentSelectionCommandFailure as DocumentSelectionCommandFailure, WorkDocumentSelectionCommandResult as DocumentSelectionCommandResult, WorkDocumentSelectionCommands as DocumentSelectionCommands, WorkDocumentSelectionContext as DocumentSelectionContext, WorkDocumentSelectionMenuIcon as DocumentSelectionMenuIcon, WorkDocumentSelectionMenuItem as DocumentSelectionMenuItem, WorkDocumentSelectionSnapshot as DocumentSelectionSnapshot, WorkGetDocumentSelectionMenuItems as GetDocumentSelectionMenuItems, } from './internal/features/work/work-document-selection-menu';
+export type { WorkArtifactExportOptions as ArtifactExportOptions } from './internal/features/work/work-file-io';
+export { createWorkArtifactBlob as createArtifactBlob, exportWorkArtifact as downloadArtifact, importWorkFile as importOfficeFile, WORK_IMPORT_ACCEPT as OFFICE_FILE_ACCEPT, workKindForFile as officeKindForFile, } from './internal/features/work/work-file-io';
+export { decodeWorkDocumentSnapshot as decodeDocumentSnapshot, encodeWorkDocumentSnapshot as encodeDocumentSnapshot, WORK_DOCUMENT_SNAPSHOT_MEDIA_TYPE as DOCUMENT_SNAPSHOT_MEDIA_TYPE, WORK_DOCUMENT_SNAPSHOT_SCHEMA as DOCUMENT_SNAPSHOT_SCHEMA, WORK_DOCUMENT_SNAPSHOT_VERSION as DOCUMENT_SNAPSHOT_VERSION, type WorkDocumentSnapshot as DocumentSnapshot, } from './internal/features/work/work-document-snapshot';
+export { applyWorkDocumentSource as applyDocumentSource, projectWorkDocumentSource as projectDocumentSource, WORK_DOCUMENT_SOURCE_MEDIA_TYPE as DOCUMENT_SOURCE_MEDIA_TYPE, WORK_DOCUMENT_SOURCE_SCHEMA as DOCUMENT_SOURCE_SCHEMA, WORK_DOCUMENT_SOURCE_VERSION as DOCUMENT_SOURCE_VERSION, type WorkDocumentSource as DocumentSource, } from './internal/features/work/work-document-source';
 export type { WorkGetMarkdownSelectionMenuItems as GetMarkdownSelectionMenuItems, WorkMarkdownSelectionCommandFailure as MarkdownSelectionCommandFailure, WorkMarkdownSelectionCommandResult as MarkdownSelectionCommandResult, WorkMarkdownSelectionCommands as MarkdownSelectionCommands, WorkMarkdownSelectionContext as MarkdownSelectionContext, WorkMarkdownSelectionMenuIcon as MarkdownSelectionMenuIcon, WorkMarkdownSelectionMenuItem as MarkdownSelectionMenuItem, WorkMarkdownSelectionSnapshot as MarkdownSelectionSnapshot, } from './internal/features/work/work-markdown-selection-menu';
-export { workArtifactExtension as artifactExtension, workArtifactKindLabel as artifactKindLabel, } from './internal/features/work/work-types';
+export { exportWorkArtifactPdf as downloadArtifactPdf, type WorkPdfExportOptions as PdfExportOptions, workPdfPagesForExport as pdfPagesForExport, } from './internal/features/work/work-pdf-export';
+export { defaultPptxRuntimeUrl } from './internal/features/work/work-presentation-file-io';
+export { forgetWorkSourceBlob as forgetSourceBlob, readWorkSourceBlob as readSourceBlob, rememberWorkSourceBlob as registerSourceBlob, } from './internal/features/work/work-repository';
+export { createWorkArtifact as createArtifact, createWorkId as createOfficeId, WORK_TEMPLATES as officeTemplates, } from './internal/features/work/work-templates';
 export type { WorkArtifact as OfficeArtifact, WorkArtifactContent as OfficeArtifactContent, WorkArtifactKind as OfficeArtifactKind, WorkCompatibilityIssue as CompatibilityIssue, WorkCompatibilityReport as CompatibilityReport, WorkDocumentContent as DocumentContent, WorkMarkdownContent as MarkdownContent, WorkPdfContent as PdfContent, WorkPresentationContent as PresentationContent, WorkSourceFile as SourceFile, WorkSpreadsheetContent as SpreadsheetContent, WorkTemplate as OfficeTemplate, } from './internal/features/work/work-types';
 export * from './internal/features/work/work-types';
+export { workArtifactExtension as artifactExtension, workArtifactKindLabel as artifactKindLabel, } from './internal/features/work/work-types';
+export { OFFICE_NOTIFICATION_EVENT, type OfficeNotification, type OfficeNotificationTone, subscribeOfficeNotifications, } from './internal/state/app-state';

package/dist/core.js

@@ -1,4 +1,12 @@
+var core_OFFICE_COLLABORATION_VERSION = 1;
 export { AGENT_PROPOSAL_PROTOCOL, OFFICE_NOTIFICATION_EVENT, createAgentProposalInstruction, createAgentProposalRequest, getAgentProposalStatus, subscribeOfficeNotifications } from "./6489.js";
-export { OFFICE_FILE_ACCEPT, artifactExtension, artifactExtension as workArtifactExtension, artifactKindLabel, artifactKindLabel as workArtifactKindLabel, createArtifactBlob, defaultPptxRuntimeUrl, downloadArtifact, downloadArtifactPdf, forgetSourceBlob, importOfficeFile, officeKindForFile, pdfPagesForExport, readSourceBlob, registerSourceBlob } from "./4104.js";
-export { createArtifact, createOfficeId, officeTemplates } from "./1134.js";
+export { DOCUMENT_SNAPSHOT_MEDIA_TYPE, DOCUMENT_SNAPSHOT_SCHEMA, DOCUMENT_SNAPSHOT_VERSION, DOCUMENT_SOURCE_MEDIA_TYPE, DOCUMENT_SOURCE_SCHEMA, DOCUMENT_SOURCE_VERSION, OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_PRESENCE_FIELD, OFFICE_FILE_ACCEPT, applyDocumentSource, artifactExtension, artifactExtension as workArtifactExtension, artifactKindLabel, artifactKindLabel as workArtifactKindLabel, createArtifactBlob, createOfficeCollaborationPresence, createOfficeCollaborationTransportBinding, createPdfCollaborationContent, decodeDocumentSnapshot, defaultPptxRuntimeUrl, downloadArtifact, downloadArtifactPdf, encodeDocumentSnapshot, forgetSourceBlob, importOfficeFile, officeKindForFile, pdfPagesForExport, projectDocumentSource, readSourceBlob, registerSourceBlob } from "./4104.js";
+export { OFFICE_COLLABORATION_NAMESPACE, OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError, createOfficeCollaborationSession, readOfficeCollaborationMetadata } from "./9787.js";
+export { assertPdfCollaborationSource, createOfficePdfCollaborationBinding, initializeOfficePdfCollaboration, readOfficePdfCollaboration, readOfficePdfCollaborationSource, replaceOfficePdfCollaboration } from "./3818.js";
+export { createArtifact, createOfficeId, officeTemplates } from "./5184.js";
+export { createOfficeDocumentCollaborationBinding, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration } from "./8928.js";
+export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
+export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";
+export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./4476.js";
 export { normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetBubbleSizeRepresents, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetDataLabelPosition, normalizeWorkSpreadsheetDataLabels, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetErrorBars, normalizeWorkSpreadsheetRadarStyle, normalizeWorkSpreadsheetScatterStyle, normalizeWorkSpreadsheetTrendline, normalizeWorkSpreadsheetTrendlineType, workSpreadsheetChartSupportsAxes, workSpreadsheetChartSupportsErrorBars, workSpreadsheetChartSupportsTrendlines, workSpreadsheetChartTypeLabel, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetCombinationSeriesTypeLabel, workSpreadsheetDataLabelPositionLabel, workSpreadsheetErrorBarTypeLabel, workSpreadsheetErrorBarValueTypeLabel, workSpreadsheetTrendlineTypeLabel } from "./8715.js";
+export { core_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION };

package/dist/index.js

@@ -1,5 +1,15 @@
+var src_DOCUMENT_SNAPSHOT_VERSION = 1;
+var src_DOCUMENT_SOURCE_VERSION = 1;
+var src_OFFICE_COLLABORATION_VERSION = 1;
 export { AGENT_PROPOSAL_PROTOCOL, OFFICE_NOTIFICATION_EVENT, createAgentProposalInstruction, createAgentProposalRequest, getAgentProposalStatus, subscribeOfficeNotifications } from "./6489.js";
-export { DocumentEditor, MarkdownEditor, PdfViewer, PresentationEditor, SpreadsheetEditor, defaultDocumentArabicLayoutFontUrl, defaultDocumentHebrewLayoutFontUrl, defaultDocumentLatinLayoutFontUrl, defaultDocumentLayoutFontUrl, defaultDocumentLayoutFonts, defaultOfficeKernelWasmUrl, defaultPdfiumWasmUrl, preloadOfficeEditor } from "./432.js";
-export { OFFICE_FILE_ACCEPT, artifactExtension, artifactExtension as workArtifactExtension, artifactKindLabel, artifactKindLabel as workArtifactKindLabel, createArtifactBlob, defaultPptxRuntimeUrl, downloadArtifact, downloadArtifactPdf, forgetSourceBlob, importOfficeFile, officeKindForFile, pdfPagesForExport, readSourceBlob, registerSourceBlob } from "./4104.js";
-export { createArtifact, createOfficeId, officeTemplates } from "./1134.js";
+export { DOCUMENT_SNAPSHOT_MEDIA_TYPE, DOCUMENT_SNAPSHOT_SCHEMA, DOCUMENT_SOURCE_MEDIA_TYPE, DOCUMENT_SOURCE_SCHEMA, OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_PRESENCE_FIELD, OFFICE_FILE_ACCEPT, applyDocumentSource, artifactExtension, artifactExtension as workArtifactExtension, artifactKindLabel, artifactKindLabel as workArtifactKindLabel, createArtifactBlob, createOfficeCollaborationPresence, createOfficeCollaborationTransportBinding, createPdfCollaborationContent, decodeDocumentSnapshot, defaultPptxRuntimeUrl, downloadArtifact, downloadArtifactPdf, encodeDocumentSnapshot, forgetSourceBlob, importOfficeFile, officeKindForFile, pdfPagesForExport, projectDocumentSource, readSourceBlob, registerSourceBlob } from "./4104.js";
+export { DocumentEditor, MarkdownEditor, PDF_EVIDENCE_COORDINATE_BASIS, PdfViewer, PresentationEditor, SpreadsheetEditor, defaultDocumentArabicLayoutFontUrl, defaultDocumentHebrewLayoutFontUrl, defaultDocumentLatinLayoutFontUrl, defaultDocumentLayoutFontUrl, defaultDocumentLayoutFonts, defaultOfficeKernelWasmUrl, defaultPdfiumWasmUrl, preloadOfficeEditor } from "./432.js";
+export { OFFICE_COLLABORATION_NAMESPACE, OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError, createOfficeCollaborationSession, readOfficeCollaborationMetadata } from "./9787.js";
+export { assertPdfCollaborationSource, createOfficePdfCollaborationBinding, initializeOfficePdfCollaboration, readOfficePdfCollaboration, readOfficePdfCollaborationSource, replaceOfficePdfCollaboration } from "./3818.js";
+export { createArtifact, createOfficeId, officeTemplates } from "./5184.js";
+export { createOfficeDocumentCollaborationBinding, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration } from "./8928.js";
+export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
+export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";
+export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./4476.js";
 export { normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetBubbleSizeRepresents, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetDataLabelPosition, normalizeWorkSpreadsheetDataLabels, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetErrorBars, normalizeWorkSpreadsheetRadarStyle, normalizeWorkSpreadsheetScatterStyle, normalizeWorkSpreadsheetTrendline, normalizeWorkSpreadsheetTrendlineType, workSpreadsheetChartSupportsAxes, workSpreadsheetChartSupportsErrorBars, workSpreadsheetChartSupportsTrendlines, workSpreadsheetChartTypeLabel, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetCombinationSeriesTypeLabel, workSpreadsheetDataLabelPositionLabel, workSpreadsheetErrorBarTypeLabel, workSpreadsheetErrorBarValueTypeLabel, workSpreadsheetTrendlineTypeLabel } from "./8715.js";
+export { src_DOCUMENT_SNAPSHOT_VERSION as DOCUMENT_SNAPSHOT_VERSION, src_DOCUMENT_SOURCE_VERSION as DOCUMENT_SOURCE_VERSION, src_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION };

package/dist/internal/collaboration/office-collaboration-flat-json.d.ts

@@ -0,0 +1,13 @@
+export interface WorkOfficeCollaborationFlatJsonMap {
+    delete(key: string): unknown;
+    entries(): IterableIterator<[string, unknown]>;
+    get(key: string): unknown;
+    set(key: string, value: unknown): unknown;
+}
+export type InvalidWorkOfficeCollaborationSharedValue = (label: string) => never;
+/**
+ * Recursively stores object leaves in a stable Y.Map. Arrays stay atomic
+ * because their positional semantics belong to each format-specific model.
+ */
+export declare function patchWorkOfficeCollaborationFlatJsonMap(target: WorkOfficeCollaborationFlatJsonMap, previous: Record<string, unknown> | undefined, next: Record<string, unknown> | undefined, label: string): void;
+export declare function readWorkOfficeCollaborationFlatJsonMap(target: WorkOfficeCollaborationFlatJsonMap, label: string, invalidShared: InvalidWorkOfficeCollaborationSharedValue): Record<string, unknown>;

package/dist/internal/collaboration/office-collaboration-json.d.ts

@@ -0,0 +1,4 @@
+export declare function cloneWorkOfficeCollaborationJson(value: unknown, seen?: WeakSet<object>): unknown;
+export declare function workOfficeCollaborationJsonEqual(left: unknown, right: unknown): boolean;
+export declare function canonicalWorkOfficeCollaborationJson(value: unknown): string;
+export declare function isWorkOfficeCollaborationRecord(value: unknown): value is Record<string, unknown>;

package/dist/internal/collaboration/office-collaboration-presence.d.ts

@@ -0,0 +1,86 @@
+import { WORK_OFFICE_COLLABORATION_PROTOCOL, WORK_OFFICE_COLLABORATION_VERSION, type WorkOfficeCollaborationActorKind, type WorkOfficeCollaborationMode, type WorkOfficeCollaborationSession } from './office-collaboration';
+export declare const WORK_OFFICE_COLLABORATION_PRESENCE_FIELD: "a3sOffice";
+export type WorkOfficeCollaborationPresenceActivity = 'active' | 'idle' | 'away';
+export interface WorkOfficeDocumentPresenceLocation {
+    readonly kind: 'document';
+    /** Zero-based ProseMirror model position. */
+    readonly anchor: number;
+    readonly head: number;
+}
+export interface WorkOfficeMarkdownPresenceLocation {
+    readonly kind: 'markdown';
+    /** Positions are UTF-16 offsets in source mode and ProseMirror positions in visual mode. */
+    readonly anchor: number;
+    readonly head: number;
+    /** Missing values from older protocol peers are interpreted as `source`. */
+    readonly surface?: 'source' | 'visual';
+}
+export type WorkOfficeTextPresenceLocation = WorkOfficeDocumentPresenceLocation | WorkOfficeMarkdownPresenceLocation;
+export interface WorkOfficeSpreadsheetPresenceCell {
+    readonly row: number;
+    readonly column: number;
+}
+export interface WorkOfficeSpreadsheetPresenceRange {
+    readonly startRow: number;
+    readonly startColumn: number;
+    readonly endRow: number;
+    readonly endColumn: number;
+}
+export interface WorkOfficeSpreadsheetPresenceLocation {
+    readonly kind: 'spreadsheet';
+    readonly sheetId: string;
+    readonly ranges: readonly WorkOfficeSpreadsheetPresenceRange[];
+    readonly activeCell?: WorkOfficeSpreadsheetPresenceCell;
+}
+export interface WorkOfficePresentationPresenceLocation {
+    readonly kind: 'presentation';
+    readonly slideId: string;
+    readonly elementIds: readonly string[];
+}
+export interface WorkOfficePdfPresenceLocation {
+    readonly kind: 'pdf';
+    /** Zero-based page index. */
+    readonly pageIndex: number;
+    readonly annotationId?: string;
+}
+export type WorkOfficeCollaborationPresenceLocation = WorkOfficeTextPresenceLocation | WorkOfficeSpreadsheetPresenceLocation | WorkOfficePresentationPresenceLocation | WorkOfficePdfPresenceLocation;
+export interface WorkOfficeCollaborationPresenceActor {
+    readonly id: string;
+    readonly name: string;
+    readonly color?: string;
+    readonly avatarUrl?: string;
+    readonly kind: WorkOfficeCollaborationActorKind;
+}
+export interface WorkOfficeCollaborationPresenceState {
+    readonly protocol: typeof WORK_OFFICE_COLLABORATION_PROTOCOL;
+    readonly version: typeof WORK_OFFICE_COLLABORATION_VERSION;
+    readonly artifactId: string;
+    readonly artifactKind: WorkOfficeCollaborationSession['kind'];
+    readonly namespace: string;
+    readonly presenceId: string;
+    readonly actor: WorkOfficeCollaborationPresenceActor;
+    readonly mode: WorkOfficeCollaborationMode;
+    readonly activity: WorkOfficeCollaborationPresenceActivity;
+    readonly location?: WorkOfficeCollaborationPresenceLocation;
+}
+export interface WorkOfficeCollaborationParticipant extends WorkOfficeCollaborationPresenceState {
+    readonly clientId: number;
+    readonly local: boolean;
+}
+export interface WorkOfficeCollaborationPresenceSnapshot {
+    readonly localClientId: number;
+    readonly participants: readonly WorkOfficeCollaborationParticipant[];
+}
+export interface WorkOfficeCollaborationPresenceUpdate {
+    readonly activity?: WorkOfficeCollaborationPresenceActivity;
+    /** `null` clears the local location; omission keeps the current location. */
+    readonly location?: WorkOfficeCollaborationPresenceLocation | null;
+}
+export interface WorkOfficeCollaborationPresence {
+    local(): WorkOfficeCollaborationPresenceState;
+    snapshot(): WorkOfficeCollaborationPresenceSnapshot;
+    update(update: WorkOfficeCollaborationPresenceUpdate): WorkOfficeCollaborationPresenceState;
+    subscribe(listener: (snapshot: WorkOfficeCollaborationPresenceSnapshot) => void): () => void;
+    destroy(): void;
+}
+export declare function createWorkOfficeCollaborationPresence(session: WorkOfficeCollaborationSession, initial?: WorkOfficeCollaborationPresenceUpdate): WorkOfficeCollaborationPresence;

package/dist/internal/collaboration/office-collaboration-transport.d.ts

@@ -0,0 +1,42 @@
+import { WORK_OFFICE_COLLABORATION_PROTOCOL, WORK_OFFICE_COLLABORATION_VERSION, type WorkOfficeCollaborationOrigin, type WorkOfficeCollaborationSession } from './office-collaboration';
+export declare const WORK_OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES: number;
+export declare const WORK_OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES: number;
+export type WorkOfficeCollaborationTransportMessageType = 'sync-step-1' | 'sync-step-2' | 'update';
+/**
+ * A structured-clone-safe envelope around standard Yjs v1 state vectors and
+ * updates. The host may encode this envelope for its own wire protocol.
+ */
+export interface WorkOfficeCollaborationTransportMessage {
+    readonly protocol: typeof WORK_OFFICE_COLLABORATION_PROTOCOL;
+    readonly version: typeof WORK_OFFICE_COLLABORATION_VERSION;
+    readonly artifactId: string;
+    readonly artifactKind: WorkOfficeCollaborationSession['kind'];
+    readonly namespace: string;
+    readonly senderClientId: number;
+    readonly type: WorkOfficeCollaborationTransportMessageType;
+    readonly payload: Uint8Array;
+    /** Present only for incremental updates whose Yjs transaction had a typed origin. */
+    readonly origin?: WorkOfficeCollaborationOrigin;
+}
+/**
+ * Host-owned room channel. It owns connectivity, buffering, authentication,
+ * authorization, persistence, and delivery ordering.
+ */
+export interface WorkOfficeCollaborationTransport {
+    publish(message: WorkOfficeCollaborationTransportMessage): void;
+    subscribe(listener: (message: unknown) => void): () => void;
+}
+export interface WorkOfficeCollaborationTransportBindingOptions {
+    /**
+     * Sends one SyncStep1 immediately after subscribing. Disable when the host
+     * must wait for a room connection, then call `synchronize()` on connect.
+     */
+    autoSynchronize?: boolean;
+    maxPayloadBytes?: number;
+}
+export interface WorkOfficeCollaborationTransportBinding {
+    /** Send a fresh state vector. Call this after every transport reconnect. */
+    synchronize(): void;
+    destroy(): void;
+}
+export declare function createWorkOfficeCollaborationTransportBinding(session: WorkOfficeCollaborationSession, transport: WorkOfficeCollaborationTransport, options?: WorkOfficeCollaborationTransportBindingOptions): WorkOfficeCollaborationTransportBinding;

package/dist/internal/collaboration/office-collaboration.d.ts

@@ -0,0 +1,85 @@
+import * as Y from 'yjs';
+import type { WorkArtifactKind } from '../features/work/work-types';
+export declare const WORK_OFFICE_COLLABORATION_PROTOCOL: "a3s.office.collaboration";
+export declare const WORK_OFFICE_COLLABORATION_VERSION: 1;
+export declare const WORK_OFFICE_COLLABORATION_NAMESPACE: "a3s.office";
+export type WorkOfficeCollaborationMode = 'view' | 'comment' | 'suggest' | 'edit';
+export type WorkOfficeCollaborationActorKind = 'human' | 'agent' | 'system';
+export interface WorkOfficeCollaborationActor {
+    id: string;
+    name: string;
+    color?: string;
+    avatarUrl?: string;
+    kind?: WorkOfficeCollaborationActorKind;
+}
+export type WorkOfficeCollaborationOriginKind = 'bootstrap' | 'editor' | 'agent' | 'import' | 'system';
+export interface WorkOfficeCollaborationOrigin {
+    readonly protocol: typeof WORK_OFFICE_COLLABORATION_PROTOCOL;
+    readonly kind: WorkOfficeCollaborationOriginKind;
+    readonly actorId?: string;
+    readonly operationId?: string;
+}
+/**
+ * Structural subset of y-protocols Awareness used by Office surfaces.
+ * Providers keep ownership of the Awareness instance and its transport.
+ */
+export interface WorkOfficeCollaborationAwareness {
+    readonly clientID: number;
+    getLocalState(): Record<string, unknown> | null;
+    getStates(): Map<number, Record<string, unknown>>;
+    setLocalStateField(field: string, value: unknown): void;
+    on(event: 'change' | 'update', listener: (changes: {
+        added: number[];
+        updated: number[];
+        removed: number[];
+    }) => void): void;
+    off(event: 'change' | 'update', listener: (changes: {
+        added: number[];
+        updated: number[];
+        removed: number[];
+    }) => void): void;
+}
+export interface WorkOfficeCollaborationMetadata {
+    protocol: typeof WORK_OFFICE_COLLABORATION_PROTOCOL;
+    version: typeof WORK_OFFICE_COLLABORATION_VERSION;
+    artifactId: string;
+    kind: WorkArtifactKind;
+    initialized: boolean;
+}
+export interface WorkOfficeCollaborationSessionOptions {
+    artifactId: string;
+    kind: WorkArtifactKind;
+    document?: Y.Doc;
+    awareness?: WorkOfficeCollaborationAwareness;
+    actor?: WorkOfficeCollaborationActor;
+    mode?: WorkOfficeCollaborationMode;
+    namespace?: string;
+}
+export interface WorkOfficeCollaborationSession {
+    readonly artifactId: string;
+    readonly kind: WorkArtifactKind;
+    readonly document: Y.Doc;
+    readonly awareness?: WorkOfficeCollaborationAwareness;
+    readonly actor?: WorkOfficeCollaborationActor;
+    readonly mode: WorkOfficeCollaborationMode;
+    readonly namespace: string;
+    readonly ownsDocument: boolean;
+    readonly localOrigin: WorkOfficeCollaborationOrigin;
+    metadata(): WorkOfficeCollaborationMetadata | null;
+    rootName(suffix: string): string;
+    createOrigin(kind: WorkOfficeCollaborationOriginKind, operationId?: string): WorkOfficeCollaborationOrigin;
+    transact<T>(operation: (transaction: Y.Transaction) => T, origin?: WorkOfficeCollaborationOrigin): T;
+    destroy(): void;
+}
+export type WorkOfficeCollaborationErrorCode = 'office.collaboration.actor_invalid' | 'office.collaboration.artifact_mismatch' | 'office.collaboration.binding_destroyed' | 'office.collaboration.bootstrap_ambiguous' | 'office.collaboration.bootstrap_invalid' | 'office.collaboration.content_invalid' | 'office.collaboration.identifier_invalid' | 'office.collaboration.kind_invalid' | 'office.collaboration.kind_mismatch' | 'office.collaboration.metadata_invalid' | 'office.collaboration.metadata_missing' | 'office.collaboration.mode_invalid' | 'office.collaboration.namespace_invalid' | 'office.collaboration.not_initialized' | 'office.collaboration.origin_invalid' | 'office.collaboration.permission_denied' | 'office.collaboration.presence_conflict' | 'office.collaboration.presence_invalid' | 'office.collaboration.presence_unavailable' | 'office.collaboration.root_invalid' | 'office.collaboration.session_destroyed' | 'office.collaboration.transport_identity_mismatch' | 'office.collaboration.transport_invalid' | 'office.collaboration.transport_message_invalid' | 'office.collaboration.transport_message_too_large';
+export declare class WorkOfficeCollaborationError extends Error {
+    readonly code: WorkOfficeCollaborationErrorCode;
+    constructor(code: WorkOfficeCollaborationErrorCode, message: string);
+}
+export declare function createWorkOfficeCollaborationSession(options: WorkOfficeCollaborationSessionOptions): WorkOfficeCollaborationSession;
+export declare function readWorkOfficeCollaborationMetadata(session: WorkOfficeCollaborationSession): WorkOfficeCollaborationMetadata | null;
+export declare function initializeWorkOfficeCollaborationMetadata(session: WorkOfficeCollaborationSession): WorkOfficeCollaborationMetadata;
+export declare function markWorkOfficeCollaborationInitialized(session: WorkOfficeCollaborationSession): void;
+export declare function registerWorkOfficeCollaborationInitializer(session: WorkOfficeCollaborationSession): void;
+export declare function assertWorkOfficeCollaborationEditable(session: WorkOfficeCollaborationSession): void;
+export declare function assertWorkOfficeCollaborationOrigin(origin: WorkOfficeCollaborationOrigin): void;

package/dist/internal/collaboration/office-document-collaboration-bibliography.d.ts

@@ -0,0 +1,7 @@
+import * as Y from 'yjs';
+import type { WorkDocumentBibliography } from '../features/work/work-types';
+export declare function validatedWorkOfficeDocumentBibliography(value: unknown): WorkDocumentBibliography;
+export declare function initializeWorkOfficeDocumentBibliography(settings: Y.Map<unknown>, records: Y.Map<unknown>, order: Y.Array<string>, bibliography: WorkDocumentBibliography): void;
+export declare function readWorkOfficeDocumentBibliography(settings: Y.Map<unknown>, records: Y.Map<unknown>, order: Y.Array<string>): WorkDocumentBibliography;
+export declare function patchWorkOfficeDocumentBibliography(settings: Y.Map<unknown>, records: Y.Map<unknown>, order: Y.Array<string>, previous: WorkDocumentBibliography | undefined, next: WorkDocumentBibliography | undefined): void;
+export declare function assertWorkOfficeDocumentBibliographyConflicts(previous: WorkDocumentBibliography | undefined, next: WorkDocumentBibliography | undefined, shared: WorkDocumentBibliography | undefined): void;

package/dist/internal/collaboration/office-document-collaboration-claims.d.ts

@@ -0,0 +1,9 @@
+import type * as Y from 'yjs';
+import type { WorkDocumentBibliography, WorkDocumentComment } from '../features/work/work-types';
+interface ClaimableDocumentSidecars {
+    comments?: WorkDocumentComment[];
+    bibliography?: WorkDocumentBibliography;
+}
+export declare function appendWorkOfficeDocumentRecordClaims(claims: Y.Array<string>, previous: ClaimableDocumentSidecars, next: ClaimableDocumentSidecars): void;
+export declare function assertWorkOfficeDocumentRecordClaims(claims: Y.Array<string>, sidecars: ClaimableDocumentSidecars): void;
+export {};

package/dist/internal/collaboration/office-document-collaboration-comments.d.ts

@@ -0,0 +1,7 @@
+import * as Y from 'yjs';
+import type { WorkDocumentComment } from '../features/work/work-types';
+export declare function validatedWorkOfficeDocumentComments(value: unknown): WorkDocumentComment[];
+export declare function initializeWorkOfficeDocumentComments(records: Y.Map<unknown>, order: Y.Array<string>, comments: WorkDocumentComment[]): void;
+export declare function readWorkOfficeDocumentComments(records: Y.Map<unknown>, order: Y.Array<string>): WorkDocumentComment[];
+export declare function patchWorkOfficeDocumentComments(records: Y.Map<unknown>, order: Y.Array<string>, previous: WorkDocumentComment[], next: WorkDocumentComment[]): void;
+export declare function assertWorkOfficeDocumentCommentConflicts(previous: WorkDocumentComment[], next: WorkDocumentComment[], shared: WorkDocumentComment[]): void;

package/dist/internal/collaboration/office-document-collaboration-sidecar-utils.d.ts

@@ -0,0 +1,27 @@
+import * as Y from 'yjs';
+export declare function validatedOrder(order: Y.Array<string>, records: Y.Map<unknown>, label: string): string[];
+export declare function requiredSharedMap(parent: Y.Map<unknown>, key: string, label: string): Y.Map<unknown>;
+export declare function requiredNestedMap(parent: Y.Map<unknown>, key: string, label: string): Y.Map<unknown>;
+export declare function requiredNestedArray(parent: Y.Map<unknown>, key: string, label: string): Y.Array<string>;
+export declare function patchRequiredScalar(target: Y.Map<unknown>, key: string, previous: unknown, next: unknown): void;
+export declare function patchOptionalScalar(target: Y.Map<unknown>, key: string, previous: unknown, next: unknown): void;
+export declare function removeFromOrder(order: Y.Array<string>, id: string): void;
+export declare function insertIntoOrder(order: Y.Array<string>, desired: string[], id: string): void;
+export declare function optionalSharedString(value: unknown, label: string): string | undefined;
+export declare function requiredIdentifier(value: unknown, label: string): string;
+export declare function requiredSharedIdentifier(value: unknown, label: string): string;
+export declare function requiredString(value: unknown, label: string): string;
+export declare function requiredSharedString(value: unknown, label: string): string;
+export declare function requiredBoolean(value: unknown, label: string): boolean;
+export declare function requiredSharedBoolean(value: unknown, label: string): boolean;
+export declare function cloneJsonRecord(value: Record<string, unknown>): Record<string, unknown>;
+export declare function cloneJsonValue(value: unknown, seen?: WeakSet<object>): unknown;
+export declare function jsonEqual(left: unknown, right: unknown): boolean;
+export declare function canonicalJson(value: unknown): string;
+export declare function assertNoAddedCollision<T extends {
+    id: string;
+}>(previous: T[], next: T[], shared: T[], label: string): void;
+export declare function changedRecordMissing(label: string, id: string): never;
+export declare function invalidInputSidecars(expected: string): never;
+export declare function invalidSharedSidecars(label: string): never;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;