tosijs-styled-editor 0.4.2

package/dist/dom-utils.d.ts

@@ -0,0 +1,85 @@
+/**
+ * DOM traversal utilities for the tosijs-styled-editor component.
+ *
+ * All operations work in terms of "leaf nodes" — nodes with no children
+ * (text nodes, <img>, <hr>, <input>, etc.).
+ */
+export type NodeFilter = ((node: Node) => boolean) | string;
+/**
+ * Normalize a filter to a predicate function.
+ * - string: matches via Element.matches(selector) (text nodes never match)
+ * - function: used directly
+ * - undefined: matches everything
+ */
+export declare function makeFilter(filter?: NodeFilter): (node: Node) => boolean;
+/** Returns true if `a` comes before `b` in document order. */
+export declare function isBefore(a: Node, b: Node): boolean;
+/** Returns the index of `node` among its parent's childNodes (-1 if no parent). */
+export declare function siblingOrder(node: Node): number;
+/** Returns the first leaf node (deepest first-child) within `node`. */
+export declare function firstLeafNode(node: Node): Node;
+/** Returns the last leaf node (deepest last-child) within `node`. */
+export declare function lastLeafNode(node: Node): Node;
+/**
+ * Returns the next leaf node after `node`, stopping at `root`.
+ * If `filter` is provided, skips nodes that don't match.
+ */
+export declare function nextLeafNode(node: Node, root?: Node, filter?: NodeFilter): Node | null;
+/**
+ * Returns the previous leaf node before `node`, stopping at `root`.
+ * If `filter` is provided, skips nodes that don't match.
+ */
+export declare function previousLeafNode(node: Node, root?: Node, filter?: NodeFilter): Node | null;
+/** Collect all leaf nodes within `node`, optionally filtered. */
+export declare function leafNodes(node: Node, filter?: NodeFilter): Node[];
+/**
+ * Walk up the chain of ancestors that have only one child.
+ * Returns the topmost single-parent ancestor, or the node itself
+ * if its parent has multiple children.
+ */
+export declare function topSingleParentAncestor(node: Node, filter?: NodeFilter): Node;
+/**
+ * Walk up the chain of single-parent ancestors until one satisfies the filter.
+ * Returns null if none match before the chain breaks.
+ */
+export declare function closestSingleParentAncestor(node: Node, filter: NodeFilter): Node | null;
+/** Set user-select CSS on an element. */
+export declare function allowSelection(element: HTMLElement, allow: boolean): void;
+/** A character position found by measurement: where it is, and which side of it */
+export interface CharacterHit {
+    node: Text;
+    offset: number;
+    rect: DOMRect;
+    after: boolean;
+}
+/**
+ * Find the character nearest a point WITHOUT changing the document.
+ *
+ * The editor used to answer this by wrapping every character in a span and
+ * reading the spans' rects. That works, but it is a DOM mutation performed in
+ * order to measure — and measuring by mutating changes the thing measured:
+ * line-breaking shifts, and in engines that do not shape across inline box
+ * boundaries, cursive scripts come apart.
+ *
+ * A Range reports the same geometry read-only. This is Range as a measuring
+ * tape, not as a selection model: no execCommand, no browser selection, no
+ * editing behaviour handed back to the engine.
+ */
+export declare function characterAtPoint(root: Element, x: number, y: number): CharacterHit | null;
+/**
+ * Where a caret sitting at `marker` should actually paint.
+ *
+ * The marker is an empty element, so its own rect is 0x0 and carries no line
+ * box — falling back to the PARENT's rect gives the height of the whole block,
+ * which paints a caret several lines tall. The geometry has to come from an
+ * adjacent character instead, measured with a Range.
+ *
+ * Which edge of that character depends on direction: a caret before a character
+ * sits at its leading edge (left in LTR, right in RTL); a caret after the last
+ * character sits at its trailing edge.
+ */
+export declare function caretGeometryAt(marker: Element, root: Element): {
+    left: number;
+    top: number;
+    height: number;
+} | null;

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './dom-utils';
+export * from './selection';
+export * from './commands';
+export * from './tosijs-styled-editor';
+export * from './toolbar';
+export * from './table-utils';
+export { version } from './version';