sentienceapi 0.92.2__py3-none-any.whl → 0.98.0__py3-none-any.whl

sentience/extension/injected_api.js

@@ -10,6 +10,165 @@
         }
         return elements;
     }
+    const CAPTCHA_TEXT_KEYWORDS = [ "verify you are human", "captcha", "human verification", "unusual traffic", "are you a robot", "security check", "prove you are human", "bot detection", "automated access" ], CAPTCHA_URL_HINTS = [ "captcha", "challenge", "verify" ], CAPTCHA_IFRAME_HINTS = {
+        recaptcha: [ "recaptcha", "google.com/recaptcha" ],
+        hcaptcha: [ "hcaptcha.com" ],
+        turnstile: [ "challenges.cloudflare.com", "turnstile" ],
+        arkose: [ "arkoselabs.com", "funcaptcha.com", "client-api.arkoselabs.com" ],
+        awswaf: [ "amazonaws.com/captcha", "awswaf.com" ]
+    }, CAPTCHA_SCRIPT_HINTS = {
+        recaptcha: [ "recaptcha" ],
+        hcaptcha: [ "hcaptcha" ],
+        turnstile: [ "turnstile", "challenges.cloudflare.com" ],
+        arkose: [ "arkoselabs", "funcaptcha" ],
+        awswaf: [ "captcha.awswaf", "awswaf-captcha" ]
+    }, CAPTCHA_CONTAINER_SELECTORS = [ {
+        selector: ".g-recaptcha",
+        provider: "recaptcha"
+    }, {
+        selector: "#g-recaptcha",
+        provider: "recaptcha"
+    }, {
+        selector: "[data-sitekey]",
+        provider: "unknown"
+    }, {
+        selector: 'iframe[title*="recaptcha" i]',
+        provider: "recaptcha"
+    }, {
+        selector: ".h-captcha",
+        provider: "hcaptcha"
+    }, {
+        selector: "#h-captcha",
+        provider: "hcaptcha"
+    }, {
+        selector: 'iframe[title*="hcaptcha" i]',
+        provider: "hcaptcha"
+    }, {
+        selector: ".cf-turnstile",
+        provider: "turnstile"
+    }, {
+        selector: "[data-cf-turnstile-sitekey]",
+        provider: "turnstile"
+    }, {
+        selector: 'iframe[src*="challenges.cloudflare.com"]',
+        provider: "turnstile"
+    }, {
+        selector: "#FunCaptcha",
+        provider: "arkose"
+    }, {
+        selector: ".funcaptcha",
+        provider: "arkose"
+    }, {
+        selector: "[data-arkose-public-key]",
+        provider: "arkose"
+    }, {
+        selector: 'iframe[src*="arkoselabs"]',
+        provider: "arkose"
+    }, {
+        selector: "#captcha-container",
+        provider: "awswaf"
+    }, {
+        selector: "[data-awswaf-captcha]",
+        provider: "awswaf"
+    }, {
+        selector: 'iframe[title*="captcha" i]',
+        provider: "unknown"
+    } ];
+    function addEvidence(list, value) {
+        value && (list.length >= 5 || list.push(value));
+    }
+    function truncateText(text, maxLen) {
+        return text ? text.length <= maxLen ? text : text.slice(0, maxLen) : "";
+    }
+    function matchHints(value, hints) {
+        const lower = String(value || "").toLowerCase();
+        return !!lower && hints.some(hint => lower.includes(hint));
+    }
+    function detectCaptcha() {
+        const evidence = {
+            text_hits: [],
+            selector_hits: [],
+            iframe_src_hits: [],
+            url_hits: []
+        };
+        let hasIframeHit = !1, hasContainerHit = !1, hasScriptHit = !1, hasKeywordHit = !1, hasUrlHit = !1;
+        const providerSignals = {
+            recaptcha: 0,
+            hcaptcha: 0,
+            turnstile: 0,
+            arkose: 0,
+            awswaf: 0
+        };
+        try {
+            const iframes = document.querySelectorAll("iframe");
+            for (const iframe of iframes) {
+                const src = iframe.getAttribute("src") || "", title = iframe.getAttribute("title") || "";
+                if (src) for (const [provider, hints] of Object.entries(CAPTCHA_IFRAME_HINTS)) matchHints(src, hints) && (hasIframeHit = !0, 
+                providerSignals[provider] += 1, addEvidence(evidence.iframe_src_hits, truncateText(src, 120)));
+                if (title && matchHints(title, [ "captcha", "recaptcha" ]) && (hasContainerHit = !0, 
+                addEvidence(evidence.selector_hits, 'iframe[title*="captcha"]')), evidence.iframe_src_hits.length >= 5) break;
+            }
+        } catch (e) {}
+        try {
+            const scripts = document.querySelectorAll("script[src]");
+            for (const script of scripts) {
+                const src = script.getAttribute("src") || "";
+                if (src) {
+                    for (const [provider, hints] of Object.entries(CAPTCHA_SCRIPT_HINTS)) matchHints(src, hints) && (hasScriptHit = !0, 
+                    providerSignals[provider] += 1, addEvidence(evidence.selector_hits, `script[src*="${hints[0]}"]`));
+                    if (evidence.selector_hits.length >= 5) break;
+                }
+            }
+        } catch (e) {}
+        for (const {selector: selector, provider: provider} of CAPTCHA_CONTAINER_SELECTORS) try {
+            document.querySelector(selector) && (hasContainerHit = !0, addEvidence(evidence.selector_hits, selector), 
+            "unknown" !== provider && (providerSignals[provider] += 1));
+        } catch (e) {}
+        const textSnippet = function() {
+            try {
+                const candidates = document.querySelectorAll("h1, h2, h3, h4, p, label, button, form, div, span");
+                let combined = "", count = 0;
+                for (const node of candidates) {
+                    if (count >= 30 || combined.length >= 2e3) break;
+                    if (!node || "string" != typeof node.innerText) continue;
+                    if (!node.offsetWidth && !node.offsetHeight && !node.getClientRects().length) continue;
+                    const text = node.innerText.replace(/\s+/g, " ").trim();
+                    text && (combined += `${text} `, count += 1);
+                }
+                if (combined = combined.trim(), combined) return truncateText(combined, 2e3);
+            } catch (e) {}
+            try {
+                let bodyText = document.body?.innerText || "";
+                return !bodyText && document.body?.textContent && (bodyText = document.body.textContent), 
+                truncateText(bodyText.replace(/\s+/g, " ").trim(), 2e3);
+            } catch (e) {
+                return "";
+            }
+        }();
+        if (textSnippet) {
+            const lowerText = textSnippet.toLowerCase();
+            for (const keyword of CAPTCHA_TEXT_KEYWORDS) lowerText.includes(keyword) && (hasKeywordHit = !0, 
+            addEvidence(evidence.text_hits, keyword));
+        }
+        try {
+            const lowerUrl = (window.location?.href || "").toLowerCase();
+            for (const hint of CAPTCHA_URL_HINTS) lowerUrl.includes(hint) && (hasUrlHit = !0, 
+            addEvidence(evidence.url_hits, hint));
+        } catch (e) {}
+        let confidence = 0;
+        hasIframeHit && (confidence += .7), hasContainerHit && (confidence += .5), hasScriptHit && (confidence += .5), 
+        hasKeywordHit && (confidence += .3), hasUrlHit && (confidence += .2), confidence = Math.min(1, confidence), 
+        hasIframeHit && (confidence = Math.max(confidence, .8)), !hasKeywordHit || hasIframeHit || hasContainerHit || hasScriptHit || hasUrlHit || (confidence = Math.min(confidence, .4));
+        const detected = confidence >= .7;
+        let providerHint = null;
+        return providerSignals.recaptcha > 0 ? providerHint = "recaptcha" : providerSignals.hcaptcha > 0 ? providerHint = "hcaptcha" : providerSignals.turnstile > 0 ? providerHint = "turnstile" : providerSignals.arkose > 0 ? providerHint = "arkose" : providerSignals.awswaf > 0 ? providerHint = "awswaf" : detected && (providerHint = "unknown"), 
+        {
+            detected: detected,
+            provider_hint: providerHint,
+            confidence: confidence,
+            evidence: evidence
+        };
+    }
     const DEFAULT_INFERENCE_CONFIG = {
         allowedTags: [ "label", "span", "div" ],
         allowedRoles: [],
@@ -157,8 +316,28 @@
         }
         return null;
     }
+    function normalizeNearbyText(text) {
+        return text ? text.replace(/\s+/g, " ").trim() : "";
+    }
+    function isInteractableElement(el) {
+        if (!el || !el.tagName) return !1;
+        const tag = el.tagName.toLowerCase(), role = el.getAttribute ? el.getAttribute("role") : null, hasTabIndex = !!el.hasAttribute && el.hasAttribute("tabindex"), hasHref = "A" === el.tagName && !!el.hasAttribute && el.hasAttribute("href");
+        if ([ "button", "input", "textarea", "select", "option", "details", "summary", "a" ].includes(tag)) return !("a" === tag && !hasHref);
+        if (role && [ "button", "link", "tab", "menuitem", "checkbox", "radio", "switch", "slider", "combobox", "textbox", "searchbox", "spinbutton" ].includes(role.toLowerCase())) return !0;
+        if (hasTabIndex) return !0;
+        if (el.onclick || el.onkeydown || el.onkeypress || el.onkeyup) return !0;
+        if (el.getAttribute) {
+            if (el.getAttribute("onclick") || el.getAttribute("onkeydown") || el.getAttribute("onkeypress") || el.getAttribute("onkeyup")) return !0;
+        }
+        return !1;
+    }
     function getText(el) {
-        return el.getAttribute("aria-label") ? el.getAttribute("aria-label") : "INPUT" === el.tagName ? el.value || el.placeholder || "" : "IMG" === el.tagName ? el.alt || "" : (el.innerText || "").replace(/\s+/g, " ").trim().substring(0, 100);
+        if (el.getAttribute("aria-label")) return el.getAttribute("aria-label");
+        if ("INPUT" === el.tagName) {
+            const t = el.getAttribute && el.getAttribute("type") || el.type || "";
+            return "password" === String(t).toLowerCase() ? el.placeholder || "" : el.value || el.placeholder || "";
+        }
+        return "IMG" === el.tagName ? el.alt || "" : (el.innerText || "").replace(/\s+/g, " ").trim().substring(0, 100);
     }
     function getClassName(el) {
         if (!el || !el.className) return "";
@@ -268,11 +447,17 @@
         try {
             !1 !== options.waitForStability && await async function(options = {}) {
                 const {minNodeCount: minNodeCount = 500, quietPeriod: quietPeriod = 200, maxWait: maxWait = 5e3} = options, startTime = Date.now();
+                try {
+                    window.__sentience_lastMutationTs = performance.now();
+                } catch (e) {}
                 return new Promise(resolve => {
                     if (document.querySelectorAll("*").length >= minNodeCount) {
                         let lastChange = Date.now();
                         const observer = new MutationObserver(() => {
                             lastChange = Date.now();
+                            try {
+                                window.__sentience_lastMutationTs = performance.now();
+                            } catch (e) {}
                         });
                         observer.observe(document.body, {
                             childList: !0,
@@ -288,11 +473,17 @@
                     } else {
                         const observer = new MutationObserver(() => {
                             const currentCount = document.querySelectorAll("*").length, totalWait = Date.now() - startTime;
+                            try {
+                                window.__sentience_lastMutationTs = performance.now();
+                            } catch (e) {}
                             if (currentCount >= minNodeCount) {
                                 observer.disconnect();
                                 let lastChange = Date.now();
                                 const quietObserver = new MutationObserver(() => {
                                     lastChange = Date.now();
+                                    try {
+                                        window.__sentience_lastMutationTs = performance.now();
+                                    } catch (e) {}
                                 });
                                 quietObserver.observe(document.body, {
                                     childList: !0,
@@ -323,8 +514,15 @@
                 if (!el.getBoundingClientRect) return;
                 const rect = el.getBoundingClientRect();
                 if (rect.width < 5 || rect.height < 5) return;
+                const tagName = el.tagName.toLowerCase();
+                if ("span" === tagName) {
+                    if (el.closest("a")) return;
+                    const childLink = el.querySelector("a[href]");
+                    if (childLink && childLink.href) return;
+                    options.debug && el.className && el.className.includes("titleline");
+                }
                 window.sentience_registry[idx] = el;
-                const semanticText = function(el, options = {}) {
+                const inputType = "input" === tagName ? toSafeString(el.getAttribute && el.getAttribute("type") || el.type || null) : null, isPasswordInput = inputType && "password" === inputType.toLowerCase(), semanticText = function(el, options = {}) {
                     if (!el) return {
                         text: "",
                         source: null
@@ -335,10 +533,10 @@
                         source: "explicit_aria_label"
                     };
                     if ("INPUT" === el.tagName) {
-                        const value = (el.value || el.placeholder || "").trim();
+                        const t = el.getAttribute && el.getAttribute("type") || el.type || "", isPassword = "password" === String(t).toLowerCase(), value = (isPassword ? el.placeholder || "" : el.value || el.placeholder || "").trim();
                         if (value) return {
                             text: value,
-                            source: "input_value"
+                            source: isPassword ? "input_placeholder" : "input_value"
                         };
                     }
                     if ("IMG" === el.tagName) {
@@ -367,11 +565,7 @@
                 }), textVal = semanticText.text || getText(el), inferredRole = function(el, options = {}) {
                     const {enableInference: enableInference = !0} = options;
                     if (!enableInference) return null;
-                    if (!function(el) {
-                        if (!el || !el.tagName) return !1;
-                        const tag = el.tagName.toLowerCase(), role = el.getAttribute ? el.getAttribute("role") : null, hasTabIndex = !!el.hasAttribute && el.hasAttribute("tabindex"), hasHref = "A" === el.tagName && !!el.hasAttribute && el.hasAttribute("href");
-                        return [ "button", "input", "textarea", "select", "option", "details", "summary", "a" ].includes(tag) ? !("a" === tag && !hasHref) : !(!role || ![ "button", "link", "tab", "menuitem", "checkbox", "radio", "switch", "slider", "combobox", "textbox", "searchbox", "spinbutton" ].includes(role.toLowerCase())) || (!!hasTabIndex || (!!(el.onclick || el.onkeydown || el.onkeypress || el.onkeyup) || !(!el.getAttribute || !(el.getAttribute("onclick") || el.getAttribute("onkeydown") || el.getAttribute("onkeypress") || el.getAttribute("onkeyup")))));
-                    }(el)) return null;
+                    if (!isInteractableElement(el)) return null;
                     const hasAriaLabel = el.getAttribute ? el.getAttribute("aria-label") : null, hasExplicitRole = el.getAttribute ? el.getAttribute("role") : null;
                     if (hasAriaLabel || hasExplicitRole) return null;
                     const tag = el.tagName.toLowerCase();
@@ -411,9 +605,79 @@
                     }
                     return null;
                 }(el);
+                let safeValue = null, valueRedacted = null;
+                try {
+                    if (void 0 !== el.value || el.getAttribute && null !== el.getAttribute("value")) if (isPasswordInput) safeValue = null, 
+                    valueRedacted = "true"; else {
+                        const rawValue = void 0 !== el.value ? String(el.value) : String(el.getAttribute("value"));
+                        safeValue = rawValue.length > 200 ? rawValue.substring(0, 200) : rawValue, valueRedacted = "false";
+                    }
+                } catch (e) {}
+                const accessibleName = toSafeString(function(el) {
+                    if (!el || !el.getAttribute) return "";
+                    const ariaLabel = el.getAttribute("aria-label");
+                    if (ariaLabel && ariaLabel.trim()) return ariaLabel.trim().substring(0, 200);
+                    const labelledBy = el.getAttribute("aria-labelledby");
+                    if (labelledBy && labelledBy.trim()) {
+                        const ids = labelledBy.split(/\s+/).filter(id => id.trim()), texts = [];
+                        for (const id of ids) try {
+                            const ref = document.getElementById(id);
+                            if (!ref) continue;
+                            const txt = (ref.innerText || ref.textContent || ref.getAttribute?.("aria-label") || "").toString().trim();
+                            txt && texts.push(txt);
+                        } catch (e) {}
+                        if (texts.length > 0) return texts.join(" ").substring(0, 200);
+                    }
+                    try {
+                        if (el.labels && el.labels.length > 0) {
+                            const t = (el.labels[0].innerText || el.labels[0].textContent || "").toString().trim();
+                            if (t) return t.substring(0, 200);
+                        }
+                    } catch (e) {}
+                    try {
+                        const parentLabel = el.closest && el.closest("label");
+                        if (parentLabel) {
+                            const t = (parentLabel.innerText || parentLabel.textContent || "").toString().trim();
+                            if (t) return t.substring(0, 200);
+                        }
+                    } catch (e) {}
+                    const tag = (el.tagName || "").toUpperCase();
+                    if ("INPUT" === tag || "TEXTAREA" === tag) {
+                        const ph = (el.getAttribute("placeholder") || "").toString().trim();
+                        if (ph) return ph.substring(0, 200);
+                    }
+                    const title = el.getAttribute("title");
+                    return title && title.trim() ? title.trim().substring(0, 200) : "";
+                }(el) || null), nearbyText = isInteractableElement(el) ? function(el, options = {}) {
+                    if (!el) return null;
+                    const maxLen = "number" == typeof options.maxLen ? options.maxLen : 80, ownText = normalizeNearbyText(el.innerText || ""), candidates = [], collect = node => {
+                        if (!node) return;
+                        let text = "";
+                        try {
+                            text = normalizeNearbyText(node.innerText || node.textContent || "");
+                        } catch (e) {
+                            text = "";
+                        }
+                        text && text !== ownText && candidates.push(text);
+                    };
+                    if (collect(el.previousElementSibling), collect(el.nextElementSibling), 0 === candidates.length && el.parentElement) {
+                        let parentText = "";
+                        try {
+                            parentText = normalizeNearbyText(el.parentElement.innerText || "");
+                        } catch (e) {
+                            parentText = "";
+                        }
+                        parentText && parentText !== ownText && parentText.length <= 120 && candidates.push(parentText);
+                    }
+                    if (0 === candidates.length) return null;
+                    let text = candidates[0];
+                    return text.length > maxLen && (text = text.slice(0, maxLen).trim()), text || null;
+                }(el, {
+                    maxLen: 80
+                }) : null;
                 rawData.push({
                     id: idx,
-                    tag: el.tagName.toLowerCase(),
+                    tag: tagName,
                     rect: {
                         x: rect.x,
                         y: rect.y,
@@ -435,18 +699,27 @@
                     attributes: {
                         role: toSafeString(el.getAttribute("role")),
                         type_: toSafeString(el.getAttribute("type")),
+                        input_type: inputType,
                         aria_label: "explicit_aria_label" === semanticText?.source ? semanticText.text : toSafeString(el.getAttribute("aria-label")),
+                        name: accessibleName,
                         inferred_label: semanticText?.source && ![ "explicit_aria_label", "input_value", "img_alt", "inner_text" ].includes(semanticText.source) ? toSafeString(semanticText.text) : null,
                         label_source: semanticText?.source || null,
                         inferred_role: inferredRole ? toSafeString(inferredRole) : null,
-                        href: toSafeString(el.href || el.getAttribute("href") || null),
+                        nearby_text: toSafeString(nearbyText),
+                        href: toSafeString(el.href || el.getAttribute("href") || el.closest && el.closest("a")?.href || null),
                         class: toSafeString(getClassName(el)),
-                        value: void 0 !== el.value ? toSafeString(el.value) : toSafeString(el.getAttribute("value")),
-                        checked: void 0 !== el.checked ? String(el.checked) : null
+                        value: null !== safeValue ? toSafeString(safeValue) : null,
+                        value_redacted: valueRedacted,
+                        checked: void 0 !== el.checked ? String(el.checked) : null,
+                        disabled: void 0 !== el.disabled ? String(el.disabled) : null,
+                        aria_checked: toSafeString(el.getAttribute("aria-checked")),
+                        aria_disabled: toSafeString(el.getAttribute("aria-disabled")),
+                        aria_expanded: toSafeString(el.getAttribute("aria-expanded"))
                     },
                     text: toSafeString(textVal),
                     in_viewport: inView,
-                    is_occluded: occluded
+                    is_occluded: occluded,
+                    scroll_y: window.scrollY
                 });
             });
             const allRawElements = [ ...rawData ];
@@ -569,6 +842,18 @@
             }(options.screenshot));
             const cleanedElements = cleanElement(processed.elements), cleanedRawElements = cleanElement(processed.raw_elements);
             cleanedElements.length, cleanedRawElements.length;
+            let diagnostics;
+            try {
+                const lastMutationTs = window.__sentience_lastMutationTs, now = performance.now(), quietMs = "number" == typeof lastMutationTs && Number.isFinite(lastMutationTs) ? Math.max(0, now - lastMutationTs) : null, nodeCount = document.querySelectorAll("*").length;
+                diagnostics = {
+                    metrics: {
+                        ready_state: document.readyState || null,
+                        quiet_ms: quietMs,
+                        node_count: nodeCount
+                    },
+                    captcha: detectCaptcha()
+                };
+            } catch (e) {}
             return {
                 status: "success",
                 url: window.location.href,
@@ -578,7 +863,8 @@
                 },
                 elements: cleanedElements,
                 raw_elements: cleanedRawElements,
-                screenshot: screenshot
+                screenshot: screenshot,
+                diagnostics: diagnostics
             };
         } catch (error) {
             return {
@@ -848,6 +1134,14 @@
             timestamp: Date.now()
         }, "*");
     }
+    function showGrid(grids, targetGridId = null) {
+        grids && Array.isArray(grids) && window.postMessage({
+            type: "SENTIENCE_SHOW_GRID_OVERLAY",
+            grids: grids,
+            targetGridId: targetGridId,
+            timestamp: Date.now()
+        }, "*");
+    }
     function clearOverlay() {
         window.postMessage({
             type: "SENTIENCE_CLEAR_OVERLAY"
@@ -868,6 +1162,7 @@
             click: click,
             startRecording: startRecording,
             showOverlay: showOverlay,
+            showGrid: showGrid,
             clearOverlay: clearOverlay
         }, window.sentience_iframe_handler_setup || (window.addEventListener("message", async event => {
             if ("SENTIENCE_IFRAME_SNAPSHOT_REQUEST" === event.data?.type) {

sentience/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Sentience Semantic Visual Grounding Extractor",
-  "version": "2.2.0",
+  "version": "2.7.0",
   "description": "Extract semantic visual grounding data from web pages",
   "permissions": ["activeTab", "scripting"],
   "host_permissions": ["<all_urls>"],

sentience/extension/pkg/sentience_core.d.ts

@@ -18,34 +18,34 @@ export function prune_for_api(val: any): any;
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
-  readonly memory: WebAssembly.Memory;
-  readonly analyze_page: (a: number) => number;
-  readonly analyze_page_with_options: (a: number, b: number) => number;
-  readonly decide_and_act: (a: number) => void;
-  readonly prune_for_api: (a: number) => number;
-  readonly __wbindgen_export: (a: number, b: number) => number;
-  readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
-  readonly __wbindgen_export3: (a: number) => void;
+    readonly memory: WebAssembly.Memory;
+    readonly analyze_page: (a: number) => number;
+    readonly analyze_page_with_options: (a: number, b: number) => number;
+    readonly decide_and_act: (a: number) => void;
+    readonly prune_for_api: (a: number) => number;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
 }
 
 export type SyncInitInput = BufferSource | WebAssembly.Module;
 
 /**
-* Instantiates the given `module`, which can either be bytes or
-* a precompiled `WebAssembly.Module`.
-*
-* @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
-*
-* @returns {InitOutput}
-*/
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
 export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
 
 /**
-* If `module_or_path` is {RequestInfo} or {URL}, makes a request and
-* for everything else, calls `WebAssembly.instantiate` directly.
-*
-* @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
-*
-* @returns {Promise<InitOutput>}
-*/
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
 export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;