@yuktishaalaa/yuktai 5.3.10 → 5.3.12

package/README.md

@@ -24,8 +24,8 @@ Built in free time by [Sandeep Miriyala](https://github.com/sandeepmiriyala03).
 | 📊 | **YuktaiGrid** | Search, sort, pages, CSV export, 5 WCAG themes, Telugu UI, keyboard navigation |
 | 🤖 | **Ask your data** | "salary over 1 lakh in Hyderabad", BI answers, unusual rows, multi-step tasks, WebMCP |
 | 💬 | **Ask page (RAG)** | Answers from your page and data, offline |
-| 🛠 | **Page tools** | QA audit (15 WCAG checks), form and design review, voice commands |
-| 🦀 | **Rust engine** | Up to 42× faster search on big data (optional) |
+| 🛠 | **Page tools** | QA audit (15 WCAG checks), form and design review, voice commands. In React/Next.js: `showPageTools` |
+| 🦀 | **Rust engine** | Up to 42× faster search on big data. The default since 5.3.11 |
 | 🎨 | **163 icons** | Any size and colour, outline or filled, safe in Server Components |
 | ⚡ | **Vibe Coder** | Plain English → a full Next.js project ZIP (developer tool) |
 | 📱 | **PWA** | Installable, works offline |
@@ -33,7 +33,7 @@ Built in free time by [Sandeep Miriyala](https://github.com/sandeepmiriyala03).
 ## Supported languages
 
 **Use it with:** HTML · JavaScript · TypeScript · React (JSX) · Next.js (TSX)
-**Built with:** TypeScript + Rust (WebAssembly, embedded; no setup needed)
+**Built with:** TypeScript 7 + Rust (WebAssembly, embedded; no setup needed)
 **Interface:** English and Telugu. All 22 Indian languages for number and date formats, sorting and voice input.
 
 ---
@@ -43,7 +43,7 @@ Built in free time by [Sandeep Miriyala](https://github.com/sandeepmiriyala03).
 **Plain HTML:** one line, no build step
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/@yuktishaalaa/yuktai@5.3.9/vanilla/index.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@yuktishaalaa/yuktai@5.3.12/vanilla/index.min.js"></script>
 <script>
   yuktai.renderGrid("#staff", { data: rows, columns, engine: "auto", showSearchTime: true })
 </script>
@@ -63,7 +63,7 @@ import type { ReactNode } from "react"
 
 export default function YuktaiClient({ children }: { children: ReactNode }) {
   return (
-    <YuktAIWrapper position="left" launcher showAccessibility showRag engine="rust">
+    <YuktAIWrapper position="left" launcher showAccessibility showRag showPageTools engine="rust">
       {children}
     </YuktAIWrapper>
   )
@@ -100,9 +100,9 @@ More examples for every feature: **https://yuktaidocs.netlify.app/**
 
 ---
 
-## Rust engine (optional)
+## Rust engine (default)
 
-Set `engine="rust"` or `"auto"`. Results are identical to TypeScript, proven by tests, only faster. If WebAssembly is unavailable, it falls back to TypeScript.
+Since 5.3.11 the grid and page search use Rust by default. Results are identical to TypeScript, proven by tests, only faster. If WebAssembly is unavailable or blocked by a Content Security Policy, they fall back to TypeScript. Set `engine="ts"` to keep TypeScript only, or `"auto"` for Rust from 10,000 rows. The 💬 button uses Rust page search when you set `engine`.
 
 | Task | TypeScript | Rust | Speed-up |
 |---|---|---|---|

package/dist/agent-SZENB4QE.mjs

@@ -0,0 +1,18 @@
+import{a as T}from"./chunk-N2HHE7YH.mjs";function f(n){try{let a=window.getComputedStyle(n);if(a.display==="none"||a.visibility==="hidden"||a.opacity==="0"||n.hidden)return!1;let t=n.getBoundingClientRect();return!(t.width===0&&t.height===0)}catch{return!0}}function E(){let n=[],a=new Set,t=e=>{let r=e.trim();r&&r.length>10&&!a.has(r)&&(a.add(r),n.push(r))};document.title&&t(document.title);let o=['meta[name="description"]','meta[name="keywords"]','meta[property="og:title"]','meta[property="og:description"]','meta[name="twitter:title"]','meta[name="twitter:description"]'];for(let e of o){let r=document.querySelector(e)?.getAttribute("content");r&&t(r)}let l=["h1","h2","h3","h4","h5","h6","p","blockquote","q","pre","code","li","dt","dd","th","td","caption","a","b","strong","em","i","u","s","abbr","acronym","cite","dfn","mark","small","sub","sup","ins","del","bdi","bdo","article","section","aside","nav","header","footer","main","summary","details","figcaption","figure","address","time","output","label","legend","option","button","font","center","span","div","[role='heading']","[role='main']","[role='article']","[role='region']","[role='complementary']","[role='contentinfo']","[role='navigation']","[role='banner']","[role='listitem']","[role='cell']","[role='columnheader']","[role='rowheader']"],c=document.querySelectorAll(l.join(","));for(let e of c){if(e.closest("[data-yuktai-panel]")||!f(e)||e.querySelector("p, h1, h2, h3, h4, h5, h6, li, td, th, div, article, section, blockquote, pre"))continue;let i=e.innerText?.trim();if(i&&i.length>10&&t(i),!i){let d=e.textContent?.trim();d&&d.length>10&&t(d)}let s=e.getAttribute("aria-label")?.trim();s&&s.length>5&&t(s);let u=e.getAttribute("aria-description")?.trim();u&&u.length>5&&t(u);let m=e.getAttribute("aria-valuetext")?.trim();m&&t(m);let p=e.getAttribute("title")?.trim();p&&p.length>5&&t(p);let b=e.getAttribute("data-label")?.trim();b&&t(b);let y=e.getAttribute("data-title")?.trim();y&&t(y),e.querySelectorAll("img").forEach(d=>{let g=d.getAttribute("alt")?.trim();g&&g.length>5&&t(g);let h=d.getAttribute("title")?.trim();h&&h.length>5&&t(h)})}document.querySelectorAll("img").forEach(e=>{if(e.closest("[data-yuktai-panel]")||!f(e))return;let r=e.getAttribute("alt")?.trim(),i=e.getAttribute("title")?.trim();r&&r.length>5&&t(r),i&&i.length>5&&t(i)}),document.querySelectorAll("input:not([type=hidden]), textarea").forEach(e=>{if(e.closest("[data-yuktai-panel]")||!f(e))return;e.placeholder&&t(e.placeholder),e.value&&e.value.length>3&&t(e.value);let r=e.getAttribute("aria-label")?.trim();r&&t(r)}),document.querySelectorAll("select").forEach(e=>{e.closest("[data-yuktai-panel]")||f(e)&&Array.from(e.options).forEach(r=>{r.text?.trim().length>3&&t(r.text.trim())})}),document.querySelectorAll("td, th").forEach(e=>{if(e.closest("[data-yuktai-panel]")||!f(e))return;let r=e.innerText?.trim();r&&r.length>3&&t(r)});try{document.querySelectorAll("iframe").forEach(e=>{try{let r=e.contentDocument;if(!r)return;let i=r.body?.innerText?.trim();i&&i.length>20&&t(i.slice(0,500))}catch{}})}catch{}return document.querySelectorAll("a").forEach(e=>{if(e.closest("[data-yuktai-panel]")||!f(e))return;let r=e.innerText?.trim();r&&r.length>3&&r.length<100&&t(r)}),n.join(" ").slice(0,5e3)}function x(n){let a=n.getAttribute("aria-label")?.trim();if(a)return a;let t=n.getAttribute("aria-labelledby");if(t){let i=document.getElementById(t);if(i)return i.innerText?.trim()||""}if(n.id){let i=document.querySelector(`label[for="${n.id}"]`);if(i)return i.innerText?.trim()||""}let o=n.closest("label");if(o){let i=o.cloneNode(!0);return i.querySelectorAll("input, select, textarea").forEach(s=>s.remove()),i.innerText?.trim()||""}if((n instanceof HTMLInputElement||n instanceof HTMLTextAreaElement)&&n.placeholder)return n.placeholder;if(n.name)return n.name.replace(/[_-]/g," ");let l=n.previousSibling;if(l?.nodeType===Node.TEXT_NODE){let i=l.textContent?.trim();if(i&&i.length>1)return i}let c=n.previousElementSibling;if(c){let i=c.innerText?.trim();if(i&&i.length>1&&i.length<60)return i}let e=n.closest("td, th");if(e){let i=e.previousElementSibling;if(i){let s=i.innerText?.trim();if(s&&s.length>1)return s}}let r=n.getAttribute("title")?.trim();return r||(n instanceof HTMLInputElement?n.type:"field")}function L(){let n=[],a=document.querySelectorAll(["input:not([type=hidden])","input:not([type=submit])","input:not([type=button])","input:not([type=reset])","input:not([type=image])","select","textarea","[contenteditable='true']","[role='textbox']","[role='combobox']","[role='spinbutton']","[role='searchbox']","[role='listbox']"].join(", "));for(let t of a){if(t.closest("[data-yuktai-panel]")||!f(t))continue;if(t instanceof HTMLInputElement){let l=t.type.toLowerCase();if(["submit","button","reset","image"].includes(l))continue}let o=x(t);n.push({label:o,type:t instanceof HTMLInputElement?t.type:t.tagName.toLowerCase(),placeholder:(t instanceof HTMLInputElement||t instanceof HTMLTextAreaElement)&&t.placeholder||"",required:t.required||t.getAttribute("aria-required")==="true"||t.getAttribute("data-required")==="true",element:t})}return n}function A(n,a=3e3){n.scrollIntoView({behavior:"smooth",block:"center"}),n.style.outline="3px solid #0d9488",n.style.outlineOffset="3px";try{n.focus()}catch{}setTimeout(()=>{n.style.outline="",n.style.outlineOffset=""},a)}function M(n){let a=n.toLowerCase(),t=document.querySelectorAll("h1, h2, h3, h4, h5, h6, section, article, [id], [aria-label], [role='heading'], [role='region']");for(let o of t){if(o.closest("[data-yuktai-panel]")||!f(o))continue;if((o.innerText||o.getAttribute("id")||o.getAttribute("aria-label")||o.getAttribute("name")||"").toLowerCase().includes(a))return o.scrollIntoView({behavior:"smooth",block:"center"}),o.style.outline="2px solid #0d9488",o.style.outlineOffset="4px",setTimeout(()=>{o.style.outline="",o.style.outlineOffset=""},2500),!0}return!1}async function H(n,a,t){let o=window,l=o.LanguageModel||o.ai?.languageModel;if(!l)throw new Error("Gemini Nano not available");let c=await l.create({...T,systemPrompt:`You are a helpful web accessibility agent.
+Create a simple action plan to help a user complete a task on a webpage.
+Rules:
+- Maximum 5 steps
+- Short and clear \u2014 no jargon
+- If filling a form \u2014 list each field and what to enter
+- No markdown \u2014 no asterisks, no bold, no headers
+- Number each step: 1. 2. 3.`}),r=`Page content: ${n}${t?`
+The page has form fields the user may need to fill.`:""}
+
+User task: ${a}
+
+Action plan:`,i=await c.prompt(r);return c.destroy(),i?.trim()||""}async function w(n,a){let{askPageWithTransformers:t}=await import("./transformers-rag-MQZRMFTG.mjs");return(await t(`How do I: ${a}`)).answer||"I could not create a plan for this task."}async function q(n,a,t){if(!n.trim())return{success:!1,steps:[],error:"Please tell me what you want to do."};if(!a)return{success:!1,steps:[],error:"No AI engine available on this device."};let o=[],l=(c,e="info")=>{let r={text:c,type:e};o.push(r),t(r)};try{l("\u{1F4D6} Reading page content...","info");let c=E(),e=L(),r=e.length>0;c.length<50&&l("\u26A0\uFE0F Page content is very limited. This may be a static image page.","error"),l(r?`\u{1F4CB} Found ${e.length} form field${e.length!==1?"s":""} on this page`:"\u{1F4C4} No form fields found \u2014 this appears to be a content page","info"),l("\u{1F916} Creating action plan...","info");let i="";try{a==="gemini"?i=await H(c,n,r):i=await w(c,n)}catch{i=r?`1. Locate the form on this page
+2. Fill each required field
+3. Review your answers
+4. Submit the form`:`1. Read the page carefully
+2. Find the section relevant to your task
+3. Follow the on-page instructions`}if(i&&(l("\u2705 Your action plan:","success"),i.split(/\n/).map(s=>s.replace(/\*\*/g,"").replace(/\*/g,"").trim()).filter(s=>s.length>5).slice(0,6).forEach(s=>l(`   ${s}`,"action"))),r){let s=e[0];l(`\u{1F3AF} First field: "${s.label}"${s.required?" \u2605 required":""}`,"field"),A(s.element),e.length>1&&l(`\u{1F4DD} All ${e.length} fields: ${e.map(u=>u.label).join(" \u2192 ")}`,"info")}else{let s=n.toLowerCase().split(/\s+/).filter(m=>m.length>3),u=!1;for(let m of s)if(M(m)){l(`\u{1F3AF} Scrolled to relevant section: "${m}"`,"action"),u=!0;break}u||l("\u{1F4A1} Scroll through the page to find what you need.","info")}return l("\u2705 Ready. Follow the steps above. Ask me again if you need more help.","success"),{success:!0,steps:o}}catch(c){let e=c instanceof Error?c.message:"Agent error.";return l(`\u26A0\uFE0F ${e}`,"error"),{success:!1,steps:o,error:e}}}export{E as getPageText,A as highlightField,q as runAgent,L as scanFormFields,M as scrollToSection};

package/dist/agentic/a11yCopilot.d.ts

@@ -0,0 +1,32 @@
+import { type AuditOptions, type AuditReport } from "./qaAudit";
+export interface CopilotFixResult {
+    issueId: string;
+    applied: boolean;
+    message: string;
+}
+export interface CopilotState {
+    report: AuditReport | null;
+    watching: boolean;
+    appliedFixes: number;
+}
+export interface A11yCopilotOptions extends AuditOptions {
+    /** Called after every scan (initial, manual or caused by DOM changes). */
+    onUpdate?: (state: CopilotState) => void;
+    /** Wait this long after DOM changes before rescanning (default 600ms). */
+    debounceMs?: number;
+    /** Apply every safe fix automatically after each scan (default false). */
+    autoApply?: boolean;
+    /** Language used when the page has no lang attribute (default: browser language). */
+    defaultLang?: string;
+}
+export interface A11yCopilot {
+    start(): void;
+    stop(): void;
+    scan(): AuditReport;
+    explain(issueId: string): string;
+    applyFix(issueId: string): CopilotFixResult;
+    applyAllFixes(): CopilotFixResult[];
+    undoAll(): number;
+    getState(): CopilotState;
+}
+export declare function createA11yCopilot(options?: A11yCopilotOptions): A11yCopilot;

package/dist/agentic/contextIndex.d.ts

@@ -0,0 +1,58 @@
+import type { GridToolColumn } from "../grid/gridTools";
+import { type AuditRoot } from "./dom";
+import type { GridEngine } from "../grid/rust/engine";
+export interface ContextPassage {
+    id: string;
+    source: "page" | "grid" | "custom";
+    text: string;
+    /** Grid row id or page section heading. */
+    ref?: string;
+}
+export interface ContextHit extends ContextPassage {
+    score: number;
+}
+export interface ContextAnswer {
+    answer: string;
+    hits: ContextHit[];
+    /** True when `generate` produced the answer; false for extractive answers. */
+    generated: boolean;
+}
+/** Unicode-aware tokens: keeps Telugu/Devanagari combining marks together. */
+export declare function tokenize(text: string): string[];
+export declare function pagePassages(root?: AuditRoot, maxChars?: number): ContextPassage[];
+export declare function gridPassages<T>(data: T[], columns: GridToolColumn[], rowKey?: string): ContextPassage[];
+export interface ContextIndexOptions<T = Record<string, unknown>> {
+    /** Index the visible page text (default true). */
+    includePage?: boolean;
+    root?: AuditRoot;
+    rows?: T[];
+    columns?: GridToolColumn[];
+    rowKey?: string;
+    /** Extra documents, e.g. FAQ text or help articles. */
+    documents?: Array<{
+        id: string;
+        text: string;
+    }>;
+    /**
+     * Search engine: "rust" (default since v5.3.11), "auto" (Rust from 1,000
+     * passages) or "ts". Same passages, same scores, same order; Rust is faster
+     * on long pages and big grids. Works offline (the engine is embedded) and
+     * falls back to TypeScript when WebAssembly is missing or blocked.
+     */
+    engine?: GridEngine;
+}
+export declare function createContextIndex<T>(input?: ContextIndexOptions<T>): {
+    search: (question: string, k?: number) => ContextHit[];
+    ask: (question: string, opts?: {
+        k?: number;
+        generate?: (question: string, context: string) => Promise<string>;
+    }) => Promise<ContextAnswer>;
+    /** Call after the page or data changes. */
+    rebuild: () => void;
+    update(next: Partial<ContextIndexOptions<T>>): void;
+    size: () => number;
+    /** "rust" when the Rust engine answers searches for this index, else "ts". */
+    readonly engine: "rust" | "ts";
+    /** Resolves "rust" or "ts" once the engine is loaded (or not wanted). */
+    whenEngineReady: () => Promise<"rust" | "ts">;
+};

package/dist/agentic/designReview.d.ts

@@ -0,0 +1,26 @@
+import { type AuditRoot } from "./dom";
+export type DesignCategory = "hierarchy" | "readability" | "interaction" | "clutter" | "consistency";
+export interface DesignFinding {
+    category: DesignCategory;
+    severity: "high" | "medium" | "low";
+    message: string;
+    suggestion: string;
+    selector?: string;
+}
+export interface DesignReview {
+    score: number;
+    categories: Record<DesignCategory, {
+        score: number;
+        findings: number;
+    }>;
+    findings: DesignFinding[];
+    summary: string;
+}
+export interface DesignReviewOptions {
+    root?: AuditRoot;
+    /** Minimum body text size in px (default 14; 16 recommended for seniors). */
+    minFontSize?: number;
+    /** Maximum comfortable line length in characters (default 90). */
+    maxLineLength?: number;
+}
+export declare function reviewDesign(options?: DesignReviewOptions): DesignReview;

package/dist/agentic/dom.d.ts

@@ -0,0 +1,42 @@
+/** Elements inside yuktai's own panels are never audited or read. */
+/** YuktAI's own UI: panels, floating buttons (React data-yuktai-ui, vanilla data-yuktai-fabs). Audits skip it. */
+export declare const YUKTAI_IGNORE = "[data-yuktai-panel],[data-yuktai-ui],[data-yuktai-fabs]";
+export type AuditRoot = Document | Element;
+export declare function isBrowser(): boolean;
+/** Works across frames/realms, unlike `instanceof Document`. */
+export declare function isDocument(node: unknown): node is Document;
+export declare function resolveRoot(root?: AuditRoot | null): AuditRoot | null;
+/** querySelectorAll that skips yuktai's own UI and hidden elements. */
+export declare function queryAll<T extends Element = Element>(root: AuditRoot, selector: string, options?: {
+    includeHidden?: boolean;
+}): T[];
+export declare function isVisible(el: Element): boolean;
+/** Collapse whitespace and trim. */
+export declare function cleanText(text: string | null | undefined): string;
+export declare function shorten(text: string, max?: number): string;
+/** A short, readable CSS path such as `main > form:nth-of-type(2) > input`. */
+export declare function selectorFor(el: Element): string;
+/** The label a screen reader would most likely announce for this element. */
+export declare function accessibleName(el: Element): string;
+export type RGBA = {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+};
+export declare function parseColor(value: string | null | undefined): RGBA | null;
+/** Paint `top` over `bottom` (simple alpha compositing). */
+export declare function blend(top: RGBA, bottom: RGBA): RGBA;
+export declare function relativeLuminance(c: RGBA): number;
+export declare function contrastRatio(fg: RGBA, bg: RGBA): number;
+/**
+ * Background actually behind an element: walks up the tree and composites
+ * semi-transparent layers over white. Returns null when a background image
+ * makes the answer unknowable.
+ */
+export declare function effectiveBackground(el: Element): RGBA | null;
+export declare function isLargeText(el: Element): boolean;
+/** True when the element has its own visible text (not only inside children). */
+export declare function hasDirectText(el: Element): boolean;
+export declare const FOCUSABLE = "a[href],button,input:not([type='hidden']),select,textarea,summary,[tabindex]:not([tabindex='-1']),[contenteditable='true']";
+export declare const INTERACTIVE = "a[href],button,input:not([type='hidden']),select,textarea,summary,[role='button'],[role='link'],[role='checkbox'],[role='tab'],[role='menuitem']";

package/dist/agentic/formReview.d.ts

@@ -0,0 +1,38 @@
+import { type AuditRoot } from "./dom";
+export type FormFindingLevel = "problem" | "improvement";
+export interface FormField {
+    label: string;
+    type: string;
+    name: string;
+    required: boolean;
+    hasVisibleLabel: boolean;
+    selector: string;
+    element: Element;
+}
+export interface FormFinding {
+    level: FormFindingLevel;
+    message: string;
+    suggestion: string;
+    field?: string;
+    selector?: string;
+}
+export interface FormReview {
+    name: string;
+    selector: string;
+    fields: FormField[];
+    findings: FormFinding[];
+    /** 0–100, higher is easier to complete. */
+    score: number;
+    summary: string;
+}
+export interface FormReviewOptions {
+    root?: AuditRoot;
+    /** Extra checks for older users: font size, field count, vague buttons (default true). */
+    seniorFriendly?: boolean;
+    /** Forms with more fields than this get a "split into steps" suggestion (default 8). */
+    maxFieldsPerStep?: number;
+}
+export declare function readFormFields(form: Element): FormField[];
+export declare function reviewForm(form: Element, options?: FormReviewOptions): FormReview;
+/** Reviews every <form> (and every role="form") on the page. */
+export declare function reviewForms(options?: FormReviewOptions): FormReview[];

package/dist/agentic/gridQuery.d.ts

@@ -0,0 +1,64 @@
+import { type GridToolColumn, type GridToolContext, type GridToolFilter, type GridToolSort } from "../grid/gridTools";
+export interface ParsedGridQuery {
+    filters: GridToolFilter[];
+    /** Free-text terms that didn't map to a column; matched across all columns. */
+    search: string[];
+    sort: GridToolSort | null;
+    limit: number | null;
+    /** Assumptions the parser made (shown to the user so they can correct it). */
+    notes: string[];
+    /** Plain-English reading of the query. */
+    explanation: string;
+}
+export interface GridQueryResult<T> {
+    rows: T[];
+    ids: string[];
+    parsed: ParsedGridQuery;
+    message: string;
+}
+type Row = Record<string, unknown>;
+/** "₹10,000" → 10000, "1.5 lakh" → 150000, "2cr" → 20000000, "10k" → 10000. */
+export declare function parseAmount(text: string): number | null;
+/** The column mentioned in `text` (longest name wins), or undefined. */
+export declare function findMentionedColumn(text: string, columns: GridToolColumn[], kind?: GridToolColumn["type"]): GridToolColumn | undefined;
+export interface ParseOptions<T = Row> {
+    /** Rows let the parser recognise values like "overdue" in a Status column. */
+    data?: T[];
+}
+export declare function parseGridQuery<T = Row>(query: string, columns: GridToolColumn[], options?: ParseOptions<T>): ParsedGridQuery;
+/** Runs a parsed query over rows without touching any UI. */
+export declare function executeGridQuery<T>(data: T[], columns: GridToolColumn[], parsed: ParsedGridQuery): T[];
+/**
+ * Parses and runs a natural-language query, then pushes the result into the
+ * grid through the context callbacks (filters, sort, highlight).
+ */
+export declare function runGridQuery<T>(query: string, context: GridToolContext<T>, options?: {
+    apply?: boolean;
+}): GridQueryResult<T>;
+export interface GridAnomaly {
+    rowId: string;
+    column: string;
+    label: string;
+    value: unknown;
+    kind: "high" | "low" | "duplicate";
+    reason: string;
+}
+/**
+ * Finds unusual rows: numeric values far outside the typical range
+ * (interquartile-range rule) and rows that duplicate another row.
+ */
+export declare function detectAnomalies<T>(data: T[], columns: GridToolColumn[], options?: {
+    rowKey?: string;
+    factor?: number;
+    columns?: string[];
+}): GridAnomaly[];
+export declare function summarizeRows<T>(rows: T[], columns: GridToolColumn[]): string;
+export interface GridAnswer<T> {
+    kind: "query" | "anomalies" | "summary";
+    message: string;
+    ids: string[];
+    rows: T[];
+    anomalies?: GridAnomaly[];
+}
+export declare function answerGridQuestion<T>(question: string, context: GridToolContext<T>): GridAnswer<T>;
+export {};

package/dist/agentic/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./a11yCopilot";
+export * from "./pageInsights";
+export * from "./gridQuery";
+export * from "./voiceA11yCommands";
+export * from "./qaAudit";
+export * from "./formReview";
+export * from "./contextIndex";
+export * from "./taskRunner";
+export * from "./insights";
+export * from "./designReview";
+export * from "./react";
+export { contrastRatio, parseColor, relativeLuminance, accessibleName } from "./dom";
+export type { RGBA, AuditRoot } from "./dom";

package/dist/agentic/insights.d.ts

@@ -0,0 +1,62 @@
+import type { GridToolColumn } from "../grid/gridTools";
+export type Aggregation = "sum" | "avg" | "count" | "min" | "max";
+export type Period = "day" | "week" | "month" | "quarter" | "year";
+export interface GroupResult {
+    group: string;
+    value: number;
+    count: number;
+}
+export interface PeriodChange {
+    group: string;
+    current: number;
+    previous: number;
+    change: number;
+    /** null when the previous value was 0 */
+    changePct: number | null;
+}
+export interface PeriodComparison {
+    period: Period;
+    current: {
+        from: Date;
+        to: Date;
+    };
+    previous: {
+        from: Date;
+        to: Date;
+    };
+    rows: PeriodChange[];
+}
+export declare function aggregate(values: number[], agg: Aggregation): number;
+/** Groups rows by a column and aggregates a metric (or counts rows). Sorted high → low. */
+export declare function groupBy<T>(data: T[], groupKey: string, metricKey: string | null, agg?: Aggregation): GroupResult[];
+export declare function startOfPeriod(date: Date, period: Period, weekStartsOn?: number): Date;
+export declare function addPeriods(date: Date, period: Period, n: number): Date;
+export interface ComparePeriodsOptions {
+    dateKey: string;
+    metricKey: string;
+    groupKey?: string;
+    agg?: Aggregation;
+    period: Period;
+    /** "Now" for the comparison (default: today). */
+    referenceDate?: Date | string;
+    /**
+     * true (default): compare the same elapsed time — e.g. Mon–Wed this week
+     * vs Mon–Wed last week — so a half-finished week doesn't look like a drop.
+     */
+    toDate?: boolean;
+    weekStartsOn?: number;
+}
+export declare function comparePeriods<T>(data: T[], o: ComparePeriodsOptions): PeriodComparison;
+/** Time series: one aggregated value per period, oldest first. */
+export declare function trend<T>(data: T[], dateKey: string, metricKey: string, period: Period, agg?: Aggregation): Array<{
+    start: Date;
+    value: number;
+}>;
+export interface InsightAnswer {
+    kind: "period-change" | "group" | "trend" | "total" | "unknown";
+    answer: string;
+    table: Array<Record<string, string | number>>;
+}
+export declare function askInsight<T>(question: string, data: T[], columns: GridToolColumn[], options?: {
+    referenceDate?: Date | string;
+}): InsightAnswer;

package/dist/agentic/pageInsights.d.ts

@@ -0,0 +1,47 @@
+import { type AuditRoot } from "./dom";
+export interface PageOutline {
+    title: string;
+    description: string;
+    language: string;
+    headings: Array<{
+        level: number;
+        text: string;
+    }>;
+    landmarks: Record<string, number>;
+    counts: {
+        links: number;
+        buttons: number;
+        images: number;
+        forms: number;
+        tables: number;
+        fields: number;
+    };
+    unlabeledFields: Array<{
+        type: string;
+        hint: string;
+        selector: string;
+    }>;
+    imagesWithoutAlt: Array<{
+        src: string;
+        selector: string;
+    }>;
+    purpose: string;
+}
+export interface PageAnswer {
+    intent: PageIntent;
+    answer: string;
+    /** Elements the answer refers to, so the UI can highlight them. */
+    targets: string[];
+    suggestions: string[];
+}
+export type PageIntent = "purpose" | "missing-labels" | "images" | "structure" | "forms" | "links" | "counts" | "unknown";
+export declare function analyzePage(root?: AuditRoot): PageOutline;
+export declare function detectPageIntent(question: string): PageIntent;
+/**
+ * Answers a question about the current page.
+ * @param summarize Optional hook (e.g. Gemini Nano or your own model) used for "purpose" questions.
+ */
+export declare function askAboutPage(question: string, options?: {
+    root?: AuditRoot;
+    summarize?: (pageText: string) => Promise<string>;
+}): Promise<PageAnswer>;

package/dist/agentic/qaAudit.d.ts

@@ -0,0 +1,59 @@
+import { type AuditRoot } from "./dom";
+export type AuditSeverity = "critical" | "serious" | "moderate" | "minor";
+export type AuditRuleId = "html-lang" | "page-title" | "image-alt" | "heading-order" | "single-h1" | "landmark-main" | "form-label" | "button-name" | "link-name" | "color-contrast" | "positive-tabindex" | "keyboard-access" | "duplicate-id" | "form-error" | "target-size";
+export interface AuditIssue {
+    /** Stable within one report, e.g. "image-alt-3". */
+    id: string;
+    rule: AuditRuleId;
+    severity: AuditSeverity;
+    /** WCAG success criterion, e.g. "1.1.1", or "best practice". */
+    wcag: string;
+    message: string;
+    /** Why it matters, in plain English. */
+    why: string;
+    /** What to change. */
+    fix: string;
+    selector: string;
+    snippet: string;
+    /** True when the copilot can apply a safe fix in the browser. */
+    autoFixable: boolean;
+    element?: Element;
+}
+export interface AuditCheck {
+    rule: AuditRuleId;
+    title: string;
+    passed: boolean;
+    issueCount: number;
+}
+export interface AuditReport {
+    url: string;
+    title: string;
+    generatedAt: string;
+    score: number;
+    passed: boolean;
+    checks: AuditCheck[];
+    issues: AuditIssue[];
+    summary: string;
+}
+export interface AuditOptions {
+    root?: AuditRoot;
+    /** Skip rules you don't need. */
+    skip?: AuditRuleId[];
+    /** Cap contrast checks on very large pages (default 600 elements). */
+    maxContrastChecks?: number;
+    /** Minimum interactive target size in CSS px (WCAG 2.5.8 uses 24). */
+    minTargetSize?: number;
+}
+interface RuleInfo {
+    title: string;
+    wcag: string;
+    severity: AuditSeverity;
+    why: string;
+}
+export declare const AUDIT_RULES: Record<AuditRuleId, RuleInfo>;
+export declare function runQaAudit(options?: AuditOptions): AuditReport;
+/** Markdown report you can download, paste into a ticket or attach to a PR. */
+export declare function auditToMarkdown(report: AuditReport): string;
+/** JSON without DOM references, safe to store or send to a server. */
+export declare function auditToJSON(report: AuditReport): string;
+export {};

package/dist/agentic/react.d.ts

@@ -0,0 +1,52 @@
+import { type CSSProperties } from "react";
+import { type GridToolFilter, type GridToolSort } from "../grid/gridTools";
+import type { GridEngine } from "../grid/rust/engine";
+import { type StepResult } from "./taskRunner";
+export interface UseAgenticGridOptions<T> {
+    data: T[];
+    columns: Array<{
+        key: string;
+        label: string;
+        type?: string;
+    }>;
+    rowKey?: string;
+    /** "Now" for questions like "this week" (default: today). */
+    referenceDate?: Date | string;
+    onOpenRow?: (id: string) => void;
+}
+export type AgenticAnswerKind = "query" | "anomalies" | "summary" | "insight" | "tasks";
+export declare function useAgenticGrid<T extends Record<string, unknown>>(options: UseAgenticGridOptions<T>): {
+    /** Pass to <YuktaiGrid data={…}> */
+    gridData: T[];
+    /** Pass to <YuktaiGrid highlightIds={…}> */
+    highlightIds: string[];
+    filters: GridToolFilter[];
+    sort: GridToolSort | null;
+    ask: (question: string) => Promise<void>;
+    reset: () => void;
+    answer: string;
+    kind: AgenticAnswerKind | null;
+    table: Record<string, string | number>[];
+    steps: StepResult[];
+    busy: boolean;
+    visibleIds: string[];
+};
+export declare function AgenticGridBar({ grid, placeholder, examples, style, }: {
+    grid: ReturnType<typeof useAgenticGrid<any>>;
+    placeholder?: string;
+    examples?: string[];
+    style?: CSSProperties;
+}): import("react").JSX.Element;
+type Tab = "copilot" | "qa" | "forms" | "design" | "ask" | "voice";
+export interface AgenticPanelProps {
+    defaultTab?: Tab;
+    /** Speech recognition language for the Voice tab (default "en-IN"). */
+    voiceLang?: string;
+    /** Optional model hook for Ask page, e.g. Gemini Nano or your own API. */
+    generate?: (question: string, context: string) => Promise<string>;
+    /** Ask page search engine: "rust" (default since v5.3.11), "auto" or "ts". Same answers; Rust is faster on long pages. */
+    engine?: GridEngine;
+    style?: CSSProperties;
+}
+export declare function AgenticPanel({ defaultTab, voiceLang, generate, engine, style }: AgenticPanelProps): import("react").JSX.Element;
+export {};

package/dist/agentic/rust/ragCoreWasm.d.ts

@@ -0,0 +1,3 @@
+/** yuktai rag-core WebAssembly (32925 bytes), base64. */
+export declare const RAG_CORE_WASM_BASE64: string;
+export declare const RAG_CORE_WASM_SIZE = 32925;

package/dist/agentic/rust/ragEngine.d.ts

@@ -0,0 +1,32 @@
+import { type GridEngine } from "../../grid/rust/engine";
+/** `engine: "auto"` switches the RAG search to Rust from this many passages. */
+export declare const RAG_AUTO_MIN_PASSAGES = 1000;
+export declare function wantsRustRag(engine: GridEngine | undefined, passages: number): boolean;
+/** Compiles the RAG engine once per page; resolves null without WebAssembly. */
+export declare function loadRagCore(): Promise<WebAssembly.Module | null>;
+export declare function getLoadedRagCore(): WebAssembly.Module | null;
+export interface RagHit {
+    /** Passage position, as given to build() */
+    doc: number;
+    score: number;
+}
+/** One index per RagCore (each has its own WebAssembly memory). */
+export declare class RagCore {
+    private readonly x;
+    private readonly encoder;
+    private docs;
+    private ready;
+    private constructor();
+    static create(mod?: WebAssembly.Module | null): RagCore | null;
+    /**
+     * Indexes the passages: one array of tokenize() words per passage.
+     * Returns false if Rust could not take it (TypeScript is then used).
+     */
+    build(docs: string[][]): boolean;
+    /**
+     * Best passages for the question words `terms` (tokenize() output), with
+     * `idf[i]` per word and `avgDiv` = average passage length (or 1).
+     * Null means "use TypeScript".
+     */
+    search(terms: string[], idf: number[], avgDiv: number, k: number): RagHit[] | null;
+}