@hozu/cli 0.7.0 → 0.9.0

package/dist/commands/browse-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-page.d.ts","sourceRoot":"","sources":["../../src/commands/browse-page.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,QAkOZ,CAAA"}

package/dist/commands/browse-page.js

@@ -0,0 +1,228 @@
+export const PAGE = String.raw `(() => {
+  const norm = (s) => (s ?? '').replace(/\s+/g, ' ').trim().toLowerCase()
+  const shown = (el) => { const r = el.getBoundingClientRect(); return r.width > 0 || r.height > 0 }
+  const nameOf = (el) => {
+    const aria = el.getAttribute('aria-label')
+    if (aria) return aria
+    const by = el.getAttribute('aria-labelledby')
+    if (by) return by.split(/\s+/).map((id) => document.getElementById(id)?.textContent ?? '').join(' ')
+    if (el.labels && el.labels.length) return [...el.labels].map((l) => l.textContent).join(' ')
+    if (el.tagName === 'INPUT' && ['submit', 'button'].includes(el.type)) return el.value
+    if (el.placeholder) return el.placeholder
+    if (el.getAttribute('title') && !el.textContent.trim()) return el.getAttribute('title')
+    return el.textContent
+  }
+  const KINDS = {
+    fill: 'input:not([type=hidden]):not([type=checkbox]):not([type=radio]):not([type=submit]):not([type=button]):not([type=image]):not([type=reset]), textarea, [contenteditable=true]',
+    select: 'select',
+    check: 'input[type=checkbox], input[type=radio]',
+    click: 'button, a[href], [role=button], [role=link], [role=tab], [role=option], [role=menuitem], [role=checkbox], [role=switch], input[type=submit], input[type=button], input[type=image], summary, [title], label',
+  }
+  const SCOPES = 'li, tr, form, [role=listitem], [role=row]'
+  const scopeOf = (within) => {
+    if (within === null) return { roots: [null] }
+    const want = norm(within)
+    const all = [...document.querySelectorAll(SCOPES)].filter((el) => shown(el) && norm(el.innerText).includes(want))
+    const exact = all.filter((el) => el.innerText.split('\n').some((l) => norm(l) === want))
+    const pool = exact.length ? exact : all
+    const roots = pool.filter((el) => !pool.some((o) => o !== el && el.contains(o)))
+    if (!roots.length) return { error: 'No list item, table row or form contains "' + within + '"' }
+    return { roots }
+  }
+  const inside = (root, el) => root === null || root.contains(el) || (root.tagName === 'FORM' && el.form === root)
+  const note = (count, scoped) =>
+    [count > 1 ? count + ' matched; used the first' : null, scoped > 1 ? scoped + ' places contain the text and the target; used the first' : null]
+      .filter(Boolean).join('; ') || null
+  const find = (kind, name, within) => {
+    const scope = scopeOf(within)
+    if (scope.error) return scope
+    const want = norm(name)
+    let all = []
+    const found = scope.roots.map((root) => {
+      const pool = [...document.querySelectorAll(KINDS[kind])].filter((el) => shown(el) && inside(root, el))
+      all = all.concat(pool)
+      let hits = pool.filter((el) => norm(nameOf(el)) === want || norm(el.getAttribute('title')) === want)
+      if (!hits.length && kind !== 'click') hits = pool.filter((el) => norm(el.getAttribute('name')) === want)
+      if (!hits.length && kind === 'click')
+        hits = [...(root ?? document.body).querySelectorAll('*')].filter(
+          (el) => shown(el) && norm(el.textContent) === want && ![...el.children].some((c) => norm(c.textContent) === want),
+        )
+      return hits
+    }).filter((hits) => hits.length)
+    if (!found.length) {
+      const names = [...new Set(all.map((el) => (nameOf(el) ?? '').replace(/\s+/g, ' ').trim()).filter(Boolean))]
+      return { error: 'No ' + kind + ' target named "' + name + '"' + (within === null ? '' : ' in "' + within + '"') + (names.length ? '. ' + (within === null ? 'On the page' : 'There') + ': ' + names.slice(0, 20).map((n) => JSON.stringify(n.slice(0, 40))).join(', ') : '') }
+    }
+    return { els: found[0], scoped: found.length }
+  }
+  const setValue = (el, value) => {
+    const proto = el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : el instanceof HTMLSelectElement ? HTMLSelectElement.prototype : HTMLInputElement.prototype
+    el.focus()
+    if (el.isContentEditable) el.textContent = value
+    else Object.getOwnPropertyDescriptor(proto, 'value').set.call(el, value)
+    el.dispatchEvent(new Event('input', { bubbles: true }))
+    el.dispatchEvent(new Event('change', { bubbles: true }))
+  }
+  const jsOnly = (el) => {
+    const tag = el.tagName.toLowerCase()
+    const type = (el.getAttribute('type') ?? '').toLowerCase()
+    if (tag === 'a') return el.hasAttribute('href') ? null : 'a link without href'
+    if (tag === 'button') return type === 'button' ? 'a type=button button' : el.form ? null : 'a button outside a form'
+    if (tag === 'input') {
+      if (type === 'button') return 'a type=button input'
+      if (['submit', 'image', 'reset'].includes(type)) return el.form ? null : 'a button outside a form'
+      return null
+    }
+    if (tag === 'label') return el.control ? null : 'a label without a control'
+    if (['summary', 'select', 'option', 'textarea'].includes(tag)) return null
+    const host = el.parentElement?.closest('a[href], button, label, summary, input')
+    if (host) return jsOnly(host)
+    const role = el.getAttribute('role')
+    return 'a <' + tag + '>' + (role ? ' with role=' + role : '') + ' has no native action'
+  }
+  const at = (el) => {
+    el.scrollIntoView({ block: 'center', inline: 'center', behavior: 'instant' })
+    const r = el.getBoundingClientRect()
+    const x = r.left + r.width / 2
+    const y = r.top + r.height / 2
+    const top = document.elementFromPoint(x, y)
+    const label = el.control ?? null
+    const hit = top && (el.contains(top) || top.contains(el) || top === label || (top.tagName === 'LABEL' && top.control === el))
+    return { x, y, covered: hit ? null : top ? '<' + top.tagName.toLowerCase() + '>' : 'nothing' }
+  }
+  const FILLED = Symbol.for('hozu.browse.filled')
+  const formName = (form) => {
+    const own = form.getAttribute('aria-label') ?? (form.getAttribute('aria-labelledby') ? nameOf(form) : null) ?? form.querySelector('legend')?.textContent
+    const buttons = [...form.elements].filter((e) => (e.tagName === 'BUTTON' && (e.getAttribute('type') ?? 'submit') === 'submit') || (e.tagName === 'INPUT' && ['submit', 'image'].includes(e.type)))
+    return { names: [own, ...buttons.map((b) => nameOf(b))].filter(Boolean).map((n) => n.replace(/\s+/g, ' ').trim()), buttons }
+  }
+  const TEXT_TYPES = ['text', 'search', 'email', 'url', 'tel', 'password', 'number', 'date', 'datetime-local', 'month', 'time', 'week']
+  return {
+    point(name, within) {
+      const f = find('click', name, within)
+      if (f.error) return f
+      return { ...at(f.els[0]), jsOnly: jsOnly(f.els[0]), note: note(f.els.length, f.scoped) }
+    },
+    checkable(name, within) {
+      const f = find('check', name, within)
+      if (f.error) return f
+      const el = f.els[0]
+      return { ...at(el), checked: el.checked, radio: el.type === 'radio', note: note(f.els.length, f.scoped) }
+    },
+    fill(name, value, within) {
+      const f = find('fill', name, within)
+      if (f.error) return f
+      const done = (window[FILLED] ??= new WeakSet())
+      const index = Math.max(0, f.els.findIndex((el) => !done.has(el)))
+      done.add(f.els[index])
+      setValue(f.els[index], value)
+      return { note: f.els.length > 1 ? 'filled ' + (index + 1) + ' of ' + f.els.length + ' named "' + name + '"' : note(1, f.scoped) }
+    },
+    select(name, option, within) {
+      const f = find('select', name, within)
+      if (f.error) return f
+      const el = f.els[0]
+      const o = [...el.options].find((o) => norm(o.textContent) === norm(option) || o.value === option)
+      if (!o) return { error: 'Select "' + name + '" has no option "' + option + '". Options: ' + [...el.options].map((o) => JSON.stringify(o.textContent.trim())).join(', ') }
+      if (el.multiple) {
+        el.focus()
+        o.selected = true
+        el.dispatchEvent(new Event('input', { bubbles: true }))
+        el.dispatchEvent(new Event('change', { bubbles: true }))
+      } else setValue(el, o.value)
+      return { note: note(f.els.length, f.scoped) }
+    },
+    submit(label, within) {
+      const scope = scopeOf(within)
+      if (scope.error) return scope
+      const want = norm(label)
+      const forms = [...document.forms].filter((f) => scope.roots.some((root) => inside(root, f) || root?.contains(f)))
+      const hits = forms.filter((f) => formName(f).names.some((n) => norm(n) === want))
+      if (!hits.length) {
+        const names = forms.map((f) => formName(f).names[0]).filter(Boolean)
+        return { error: 'No form named "' + label + '"' + (names.length ? '. Forms: ' + names.slice(0, 20).map((n) => JSON.stringify(n.slice(0, 40))).join(', ') : '') }
+      }
+      const form = hits[0]
+      form.requestSubmit(formName(form).buttons[0])
+      return { note: note(hits.length, 1) }
+    },
+    keyJsOnly(key) {
+      const el = document.activeElement
+      const tag = el && el !== document.body ? el.tagName.toLowerCase() : null
+      if (key === 'Tab') return null
+      if (key === 'Enter') {
+        if (!tag) return 'nothing is focused'
+        if (tag === 'a') return el.hasAttribute('href') ? null : 'a link without href'
+        if (tag === 'button') return jsOnly(el)
+        if (tag === 'textarea') return 'Enter in a textarea adds a line'
+        if (tag === 'input') {
+          if (!el.form) return 'Enter in a field outside a form'
+          const buttons = formName(el.form).buttons
+          const fields = [...el.form.elements].filter((e) => e.tagName === 'INPUT' && TEXT_TYPES.includes(e.type))
+          if (!buttons.length && fields.length > 1) return 'the form has no submit button'
+          return TEXT_TYPES.includes(el.type) ? null : jsOnly(el)
+        }
+        return 'Enter on a <' + tag + '> has no native action'
+      }
+      if (key === 'Space' || key.length === 1) return tag ? null : 'nothing is focused'
+      return key + ' has no native action'
+    },
+    snapshot() {
+      const clean = (s) => (s ?? '').replace(/[ \t]+/g, ' ').replace(/\n\s*\n+/g, '\n').trim()
+      const text = clean(document.body?.innerText)
+      const component = [...document.querySelectorAll('[data-hozu-component]')].flatMap((el) => clean(el.innerText).split('\n').filter(Boolean))
+      const url = new URL(location.href)
+      url.searchParams.delete('__hozu')
+      return { url: url.pathname + url.search, title: document.title, text, component }
+    },
+    report(selectors, expected) {
+      const components = []
+      const hydrated = document.documentElement.hasAttribute('data-hozu-ready') || !document.getElementById('hozu-payload')
+      for (const el of document.querySelectorAll('[data-hozu-component]')) {
+        const name = el.getAttribute('data-hozu-component')
+        const state = el.getAttribute('data-hozu-component-state')
+        const load = expected.find(([n]) => n === name)?.[1]
+        const r = el.getBoundingClientRect()
+        const empty = !el.children.length && !el.textContent.trim()
+        components.push({
+          name,
+          state: state === 'loading' ? 'not mounted' : state,
+          width: Math.round(r.width),
+          height: Math.round(r.height),
+          canvases: el.querySelectorAll('canvas').length,
+          elements: el.querySelectorAll('*').length,
+          hint:
+            state === 'failed'
+              ? 'its setup threw; see errors'
+              : state === 'loading'
+                ? load === 'visible' && (r.bottom < 0 || r.top > innerHeight)
+                  ? "load: 'visible' mounts it when it scrolls into view"
+                  : load === 'idle'
+                    ? "load: 'idle' mounts it when the browser is idle"
+                    : 'its module has not loaded; see errors'
+                : r.height === 0
+                  ? 'it has no height, so a map or canvas inside shows nothing: give it a height class such as h-64'
+                  : empty
+                    ? 'it mounted but rendered nothing'
+                    : null,
+        })
+      }
+      if (!hydrated)
+        for (const [name] of expected)
+          components.push({
+            name, state: 'not mounted', width: null, height: null, canvases: 0, elements: 0,
+            hint: 'the page did not hydrate; see errors',
+          })
+      const elements = []
+      for (const sel of selectors)
+        for (const el of document.querySelectorAll(sel)) {
+          const attrs = {}
+          for (const a of el.attributes) attrs[a.name] = a.value
+          const text = (el.innerText ?? el.textContent ?? '').replace(/\s+/g, ' ').trim()
+          elements.push({ selector: sel, tag: el.tagName.toLowerCase(), attrs, text: text.length > 120 ? text.slice(0, 120) + '…' : text })
+        }
+      return { hydrated, components, elements }
+    },
+  }
+})()`;
+//# sourceMappingURL=browse-page.js.map

package/dist/commands/browse-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-page.js","sourceRoot":"","sources":["../../src/commands/browse-page.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkOzB,CAAA"}

package/dist/commands/browse-tab.d.ts

@@ -0,0 +1,80 @@
+import type { Cdp } from '../cdp.ts';
+import type { BrowseError, BrowseMode } from '../contract.ts';
+import type { WorldRequest } from './browse-world.ts';
+export declare const ORIGIN = "http://localhost";
+export declare const sleep: (ms: number) => Promise<unknown>;
+interface Head {
+    id: number;
+    status: number;
+    headers: [string, string][];
+    stream: boolean;
+    body?: Uint8Array;
+}
+/** One app world (module graph, data, session store) per mode, in its own worker. */
+export declare class World {
+    readonly cookies: Promise<(string | null)[]>;
+    private readonly worker;
+    private next;
+    private readonly heads;
+    private readonly chunks;
+    constructor(config: string | undefined, cwd: string, sessions: (string | undefined)[]);
+    fetch(request: Omit<Extract<WorldRequest, {
+        url: string;
+    }>, 'id'>, onChunk: (c: string | null) => void): Promise<Head>;
+    cancel(id: number): void;
+    close(): Promise<number>;
+}
+export interface Snapshot {
+    url: string;
+    title: string;
+    text: string;
+    component: string[];
+}
+export interface StepResult {
+    ok: boolean;
+    note: string | null;
+    jsOnly: string | null;
+}
+/** One browser context and page for one actor in one mode. */
+export declare class Tab {
+    sessionId: string;
+    targetId: string;
+    status: number;
+    loaded: boolean;
+    requested: boolean;
+    snapshot: Snapshot;
+    readonly sessions: Set<string>;
+    private readonly prerender;
+    private readonly tracked;
+    private readonly urls;
+    private readonly live;
+    private readonly invalidPosts;
+    private lastActivity;
+    private activity;
+    private marked;
+    private location;
+    private prerendering;
+    private readonly cdp;
+    private readonly world;
+    readonly mode: BrowseMode;
+    readonly actor: string | null;
+    private readonly errors;
+    constructor(cdp: Cdp, world: World, mode: BrowseMode, actor: string | null, errors: BrowseError[]);
+    send(method: string, params?: Record<string, unknown>, session?: string): Promise<any>;
+    start(cookie: string | null, reducedMotion: boolean): Promise<void>;
+    private enable;
+    private error;
+    handle(method: string, params: any, session: string): boolean;
+    private fulfill;
+    private paused;
+    evaluate(expression: string): Promise<any>;
+    page(call: string): Promise<any>;
+    mark(): void;
+    settle(): Promise<void>;
+    open(path: string): Promise<void>;
+    look(): Promise<Snapshot>;
+    mouse(x: number, y: number): Promise<void>;
+    key(name: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=browse-tab.d.ts.map

package/dist/commands/browse-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-tab.d.ts","sourceRoot":"","sources":["../../src/commands/browse-tab.ts"],"names":[],"mappings":"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"}