@xyne/workflow-ui 1.3.18 → 1.3.20

package/dist/components/shared/viewers/TextView.js

@@ -1,13 +1,18 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect, useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
 import { MarkdownView } from '../MarkdownView.js';
 import { ViewerLoading } from './chrome.js';
+import { useDomAnchor } from './useDomAnchor.js';
 // Plain-text / JSON / Markdown renderer. Fetches the file as text (same-origin,
 // so the auth cookie rides along) and renders by mode. On load failure it
 // throws during render so the parent ViewerBoundary shows the download fallback.
-export default function TextView({ url, mode }) {
+export default function TextView({ url, mode, anchor, }) {
     const [text, setText] = useState(null);
     const [failed, setFailed] = useState(false);
+    const bodyRef = useRef(null);
+    // `text` gates the search: the content only exists in the DOM once it has
+    // loaded, and `mode` because switching renderer rebuilds the subtree.
+    useDomAnchor(bodyRef, anchor, `${mode}:${String(text?.length ?? -1)}`);
     useEffect(() => {
         let cancelled = false;
         setText(null);
@@ -29,10 +34,10 @@ export default function TextView({ url, mode }) {
     if (text === null)
         return _jsx(ViewerLoading, {});
     if (mode === 'markdown') {
-        return (_jsx("div", { className: "px-5 py-4 text-[14px] text-[var(--wui-fg)]", children: _jsx(MarkdownView, { children: text }) }));
+        return (_jsx("div", { ref: bodyRef, className: "px-5 py-4 text-[14px] text-[var(--wui-fg)]", children: _jsx(MarkdownView, { children: text }) }));
     }
     const body = mode === 'json' ? prettyJson(text) : text;
-    return (_jsx("pre", { className: "whitespace-pre-wrap break-words px-5 py-4 font-mono text-[12.5px] leading-relaxed text-[var(--wui-fg)]", children: body }));
+    return (_jsx("div", { ref: bodyRef, children: _jsx("pre", { className: "whitespace-pre-wrap break-words px-5 py-4 font-mono text-[12.5px] leading-relaxed text-[var(--wui-fg)]", children: body }) }));
 }
 function prettyJson(t) {
     try {

package/dist/components/shared/viewers/TextView.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextView.js","sourceRoot":"","sources":["../../../../src/components/shared/viewers/TextView.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,gFAAgF;AAChF,0EAA0E;AAC1E,iFAAiF;AACjF,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,EAAuD;IACjG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE5C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,SAAS,CAAC,KAAK,CAAC,CAAC;QACjB,KAAK,KAAK,CAAC,GAAG,CAAC;aACZ,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAC5C,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,IAAI,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAC,aAAa,KAAG,CAAC;IAE5C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,CACL,cAAK,SAAS,EAAC,4CAA4C,YACzD,KAAC,YAAY,cAAE,IAAI,GAAgB,GAC/B,CACP,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,OAAO,CACL,cAAK,SAAS,EAAC,wGAAwG,YACpH,IAAI,GACD,CACP,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}
+{"version":3,"file":"TextView.js","sourceRoot":"","sources":["../../../../src/components/shared/viewers/TextView.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAE9D,gFAAgF;AAChF,0EAA0E;AAC1E,iFAAiF;AACjF,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,EAC/B,GAAG,EACH,IAAI,EACJ,MAAM,GAKP;IACC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACpD,0EAA0E;IAC1E,sEAAsE;IACtE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEvE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,SAAS,CAAC,KAAK,CAAC,CAAC;QACjB,KAAK,KAAK,CAAC,GAAG,CAAC;aACZ,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAC5C,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,IAAI,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAC,aAAa,KAAG,CAAC;IAE5C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,CACL,cAAK,GAAG,EAAE,OAAO,EAAE,SAAS,EAAC,4CAA4C,YACvE,KAAC,YAAY,cAAE,IAAI,GAAgB,GAC/B,CACP,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,OAAO,CACL,cAAK,GAAG,EAAE,OAAO,YACf,cAAK,SAAS,EAAC,wGAAwG,YACpH,IAAI,GACD,GACF,CACP,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/components/shared/viewers/anchor-match.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Finding a cited passage inside rendered text — the format-agnostic half of
+ * citation anchoring.
+ *
+ * A citation's `quote` is what the **agent read**, which is rarely byte-identical
+ * to what the **viewer renders**: OCR drops or doubles spaces, smart quotes and
+ * ligatures differ between the extractor and the renderer, and a passage can be
+ * split across elements. An exact `indexOf` therefore fails on precisely the
+ * documents citations exist for, and fails *silently* — the reader just sees an
+ * unhighlighted page and assumes the citation is wrong.
+ *
+ * So matching is normalized and laddered: compare on a canonical form, and when
+ * the whole phrase misses, fall back to progressively shorter prefixes. The
+ * *start* of a quote is reliable even when its middle drifted.
+ *
+ * Used by every DOM-rendered viewer (text, markdown, json, docx, csv, xlsx) via
+ * `useDomAnchor`, and by `PdfView` for its own pdf.js find controller.
+ */
+/**
+ * Canonical form for comparison: folded characters, whitespace runs collapsed to
+ * a single space, trimmed. Used on both haystack and needle so they meet in the
+ * middle.
+ */
+export declare function normalizeForMatch(s: string): string;
+/**
+ * Progressively shorter prefixes of a phrase, longest first.
+ *
+ * The fallback when a whole quote won't match — because it spans a page break,
+ * or its middle drifted in OCR. The start of the value is on the cited page by
+ * definition, so a shorter head still lands the reader in the right place.
+ *
+ * Guards against matching noise: never fewer than 2 words or 4 characters, since
+ * a 1-word ladder rung would highlight the first "the" on the page.
+ */
+export declare function buildQueryLadder(value: string): string[];
+/**
+ * Find `quote` inside `root`'s rendered text and return a `Range` over it.
+ *
+ * Tries the whole phrase first, then the prefix ladder. Returns `null` when
+ * nothing matches — callers should degrade to "opened, not highlighted" rather
+ * than pretending.
+ */
+export declare function findRange(root: HTMLElement, quote: string): Range | null;
+//# sourceMappingURL=anchor-match.d.ts.map

package/dist/components/shared/viewers/anchor-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-match.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/viewers/anchor-match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAiBH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAenD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASxD;AAiDD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAyBxE"}

package/dist/components/shared/viewers/anchor-match.js

@@ -0,0 +1,147 @@
+/**
+ * Finding a cited passage inside rendered text — the format-agnostic half of
+ * citation anchoring.
+ *
+ * A citation's `quote` is what the **agent read**, which is rarely byte-identical
+ * to what the **viewer renders**: OCR drops or doubles spaces, smart quotes and
+ * ligatures differ between the extractor and the renderer, and a passage can be
+ * split across elements. An exact `indexOf` therefore fails on precisely the
+ * documents citations exist for, and fails *silently* — the reader just sees an
+ * unhighlighted page and assumes the citation is wrong.
+ *
+ * So matching is normalized and laddered: compare on a canonical form, and when
+ * the whole phrase misses, fall back to progressively shorter prefixes. The
+ * *start* of a quote is reliable even when its middle drifted.
+ *
+ * Used by every DOM-rendered viewer (text, markdown, json, docx, csv, xlsx) via
+ * `useDomAnchor`, and by `PdfView` for its own pdf.js find controller.
+ */
+/** Characters that differ between text extractors and renderers but read the same. */
+const CHAR_FOLD = {
+    '‘': "'", '’': "'", '‚': "'", '‛': "'", // ‘ ’ ‚ ‛
+    '“': '"', '”': '"', '„': '"', '‟': '"', // “ ” „ ‟
+    '–': '-', '—': '-', '−': '-', // – — −
+    ' ': ' ', ' ': ' ', ' ': ' ', ' ': ' ', // nbsp & friends
+    'ff': 'ff', 'fi': 'fi', 'fl': 'fl', // ff fi fl
+    'ffi': 'ffi', 'ffl': 'ffl',
+};
+/** Fold one character to its canonical form (may expand, e.g. a ligature). */
+function foldChar(ch) {
+    return CHAR_FOLD[ch] ?? ch.toLowerCase();
+}
+/**
+ * Canonical form for comparison: folded characters, whitespace runs collapsed to
+ * a single space, trimmed. Used on both haystack and needle so they meet in the
+ * middle.
+ */
+export function normalizeForMatch(s) {
+    let out = '';
+    let pendingSpace = false;
+    for (const ch of s) {
+        if (/\s/.test(ch)) {
+            pendingSpace = out.length > 0;
+            continue;
+        }
+        if (pendingSpace) {
+            out += ' ';
+            pendingSpace = false;
+        }
+        out += foldChar(ch);
+    }
+    return out;
+}
+/**
+ * Progressively shorter prefixes of a phrase, longest first.
+ *
+ * The fallback when a whole quote won't match — because it spans a page break,
+ * or its middle drifted in OCR. The start of the value is on the cited page by
+ * definition, so a shorter head still lands the reader in the right place.
+ *
+ * Guards against matching noise: never fewer than 2 words or 4 characters, since
+ * a 1-word ladder rung would highlight the first "the" on the page.
+ */
+export function buildQueryLadder(value) {
+    const words = value.trim().split(/\s+/);
+    const ladder = [];
+    for (const n of [words.length, 6, 4, 3, 2]) {
+        if (n < 2 || n > words.length)
+            continue;
+        const q = words.slice(0, n).join(' ');
+        if (q.length >= 4 && !ladder.includes(q))
+            ladder.push(q);
+    }
+    return ladder.length ? ladder : [value.trim()];
+}
+/**
+ * Flatten a subtree's text into its normalized form plus, for each normalized
+ * character, the text node and offset it came from.
+ *
+ * The index map is what lets a match on the *normalized* string become a real
+ * `Range` over the *original* DOM — without it we could detect a hit but not
+ * highlight it.
+ */
+function flatten(root) {
+    const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
+    let text = '';
+    const map = [];
+    let pendingSpace = false;
+    for (let n = walker.nextNode(); n; n = walker.nextNode()) {
+        const node = n;
+        const raw = node.data;
+        for (let i = 0; i < raw.length; i++) {
+            const ch = raw[i];
+            if (/\s/.test(ch)) {
+                pendingSpace = text.length > 0;
+                continue;
+            }
+            if (pendingSpace) {
+                // The space belongs to this character's position, so a match starting
+                // here still points at a real node offset.
+                text += ' ';
+                map.push({ node, offset: i });
+                pendingSpace = false;
+            }
+            const folded = foldChar(ch);
+            // A ligature folds to several characters; each maps back to the same source.
+            for (const f of folded) {
+                text += f;
+                map.push({ node, offset: i });
+            }
+        }
+    }
+    return { text, map };
+}
+/**
+ * Find `quote` inside `root`'s rendered text and return a `Range` over it.
+ *
+ * Tries the whole phrase first, then the prefix ladder. Returns `null` when
+ * nothing matches — callers should degrade to "opened, not highlighted" rather
+ * than pretending.
+ */
+export function findRange(root, quote) {
+    const needleRaw = quote.trim();
+    if (!needleRaw)
+        return null;
+    const { text, map } = flatten(root);
+    if (!text)
+        return null;
+    for (const candidate of buildQueryLadder(needleRaw)) {
+        const needle = normalizeForMatch(candidate);
+        if (needle.length < 2)
+            continue;
+        const at = text.indexOf(needle);
+        if (at === -1)
+            continue;
+        const start = map[at];
+        const end = map[at + needle.length - 1];
+        if (!start || !end)
+            continue;
+        const range = document.createRange();
+        range.setStart(start.node, start.offset);
+        // `end` is the last matched character — the range must close after it.
+        range.setEnd(end.node, Math.min(end.offset + 1, end.node.data.length));
+        return range;
+    }
+    return null;
+}
+//# sourceMappingURL=anchor-match.js.map

package/dist/components/shared/viewers/anchor-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-match.js","sourceRoot":"","sources":["../../../../src/components/shared/viewers/anchor-match.ts"],"names":[],"mappings":"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"}

package/dist/components/shared/viewers/useDomAnchor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Scroll to a cited passage and highlight it — for any viewer that renders its
+ * content into the DOM (text, markdown, json, docx, csv, xlsx).
+ *
+ * One hook serves all of them because, once rendered, those formats are just
+ * text in a subtree. Only PDF (canvas + its own text layer) and images need
+ * bespoke handling. So "support a new format" means *render it and stamp a few
+ * data attributes* — not write new anchoring logic.
+ *
+ * The resolution ladder is deliberately the same everywhere:
+ *   locator (structural, exact) → quote (fuzzy text search) → nothing
+ * and "nothing" is a real outcome: the document still opens, just unhighlighted.
+ * Guessing a location would be worse than admitting we couldn't find it.
+ */
+import { type RefObject } from 'react';
+import type { Locator } from '@xyne/workflow-sdk/common';
+export type { Locator } from '@xyne/workflow-sdk/common';
+export interface Anchor {
+    /** The cited text. The portable anchor — works in any text-bearing renderer. */
+    quote?: string | undefined;
+    /** Exact structural address, when the source exposed one. */
+    locator?: Locator | undefined;
+}
+export interface UseDomAnchorResult {
+    /** Whether the anchor was located. `false` ⇒ the doc opened unhighlighted. */
+    hit: boolean;
+}
+/**
+ * The container must render its content as React children or be written
+ * imperatively (as docx-preview does). A container using
+ * `dangerouslySetInnerHTML` re-applies that HTML on re-render and would discard
+ * the overlay — a property of that API, not of this hook.
+ *
+ * @param containerRef the element wrapping the viewer's rendered content
+ * @param anchor       what to locate; `undefined` ⇒ do nothing at all
+ * @param ready        re-runs the search when this changes — pass whatever
+ *                     signals the content has painted (parsed rows, loaded text).
+ *                     Searching before paint finds nothing.
+ */
+export declare function useDomAnchor(containerRef: RefObject<HTMLElement | null>, anchor: Anchor | undefined, ready?: unknown): UseDomAnchorResult;
+//# sourceMappingURL=useDomAnchor.d.ts.map

package/dist/components/shared/viewers/useDomAnchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDomAnchor.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/viewers/useDomAnchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAKzD,YAAY,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,WAAW,MAAM;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AA8DD,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAC3C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,CAAC,EAAE,OAAO,GACd,kBAAkB,CA+CpB"}

package/dist/components/shared/viewers/useDomAnchor.js

@@ -0,0 +1,125 @@
+/**
+ * Scroll to a cited passage and highlight it — for any viewer that renders its
+ * content into the DOM (text, markdown, json, docx, csv, xlsx).
+ *
+ * One hook serves all of them because, once rendered, those formats are just
+ * text in a subtree. Only PDF (canvas + its own text layer) and images need
+ * bespoke handling. So "support a new format" means *render it and stamp a few
+ * data attributes* — not write new anchoring logic.
+ *
+ * The resolution ladder is deliberately the same everywhere:
+ *   locator (structural, exact) → quote (fuzzy text search) → nothing
+ * and "nothing" is a real outcome: the document still opens, just unhighlighted.
+ * Guessing a location would be worse than admitting we couldn't find it.
+ */
+import { useEffect, useState } from 'react';
+import { findRange } from './anchor-match.js';
+const LAYER_ATTR = 'data-wui-anchor-layer';
+/** The element a structural locator addresses, via attributes viewers stamp. */
+function findByLocator(root, locator) {
+    switch (locator.at) {
+        case 'cell':
+            return root.querySelector(`[data-row="${String(locator.row)}"][data-col="${String(locator.col)}"]`);
+        case 'line':
+            return root.querySelector(`[data-line="${String(locator.from)}"]`);
+        case 'page':
+            // Paged rendering is pdf.js's own concern; DOM viewers have no pages.
+            return null;
+    }
+}
+function clearOverlay(container) {
+    container.querySelectorAll(`[${LAYER_ATTR}]`).forEach((n) => { n.remove(); });
+}
+/**
+ * Paint highlight rectangles over a range.
+ *
+ * An overlay rather than wrapping the match in `<mark>`: several viewers render
+ * content they own (docx-preview rebuilds its subtree, tables re-render), and
+ * mutating that DOM corrupts it and gets wiped on the next paint. Rectangles
+ * layered on top are non-destructive and behave identically everywhere.
+ */
+function paintOverlay(container, rects) {
+    if (rects.length === 0)
+        return;
+    // The layer is positioned against the container's padding box, so the
+    // container must establish a containing block.
+    if (getComputedStyle(container).position === 'static') {
+        container.style.position = 'relative';
+    }
+    const base = container.getBoundingClientRect();
+    const layer = document.createElement('div');
+    layer.setAttribute(LAYER_ATTR, 'true');
+    layer.style.cssText = 'position:absolute;inset:0;pointer-events:none;z-index:5;';
+    for (const r of rects) {
+        if (r.width === 0 || r.height === 0)
+            continue;
+        const mark = document.createElement('div');
+        mark.style.cssText = [
+            'position:absolute',
+            `left:${String(r.left - base.left + container.scrollLeft)}px`,
+            `top:${String(r.top - base.top + container.scrollTop)}px`,
+            `width:${String(r.width)}px`,
+            `height:${String(r.height)}px`,
+            'background:color-mix(in srgb, var(--wui-primary) 26%, transparent)',
+            'border-radius:2px',
+            'mix-blend-mode:multiply',
+        ].join(';');
+        layer.appendChild(mark);
+    }
+    container.appendChild(layer);
+}
+/**
+ * The container must render its content as React children or be written
+ * imperatively (as docx-preview does). A container using
+ * `dangerouslySetInnerHTML` re-applies that HTML on re-render and would discard
+ * the overlay — a property of that API, not of this hook.
+ *
+ * @param containerRef the element wrapping the viewer's rendered content
+ * @param anchor       what to locate; `undefined` ⇒ do nothing at all
+ * @param ready        re-runs the search when this changes — pass whatever
+ *                     signals the content has painted (parsed rows, loaded text).
+ *                     Searching before paint finds nothing.
+ */
+export function useDomAnchor(containerRef, anchor, ready) {
+    const [hit, setHit] = useState(false);
+    const quote = anchor?.quote;
+    const locator = anchor?.locator;
+    // Locators are small and flat; a stable string keeps the effect from re-running
+    // on every render just because the object identity changed.
+    const locatorKey = locator ? JSON.stringify(locator) : '';
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!container)
+            return;
+        clearOverlay(container);
+        if (!quote && !locator) {
+            setHit(false);
+            return;
+        }
+        let target = null;
+        if (locator) {
+            const el = findByLocator(container, locator);
+            if (el)
+                target = { scrollTo: el, rects: [el.getBoundingClientRect()] };
+        }
+        if (!target && quote) {
+            const range = findRange(container, quote);
+            if (range) {
+                const rects = Array.from(range.getClientRects());
+                const first = range.startContainer.parentElement;
+                if (first)
+                    target = { scrollTo: first, rects };
+            }
+        }
+        if (!target) {
+            setHit(false);
+            return;
+        }
+        paintOverlay(container, target.rects);
+        target.scrollTo.scrollIntoView({ block: 'center', inline: 'nearest' });
+        setHit(true);
+        return () => { clearOverlay(container); };
+    }, [containerRef, quote, locatorKey, ready]);
+    return { hit };
+}
+//# sourceMappingURL=useDomAnchor.js.map

package/dist/components/shared/viewers/useDomAnchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDomAnchor.js","sourceRoot":"","sources":["../../../../src/components/shared/viewers/useDomAnchor.ts"],"names":[],"mappings":"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"}

package/dist/components/workflows/WorkflowApp.d.ts

@@ -0,0 +1,19 @@
+import type { AiBuilderClient } from '@xyne/workflow-sdk/ai-builder';
+export interface WorkflowSearch {
+    view?: 'tabs' | 'graph' | undefined;
+}
+export interface WorkflowAppProps {
+    /** Sub-path after the host's /workflows mount: '', 'executions', 'approvals',
+     *  'folder/<id>', 'w/<id>', 'runs/<id>'. */
+    path: string;
+    /** Query params (view state within a page — e.g. the run viewer's tab/node). */
+    search?: WorkflowSearch | undefined;
+    /** Push a new sub-path (+ optional query); the host wires this to its router so
+     *  back/forward work. `replace` avoids a history entry for in-page view changes. */
+    onNavigate: (path: string, search?: WorkflowSearch, replace?: boolean) => void;
+    aiBuilderClient?: AiBuilderClient | undefined;
+    onToast?: (kind: 'success' | 'error', message: string) => void;
+    className?: string;
+}
+export declare function WorkflowApp({ path, search, onNavigate, aiBuilderClient, onToast, className, }: WorkflowAppProps): import("react").JSX.Element;
+//# sourceMappingURL=WorkflowApp.d.ts.map

package/dist/components/workflows/WorkflowApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowApp.d.ts","sourceRoot":"","sources":["../../../src/components/workflows/WorkflowApp.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAOrE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B;gDAC4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC;wFACoF;IACpF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/E,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6CD,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,MAAM,EACN,UAAU,EACV,eAAe,EACf,OAAO,EACP,SAAS,GACV,EAAE,gBAAgB,+BAyMlB"}

package/dist/components/workflows/WorkflowApp.js

@@ -0,0 +1,121 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState, } from 'react';
+import { ArrowLeft } from 'lucide-react';
+import { useWorkflowClient } from '../../hooks/use-workflow-client.js';
+import { WorkflowHome } from './WorkflowHome.js';
+import {} from './WorkflowBrowser.js';
+import { WorkflowDashboard } from '../dashboard/WorkflowDashboard.js';
+import { ExecutionViewer } from '../execution/ExecutionViewer.js';
+const parseRoute = (raw) => {
+    const clean = raw.replace(/^\/+|\/+$/g, '');
+    if (clean === '')
+        return { kind: 'home', tab: 'workflows' };
+    const [head, ...rest] = clean.split('/');
+    const arg = rest.join('/');
+    if (head === 'executions')
+        return { kind: 'home', tab: 'executions' };
+    if (head === 'approvals')
+        return { kind: 'home', tab: 'approvals', ...(arg ? { approvalId: arg } : {}) };
+    if (head === 'folder' && arg)
+        return { kind: 'home', tab: 'workflows', folderId: arg };
+    if (head === 'w' && arg) {
+        const [wfId, sub] = arg.split('/');
+        if (wfId)
+            return { kind: 'workflow', workflowId: wfId, view: sub === 'edit' ? 'builder' : 'runs' };
+    }
+    if (head === 'runs' && arg) {
+        const [execId, ...nodeParts] = arg.split('/');
+        const nodeId = nodeParts.join('/');
+        if (execId)
+            return { kind: 'run', executionId: execId, ...(nodeId ? { nodeId } : {}) };
+    }
+    return { kind: 'home', tab: 'workflows' };
+};
+const tabToPath = (tab) => (tab === 'workflows' ? '' : tab);
+const folderToPath = (crumbs) => {
+    const leaf = crumbs[crumbs.length - 1];
+    return leaf ? `folder/${leaf.id}` : '';
+};
+const runToPath = (executionId, nodeId) => nodeId ? `runs/${executionId}/${nodeId}` : `runs/${executionId}`;
+export function WorkflowApp({ path, search, onNavigate, aiBuilderClient, onToast, className, }) {
+    const client = useWorkflowClient();
+    const route = parseRoute(path);
+    // The URL carries only the leaf folder id; the full breadcrumb lives here and is
+    // reconciled with the id on back/forward/deep-link below.
+    const [folderCrumbs, setFolderCrumbs] = useState([]);
+    const [detail, setDetail] = useState(null);
+    const folderId = route.kind === 'home' ? route.folderId : undefined;
+    useEffect(() => {
+        setFolderCrumbs((prev) => {
+            if (!folderId)
+                return prev.length ? [] : prev;
+            if (prev[prev.length - 1]?.id === folderId)
+                return prev;
+            const idx = prev.findIndex((c) => c.id === folderId);
+            if (idx >= 0)
+                return prev.slice(0, idx + 1);
+            return [{ id: folderId, name: 'Folder' }];
+        });
+    }, [folderId]);
+    const workflowId = route.kind === 'workflow' ? route.workflowId : undefined;
+    const fetchSeq = useRef(0);
+    useEffect(() => {
+        if (!workflowId) {
+            setDetail(null);
+            return;
+        }
+        const seq = ++fetchSeq.current;
+        void (async () => {
+            const wf = await client.workflows.get(workflowId);
+            if (seq !== fetchSeq.current)
+                return;
+            const meta = wf.metadata
+                ? JSON.parse(wf.metadata)
+                : {};
+            const config = wf.config
+                ? JSON.parse(wf.config)
+                : undefined;
+            setDetail({
+                workflowId,
+                name: meta.name ?? workflowId,
+                config,
+                ...(wf.summary != null ? { summary: wf.summary } : {}),
+                ...(wf.permittedActions ? { permittedActions: wf.permittedActions } : {}),
+            });
+        })();
+    }, [workflowId, client]);
+    const goTab = useCallback((tab) => onNavigate(tabToPath(tab)), [onNavigate]);
+    const goFolder = useCallback((crumbs) => {
+        setFolderCrumbs(crumbs);
+        onNavigate(folderToPath(crumbs));
+    }, [onNavigate]);
+    const openWorkflow = useCallback((id, crumbs) => {
+        setFolderCrumbs(crumbs);
+        onNavigate(`w/${id}`);
+    }, [onNavigate]);
+    const openRun = useCallback((executionId) => onNavigate(`runs/${executionId}`), [onNavigate]);
+    const backToBrowser = useCallback(() => onNavigate(folderToPath(folderCrumbs)), [folderCrumbs, onNavigate]);
+    const goToCrumb = (index) => goFolder(index < 0 ? [] : folderCrumbs.slice(0, index + 1));
+    const handleSave = useCallback(async (config, summary) => {
+        if (!detail)
+            return;
+        await client.workflows.update(detail.workflowId, { config });
+        setDetail((prev) => prev ? { ...prev, config, ...(summary != null ? { summary } : {}) } : prev);
+    }, [client, detail]);
+    let detailView = null;
+    if (route.kind === 'run') {
+        detailView = (_jsx(ExecutionViewer, { executionId: route.executionId, selectedStepId: route.nodeId ?? null, viewMode: search?.view ?? 'tabs', onViewModeChange: (m) => onNavigate(runToPath(route.executionId, route.nodeId), { view: m === 'graph' ? 'graph' : undefined }, true), onSelectStep: (node, replace) => onNavigate(runToPath(route.executionId, node ?? undefined), { view: search?.view }, replace ?? false), onBack: () => {
+                if (typeof window !== 'undefined')
+                    window.history.back();
+            }, onRerunSuccess: (newId) => openRun(newId) }));
+    }
+    else if (route.kind === 'workflow') {
+        detailView =
+            detail?.workflowId === route.workflowId ? (_jsxs("div", { className: "flex h-full flex-col", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-3 border-b border-[var(--wui-border)] bg-[var(--wui-bg)] px-5 py-2.5", children: [_jsx("button", { type: "button", "aria-label": "Back", onClick: backToBrowser, className: "grid h-7 w-7 place-items-center rounded-md text-[var(--wui-fg-muted)] transition-colors hover:bg-[color-mix(in_srgb,var(--wui-fg)_6%,transparent)] hover:text-[var(--wui-fg)]", children: _jsx(ArrowLeft, { className: "h-3.5 w-3.5", strokeWidth: 1.75 }) }), _jsxs("nav", { className: "flex min-w-0 items-center gap-1 text-[13px] text-[var(--wui-fg-muted)]", children: [_jsx("button", { type: "button", onClick: () => goToCrumb(-1), className: "rounded-md px-1.5 py-0.5 transition-colors hover:bg-[color-mix(in_srgb,var(--wui-fg)_6%,transparent)] hover:text-[var(--wui-fg)]", children: "Workflows" }), folderCrumbs.map((seg, i) => (_jsxs("span", { className: "flex min-w-0 items-center gap-1", children: [_jsx("span", { className: "select-none text-[var(--wui-fg-muted)]/60", children: "\u203A" }), _jsx("button", { type: "button", onClick: () => goToCrumb(i), className: "max-w-[24ch] truncate rounded-md px-1.5 py-0.5 transition-colors hover:bg-[color-mix(in_srgb,var(--wui-fg)_6%,transparent)] hover:text-[var(--wui-fg)]", title: seg.name, children: seg.name })] }, seg.id))), _jsxs("span", { className: "flex min-w-0 items-center gap-1", children: [_jsx("span", { className: "select-none text-[var(--wui-fg-muted)]/60", children: "\u203A" }), _jsx("span", { className: "max-w-[32ch] truncate rounded-md px-1.5 py-0.5 font-medium text-[var(--wui-fg)]", title: detail.name, children: detail.name })] })] })] }), _jsx("div", { className: "flex-1 overflow-hidden", children: _jsx(WorkflowDashboard, { view: route.view, onViewChange: (v) => onNavigate(v === 'builder' ? `w/${route.workflowId}/edit` : `w/${route.workflowId}`), onViewRun: openRun, workflowId: detail.workflowId, workflowConfig: detail.config, summary: detail.summary, onSave: handleSave, ...(aiBuilderClient ? { aiBuilderClient } : {}), ...(detail.permittedActions
+                                ? { permittedActions: detail.permittedActions }
+                                : {}) }) })] })) : (_jsx("div", { className: "flex h-full items-center justify-center text-[13px] text-[var(--wui-fg-muted)]", children: "Loading\u2026" }));
+    }
+    const tab = route.kind === 'home' ? route.tab : 'workflows';
+    return (_jsx(WorkflowHome, { ...(className ? { className } : {}), tab: tab, onTabChange: goTab, path: folderCrumbs, onPathChange: goFolder, onSelectWorkflow: openWorkflow, onViewRun: (id) => openRun(id), approvalId: route.kind === 'home' && route.tab === 'approvals' ? (route.approvalId ?? null) : null, onApprovalSelect: (id) => onNavigate(id ? `approvals/${id}` : 'approvals'), ...(onToast ? { onToast } : {}), ...(detailView ? { detailView } : {}) }));
+}
+//# sourceMappingURL=WorkflowApp.js.map

package/dist/components/workflows/WorkflowApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowApp.js","sourceRoot":"","sources":["../../../src/components/workflows/WorkflowApp.tsx"],"names":[],"mappings":"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"}

package/dist/components/workflows/WorkflowHome.d.ts

@@ -7,9 +7,15 @@ export interface WorkflowHomeProps {
     onPathChange: (path: FolderCrumb[]) => void;
     onSelectWorkflow: (workflowId: string, path: FolderCrumb[]) => void;
     onViewRun: (executionId: string, workflowName: string) => void;
+    /** Controlled approval selection (for URL sync) — threaded to the Approvals tab. */
+    approvalId?: string | null | undefined;
+    onApprovalSelect?: ((id: string | null) => void) | undefined;
     onToast?: (kind: 'success' | 'error', message: string) => void;
-    /** Which tab opens first. */
+    /** Which tab opens first (uncontrolled). */
     defaultTab?: WorkflowHomeTab;
+    /** Controlled active tab; with onTabChange the parent (router) owns it. */
+    tab?: WorkflowHomeTab;
+    onTabChange?: (tab: WorkflowHomeTab) => void;
     /** When provided, fills the content area (below the tab bar) instead of the active tab. */
     detailView?: ReactNode | undefined;
     /** Called when a tab is clicked while a detailView is open, so the host can close it. */
@@ -23,5 +29,5 @@ export interface WorkflowHomeProps {
  * pending-approval count surfaces as a badge on the Approvals tab rather
  * than an in-list banner.
  */
-export declare function WorkflowHome({ path, onPathChange, onSelectWorkflow, onViewRun, onToast, defaultTab, detailView, onLeaveDetail, className, }: WorkflowHomeProps): import("react").JSX.Element;
+export declare function WorkflowHome({ path, onPathChange, onSelectWorkflow, onViewRun, approvalId, onApprovalSelect, onToast, defaultTab, tab: controlledTab, onTabChange, detailView, onLeaveDetail, className, }: WorkflowHomeProps): import("react").JSX.Element;
 //# sourceMappingURL=WorkflowHome.d.ts.map

package/dist/components/workflows/WorkflowHome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkflowHome.d.ts","sourceRoot":"","sources":["../../../src/components/workflows/WorkflowHome.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMzE,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC5C,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACpE,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,6BAA6B;IAC7B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,2FAA2F;IAC3F,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACnC,yFAAyF;IACzF,aAAa,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,OAAO,EACP,UAAwB,EACxB,UAAU,EACV,aAAa,EACb,SAAS,GACV,EAAE,iBAAiB,+BA4EnB"}
+{"version":3,"file":"WorkflowHome.d.ts","sourceRoot":"","sources":["../../../src/components/workflows/WorkflowHome.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMzE,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC5C,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACpE,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC7D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,4CAA4C;IAC5C,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,2EAA2E;IAC3E,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;IAC7C,2FAA2F;IAC3F,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACnC,yFAAyF;IACzF,aAAa,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,UAAwB,EACxB,GAAG,EAAE,aAAa,EAClB,WAAW,EACX,UAAU,EACV,aAAa,EACb,SAAS,GACV,EAAE,iBAAiB,+BAoFnB"}