smartrte-core 0.2.1 → 1.0.0-beta.1

package/dist/foundation/surface/renderer.d.ts

@@ -0,0 +1,84 @@
+import "katex/contrib/mhchem";
+import { FoundationModelDomMapping } from "../modelDom.js";
+import type { SmartDocument, SmartSelection } from "../types.js";
+import type { CanonicalSubtreeRenderer } from "./types.js";
+export declare class FoundationSubtreeRenderer implements CanonicalSubtreeRenderer {
+    private readonly root;
+    private readonly options;
+    readonly mapping: FoundationModelDomMapping;
+    private current;
+    private readonly modelById;
+    private compositionOwner;
+    private writes;
+    private compositionWrites;
+    private liveRegion;
+    constructor(root: HTMLElement, options?: {
+        contentVisibility?: boolean;
+    });
+    get composingNodeId(): string | null;
+    get domWriteCount(): number;
+    get composingDomWriteCount(): number;
+    private recordWrite;
+    private setAttribute;
+    private removeAttribute;
+    private syncNodeAttributes;
+    /**
+     * Keep failed remote resources visible as model-backed atoms instead of
+     * leaving a silent broken-image/media control. The event only updates
+     * renderer diagnostics; it never mutates the canonical document. A later
+     * attribute transaction (retry, replacement, or upload completion) clears
+     * the state through the normal diff path.
+     */
+    private installMediaDiagnostics;
+    private syncTableAccessibility;
+    private createNode;
+    private forget;
+    private modelChildren;
+    /**
+     * Empty inline owners need a browser line box for an immediately visible
+     * caret. This <br> is renderer UI, not canonical document content.
+     */
+    private syncEmptyLineProjection;
+    private diffElement;
+    private selectionMatches;
+    private restoreSelection;
+    /** Cell selections are projected as a DOM-only highlight; cells remain model nodes. */
+    private syncCellSelectionProjection;
+    /** Keep the active line visible without scrolling the surrounding page. */
+    private revealSelectionHead;
+    private listItemDepths;
+    /**
+     * Checklist controls are renderer projections whose state depends on both
+     * the list parent and the item attributes.  A list-type transition can keep
+     * the item object reference unchanged, so the normal subtree identity skip
+     * must not leave a stale checkbox projection behind.  Reconcile these
+     * projections from the current model after every render; attribute writes
+     * remain idempotent.
+     */
+    private syncListProjections;
+    private announceSelectedLevel;
+    render(document: SmartDocument, selection: SmartSelection): void;
+    /**
+     * Renderer-integrated content-visibility (Phase 11 Tier 3): the naive
+     * per-block experiment (stamping content-visibility:auto on every
+     * top-level block unconditionally, including the one actively being
+     * typed into) measured 55-699ms against a 41-46ms baseline and was
+     * disproven - the active block's own containment-recalculation overhead
+     * on every keystroke outweighs any off-screen skip benefit. This keys off
+     * the same reference-identity check diffElement already computes
+     * (`next === previous`, line ~421): a top-level block only gets
+     * content-visibility when it was untouched THIS render pass AND isn't
+     * the selection's own block, so the actively-edited block never carries
+     * the extra containment cost. Opt-in via the `contentVisibility`
+     * constructor option - default behavior for every existing caller and
+     * test is completely unchanged.
+     */
+    private syncContentVisibility;
+    beginComposition(nodeId: string): void;
+    endComposition(): void;
+    resetWriteCounters(): void;
+    destroy(): void;
+}
+export declare const createSubtreeRenderer: (root: HTMLElement, options?: {
+    contentVisibility?: boolean;
+}) => CanonicalSubtreeRenderer;