@oakoliver/bubblezone 0.0.0-stage → 1.0.0

package/dist/index.js

@@ -0,0 +1,381 @@
+// src/manager.ts
+import { Batch } from "@oakoliver/bubbletea";
+
+// src/messages.ts
+var MsgZoneInBounds = class {
+  constructor(zone, event) {
+    this.zone = zone;
+    this.event = event;
+  }
+  zone;
+  event;
+  _tag = "MsgZoneInBounds";
+};
+
+// src/zoneinfo.ts
+function position(msg) {
+  const m = msg;
+  if (typeof m.mouse === "function") return m.mouse();
+  return { x: m.x, y: m.y };
+}
+var ZoneInfo = class {
+  /** The ID passed to `mark()`; empty for a zone that is not known yet. */
+  id;
+  /** @internal The generated marker sequence that stands for `id` in a view. */
+  rid;
+  /** @internal The scan this zone came from, used to drop stale zones. */
+  iteration;
+  /** X of the top-left cell of the zone. */
+  startX;
+  /** Y of the top-left cell of the zone. */
+  startY;
+  /** X of the bottom-right cell of the zone. */
+  endX;
+  /** Y of the bottom-right cell of the zone. */
+  endY;
+  constructor(init = {}) {
+    this.id = init.id ?? "";
+    this.rid = init.rid ?? "";
+    this.iteration = init.iteration ?? 0;
+    this.startX = init.startX ?? 0;
+    this.startY = init.startY ?? 0;
+    this.endX = init.endX ?? 0;
+    this.endY = init.endY ?? 0;
+  }
+  /** Reports whether the zone is not known (yet). `Manager.get()` returns such a zone for unknown IDs. */
+  isZero() {
+    return this.id === "";
+  }
+  /**
+   * Reports whether the mouse event is inside the box between the start and end
+   * cells. Unknown zones are never in bounds. A zone whose end lies before its
+   * start (for example text that wrapped onto the next line) is never in bounds
+   * either; for shapes a box cannot describe, do the check yourself.
+   */
+  inBounds(msg) {
+    if (this.isZero()) return false;
+    if (this.startX > this.endX || this.startY > this.endY) return false;
+    const { x, y } = position(msg);
+    if (x < this.startX || y < this.startY) return false;
+    if (x > this.endX || y > this.endY) return false;
+    return true;
+  }
+  /**
+   * Returns the event position relative to the zone, with (0, 0) at its top-left
+   * cell, or `[-1, -1]` if the zone is unknown or the event is outside it.
+   */
+  pos(msg) {
+    if (this.isZero() || !this.inBounds(msg)) return [-1, -1];
+    const { x, y } = position(msg);
+    return [x - this.startX, y - this.startY];
+  }
+  /** Width in cells (0 for an unknown or inverted zone). */
+  get width() {
+    return this.isZero() || this.endX < this.startX ? 0 : this.endX - this.startX + 1;
+  }
+  /** Height in rows (0 for an unknown or inverted zone). */
+  get height() {
+    return this.isZero() || this.endY < this.startY ? 0 : this.endY - this.startY + 1;
+  }
+};
+
+// src/width.ts
+var ESC = 27;
+var BEL = 7;
+var wideEmoji = /^\p{Emoji_Presentation}$/u;
+var zeroWidth = /^[\p{Mn}\p{Me}\p{Cf}]$/u;
+function isWide(cp) {
+  return cp >= 4352 && (cp <= 4447 || cp === 9001 || cp === 9002 || cp >= 11904 && cp <= 12350 || cp >= 12353 && cp <= 13311 || cp >= 13312 && cp <= 19903 || cp >= 19968 && cp <= 42191 || cp >= 43360 && cp <= 43391 || cp >= 44032 && cp <= 55203 || cp >= 63744 && cp <= 64255 || cp >= 65040 && cp <= 65049 || cp >= 65072 && cp <= 65135 || cp >= 65280 && cp <= 65376 || cp >= 65504 && cp <= 65510 || cp >= 94176 && cp <= 94180 || cp >= 94208 && cp <= 101631 || cp >= 110592 && cp <= 111359 || cp >= 131072 && cp <= 262141);
+}
+function runeWidth(cp) {
+  if (cp < 32 || cp >= 127 && cp < 160) return 0;
+  if (cp < 768) return 1;
+  if (cp === 8203 || cp === 8205 || cp >= 65024 && cp <= 65039) return 0;
+  if (isWide(cp)) return 2;
+  if (zeroWidth.test(String.fromCodePoint(cp))) return 0;
+  if (cp >= 8986 && wideEmoji.test(String.fromCodePoint(cp))) return 2;
+  return 1;
+}
+var plain = /^[\x20-\x7e]*$/;
+function printableWidth(s) {
+  if (plain.test(s)) return s.length;
+  let n = 0;
+  for (let i = 0; i < s.length; ) {
+    const cp = s.codePointAt(i);
+    const len = cp > 65535 ? 2 : 1;
+    if (cp !== ESC) {
+      n += runeWidth(cp);
+      i += len;
+      continue;
+    }
+    const next = s.charCodeAt(i + 1);
+    if (Number.isNaN(next)) break;
+    if (next === 91) {
+      i += 2;
+      while (i < s.length) {
+        const c = s.charCodeAt(i++);
+        if (c >= 64 && c <= 126) break;
+      }
+    } else if (next === 93 || next === 80 || next === 95 || next === 94 || next === 88) {
+      i += 2;
+      while (i < s.length) {
+        const c = s.charCodeAt(i);
+        if (c === BEL) {
+          i++;
+          break;
+        }
+        if (c === ESC && s.charCodeAt(i + 1) === 92) {
+          i += 2;
+          break;
+        }
+        i++;
+      }
+    } else if (next >= 32 && next <= 47) {
+      i += 2;
+      while (i < s.length && s.charCodeAt(i) >= 32 && s.charCodeAt(i) <= 47) i++;
+      i++;
+    } else {
+      i += 2;
+    }
+  }
+  return n;
+}
+
+// src/scanner.ts
+var tokens = /\x1b\[(\d+)z|\n/g;
+function scanView(host, input, iteration) {
+  if (input.indexOf("\x1B[") === -1 && input.indexOf("\n") === -1) return input;
+  let out = "";
+  let line = "";
+  let rows = 0;
+  let last = 0;
+  const tracked = /* @__PURE__ */ new Map();
+  tokens.lastIndex = 0;
+  for (let m = tokens.exec(input); m !== null; m = tokens.exec(input)) {
+    line += input.slice(last, m.index);
+    last = m.index + m[0].length;
+    if (m[0] === "\n") {
+      out += line + "\n";
+      line = "";
+      rows++;
+      continue;
+    }
+    if (!host.enabled) continue;
+    const rid = m[0];
+    const id = host.resolve(rid);
+    if (id === void 0) continue;
+    const open = tracked.get(rid);
+    if (open) {
+      open.endX = printableWidth(line) - 1;
+      open.endY = rows;
+      host.emit(open);
+      tracked.delete(rid);
+    } else {
+      tracked.set(rid, new ZoneInfo({ id, rid, iteration, startX: printableWidth(line), startY: rows }));
+    }
+  }
+  return out + line + input.slice(last);
+}
+
+// src/manager.ts
+var IDENT_START = "\x1B";
+var IDENT_BRACKET = "[";
+var IDENT_END = "z";
+var markerCounter = 1e3;
+var prefixCounter = 0;
+var scanCounter = 0;
+var Manager = class {
+  #enabled = true;
+  #closed = false;
+  #zones = /* @__PURE__ */ new Map();
+  #ids = /* @__PURE__ */ new Map();
+  // user ID -> marker sequence
+  #rids = /* @__PURE__ */ new Map();
+  // marker sequence -> user ID
+  /** Stops the manager. Later scans still strip markers but no longer store zones. */
+  close() {
+    this.#closed = true;
+  }
+  /**
+   * Enables or disables the manager. When disabled, `mark()` returns its input
+   * unchanged and `scan()` only strips markers (from views cached earlier).
+   * Disabling also forgets every stored zone.
+   */
+  setEnabled(enabled) {
+    this.#enabled = enabled;
+    if (!enabled) this.#zones.clear();
+  }
+  /** Reports whether the manager is enabled. */
+  enabled() {
+    return this.#enabled;
+  }
+  /**
+   * Returns a prefix that is unique across calls, for components that build zone
+   * IDs of their own and must not collide with a sibling instance:
+   * `zone.mark(this.id + 'item-3', row)`.
+   */
+  newPrefix() {
+    return "zone_" + String(++prefixCounter) + "__";
+  }
+  /**
+   * Wraps `v` in a start and end marker so `scan()` can find where it ended up
+   * on screen. Returns `v` unchanged when the manager is disabled or when `id`
+   * or `v` is empty.
+   */
+  mark(id, v) {
+    if (!this.#enabled) return v;
+    if (id === "" || v === "") return v;
+    let gid = this.#ids.get(id);
+    if (gid === void 0) {
+      gid = IDENT_START + IDENT_BRACKET + String(++markerCounter) + IDENT_END;
+      this.#ids.set(id, gid);
+      this.#rids.set(gid, id);
+    }
+    return gid + v + gid;
+  }
+  /** Forgets the stored zone for `id`. It is recorded again by the next scan that sees it. */
+  clear(id) {
+    this.#zones.delete(id);
+  }
+  /**
+   * Returns the zone stored for `id`. For an ID that is not known (yet) it
+   * returns a zero zone whose `isZero()` is true and whose `inBounds()` is
+   * false, so `get('x').inBounds(msg)` is always safe to call.
+   */
+  get(id) {
+    return this.#zones.get(id) ?? new ZoneInfo();
+  }
+  /**
+   * Strips the markers out of a view and records where each zone is. Call it
+   * once, on the outermost view, not inside child components.
+   *
+   * Unlike upstream, which hands the zones to a background worker, the zones are
+   * stored before `scan()` returns, so `get()` right afterwards sees them.
+   */
+  scan(v) {
+    const iteration = ++scanCounter;
+    const found = [];
+    const out = scanView(
+      {
+        enabled: this.#enabled,
+        resolve: (rid) => this.#rids.get(rid),
+        emit: (zone) => found.push(zone)
+      },
+      v,
+      iteration
+    );
+    if (this.#closed) return out;
+    for (const zone of found) this.#zones.set(zone.id, zone);
+    for (const [id, zone] of this.#zones) {
+      if (zone.iteration !== iteration) this.#zones.delete(id);
+    }
+    return out;
+  }
+  #findInBounds(mouse) {
+    const ids = [...this.#zones.keys()].sort();
+    const hit = [];
+    for (const id of ids) {
+      const zone = this.#zones.get(id);
+      if (zone.inBounds(mouse)) hit.push(zone);
+    }
+    return hit;
+  }
+  /**
+   * Sends a `MsgZoneInBounds` to `model.update()` for every zone the mouse event
+   * is inside, in alphabetical order of their IDs. The results of `update()` are
+   * discarded.
+   */
+  anyInBounds(model, mouse) {
+    for (const zone of this.#findInBounds(mouse)) {
+      model.update(new MsgZoneInBounds(zone, mouse));
+    }
+  }
+  /**
+   * Like `anyInBounds()`, but the model returned by each `update()` is passed to
+   * the next one and returned at the end; the commands are combined with `Batch`.
+   */
+  anyInBoundsAndUpdate(model, mouse) {
+    const cmds = [];
+    for (const zone of this.#findInBounds(mouse)) {
+      let cmd;
+      [model, cmd] = model.update(new MsgZoneInBounds(zone, mouse));
+      cmds.push(cmd);
+    }
+    return [model, Batch(...cmds)];
+  }
+};
+function New() {
+  return new Manager();
+}
+
+// src/global.ts
+var DefaultManager;
+function manager() {
+  if (!DefaultManager) throw new Error("manager not initialized");
+  return DefaultManager;
+}
+function NewGlobal() {
+  if (DefaultManager) return;
+  DefaultManager = New();
+}
+function Close() {
+  manager().close();
+}
+function SetEnabled(v) {
+  manager().setEnabled(v);
+}
+function Enabled() {
+  return manager().enabled();
+}
+function NewPrefix() {
+  return manager().newPrefix();
+}
+function Mark(id, v) {
+  return manager().mark(id, v);
+}
+function Clear(id) {
+  manager().clear(id);
+}
+function Get(id) {
+  return manager().get(id);
+}
+function Scan(v) {
+  return manager().scan(v);
+}
+function AnyInBounds(model, mouse) {
+  manager().anyInBounds(model, mouse);
+}
+function AnyInBoundsAndUpdate(model, mouse) {
+  return manager().anyInBoundsAndUpdate(model, mouse);
+}
+export {
+  AnyInBounds,
+  AnyInBoundsAndUpdate,
+  Clear,
+  Close,
+  DefaultManager,
+  Enabled,
+  Get,
+  Manager,
+  Mark,
+  MsgZoneInBounds,
+  New,
+  NewGlobal,
+  NewPrefix,
+  Scan,
+  SetEnabled,
+  ZoneInfo,
+  AnyInBounds as anyInBounds,
+  AnyInBoundsAndUpdate as anyInBoundsAndUpdate,
+  Clear as clear,
+  Close as close,
+  Enabled as enabled,
+  Get as get,
+  Mark as mark,
+  NewGlobal as newGlobal,
+  NewPrefix as newPrefix,
+  printableWidth,
+  runeWidth,
+  Scan as scan,
+  SetEnabled as setEnabled
+};

package/dist/manager.d.ts

@@ -0,0 +1,64 @@
+import type { Cmd, Model, MouseMsg } from '@oakoliver/bubbletea';
+import { ZoneInfo } from './zoneinfo.js';
+/**
+ * Parses zone information from the output of your components and stores it for
+ * later bounds checks. Enabled by default.
+ */
+export declare class Manager {
+    #private;
+    /** Stops the manager. Later scans still strip markers but no longer store zones. */
+    close(): void;
+    /**
+     * Enables or disables the manager. When disabled, `mark()` returns its input
+     * unchanged and `scan()` only strips markers (from views cached earlier).
+     * Disabling also forgets every stored zone.
+     */
+    setEnabled(enabled: boolean): void;
+    /** Reports whether the manager is enabled. */
+    enabled(): boolean;
+    /**
+     * Returns a prefix that is unique across calls, for components that build zone
+     * IDs of their own and must not collide with a sibling instance:
+     * `zone.mark(this.id + 'item-3', row)`.
+     */
+    newPrefix(): string;
+    /**
+     * Wraps `v` in a start and end marker so `scan()` can find where it ended up
+     * on screen. Returns `v` unchanged when the manager is disabled or when `id`
+     * or `v` is empty.
+     */
+    mark(id: string, v: string): string;
+    /** Forgets the stored zone for `id`. It is recorded again by the next scan that sees it. */
+    clear(id: string): void;
+    /**
+     * Returns the zone stored for `id`. For an ID that is not known (yet) it
+     * returns a zero zone whose `isZero()` is true and whose `inBounds()` is
+     * false, so `get('x').inBounds(msg)` is always safe to call.
+     */
+    get(id: string): ZoneInfo;
+    /**
+     * Strips the markers out of a view and records where each zone is. Call it
+     * once, on the outermost view, not inside child components.
+     *
+     * Unlike upstream, which hands the zones to a background worker, the zones are
+     * stored before `scan()` returns, so `get()` right afterwards sees them.
+     */
+    scan(v: string): string;
+    /**
+     * Sends a `MsgZoneInBounds` to `model.update()` for every zone the mouse event
+     * is inside, in alphabetical order of their IDs. The results of `update()` are
+     * discarded.
+     */
+    anyInBounds(model: Model, mouse: MouseMsg): void;
+    /**
+     * Like `anyInBounds()`, but the model returned by each `update()` is passed to
+     * the next one and returned at the end; the commands are combined with `Batch`.
+     */
+    anyInBoundsAndUpdate(model: Model, mouse: MouseMsg): [Model, Cmd];
+}
+/**
+ * Creates a manager that is not global. Give it to the components that mark
+ * zones and to the root model that scans.
+ */
+export declare function New(): Manager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAezC;;;GAGG;AACH,qBAAa,OAAO;;IAOlB,oFAAoF;IACpF,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKlC,8CAA8C;IAC9C,OAAO,IAAI,OAAO;IAIlB;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAInB;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAanC,4FAA4F;IAC5F,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIvB;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ;IAIzB;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAkCvB;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMhD;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;CASlE;AAED;;;GAGG;AACH,wBAAgB,GAAG,IAAI,OAAO,CAE7B"}

package/dist/messages.d.ts

@@ -0,0 +1,19 @@
+import type { MouseMsg } from '@oakoliver/bubbletea';
+import type { ZoneInfo } from './zoneinfo.js';
+/**
+ * Sent to a model by `anyInBounds()` for each zone a mouse event landed in.
+ * Recognised by `_tag`, like the Bubble Tea messages.
+ */
+export declare class MsgZoneInBounds {
+    /** The zone that is in bounds. */
+    readonly zone: ZoneInfo;
+    /** The mouse event that caused it. */
+    readonly event: MouseMsg;
+    readonly _tag: "MsgZoneInBounds";
+    constructor(
+    /** The zone that is in bounds. */
+    zone: ZoneInfo, 
+    /** The mouse event that caused it. */
+    event: MouseMsg);
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,qBAAa,eAAe;IAIxB,kCAAkC;aAClB,IAAI,EAAE,QAAQ;IAC9B,sCAAsC;aACtB,KAAK,EAAE,QAAQ;IANjC,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAU;;IAGzC,kCAAkC;IAClB,IAAI,EAAE,QAAQ;IAC9B,sCAAsC;IACtB,KAAK,EAAE,QAAQ;CAElC"}

package/dist/scanner.d.ts

@@ -0,0 +1,19 @@
+import { ZoneInfo } from './zoneinfo.js';
+/** Callbacks the scanner uses to talk to its manager. */
+export interface ScanHost {
+    /** Reports whether markers should be recorded (otherwise they are only stripped). */
+    readonly enabled: boolean;
+    /** Maps a marker sequence back to the ID given to `mark()`, or undefined if this manager did not create it. */
+    resolve(rid: string): string | undefined;
+    /** Called for each completed zone. */
+    emit(zone: ZoneInfo): void;
+}
+/**
+ * Strips every marker out of `input` and reports each zone whose start and end
+ * markers were both found. Returns the cleaned view.
+ *
+ * Positions are measured on the cleaned text: columns are the printable width
+ * of everything since the last newline, rows count newlines.
+ */
+export declare function scanView(host: ScanHost, input: string, iteration: number): string;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOzC,yDAAyD;AACzD,MAAM,WAAW,QAAQ;IACvB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+GAA+G;IAC/G,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,sCAAsC;IACtC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAqCjF"}

package/dist/width.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Cell-width measurement for the scanner.
+ *
+ * Upstream uses `runewidth.RuneWidth` on every code point of the text in front
+ * of a marker and skips ANSI escape sequences by hand. This is the same idea
+ * with two differences: OSC/DCS/APC/PM/SOS strings (hyperlinks, titles) are
+ * skipped up to their BEL or ST terminator instead of the first letter, and the
+ * width table is self-contained (no dependency).
+ */
+/** Printable width of one code point: 0 for controls and combining marks, 2 for wide, else 1. */
+export declare function runeWidth(cp: number): number;
+/**
+ * Returns the number of terminal cells `s` occupies when printed, skipping
+ * ANSI escape sequences.
+ */
+export declare function printableWidth(s: string): number;
+//# sourceMappingURL=width.d.ts.map

package/dist/width.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"width.d.ts","sourceRoot":"","sources":["../src/width.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiCH,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQ5C;AAKD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CA+ChD"}

package/dist/zoneinfo.d.ts

@@ -0,0 +1,51 @@
+import type { Mouse, MouseMsg } from '@oakoliver/bubbletea';
+/** Something that carries a mouse position: a Bubble Tea `MouseMsg` or a plain `{ x, y }`. */
+export type MouseLike = MouseMsg | Pick<Mouse, 'x' | 'y'>;
+/**
+ * Holds the start and end cells of a zone. All coordinates are zero-based and
+ * inclusive: `(endX, endY)` is the bottom-right cell that belongs to the zone.
+ */
+export declare class ZoneInfo {
+    /** The ID passed to `mark()`; empty for a zone that is not known yet. */
+    readonly id: string;
+    /** @internal The generated marker sequence that stands for `id` in a view. */
+    readonly rid: string;
+    /** @internal The scan this zone came from, used to drop stale zones. */
+    readonly iteration: number;
+    /** X of the top-left cell of the zone. */
+    startX: number;
+    /** Y of the top-left cell of the zone. */
+    startY: number;
+    /** X of the bottom-right cell of the zone. */
+    endX: number;
+    /** Y of the bottom-right cell of the zone. */
+    endY: number;
+    constructor(init?: {
+        id?: string;
+        rid?: string;
+        iteration?: number;
+        startX?: number;
+        startY?: number;
+        endX?: number;
+        endY?: number;
+    });
+    /** Reports whether the zone is not known (yet). `Manager.get()` returns such a zone for unknown IDs. */
+    isZero(): boolean;
+    /**
+     * Reports whether the mouse event is inside the box between the start and end
+     * cells. Unknown zones are never in bounds. A zone whose end lies before its
+     * start (for example text that wrapped onto the next line) is never in bounds
+     * either; for shapes a box cannot describe, do the check yourself.
+     */
+    inBounds(msg: MouseLike): boolean;
+    /**
+     * Returns the event position relative to the zone, with (0, 0) at its top-left
+     * cell, or `[-1, -1]` if the zone is unknown or the event is outside it.
+     */
+    pos(msg: MouseLike): [x: number, y: number];
+    /** Width in cells (0 for an unknown or inverted zone). */
+    get width(): number;
+    /** Height in rows (0 for an unknown or inverted zone). */
+    get height(): number;
+}
+//# sourceMappingURL=zoneinfo.d.ts.map

package/dist/zoneinfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoneinfo.d.ts","sourceRoot":"","sources":["../src/zoneinfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE5D,8FAA8F;AAC9F,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;AAQ1D;;;GAGG;AACH,qBAAa,QAAQ;IACnB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;gBAED,IAAI,GAAE;QAChB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACV;IAUN,wGAAwG;IACxG,MAAM,IAAI,OAAO;IAIjB;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IASjC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC;IAM3C,0DAA0D;IAC1D,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,0DAA0D;IAC1D,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@oakoliver/bubblezone",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Mouse hit-zones for Bubble Tea in TypeScript: mark a region of your view, scan once, ask whether a click landed inside it. Port of lrstanley/bubblezone",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build:esm": "esbuild src/index.ts --bundle --format=esm --platform=node --outfile=dist/index.js --target=esnext --external:@oakoliver/bubbletea",
+    "build:cjs": "esbuild src/index.ts --bundle --format=cjs --platform=node --outfile=dist/index.cjs --target=esnext --external:@oakoliver/bubbletea",
+    "build:types": "tsc --emitDeclarationOnly",
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "typecheck": "tsc --noEmit",
+    "typecheck:examples": "tsc -p examples/tsconfig.json",
+    "test": "bun test",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "tui",
+    "terminal",
+    "mouse",
+    "hit-testing",
+    "click",
+    "zones",
+    "bubbletea",
+    "bubblezone",
+    "charmbracelet",
+    "typescript"
+  ],
+  "author": "Antonio Oliveira <antonio@oakoliver.com> (https://oakoliver.com)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oakoliver/bubblezone"
+  },
+  "homepage": "https://github.com/oakoliver/bubblezone#readme",
+  "bugs": {
+    "url": "https://github.com/oakoliver/bubblezone/issues"
+  },
+  "peerDependencies": {
+    "@oakoliver/bubbletea": "^1.2.1",
+    "@oakoliver/lipgloss": "^1.1.3"
+  },
+  "peerDependenciesMeta": {
+    "@oakoliver/lipgloss": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@oakoliver/bubbles": "^1.2.2",
+    "@oakoliver/bubbletea": "^1.2.1",
+    "@oakoliver/lipgloss": "^1.1.3",
+    "@types/node": "^20",
+    "esbuild": "^0.28.2",
+    "typescript": "^5"
+  }
+}