nothing-browser 0.1.0 → 0.1.1

package/dist/piggy/find/index.d.ts

@@ -12,74 +12,36 @@ export interface ElementDescriptor {
     value: string;
     attrs: Record<string, string>;
 }
-export interface FindByTextOptions {
-    text: string;
-    /** Narrow the search to descendants of this CSS selector. */
-    selector?: string;
-    /** If true, innerText must match exactly (trimmed). Default: false. */
-    exact?: boolean;
-}
-export interface FindByAttrOptions {
-    attr: string;
-    /** If omitted, matches any element that has the attribute at all. */
-    value?: string;
-    /** Optionally scope to a parent selector. */
-    selector?: string;
-}
-export interface FindByRoleOptions {
-    role: string;
-    /** Filter by aria-label or innerText containing this string. */
-    name?: string;
-}
-export interface FindClosestOptions {
-    /** CSS selector for the starting element. */
-    selector: string;
-    /** CSS selector for the ancestor to climb to. */
-    ancestor: string;
-}
-export interface FindFilterOptions {
-    selector: string;
-    attr: string;
-    value: string;
-}
 export declare class FindClient {
     private client;
     constructor(client: PiggyClient);
     /** querySelectorAll — returns all matching elements. */
     css(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
-    /** Alias for css() — querySelectorAll. */
+    /** Alias for css(). */
     all(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
     /** querySelector — returns a single-element array or []. */
     first(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
-    /** Find elements whose innerText contains (or exactly matches) the given text. */
-    byText(opts: FindByTextOptions, tabId?: string): Promise<ElementDescriptor[]>;
-    /** Find elements by attribute name and optional value. */
-    byAttr(opts: FindByAttrOptions, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Find elements whose innerText contains the given text. */
+    byText(text: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Find elements by attribute name (and optional value). */
+    byAttr(attr: string, value?: string, tabId?: string): Promise<ElementDescriptor[]>;
     /** getElementsByTagName. */
     byTag(tag: string, tabId?: string): Promise<ElementDescriptor[]>;
     /** Find inputs/textareas whose placeholder contains the given text. */
     byPlaceholder(text: string, tabId?: string): Promise<ElementDescriptor[]>;
-    /** Find elements by ARIA role, optionally filtered by aria-label / innerText. */
-    byRole(opts: FindByRoleOptions, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Find elements by ARIA role, optionally filtered by accessible name. */
+    byRole(role: string, name?: string, tabId?: string): Promise<ElementDescriptor[]>;
     /** Direct children of the matched element. */
     children(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
-    /**
-     * Filter querySelectorAll results by attribute value substring.
-     * Equivalent to: querySelectorAll(selector).filter(el => el.attr.includes(value))
-     */
-    filter(opts: FindFilterOptions, tabId?: string): Promise<ElementDescriptor[]>;
-    /** Walk up the DOM from selector until ancestor matches. */
-    closest(opts: FindClosestOptions, tabId?: string): Promise<ElementDescriptor[]>;
     /** parentElement of the matched element. */
     parent(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Walk up the DOM from selector until ancestor matches. */
+    closest(selector: string, ancestor: string, tabId?: string): Promise<ElementDescriptor[]>;
     /** Number of elements matching the selector. */
     count(selector: string, tabId?: string): Promise<number>;
-    /** True if at least one element matches the selector. */
+    /** True if at least one element matches. */
     exists(selector: string, tabId?: string): Promise<boolean>;
-    /**
-     * True if the first matched element is visible
-     * (display !== none, visibility !== hidden, opacity !== 0).
-     */
+    /** True if the first matched element is visible. */
     visible(selector: string, tabId?: string): Promise<boolean>;
     /** True if the first matched element is not disabled. */
     enabled(selector: string, tabId?: string): Promise<boolean>;

package/dist/piggy/find/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/find/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/find/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAKxC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAI,MAAM,CAAC;IACd,EAAE,EAAK,MAAM,CAAC;IACd,GAAG,EAAI,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAG,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAG,MAAM,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;IACd,GAAG,EAAI,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAOD,qBAAa,UAAU;IACT,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAIvC,wDAAwD;IACxD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAItE,uBAAuB;IACvB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAItE,4DAA4D;IAC5D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxE,6DAA6D;IAC7D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIrE,4DAA4D;IAC5D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIrF,4BAA4B;IAC5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAInE,uEAAuE;IACvE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAI5E,0EAA0E;IAC1E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIpF,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAI3E,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIzE,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAM5F,gDAAgD;IAChD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D,oDAAoD;IACpD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,yDAAyD;IACzD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAG/D;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAE7D"}

package/dist/piggy/provide/index.d.ts

@@ -1,4 +1,21 @@
 import { PiggyClient } from "../client";
+export interface ProvideOptions {
+    /** CSS selector for the target element(s). */
+    selector: string;
+    /**
+     * Optional parent selector to scope the query under.
+     * Equivalent to: parent.querySelector(selector)
+     */
+    parent?: string;
+}
+export interface ProvideAttrOptions extends ProvideOptions {
+    /** The attribute name to extract. */
+    attr: string;
+}
+export interface ProvideListOptions extends ProvideOptions {
+    /** Optional child selector to scope list items. */
+    itemSel?: string;
+}
 export interface ProvideTable {
     headers: string[];
     rows: string[][];
@@ -44,38 +61,38 @@ export declare class ProvideClient {
     private client;
     constructor(client: PiggyClient);
     /** innerText of the first matched element. */
-    text(selector: string, tabId?: string): Promise<string>;
+    text(opts: ProvideOptions, tabId?: string): Promise<string>;
     /** innerText of all matched elements. */
-    textAll(selector: string, tabId?: string): Promise<string[]>;
+    textAll(opts: ProvideOptions, tabId?: string): Promise<string[]>;
     /** Single attribute value from the first matched element. */
-    attr(selector: string, attr: string, tabId?: string): Promise<string>;
+    attr(opts: ProvideAttrOptions, tabId?: string): Promise<string>;
     /** Attribute value from all matched elements. */
-    attrAll(selector: string, attr: string, tabId?: string): Promise<string[]>;
+    attrAll(opts: ProvideAttrOptions, tabId?: string): Promise<string[]>;
     /** innerHTML of the first matched element. */
-    html(selector: string, tabId?: string): Promise<string>;
+    html(opts: ProvideOptions, tabId?: string): Promise<string>;
     /** Extract a table into headers + rows. */
-    table(selector: string, tabId?: string): Promise<ProvideTable>;
-    /** Extract a list of text items. Optionally scope items with itemSel. */
-    list(selector: string, itemSel?: string, tabId?: string): Promise<string[]>;
-    /** All links inside an optional selector. */
-    links(selector?: string, tabId?: string): Promise<ProvideLink[]>;
-    /** All images inside an optional selector. */
-    images(selector?: string, tabId?: string): Promise<ProvideImage[]>;
+    table(opts: ProvideOptions, tabId?: string): Promise<ProvideTable>;
+    /** Extract a list of text items, optionally scoped to child items. */
+    list(opts: ProvideListOptions, tabId?: string): Promise<string[]>;
+    /** All links inside the matched selector. */
+    links(opts: ProvideOptions, tabId?: string): Promise<ProvideLink[]>;
+    /** All images inside the matched selector. */
+    images(opts: ProvideOptions, tabId?: string): Promise<ProvideImage[]>;
     /** Form field name→value map. */
-    form(selector: string, tabId?: string): Promise<ProvideForm>;
-    /** Full page info: title, url, html, text. */
+    form(opts: ProvideOptions, tabId?: string): Promise<ProvideForm>;
+    /** Full page info: title, url, html, text. No selector needed. */
     page(tabId?: string): Promise<ProvidePage>;
-    /** Structured div: tag, id, cls, text, html, children[]. */
-    div(selector: string, tabId?: string): Promise<ProvideDiv>;
-    /** All <meta> name→content pairs. */
+    /** Structured div tree: tag, id, cls, text, html, children[]. */
+    div(opts: ProvideOptions, tabId?: string): Promise<ProvideDiv>;
+    /** All <meta> name→content pairs. No selector needed. */
     meta(tabId?: string): Promise<ProvideMeta>;
     /** <select> current value + all options. */
-    select(selector: string, tabId?: string): Promise<ProvideSelect>;
+    select(opts: ProvideOptions, tabId?: string): Promise<ProvideSelect>;
     /**
      * Parse JSON from element innerText or script[type=application/json].
      * selector is optional — defaults to the first matching JSON script tag.
      */
-    json(selector?: string, tabId?: string): Promise<unknown>;
+    json(opts?: Partial<ProvideOptions>, tabId?: string): Promise<unknown>;
 }
 export declare function createProvideAPI(client: PiggyClient): ProvideClient;
 //# sourceMappingURL=index.d.ts.map

package/dist/piggy/provide/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/provide/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAK,MAAM,EAAE,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAI,MAAM,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAO,MAAM,CAAC;IACjB,EAAE,EAAQ,MAAM,CAAC;IACjB,GAAG,EAAO,MAAM,CAAC;IACjB,IAAI,EAAM,MAAM,CAAC;IACjB,IAAI,EAAM,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAM,MAAM,CAAC;IACjB,KAAK,EAAK,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAI,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAID,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEvC,8CAA8C;IAC9C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1D,yCAAyC;IACzC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/D,6DAA6D;IAC7D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxE,iDAAiD;IACjD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI7E,8CAA8C;IAC9C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1D,2CAA2C;IAC3C,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjE,yEAAyE;IACzE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI9E,6CAA6C;IAC7C,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAInE,8CAA8C;IAC9C,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrE,iCAAiC;IACjC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/D,8CAA8C;IAC9C,IAAI,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7C,4DAA4D;IAC5D,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7D,qCAAqC;IACrC,IAAI,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7C,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAInE;;;OAGG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAG7D;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAEnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/provide/index.ts"],"names":[],"mappings":"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"}

package/dist/piggy.js

@@ -29333,11 +29333,11 @@ class FindClient {
   first(selector, tabId = "default") {
     return this.client.send("find.first", { selector, tabId });
   }
-  byText(opts, tabId = "default") {
-    return this.client.send("find.byText", { ...opts, tabId });
+  byText(text, tabId = "default") {
+    return this.client.send("find.byText", { text, tabId });
   }
-  byAttr(opts, tabId = "default") {
-    return this.client.send("find.byAttr", { ...opts, tabId });
+  byAttr(attr, value, tabId = "default") {
+    return this.client.send("find.byAttr", { attr, value, tabId });
   }
   byTag(tag, tabId = "default") {
     return this.client.send("find.byTag", { tag, tabId });
@@ -29345,21 +29345,18 @@ class FindClient {
   byPlaceholder(text, tabId = "default") {
     return this.client.send("find.byPlaceholder", { text, tabId });
   }
-  byRole(opts, tabId = "default") {
-    return this.client.send("find.byRole", { ...opts, tabId });
+  byRole(role, name, tabId = "default") {
+    return this.client.send("find.byRole", { role, name, tabId });
   }
   children(selector, tabId = "default") {
     return this.client.send("find.children", { selector, tabId });
   }
-  filter(opts, tabId = "default") {
-    return this.client.send("find.filter", { ...opts, tabId });
-  }
-  closest(opts, tabId = "default") {
-    return this.client.send("find.closest", { ...opts, tabId });
-  }
   parent(selector, tabId = "default") {
     return this.client.send("find.parent", { selector, tabId });
   }
+  closest(selector, ancestor, tabId = "default") {
+    return this.client.send("find.closest", { selector, ancestor, tabId });
+  }
   count(selector, tabId = "default") {
     return this.client.send("find.count", { selector, tabId });
   }
@@ -29544,50 +29541,50 @@ class ProvideClient {
   constructor(client) {
     this.client = client;
   }
-  text(selector, tabId = "default") {
-    return this.client.send("provide.text", { selector, tabId });
+  text(opts, tabId = "default") {
+    return this.client.send("provide.text", { ...opts, tabId });
   }
-  textAll(selector, tabId = "default") {
-    return this.client.send("provide.textAll", { selector, tabId });
+  textAll(opts, tabId = "default") {
+    return this.client.send("provide.textAll", { ...opts, tabId });
   }
-  attr(selector, attr, tabId = "default") {
-    return this.client.send("provide.attr", { selector, attr, tabId });
+  attr(opts, tabId = "default") {
+    return this.client.send("provide.attr", { ...opts, tabId });
   }
-  attrAll(selector, attr, tabId = "default") {
-    return this.client.send("provide.attrAll", { selector, attr, tabId });
+  attrAll(opts, tabId = "default") {
+    return this.client.send("provide.attrAll", { ...opts, tabId });
   }
-  html(selector, tabId = "default") {
-    return this.client.send("provide.html", { selector, tabId });
+  html(opts, tabId = "default") {
+    return this.client.send("provide.html", { ...opts, tabId });
   }
-  table(selector, tabId = "default") {
-    return this.client.send("provide.table", { selector, tabId });
+  table(opts, tabId = "default") {
+    return this.client.send("provide.table", { ...opts, tabId });
   }
-  list(selector, itemSel, tabId = "default") {
-    return this.client.send("provide.list", { selector, itemSel, tabId });
+  list(opts, tabId = "default") {
+    return this.client.send("provide.list", { ...opts, tabId });
   }
-  links(selector, tabId = "default") {
-    return this.client.send("provide.links", { selector, tabId });
+  links(opts, tabId = "default") {
+    return this.client.send("provide.links", { ...opts, tabId });
   }
-  images(selector, tabId = "default") {
-    return this.client.send("provide.images", { selector, tabId });
+  images(opts, tabId = "default") {
+    return this.client.send("provide.images", { ...opts, tabId });
   }
-  form(selector, tabId = "default") {
-    return this.client.send("provide.form", { selector, tabId });
+  form(opts, tabId = "default") {
+    return this.client.send("provide.form", { ...opts, tabId });
   }
   page(tabId = "default") {
     return this.client.send("provide.page", { tabId });
   }
-  div(selector, tabId = "default") {
-    return this.client.send("provide.div", { selector, tabId });
+  div(opts, tabId = "default") {
+    return this.client.send("provide.div", { ...opts, tabId });
   }
   meta(tabId = "default") {
     return this.client.send("provide.meta", { tabId });
   }
-  select(selector, tabId = "default") {
-    return this.client.send("provide.select", { selector, tabId });
+  select(opts, tabId = "default") {
+    return this.client.send("provide.select", { ...opts, tabId });
   }
-  json(selector, tabId = "default") {
-    return this.client.send("provide.json", { selector, tabId });
+  json(opts, tabId = "default") {
+    return this.client.send("provide.json", { ...opts, tabId });
   }
 }
 function createProvideAPI(client) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nothing-browser",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Browser automation library powered by Nothing Browser",
   "homepage": "https://github.com/ernest-tech-house-co-operation/nothing-browser#readme",
   "repository": {

package/piggy/find/index.ts

@@ -5,69 +5,35 @@ import { PiggyClient } from "../client";
 // Mirrors __nb_serialize() in PiggyFind.cpp
 
 export interface ElementDescriptor {
-  tag: string;
-  id: string;
-  cls: string;
+  tag:   string;
+  id:    string;
+  cls:   string;
   /** First 400 chars of innerText */
-  text: string;
+  text:  string;
   /** First 800 chars of innerHTML */
-  html: string;
-  href: string;
-  src: string;
+  html:  string;
+  href:  string;
+  src:   string;
   value: string;
   attrs: Record<string, string>;
 }
 
-// ─── Option types ─────────────────────────────────────────────────────────────
-
-export interface FindByTextOptions {
-  text: string;
-  /** Narrow the search to descendants of this CSS selector. */
-  selector?: string;
-  /** If true, innerText must match exactly (trimmed). Default: false. */
-  exact?: boolean;
-}
-
-export interface FindByAttrOptions {
-  attr: string;
-  /** If omitted, matches any element that has the attribute at all. */
-  value?: string;
-  /** Optionally scope to a parent selector. */
-  selector?: string;
-}
-
-export interface FindByRoleOptions {
-  role: string;
-  /** Filter by aria-label or innerText containing this string. */
-  name?: string;
-}
-
-export interface FindClosestOptions {
-  /** CSS selector for the starting element. */
-  selector: string;
-  /** CSS selector for the ancestor to climb to. */
-  ancestor: string;
-}
-
-export interface FindFilterOptions {
-  selector: string;
-  attr: string;
-  value: string;
-}
-
 // ─── FindClient ───────────────────────────────────────────────────────────────
+// find answers ONE question: "is this thing here, and where?"
+// All methods take plain selector strings — no option objects, no parent scoping.
+// If you need a value out of an element, use provide instead.
 
 export class FindClient {
   constructor(private client: PiggyClient) {}
 
-  // ── Multi-result queries ─────────────────────────────────────────────────────
+  // ── Multi-result ─────────────────────────────────────────────────────────────
 
   /** querySelectorAll — returns all matching elements. */
   css(selector: string, tabId = "default"): Promise<ElementDescriptor[]> {
     return this.client.send("find.css", { selector, tabId });
   }
 
-  /** Alias for css() — querySelectorAll. */
+  /** Alias for css(). */
   all(selector: string, tabId = "default"): Promise<ElementDescriptor[]> {
     return this.client.send("find.all", { selector, tabId });
   }
@@ -77,14 +43,14 @@ export class FindClient {
     return this.client.send("find.first", { selector, tabId });
   }
 
-  /** Find elements whose innerText contains (or exactly matches) the given text. */
-  byText(opts: FindByTextOptions, tabId = "default"): Promise<ElementDescriptor[]> {
-    return this.client.send("find.byText", { ...opts, tabId });
+  /** Find elements whose innerText contains the given text. */
+  byText(text: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.byText", { text, tabId });
   }
 
-  /** Find elements by attribute name and optional value. */
-  byAttr(opts: FindByAttrOptions, tabId = "default"): Promise<ElementDescriptor[]> {
-    return this.client.send("find.byAttr", { ...opts, tabId });
+  /** Find elements by attribute name (and optional value). */
+  byAttr(attr: string, value?: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.byAttr", { attr, value, tabId });
   }
 
   /** getElementsByTagName. */
@@ -97,9 +63,9 @@ export class FindClient {
     return this.client.send("find.byPlaceholder", { text, tabId });
   }
 
-  /** Find elements by ARIA role, optionally filtered by aria-label / innerText. */
-  byRole(opts: FindByRoleOptions, tabId = "default"): Promise<ElementDescriptor[]> {
-    return this.client.send("find.byRole", { ...opts, tabId });
+  /** Find elements by ARIA role, optionally filtered by accessible name. */
+  byRole(role: string, name?: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.byRole", { role, name, tabId });
   }
 
   /** Direct children of the matched element. */
@@ -107,42 +73,29 @@ export class FindClient {
     return this.client.send("find.children", { selector, tabId });
   }
 
-  /**
-   * Filter querySelectorAll results by attribute value substring.
-   * Equivalent to: querySelectorAll(selector).filter(el => el.attr.includes(value))
-   */
-  filter(opts: FindFilterOptions, tabId = "default"): Promise<ElementDescriptor[]> {
-    return this.client.send("find.filter", { ...opts, tabId });
-  }
-
-  // ── Single-element traversal ──────────────────────────────────────────────
-
-  /** Walk up the DOM from selector until ancestor matches. */
-  closest(opts: FindClosestOptions, tabId = "default"): Promise<ElementDescriptor[]> {
-    return this.client.send("find.closest", { ...opts, tabId });
-  }
-
   /** parentElement of the matched element. */
   parent(selector: string, tabId = "default"): Promise<ElementDescriptor[]> {
     return this.client.send("find.parent", { selector, tabId });
   }
 
-  // ── Boolean / numeric queries ─────────────────────────────────────────────
+  /** Walk up the DOM from selector until ancestor matches. */
+  closest(selector: string, ancestor: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.closest", { selector, ancestor, tabId });
+  }
+
+  // ── Boolean / numeric ────────────────────────────────────────────────────────
 
   /** Number of elements matching the selector. */
   count(selector: string, tabId = "default"): Promise<number> {
     return this.client.send("find.count", { selector, tabId });
   }
 
-  /** True if at least one element matches the selector. */
+  /** True if at least one element matches. */
   exists(selector: string, tabId = "default"): Promise<boolean> {
     return this.client.send("find.exists", { selector, tabId });
   }
 
-  /**
-   * True if the first matched element is visible
-   * (display !== none, visibility !== hidden, opacity !== 0).
-   */
+  /** True if the first matched element is visible. */
   visible(selector: string, tabId = "default"): Promise<boolean> {
     return this.client.send("find.visible", { selector, tabId });
   }
@@ -158,7 +111,7 @@ export class FindClient {
   }
 }
 
-// ── Factory helper ────────────────────────────────────────────────────────────
+// ─── Factory helper ───────────────────────────────────────────────────────────
 
 export function createFindAPI(client: PiggyClient): FindClient {
   return new FindClient(client);

package/piggy/provide/index.ts

@@ -1,6 +1,29 @@
 // piggy/provide/index.ts
 import { PiggyClient } from "../client";
 
+// ─── Shared base option ───────────────────────────────────────────────────────
+// Every provide method targets a selector, and optionally scopes under a parent.
+
+export interface ProvideOptions {
+  /** CSS selector for the target element(s). */
+  selector: string;
+  /**
+   * Optional parent selector to scope the query under.
+   * Equivalent to: parent.querySelector(selector)
+   */
+  parent?: string;
+}
+
+export interface ProvideAttrOptions extends ProvideOptions {
+  /** The attribute name to extract. */
+  attr: string;
+}
+
+export interface ProvideListOptions extends ProvideOptions {
+  /** Optional child selector to scope list items. */
+  itemSel?: string;
+}
+
 // ─── Return types ─────────────────────────────────────────────────────────────
 
 export interface ProvideTable {
@@ -54,86 +77,89 @@ export interface ProvideSelect {
 }
 
 // ─── ProvideClient ────────────────────────────────────────────────────────────
+// provide answers ONE question: "give me the actual value from this element."
+// All methods take an options object { selector, parent? } so scoping is consistent.
+// If you just want to know if something exists, use find instead.
 
 export class ProvideClient {
   constructor(private client: PiggyClient) {}
 
   /** innerText of the first matched element. */
-  text(selector: string, tabId = "default"): Promise<string> {
-    return this.client.send("provide.text", { selector, tabId });
+  text(opts: ProvideOptions, tabId = "default"): Promise<string> {
+    return this.client.send("provide.text", { ...opts, tabId });
   }
 
   /** innerText of all matched elements. */
-  textAll(selector: string, tabId = "default"): Promise<string[]> {
-    return this.client.send("provide.textAll", { selector, tabId });
+  textAll(opts: ProvideOptions, tabId = "default"): Promise<string[]> {
+    return this.client.send("provide.textAll", { ...opts, tabId });
   }
 
   /** Single attribute value from the first matched element. */
-  attr(selector: string, attr: string, tabId = "default"): Promise<string> {
-    return this.client.send("provide.attr", { selector, attr, tabId });
+  attr(opts: ProvideAttrOptions, tabId = "default"): Promise<string> {
+    return this.client.send("provide.attr", { ...opts, tabId });
   }
 
   /** Attribute value from all matched elements. */
-  attrAll(selector: string, attr: string, tabId = "default"): Promise<string[]> {
-    return this.client.send("provide.attrAll", { selector, attr, tabId });
+  attrAll(opts: ProvideAttrOptions, tabId = "default"): Promise<string[]> {
+    return this.client.send("provide.attrAll", { ...opts, tabId });
   }
 
   /** innerHTML of the first matched element. */
-  html(selector: string, tabId = "default"): Promise<string> {
-    return this.client.send("provide.html", { selector, tabId });
+  html(opts: ProvideOptions, tabId = "default"): Promise<string> {
+    return this.client.send("provide.html", { ...opts, tabId });
   }
 
   /** Extract a table into headers + rows. */
-  table(selector: string, tabId = "default"): Promise<ProvideTable> {
-    return this.client.send("provide.table", { selector, tabId });
+  table(opts: ProvideOptions, tabId = "default"): Promise<ProvideTable> {
+    return this.client.send("provide.table", { ...opts, tabId });
   }
 
-  /** Extract a list of text items. Optionally scope items with itemSel. */
-  list(selector: string, itemSel?: string, tabId = "default"): Promise<string[]> {
-    return this.client.send("provide.list", { selector, itemSel, tabId });
+  /** Extract a list of text items, optionally scoped to child items. */
+  list(opts: ProvideListOptions, tabId = "default"): Promise<string[]> {
+    return this.client.send("provide.list", { ...opts, tabId });
   }
 
-  /** All links inside an optional selector. */
-  links(selector?: string, tabId = "default"): Promise<ProvideLink[]> {
-    return this.client.send("provide.links", { selector, tabId });
+  /** All links inside the matched selector. */
+  links(opts: ProvideOptions, tabId = "default"): Promise<ProvideLink[]> {
+    return this.client.send("provide.links", { ...opts, tabId });
   }
 
-  /** All images inside an optional selector. */
-  images(selector?: string, tabId = "default"): Promise<ProvideImage[]> {
-    return this.client.send("provide.images", { selector, tabId });
+  /** All images inside the matched selector. */
+  images(opts: ProvideOptions, tabId = "default"): Promise<ProvideImage[]> {
+    return this.client.send("provide.images", { ...opts, tabId });
   }
 
   /** Form field name→value map. */
-  form(selector: string, tabId = "default"): Promise<ProvideForm> {
-    return this.client.send("provide.form", { selector, tabId });
+  form(opts: ProvideOptions, tabId = "default"): Promise<ProvideForm> {
+    return this.client.send("provide.form", { ...opts, tabId });
   }
 
-  /** Full page info: title, url, html, text. */
+  /** Full page info: title, url, html, text. No selector needed. */
   page(tabId = "default"): Promise<ProvidePage> {
     return this.client.send("provide.page", { tabId });
   }
 
-  /** Structured div: tag, id, cls, text, html, children[]. */
-  div(selector: string, tabId = "default"): Promise<ProvideDiv> {
-    return this.client.send("provide.div", { selector, tabId });
+  /** Structured div tree: tag, id, cls, text, html, children[]. */
+  div(opts: ProvideOptions, tabId = "default"): Promise<ProvideDiv> {
+    return this.client.send("provide.div", { ...opts, tabId });
   }
 
-  /** All <meta> name→content pairs. */
+  /** All <meta> name→content pairs. No selector needed. */
   meta(tabId = "default"): Promise<ProvideMeta> {
     return this.client.send("provide.meta", { tabId });
   }
 
   /** <select> current value + all options. */
-  select(selector: string, tabId = "default"): Promise<ProvideSelect> {
-    return this.client.send("provide.select", { selector, tabId });
+  select(opts: ProvideOptions, tabId = "default"): Promise<ProvideSelect> {
+    return this.client.send("provide.select", { ...opts, tabId });
   }
 
   /**
    * Parse JSON from element innerText or script[type=application/json].
    * selector is optional — defaults to the first matching JSON script tag.
    */
-  json(selector?: string, tabId = "default"): Promise<unknown> {
-    return this.client.send("provide.json", { selector, tabId });
+  json(opts?: Partial<ProvideOptions>, tabId = "default"): Promise<unknown> {
+    return this.client.send("provide.json", { ...opts, tabId });
   }
 }
 

package/piggy/find/index.d.ts

@@ -1,79 +0,0 @@
-// piggy/find/index.d.ts
-import { PiggyClient } from "../client";
-
-// ─── Element descriptor ───────────────────────────────────────────────────────
-
-export interface ElementDescriptor {
-  tag: string;
-  id: string;
-  cls: string;
-  /** First 400 chars of innerText */
-  text: string;
-  /** First 800 chars of innerHTML */
-  html: string;
-  href: string;
-  src: string;
-  value: string;
-  attrs: Record<string, string>;
-}
-
-// ─── Option types ─────────────────────────────────────────────────────────────
-
-export interface FindByTextOptions {
-  text: string;
-  selector?: string;
-  exact?: boolean;
-}
-
-export interface FindByAttrOptions {
-  attr: string;
-  value?: string;
-  selector?: string;
-}
-
-export interface FindByRoleOptions {
-  role: string;
-  name?: string;
-}
-
-export interface FindClosestOptions {
-  selector: string;
-  ancestor: string;
-}
-
-export interface FindFilterOptions {
-  selector: string;
-  attr: string;
-  value: string;
-}
-
-// ─── FindClient ───────────────────────────────────────────────────────────────
-
-export declare class FindClient {
-  constructor(client: PiggyClient);
-
-  // Multi-result
-  css(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
-  all(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
-  first(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
-  byText(opts: FindByTextOptions, tabId?: string): Promise<ElementDescriptor[]>;
-  byAttr(opts: FindByAttrOptions, tabId?: string): Promise<ElementDescriptor[]>;
-  byTag(tag: string, tabId?: string): Promise<ElementDescriptor[]>;
-  byPlaceholder(text: string, tabId?: string): Promise<ElementDescriptor[]>;
-  byRole(opts: FindByRoleOptions, tabId?: string): Promise<ElementDescriptor[]>;
-  children(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
-  filter(opts: FindFilterOptions, tabId?: string): Promise<ElementDescriptor[]>;
-
-  // Traversal
-  closest(opts: FindClosestOptions, tabId?: string): Promise<ElementDescriptor[]>;
-  parent(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
-
-  // Boolean / numeric
-  count(selector: string, tabId?: string): Promise<number>;
-  exists(selector: string, tabId?: string): Promise<boolean>;
-  visible(selector: string, tabId?: string): Promise<boolean>;
-  enabled(selector: string, tabId?: string): Promise<boolean>;
-  checked(selector: string, tabId?: string): Promise<boolean>;
-}
-
-export declare function createFindAPI(client: PiggyClient): FindClient;