edytor 5.0.0 → 7.0.0

package/dist/session/handles.js

@@ -16,6 +16,7 @@ import { Block } from '../block/block.svelte.js';
 import { InlineBlock } from '../block/inlineBlock.svelte.js';
 import { Text } from '../text/text.svelte.js';
 import { partsOf } from '../crdt/parts.js';
+import { getOr } from '../utils.js';
 /**
  * A text segment's items as `JSONText` runs (`text.value`): empty items
  * dropped, adjacent runs with the same marks joined, each run's marks a
@@ -61,10 +62,7 @@ export class Handles {
     block = (id) => {
         if (id === 'root')
             return this.root;
-        let block = this.#blocks.get(id);
-        if (!block)
-            this.#blocks.set(id, (block = new Block(this.edytor, id)));
-        return block;
+        return getOr(this.#blocks, id, () => new Block(this.edytor, id));
     };
     /** The handle of live block `id`; none for a dead or unknown id. */
     get = (id) => id === 'root' || (id && this.edytor.facade.isVisibleBlock(id)) ? this.block(id) : undefined;
@@ -84,9 +82,7 @@ export class Handles {
     };
     /** The handle of atom `atomId`, shown in block `blockId`. */
     atom = (blockId, atomId) => {
-        let atom = this.#atoms.get(atomId);
-        if (!atom)
-            this.#atoms.set(atomId, (atom = new InlineBlock(this.edytor, blockId, atomId)));
+        const atom = getOr(this.#atoms, atomId, () => new InlineBlock(this.edytor, blockId, atomId));
         atom.blockId = blockId;
         return atom;
     };

package/dist/surface/attributes.d.ts

@@ -32,12 +32,12 @@ export type Kind = 'block' | 'text' | 'mark' | 'atom' | 'anchor' | 'preview';
  * moves the caret by its paragraph's direction, never an inline run's.
  */
 export declare const blockDir: (text: string) => "rtl" | "ltr" | null;
-/** The text a cell's runs show (its atoms left out): what `blockDir` reads. */
-export declare const ownText: (runs: readonly ContentRun[]) => string;
+/** The text a cell's runs show, each atom as `atom` (left out: what `blockDir` reads). */
+export declare const ownText: (runs: readonly ContentRun[], atom?: string) => string;
 /** A text inside a void block is its own editing host (the core sets it at attach). */
 export declare const insideVoid: (edytor: Edytor, block: string) => boolean;
 /** What the table owns on `element` (the root, or a registered element). */
-export declare const ownedOf: (edytor: Edytor, element: Element, entry: {
+export declare const ownedOf: (edytor: Edytor, element: Element, entry?: {
     kind: Kind;
     block: string;
     name?: string;

package/dist/surface/attributes.js

@@ -20,8 +20,8 @@ export const blockDir = (text) => {
     const strong = STRONG.exec(text)?.[0];
     return strong === undefined ? null : RTL.test(strong) ? 'rtl' : 'ltr';
 };
-/** The text a cell's runs show (its atoms left out): what `blockDir` reads. */
-export const ownText = (runs) => runs.map((run) => (run.kind === 'text' ? run.text : '')).join('');
+/** The text a cell's runs show, each atom as `atom` (left out: what `blockDir` reads). */
+export const ownText = (runs, atom = '') => runs.map((run) => (run.kind === 'text' ? run.text : atom)).join('');
 /** A text inside a void block is its own editing host (the core sets it at attach). */
 export const insideVoid = (edytor, block) => {
     for (let id = block; id; id = edytor.facade.parentOf(id))

package/dist/surface/observer.svelte.d.ts

@@ -31,12 +31,12 @@ export declare class SurfaceObserver {
      * editing host inside a void).
      */
     register: (node: Element, kind: Kind, block: string, name?: string, owned?: () => Owned, handle?: Text | InlineBlock) => () => void;
-    /** The render anchor (`Edytor.svelte`): a registered child of the strict root. */
-    anchor: (node: HTMLElement) => {
-        destroy: () => void;
-    };
-    /** A suggestion's preview group (`components/Suggestion`): registered, view-only, never compared. */
-    preview: (node: HTMLElement, id: string) => {
+    /**
+     * A view-only element the core renders in the host, never compared: the
+     * render anchor (`Edytor.svelte`, a registered child of the strict root),
+     * or with its suggestion's `id`, a preview group (`components/Suggestion`).
+     */
+    own: (node: HTMLElement, id?: string) => {
         destroy: () => void;
     };
     /** Extension view state rendered into the host, or a re-display request: an epoch bump. */
@@ -71,4 +71,4 @@ export declare class SurfaceObserver {
  * The caret lands where the browser put it (`domCaret`), else, for an
  * attempt, where the change ends — unless a gesture came since.
  */
-export declare const adopt: (edytor: Edytor, text: Text, dom: string, domCaret?: number, prefer?: number) => Promise<boolean>;
+export declare const adopt: (edytor: Edytor, text: Text, dom: string, domCaret?: number, prefer?: number) => Promise<void>;