@zaly/tui 0.0.4

package/dist/kitty-JbCJC0iQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kitty-JbCJC0iQ.mjs","names":["#support","#wrap"],"sources":["../src/image/kitty.ts"],"sourcesContent":["/**\n * Kitty Graphics Protocol — local-file transmission + native placements.\n *\n * Flow:\n *  1. Transmit once per src via `transmitFile(id, path)` (t=f). The\n *     terminal loads the image bytes from the file path; nothing of the\n *     image is transmitted over the wire beyond the path itself.\n *  2. On every render, emit `placement(imgId, placeId, { cols, rows })`\n *     at the target cursor position. Re-sending a placement with the\n *     same (image id, placement id) moves/resizes the existing placement\n *     without flicker — ideal for re-renders.\n *\n * Reference: https://sw.kovidgoyal.net/kitty/graphics-protocol/\n */\n\nimport type { MaybePromise } from \"@zaly/shared\"\nimport type { ImageInfo } from \"@zaly/shared/image\"\nimport type { TerminalQueries, TerminalQuery } from \"../input/queries.ts\"\n\nimport { isSSH } from \"@zaly/shared/env\"\n\nexport type KittyPlacement = {\n  imageId: number\n  /** Placement ID. Omitted when this is an inline placement (U=1) */\n  placementId?: number\n  /** inline: placement using unicode placeholder (U=1) */\n  inline?: boolean\n  /** The KGP escape sequence to place the image */\n  seq: string\n  /** Rows to render (excluding the placement escape sequence) */\n  data: string[]\n}\n\nexport type ImageSupport = {\n  terminal?: { name: string; version?: string }\n  remote?: boolean\n  wrap?: (seq: string) => string\n  tmux?: boolean\n} & (\n  | {\n      ok: false\n      error: string\n      terminal?: { name: string; version?: string }\n    }\n  | {\n      ok: true\n      error?: never\n      terminal: { name: string; version?: string }\n      inline?: boolean\n    }\n)\n\nexport type KittyResponse =\n  | {\n      attrs: Record<string, string | number>\n      ok: true\n    }\n  | {\n      attrs: Record<string, string | number>\n      ok: false\n      error: { code: string; message: string }\n    }\n\nexport type PlacementDims = {\n  /** Display width in terminal cells. */\n  cols: number\n  /** Display height in terminal cells. */\n  rows: number\n}\n\n// Per-src transmit cache. The first caller gets the full transmit sequence;\n// subsequent callers get undefined since the terminal already has the bytes.\ntype CacheEntry = {\n  imageId: number\n  seq: string\n  sent: boolean\n}\n\n// oxfmt-ignore\n// oxlint-disable-next-line unicorn/numeric-separators-style\nexport const DIACRITICS = [ 0x0305, 0x030d, 0x030e, 0x0310, 0x0312, 0x033d, 0x033e, 0x033f, 0x0346, 0x034a, 0x034b, 0x034c, 0x0350, 0x0351, 0x0352, 0x0357, 0x035b, 0x0363, 0x0364, 0x0365, 0x0366, 0x0367, 0x0368, 0x0369, 0x036a, 0x036b, 0x036c, 0x036d, 0x036e, 0x036f, 0x0483, 0x0484, 0x0485, 0x0486, 0x0487, 0x0592, 0x0593, 0x0594, 0x0595, 0x0597, 0x0598, 0x0599, 0x059c, 0x059d, 0x059e, 0x059f, 0x05a0, 0x05a1, 0x05a8, 0x05a9, 0x05ab, 0x05ac, 0x05af, 0x05c4, 0x0610, 0x0611, 0x0612, 0x0613, 0x0614, 0x0615, 0x0616, 0x0617, 0x0657, 0x0658, 0x0659, 0x065a, 0x065b, 0x065d, 0x065e, 0x06d6, 0x06d7, 0x06d8, 0x06d9, 0x06da, 0x06db, 0x06dc, 0x06df, 0x06e0, 0x06e1, 0x06e2, 0x06e4, 0x06e7, 0x06e8, 0x06eb, 0x06ec, 0x0730, 0x0732, 0x0733, 0x0735, 0x0736, 0x073a, 0x073d, 0x073f, 0x0740, 0x0741, 0x0743, 0x0745, 0x0747, 0x0749, 0x074a, 0x07eb, 0x07ec, 0x07ed, 0x07ee, 0x07ef, 0x07f0, 0x07f1, 0x07f3, 0x0816, 0x0817, 0x0818, 0x0819, 0x081b, 0x081c, 0x081d, 0x081e, 0x081f, 0x0820, 0x0821, 0x0822, 0x0823, 0x0825, 0x0826, 0x0827, 0x0829, 0x082a, 0x082b, 0x082c, 0x082d, 0x0951, 0x0953, 0x0954, 0x0f82, 0x0f83, 0x0f86, 0x0f87, 0x135d, 0x135e, 0x135f, 0x17dd, 0x193a, 0x1a17, 0x1a75, 0x1a76, 0x1a77, 0x1a78, 0x1a79, 0x1a7a, 0x1a7b, 0x1a7c, 0x1b6b, 0x1b6d, 0x1b6e, 0x1b6f, 0x1b70, 0x1b71, 0x1b72, 0x1b73, 0x1cd0, 0x1cd1, 0x1cd2, 0x1cda, 0x1cdb, 0x1ce0, 0x1dc0, 0x1dc1, 0x1dc3, 0x1dc4, 0x1dc5, 0x1dc6, 0x1dc7, 0x1dc8, 0x1dc9, 0x1dcb, 0x1dcc, 0x1dd1, 0x1dd2, 0x1dd3, 0x1dd4, 0x1dd5, 0x1dd6, 0x1dd7, 0x1dd8, 0x1dd9, 0x1dda, 0x1ddb, 0x1ddc, 0x1ddd, 0x1dde, 0x1ddf, 0x1de0, 0x1de1, 0x1de2, 0x1de3, 0x1de4, 0x1de5, 0x1de6, 0x1dfe, 0x20d0, 0x20d1, 0x20d4, 0x20d5, 0x20d6, 0x20d7, 0x20db, 0x20dc, 0x20e1, 0x20e7, 0x20e9, 0x20f0, 0x2cef, 0x2cf0, 0x2cf1, 0x2de0, 0x2de1, 0x2de2, 0x2de3, 0x2de4, 0x2de5, 0x2de6, 0x2de7, 0x2de8, 0x2de9, 0x2dea, 0x2deb, 0x2dec, 0x2ded, 0x2dee, 0x2def, 0x2df0, 0x2df1, 0x2df2, 0x2df3, 0x2df4, 0x2df5, 0x2df6, 0x2df7, 0x2df8, 0x2df9, 0x2dfa, 0x2dfb, 0x2dfc, 0x2dfd, 0x2dfe, 0x2dff, 0xa66f, 0xa67c, 0xa67d, 0xa6f0, 0xa6f1, 0xa8e0, 0xa8e1, 0xa8e2, 0xa8e3, 0xa8e4, 0xa8e5, 0xa8e6, 0xa8e7, 0xa8e8, 0xa8e9, 0xa8ea, 0xa8eb, 0xa8ec, 0xa8ed, 0xa8ee, 0xa8ef, 0xa8f0, 0xa8f1, 0xaab0, 0xaab2, 0xaab3, 0xaab7, 0xaab8, 0xaabe, 0xaabf, 0xaac1, 0xfe20, 0xfe21, 0xfe22, 0xfe23, 0xfe24, 0xfe25, 0xfe26, 0x10a0f, 0x10a38, 0x1d185, 0x1d186, 0x1d187, 0x1d188, 0x1d189, 0x1d1aa, 0x1d1ab, 0x1d1ac, 0x1d1ad, 0x1d242, 0x1d243, 0x1d244 ].map((c) => String.fromCodePoint(c))\nexport const PLACEHOLDER = String.fromCodePoint(0x10_ee_ee)\nconst CHUNK_SIZE = 4096\nconst transmitCache = new Map<string, CacheEntry>()\n\nconst known: Record<string, { inline?: boolean } | false | undefined> = {\n  ghostty: { inline: true },\n  kitty: { inline: true },\n  rio: { inline: false },\n  wezterm: { inline: false },\n}\n\nlet prom: Promise<Kitty> | undefined = undefined\nlet kitty: Kitty | undefined = undefined\nconst wrapTmux = (seq: string): string => `\\x1bPtmux;${seq.replaceAll(\"\\x1b\", \"\\x1b\\x1b\")}\\x1b\\\\`\n\n/** Allocate a fresh 24-bit image id (1..0xFFFFFFFE). */\nexport function allocateImageId(): number {\n  return Math.floor(Math.random() * 0xff_ff_fd) + 1\n}\n\n/** Allocate a fresh 24-bit placement id. */\nexport function allocatePlacementId(): number {\n  return Math.floor(Math.random() * 0xff_ff_fd) + 1\n}\n\nexport class Kitty {\n  #support: ImageSupport\n  #wrap: (seq: string) => string = (s) => s\n\n  constructor(support: ImageSupport) {\n    this.#support = support\n    this.#wrap = support.wrap ?? ((s) => s)\n  }\n\n  get supported(): boolean {\n    return this.#support.ok\n  }\n\n  get inline(): boolean {\n    return this.#support.ok && this.#support.inline === true\n  }\n\n  /** Create a KGP request escape sequence */\n  request(\n    attrs: Record<string, string | number>,\n    data?: string | Uint8Array,\n    opts: { base64?: boolean } = {}\n  ): string {\n    const params = Object.entries(attrs)\n      .map(([k, v]) => `${k}=${v}`)\n      .join(\",\")\n    let encoded: string | undefined\n    if (opts.base64 === false && typeof data === \"string\") encoded = data\n    else if (data)\n      encoded = toBase64(typeof data === \"string\" ? new TextEncoder().encode(data) : data)\n    const payload = encoded ? `;${encoded}` : \"\"\n    return this.#wrap(`\\x1b_G${params}${payload}\\x1b\\\\`)\n  }\n\n  /** Create a TerminalQuery that requests a KGP operation and parses the response. */\n  query(\n    attrs: Record<string, string | number>,\n    data?: string | Uint8Array,\n    opts: { base64?: boolean } = {}\n  ): TerminalQuery {\n    return {\n      match: (ev) => {\n        if (ev.kind !== \"apc\") return\n        const kr = this.parse(ev.sequence)\n        if (!kr) return\n        return { ...ev, ...kr }\n      },\n      request: this.request(attrs, data, opts),\n    }\n  }\n\n  /** Probe the terminal for KGP support. Should return an error response. */\n  probe(): string {\n    return this.request({ i: 4_294_967_290, s: 10, t: \"s\", v: 2 }, \"<error>\")\n  }\n\n  /** Parse a KGP response escape sequence into a structured object. */\n  parse(res: string): KittyResponse | undefined {\n    if (!res.startsWith(\"\\x1b_G\") || !res.endsWith(\"\\x1b\\\\\")) return undefined\n    const body = res.slice(3, -2)\n    const m = body.match(/^([^;]+);(.*)?$/)\n    if (!m) return undefined\n    const [_, params, data] = m as [string, string, string | undefined]\n    const attrs: Record<string, string | number> = {}\n    for (const pair of params.split(\",\")) {\n      const [k, v] = pair.split(\"=\", 2)\n      if (k && v) attrs[k] = /^\\d+$/.test(v) ? parseInt(v, 10) : v\n    }\n    if (data === \"OK\") return { attrs, ok: true }\n    const error = data?.match(/^([A-Z]+):\\s*(.*)$/)\n    return {\n      attrs,\n      error: error\n        ? { code: error[1], message: error[2] }\n        : { code: \"UNKNOWN\", message: data ?? \"\" },\n      ok: false,\n    }\n  }\n\n  placement(imageId: number, dims: PlacementDims): KittyPlacement | undefined {\n    if (!this.#support.ok) return\n    if (this.#support.inline)\n      return {\n        data: unicodePlaceholder(imageId, dims),\n        imageId,\n        inline: true,\n        seq: this.request({ U: 1, a: \"p\", c: dims.cols, i: imageId, q: 2, r: dims.rows }),\n      }\n    const blank = \" \".repeat(dims.cols)\n    const placementId = allocatePlacementId()\n    // NOTE: never sort this, since we need a deterministic order for bumping placements\n    // oxlint-disable-next-line sort-keys\n    const seq = this.request({\n      a: \"p\",\n      i: imageId,\n      p: placementId,\n      C: 1,\n      c: dims.cols,\n      q: 2,\n      r: dims.rows,\n    })\n    return {\n      data: Array.from<string>({ length: dims.rows }).fill(blank),\n      imageId,\n      placementId,\n      seq,\n    }\n  }\n\n  /** Delete an image and all its placements, or ALL images if `imageId` is omitted. */\n  deleteImage(imageId?: number): string {\n    return imageId === undefined\n      ? this.request({ a: \"d\", d: \"A\", q: 2 })\n      : this.request({ a: \"d\", d: \"I\", i: imageId, q: 2 })\n  }\n\n  /** Delete a placement (keeps image data so it can be re-placed cheaply). */\n  deletePlacement(imageId: number, placementId: number): string {\n    return this.request({ a: \"d\", d: \"i\", i: imageId, p: placementId, q: 2 })\n  }\n\n  /**\n   * Ensure an image has been transmitted to the terminal at least once.\n   * On the first call per `src`, returns the full `a=t,t=f` escape to be\n   * prepended to the caller's first row — the APC payload has zero display\n   * width, so layout sees through it. Subsequent calls return `transmit:\n   * \"\"` since the terminal already has the bytes under `imageId`.\n   *\n   * The caller is expected to combine this with `placement(...)` on every\n   * render to actually paint the image at the right cell rectangle.\n   */\n  async transmitOnce(info: ImageInfo): Promise<{ imageId: number; transmit?: string } | undefined> {\n    if (!this.#support.ok) return undefined\n    const { fileHash } = await import(\"@zaly/shared/detect\")\n    const key = fileHash(info)\n    let entry = transmitCache.get(key)\n    if (entry === undefined) {\n      const { imageConvert } = await import(\"@zaly/shared/image\")\n      const png = await imageConvert(info, \"png\")\n      if (!png) return undefined\n      const id = allocateImageId()\n      // Under SSH the terminal can't read files on the local side, so\n      // fall back to bytes-in-band (`t=d`). Locally we pass a path and\n      // the transmit payload stays under 1KB.\n      entry = {\n        imageId: id,\n        sent: false,\n        seq:\n          this.#support.remote || !png.path\n            ? this.transmitBytes(id, png.data)\n            : this.transmitFile(id, png.path),\n      }\n      transmitCache.set(key, entry)\n    }\n    if (entry.sent) {\n      entry.seq = \"\" // Clear the transmit memory\n      return { imageId: entry.imageId }\n    }\n    entry.sent = true\n    return { imageId: entry.imageId, transmit: entry.seq }\n  }\n\n  /**\n   * Transmit an image to the terminal by file path (`t=f`). Near-zero cost\n   * on the wire — the terminal opens and reads the file itself. `path`\n   * must be absolute and must point to a regular file; symlinks are\n   * followed by the terminal.\n   */\n  transmitFile(id: number, path: string): string {\n    return this.request({ a: \"t\", f: 100, i: id, q: 2, t: \"f\" }, path)\n  }\n\n  /**\n   * Remote/bytes transmission fallback (`t=d`) for when the terminal can't\n   * read local files — typical of SSH sessions. Base64-encodes and chunks\n   * the PNG payload at 4KB boundaries per the protocol.\n   */\n  transmitBytes(id: number, png: Uint8Array): string {\n    const base64 = toBase64(png)\n    const params = { a: \"t\", f: 100, i: id, q: 2, t: \"d\" }\n    if (base64.length <= CHUNK_SIZE) return this.request(params, base64, { base64: false })\n\n    const out: string[] = []\n    let offset = 0\n    let first = true\n    while (offset < base64.length) {\n      const chunk = base64.slice(offset, offset + CHUNK_SIZE)\n      offset += CHUNK_SIZE\n      const more = offset < base64.length ? 1 : 0\n      out.push(this.request(first ? { ...params, m: more } : { m: more }, chunk, { base64: false }))\n      first = false\n    }\n    return out.join(\"\")\n  }\n}\n\n/** Drop the per-src transmit cache. Mostly for tests. */\nexport function resetTransmitCache(): void {\n  transmitCache.clear()\n}\n\nexport function resetKittyGraphics(): void {\n  resetTransmitCache()\n  prom = undefined\n  kitty = undefined\n}\n\nfunction intToRgb(color24bit: number): { r: number; g: number; b: number } {\n  const r = (color24bit >> 16) & 0xff\n  const g = (color24bit >> 8) & 0xff\n  const b = color24bit & 0xff\n  return { b, g, r }\n}\n\nfunction unicodePlaceholder(id: number, dims: PlacementDims): string[] {\n  const rgb = intToRgb(id)\n  const rows = Math.min(DIACRITICS.length, dims.rows)\n  const cols = Math.min(DIACRITICS.length, dims.cols)\n  const fg = `\\x1b[38;2;${rgb.r};${rgb.g};${rgb.b}m`\n  const img: string[] = []\n  for (let r = 0; r < rows; r++) {\n    const line: string[] = []\n    for (let c = 0; c < cols; c++) {\n      line.push(fg)\n      line.push(PLACEHOLDER)\n      line.push(DIACRITICS[r])\n      line.push(DIACRITICS[c])\n    }\n    line.push(\"\\x1b[39m\")\n    img.push(line.join(\"\"))\n  }\n  return img\n}\n\nfunction toBase64(bytes: Uint8Array): string {\n  if (typeof Buffer !== \"undefined\") return Buffer.from(bytes).toString(\"base64\")\n  let binary = \"\"\n  for (const b of bytes) binary += String.fromCharCode(b)\n  return btoa(binary)\n}\n\nexport function bumpPlacements(\n  rows: string[]\n): undefined | { delete: () => string; rows: string[] } {\n  // We only need to bump placements when:\n  // - kitty graphics are loaded (when not loaded, there can't be any placements yet)\n  // - we're not using inline placements (when using inline, the placement is part of the row and doesn't need to be bumped)\n  if (!kitty || kitty.inline) return\n\n  const placements: { i: number; p: number }[] = []\n  const ret = rows.map((row) =>\n    row.replace(/\\x1b_Ga=p,i=(\\d+),p=(\\d+)/g, (_, i) => {\n      const imageId = parseInt(i, 10)\n      const placementId = allocatePlacementId()\n      placements.push({ i: imageId, p: placementId })\n      return `\\x1b_Ga=p,i=${imageId},p=${placementId}`\n    })\n  )\n  if (!placements.length) return\n  const k = kitty\n  return {\n    delete: () => placements.map((p) => k.deletePlacement(p.i, p.p)).join(\"\"),\n    rows: ret,\n  }\n}\n\nasync function detect(tq: TerminalQueries): Promise<ImageSupport> {\n  const support: Omit<ImageSupport, \"ok\" | \"error\"> = {\n    remote: isSSH,\n    tmux: !!process.env.TMUX,\n    // Escape sequences must be wrapped in a special way for tmux to pass them\n    // through to the underlying terminal.\n    wrap: process.env.TMUX ? wrapTmux : undefined,\n  }\n  if (support.tmux) {\n    try {\n      const { spawnCmd } = await import(\"@zaly/shared/process\")\n      // TMUX needs to have allow-passthrough set to all images to work properly\n      await spawnCmd(\"tmux\", \"set\", \"-p\", \"allow-passthrough\", \"on\")\n      support.wrap = wrapTmux\n    } catch (error) {\n      return {\n        ...support,\n        error: `Failed to set allow-passthrough in tmux: ${error instanceof Error ? error.message : String(error)}`,\n        ok: false,\n      }\n    }\n  }\n\n  const v = await tq.xtVersion({ wrap: support.wrap })\n  if (!v) return { error: \"Failed to query terminal name & version\", ok: false, ...support }\n\n  support.terminal = { name: v.name, version: v.version }\n\n  const kgp = known[v.name.toLowerCase()]\n  if (kgp === false)\n    return { error: `Terminal ${v.name} does not support KGP`, ok: false, ...support }\n\n  if (kgp === undefined) {\n    // Probe KGP support\n    // Create a tmp Kitty instance to probe the terminal for KGP support.\n    const k = new Kitty({ ...support, error: \"\", ok: false })\n    const res = await tq.query({\n      match: (ev) => {\n        if (ev.kind === \"apc\" && ev.payload.startsWith(\"G\")) return { kgp: true, ...ev }\n        if (ev.kind === \"csi\" && ev.final === \"c\" && ev.params.startsWith(\"?\"))\n          return { kgp: false, ...ev }\n        return\n      },\n      request: `${k.probe()}\\x1b[c`,\n      timeout: 200,\n    })\n    if (res?.kgp !== true)\n      return { error: \"Failed to query kitty graphics protocol\", ok: false, ...support }\n  }\n\n  return {\n    ...support,\n    inline: kgp?.inline,\n    ok: true,\n    terminal: { name: v.name, version: v.version },\n  }\n}\n\nexport function loadKittyGraphics(tq: TerminalQueries): MaybePromise<Kitty> {\n  if (kitty) return kitty\n  prom ??= (async () => (kitty = new Kitty(await detect(tq))))()\n  return prom\n}\n"],"mappings":";;AAgFA,MAAa,aAAa;CAAE;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CA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"}

package/dist/markdown.d.mts

@@ -0,0 +1,24 @@
+import { P as RenderCtx, p as Node } from "./queries-DH3bj74K.mjs";
+import { n as MdOptions, r as RenderMarkdown } from "./types-D3jk1rtk.mjs";
+//#region src/markdown/renderer.d.ts
+type MarkdownOptions = MdOptions & {
+  parent?: Node;
+};
+type MarkdownCtx = RenderCtx & {
+  images?: boolean;
+  highlight?: (code: string, lang?: string) => string;
+};
+declare class MarkdownRenderer {
+  #private;
+  constructor(opts?: MarkdownOptions);
+  render(source: string, ctx: MarkdownCtx): Promise<string>;
+  /** Mirror the source's trailing newlines: the renderer adds its own
+    /* padding after blocks (`\n\n` after paragraphs, etc.) which would
+    /* leave stray blank rows. Normalizing to what the caller typed keeps
+    /* single-line inputs compact and preserves explicit spacing when
+    /* they asked for it. */
+  normalizeEol(source: string, rendered: string): string;
+}
+//#endregion
+export { MarkdownCtx, MarkdownOptions, MarkdownRenderer, type MdOptions, type RenderMarkdown };
+//# sourceMappingURL=markdown.d.mts.map

package/dist/markdown.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.mts","names":[],"sources":["../src/markdown/renderer.ts"],"mappings":";;;KAKY,kBAAkB;EAC5B,SAAS;;KAGC,cAAc;EACxB;EACA,aAAa,cAAc;;cAGhB;;EAMX,YAAY,OAAM;EAKZ,OAAO,gBAAgB,KAAK,cAAc;;;;;;EAqChD,aAAa,gBAAgB"}

package/dist/markdown.mjs

@@ -0,0 +1,2 @@
+import { t as MarkdownRenderer } from "./renderer-CdLCkJB-.mjs";
+export { MarkdownRenderer };

package/dist/md.bun.d.mts

@@ -0,0 +1,14 @@
+import { n as MdOptions, t as MdCallbacks } from "./types-D3jk1rtk.mjs";
+//#region src/runtime/md.bun.d.ts
+/**
+ * Bun wrapper for `renderMarkdown`. `Bun.markdown.render` truncates code
+ * fence info-strings at the first whitespace, so attrs like
+ * `title="foo.ts"` never make it through. We pre-encode the spaces as
+ * NUL sentinels and decode the full string back into `{ language, title }`
+ * inside the `code` callback. Node's marked-backed impl parses info-
+ * strings natively, so the equivalent dance lives only here.
+ */
+declare function renderMarkdown(input: string, callbacks: MdCallbacks, opts?: MdOptions): string;
+//#endregion
+export { renderMarkdown };
+//# sourceMappingURL=md.bun.d.mts.map

package/dist/md.bun.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"md.bun.d.mts","names":[],"sources":["../src/runtime/md.bun.ts"],"mappings":";;;;;;;;;;iBAYgB,eAAe,eAAe,WAAW,aAAa,OAAO"}

package/dist/md.bun.mjs

@@ -0,0 +1,28 @@
+import { n as parseCodeInfoString, t as encodeFenceInfoStrings } from "./utils-3M4D_AXZ.mjs";
+//#region src/runtime/md.bun.ts
+/**
+* Bun wrapper for `renderMarkdown`. `Bun.markdown.render` truncates code
+* fence info-strings at the first whitespace, so attrs like
+* `title="foo.ts"` never make it through. We pre-encode the spaces as
+* NUL sentinels and decode the full string back into `{ language, title }`
+* inside the `code` callback. Node's marked-backed impl parses info-
+* strings natively, so the equivalent dance lives only here.
+*/
+function renderMarkdown(input, callbacks, opts) {
+	const encoded = encodeFenceInfoStrings(input);
+	const wrapped = callbacks.code === void 0 ? callbacks : {
+		...callbacks,
+		code: (text, meta) => callbacks.code(text, decodeCodeMeta(meta))
+	};
+	return Bun.markdown.render(encoded, wrapped, opts);
+}
+function decodeCodeMeta(meta) {
+	if (meta === void 0) return void 0;
+	if (meta.title !== void 0) return meta;
+	if (meta.language === void 0) return meta;
+	return parseCodeInfoString(meta.language) ?? meta;
+}
+//#endregion
+export { renderMarkdown };
+
+//# sourceMappingURL=md.bun.mjs.map

package/dist/md.bun.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"md.bun.mjs","names":[],"sources":["../src/runtime/md.bun.ts"],"sourcesContent":["import type { MdCallbacks, MdCodeBlockMeta, MdOptions } from \"../markdown/types.ts\"\n\nimport { encodeFenceInfoStrings, parseCodeInfoString } from \"../markdown/utils.ts\"\n\n/**\n * Bun wrapper for `renderMarkdown`. `Bun.markdown.render` truncates code\n * fence info-strings at the first whitespace, so attrs like\n * `title=\"foo.ts\"` never make it through. We pre-encode the spaces as\n * NUL sentinels and decode the full string back into `{ language, title }`\n * inside the `code` callback. Node's marked-backed impl parses info-\n * strings natively, so the equivalent dance lives only here.\n */\nexport function renderMarkdown(input: string, callbacks: MdCallbacks, opts?: MdOptions): string {\n  const encoded = encodeFenceInfoStrings(input)\n  const wrapped: MdCallbacks =\n    callbacks.code === undefined\n      ? callbacks\n      : {\n          ...callbacks,\n          code: (text, meta) => callbacks.code!(text, decodeCodeMeta(meta)),\n        }\n  return Bun.markdown.render(encoded, wrapped, opts)\n}\n\nfunction decodeCodeMeta(meta: MdCodeBlockMeta | undefined): MdCodeBlockMeta | undefined {\n  if (meta === undefined) return undefined\n  if (meta.title !== undefined) return meta\n  if (meta.language === undefined) return meta\n  return parseCodeInfoString(meta.language) ?? meta\n}\n"],"mappings":";;;;;;;;;;AAYA,SAAgB,eAAe,OAAe,WAAwB,MAA0B;CAC9F,MAAM,UAAU,uBAAuB,KAAK;CAC5C,MAAM,UACJ,UAAU,SAAS,KAAA,IACf,YACA;EACE,GAAG;EACH,OAAO,MAAM,SAAS,UAAU,KAAM,MAAM,eAAe,IAAI,CAAC;CAClE;CACN,OAAO,IAAI,SAAS,OAAO,SAAS,SAAS,IAAI;AACnD;AAEA,SAAS,eAAe,MAAgE;CACtF,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;CAC/B,IAAI,KAAK,UAAU,KAAA,GAAW,OAAO;CACrC,IAAI,KAAK,aAAa,KAAA,GAAW,OAAO;CACxC,OAAO,oBAAoB,KAAK,QAAQ,KAAK;AAC/C"}

package/dist/md.node.d.mts

@@ -0,0 +1,14 @@
+import { n as MdOptions, t as MdCallbacks } from "./types-D3jk1rtk.mjs";
+//#region src/markdown/marked.d.ts
+/**
+ * Walk the markdown source with `marked`'s lexer and invoke the caller's
+ * callbacks for each block / inline element. Output shape matches
+ * `Bun.markdown.render()` — same callback names, same metadata, same
+ * "null/undefined omits, missing callback passes through" semantics.
+ *
+ * @internal
+ */
+declare function renderMarkdown(input: string, callbacks: MdCallbacks, opts?: MdOptions): string;
+//#endregion
+export { renderMarkdown };
+//# sourceMappingURL=md.node.d.mts.map

package/dist/md.node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"md.node.d.mts","names":[],"sources":["../src/markdown/marked.ts"],"mappings":";;;;;;;;;;iBAuBgB,eAAe,eAAe,WAAW,aAAa,OAAO"}

package/dist/md.node.mjs

@@ -0,0 +1,126 @@
+import { n as parseCodeInfoString } from "./utils-3M4D_AXZ.mjs";
+import { marked } from "marked";
+//#region src/markdown/marked.ts
+/**
+* Walk the markdown source with `marked`'s lexer and invoke the caller's
+* callbacks for each block / inline element. Output shape matches
+* `Bun.markdown.render()` — same callback names, same metadata, same
+* "null/undefined omits, missing callback passes through" semantics.
+*
+* @internal
+*/
+function renderMarkdown(input, callbacks, opts) {
+	return renderTokens(marked.lexer(input, {
+		breaks: opts?.hardSoftBreaks ?? false,
+		gfm: true
+	}), callbacks, 0);
+}
+function renderTokens(tokens, cb, depth) {
+	let out = "";
+	for (const tok of tokens) out += renderToken(tok, cb, depth);
+	return out;
+}
+function renderToken(tok, cb, depth) {
+	switch (tok.type) {
+		case "heading": {
+			const t = tok;
+			return applyMeta(renderTokens(t.tokens, cb, depth), { level: t.depth }, cb.heading);
+		}
+		case "paragraph": return applyBlock(renderTokens(tok.tokens, cb, depth), cb.paragraph);
+		case "blockquote": return applyBlock(renderTokens(tok.tokens, cb, depth), cb.blockquote);
+		case "code": {
+			const t = tok;
+			const meta = parseCodeInfoString(t.lang);
+			if (cb.code === void 0) return t.text;
+			return cb.code(t.text, meta) ?? "";
+		}
+		case "list": {
+			const t = tok;
+			const ordered = t.ordered;
+			const start = ordered && t.start !== "" ? t.start : void 0;
+			const childDepth = depth + 1;
+			let items = "";
+			for (let i = 0; i < t.items.length; i++) {
+				const item = t.items[i];
+				const kids = renderTokens(item.tokens, cb, childDepth);
+				const meta = {
+					checked: item.task ? item.checked : void 0,
+					depth,
+					index: i,
+					ordered,
+					start
+				};
+				items += applyMeta(kids, meta, cb.listItem);
+			}
+			return applyMeta(items, {
+				depth,
+				ordered,
+				start
+			}, cb.list);
+		}
+		case "hr": return applyBlock("", cb.hr);
+		case "table": {
+			const t = tok;
+			const aligns = t.align;
+			const renderCell = (cell, col, fn) => {
+				const kids = renderTokens(cell.tokens, cb, depth);
+				const a = aligns[col];
+				const meta = a === null ? void 0 : { align: a };
+				if (fn === void 0) return kids;
+				return fn(kids, meta) ?? "";
+			};
+			return applyBlock(applyBlock(applyBlock(t.header.map((c, i) => renderCell(c, i, cb.th)).join(""), cb.tr), cb.thead) + applyBlock(t.rows.map((row) => applyBlock(row.map((c, i) => renderCell(c, i, cb.td)).join(""), cb.tr)).join(""), cb.tbody), cb.table);
+		}
+		case "html": return applyBlock(tok.text, cb.html);
+		case "space": return "";
+		case "strong": return applyBlock(renderTokens(tok.tokens, cb, depth), cb.strong);
+		case "em": return applyBlock(renderTokens(tok.tokens, cb, depth), cb.emphasis);
+		case "codespan": {
+			const t = tok;
+			if (cb.codespan === void 0) return t.text;
+			return cb.codespan(t.text) ?? "";
+		}
+		case "del": return applyBlock(renderTokens(tok.tokens, cb, depth), cb.strikethrough);
+		case "link": {
+			const t = tok;
+			return applyMeta(renderTokens(t.tokens, cb, depth), {
+				href: t.href,
+				title: t.title ?? void 0
+			}, cb.link);
+		}
+		case "image": {
+			const t = tok;
+			const meta = {
+				src: t.href,
+				title: t.title ?? void 0
+			};
+			if (cb.image === void 0) return t.text;
+			return cb.image(t.text, meta) ?? "";
+		}
+		case "br": return "\n";
+		case "checkbox": return "";
+		case "escape": return applyText(tok.text, cb);
+		case "text": {
+			const t = tok;
+			if (t.tokens) return renderTokens(t.tokens, cb, depth);
+			return applyText(t.text, cb);
+		}
+		default: return tok.text ?? tok.raw ?? "";
+	}
+}
+function applyBlock(children, fn) {
+	if (fn === void 0) return children;
+	return fn(children) ?? "";
+}
+function applyMeta(children, meta, fn) {
+	if (fn === void 0) return children;
+	return fn(children, meta) ?? "";
+}
+function applyText(text, cb) {
+	if (cb.text === void 0) return text;
+	return cb.text(text) ?? "";
+}
+//#endregion
+export { renderMarkdown };
+
+//# sourceMappingURL=md.node.mjs.map

package/dist/md.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"md.node.mjs","names":["t"],"sources":["../src/markdown/marked.ts"],"sourcesContent":["import type { Token, Tokens } from \"marked\"\nimport type {\n  CbNoMeta,\n  MdCallbacks,\n  MdCellMeta,\n  MdImageMeta,\n  MdListItemMeta,\n  MdOptions,\n} from \"./types.ts\"\n\nimport { marked } from \"marked\"\nimport { parseCodeInfoString } from \"./utils.ts\"\n\n// ── Implementation (Node-side; Bun's runtime passes through to Bun.markdown) ──\n\n/**\n * Walk the markdown source with `marked`'s lexer and invoke the caller's\n * callbacks for each block / inline element. Output shape matches\n * `Bun.markdown.render()` — same callback names, same metadata, same\n * \"null/undefined omits, missing callback passes through\" semantics.\n *\n * @internal\n */\nexport function renderMarkdown(input: string, callbacks: MdCallbacks, opts?: MdOptions): string {\n  const tokens = marked.lexer(input, {\n    breaks: opts?.hardSoftBreaks ?? false,\n    gfm: true,\n  })\n  return renderTokens(tokens, callbacks, 0)\n}\n\nfunction renderTokens(tokens: Token[], cb: MdCallbacks, depth: number): string {\n  let out = \"\"\n  for (const tok of tokens) out += renderToken(tok, cb, depth)\n  return out\n}\n\nfunction renderToken(tok: Token, cb: MdCallbacks, depth: number): string {\n  switch (tok.type) {\n    case \"heading\": {\n      const t = tok as Tokens.Heading\n      const children = renderTokens(t.tokens, cb, depth)\n      return applyMeta(children, { level: t.depth }, cb.heading)\n    }\n    case \"paragraph\": {\n      const t = tok as Tokens.Paragraph\n      const children = renderTokens(t.tokens, cb, depth)\n      return applyBlock(children, cb.paragraph)\n    }\n    case \"blockquote\": {\n      const t = tok as Tokens.Blockquote\n      const children = renderTokens(t.tokens, cb, depth)\n      return applyBlock(children, cb.blockquote)\n    }\n    case \"code\": {\n      const t = tok as Tokens.Code\n      const meta = parseCodeInfoString(t.lang)\n      if (cb.code === undefined) return t.text\n      return cb.code(t.text, meta) ?? \"\"\n    }\n    case \"list\": {\n      const t = tok as Tokens.List\n      const ordered = t.ordered\n      const start = ordered && t.start !== \"\" ? t.start : undefined\n      const childDepth = depth + 1\n      let items = \"\"\n      for (let i = 0; i < t.items.length; i++) {\n        const item = t.items[i]\n        const kids = renderTokens(item.tokens, cb, childDepth)\n        const meta: MdListItemMeta = {\n          checked: item.task ? item.checked : undefined,\n          depth,\n          index: i,\n          ordered,\n          start,\n        }\n        items += applyMeta(kids, meta, cb.listItem)\n      }\n      return applyMeta(items, { depth, ordered, start }, cb.list)\n    }\n    case \"hr\": {\n      return applyBlock(\"\", cb.hr)\n    }\n    case \"table\": {\n      const t = tok as Tokens.Table\n      const aligns = t.align\n      const renderCell = (\n        cell: Tokens.TableCell,\n        col: number,\n        fn: MdCallbacks[\"th\"] | MdCallbacks[\"td\"]\n      ): string => {\n        const kids = renderTokens(cell.tokens, cb, depth)\n        const a = aligns[col]\n        const meta: MdCellMeta | undefined = a === null ? undefined : { align: a }\n        if (fn === undefined) return kids\n        return fn(kids, meta) ?? \"\"\n      }\n      const headerRow = t.header.map((c, i) => renderCell(c, i, cb.th)).join(\"\")\n      const thead = applyBlock(applyBlock(headerRow, cb.tr), cb.thead)\n      const bodyRows = t.rows\n        .map((row) => applyBlock(row.map((c, i) => renderCell(c, i, cb.td)).join(\"\"), cb.tr))\n        .join(\"\")\n      const tbody = applyBlock(bodyRows, cb.tbody)\n      return applyBlock(thead + tbody, cb.table)\n    }\n    case \"html\": {\n      const t = tok as Tokens.HTML\n      return applyBlock(t.text, cb.html)\n    }\n    case \"space\": {\n      // marked emits these for inter-block whitespace; drop — block callbacks\n      // add their own trailing separators.\n      return \"\"\n    }\n    case \"strong\": {\n      const t = tok as Tokens.Strong\n      const children = renderTokens(t.tokens, cb, depth)\n      return applyBlock(children, cb.strong)\n    }\n    case \"em\": {\n      const t = tok as Tokens.Em\n      const children = renderTokens(t.tokens, cb, depth)\n      return applyBlock(children, cb.emphasis)\n    }\n    case \"codespan\": {\n      const t = tok as Tokens.Codespan\n      if (cb.codespan === undefined) return t.text\n      return cb.codespan(t.text) ?? \"\"\n    }\n    case \"del\": {\n      const t = tok as Tokens.Del\n      const children = renderTokens(t.tokens, cb, depth)\n      return applyBlock(children, cb.strikethrough)\n    }\n    case \"link\": {\n      const t = tok as Tokens.Link\n      const children = renderTokens(t.tokens, cb, depth)\n      return applyMeta(children, { href: t.href, title: t.title ?? undefined }, cb.link)\n    }\n    case \"image\": {\n      const t = tok as Tokens.Image\n      const meta: MdImageMeta = { src: t.href, title: t.title ?? undefined }\n      if (cb.image === undefined) return t.text\n      return cb.image(t.text, meta) ?? \"\"\n    }\n    case \"br\": {\n      return \"\\n\"\n    }\n    case \"checkbox\": {\n      // marked emits this as a sibling of the task-item content. Drop —\n      // the state is already carried on MdListItemMeta.checked.\n      return \"\"\n    }\n    case \"escape\": {\n      const t = tok as Tokens.Escape\n      return applyText(t.text, cb)\n    }\n    case \"text\": {\n      const t = tok as Tokens.Text\n      // Block-level text wrappers carry inline tokens — recurse.\n      if (t.tokens) return renderTokens(t.tokens, cb, depth)\n      return applyText(t.text, cb)\n    }\n    default: {\n      // Unknown / unsupported — pass through raw if available.\n      const raw = (tok as { text?: string; raw?: string }).text\n      return raw ?? (tok as { raw?: string }).raw ?? \"\"\n    }\n  }\n}\n\nfunction applyBlock(children: string, fn: CbNoMeta | undefined): string {\n  if (fn === undefined) return children\n  return fn(children) ?? \"\"\n}\n\nfunction applyMeta<M>(\n  children: string,\n  meta: M,\n  fn: ((children: string, meta: M) => string | null | undefined) | undefined\n): string {\n  if (fn === undefined) return children\n  return fn(children, meta) ?? \"\"\n}\n\nfunction applyText(text: string, cb: MdCallbacks): string {\n  if (cb.text === undefined) return text\n  return cb.text(text) ?? \"\"\n}\n"],"mappings":"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"}

package/dist/node-BZ7f6HzU.mjs

@@ -0,0 +1,316 @@
+import { S as unwrap, T as withActiveNode, p as inRenderContextOf, u as createStore } from "./reactive-f7NpAi69.mjs";
+import { Emitter } from "@zaly/shared";
+//#region src/core/node.ts
+/**
+* Public Node handle. Calling `render(ctx)` returns the node's rows from the
+* per-node cache, recomputing only if state read inside `_render` has changed
+* since the last call.
+*
+* Concrete subclasses implement the protected `_render(ctx)` hook; the public
+* `render` is the caching wrapper around it.
+*
+* State is a `createStore` proxy: reads inside `_render` track per-field;
+* mutating a read field invalidates this node. Three write forms:
+*
+*   - `n.state.field = value`               (direct assignment)
+*   - `n.state.set({ field: value, ... })`  (patch — partial merge)
+*   - `n.state.set(current => ({ ... }))`   (updater — receives untracked current)
+*
+* Writes through nested objects/arrays (`n.state.padding[0] = 1`) do NOT —
+* reassign the whole field instead.
+*/
+var Node = class extends Emitter {
+	#cache;
+	#parent;
+	#rendering;
+	/** Bumped on every `invalidate()`. Captured at the start of a render
+	*  and re-checked after `_render` resolves: if the count moved, an
+	*  external mutation landed during the render and the rows we just
+	*  produced reflect pre-mutation state. We skip writing the cache in
+	*  that case so the surface's already-scheduled re-paint sees a
+	*  cache miss and re-renders against the latest state. */
+	#invalidations = 0;
+	#children = [];
+	#state;
+	#ctx;
+	#id;
+	#actionTargets = /* @__PURE__ */ new Set();
+	#mountAc;
+	actions;
+	type;
+	constructor(state, ...children) {
+		super();
+		this.onEmitError = (err) => {
+			const logger = this.logger;
+			if (logger) logger.error(err);
+			else console.error("Uncaught node event error (node is unmounted, no ctx):", err);
+		};
+		this.#state = createStore(state);
+		children.forEach((c) => this.add(c));
+	}
+	withEvents() {
+		return this;
+	}
+	withActions(actions) {
+		this.actions = {
+			...this.actions,
+			...actions
+		};
+		return this;
+	}
+	action(id, opts) {
+		const entry = this.actions?.[id];
+		const fn = typeof entry === "function" ? entry : entry?.fn;
+		if (!fn) return false;
+		fn({
+			source: "programmatic",
+			target: this,
+			...opts,
+			id,
+			node: this
+		});
+		return true;
+	}
+	get mountSignal() {
+		this.#mountAc ??= new AbortController();
+		return this.#mountAc.signal;
+	}
+	get state() {
+		return this.#state;
+	}
+	get children() {
+		return this.#children;
+	}
+	get logger() {
+		return this.#ctx?.logger.child({
+			id: this.#id,
+			name: "node",
+			node: this.type ?? "unknown"
+		});
+	}
+	try(fn) {
+		const logger = this.logger;
+		if (!logger) return fn();
+		return logger.try(fn);
+	}
+	get parent() {
+		return this.#parent;
+	}
+	/** Mount context when this node is attached to a surface — surface
+	*  identifier plus scoped handles to router / overlay / tree lookups.
+	*  `undefined` before mount and after unmount. Exposed so widget
+	*  authors can reach renderer services without closing over a ref. */
+	get ctx() {
+		return this.#ctx;
+	}
+	get surface() {
+		return this.#ctx?.surface;
+	}
+	get mounted() {
+		return this.#ctx !== void 0;
+	}
+	id(value) {
+		if (value === void 0) return this.#id;
+		this.#id = value;
+		return this;
+	}
+	async getLayout(ctx) {
+		if (!this.layout) return;
+		return this.layout(ctx);
+	}
+	get layoutNodes() {
+		if (this.layoutChildren === void 0) return [this];
+		const ret = [];
+		for (const c of this.with(() => this.layoutChildren?.()) ?? []) ret.push(...c.layoutNodes);
+		return ret;
+	}
+	addActionTarget(node) {
+		this.#actionTargets.add(node);
+		return this;
+	}
+	removeActionTarget(node) {
+		this.#actionTargets.delete(node);
+		return this;
+	}
+	get actionTargets() {
+		return this.#actionTargets;
+	}
+	invalidate() {
+		this.#cache = void 0;
+		if (inRenderContextOf(this)) return this;
+		this.#invalidations++;
+		this.emit("invalidate");
+		this.parent?.invalidate();
+		return this;
+	}
+	with(fn) {
+		return withActiveNode(this, () => fn());
+	}
+	async render(ctx) {
+		this.#rendering ??= this.with(() => this.#render(ctx));
+		try {
+			return await this.#rendering;
+		} finally {
+			this.#rendering = void 0;
+		}
+	}
+	async #render(ctx) {
+		if (!(unwrap(this.state.visible) ?? true)) {
+			this.#cache = {
+				rows: [],
+				version: ctx.version,
+				width: ctx.width
+			};
+			return this.#cache.rows;
+		}
+		if (this.#cache?.version === ctx.version && this.#cache.width === ctx.width) return this.#cache.rows;
+		const stamp = this.#invalidations;
+		try {
+			const rows = await this._render(ctx);
+			if (this.#invalidations === stamp) this.#cache = {
+				rows,
+				version: ctx.version,
+				width: ctx.width
+			};
+			return rows;
+		} catch (error) {
+			this.logger?.error(error);
+			this.#cache = void 0;
+			return [ctx.style.error(`[Node render error: ${error instanceof Error ? error.message : String(error)}]`)];
+		}
+	}
+	add(child) {
+		this.splice(this.#children.length, 0, child);
+		return this;
+	}
+	remove(child) {
+		const i = this.#children.indexOf(child);
+		if (i === -1) return this;
+		this.splice(i, 1);
+		return this;
+	}
+	splice(start, deleteCount, ...items) {
+		const filtered = [];
+		for (const c of items) {
+			if (c === this) continue;
+			filtered.push(c);
+		}
+		let adjustedStart = Math.max(0, Math.min(start, this.#children.length));
+		for (const c of filtered) {
+			if (c.parent !== this) continue;
+			const i = this.#children.indexOf(c);
+			if (i === -1) continue;
+			this.#children.splice(i, 1);
+			if (i < adjustedStart) adjustedStart--;
+		}
+		const removed = this.#children.splice(adjustedStart, deleteCount, ...filtered);
+		for (const c of removed) {
+			this.emit("childremoved", { child: c });
+			if (c.mounted) c.unmount();
+			if (c.parent === this) c.#parent = void 0;
+		}
+		for (const c of filtered) {
+			if (c.parent && c.parent !== this) {
+				c.unmount();
+				c.parent.remove(c);
+			}
+			c.#parent = this;
+			this.emit("childadded", { child: c });
+			if (this.#ctx !== void 0) c.mount(this.#ctx);
+		}
+		this.invalidate();
+		return this;
+	}
+	clear() {
+		this.splice(0, this.#children.length);
+		return this;
+	}
+	mount(ctx) {
+		if (this.#ctx?.surface === ctx.surface) return this;
+		if (this.#ctx) throw new Error(`Node is already mounted on "${this.#ctx.surface}" (requested "${ctx.surface}"). Unmount first if you meant to move it.`);
+		withActiveNode(this, () => unwrap(this.state.visible));
+		this.#ctx = ctx;
+		this.#registerActionMeta(ctx);
+		this.emit("mount");
+		for (const c of this.#children) c.mount(ctx);
+		return this;
+	}
+	/** Contribute any `ActionInfo`-shaped entries in `this.actions` to
+	*  the catalog. The instance `fn` stays on the node (dispatch finds
+	*  it via the focus-chain walk); only metadata lands in the registry.
+	*  Uses `extend: false` so defaults don't clobber user overrides
+	*  that were registered before the widget mounted. */
+	#registerActionMeta(ctx) {
+		if (!this.actions) return;
+		const metas = {};
+		let any = false;
+		for (const [id, entry] of Object.entries(this.actions)) {
+			if (typeof entry === "function") continue;
+			const { fn: _fn, ...info } = entry;
+			metas[id] = info;
+			any = true;
+		}
+		if (any) ctx.actions.register(metas, { default: true });
+	}
+	unmount() {
+		if (!this.#ctx) return this;
+		this.#mountAc?.abort();
+		this.#mountAc = void 0;
+		for (const c of this.#children) c.unmount();
+		this.emit("unmount");
+		this.#ctx.input.blur(this);
+		this.#ctx = void 0;
+		return this;
+	}
+	/** Become the focused node. Routes through the MountCtx, which emits
+	*  `blur` on the previous focus and `focus` on this node.
+	*
+	*  When called before the node is mounted (the common case for
+	*  `input({ focus: true }).on(...)` style setup), the focus is
+	*  deferred until the next `mount` event. That keeps the API
+	*  synchronous and side-effect-free at build time — callers don't
+	*  have to think about ordering. */
+	focus() {
+		if (!this.#ctx) {
+			this.once("mount", () => this.focus());
+			return this;
+		}
+		this.#ctx.input.focus(this);
+		return this;
+	}
+	/** Release focus. No-op when not mounted. */
+	blur() {
+		this.#ctx?.input.blur(this);
+		return this;
+	}
+	get visible() {
+		return unwrap(this.state.visible) ?? true;
+	}
+	show() {
+		if (this.visible) return this;
+		this.state.visible = true;
+		this.emit("show");
+		return this;
+	}
+	hide() {
+		if (!this.visible) return this;
+		this.state.visible = false;
+		this.emit("hide");
+		return this;
+	}
+	toggle() {
+		this.state.visible = !this.visible;
+		return this;
+	}
+	ref(ref) {
+		if (ref) ref.value = this;
+		return this;
+	}
+	isVisible() {
+		return this.visible && (this.parent ? this.parent.isVisible() : true);
+	}
+};
+//#endregion
+export { Node as t };
+
+//# sourceMappingURL=node-BZ7f6HzU.mjs.map