@docx-editor.dev/core/collaboration/replication

createCollaborationDocumentPortfunctionSource ↗

Create the narrow collaboration view over one canonical package store.

declare function createCollaborationDocumentPort(store: TreePackageStore, options: CreateCollaborationDocumentPortOptions): CollaborationDocumentPort;

CanonicalAttributeNameinterfaceSource ↗

Attribute name as the journal addresses it. Prefix is authored fidelity, not identity.

interface CanonicalAttributeName

CanonicalBinaryDescriptorinterfaceSource ↗

Content-addressed binary part reference. Bytes stay out of the journal.

interface CanonicalBinaryDescriptor

CanonicalElementNodeDescriptorinterfaceSource ↗

OOXML element shell. Attributes, bindings, and children arrive as later effects.

interface CanonicalElementNodeDescriptor

CanonicalPrimitiveJournalinterfaceSource ↗

One immutable journal for one TreePackageStore transaction.

Empty only when a committed write used a path the journal does not yet intercept.

interface CanonicalPrimitiveJournal

CanonicalRelationshipRecordinterfaceSource ↗

One relationship as the journal records it.

interface CanonicalRelationshipRecord

CanonicalTextNodeDescriptorinterfaceSource ↗

Text node shell. Value arrives later through spliceText.

interface CanonicalTextNodeDescriptor

CollaborationDocumentPortinterfaceSource ↗

Narrow canonical document capability handed to a collaboration implementation.

It deliberately exposes no mutable package or tree store. Every write returns through the same validated transaction path as browser and automation edits.

interface CollaborationDocumentPort

CollaborationMutationinterfaceSource ↗

Attribution for one collaboration-derived canonical publication.

interface CollaborationMutation

CollaborationParagraphinterfaceSource ↗

One existing body paragraph exposed to the replication adapter.

interface CollaborationParagraph

CollaborationParagraphTextUpdateinterfaceSource ↗

One paragraph text value in an atomic collaboration publication.

interface CollaborationParagraphTextUpdate

CreateCollaborationDocumentPortOptionsinterfaceSource ↗

Options for a canonical collaboration document port.

interface CreateCollaborationDocumentPortOptions

CanonicalNodeDescriptortypeSource ↗

Immutable node record required to create a registry entry.

type CanonicalNodeDescriptor = CanonicalTextNodeDescriptor | CanonicalElementNodeDescriptor;

CanonicalPrimitiveEffecttypeSource ↗

One compositional tree or package effect captured from a canonical write.

type CanonicalPrimitiveEffect = {
    readonly kind: 'putNode';
    readonly descriptor: CanonicalNodeDescriptor;
} | {
    readonly kind: 'spliceText';
    readonly logicalId: string;
    readonly utf16Start: number;
    readonly deleteCount: number;
    readonly insert: string;
} | {
    readonly kind: 'setAttribute';
    readonly logicalId: string;
    readonly qname: CanonicalAttributeName;
    readonly value: string | null;
} | {
    readonly kind: 'setNamespaceBinding';
    readonly logicalId: string;
    readonly prefix: string;
    readonly uri: string | null;
} | {
    readonly kind: 'spliceChildren';
    readonly parentLogicalId: string;
    readonly start: number;
    readonly deleteCount: number;
    readonly childLogicalIds: readonly string[];
} | {
    readonly kind: 'moveNode';
    readonly logicalId: string;
    readonly destinationParentLogicalId: string;
    readonly destinationIndex: number;
} | {
    readonly kind: 'putXmlPart';
    readonly name: string;
    readonly rootLogicalId: string;
} | {
    readonly kind: 'deleteXmlPart';
    readonly name: string;
} | {
    readonly kind: 'putRelationship';
    readonly owner: string;
    readonly record: CanonicalRelationshipRecord;
} | {
    readonly kind: 'deleteRelationship';
    readonly owner: string;
    readonly relationshipId: string;
} | {
    readonly kind: 'putContentTypeOverride';
    readonly partName: string;
    readonly mediaType: string;
} | {
    readonly kind: 'deleteContentTypeOverride';
    readonly partName: string;
} | {
    readonly kind: 'putBinary';
    readonly descriptor: CanonicalBinaryDescriptor;
} | {
    readonly kind: 'deleteBinary';
    readonly storageKey: string;
};

CollaborationApplyResulttypeSource ↗

Result of replacing one supported paragraph's canonical text.

type CollaborationApplyResult = {
    readonly ok: true;
    readonly changed: boolean;
} | {
    readonly ok: false;
    readonly reason: string;
};