@stigmer/react 3.1.1 → 3.1.2

package/workspace/findChangeForSelection.d.ts

@@ -0,0 +1,19 @@
+import type { FileChange } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import type { SelectedWorkspaceFile } from "../internal/store/workspace-file-selection-store.js";
+import type { WorkspaceEntry } from "./useWorkspaceEntries.js";
+/**
+ * The session {@link FileChange} that touched the currently-open file, or
+ * `null` when the open file was not changed this session (or cannot be
+ * correlated with certainty).
+ *
+ * @param selection - The open file, keyed by `entryId` + repo/root-relative `path`.
+ * @param fileChanges - Net-per-file session changes (from `useSessionFileChanges`).
+ * @param entries - The client workspace entries — the SAME list the tree and
+ *   transcript resolve against (`flow.workspace.entries`), so the returned
+ *   `entryId` is directly comparable. Do not pass the proto `workspaceEntries`.
+ * @param sandboxWorkspaceRoot - The sandbox root for git sessions (strips
+ *   cloud-absolute change paths), identical to the transcript resolver's input.
+ * @returns The matching change, or `null`.
+ */
+export declare function findChangeForSelection(selection: SelectedWorkspaceFile, fileChanges: readonly FileChange[], entries: readonly WorkspaceEntry[], sandboxWorkspaceRoot?: string): FileChange | null;
+//# sourceMappingURL=findChangeForSelection.d.ts.map

package/workspace/findChangeForSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findChangeForSelection.d.ts","sourceRoot":"","sources":["../../src/workspace/findChangeForSelection.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iEAAiE,CAAC;AAClG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAEjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,qBAAqB,EAChC,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,oBAAoB,CAAC,EAAE,MAAM,GAC5B,UAAU,GAAG,IAAI,CAgBnB"}

package/workspace/findChangeForSelection.js

@@ -0,0 +1,46 @@
+// Correlate an open workspace-file selection with the session file change that
+// touched it, so the read-only Viewer can default a changed file to its diff
+// (Slice 4). This is the change-side peer of `resolveWorkspaceFileSelection`.
+//
+// The hard part is again PATH FORM, and — critically — ENTRY IDENTITY. A
+// `FileChange` carries a capture-side path (`path` is workspace-root-relative,
+// falling back to `absolutePath`), while the selection is the reader's
+// `{ entryId, path }`. Matching by a bare `/`-boundary suffix (as the
+// presentation-only `changeForRowPath` does) is deliberately NOT used here: in
+// a multi-repo session it would happily match `repoA/src/a.ts` to a change in
+// `repoB/src/a.ts` and render the wrong file's diff.
+//
+// Instead we route each change's path through the SAME correlation-grade
+// resolver (`resolveWorkspaceFileSelection`) the tree and transcript use to
+// open files, with the SAME `entries` and `sandboxWorkspaceRoot`. A change is
+// the open file's change iff it resolves to the exact `{ entryId, path }`
+// currently selected. Single-entry sessions match exactly; ambiguous
+// multi-entry / absolute paths degrade to "no match" (never a wrong match),
+// inheriting DD-08's honesty. One resolver, one truth.
+import { resolveWorkspaceFileSelection } from "./resolveWorkspaceFileSelection.js";
+/**
+ * The session {@link FileChange} that touched the currently-open file, or
+ * `null` when the open file was not changed this session (or cannot be
+ * correlated with certainty).
+ *
+ * @param selection - The open file, keyed by `entryId` + repo/root-relative `path`.
+ * @param fileChanges - Net-per-file session changes (from `useSessionFileChanges`).
+ * @param entries - The client workspace entries — the SAME list the tree and
+ *   transcript resolve against (`flow.workspace.entries`), so the returned
+ *   `entryId` is directly comparable. Do not pass the proto `workspaceEntries`.
+ * @param sandboxWorkspaceRoot - The sandbox root for git sessions (strips
+ *   cloud-absolute change paths), identical to the transcript resolver's input.
+ * @returns The matching change, or `null`.
+ */
+export function findChangeForSelection(selection, fileChanges, entries, sandboxWorkspaceRoot) {
+    for (const change of fileChanges) {
+        const resolved = resolveWorkspaceFileSelection(change.path || change.absolutePath, entries, sandboxWorkspaceRoot);
+        if (resolved !== null &&
+            resolved.entryId === selection.entryId &&
+            resolved.path === selection.path) {
+            return change;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=findChangeForSelection.js.map

package/workspace/findChangeForSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findChangeForSelection.js","sourceRoot":"","sources":["../../src/workspace/findChangeForSelection.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,uEAAuE;AACvE,sEAAsE;AACtE,+EAA+E;AAC/E,8EAA8E;AAC9E,qDAAqD;AACrD,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,8EAA8E;AAC9E,0EAA0E;AAC1E,qEAAqE;AACrE,4EAA4E;AAC5E,uDAAuD;AAIvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAGnF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAgC,EAChC,WAAkC,EAClC,OAAkC,EAClC,oBAA6B;IAE7B,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,6BAA6B,CAC5C,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,EAClC,OAAO,EACP,oBAAoB,CACrB,CAAC;QACF,IACE,QAAQ,KAAK,IAAI;YACjB,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO;YACtC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAChC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/workspace/index.d.ts

@@ -1,10 +1,32 @@
 export { useWorkspaceEntries } from "./useWorkspaceEntries.js";
 export type { WorkspaceEntry, UseWorkspaceEntriesReturn, } from "./useWorkspaceEntries.js";
 export type { WorkspaceFileEntry, WorkspaceFileLister, } from "./WorkspaceFileLister.js";
+export { MAX_WORKSPACE_FILE_READ_BYTES } from "./WorkspaceFileReader.js";
+export type { WorkspaceFileContent, WorkspaceFileReader, } from "./WorkspaceFileReader.js";
 export { useWorkspaceFiles } from "./useWorkspaceFiles.js";
 export type { UseWorkspaceFilesOptions, UseWorkspaceFilesReturn, } from "./useWorkspaceFiles.js";
-export { WorkspaceEntryFiles } from "./WorkspaceEntryFiles.js";
-export type { WorkspaceEntryFilesProps } from "./WorkspaceEntryFiles.js";
+export { useWorkspaceFileContent } from "./useWorkspaceFileContent.js";
+export type { UseWorkspaceFileContentOptions, UseWorkspaceFileContentReturn, } from "./useWorkspaceFileContent.js";
+export { useWorkspaceFileSearch } from "./useWorkspaceFileSearch.js";
+export type { UseWorkspaceFileSearchOptions, UseWorkspaceFileSearchReturn, WorkspaceFileSearchGroup, } from "./useWorkspaceFileSearch.js";
+export type { WorkspaceFileMatch } from "./matchWorkspaceFiles.js";
+export { WorkspaceFileSearch } from "./WorkspaceFileSearch.js";
+export type { WorkspaceFileSearchProps } from "./WorkspaceFileSearch.js";
+export type { WorkspaceContentMatch, WorkspaceContentSearchResult, WorkspaceContentSearcher, } from "./WorkspaceContentSearcher.js";
+export { useWorkspaceContentSearch } from "./useWorkspaceContentSearch.js";
+export type { UseWorkspaceContentSearchOptions, UseWorkspaceContentSearchReturn, WorkspaceContentSearchGroup, } from "./useWorkspaceContentSearch.js";
+export { WorkspaceContentSearch } from "./WorkspaceContentSearch.js";
+export type { WorkspaceContentSearchProps } from "./WorkspaceContentSearch.js";
+export { FileViewer } from "./FileViewer.js";
+export type { FileViewerProps, FileViewerHandle } from "./FileViewer.js";
+export { WorkspaceSurface } from "./WorkspaceSurface.js";
+export type { WorkspaceSurfaceProps, SurfaceRailView, SurfaceVirtualDocument, } from "./WorkspaceSurface.js";
+export { virtualEntryId, isVirtualEntryId } from "../internal/store/index.js";
+export { ExplorerTree } from "./ExplorerTree.js";
+export type { ExplorerTreeProps } from "./ExplorerTree.js";
+export type { OpenEditor, OpenFileOptions } from "../internal/store/index.js";
+export type { RevealTarget } from "../internal/useRevealLine.js";
+export type { SelectedWorkspaceFile } from "../internal/store/workspace-file-selection-store.js";
 export { WorkspaceEditor } from "./WorkspaceEditor.js";
 export type { WorkspaceEditorProps } from "./WorkspaceEditor.js";
 export { WorkspaceSummary } from "./WorkspaceSummary.js";

package/workspace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,cAAc,EACd,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,eAAe,EACf,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,cAAc,EACd,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,YAAY,EACV,gCAAgC,EAChC,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE/E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG9E,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE,YAAY,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,eAAe,EACf,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC"}

package/workspace/index.js

@@ -1,6 +1,18 @@
 export { useWorkspaceEntries } from "./useWorkspaceEntries.js";
+export { MAX_WORKSPACE_FILE_READ_BYTES } from "./WorkspaceFileReader.js";
 export { useWorkspaceFiles } from "./useWorkspaceFiles.js";
-export { WorkspaceEntryFiles } from "./WorkspaceEntryFiles.js";
+export { useWorkspaceFileContent } from "./useWorkspaceFileContent.js";
+export { useWorkspaceFileSearch } from "./useWorkspaceFileSearch.js";
+export { WorkspaceFileSearch } from "./WorkspaceFileSearch.js";
+export { useWorkspaceContentSearch } from "./useWorkspaceContentSearch.js";
+export { WorkspaceContentSearch } from "./WorkspaceContentSearch.js";
+// The highlight helper (findHighlightRanges) stays @internal, like matchWorkspaceFiles.
+export { FileViewer } from "./FileViewer.js";
+export { WorkspaceSurface } from "./WorkspaceSurface.js";
+// Virtual-document identity helpers: hosts mint collision-proof entry ids for
+// SurfaceVirtualDocument tabs and detect them in file-only code paths.
+export { virtualEntryId, isVirtualEntryId } from "../internal/store/index.js";
+export { ExplorerTree } from "./ExplorerTree.js";
 export { WorkspaceEditor } from "./WorkspaceEditor.js";
 export { WorkspaceSummary } from "./WorkspaceSummary.js";
 export { useRecentWorkspaces } from "./useRecentWorkspaces.js";

package/workspace/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAS/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAK3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAK/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAS/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAKzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAK3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAKvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAQrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAO/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAM3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,wFAAwF;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,8EAA8E;AAC9E,uEAAuE;AACvE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAK/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/workspace/matchContentPreview.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A half-open `[start, end)` range of code-unit offsets into a preview string,
+ * marking one occurrence of the query to emphasize.
+ */
+export interface HighlightRange {
+    /** Inclusive start offset within the preview. */
+    readonly start: number;
+    /** Exclusive end offset within the preview. */
+    readonly end: number;
+}
+/**
+ * Finds every case-insensitive occurrence of `query` within `preview`,
+ * best-effort for rendering emphasis.
+ *
+ * - Empty/whitespace query → `[]` (nothing to highlight).
+ * - Overlapping matches cannot occur (search advances past each match end).
+ * - Offsets are JS string code units, so a consumer highlights with
+ *   `preview.slice(start, end)`.
+ */
+export declare function findHighlightRanges(preview: string, query: string): HighlightRange[];
+//# sourceMappingURL=matchContentPreview.d.ts.map

package/workspace/matchContentPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchContentPreview.d.ts","sourceRoot":"","sources":["../../src/workspace/matchContentPreview.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,cAAc,EAAE,CAiBlB"}

package/workspace/matchContentPreview.js

@@ -0,0 +1,36 @@
+// Pure highlight helper behind content search. Kept separate from the hook and
+// component so the offset math is exhaustively unit-testable in isolation (no
+// React, no async).
+//
+// The backend returns each hit's `preview` line but no column offset (a
+// cross-language byte/UTF-16 offset would be brittle — see WorkspaceContentMatch).
+// Since matching is case-insensitive substring, the client re-derives the
+// highlight span(s) from the preview text itself, identically to how
+// `matchWorkspaceFiles` derives the filename highlight range. `@internal`.
+/**
+ * Finds every case-insensitive occurrence of `query` within `preview`,
+ * best-effort for rendering emphasis.
+ *
+ * - Empty/whitespace query → `[]` (nothing to highlight).
+ * - Overlapping matches cannot occur (search advances past each match end).
+ * - Offsets are JS string code units, so a consumer highlights with
+ *   `preview.slice(start, end)`.
+ */
+export function findHighlightRanges(preview, query) {
+    const needle = query.trim().toLowerCase();
+    if (needle.length === 0)
+        return [];
+    const haystack = preview.toLowerCase();
+    const ranges = [];
+    let from = 0;
+    for (;;) {
+        const start = haystack.indexOf(needle, from);
+        if (start === -1)
+            break;
+        const end = start + needle.length;
+        ranges.push({ start, end });
+        from = end;
+    }
+    return ranges;
+}
+//# sourceMappingURL=matchContentPreview.js.map

package/workspace/matchContentPreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchContentPreview.js","sourceRoot":"","sources":["../../src/workspace/matchContentPreview.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,oBAAoB;AACpB,EAAE;AACF,wEAAwE;AACxE,mFAAmF;AACnF,0EAA0E;AAC1E,qEAAqE;AACrE,2EAA2E;AAa3E;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,KAAa;IAEb,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,SAAS,CAAC;QACR,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,MAAM;QACxB,MAAM,GAAG,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5B,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/workspace/matchWorkspaceFiles.d.ts

@@ -0,0 +1,30 @@
+import type { WorkspaceFileEntry } from "./WorkspaceFileLister.js";
+/**
+ * A workspace file that matched a search query.
+ *
+ * `matchStart`/`matchEnd` are code-unit offsets into `path` (a half-open
+ * `[start, end)` range) for the single contiguous substring hit, so a consumer
+ * can highlight exactly the matched span with `path.slice(...)`.
+ */
+export interface WorkspaceFileMatch {
+    /** Repo-relative (git) or root-relative (local) path of the matched file. */
+    readonly path: string;
+    /** Inclusive start offset of the matched substring within `path`. */
+    readonly matchStart: number;
+    /** Exclusive end offset of the matched substring within `path`. */
+    readonly matchEnd: number;
+}
+/**
+ * Ranks a flat listing against a query, returning matched files best-first.
+ *
+ * - Case-insensitive substring on the full relative path.
+ * - Directories and advisory `notice` entries are never matched (a defensive
+ *   guard even though the shared cache already strips notices — DD-11).
+ * - Empty/whitespace query returns `[]` (search shows a hint, not everything).
+ *
+ * Ranking, in order: a basename hit outranks a path-only hit; then an earlier
+ * match offset; then a shorter path; then lexicographic path for a stable,
+ * deterministic order.
+ */
+export declare function matchWorkspaceFiles(files: readonly WorkspaceFileEntry[], query: string): WorkspaceFileMatch[];
+//# sourceMappingURL=matchWorkspaceFiles.d.ts.map

package/workspace/matchWorkspaceFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchWorkspaceFiles.d.ts","sourceRoot":"","sources":["../../src/workspace/matchWorkspaceFiles.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,kBAAkB,EAAE,EACpC,KAAK,EAAE,MAAM,GACZ,kBAAkB,EAAE,CA6BtB"}

package/workspace/matchWorkspaceFiles.js

@@ -0,0 +1,58 @@
+// Pure ranking function behind workspace search. Kept separate from the hook and
+// component so the matching/ranking rules are exhaustively unit-testable in
+// isolation (no React, no async).
+//
+// Match semantics intentionally mirror `internal/file-tree/filterFileTree` —
+// case-insensitive substring — but widened from a node's basename to the full
+// relative path, so `foo/bar` is findable and directory context is searchable
+// (DD-10). The trivial predicate is not extracted into a shared micro-module; a
+// cross-reference comment is the lower-coupling, honest choice.
+/**
+ * Ranks a flat listing against a query, returning matched files best-first.
+ *
+ * - Case-insensitive substring on the full relative path.
+ * - Directories and advisory `notice` entries are never matched (a defensive
+ *   guard even though the shared cache already strips notices — DD-11).
+ * - Empty/whitespace query returns `[]` (search shows a hint, not everything).
+ *
+ * Ranking, in order: a basename hit outranks a path-only hit; then an earlier
+ * match offset; then a shorter path; then lexicographic path for a stable,
+ * deterministic order.
+ */
+export function matchWorkspaceFiles(files, query) {
+    const trimmed = query.trim();
+    if (trimmed.length === 0)
+        return [];
+    const needle = trimmed.toLowerCase();
+    const ranked = [];
+    for (const file of files) {
+        if (file.isDirectory || file.notice)
+            continue;
+        const matchStart = file.path.toLowerCase().indexOf(needle);
+        if (matchStart === -1)
+            continue;
+        const lastSlash = file.path.lastIndexOf("/");
+        ranked.push({
+            path: file.path,
+            matchStart,
+            matchEnd: matchStart + needle.length,
+            isBasenameHit: matchStart >= lastSlash + 1,
+        });
+    }
+    ranked.sort(compareMatches);
+    return ranked.map(({ path, matchStart, matchEnd }) => ({
+        path,
+        matchStart,
+        matchEnd,
+    }));
+}
+function compareMatches(a, b) {
+    if (a.isBasenameHit !== b.isBasenameHit)
+        return a.isBasenameHit ? -1 : 1;
+    if (a.matchStart !== b.matchStart)
+        return a.matchStart - b.matchStart;
+    if (a.path.length !== b.path.length)
+        return a.path.length - b.path.length;
+    return a.path.localeCompare(b.path);
+}
+//# sourceMappingURL=matchWorkspaceFiles.js.map

package/workspace/matchWorkspaceFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchWorkspaceFiles.js","sourceRoot":"","sources":["../../src/workspace/matchWorkspaceFiles.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4EAA4E;AAC5E,kCAAkC;AAClC,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,gEAAgE;AA0BhE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAoC,EACpC,KAAa;IAEb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM;YAAE,SAAS;QAE9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,UAAU,KAAK,CAAC,CAAC;YAAE,SAAS;QAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU;YACV,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM;YACpC,aAAa,EAAE,UAAU,IAAI,SAAS,GAAG,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE5B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI;QACJ,UAAU;QACV,QAAQ;KACT,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,cAAc,CAAC,CAAc,EAAE,CAAc;IACpD,IAAI,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,aAAa;QAAE,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;IACtE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1E,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/workspace/resolveWorkspaceFileSelection.d.ts

@@ -0,0 +1,19 @@
+import type { SelectedWorkspaceFile } from "../internal/store/workspace-file-selection-store.js";
+import type { WorkspaceEntry } from "./useWorkspaceEntries.js";
+/**
+ * Resolves a transcript tool-call file path to the {@link SelectedWorkspaceFile}
+ * that opens it in the read-only Viewer, or `null` when it cannot be resolved to
+ * a definite repo/root-relative file (caller keeps copy/GitHub-link fallback).
+ *
+ * `entries` are the client-side workspace entries (`useWorkspaceEntries`), the
+ * same list the Viewer resolves against, so the returned `entryId` is directly
+ * usable. `sandboxWorkspaceRoot` (when the session has git-repo entries, e.g.
+ * `/home/daytona/workspace`) is stripped first so cloud-absolute paths reduce to
+ * workspace-relative before per-entry anchoring.
+ *
+ * The result `path` is guaranteed to match what the file tree / lister emits for
+ * the same file, so opening from the transcript and from the tree produce an
+ * identical selection (and hit the same content fetch/cache).
+ */
+export declare function resolveWorkspaceFileSelection(path: string, entries: readonly WorkspaceEntry[], sandboxWorkspaceRoot?: string): SelectedWorkspaceFile | null;
+//# sourceMappingURL=resolveWorkspaceFileSelection.d.ts.map

package/workspace/resolveWorkspaceFileSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWorkspaceFileSelection.d.ts","sourceRoot":"","sources":["../../src/workspace/resolveWorkspaceFileSelection.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAmB/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,oBAAoB,CAAC,EAAE,MAAM,GAC5B,qBAAqB,GAAG,IAAI,CAiD9B"}

package/workspace/resolveWorkspaceFileSelection.js

@@ -0,0 +1,115 @@
+// Resolve a transcript tool-call file path to an openable workspace-file
+// selection. This is the seam that lets a click on a path in the message thread
+// route to the same read-only Viewer a file-tree click drives (Slice 3).
+//
+// The hard part is NOT identity ("which entry") but PATH FORM. The reader and
+// lister contracts are strict: `WorkspaceFileReader` / the GitHub Trees lister
+// speak repo-root-relative (git) or root-relative (local) paths — the exact
+// strings a file-tree node carries. Transcript tool-call paths are not
+// guaranteed to be in that form: depending on harness and workspace layout they
+// arrive workspace-relative, subdir-prefixed, or absolute (see
+// `execution/file-review-status.ts` `changeForRowPath`, which documents the
+// same variance and treats path matching as presentation-only).
+//
+// Rather than fuzzy-match, this resolver normalizes deterministically using only
+// anchors the client already holds, grounded in how the runner provisions the
+// workspace (`backend/.../workspace/provisioner.ts`):
+//   - Single entry  -> cloned at the workspace root, so a (humanized) tool-call
+//                      path is already repo/root-relative. Identity transform.
+//   - Multiple git  -> each cloned into `<root>/<entry.name>/`, so the path is
+//                      prefixed by the subdir name; strip it.
+//   - Local (desktop) -> the native reader joins `entry.localPath` + a
+//                      root-relative path; local tool paths may be absolute, so
+//                      strip the known `entry.localPath` prefix.
+//   - Cloud absolute -> strip the known `sandboxWorkspaceRoot` first.
+// Anything that does not resolve to a definite relative path returns `null` so
+// the caller keeps its existing copy/GitHub-link behavior — a wrong file can
+// never open. Extending this to arbitrary/absolute paths belongs to a later
+// slice that resolves against the authoritative file-tree index.
+import { classifyPath } from "../execution/file-path-resolver.js";
+/** Forward-slash-normalize and drop any leading slashes for prefix comparison. */
+function normalize(path) {
+    return path.replace(/\\/g, "/").replace(/^\/+/, "");
+}
+/**
+ * Returns the portion of `path` beneath `anchor`, or `null` when `path` does
+ * not sit under `anchor`. An exact match (the anchor itself, a directory) yields
+ * `""` — the caller rejects it, since a directory is not a viewable file.
+ */
+function relativeTo(path, anchor) {
+    if (!anchor)
+        return null;
+    if (path === anchor)
+        return "";
+    if (path.startsWith(anchor + "/"))
+        return path.slice(anchor.length + 1);
+    return null;
+}
+/**
+ * Resolves a transcript tool-call file path to the {@link SelectedWorkspaceFile}
+ * that opens it in the read-only Viewer, or `null` when it cannot be resolved to
+ * a definite repo/root-relative file (caller keeps copy/GitHub-link fallback).
+ *
+ * `entries` are the client-side workspace entries (`useWorkspaceEntries`), the
+ * same list the Viewer resolves against, so the returned `entryId` is directly
+ * usable. `sandboxWorkspaceRoot` (when the session has git-repo entries, e.g.
+ * `/home/daytona/workspace`) is stripped first so cloud-absolute paths reduce to
+ * workspace-relative before per-entry anchoring.
+ *
+ * The result `path` is guaranteed to match what the file tree / lister emits for
+ * the same file, so opening from the transcript and from the tree produce an
+ * identical selection (and hit the same content fetch/cache).
+ */
+export function resolveWorkspaceFileSelection(path, entries, sandboxWorkspaceRoot) {
+    if (!path || entries.length === 0)
+        return null;
+    // 1. Reduce a cloud-absolute path to workspace-relative using the known root.
+    let work = normalize(path);
+    if (sandboxWorkspaceRoot) {
+        const root = normalize(sandboxWorkspaceRoot);
+        const relToRoot = relativeTo(work, root);
+        if (relToRoot !== null)
+            work = relToRoot;
+    }
+    // The bare workspace root ("" after stripping, or the humanized ".") is not a
+    // file.
+    if (!work || work === ".")
+        return null;
+    // 2. The platform mount (`.stigmer/…`) is a virtual namespace, not a workspace
+    //    file — checked after the root strip so an absolute `<root>/.stigmer/…`
+    //    is caught too. Keep copy behavior for it.
+    if (classifyPath(work).kind === "platform")
+        return null;
+    // 3. Anchor on the exact per-entry roots the client holds. Local entries
+    //    anchor on their absolute `localPath`; multi-entry git repos anchor on the
+    //    provisioning subdir (`entry.name`). A single git entry is cloned at the
+    //    root, so it falls through to step 4.
+    const isMulti = entries.length > 1;
+    for (const entry of entries) {
+        let anchor = null;
+        if (entry.type === "local" && entry.localPath) {
+            anchor = normalize(entry.localPath);
+        }
+        else if (entry.type === "git" && isMulti) {
+            anchor = normalize(entry.name);
+        }
+        if (anchor === null)
+            continue;
+        const rel = relativeTo(work, anchor);
+        // Exact match is the entry's own root directory, not a viewable file — stop
+        // rather than fall through to the single-entry fallback (which would return
+        // the raw root path).
+        if (rel === "")
+            return null;
+        if (rel)
+            return { entryId: entry.id, path: rel };
+    }
+    // 4. A single entry whose anchor did not apply (e.g. a git repo at the root, or
+    //    a local path already root-relative): the path is already repo/root-relative.
+    if (entries.length === 1) {
+        return { entryId: entries[0].id, path: work };
+    }
+    // 5. Multi-entry with no anchor match: refuse to guess which entry owns it.
+    return null;
+}
+//# sourceMappingURL=resolveWorkspaceFileSelection.js.map

package/workspace/resolveWorkspaceFileSelection.js.map

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

package/workspace/useWorkspaceContentSearch.d.ts

@@ -0,0 +1,69 @@
+import type { WorkspaceEntry } from "./useWorkspaceEntries.js";
+import type { WorkspaceContentMatch, WorkspaceContentSearcher } from "./WorkspaceContentSearcher.js";
+/** Options for {@link useWorkspaceContentSearch}. */
+export interface UseWorkspaceContentSearchOptions {
+    /** All workspace entries to search across. */
+    readonly entries: readonly WorkspaceEntry[];
+    /** Platform-injected content searcher. `undefined` → content search is unavailable. */
+    readonly searcher: WorkspaceContentSearcher | undefined;
+    /** Current search query. Trimmed; below {@link minLength} yields no search. */
+    readonly query: string;
+    /** Debounce delay for query changes in milliseconds. @default 300 */
+    readonly debounceMs?: number;
+    /** Minimum trimmed query length before a search runs. @default 2 */
+    readonly minLength?: number;
+}
+/** Content-search hits (and per-entry status) for one workspace entry. */
+export interface WorkspaceContentSearchGroup {
+    /** The workspace entry these matches belong to. */
+    readonly entry: WorkspaceEntry;
+    /** Line-level matches within this entry, backend-ordered (path, then line). */
+    readonly matches: readonly WorkspaceContentMatch[];
+    /** `true` when this entry's search was capped (more matches exist than shown). */
+    readonly truncated: boolean;
+    /** Search error for this entry, if any (isolated — other entries still resolve). */
+    readonly error: Error | null;
+}
+/** Return value of {@link useWorkspaceContentSearch}. */
+export interface UseWorkspaceContentSearchReturn {
+    /** Entries with something to show (matches, an error, or a truncation notice). */
+    readonly groups: readonly WorkspaceContentSearchGroup[];
+    /** Total matches across all groups (for a "showing N of M" affordance). */
+    readonly totalMatches: number;
+    /** `true` during the first search of a query with no prior results to show. */
+    readonly isLoading: boolean;
+    /** `true` while a new query loads *over* previously-shown results (no blank flash). */
+    readonly isRefetching: boolean;
+    /** `true` when no substrate can be searched (no searcher, or every entry unsupported). */
+    readonly isUnsupported: boolean;
+    /** First per-entry error, for a top-level fallback message. `null` when none. */
+    readonly error: Error | null;
+}
+/**
+ * Behavior hook powering workspace-wide content (text) search.
+ *
+ * The text-grep sibling of
+ * {@link useWorkspaceFileSearch}: it keeps
+ * that hook's per-entry aggregation, error isolation, and generation guard, and
+ * adds the platform's canonical debounce idiom from `useResourceSearch`
+ * (`query`/`debouncedQuery` + `setTimeout`). The key difference is that the
+ * debounced query is part of the *fetch* — each keystroke hits disk via the
+ * injected {@link WorkspaceContentSearcher}, uncached — so a `minLength` guard
+ * and a debounce protect the filesystem.
+ *
+ * Prior results stay visible while a new debounced query loads (`isRefetching`
+ * true, results unchanged); only the very first search with nothing to show
+ * flips `isLoading`. This avoids a per-keystroke blank flash the cached filename
+ * search never had.
+ *
+ * @example
+ * ```tsx
+ * const { groups, totalMatches, isRefetching } = useWorkspaceContentSearch({
+ *   entries: workspace.entries,
+ *   searcher: workspaceContentSearcher,
+ *   query,
+ * });
+ * ```
+ */
+export declare function useWorkspaceContentSearch({ entries, searcher, query, debounceMs, minLength, }: UseWorkspaceContentSearchOptions): UseWorkspaceContentSearchReturn;
+//# sourceMappingURL=useWorkspaceContentSearch.d.ts.map

package/workspace/useWorkspaceContentSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkspaceContentSearch.d.ts","sourceRoot":"","sources":["../../src/workspace/useWorkspaceContentSearch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AAavC,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACxD,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,0EAA0E;AAC1E,MAAM,WAAW,2BAA2B;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,WAAW,+BAA+B;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACxD,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,uFAAuF;IACvF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,0FAA0F;IAC1F,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,OAAO,EACP,QAAQ,EACR,KAAK,EACL,UAAgC,EAChC,SAA8B,GAC/B,EAAE,gCAAgC,GAAG,+BAA+B,CA4HpE"}