@formicoidea/labre-core 0.30.1 → 0.32.0

package/dist/_pkgs/affine-shared/services/edit-props-store.js

@@ -3,8 +3,8 @@ import { DisposableGroup } from '../../global/disposable/index.js';
 import { BlockSuiteError, ErrorCode } from '../../global/exceptions/index.js';
 import { LifeCycleWatcher } from '../../std/index.js';
 import { computed, signal } from '@preact/signals-core';
-import clonedeep from 'lodash-es/cloneDeep';
-import mergeWith from 'lodash-es/mergeWith';
+import clonedeep from 'lodash-es/cloneDeep.js';
+import mergeWith from 'lodash-es/mergeWith.js';
 import { Subject } from 'rxjs';
 import * as Y from 'yjs';
 import { z } from 'zod';
@@ -59,6 +59,13 @@ export class EditPropsStore extends LifeCycleWatcher {
         super(std);
         this._disposables = new DisposableGroup();
         this.innerProps$ = signal({});
+        /**
+         * Flat accumulation of every style prop the user recorded, most recent
+         * value per prop, across element types. "Apply last style" (Mod+Y) reads
+         * this so a fill picked on a rect can repaint an ellipse, or a font style
+         * set on a text can restyle a shape.
+         */
+        this.lastUsedStyle$ = signal({});
         this.slots = {
             storageUpdated: new Subject(),
         };
@@ -141,6 +148,10 @@ export class EditPropsStore extends LifeCycleWatcher {
         const overrideProps = schema.parse(props);
         if (Object.keys(overrideProps).length === 0)
             return;
+        this.lastUsedStyle$.value = {
+            ...this.lastUsedStyle$.value,
+            ...overrideProps,
+        };
         const innerProps = this.innerProps$.value;
         const nextProps = mergeWith(clonedeep(innerProps), { [key]: overrideProps }, customizer);
         this.innerProps$.value = OptionalPropsSchema.parse(nextProps);

package/dist/_pkgs/affine-shared/services/embed-iframe/embed-iframe-service.d.ts

@@ -1,6 +1,6 @@
 import type { EmbedIframeBlockProps } from '../../../affine-model/index.js';
 import { type Store, StoreExtension } from '../../../store/index.js';
-import { type EmbedIframeConfig } from './embed-iframe-config';
+import { type EmbedIframeConfig } from './embed-iframe-config.js';
 export type EmbedIframeData = {
     html?: string;
     iframe_url?: string;

package/dist/_pkgs/affine-shared/services/embed-iframe/embed-iframe-service.js

@@ -1,5 +1,5 @@
 import { StoreExtension } from '../../../store/index.js';
-import { EmbedIframeConfigIdentifier, } from './embed-iframe-config';
+import { EmbedIframeConfigIdentifier, } from './embed-iframe-config.js';
 export class EmbedIframeService extends StoreExtension {
     static { this.key = 'embed-iframe-service'; }
     constructor(store) {

package/dist/_pkgs/affine-shared/services/embed-iframe/index.d.ts

@@ -1,2 +1,2 @@
-export * from './embed-iframe-config';
-export * from './embed-iframe-service';
+export * from './embed-iframe-config.js';
+export * from './embed-iframe-service.js';

package/dist/_pkgs/affine-shared/services/embed-iframe/index.js

@@ -1,2 +1,2 @@
-export * from './embed-iframe-config';
-export * from './embed-iframe-service';
+export * from './embed-iframe-config.js';
+export * from './embed-iframe-service.js';

package/dist/_pkgs/affine-shared/services/font-loader/font-loader-service.d.ts

@@ -3,8 +3,33 @@ import type { ExtensionType } from '../../../store/index.js';
 import type { FontConfig } from './config.js';
 export declare class FontLoaderService extends LifeCycleWatcher {
     static readonly key = "font-loader";
+    private static readonly DEFERRED_LOAD_DELAY_MS;
+    private static readonly DEFERRED_LOAD_BATCH_SIZE;
+    private static readonly DEFERRED_LOAD_BATCH_INTERVAL_MS;
+    private _idleLoadTaskId;
+    private _lazyLoadTimeoutId;
+    private _deferredFontsQueue;
+    private _deferredFontsCursor;
+    private _resolveDeferredDone;
+    /**
+     * Resolves once every deferred font has been handed to the browser, so
+     * `ready` still speaks for the whole configuration and the canvas is still
+     * repainted once — and only once — every font is in.
+     */
+    private _deferredDone;
+    private readonly _loadedFontKeys;
     readonly fontFaces: FontFace[];
-    get ready(): Promise<FontFace[]>;
+    get ready(): Promise<undefined>;
+    private readonly _fontKey;
+    /**
+     * The fonts the canvas paints with before anyone has picked anything: the
+     * ones a board is guaranteed to need on its very first frame. Everything
+     * else is a font a document has to ask for, and can arrive a few seconds
+     * later without anyone seeing a fallback.
+     */
+    private readonly _isCriticalCanvasFont;
+    private readonly _scheduleDeferredLoad;
+    private readonly _cancelDeferredLoad;
     load(fonts: FontConfig[]): void;
     mounted(): void;
     unmounted(): void;

package/dist/_pkgs/affine-shared/services/font-loader/font-loader-service.js

@@ -1,3 +1,4 @@
+import { FontFamily, FontStyle, FontWeight } from '../../../affine-model/index.js';
 import { createIdentifier } from '../../../global/di/index.js';
 import { IS_FIREFOX } from '../../../global/env/index.js';
 import { LifeCycleWatcher } from '../../../std/index.js';
@@ -13,29 +14,145 @@ const initFontFace = IS_FIREFOX
 export class FontLoaderService extends LifeCycleWatcher {
     constructor() {
         super(...arguments);
+        this._idleLoadTaskId = null;
+        this._lazyLoadTimeoutId = null;
+        this._deferredFontsQueue = [];
+        this._deferredFontsCursor = 0;
+        this._resolveDeferredDone = null;
+        /**
+         * Resolves once every deferred font has been handed to the browser, so
+         * `ready` still speaks for the whole configuration and the canvas is still
+         * repainted once — and only once — every font is in.
+         */
+        this._deferredDone = Promise.resolve();
+        this._loadedFontKeys = new Set();
         this.fontFaces = [];
+        this._fontKey = ({ font, weight, style, url }) => {
+            return `${font}:${weight}:${style}:${url}`;
+        };
+        /**
+         * The fonts the canvas paints with before anyone has picked anything: the
+         * ones a board is guaranteed to need on its very first frame. Everything
+         * else is a font a document has to ask for, and can arrive a few seconds
+         * later without anyone seeing a fallback.
+         */
+        this._isCriticalCanvasFont = ({ font, weight, style, }) => {
+            if (style !== FontStyle.Normal)
+                return false;
+            if (font === FontFamily.Poppins) {
+                return (weight === FontWeight.Regular ||
+                    weight === FontWeight.Medium ||
+                    weight === FontWeight.SemiBold);
+            }
+            if (font === FontFamily.Inter) {
+                return weight === FontWeight.Regular || weight === FontWeight.SemiBold;
+            }
+            if (font === FontFamily.Kalam) {
+                // Mindmap style four uses bold Kalam text. SemiBold is the strongest
+                // Kalam weight we ship.
+                return weight === FontWeight.SemiBold;
+            }
+            return false;
+        };
+        this._scheduleDeferredLoad = (fonts) => {
+            if (fonts.length === 0 || typeof window === 'undefined') {
+                return;
+            }
+            this._deferredFontsQueue = fonts;
+            this._deferredFontsCursor = 0;
+            this._deferredDone = new Promise(resolve => {
+                this._resolveDeferredDone = resolve;
+            });
+            const win = window;
+            const scheduleBatch = (delayMs) => {
+                this._lazyLoadTimeoutId = window.setTimeout(() => {
+                    this._lazyLoadTimeoutId = null;
+                    const runBatch = () => {
+                        this._idleLoadTaskId = null;
+                        const start = this._deferredFontsCursor;
+                        const end = Math.min(start + FontLoaderService.DEFERRED_LOAD_BATCH_SIZE, this._deferredFontsQueue.length);
+                        this._deferredFontsCursor = end;
+                        this.load(this._deferredFontsQueue.slice(start, end));
+                        if (this._deferredFontsCursor < this._deferredFontsQueue.length) {
+                            scheduleBatch(FontLoaderService.DEFERRED_LOAD_BATCH_INTERVAL_MS);
+                            return;
+                        }
+                        this._resolveDeferredDone?.();
+                        this._resolveDeferredDone = null;
+                    };
+                    if (typeof win.requestIdleCallback === 'function') {
+                        this._idleLoadTaskId = win.requestIdleCallback(runBatch, {
+                            timeout: 2000,
+                        });
+                        return;
+                    }
+                    runBatch();
+                }, delayMs);
+            };
+            scheduleBatch(FontLoaderService.DEFERRED_LOAD_DELAY_MS);
+        };
+        this._cancelDeferredLoad = () => {
+            if (typeof window === 'undefined') {
+                return;
+            }
+            const win = window;
+            if (this._idleLoadTaskId !== null &&
+                typeof win.cancelIdleCallback === 'function') {
+                win.cancelIdleCallback(this._idleLoadTaskId);
+            }
+            this._idleLoadTaskId = null;
+            if (this._lazyLoadTimeoutId !== null) {
+                window.clearTimeout(this._lazyLoadTimeoutId);
+                this._lazyLoadTimeoutId = null;
+            }
+            this._deferredFontsQueue = [];
+            this._deferredFontsCursor = 0;
+            this._resolveDeferredDone?.();
+            this._resolveDeferredDone = null;
+            this._deferredDone = Promise.resolve();
+        };
     }
     static { this.key = 'font-loader'; }
+    static { this.DEFERRED_LOAD_DELAY_MS = 5000; }
+    static { this.DEFERRED_LOAD_BATCH_SIZE = 4; }
+    static { this.DEFERRED_LOAD_BATCH_INTERVAL_MS = 1000; }
     get ready() {
-        return Promise.all(this.fontFaces.map(fontFace => fontFace.loaded));
+        return this._deferredDone.then(() => Promise.all(this.fontFaces.map(fontFace => fontFace.loaded)).then(() => undefined));
     }
     load(fonts) {
-        this.fontFaces.push(...fonts.map(font => {
+        for (const font of fonts) {
+            const key = this._fontKey(font);
+            // The same face registered twice is a second download and a second
+            // entry in `document.fonts`.
+            if (this._loadedFontKeys.has(key)) {
+                continue;
+            }
+            this._loadedFontKeys.add(key);
             const fontFace = initFontFace(font);
             document.fonts.add(fontFace);
             fontFace.load().catch(console.error);
-            return fontFace;
-        }));
+            this.fontFaces.push(fontFace);
+        }
     }
     mounted() {
         const config = this.std.getOptional(FontConfigIdentifier);
-        if (config) {
-            this.load(config);
+        if (!config || config.length === 0) {
+            return;
         }
+        const criticalFonts = config.filter(this._isCriticalCanvasFont);
+        const eagerFonts = criticalFonts.length > 0 ? criticalFonts : config.slice(0, 3);
+        const eagerFontKeySet = new Set(eagerFonts.map(this._fontKey));
+        const deferredFonts = config.filter(font => !eagerFontKeySet.has(this._fontKey(font)));
+        this.load(eagerFonts);
+        this._scheduleDeferredLoad(deferredFonts);
     }
     unmounted() {
-        this.fontFaces.forEach(fontFace => document.fonts.delete(fontFace));
+        this._cancelDeferredLoad();
+        for (const fontFace of this.fontFaces) {
+            document.fonts.delete(fontFace);
+        }
         this.fontFaces.splice(0, this.fontFaces.length);
+        this._loadedFontKeys.clear();
     }
 }
 export const FontConfigIdentifier = createIdentifier('AffineFontConfig');

package/dist/_pkgs/affine-shared/services/index.d.ts

@@ -1,32 +1,37 @@
-export * from './auto-clear-selection-service';
-export * from './block-meta-service';
-export * from './citation-service';
-export * from './comment-service';
-export * from './doc-display-meta-service';
-export * from './doc-mode-service';
-export * from './drag-handle-config';
-export * from './edit-props-store';
-export * from './editor-setting-service';
-export * from './embed-iframe';
-export * from './embed-option-service';
-export * from './feature-flag-service';
-export * from './file-size-limit-service';
-export * from './font-loader';
-export * from './generate-url-service';
-export * from './keymap-override-service';
-export * from './link-preview-service';
-export * from './linked-doc-content-service';
-export * from './linked-doc-creation-service';
-export * from './native-clipboard-service';
-export * from './notification-service';
-export * from './open-doc-config';
-export * from './page-viewport-service';
-export * from './parse-url-service';
-export * from './quick-search-service';
-export * from './sidebar-service';
-export * from './telemetry-service';
-export * from './theme-service';
-export * from './toolbar-service';
-export * from './user-service';
-export * from './viewport-element-service';
-export * from './virtual-keyboard-service';
+export * from './audit-service.js';
+export * from './auto-clear-selection-service.js';
+export * from './block-meta-service.js';
+export * from './citation-service/index.js';
+export * from './comment-service/index.js';
+export * from './doc-display-meta-service.js';
+export * from './doc-mode-service.js';
+export * from './drag-handle-config.js';
+export * from './edit-props-store.js';
+export * from './editor-setting-service.js';
+export * from './embed-iframe/index.js';
+export * from './embed-option-service.js';
+export * from './feature-flag-service.js';
+export * from './file-size-limit-service.js';
+export * from './font-loader/index.js';
+export * from './generate-url-service.js';
+export * from './keymap-override-service.js';
+export * from './link-preview-service/index.js';
+export * from './linked-doc-content-service.js';
+export * from './linked-doc-creation-service.js';
+export * from './native-clipboard-service.js';
+export * from './notification-service.js';
+export * from './open-doc-config.js';
+export * from './page-viewport-service.js';
+export * from './parse-url-service.js';
+export * from './pivot-materiality-publisher.js';
+export * from './pivot-properties-service.js';
+export * from './quick-search-service.js';
+export * from './sidebar-service.js';
+export * from './telemetry-service/index.js';
+export * from './theme-service.js';
+export * from './toolbar-service/index.js';
+export * from './translation-service/index.js';
+export * from './universe-tag-defs-service.js';
+export * from './user-service/index.js';
+export * from './viewport-element-service.js';
+export * from './virtual-keyboard-service.js';

package/dist/_pkgs/affine-shared/services/index.js

@@ -1,32 +1,37 @@
-export * from './auto-clear-selection-service';
-export * from './block-meta-service';
-export * from './citation-service';
-export * from './comment-service';
-export * from './doc-display-meta-service';
-export * from './doc-mode-service';
-export * from './drag-handle-config';
-export * from './edit-props-store';
-export * from './editor-setting-service';
-export * from './embed-iframe';
-export * from './embed-option-service';
-export * from './feature-flag-service';
-export * from './file-size-limit-service';
-export * from './font-loader';
-export * from './generate-url-service';
-export * from './keymap-override-service';
-export * from './link-preview-service';
-export * from './linked-doc-content-service';
-export * from './linked-doc-creation-service';
-export * from './native-clipboard-service';
-export * from './notification-service';
-export * from './open-doc-config';
-export * from './page-viewport-service';
-export * from './parse-url-service';
-export * from './quick-search-service';
-export * from './sidebar-service';
-export * from './telemetry-service';
-export * from './theme-service';
-export * from './toolbar-service';
-export * from './user-service';
-export * from './viewport-element-service';
-export * from './virtual-keyboard-service';
+export * from './audit-service.js';
+export * from './auto-clear-selection-service.js';
+export * from './block-meta-service.js';
+export * from './citation-service/index.js';
+export * from './comment-service/index.js';
+export * from './doc-display-meta-service.js';
+export * from './doc-mode-service.js';
+export * from './drag-handle-config.js';
+export * from './edit-props-store.js';
+export * from './editor-setting-service.js';
+export * from './embed-iframe/index.js';
+export * from './embed-option-service.js';
+export * from './feature-flag-service.js';
+export * from './file-size-limit-service.js';
+export * from './font-loader/index.js';
+export * from './generate-url-service.js';
+export * from './keymap-override-service.js';
+export * from './link-preview-service/index.js';
+export * from './linked-doc-content-service.js';
+export * from './linked-doc-creation-service.js';
+export * from './native-clipboard-service.js';
+export * from './notification-service.js';
+export * from './open-doc-config.js';
+export * from './page-viewport-service.js';
+export * from './parse-url-service.js';
+export * from './pivot-materiality-publisher.js';
+export * from './pivot-properties-service.js';
+export * from './quick-search-service.js';
+export * from './sidebar-service.js';
+export * from './telemetry-service/index.js';
+export * from './theme-service.js';
+export * from './toolbar-service/index.js';
+export * from './translation-service/index.js';
+export * from './universe-tag-defs-service.js';
+export * from './user-service/index.js';
+export * from './viewport-element-service.js';
+export * from './virtual-keyboard-service.js';

package/dist/_pkgs/affine-shared/services/link-preview-service/index.d.ts

@@ -1,3 +1,3 @@
-export * from './link-preview-cache';
-export * from './link-preview-service';
-export * from './link-preview-storage';
+export * from './link-preview-cache.js';
+export * from './link-preview-service.js';
+export * from './link-preview-storage.js';

package/dist/_pkgs/affine-shared/services/link-preview-service/index.js

@@ -1,3 +1,3 @@
-export * from './link-preview-cache';
-export * from './link-preview-service';
-export * from './link-preview-storage';
+export * from './link-preview-cache.js';
+export * from './link-preview-service.js';
+export * from './link-preview-storage.js';

package/dist/_pkgs/affine-shared/services/link-preview-service/link-preview-cache.js

@@ -1,9 +1,9 @@
 import { createIdentifier } from '../../../global/di/index.js';
 import { Extension } from '../../../store/index.js';
-import debounce from 'lodash-es/debounce';
+import debounce from 'lodash-es/debounce.js';
 import QuickLRU from 'quick-lru';
 import { z } from 'zod';
-import { LinkPreviewStorage } from './link-preview-storage';
+import { LinkPreviewStorage } from './link-preview-storage.js';
 export const LinkPreviewCacheConfigSchema = z.object({
     /**
      * The maximum number of items in the cache

package/dist/_pkgs/affine-shared/services/link-preview-service/link-preview-service.d.ts

@@ -1,7 +1,7 @@
 import { type LinkPreviewData } from '../../../affine-model/index.js';
 import { type Container } from '../../../global/di/index.js';
 import { Extension } from '../../../store/index.js';
-import { type LinkPreviewCacheProvider } from './link-preview-cache';
+import { type LinkPreviewCacheProvider } from './link-preview-cache.js';
 export type LinkPreviewResponseData = {
     url: string;
     title?: string;

package/dist/_pkgs/affine-shared/services/link-preview-service/link-preview-service.js

@@ -2,9 +2,9 @@ import {} from '../../../affine-model/index.js';
 import { createIdentifier } from '../../../global/di/index.js';
 import { BlockSuiteError, ErrorCode } from '../../../global/exceptions/index.js';
 import { Extension } from '../../../store/index.js';
-import { DEFAULT_LINK_PREVIEW_ENDPOINT } from '../../consts';
-import { isAbortError } from '../../utils/is-abort-error';
-import { LinkPreviewCacheIdentifier, } from './link-preview-cache';
+import { DEFAULT_LINK_PREVIEW_ENDPOINT } from '../../consts/index.js';
+import { isAbortError } from '../../utils/is-abort-error.js';
+import { LinkPreviewCacheIdentifier, } from './link-preview-cache.js';
 export const LinkPreviewServiceIdentifier = createIdentifier('AffineLinkPreviewService');
 export class LinkPreviewService extends Extension {
     static setup(di) {

package/dist/_pkgs/affine-shared/services/page-viewport-service.d.ts

@@ -1,5 +1,5 @@
 import type { ExtensionType } from '../../store/index.js';
 import { Subject } from 'rxjs';
-import type { Viewport } from '../types';
+import type { Viewport } from '../types/index.js';
 export declare const PageViewportService: import("../../global/di/types.js").ServiceIdentifier<Subject<Viewport>> & (<U extends Subject<Viewport> = Subject<Viewport>>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
 export declare const PageViewportServiceExtension: ExtensionType;

package/dist/_pkgs/affine-shared/services/pivot-materiality-publisher.d.ts

@@ -0,0 +1,129 @@
+/**
+ * `PivotMaterialityPublisher` — the one place a board occurrence's derived
+ * materialities are announced to the host (MF3 / ADR 0006 § 4).
+ *
+ * When the level-3 qualification of a **bound** element changes, the library
+ * announces it and forgets. It never writes to the pivot record, never awaits
+ * the host, never retries and never observes the result: the element is the
+ * source of truth for the occurrence, the record is the source of truth for
+ * itself, and the channel between them is one-way.
+ *
+ * ## Why a Yjs observer and not the setter, and not the command layer
+ *
+ * Both were rejected for the same concrete reason: **undo**.
+ *
+ * The `@field()` setter runs on a JS assignment only. Undo, redo and every
+ * remote peer's change arrive through the element's `Y.Map` observer and never
+ * touch it. Publishing from the setter — or from the command that calls it —
+ * means: qualify a bound element, press Ctrl+Z, and the element reverts while
+ * the record keeps the derived materiality. A silent, permanent desync on the
+ * very first undo.
+ *
+ * Subscribing to the surface's change stream and gating on `local` fixes it and
+ * costs nothing else:
+ *
+ * | Event                           | `local` | Publishes?                                |
+ * | ------------------------------- | ------- | ----------------------------------------- |
+ * | Author qualifies an element     | `true`  | Yes, on the authoring client only         |
+ * | Author presses Ctrl+Z / Ctrl+Y  | `true`  | Yes — this is what fixes the undo desync  |
+ * | Remote peer receives the change | `false` | No                                        |
+ *
+ * `local` also IS the de-duplication: it partitions the fleet into exactly one
+ * publisher and N−1 silent observers, with no leader election, no lock and no
+ * acknowledgement.
+ *
+ * ## Best-effort, and honest about it
+ *
+ * Patches are full-state and idempotent, so replaying one converges — which is
+ * what makes the unobservable `void` return survivable. If the authoring client
+ * is offline from the host at that moment the patch is lost and the record
+ * stays stale until the next local change to that element. The safety net is
+ * that the element is always authoritative: a host can rebuild every derived
+ * materiality by scanning `collectPivotOccurrences`. Derived materialities are
+ * a cache of the boards, never a second original.
+ */
+import { LifeCycleWatcher } from '../../std/index.js';
+import { type GfxPrimitiveElementModel } from '../../std/gfx/index.js';
+import { type OccurrenceMaterialityPatch } from './pivot-properties-service.js';
+export declare class PivotMaterialityPublisher extends LifeCycleWatcher {
+    static readonly key = "pivot-materiality-publisher";
+    /** Elements whose state is to be re-examined at the end of this microtask. */
+    private readonly _pending;
+    private _flushing;
+    /**
+     * The record each element was last known to be bound to, so that unbinding —
+     * or re-binding — can retract the OLD record's materiality. Without it the
+     * retraction has no `pivotDocId` to name: by the time the change is seen, the
+     * element no longer carries the old one.
+     */
+    private readonly _lastBinding;
+    /**
+     * Last published fingerprint per `(pivotDocId, elementId)`. One user gesture
+     * produces several payloads for one element — the stash/pop path alone emits
+     * one per stashed prop — and a drag emits dozens that change nothing a patch
+     * describes. Publishing the element's CURRENT FULL STATE and dropping it when
+     * it repeats is what keeps that to one patch per real change.
+     */
+    private readonly _published;
+    private _subscriptions;
+    private _disposeSurfaceEffect;
+    mounted(): void;
+    unmounted(): void;
+    private _unsubscribe;
+    private _resubscribe;
+    /**
+     * Record what record an element is bound to, **without publishing anything**.
+     *
+     * ## Who owns a retraction in a collaborative session
+     *
+     * The client whose LOCAL transaction removes the occurrence — deletion,
+     * unbind, or re-bind. That is the same rule as every other emission here
+     * (`local` partitions the fleet into one publisher and N−1 observers), and it
+     * is the only rule that can work: the peer that ORIGINALLY bound the element
+     * sees the deletion as a remote change, so if retraction belonged to the
+     * binder, nobody would emit it at all.
+     *
+     * Owning the retraction requires knowing which record to retract from, and by
+     * the time the deletion is seen the element is gone. Hence this: **tracking
+     * the binding is bookkeeping, not publication.** Every client keeps the map
+     * for everything it can see, whoever wrote it, so that whichever client
+     * eventually performs the removal can name the record. Without it, retraction
+     * only ever worked when one client both created and deleted the occurrence —
+     * the rare case in an open collaborative session, and the host would keep a
+     * materiality attributed to an occurrence that no longer exists.
+     *
+     * A remote peer that CHANGES a binding updates this map silently: it is
+     * publishing its own retraction and its own patch, and a second one from here
+     * would be a duplicate, not a safety net.
+     *
+     * ## …and it invalidates what WE last published
+     *
+     * `_published` remembers the last patch this client sent, so an unchanged
+     * state is not re-announced. A remote change makes that memory a lie: the
+     * peer published its own patch, so the host now holds the peer's state, not
+     * ours. Left stale, the sequence `we publish data` → `peer switches to
+     * practice` → `we go back to data` compares equal to our own last
+     * fingerprint and DROPS the patch — the element says `data`, the host keeps
+     * `practice`, until some third, different value comes along.
+     *
+     * Milder than the retraction gap above (this is host-side cache staleness,
+     * not document data, and it heals on the next real change), but free to
+     * close: every remote touch drops our fingerprint for that occurrence, so
+     * the next local patch is always sent.
+     */
+    private _track;
+    /**
+     * Coalesce per element within one microtask, then publish the element's
+     * CURRENT FULL STATE — never a delta. `_onChange` is also invoked directly on
+     * the stash/pop path, so one gesture legitimately produces several payloads
+     * for the same element.
+     */
+    private _schedule;
+    private _publish;
+    private _emit;
+}
+/**
+ * The full state of one occurrence, as the host stores it. Exported for the
+ * host's own rebuild path and for tests — it is a pure function of the element.
+ */
+export declare function buildOccurrencePatch(element: GfxPrimitiveElementModel, pivotDocId: string): OccurrenceMaterialityPatch;