@sametalmdr/word-editor 0.2.0-alpha → 0.3.0-alpha

package/dist/canvas/geometry.js

@@ -1,131 +1,131 @@
-// Pure pt-space rectangle math for the canvas interaction layer (ADR-0018
-// §9/Karar 9). Every function here works on {x, y, cx, cy} — the same shape
-// BoxLayout and Decoration already use (src/model/node.js) — so a caller
-// never converts between coordinate conventions to use this file.
-//
-// `rectLines` is the single definition of "the six snap lines" a rect
-// offers (ADR-0018 Karar 6, §9): snap.js (a later phase) reuses this rather
-// than recomputing left/centerX/right/top/centerY/bottom itself, the same
-// "one definition, several consumers" discipline pageOccupants() applies to
-// "is this a box or a decoration" (page.js).
-//
-// No src/, DOM, or history import — this module is pure data in, data out.
-
-/**
- * @typedef {object} Rect
- * @property {number} x
- * @property {number} y
- * @property {number} cx
- * @property {number} cy
- */
-
-/**
- * @typedef {object} SnapLines
- * @property {number} left
- * @property {number} centerX
- * @property {number} right
- * @property {number} top
- * @property {number} centerY
- * @property {number} bottom
- */
-
-/**
- * Extracts the rect portion of anything shaped like a BoxLayout or a
- * Decoration (both carry x/y/cx/cy alongside fields this module does not
- * care about — z, rot, fillHex, paths). Always returns a NEW object: the
- * caller never receives a live reference into the model (invariant #13's
- * discipline applied here even though this is not an IO boundary — a
- * pageOccupants() consumer mutating a returned rect must never reach the
- * real BoxLayout/Decoration entry).
- *
- * @param {{x: number, y: number, cx: number, cy: number}} entry
- * @returns {Rect}
- */
-export function rectOfLayout(entry) {
-  return { x: entry.x, y: entry.y, cx: entry.cx, cy: entry.cy };
-}
-
-/**
- * True when `inner` is entirely within `outer`, edges inclusive. A point is
- * just a zero-size rect ({x, y, cx: 0, cy: 0}) — hit-test.js's
- * point-in-rect check reuses this rather than defining its own, the same
- * "one definition" discipline as `rectLines`.
- *
- * @param {Rect} outer
- * @param {Rect} inner
- * @returns {boolean}
- */
-export function rectContains(outer, inner) {
-  return (
-    outer.x <= inner.x &&
-    inner.x + inner.cx <= outer.x + outer.cx &&
-    outer.y <= inner.y &&
-    inner.y + inner.cy <= outer.y + outer.cy
-  );
-}
-
-/**
- * True when `a` and `b` overlap by a non-zero area. Edges touching (sharing
- * a boundary with no overlap) do NOT count — strict inequalities, matching
- * `contenteditable-scale-probe.html`'s `countOverlaps` (the corpus's own
- * overlap-pair count was built the same way).
- *
- * @param {Rect} a
- * @param {Rect} b
- * @returns {boolean}
- */
-export function rectsIntersect(a, b) {
-  return a.x < b.x + b.cx && b.x < a.x + a.cx && a.y < b.y + b.cy && b.y < a.y + a.cy;
-}
-
-/**
- * A rect built from two dragged corners can have a negative `cx`/`cy`
- * (dragging up-left of the start point). Returns an equivalent rect with
- * non-negative `cx`/`cy`, flipping `x`/`y` to compensate — the marquee
- * (ADR-0018 Karar 5, a later phase) needs this before it can call
- * `rectContains`/`rectsIntersect`, which assume non-negative size.
- *
- * @param {Rect} rect
- * @returns {Rect}
- */
-export function normalizeRect(rect) {
-  const x = rect.cx < 0 ? rect.x + rect.cx : rect.x;
-  const y = rect.cy < 0 ? rect.y + rect.cy : rect.y;
-  return { x, y, cx: Math.abs(rect.cx), cy: Math.abs(rect.cy) };
-}
-
-/**
- * The smallest rect containing both `a` and `b` — the multi-select bounding
- * box a later phase draws its single move handle around.
- *
- * @param {Rect} a
- * @param {Rect} b
- * @returns {Rect}
- */
-export function unionRect(a, b) {
-  const x = Math.min(a.x, b.x);
-  const y = Math.min(a.y, b.y);
-  const right = Math.max(a.x + a.cx, b.x + b.cx);
-  const bottom = Math.max(a.y + a.cy, b.y + b.cy);
-  return { x, y, cx: right - x, cy: bottom - y };
-}
-
-/**
- * The six lines a rect offers a snap search: three vertical (left, center,
- * right) and three horizontal (top, center, bottom). ADR-0018 §6.2's
- * "sürüklenen kutunun sol/orta-x/sağ ve üst/orta-y/alt, hedefin aynı
- * altısına karşı" rule, defined exactly once.
- *
- * @param {Rect} rect
- * @returns {SnapLines}
- */
-export function rectLines(rect) {
-  return {
-    left: rect.x,
-    centerX: rect.x + rect.cx / 2,
-    right: rect.x + rect.cx,
-    top: rect.y,
-    centerY: rect.y + rect.cy / 2,
-    bottom: rect.y + rect.cy,
-  };
-}
+// Pure pt-space rectangle math for the canvas interaction layer (ADR-0018
+// §9/Karar 9). Every function here works on {x, y, cx, cy} — the same shape
+// BoxLayout and Decoration already use (src/model/node.js) — so a caller
+// never converts between coordinate conventions to use this file.
+//
+// `rectLines` is the single definition of "the six snap lines" a rect
+// offers (ADR-0018 Karar 6, §9): snap.js (a later phase) reuses this rather
+// than recomputing left/centerX/right/top/centerY/bottom itself, the same
+// "one definition, several consumers" discipline pageOccupants() applies to
+// "is this a box or a decoration" (page.js).
+//
+// No src/, DOM, or history import — this module is pure data in, data out.
+
+/**
+ * @typedef {object} Rect
+ * @property {number} x
+ * @property {number} y
+ * @property {number} cx
+ * @property {number} cy
+ */
+
+/**
+ * @typedef {object} SnapLines
+ * @property {number} left
+ * @property {number} centerX
+ * @property {number} right
+ * @property {number} top
+ * @property {number} centerY
+ * @property {number} bottom
+ */
+
+/**
+ * Extracts the rect portion of anything shaped like a BoxLayout or a
+ * Decoration (both carry x/y/cx/cy alongside fields this module does not
+ * care about — z, rot, fillHex, paths). Always returns a NEW object: the
+ * caller never receives a live reference into the model (invariant #13's
+ * discipline applied here even though this is not an IO boundary — a
+ * pageOccupants() consumer mutating a returned rect must never reach the
+ * real BoxLayout/Decoration entry).
+ *
+ * @param {{x: number, y: number, cx: number, cy: number}} entry
+ * @returns {Rect}
+ */
+export function rectOfLayout(entry) {
+  return { x: entry.x, y: entry.y, cx: entry.cx, cy: entry.cy };
+}
+
+/**
+ * True when `inner` is entirely within `outer`, edges inclusive. A point is
+ * just a zero-size rect ({x, y, cx: 0, cy: 0}) — hit-test.js's
+ * point-in-rect check reuses this rather than defining its own, the same
+ * "one definition" discipline as `rectLines`.
+ *
+ * @param {Rect} outer
+ * @param {Rect} inner
+ * @returns {boolean}
+ */
+export function rectContains(outer, inner) {
+  return (
+    outer.x <= inner.x &&
+    inner.x + inner.cx <= outer.x + outer.cx &&
+    outer.y <= inner.y &&
+    inner.y + inner.cy <= outer.y + outer.cy
+  );
+}
+
+/**
+ * True when `a` and `b` overlap by a non-zero area. Edges touching (sharing
+ * a boundary with no overlap) do NOT count — strict inequalities, matching
+ * `contenteditable-scale-probe.html`'s `countOverlaps` (the corpus's own
+ * overlap-pair count was built the same way).
+ *
+ * @param {Rect} a
+ * @param {Rect} b
+ * @returns {boolean}
+ */
+export function rectsIntersect(a, b) {
+  return a.x < b.x + b.cx && b.x < a.x + a.cx && a.y < b.y + b.cy && b.y < a.y + a.cy;
+}
+
+/**
+ * A rect built from two dragged corners can have a negative `cx`/`cy`
+ * (dragging up-left of the start point). Returns an equivalent rect with
+ * non-negative `cx`/`cy`, flipping `x`/`y` to compensate — the marquee
+ * (ADR-0018 Karar 5, a later phase) needs this before it can call
+ * `rectContains`/`rectsIntersect`, which assume non-negative size.
+ *
+ * @param {Rect} rect
+ * @returns {Rect}
+ */
+export function normalizeRect(rect) {
+  const x = rect.cx < 0 ? rect.x + rect.cx : rect.x;
+  const y = rect.cy < 0 ? rect.y + rect.cy : rect.y;
+  return { x, y, cx: Math.abs(rect.cx), cy: Math.abs(rect.cy) };
+}
+
+/**
+ * The smallest rect containing both `a` and `b` — the multi-select bounding
+ * box a later phase draws its single move handle around.
+ *
+ * @param {Rect} a
+ * @param {Rect} b
+ * @returns {Rect}
+ */
+export function unionRect(a, b) {
+  const x = Math.min(a.x, b.x);
+  const y = Math.min(a.y, b.y);
+  const right = Math.max(a.x + a.cx, b.x + b.cx);
+  const bottom = Math.max(a.y + a.cy, b.y + b.cy);
+  return { x, y, cx: right - x, cy: bottom - y };
+}
+
+/**
+ * The six lines a rect offers a snap search: three vertical (left, center,
+ * right) and three horizontal (top, center, bottom). ADR-0018 §6.2's
+ * "sürüklenen kutunun sol/orta-x/sağ ve üst/orta-y/alt, hedefin aynı
+ * altısına karşı" rule, defined exactly once.
+ *
+ * @param {Rect} rect
+ * @returns {SnapLines}
+ */
+export function rectLines(rect) {
+  return {
+    left: rect.x,
+    centerX: rect.x + rect.cx / 2,
+    right: rect.x + rect.cx,
+    top: rect.y,
+    centerY: rect.y + rect.cy / 2,
+    bottom: rect.y + rect.cy,
+  };
+}

package/dist/canvas/gesture.d.ts

@@ -127,7 +127,6 @@ export function framePatches(entries: DragEntry[], dx: number, dy: number, limit
  */
 export function framePatchesMatchKeys(previousPatches: import("../commands/box.js").BoxTransformEntry[], patches: import("../commands/box.js").BoxTransformEntry[]): boolean;
 /**
- *
  * Terk (abandon) kapanıştan (closed) AYIRT EDİLEBİLİR tutulur (ADR-0016 §1):
  * a mutation that let an abandoned gesture read back as "closed" would make
  * "the bracket abandons cleanly" impossible to assert — it would only ever