waybetter 0.1.1 → 0.6.0

package/dist/runtime/column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.js","sourceRoot":"","sources":["../../../runtime/src/column.ts"],"names":[],"mappings":"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","sourcesContent":["// Power User Mode, page side: a site tab that is a deck column (see shell/deckModel.ts). The shell\n// lays the column out; native code hands this module the column's config. Here the page hides the\n// site's chrome (rail, side column, floating buttons), lets the content column fill the width,\n// applies the column's density and filters, and tracks unread items. It never makes a request and\n// never clicks anything on its own except what the adapter's `prepare` does (navigation only, e.g.\n// selecting one of the site's own timeline tabs). Unread items are counted from what the site has\n// rendered: new item ids above the ones already seen, not yet scrolled into view. Only the count\n// leaves the page (the adapter reports it through its own bridge).\n\nimport { watchDom, type DomWatchHandle } from './domHub.ts';\n\nexport type ColumnDensity = 'compact' | 'comfortable';\n\nexport type ColumnFiltersConfig = { terms: string[]; hideReplies: boolean; hideReposts: boolean; mediaOnly: boolean };\n\n/** What native code delivers for one column (validated there too; see waybetter-host `ColumnConfig`). */\nexport type ColumnConfig = {\n  /** The column's own page (its source); chrome that only makes sense elsewhere hides only here. */\n  url: string;\n  density: ColumnDensity;\n  filters: ColumnFiltersConfig;\n  /** Count unread items and report them. */\n  unread: boolean;\n  /** Increments when the shell asks to mark everything read / jump to the first unread item. */\n  readSeq: number;\n  jumpSeq: number;\n  /** Source kind (adapter-defined), for `prepare`. */\n  kind: string;\n};\n\nexport type ItemKind = { reply: boolean; repost: boolean; media: boolean };\n\nexport type ColumnSite = {\n  /** Prefix of the attributes/ids this module owns (`data-<prefix>-column`, `<prefix>-column-css`). */\n  prefix: string;\n  /** The site's content column; it fills the column width. */\n  keep: string;\n  /** Always hidden in a column. */\n  hide: readonly string[];\n  /** Hidden only on the column's own page (e.g. a page title the column header repeats). */\n  sourceHide?: readonly string[];\n  /** Items for filters and the unread tracker. */\n  itemSelector: string;\n  /** The element hidden for a filtered item (default: the item itself). */\n  container?(item: Element): Element;\n  /** A stable id for an item (e.g. a post id), or null to ignore it. */\n  itemId(item: Element): string | null;\n  itemKind?(item: Element): ItemKind;\n  itemText?(item: Element): string;\n  /** Items the site announces but has not rendered yet (e.g. a \"Show 12 posts\" button); 0 = none. */\n  pendingCount?(doc: Document): number;\n  /** Site CSS for the column (density-aware); every rule should be scoped to `html[data-<prefix>-column]`. */\n  css?(density: ColumnDensity): string;\n  /** Navigation-only setup on the source page (e.g. select a timeline tab); true once done. */\n  prepare?(doc: Document, config: ColumnConfig): boolean;\n};\n\nexport type ColumnHandle = {\n  set(config: unknown): void;\n  markRead(): void;\n  jumpToUnread(): void;\n  /** Current unread count (tracked + pending), 0 when off. */\n  unread(): number;\n  dispose(): void;\n};\n\nexport type ColumnWindow = Window & typeof globalThis;\n\nconst MAX_TERMS = 32;\nconst MAX_TERM_CHARS = 200;\nconst MAX_IDS = 2000;\n\n// ---------------------------------------------------------------------------------------------\n// Config and filters (pure)\n\nexport function normalizeColumnConfig(value: unknown): ColumnConfig | null {\n  if (!value || typeof value !== 'object') return null;\n  const raw = value as Record<string, unknown>;\n  if (typeof raw.url !== 'string' || raw.url.length > 2048) return null;\n  const filters = (raw.filters && typeof raw.filters === 'object' ? raw.filters : {}) as Record<string, unknown>;\n  const terms = (Array.isArray(filters.terms) ? filters.terms : [])\n    .filter((term): term is string => typeof term === 'string' && term.trim().length > 0 && term.length <= MAX_TERM_CHARS)\n    .slice(0, MAX_TERMS);\n  const seq = (n: unknown) => (typeof n === 'number' && Number.isFinite(n) && n >= 0 ? Math.floor(n) : 0);\n  return {\n    url: raw.url,\n    density: raw.density === 'comfortable' ? 'comfortable' : 'compact',\n    filters: { terms, hideReplies: filters.hideReplies === true, hideReposts: filters.hideReposts === true, mediaOnly: filters.mediaOnly === true },\n    unread: raw.unread !== false,\n    readSeq: seq(raw.readSeq),\n    jumpSeq: seq(raw.jumpSeq),\n    kind: typeof raw.kind === 'string' && raw.kind.length <= 24 ? raw.kind : '',\n  };\n}\n\n/** `/pattern/flags` → RegExp (flags i, m, s, u only); anything else is a plain keyword. Invalid → null. */\nexport function parseTerm(term: string): RegExp | string | null {\n  const text = term.trim();\n  if (!text) return null;\n  const match = /^\\/(.+)\\/([imsu]*)$/.exec(text);\n  if (!match) return text.toLowerCase();\n  try {\n    return new RegExp(match[1]!, match[2]!.includes('i') ? match[2] : `${match[2]}i`);\n  } catch {\n    return null;\n  }\n}\n\nexport type FilterInput = { text: string } & ItemKind;\n\n/** A predicate that says whether an item is hidden by the column's filters. */\nexport function compileFilters(filters: ColumnFiltersConfig): (item: FilterInput) => boolean {\n  const terms = filters.terms.map(parseTerm).filter((term): term is RegExp | string => term !== null);\n  const active = terms.length > 0 || filters.hideReplies || filters.hideReposts || filters.mediaOnly;\n  if (!active) return () => false;\n  return item => {\n    if (filters.hideReplies && item.reply) return true;\n    if (filters.hideReposts && item.repost) return true;\n    if (filters.mediaOnly && !item.media) return true;\n    if (!terms.length) return false;\n    const lower = item.text.toLowerCase();\n    for (const term of terms) {\n      if (typeof term === 'string' ? lower.includes(term) : term.test(item.text)) return true;\n    }\n    return false;\n  };\n}\n\n/** Same page: origin, path (trailing slash ignored) and query. */\nexport function isSourcePage(href: string, source: string): boolean {\n  try {\n    const a = new URL(href);\n    const b = new URL(source);\n    const path = (url: URL) => url.pathname.replace(/\\/+$/, '') || '/';\n    return a.origin === b.origin && path(a) === path(b) && a.search === b.search;\n  } catch {\n    return false;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Unread tracking (pure: fed with the rendered items in document order)\n\nexport type UnreadTracker = {\n  /**\n   * The rendered items, top to bottom, and which of them are on screen right now. The first\n   * non-empty observation is the baseline (read). Later, an id rendered above both the topmost\n   * read id and the topmost item on screen is unread (new, not seen yet); ids below are older\n   * items (read).\n   */\n  observe(ordered: readonly string[], onScreen: ReadonlySet<string>): void;\n  /** An item came on screen. */\n  seen(id: string): void;\n  markRead(): void;\n  count(): number;\n  /** The unread item closest to the read ones (the next one to read, scrolling up), if rendered. */\n  nextUnread(ordered: readonly string[]): string | null;\n  isUnread(id: string): boolean;\n};\n\nexport function createUnreadTracker(): UnreadTracker {\n  const read = new Set<string>();\n  const unread = new Set<string>();\n  let baseline = false;\n  const remember = (set: Set<string>, id: string) => {\n    set.add(id);\n    if (set.size > MAX_IDS) set.delete(set.values().next().value as string);\n  };\n  return {\n    observe(ordered, onScreen) {\n      if (!ordered.length) return;\n      if (!baseline) {\n        baseline = true;\n        for (const id of ordered) remember(read, id);\n        return;\n      }\n      const topRead = ordered.findIndex(id => read.has(id));\n      const topShown = ordered.findIndex(id => onScreen.has(id));\n      const limit = topShown >= 0 && topRead >= 0 ? Math.min(topRead, topShown) : topRead;\n      ordered.forEach((id, index) => {\n        if (read.has(id) || unread.has(id)) {\n          if (onScreen.has(id) && unread.delete(id)) remember(read, id);\n          return;\n        }\n        if (limit >= 0 && index < limit && !onScreen.has(id)) remember(unread, id);\n        else remember(read, id);\n      });\n    },\n    seen(id) {\n      if (unread.delete(id)) remember(read, id);\n    },\n    markRead() {\n      for (const id of unread) remember(read, id);\n      unread.clear();\n    },\n    count: () => unread.size,\n    nextUnread(ordered) {\n      for (let i = ordered.length - 1; i >= 0; i--) if (unread.has(ordered[i]!)) return ordered[i]!;\n      return null;\n    },\n    isUnread: id => unread.has(id),\n  };\n}\n\n// ---------------------------------------------------------------------------------------------\n// The page module\n\nconst names = (site: ColumnSite) => ({\n  style: `${site.prefix}-column-css`,\n  column: `data-${site.prefix}-column`,\n  home: `data-${site.prefix}-column-home`,\n  density: `data-${site.prefix}-density`,\n  filtered: `data-${site.prefix}-filtered`,\n  unread: `data-${site.prefix}-unread`,\n});\n\n/** Pure: the module's stylesheet. Every rule is scoped to the column attribute on <html>. */\nexport function buildColumnCss(site: ColumnSite, density: ColumnDensity): string {\n  const n = names(site);\n  const root = `html[${n.column}]`;\n  const rules = [\n    site.hide.length ? `${root} :is(${site.hide.join(', ')}) { display: none !important; }` : '',\n    site.sourceHide?.length ? `${root}[${n.home}] :is(${site.sourceHide.join(', ')}) { display: none !important; }` : '',\n    `${root} ${site.keep} { width: 100% !important; max-width: none !important; min-width: 0 !important; flex: 1 1 auto !important; }`,\n    `${root} [${n.filtered}] { display: none !important; }`,\n    // Narrow columns scroll without a scrollbar (the deck header shows where you are: unread count).\n    `${root} { scrollbar-width: none; }`,\n    site.css?.(density) ?? '',\n  ];\n  return rules.filter(Boolean).join('\\n');\n}\n\nexport type ColumnOptions = {\n  /** Called with the unread count (tracked + pending) whenever it changes, at most every 250 ms. */\n  onUnread?(count: number): void;\n};\n\nexport function installColumnMode(win: ColumnWindow, site: ColumnSite, options: ColumnOptions = {}): ColumnHandle {\n  const doc = win.document;\n  const n = names(site);\n  const root = () => doc.documentElement as HTMLElement | null;\n  let config: ColumnConfig | null = null;\n  let matcher: (item: FilterInput) => boolean = () => false;\n  let tracker = createUnreadTracker();\n  let watch: DomWatchHandle | null = null;\n  let observer: IntersectionObserver | null = null;\n  const observed = new WeakSet<Element>();\n  const ids = new WeakMap<Element, string>();\n  let prepared = false;\n  let lastReported = -1;\n  let reportTimer = 0;\n  let lastUrl = '';\n  let lastSeq = { read: -1, jump: -1 };\n\n  const onSource = () => !!config && isSourcePage(win.location.href, config.url);\n\n  const ensureStyle = () => {\n    if (!config) return;\n    let style = doc.getElementById(n.style) as HTMLStyleElement | null;\n    if (!style) {\n      const parent = doc.head || root();\n      if (!parent) return;\n      style = doc.createElement('style');\n      style.id = n.style;\n      parent.appendChild(style);\n    }\n    const css = buildColumnCss(site, config.density);\n    if (style.textContent !== css) style.textContent = css;\n  };\n\n  const kindOf = (item: Element): ItemKind => site.itemKind?.(item) ?? { reply: false, repost: false, media: false };\n  const textOf = (item: Element) => site.itemText?.(item) ?? item.textContent ?? '';\n\n  /** The column is on screen: the page is visible and the webview has a real size (hosts shrink a\n   * hidden tab webview to a pixel, and not every engine reports it as hidden). */\n  const shown = () => doc.visibilityState !== 'hidden' && win.innerWidth > 40 && win.innerHeight > 40;\n  const onScreen = (item: Element) => {\n    if (!shown()) return false;\n    const box = item.getBoundingClientRect();\n    const height = win.innerHeight || doc.documentElement.clientHeight;\n    // Mostly in view: its top is on screen and at least 40 px (or all of it) is visible.\n    return box.bottom > 0 && box.top < height && Math.min(box.bottom, height) - Math.max(box.top, 0) >= Math.min(40, box.height);\n  };\n\n  const pending = () => {\n    try { return Math.max(0, Math.floor(site.pendingCount?.(doc) ?? 0)); } catch { return 0; }\n  };\n\n  const report = () => {\n    if (!options.onUnread) return;\n    const count = config?.unread ? Math.min(999, tracker.count() + pending()) : 0;\n    if (count === lastReported) return;\n    if (reportTimer) return;\n    reportTimer = win.setTimeout(() => {\n      reportTimer = 0;\n      const now = config?.unread ? Math.min(999, tracker.count() + pending()) : 0;\n      if (now === lastReported) return;\n      lastReported = now;\n      try { options.onUnread?.(now); } catch { /* reporting is best effort */ }\n    }, 250);\n  };\n\n  const ensureObserver = () => {\n    if (observer || typeof win.IntersectionObserver !== 'function') return;\n    observer = new win.IntersectionObserver(entries => {\n      if (!shown()) return;\n      let changed = false;\n      for (const entry of entries) {\n        if (!entry.isIntersecting) continue;\n        const id = ids.get(entry.target);\n        if (id && tracker.isUnread(id)) { tracker.seen(id); changed = true; }\n        if (id) entry.target.removeAttribute(n.unread);\n      }\n      if (changed) report();\n    }, { threshold: [0, 0.5, 1] });\n  };\n\n  const items = (): Element[] => Array.from(doc.querySelectorAll(site.itemSelector));\n\n  const scan = () => {\n    if (!config) return;\n    const html = root();\n    if (!html) return;\n    // A config delivered at document start arrives before the parser has created <html>.\n    if (!html.hasAttribute(n.column)) html.setAttribute(n.column, '');\n    if (html.getAttribute(n.density) !== config.density) html.setAttribute(n.density, config.density);\n    ensureStyle();\n    const source = onSource();\n    if (source) html.setAttribute(n.home, '');\n    else html.removeAttribute(n.home);\n    if (win.location.href !== lastUrl) { lastUrl = win.location.href; prepared = false; }\n    if (source && !prepared && site.prepare) {\n      try { prepared = site.prepare(doc, config); } catch { prepared = true; }\n    }\n    const list = items();\n    const ordered: string[] = [];\n    const visible = new Set<string>();\n    for (const item of list) {\n      const container = site.container?.(item) ?? item;\n      let hidden = false;\n      if (source) {\n        try { hidden = matcher({ text: textOf(item), ...kindOf(item) }); } catch { hidden = false; }\n      }\n      if (hidden) container.setAttribute(n.filtered, '');\n      else if (container.hasAttribute(n.filtered)) container.removeAttribute(n.filtered);\n      if (!source || !config.unread || hidden) continue;\n      let id: string | null = null;\n      try { id = site.itemId(item); } catch { id = null; }\n      if (!id || ordered.includes(id)) continue;\n      ids.set(item, id);\n      ordered.push(id);\n      if (onScreen(item)) visible.add(id);\n      ensureObserver();\n      if (observer && !observed.has(item)) { observed.add(item); observer.observe(item); }\n    }\n    if (source && config.unread) {\n      tracker.observe(ordered, visible);\n      for (const item of list) {\n        const id = ids.get(item);\n        if (!id) continue;\n        if (tracker.isUnread(id)) item.setAttribute(n.unread, '');\n        else if (item.hasAttribute(n.unread)) item.removeAttribute(n.unread);\n      }\n    }\n    report();\n  };\n\n  const onKey = (event: KeyboardEvent) => {\n    if (!config || !event.altKey || event.ctrlKey || event.metaKey || event.shiftKey) return;\n    const key = event.key.toLowerCase();\n    if (key !== 'r' && key !== 'u') return;\n    event.preventDefault();\n    event.stopImmediatePropagation();\n    if (key === 'r') handle.markRead();\n    else handle.jumpToUnread();\n  };\n\n  const onVisibility = () => { if (shown()) watch?.schedule(); };\n\n  const start = () => {\n    if (watch) return;\n    watch = watchDom(win, scan, { phase: 'write' });\n    win.addEventListener('keydown', onKey, true);\n    doc.addEventListener('visibilitychange', onVisibility);\n    win.addEventListener('resize', onVisibility);\n    win.addEventListener('scroll', onScroll, { passive: true });\n  };\n\n  let scrollFrame = 0;\n  const onScroll = () => {\n    if (scrollFrame) return;\n    scrollFrame = win.requestAnimationFrame(() => { scrollFrame = 0; report(); });\n  };\n\n  const stop = () => {\n    watch?.dispose();\n    watch = null;\n    observer?.disconnect();\n    observer = null;\n    win.removeEventListener('keydown', onKey, true);\n    doc.removeEventListener('visibilitychange', onVisibility);\n    win.removeEventListener('resize', onVisibility);\n    win.removeEventListener('scroll', onScroll);\n    if (reportTimer) { win.clearTimeout(reportTimer); reportTimer = 0; }\n    const html = root();\n    html?.removeAttribute(n.column);\n    html?.removeAttribute(n.home);\n    html?.removeAttribute(n.density);\n    doc.getElementById(n.style)?.remove();\n    for (const el of Array.from(doc.querySelectorAll(`[${n.filtered}], [${n.unread}]`))) {\n      el.removeAttribute(n.filtered);\n      el.removeAttribute(n.unread);\n    }\n  };\n\n  const handle: ColumnHandle = {\n    set(value) {\n      const next = normalizeColumnConfig(value);\n      if (!next) {\n        if (config) { config = null; stop(); lastReported = -1; options.onUnread?.(0); }\n        return;\n      }\n      const first = !config;\n      const sourceChanged = !!config && config.url !== next.url;\n      config = next;\n      matcher = compileFilters(next.filters);\n      if (first || sourceChanged) { tracker = createUnreadTracker(); prepared = false; }\n      const html = root();\n      html?.setAttribute(n.column, '');\n      html?.setAttribute(n.density, next.density);\n      if (!first && lastSeq.read >= 0 && next.readSeq !== lastSeq.read) handle.markRead();\n      if (!first && lastSeq.jump >= 0 && next.jumpSeq !== lastSeq.jump) handle.jumpToUnread();\n      lastSeq = { read: next.readSeq, jump: next.jumpSeq };\n      ensureStyle();\n      start();\n      watch?.schedule();\n      if (!next.unread) report();\n    },\n    markRead() {\n      tracker.markRead();\n      for (const el of Array.from(doc.querySelectorAll(`[${n.unread}]`))) el.removeAttribute(n.unread);\n      report();\n    },\n    jumpToUnread() {\n      const list = items();\n      const ordered = list.map(item => ids.get(item)).filter((id): id is string => !!id);\n      const target = tracker.nextUnread(ordered);\n      const element = target ? list.find(item => ids.get(item) === target) : null;\n      if (element) (site.container?.(element) ?? element).scrollIntoView({ block: 'start' });\n      else if (pending() > 0) win.scrollTo({ top: 0 });\n    },\n    unread: () => (config?.unread ? Math.min(999, tracker.count() + pending()) : 0),\n    dispose() { config = null; stop(); },\n  };\n  return handle;\n}\n"]}

package/dist/runtime/commandReport.d.ts

@@ -0,0 +1,19 @@
+import type { CommandInfo } from './commands.ts';
+export type Invoke = (command: string, args: Record<string, unknown>) => Promise<unknown>;
+type Commands = {
+    list(): CommandInfo[];
+    onChange(callback: (list: CommandInfo[]) => void): () => void;
+};
+/** Reports the command list after it changes (batched, only real changes). Returns the disposer. */
+export declare function installCommandReport(commands: Commands, invoke: Invoke | undefined, delay?: number): () => void;
+type Toast = (message: string, options: {
+    tone: 'danger';
+    duration: number;
+}) => void;
+/**
+ * Developer mode (live reload): a plugin whose start failed shows `file:line — message` as a toast
+ * in this page. The host evaluates reloaded plugins with a `sourceURL`, so the line is the file's.
+ * `text` wraps the location in the app's words ("Plugin failed: {error}").
+ */
+export declare function devErrorReporter(toast: () => Toast | undefined, text: (error: string) => string): (file: unknown, error: unknown) => void;
+export {};

package/dist/runtime/commandReport.js

@@ -0,0 +1,47 @@
+// Plugin palette commands: a site tab tells the shell which commands its plugins registered, so the
+// command palette can list them under each plugin's name. Only `{ id, title, keywords }` strings
+// travel (capped in the registry and again natively, waybetter-host `plugins::commands`), only
+// about this tab, only when the list changes (`tab_report.commands`). Running one is the shell
+// asking native code to call `api.commands.run(id)` in this page; `run` never leaves it.
+//
+// Developer mode's start failures are reported here too: a toast in the page with file and line.
+import { devErrorLocation, formatDevError } from "./devErrors.js";
+/** Reports the command list after it changes (batched, only real changes). Returns the disposer. */
+export function installCommandReport(commands, invoke, delay = 80) {
+    if (!invoke)
+        return () => { };
+    let last = '[]';
+    let timer;
+    const send = () => {
+        timer = undefined;
+        const list = commands.list();
+        const json = JSON.stringify(list);
+        if (json === last)
+            return;
+        last = json;
+        invoke('tab_report', { report: { commands: list } }).catch(() => { });
+    };
+    const off = commands.onChange(() => {
+        if (timer === undefined)
+            timer = setTimeout(send, delay);
+    });
+    return () => { off(); if (timer !== undefined)
+        clearTimeout(timer); };
+}
+/**
+ * Developer mode (live reload): a plugin whose start failed shows `file:line — message` as a toast
+ * in this page. The host evaluates reloaded plugins with a `sourceURL`, so the line is the file's.
+ * `text` wraps the location in the app's words ("Plugin failed: {error}").
+ */
+export function devErrorReporter(toast, text) {
+    return (file, error) => {
+        if (typeof file !== 'string')
+            return;
+        const location = formatDevError(devErrorLocation(error, file));
+        try {
+            toast()?.(text(location), { tone: 'danger', duration: 12000 });
+        }
+        catch { /* the page keeps working */ }
+    };
+}
+//# sourceMappingURL=commandReport.js.map

package/dist/runtime/commandReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandReport.js","sourceRoot":"","sources":["../../../runtime/src/commandReport.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,iGAAiG;AACjG,+FAA+F;AAC/F,+FAA+F;AAC/F,yFAAyF;AACzF,EAAE;AACF,iGAAiG;AAGjG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKlE,oGAAoG;AACpG,MAAM,UAAU,oBAAoB,CAAC,QAAkB,EAAE,MAA0B,EAAE,KAAK,GAAG,EAAE;IAC7F,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAC7B,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,IAAI,KAAgD,CAAC;IACrD,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,KAAK,GAAG,SAAS,CAAC;QAClB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO;QAC1B,IAAI,GAAG,IAAI,CAAC;QACZ,MAAM,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE;QACjC,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,KAAK,KAAK,SAAS;QAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAID;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA8B,EAAE,IAA+B;IAC9F,OAAO,CAAC,IAAa,EAAE,KAAc,EAAE,EAAE;QACvC,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO;QACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC;YAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,4BAA4B,CAAC,CAAC;IAChH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["// Plugin palette commands: a site tab tells the shell which commands its plugins registered, so the\n// command palette can list them under each plugin's name. Only `{ id, title, keywords }` strings\n// travel (capped in the registry and again natively, waybetter-host `plugins::commands`), only\n// about this tab, only when the list changes (`tab_report.commands`). Running one is the shell\n// asking native code to call `api.commands.run(id)` in this page; `run` never leaves it.\n//\n// Developer mode's start failures are reported here too: a toast in the page with file and line.\n\nimport type { CommandInfo } from './commands.ts';\nimport { devErrorLocation, formatDevError } from './devErrors.ts';\n\nexport type Invoke = (command: string, args: Record<string, unknown>) => Promise<unknown>;\ntype Commands = { list(): CommandInfo[]; onChange(callback: (list: CommandInfo[]) => void): () => void };\n\n/** Reports the command list after it changes (batched, only real changes). Returns the disposer. */\nexport function installCommandReport(commands: Commands, invoke: Invoke | undefined, delay = 80): () => void {\n  if (!invoke) return () => {};\n  let last = '[]';\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const send = () => {\n    timer = undefined;\n    const list = commands.list();\n    const json = JSON.stringify(list);\n    if (json === last) return;\n    last = json;\n    invoke('tab_report', { report: { commands: list } }).catch(() => {});\n  };\n  const off = commands.onChange(() => {\n    if (timer === undefined) timer = setTimeout(send, delay);\n  });\n  return () => { off(); if (timer !== undefined) clearTimeout(timer); };\n}\n\ntype Toast = (message: string, options: { tone: 'danger'; duration: number }) => void;\n\n/**\n * Developer mode (live reload): a plugin whose start failed shows `file:line — message` as a toast\n * in this page. The host evaluates reloaded plugins with a `sourceURL`, so the line is the file's.\n * `text` wraps the location in the app's words (\"Plugin failed: {error}\").\n */\nexport function devErrorReporter(toast: () => Toast | undefined, text: (error: string) => string) {\n  return (file: unknown, error: unknown) => {\n    if (typeof file !== 'string') return;\n    const location = formatDevError(devErrorLocation(error, file));\n    try { toast()?.(text(location), { tone: 'danger', duration: 12000 }); } catch { /* the page keeps working */ }\n  };\n}\n"]}

package/dist/runtime/commands.d.ts

@@ -0,0 +1,72 @@
+export type Dispose = () => void;
+export type CommandDefinition = {
+    /** Unique within the plugin: letters, digits, `.`, `_`, `-`, 1–64 characters. */
+    id: string;
+    /** Shown in the palette (at most 80 characters are kept). */
+    title: string;
+    /** Extra words the palette matches (string or list; at most 160 characters are kept). */
+    keywords?: string | readonly string[];
+    /** Optional in-page shortcut such as `Alt+Shift+F` (works while this page has focus, not while typing). */
+    shortcut?: string;
+    run: () => unknown;
+};
+/** What the palette sees of a command: strings only. `id` is `<owner>:<command id>`. */
+export type CommandInfo = {
+    id: string;
+    title: string;
+    keywords: string;
+};
+export declare const COMMAND_LIMITS: Readonly<{
+    /** Commands one plugin may register. */
+    perOwner: 16;
+    /** Commands one page may report. */
+    total: 48;
+    id: 64;
+    title: 80;
+    keywords: 160;
+    owner: 128;
+}>;
+/** Owner of commands registered outside any plugin start (e.g. later, from a timer). */
+export declare const NO_OWNER = "_";
+export type Shortcut = {
+    key: string;
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+    meta: boolean;
+};
+/** Parses `Ctrl+Alt+Shift+Meta+<key>` (case-insensitive; `Cmd`/`Mod` = Meta/Ctrl). Null when invalid. */
+export declare function parseShortcut(value: unknown): Shortcut | null;
+/** Whether a keydown matches a parsed shortcut. Letters and digits match by physical key too. */
+export declare function matchesShortcut(event: Pick<KeyboardEvent, 'key' | 'code' | 'ctrlKey' | 'altKey' | 'shiftKey' | 'metaKey'>, shortcut: Shortcut): boolean;
+export type CommandRegistry = {
+    /** Registers a command for the current owner; returns its disposer. Throws on invalid input or caps. */
+    register(definition: CommandDefinition): Dispose;
+    /** The palette's view of every command (strings only), in registration order. */
+    list(): CommandInfo[];
+    /** Runs `<owner>:<id>` in this page. False when there is no such command. */
+    run(id: string): boolean;
+    /** Calls `callback(list())` after commands change (batched), until disposed. */
+    onChange(callback: (list: CommandInfo[]) => void): Dispose;
+    /** Host hook: runs `fn` with `owner` as the owner of commands registered meanwhile. */
+    withOwner<T>(owner: string, fn: () => T): T;
+    /** Host hook: removes every command of `owner` (called after a plugin stops). */
+    removeOwner(owner: string): void;
+};
+/** Registry internals the plugin API needs (not handed to plugins). */
+export type CommandRegistryInternal = CommandRegistry & {
+    /** The owner commands registered right now would get. */
+    currentOwner(): string;
+    /** Registers for an explicit owner (a scope remembers the plugin that created it). */
+    registerFor(owner: string, definition: CommandDefinition): Dispose;
+};
+export type CommandEnv = {
+    /** Where shortcut keydowns are listened to (the page's document). */
+    target?: Pick<EventTarget, 'addEventListener' | 'removeEventListener'>;
+    /** True while the user types (no shortcut then). */
+    isTyping?: (event: KeyboardEvent) => boolean;
+    /** Batches change notifications; defaults to a microtask. */
+    schedule?: (fn: () => void) => void;
+    report?: (error: unknown) => void;
+};
+export declare function createCommandRegistry(env?: CommandEnv): CommandRegistryInternal;

package/dist/runtime/commands.js

@@ -0,0 +1,214 @@
+// Plugin commands for the shell's command palette (Ctrl+K).
+//
+// A plugin registers `{ id, title, keywords, shortcut?, run }` with `api.commands.register` (or
+// `scope.commands.register`, removed on dispose). The registry is local to the page: the runtime
+// reports `list()` (ids, titles and keywords only, capped) about this tab to the host, and the
+// shell asks this tab to `run(id)` when the user picks one in the palette. `run` always executes
+// here, in the plugin's own page; nothing crosses to the shell but these strings.
+//
+// Every command belongs to the plugin that registered it: the host starts a plugin inside
+// `withOwner(file, ...)`, and stopping the plugin removes all of its commands (`removeOwner`), so
+// a plugin that forgets to unregister cannot leave a dead entry in the palette.
+export const COMMAND_LIMITS = Object.freeze({
+    /** Commands one plugin may register. */
+    perOwner: 16,
+    /** Commands one page may report. */
+    total: 48,
+    id: 64,
+    title: 80,
+    keywords: 160,
+    owner: 128,
+});
+/** Owner of commands registered outside any plugin start (e.g. later, from a timer). */
+export const NO_OWNER = '_';
+const COMMAND_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+/** Plugin file names (the host's `valid_file_name`) and `_`. */
+const OWNER_ID = /^(?:_|[A-Za-z0-9_\- ][A-Za-z0-9_.\- ]{0,127})$/;
+const clean = (value, max) => 
+// eslint-disable-next-line no-control-regex
+value.replace(/[\u0000-\u001f\u007f]+/g, ' ').replace(/\s+/g, ' ').trim().slice(0, max);
+/** Parses `Ctrl+Alt+Shift+Meta+<key>` (case-insensitive; `Cmd`/`Mod` = Meta/Ctrl). Null when invalid. */
+export function parseShortcut(value) {
+    if (typeof value !== 'string' || value.length > 40)
+        return null;
+    const parts = value.split('+').map(part => part.trim()).filter(Boolean);
+    if (!parts.length)
+        return null;
+    const shortcut = { key: '', ctrl: false, alt: false, shift: false, meta: false };
+    for (const [index, raw] of parts.entries()) {
+        const part = raw.toLowerCase();
+        const last = index === parts.length - 1;
+        if (!last) {
+            if (part === 'ctrl' || part === 'control' || part === 'mod')
+                shortcut.ctrl = true;
+            else if (part === 'alt' || part === 'option')
+                shortcut.alt = true;
+            else if (part === 'shift')
+                shortcut.shift = true;
+            else if (part === 'meta' || part === 'cmd' || part === 'command')
+                shortcut.meta = true;
+            else
+                return null;
+            continue;
+        }
+        if (!/^(?:[a-z0-9]|f(?:[1-9]|1[0-2])|arrow(?:up|down|left|right)|enter|escape|space|[[\]\\;',./`=-])$/.test(part))
+            return null;
+        shortcut.key = part;
+    }
+    return shortcut.key ? shortcut : null;
+}
+/** Whether a keydown matches a parsed shortcut. Letters and digits match by physical key too. */
+export function matchesShortcut(event, shortcut) {
+    if (event.ctrlKey !== shortcut.ctrl || event.altKey !== shortcut.alt || event.shiftKey !== shortcut.shift || event.metaKey !== shortcut.meta)
+        return false;
+    const key = shortcut.key;
+    if (/^[a-z]$/.test(key))
+        return event.code === `Key${key.toUpperCase()}` || event.key.toLowerCase() === key;
+    if (/^[0-9]$/.test(key))
+        return event.code === `Digit${key}` || event.key === key;
+    if (key === 'space')
+        return event.key === ' ' || event.code === 'Space';
+    return event.key.toLowerCase() === key;
+}
+export function createCommandRegistry(env = {}) {
+    const entries = [];
+    const listeners = new Set();
+    const report = env.report ?? ((error) => console.error('[wayBetter] command failed', error));
+    const schedule = env.schedule ?? ((fn) => { void Promise.resolve().then(fn); });
+    const owners = [];
+    let pending = false;
+    let keyListening = false;
+    const info = (entry) => ({ id: `${entry.owner}:${entry.id}`, title: entry.title, keywords: entry.keywords });
+    const list = () => entries.map(info);
+    const changed = () => {
+        syncKeys();
+        if (pending)
+            return;
+        pending = true;
+        schedule(() => {
+            pending = false;
+            const snapshot = list();
+            for (const listener of [...listeners]) {
+                try {
+                    listener(snapshot);
+                }
+                catch (error) {
+                    report(error);
+                }
+            }
+        });
+    };
+    const invoke = (entry) => {
+        try {
+            const result = entry.run();
+            if (result && typeof result.then === 'function')
+                result.then(undefined, report);
+        }
+        catch (error) {
+            report(error);
+        }
+    };
+    const onKeyDown = (event) => {
+        const key = event;
+        if (key.defaultPrevented || key.repeat || env.isTyping?.(key))
+            return;
+        const entry = entries.find(item => item.shortcut && matchesShortcut(key, item.shortcut));
+        if (!entry)
+            return;
+        key.preventDefault();
+        key.stopPropagation();
+        invoke(entry);
+    };
+    function syncKeys() {
+        const wanted = !!env.target && entries.some(entry => entry.shortcut);
+        if (wanted === keyListening)
+            return;
+        keyListening = wanted;
+        if (wanted)
+            env.target.addEventListener('keydown', onKeyDown, true);
+        else
+            env.target.removeEventListener('keydown', onKeyDown, true);
+    }
+    const currentOwner = () => owners[owners.length - 1] ?? NO_OWNER;
+    function registerFor(owner, definition) {
+        if (typeof owner !== 'string' || !OWNER_ID.test(owner))
+            throw new Error('commands.register: invalid owner');
+        if (!definition || typeof definition !== 'object')
+            throw new Error('commands.register: expected { id, title, run }');
+        const { id, title, keywords, shortcut, run } = definition;
+        if (typeof id !== 'string' || !COMMAND_ID.test(id))
+            throw new Error(`commands.register: invalid id ${JSON.stringify(id)} (letters, digits, . _ -, at most ${COMMAND_LIMITS.id})`);
+        if (typeof run !== 'function')
+            throw new Error('commands.register: run must be a function');
+        const shownTitle = typeof title === 'string' ? clean(title, COMMAND_LIMITS.title) : '';
+        if (!shownTitle)
+            throw new Error('commands.register: title is required');
+        const words = typeof keywords === 'string' ? keywords : Array.isArray(keywords) ? keywords.filter(word => typeof word === 'string').join(' ') : '';
+        const parsed = shortcut === undefined ? null : parseShortcut(shortcut);
+        if (shortcut !== undefined && !parsed)
+            throw new Error(`commands.register: invalid shortcut ${JSON.stringify(shortcut)}`);
+        const existing = entries.findIndex(entry => entry.owner === owner && entry.id === id);
+        if (existing < 0) {
+            if (entries.filter(entry => entry.owner === owner).length >= COMMAND_LIMITS.perOwner)
+                throw new Error(`commands.register: at most ${COMMAND_LIMITS.perOwner} commands per plugin`);
+            if (entries.length >= COMMAND_LIMITS.total)
+                throw new Error(`commands.register: at most ${COMMAND_LIMITS.total} commands per page`);
+        }
+        const entry = { owner, id, title: shownTitle, keywords: clean(words, COMMAND_LIMITS.keywords), shortcut: parsed, run: run };
+        // Registering the same id again replaces the command in place (a plugin reloading its settings).
+        if (existing >= 0)
+            entries.splice(existing, 1, entry);
+        else
+            entries.push(entry);
+        changed();
+        return () => {
+            const index = entries.indexOf(entry);
+            if (index < 0)
+                return;
+            entries.splice(index, 1);
+            changed();
+        };
+    }
+    return {
+        register: definition => registerFor(currentOwner(), definition),
+        registerFor,
+        currentOwner,
+        list,
+        run(fullId) {
+            if (typeof fullId !== 'string')
+                return false;
+            const entry = entries.find(item => `${item.owner}:${item.id}` === fullId);
+            if (!entry)
+                return false;
+            invoke(entry);
+            return true;
+        },
+        onChange(callback) {
+            listeners.add(callback);
+            return () => { listeners.delete(callback); };
+        },
+        withOwner(owner, fn) {
+            if (typeof owner !== 'string' || !OWNER_ID.test(owner))
+                return fn();
+            owners.push(owner);
+            try {
+                return fn();
+            }
+            finally {
+                owners.pop();
+            }
+        },
+        removeOwner(owner) {
+            let removed = false;
+            for (let index = entries.length - 1; index >= 0; index -= 1) {
+                if (entries[index].owner === owner) {
+                    entries.splice(index, 1);
+                    removed = true;
+                }
+            }
+            if (removed)
+                changed();
+        },
+    };
+}
+//# sourceMappingURL=commands.js.map

package/dist/runtime/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../runtime/src/commands.ts"],"names":[],"mappings":"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","sourcesContent":["// Plugin commands for the shell's command palette (Ctrl+K).\n//\n// A plugin registers `{ id, title, keywords, shortcut?, run }` with `api.commands.register` (or\n// `scope.commands.register`, removed on dispose). The registry is local to the page: the runtime\n// reports `list()` (ids, titles and keywords only, capped) about this tab to the host, and the\n// shell asks this tab to `run(id)` when the user picks one in the palette. `run` always executes\n// here, in the plugin's own page; nothing crosses to the shell but these strings.\n//\n// Every command belongs to the plugin that registered it: the host starts a plugin inside\n// `withOwner(file, ...)`, and stopping the plugin removes all of its commands (`removeOwner`), so\n// a plugin that forgets to unregister cannot leave a dead entry in the palette.\n\nexport type Dispose = () => void;\n\nexport type CommandDefinition = {\n  /** Unique within the plugin: letters, digits, `.`, `_`, `-`, 1–64 characters. */\n  id: string;\n  /** Shown in the palette (at most 80 characters are kept). */\n  title: string;\n  /** Extra words the palette matches (string or list; at most 160 characters are kept). */\n  keywords?: string | readonly string[];\n  /** Optional in-page shortcut such as `Alt+Shift+F` (works while this page has focus, not while typing). */\n  shortcut?: string;\n  run: () => unknown;\n};\n\n/** What the palette sees of a command: strings only. `id` is `<owner>:<command id>`. */\nexport type CommandInfo = { id: string; title: string; keywords: string };\n\nexport const COMMAND_LIMITS = Object.freeze({\n  /** Commands one plugin may register. */\n  perOwner: 16,\n  /** Commands one page may report. */\n  total: 48,\n  id: 64,\n  title: 80,\n  keywords: 160,\n  owner: 128,\n});\n\n/** Owner of commands registered outside any plugin start (e.g. later, from a timer). */\nexport const NO_OWNER = '_';\n\nconst COMMAND_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;\n/** Plugin file names (the host's `valid_file_name`) and `_`. */\nconst OWNER_ID = /^(?:_|[A-Za-z0-9_\\- ][A-Za-z0-9_.\\- ]{0,127})$/;\n\nconst clean = (value: string, max: number) =>\n  // eslint-disable-next-line no-control-regex\n  value.replace(/[\\u0000-\\u001f\\u007f]+/g, ' ').replace(/\\s+/g, ' ').trim().slice(0, max);\n\nexport type Shortcut = { key: string; ctrl: boolean; alt: boolean; shift: boolean; meta: boolean };\n\n/** Parses `Ctrl+Alt+Shift+Meta+<key>` (case-insensitive; `Cmd`/`Mod` = Meta/Ctrl). Null when invalid. */\nexport function parseShortcut(value: unknown): Shortcut | null {\n  if (typeof value !== 'string' || value.length > 40) return null;\n  const parts = value.split('+').map(part => part.trim()).filter(Boolean);\n  if (!parts.length) return null;\n  const shortcut: Shortcut = { key: '', ctrl: false, alt: false, shift: false, meta: false };\n  for (const [index, raw] of parts.entries()) {\n    const part = raw.toLowerCase();\n    const last = index === parts.length - 1;\n    if (!last) {\n      if (part === 'ctrl' || part === 'control' || part === 'mod') shortcut.ctrl = true;\n      else if (part === 'alt' || part === 'option') shortcut.alt = true;\n      else if (part === 'shift') shortcut.shift = true;\n      else if (part === 'meta' || part === 'cmd' || part === 'command') shortcut.meta = true;\n      else return null;\n      continue;\n    }\n    if (!/^(?:[a-z0-9]|f(?:[1-9]|1[0-2])|arrow(?:up|down|left|right)|enter|escape|space|[[\\]\\\\;',./`=-])$/.test(part)) return null;\n    shortcut.key = part;\n  }\n  return shortcut.key ? shortcut : null;\n}\n\n/** Whether a keydown matches a parsed shortcut. Letters and digits match by physical key too. */\nexport function matchesShortcut(event: Pick<KeyboardEvent, 'key' | 'code' | 'ctrlKey' | 'altKey' | 'shiftKey' | 'metaKey'>, shortcut: Shortcut): boolean {\n  if (event.ctrlKey !== shortcut.ctrl || event.altKey !== shortcut.alt || event.shiftKey !== shortcut.shift || event.metaKey !== shortcut.meta) return false;\n  const key = shortcut.key;\n  if (/^[a-z]$/.test(key)) return event.code === `Key${key.toUpperCase()}` || event.key.toLowerCase() === key;\n  if (/^[0-9]$/.test(key)) return event.code === `Digit${key}` || event.key === key;\n  if (key === 'space') return event.key === ' ' || event.code === 'Space';\n  return event.key.toLowerCase() === key;\n}\n\nexport type CommandRegistry = {\n  /** Registers a command for the current owner; returns its disposer. Throws on invalid input or caps. */\n  register(definition: CommandDefinition): Dispose;\n  /** The palette's view of every command (strings only), in registration order. */\n  list(): CommandInfo[];\n  /** Runs `<owner>:<id>` in this page. False when there is no such command. */\n  run(id: string): boolean;\n  /** Calls `callback(list())` after commands change (batched), until disposed. */\n  onChange(callback: (list: CommandInfo[]) => void): Dispose;\n  /** Host hook: runs `fn` with `owner` as the owner of commands registered meanwhile. */\n  withOwner<T>(owner: string, fn: () => T): T;\n  /** Host hook: removes every command of `owner` (called after a plugin stops). */\n  removeOwner(owner: string): void;\n};\n\n/** Registry internals the plugin API needs (not handed to plugins). */\nexport type CommandRegistryInternal = CommandRegistry & {\n  /** The owner commands registered right now would get. */\n  currentOwner(): string;\n  /** Registers for an explicit owner (a scope remembers the plugin that created it). */\n  registerFor(owner: string, definition: CommandDefinition): Dispose;\n};\n\ntype Entry = { owner: string; id: string; title: string; keywords: string; shortcut: Shortcut | null; run: () => unknown };\n\nexport type CommandEnv = {\n  /** Where shortcut keydowns are listened to (the page's document). */\n  target?: Pick<EventTarget, 'addEventListener' | 'removeEventListener'>;\n  /** True while the user types (no shortcut then). */\n  isTyping?: (event: KeyboardEvent) => boolean;\n  /** Batches change notifications; defaults to a microtask. */\n  schedule?: (fn: () => void) => void;\n  report?: (error: unknown) => void;\n};\n\nexport function createCommandRegistry(env: CommandEnv = {}): CommandRegistryInternal {\n  const entries: Entry[] = [];\n  const listeners = new Set<(list: CommandInfo[]) => void>();\n  const report = env.report ?? ((error: unknown) => console.error('[wayBetter] command failed', error));\n  const schedule = env.schedule ?? ((fn: () => void) => { void Promise.resolve().then(fn); });\n  const owners: string[] = [];\n  let pending = false;\n  let keyListening = false;\n\n  const info = (entry: Entry): CommandInfo => ({ id: `${entry.owner}:${entry.id}`, title: entry.title, keywords: entry.keywords });\n  const list = () => entries.map(info);\n  const changed = () => {\n    syncKeys();\n    if (pending) return;\n    pending = true;\n    schedule(() => {\n      pending = false;\n      const snapshot = list();\n      for (const listener of [...listeners]) {\n        try { listener(snapshot); } catch (error) { report(error); }\n      }\n    });\n  };\n  const invoke = (entry: Entry) => {\n    try {\n      const result = entry.run();\n      if (result && typeof (result as Promise<unknown>).then === 'function') (result as Promise<unknown>).then(undefined, report);\n    } catch (error) { report(error); }\n  };\n  const onKeyDown = (event: Event) => {\n    const key = event as KeyboardEvent;\n    if (key.defaultPrevented || key.repeat || env.isTyping?.(key)) return;\n    const entry = entries.find(item => item.shortcut && matchesShortcut(key, item.shortcut));\n    if (!entry) return;\n    key.preventDefault();\n    key.stopPropagation();\n    invoke(entry);\n  };\n  function syncKeys() {\n    const wanted = !!env.target && entries.some(entry => entry.shortcut);\n    if (wanted === keyListening) return;\n    keyListening = wanted;\n    if (wanted) env.target!.addEventListener('keydown', onKeyDown, true);\n    else env.target!.removeEventListener('keydown', onKeyDown, true);\n  }\n\n  const currentOwner = () => owners[owners.length - 1] ?? NO_OWNER;\n\n  function registerFor(owner: string, definition: CommandDefinition): Dispose {\n    if (typeof owner !== 'string' || !OWNER_ID.test(owner)) throw new Error('commands.register: invalid owner');\n    if (!definition || typeof definition !== 'object') throw new Error('commands.register: expected { id, title, run }');\n    const { id, title, keywords, shortcut, run } = definition;\n    if (typeof id !== 'string' || !COMMAND_ID.test(id)) throw new Error(`commands.register: invalid id ${JSON.stringify(id)} (letters, digits, . _ -, at most ${COMMAND_LIMITS.id})`);\n    if (typeof run !== 'function') throw new Error('commands.register: run must be a function');\n    const shownTitle = typeof title === 'string' ? clean(title, COMMAND_LIMITS.title) : '';\n    if (!shownTitle) throw new Error('commands.register: title is required');\n    const words = typeof keywords === 'string' ? keywords : Array.isArray(keywords) ? keywords.filter(word => typeof word === 'string').join(' ') : '';\n    const parsed = shortcut === undefined ? null : parseShortcut(shortcut);\n    if (shortcut !== undefined && !parsed) throw new Error(`commands.register: invalid shortcut ${JSON.stringify(shortcut)}`);\n    const existing = entries.findIndex(entry => entry.owner === owner && entry.id === id);\n    if (existing < 0) {\n      if (entries.filter(entry => entry.owner === owner).length >= COMMAND_LIMITS.perOwner) throw new Error(`commands.register: at most ${COMMAND_LIMITS.perOwner} commands per plugin`);\n      if (entries.length >= COMMAND_LIMITS.total) throw new Error(`commands.register: at most ${COMMAND_LIMITS.total} commands per page`);\n    }\n    const entry: Entry = { owner, id, title: shownTitle, keywords: clean(words, COMMAND_LIMITS.keywords), shortcut: parsed, run: run as () => unknown };\n    // Registering the same id again replaces the command in place (a plugin reloading its settings).\n    if (existing >= 0) entries.splice(existing, 1, entry); else entries.push(entry);\n    changed();\n    return () => {\n      const index = entries.indexOf(entry);\n      if (index < 0) return;\n      entries.splice(index, 1);\n      changed();\n    };\n  }\n\n  return {\n    register: definition => registerFor(currentOwner(), definition),\n    registerFor,\n    currentOwner,\n    list,\n    run(fullId) {\n      if (typeof fullId !== 'string') return false;\n      const entry = entries.find(item => `${item.owner}:${item.id}` === fullId);\n      if (!entry) return false;\n      invoke(entry);\n      return true;\n    },\n    onChange(callback) {\n      listeners.add(callback);\n      return () => { listeners.delete(callback); };\n    },\n    withOwner(owner, fn) {\n      if (typeof owner !== 'string' || !OWNER_ID.test(owner)) return fn();\n      owners.push(owner);\n      try { return fn(); } finally { owners.pop(); }\n    },\n    removeOwner(owner) {\n      let removed = false;\n      for (let index = entries.length - 1; index >= 0; index -= 1) {\n        if (entries[index]!.owner === owner) { entries.splice(index, 1); removed = true; }\n      }\n      if (removed) changed();\n    },\n  };\n}\n"]}

package/dist/runtime/devErrors.d.ts

@@ -0,0 +1,16 @@
+export type DevErrorLocation = {
+    file: string;
+    line: number | null;
+    column: number | null;
+    message: string;
+};
+/** Default prefix the host uses for plugin source URLs. */
+export declare const DEV_SOURCE_PREFIX = "wb-dev/";
+/**
+ * The first stack frame inside `file` (evaluated as `<prefix><file>`), mapped back to the file's
+ * own line numbers. Line is null when no frame names the file (e.g. an error thrown from a timer
+ * in other code). The message is one line, at most 300 characters.
+ */
+export declare function devErrorLocation(error: unknown, file: string, prefix?: string, lineOffset?: number): DevErrorLocation;
+/** `file:line:column — message` (parts that are unknown are left out). */
+export declare function formatDevError(location: DevErrorLocation): string;

package/dist/runtime/devErrors.js

@@ -0,0 +1,30 @@
+// Live-reload developer mode: where a plugin's start failure happened, for the in-page error toast.
+//
+// The host evaluates a plugin with `//# sourceURL=<prefix><file>` (waybetter-host
+// `dev_start_script`), so V8/JavaScriptCore stack frames name that URL with the line and column
+// of the evaluated script; the plugin file's line 1 is line `1 + lineOffset` there.
+/** Default prefix the host uses for plugin source URLs. */
+export const DEV_SOURCE_PREFIX = 'wb-dev/';
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * The first stack frame inside `file` (evaluated as `<prefix><file>`), mapped back to the file's
+ * own line numbers. Line is null when no frame names the file (e.g. an error thrown from a timer
+ * in other code). The message is one line, at most 300 characters.
+ */
+export function devErrorLocation(error, file, prefix = DEV_SOURCE_PREFIX, lineOffset = 1) {
+    const text = error instanceof Error ? error.message : String(error);
+    const message = `${error instanceof Error && error.name && error.name !== 'Error' ? `${error.name}: ` : ''}${text}`.split('\n')[0].slice(0, 300);
+    const stack = error instanceof Error && typeof error.stack === 'string' ? error.stack : '';
+    const url = `${prefix}${file.replace(/ /g, '%20')}`;
+    const match = new RegExp(`${escapeRegExp(url)}:(\\d+):(\\d+)`).exec(stack);
+    if (!match)
+        return { file, line: null, column: null, message };
+    const line = Number(match[1]) - lineOffset;
+    return { file, line: line >= 1 ? line : null, column: Number(match[2]), message };
+}
+/** `file:line:column — message` (parts that are unknown are left out). */
+export function formatDevError(location) {
+    const where = location.line ? `${location.file}:${location.line}${location.column ? `:${location.column}` : ''}` : location.file;
+    return `${where} — ${location.message}`;
+}
+//# sourceMappingURL=devErrors.js.map

package/dist/runtime/devErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devErrors.js","sourceRoot":"","sources":["../../../runtime/src/devErrors.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,EAAE;AACF,kFAAkF;AAClF,gGAAgG;AAChG,oFAAoF;AAIpF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAErF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,IAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE,UAAU,GAAG,CAAC;IACvG,MAAM,IAAI,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClJ,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;IAC3C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;AACpF,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,QAA0B;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IACjI,OAAO,GAAG,KAAK,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC1C,CAAC","sourcesContent":["// Live-reload developer mode: where a plugin's start failure happened, for the in-page error toast.\n//\n// The host evaluates a plugin with `//# sourceURL=<prefix><file>` (waybetter-host\n// `dev_start_script`), so V8/JavaScriptCore stack frames name that URL with the line and column\n// of the evaluated script; the plugin file's line 1 is line `1 + lineOffset` there.\n\nexport type DevErrorLocation = { file: string; line: number | null; column: number | null; message: string };\n\n/** Default prefix the host uses for plugin source URLs. */\nexport const DEV_SOURCE_PREFIX = 'wb-dev/';\n\nconst escapeRegExp = (value: string) => value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/**\n * The first stack frame inside `file` (evaluated as `<prefix><file>`), mapped back to the file's\n * own line numbers. Line is null when no frame names the file (e.g. an error thrown from a timer\n * in other code). The message is one line, at most 300 characters.\n */\nexport function devErrorLocation(error: unknown, file: string, prefix = DEV_SOURCE_PREFIX, lineOffset = 1): DevErrorLocation {\n  const text = error instanceof Error ? error.message : String(error);\n  const message = `${error instanceof Error && error.name && error.name !== 'Error' ? `${error.name}: ` : ''}${text}`.split('\\n')[0]!.slice(0, 300);\n  const stack = error instanceof Error && typeof error.stack === 'string' ? error.stack : '';\n  const url = `${prefix}${file.replace(/ /g, '%20')}`;\n  const match = new RegExp(`${escapeRegExp(url)}:(\\\\d+):(\\\\d+)`).exec(stack);\n  if (!match) return { file, line: null, column: null, message };\n  const line = Number(match[1]) - lineOffset;\n  return { file, line: line >= 1 ? line : null, column: Number(match[2]), message };\n}\n\n/** `file:line:column — message` (parts that are unknown are left out). */\nexport function formatDevError(location: DevErrorLocation): string {\n  const where = location.line ? `${location.file}:${location.line}${location.column ? `:${location.column}` : ''}` : location.file;\n  return `${where} — ${location.message}`;\n}\n"]}

package/dist/runtime/domHub.d.ts

@@ -17,6 +17,8 @@ export type DomHubConfig = {
     label: string;
     /** Pathnames where `offOnHeavy` features are skipped; null = none. */
     heavyPath: RegExp | null;
+    /** Selectors of hosts whose open shadow roots are part of the page (observed and searched like it). */
+    shadowHosts: readonly string[];
 };
 export type DomWindow = {
     document: Document;
@@ -28,7 +30,26 @@ export type DomWindow = {
 };
 /** Set once by the site adapter, before features register. */
 export declare function configureDomHub(next: Partial<DomHubConfig>): void;
+/** The page's roots: the document, then the open shadow roots of the configured hosts now in it. */
+export declare function domRoots(win: {
+    document: Document;
+}): Array<Document | ShadowRoot>;
+/** The site names hosts whose shadow roots are part of the page. */
+export declare function hasShadowHosts(): boolean;
 export declare function isHeavyPath(pathname: string): boolean;
+export type ObserveOptions = {
+    /** Skip on the site's heavy pages (default false). */
+    offOnHeavy?: boolean;
+    /** A callback that throws is handed here (default: the hub's console line). */
+    report?(error: unknown): void;
+};
+/**
+ * Calls `callback` once for every element matching `selector`, now and as the page renders more.
+ * Every call shares the hub's one MutationObserver and one frame: a page with a hundred selector
+ * observers still has one observer, and a mutation costs one frame in which each observer looks
+ * for elements it has not seen yet. Returns the disposer.
+ */
+export declare function observeSelector(win: DomWindow, selector: string, callback: (element: Element) => void, options?: ObserveOptions): () => void;
 /**
  * Runs `run` in the next animation frame after body mutations of the watched kinds (child list
  * always), or whenever `schedule()` is called (scroll, popstate, input, ...). Several calls in one