@opencraw/studio 0.0.31 → 0.0.33

package/dist/page-snapshot/blocked-page.algorithm.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Whether a page is the site's bot check or an access-denied page instead of its content, and, if so, what to tell the person: the
+ * Studio's browser was turned away, so everything else on the screen is not the page they asked for.
+ *
+ * @param text - The page's title and the start of its visible text.
+ * @param status - The HTTP status the page came with, when known.
+ * @returns A sentence for the person, or `undefined` when the page looks like a page.
+ */
+export declare function blockedPageNotice(text: string, status?: number): string | undefined;
+//# sourceMappingURL=blocked-page.algorithm.d.ts.map

package/dist/page-snapshot/consent-banner.algorithm.d.ts

@@ -0,0 +1,23 @@
+/** The attribute a pop-up that covers the page is marked with in the snapshot; the picture leaves it out unless "Show hidden" is on. */
+export declare const OVERLAY_ATTRIBUTE = "data-oc-overlay";
+/**
+ * A script that, in a page, finds a cookie or consent banner's button and presses it: "Reject all", "Only necessary cookies" and the
+ * like first, else "Accept all", "I agree"... in English, Portuguese, Spanish, French, Italian, German and Dutch, and by the ids the common
+ * consent tools give their buttons (OneTrust, Didomi, Cookiebot, Usercentrics, Osano, iubenda). A banner that is left in place covers the
+ * page in the Studio's view of it, and the Studio's own clicks (to pick a value) would land on it. Only buttons whose whole text is one
+ * of these are pressed, so a "Cookie settings" or "Gerir os cookies" button, a link to a policy and the page's own buttons are left alone.
+ * The answer is the text of the button pressed, or an empty string when there was none.
+ *
+ * It only ever runs in the browser the Studio captures the page with, never in a crawl.
+ */
+export declare const DISMISS_CONSENT_SCRIPT: string;
+/**
+ * A script that marks, in the page, every pop-up that covers it: something fixed to the window that fills most of it (a dimming backdrop,
+ * a modal), a modal dialog, or a banner a consent tool put there. The picture of the page leaves them out (the page behind is what the
+ * person wants to pick from), and "Show hidden" brings them back. Run after the consent button has been tried: a banner that went away
+ * needs nothing, one that stayed (its button in a form the script does not know, an icon with no text) is covered here.
+ *
+ * Only the outermost element of an overlay is marked, since hiding it hides all it holds.
+ */
+export declare const MARK_OVERLAYS_SCRIPT = "(() => {\n  const attribute = 'data-oc-overlay'\n  const consentName = /cookie|consent|gdpr|privacy|onetrust|ot-sdk|didomi|cookiebot|usercentrics|trustarc|truste|osano|iubenda|cmp|banner-modal/i\n  const width = window.innerWidth\n  const height = window.innerHeight\n  const marked = []\n  for (const element of document.querySelectorAll('body *')) {\n    if (marked.some((outer) => outer.contains(element))) continue\n    const style = getComputedStyle(element)\n    if (style.position !== 'fixed' || style.display === 'none' || style.visibility === 'hidden') continue\n    const box = element.getBoundingClientRect()\n    if (box.width === 0 || box.height === 0) continue\n    const covers = box.width >= width * 0.6 && box.height >= height * 0.5\n    const modal = element.getAttribute('aria-modal') === 'true' || element.getAttribute('role') === 'dialog' || element.getAttribute('role') === 'alertdialog'\n    const named = consentName.test((element.id || '') + ' ' + (typeof element.className === 'string' ? element.className : ''))\n    // A page built as one fixed, scrolling frame is the page, not a pop-up on it.\n    if (covers && !modal && !named && (element.innerText || '').length > document.body.innerText.length * 0.6) continue\n    // A bar along an edge (a site's own header or footer) is not a pop-up unless a consent tool named it.\n    if (covers || modal || named) {\n      element.setAttribute(attribute, '1')\n      marked.push(element)\n    }\n  }\n\n  return marked.length\n})()";
+//# sourceMappingURL=consent-banner.algorithm.d.ts.map

package/dist/page-snapshot/detect-url.use-case.d.ts

@@ -0,0 +1,13 @@
+/** What an address returns, in the engine's own words (`html` is a page; anything else is a document it reads), or `unknown` when it cannot be fetched. */
+export type UrlKind = 'html' | 'json' | 'jsonl' | 'text' | 'pdf' | 'csv' | 'xlsx' | 'pptx' | 'yaml' | 'markdown' | 'xml' | 'docx' | 'unknown';
+/**
+ * What an address returns: the format the engine reads its response as (content type, then what the first bytes
+ * show, then the file extension in the address), and, for an API that serves JSON as `text/plain` (common), JSON when
+ * the text starts like an object or an array. Only the start of the response is read: a large file is not downloaded.
+ * An address that cannot be fetched is `unknown`; the recipe started from it then reports why on its first snapshot.
+ *
+ * @param url - The address.
+ * @returns The kind: `html` is a page to open in a browser, anything else a document to read.
+ */
+export declare function detectUrlKind(url: string): Promise<UrlKind>;
+//# sourceMappingURL=detect-url.use-case.d.ts.map

package/dist/page-snapshot/index.d.ts

@@ -1,6 +1,10 @@
+export { detectUrlKind } from './detect-url.use-case';
+export type { UrlKind } from './detect-url.use-case';
 export { fetchStartPage } from './fetch-start-page.use-case';
 export { takeSnapshot } from './take-snapshot.use-case';
 export type { SnapshotResult } from './take-snapshot.use-case';
+export { inlineLocalImages } from './inline-local-images.use-case';
+export type { InlinedImages } from './inline-local-images.use-case';
 export { rewriteDocument } from './rewrite-document.mapper';
 export type { RewrittenDocument } from './rewrite-document.mapper';
 export { hiddenMarksScript, HIDDEN_ATTRIBUTE } from './hidden-marks.algorithm';

package/dist/page-snapshot/inline-assets.mapper.d.ts

@@ -0,0 +1,29 @@
+/** A stylesheet or font the page loaded, as the capture browser received it. */
+export interface CapturedAsset {
+    kind: 'css' | 'font';
+    /** The bytes; text for a stylesheet. */
+    body: Uint8Array;
+}
+/**
+ * A stylesheet's text with every `url(...)` made absolute, and each font the page loaded embedded as a data address. The picture of a page
+ * is shown in a frame that is not the site, so a font file is a cross-site request the site's server does not allow: its text comes
+ * out in a fallback face and its icons (a menu, a close button) as empty boxes. A font inside the page cannot be refused.
+ *
+ * @param css - The stylesheet text.
+ * @param base - Where the stylesheet came from (or the page, for a `<style>` in it).
+ * @param assets - What the page loaded, by address.
+ * @returns The stylesheet, ready to sit inside the snapshot.
+ */
+export declare function embedFonts(css: string, base: string, assets: ReadonlyMap<string, CapturedAsset>): string;
+/**
+ * Turns a captured page into one that carries its own styles: every `<link rel="stylesheet">` the page loaded becomes a `<style>` with
+ * the stylesheet's text, and the fonts in it (and in the page's own `<style>`s) are embedded. A stylesheet that was not captured is left
+ * as the link it was.
+ *
+ * @param html - The page as captured.
+ * @param pageUrl - The page's address.
+ * @param assets - The stylesheets and fonts the page loaded, by address.
+ * @returns The page with its styles and fonts inside it.
+ */
+export declare function inlineAssets(html: string, pageUrl: string, assets: ReadonlyMap<string, CapturedAsset>): string;
+//# sourceMappingURL=inline-assets.mapper.d.ts.map

package/dist/page-snapshot/inline-local-images.use-case.d.ts

@@ -0,0 +1,19 @@
+/** What `inlineLocalImages` made of a document. */
+export interface InlinedImages {
+    html: string;
+    /** How many images were embedded. */
+    inlined: number;
+    /** How many pictures could not be found next to the file (or were too big), so they stay as they were. */
+    missing: number;
+}
+/**
+ * A document read from a file (a Markdown file, say) names its pictures by paths beside it, which the browser showing it cannot open. The
+ * pictures that sit in the document's own folder are embedded in the page as data addresses, so they show; ones that are not there are counted
+ * so the person is told. Nothing outside the document's folder is ever read.
+ *
+ * @param html - The document as HTML, its addresses already made absolute against `documentUrl`.
+ * @param documentUrl - The document's own `file:` address.
+ * @returns The page with the pictures embedded, and how many were embedded and how many could not be.
+ */
+export declare function inlineLocalImages(html: string, documentUrl: string): Promise<InlinedImages>;
+//# sourceMappingURL=inline-local-images.use-case.d.ts.map

package/dist/page-snapshot/take-snapshot.use-case.d.ts

@@ -15,6 +15,8 @@ export interface SnapshotResult {
      * snapshot no longer has by the time it is cached.
      */
     rawHtml: string;
+    /** Something to tell the person about the page: it is a bot check or an access-denied page, not the content. */
+    notice?: string;
     /**
      * The format `http.client.ts` read the body as (api mode only; `undefined`
      * in web mode, whose document is always HTML) — what the content pane

package/dist/recipe-workspace/import-document.use-case.d.ts

@@ -1,7 +1,7 @@
 export interface ImportedDocument {
     /** The copy's path on disk, inside `folder`. */
     path: string;
-    /** The copy as a `file:` URL: what the recipe's `start.url` becomes. */
+    /** The copy as a `file:` URL relative to the folder (`file:report.pdf`): what the recipe's `start.url` becomes, so the folder can be moved or shared. */
     url: string;
 }
 /**
@@ -9,8 +9,10 @@ export interface ImportedDocument {
  * `file:` URL the same way a run would read any downloaded file (core's
  * `HttpClient` handles `file:` itself). The folder is created when missing,
  * so dropping a file is also a way to start a workspace. A name already in
- * the folder is never overwritten: the copy gets the next free numbered
- * name (`report-2.pdf`), and the returned `path`/`url` say which.
+ * the folder is never overwritten: a file there with the very same bytes is
+ * reused (loading one document twice leaves one copy), a different one gets
+ * the next free numbered name (`report-2.pdf`); the returned `path`/`url`
+ * say which.
  *
  * @param folder - The workspace folder; created (recursively) when it does not exist.
  * @param name - The file's own name, no directories: the copy keeps it, extension included.

package/dist/selector-inference/selector-ranking.policy.d.ts

@@ -14,7 +14,7 @@ export interface RankedCandidate extends SelectorCandidate {
  * Ordering: candidates that do not match `targetNodeId` (when given) sort
  * last; among the rest, best tier first, and within a tier the fewest
  * matches first (the most specific selector that still hits the target).
- * A candidate matching nothing is dropped entirely: it is not a real option.
+ * Equal on all that, the selector naming more ids and classes comes first. A candidate matching nothing is dropped entirely: it is not a real option.
  *
  * @param html - The document to verify against (the snapshot, or the live page for the second, cross-check pass).
  * @param candidates - Unranked candidates, e.g. from `candidatesFor`.

package/dist/src/document-view/index.d.ts

@@ -8,6 +8,6 @@ export { previewDeckTable, previewGridTable, previewPdfTable } from './table-pre
 export type { DeckTablePreviewMatch, DeckTablePreviewOptions, DeckTablePreviewResult, GridTablePreviewMatch, GridTablePreviewOptions, GridTablePreviewResult, TablePreviewMatch, TablePreviewOptions, TablePreviewResult } from './table-preview.use-case.js';
 export { previewRegion } from './region-preview.use-case.js';
 export type { RegionPreviewResult, RegionPreviewMatch } from './region-preview.use-case.js';
-export { workbookDocumentView } from './workbook-view.mapper.js';
+export { workbookDocumentView, workbookSheetRows } from './workbook-view.mapper.js';
 export type { GridCellType, GridCellView, GridMergeView, GridSheetView, WorkbookDocumentView } from './workbook-view.mapper.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/document-view/workbook-view.mapper.d.ts

@@ -22,7 +22,10 @@ export interface GridSheetView {
     hiddenRows: number[];
     /** The widest row's own length, ragged rows included — for the grid to size its columns. */
     columnCount: number;
+    /** The sheet's rows; only the first window of them when `rowCount` is set (the rest are fetched with `grid-rows`). */
     rows: GridCellView[][];
+    /** How many rows the sheet has, set only when `rows` holds just the first window of them. */
+    rowCount?: number;
     merges: GridMergeView[];
     /** Column widths in characters by 0-based column, as the spreadsheet stores them; absent keys are columns the file does not size. */
     columnWidths?: Record<string, number>;
@@ -55,5 +58,18 @@ export interface WorkbookDocumentView {
  * @param document - The read workbook (a spreadsheet or a CSV).
  * @returns The view.
  */
-export declare function workbookDocumentView(document: WorkbookDocument): WorkbookDocumentView;
+export declare function workbookDocumentView(document: WorkbookDocument, options?: {
+    windowRows?: number;
+}): WorkbookDocumentView;
+/**
+ * A run of one sheet's rows, typed, for a grid that only holds the screens around where it is scrolled to (the rest of a big file is never
+ * sent to the browser until it is needed).
+ *
+ * @param document - The read workbook.
+ * @param sheetIndex - Which sheet, 0-based.
+ * @param from - The first row, 0-based.
+ * @param count - How many rows at most.
+ * @returns The rows (fewer at the end of the sheet, none past it).
+ */
+export declare function workbookSheetRows(document: WorkbookDocument, sheetIndex: number, from: number, count: number): GridCellView[][];
 //# sourceMappingURL=workbook-view.mapper.d.ts.map

package/dist/src/index.d.ts

@@ -9,6 +9,6 @@ export { runSample, loadRecipePair } from './sample-run/index.js';
 export type { RecipePair, SampleRunCallbacks, SampleRunHandle, SampleRunRecord, SampleRunRejected, SampleRunResult, SampleStepSummary, SampleStoppedBy } from './sample-run/index.js';
 export { fetchStartPage } from './page-snapshot/index.js';
 export type { WhyFacts, WhyStepFact } from './explain-why/index.js';
-export { sampleBudgetSchema, openWorkspaceCommandSchema, chooseFolderCommandSchema, openPathCommandSchema, importDocumentCommandSchema, runSampleCommandSchema, stopRunCommandSchema, saveRecipeCommandSchema, fetchStartPageCommandSchema, saveOutlineCommandSchema, takeSnapshotCommandSchema, verifySelectorCommandSchema, inferSelectorCommandSchema, missingWhyTargetSchema, rejectedWhyTargetSchema, whyTargetSchema, explainWhyCommandSchema, studioCommandSchema, chooseFolderViewSchema, openPathViewSchema, importDocumentViewSchema, stoppedBySchema, fieldTraceSchema, traceLineEventSchema, recordEventSchema, recordRejectedEventSchema, runFinishedEventSchema, workspaceChangedEventSchema, studioEventSchema, loadedHooksSchema, recipeIssueSchema, recipeListingSchema, workspaceViewSchema, sampleRunRecordSchema, sampleRunViewSchema, startPageViewSchema, snapshotViewSchema, verifySelectorViewSchema, fieldPickSchema, inferSelectorViewSchema, sentencePartSchema, outlineCardSchema, outlineBracketSchema, outlineNodeSchema, outlineViewSchema, whyViewSchema, inspectPageCommandSchema, responsesSeenCommandSchema, documentTreeCommandSchema, pdfViewCommandSchema, tablePreviewOptionsSchema, tablePreviewCommandSchema, regionPreviewCommandSchema, regionPreviewMatchSchema, regionPreviewViewSchema, gridViewCommandSchema, gridPreviewOptionsSchema, gridPreviewCommandSchema, deckViewCommandSchema, deckPreviewOptionsSchema, deckPreviewCommandSchema, domTreeNodeViewSchema, pageDataFindingSchema, inspectViewSchema, observedResponseSchema, responsesSeenViewSchema, documentTreeNodeViewSchema, documentTreeViewSchema, pdfCellViewSchema, pdfRowViewSchema, pdfPageViewSchema, pdfDocumentViewSchema, tablePreviewTableSchema, tablePreviewBandSchema, tablePreviewMatchSchema, tablePreviewViewSchema, gridCellViewSchema, gridMergeViewSchema, gridSheetViewSchema, workbookDocumentViewSchema, gridTablePreviewMatchSchema, gridTablePreviewViewSchema, deckShapeViewSchema, deckChartSeriesViewSchema, deckChartViewSchema, deckSlideViewSchema, deckDocumentViewSchema, deckTablePreviewMatchSchema, deckTablePreviewViewSchema, startRecordingCommandSchema, stopRecordingCommandSchema, recordingCardEventSchema, recordingNoteEventSchema, recordingStoppedEventSchema, } from './studio-api/index.js';
-export type { SampleBudget, OpenWorkspaceCommand, ChooseFolderCommand, OpenPathCommand, ImportDocumentCommand, RunSampleCommand, StopRunCommand, SaveRecipeCommand, FetchStartPageCommand, SaveOutlineCommand, TakeSnapshotCommand, VerifySelectorCommand, InferSelectorCommand, MissingWhyTarget, RejectedWhyTarget, WhyTarget, ExplainWhyCommand, InspectPageCommand, ResponsesSeenCommand, DocumentTreeCommand, PdfViewCommand, TablePreviewOptions, TablePreviewCommand, RegionPreviewCommand, GridViewCommand, GridPreviewOptions, GridPreviewCommand, DeckViewCommand, DeckPreviewOptions, DeckPreviewCommand, StudioCommand, ChooseFolderView, OpenPathView, ImportDocumentView, RegionPreviewMatchView, RegionPreviewView, StoppedBy, FieldTraceView, TraceLineEvent, RecordEvent, RecordRejectedEvent, RunFinishedEvent, WorkspaceChangedEvent, StudioEvent, LoadedHooks, RecipeIssue, RecipeListing, WorkspaceView, SampleRunView, StartPageView, SnapshotView, VerifySelectorView, FieldPick, InferSelectorView, SentencePart, OutlineCard, OutlineBracket, OutlineNode, OutlineView, WhyView, DomTreeNodeView, PageDataKind, PageDataFindingView, InspectView, ObservedResponseView, ResponsesSeenView, DocumentTreeNodeView, DocumentTreeView, PdfCellView, PdfRowView, PdfPageView, PdfDocumentView, TablePreviewTableView, TablePreviewBandView, TablePreviewMatchView, TablePreviewView, GridCellView, GridMergeView, GridSheetView, WorkbookDocumentView, GridTablePreviewMatchView, GridTablePreviewView, DeckShapeView, DeckChartSeriesView, DeckChartView, DeckSlideView, DeckDocumentView, DeckTablePreviewMatchView, DeckTablePreviewView, StartRecordingCommand, StopRecordingCommand, RecordingCardEvent, RecordingNoteEvent, RecordingStoppedEvent, } from './studio-api/index.js';
+export { sampleBudgetSchema, openWorkspaceCommandSchema, chooseFolderCommandSchema, openPathCommandSchema, importDocumentCommandSchema, runSampleCommandSchema, stopRunCommandSchema, saveRecipeCommandSchema, fetchStartPageCommandSchema, detectUrlCommandSchema, saveOutlineCommandSchema, takeSnapshotCommandSchema, verifySelectorCommandSchema, inferSelectorCommandSchema, missingWhyTargetSchema, rejectedWhyTargetSchema, whyTargetSchema, explainWhyCommandSchema, studioCommandSchema, chooseFolderViewSchema, openPathViewSchema, importDocumentViewSchema, stoppedBySchema, fieldTraceSchema, traceLineEventSchema, recordEventSchema, recordRejectedEventSchema, runFinishedEventSchema, workspaceChangedEventSchema, studioEventSchema, loadedHooksSchema, recipeIssueSchema, recipeListingSchema, workspaceViewSchema, sampleRunRecordSchema, sampleRunViewSchema, startPageViewSchema, detectUrlViewSchema, snapshotViewSchema, verifySelectorViewSchema, fieldPickSchema, inferSelectorViewSchema, selectorAlternativeSchema, sentencePartSchema, outlineCardSchema, outlineBracketSchema, outlineNodeSchema, outlineViewSchema, whyViewSchema, inspectPageCommandSchema, responsesSeenCommandSchema, documentTreeCommandSchema, pdfViewCommandSchema, tablePreviewOptionsSchema, tablePreviewCommandSchema, regionPreviewCommandSchema, regionPreviewMatchSchema, regionPreviewViewSchema, gridViewCommandSchema, gridRowsCommandSchema, gridPreviewOptionsSchema, gridPreviewCommandSchema, deckViewCommandSchema, deckPreviewOptionsSchema, deckPreviewCommandSchema, domTreeNodeViewSchema, pageDataFindingSchema, inspectViewSchema, observedResponseSchema, responsesSeenViewSchema, documentTreeNodeViewSchema, documentTreeViewSchema, pdfCellViewSchema, pdfRowViewSchema, pdfPageViewSchema, pdfDocumentViewSchema, tablePreviewTableSchema, tablePreviewBandSchema, tablePreviewMatchSchema, tablePreviewViewSchema, gridCellViewSchema, gridMergeViewSchema, gridRowsViewSchema, gridSheetViewSchema, workbookDocumentViewSchema, gridTablePreviewMatchSchema, gridTablePreviewViewSchema, deckShapeViewSchema, deckChartSeriesViewSchema, deckChartViewSchema, deckSlideViewSchema, deckDocumentViewSchema, deckTablePreviewMatchSchema, deckTablePreviewViewSchema, startRecordingCommandSchema, stopRecordingCommandSchema, recordingCardEventSchema, recordingNoteEventSchema, recordingStoppedEventSchema, } from './studio-api/index.js';
+export type { SampleBudget, OpenWorkspaceCommand, ChooseFolderCommand, OpenPathCommand, ImportDocumentCommand, RunSampleCommand, StopRunCommand, SaveRecipeCommand, FetchStartPageCommand, DetectUrlCommand, SaveOutlineCommand, TakeSnapshotCommand, VerifySelectorCommand, InferSelectorCommand, MissingWhyTarget, RejectedWhyTarget, WhyTarget, ExplainWhyCommand, InspectPageCommand, ResponsesSeenCommand, DocumentTreeCommand, PdfViewCommand, TablePreviewOptions, TablePreviewCommand, RegionPreviewCommand, GridViewCommand, GridRowsCommand, GridPreviewOptions, GridPreviewCommand, DeckViewCommand, DeckPreviewOptions, DeckPreviewCommand, StudioCommand, ChooseFolderView, OpenPathView, ImportDocumentView, RegionPreviewMatchView, RegionPreviewView, StoppedBy, FieldTraceView, TraceLineEvent, RecordEvent, RecordRejectedEvent, RunFinishedEvent, WorkspaceChangedEvent, StudioEvent, LoadedHooks, RecipeIssue, RecipeListing, WorkspaceView, SampleRunView, StartPageView, DetectUrlView, SnapshotView, VerifySelectorView, FieldPick, InferSelectorView, SelectorAlternative, SentencePart, OutlineCard, OutlineBracket, OutlineNode, OutlineView, WhyView, DomTreeNodeView, PageDataKind, PageDataFindingView, InspectView, ObservedResponseView, ResponsesSeenView, DocumentTreeNodeView, DocumentTreeView, PdfCellView, PdfRowView, PdfPageView, PdfDocumentView, TablePreviewTableView, TablePreviewBandView, TablePreviewMatchView, TablePreviewView, GridCellView, GridMergeView, GridRowsView, GridSheetView, WorkbookDocumentView, GridTablePreviewMatchView, GridTablePreviewView, DeckShapeView, DeckChartSeriesView, DeckChartView, DeckSlideView, DeckDocumentView, DeckTablePreviewMatchView, DeckTablePreviewView, StartRecordingCommand, StopRecordingCommand, RecordingCardEvent, RecordingNoteEvent, RecordingStoppedEvent, } from './studio-api/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/page-snapshot/blocked-page.algorithm.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Whether a page is the site's bot check or an access-denied page instead of its content, and, if so, what to tell the person: the
+ * Studio's browser was turned away, so everything else on the screen is not the page they asked for.
+ *
+ * @param text - The page's title and the start of its visible text.
+ * @param status - The HTTP status the page came with, when known.
+ * @returns A sentence for the person, or `undefined` when the page looks like a page.
+ */
+export declare function blockedPageNotice(text: string, status?: number): string | undefined;
+//# sourceMappingURL=blocked-page.algorithm.d.ts.map

package/dist/src/page-snapshot/consent-banner.algorithm.d.ts

@@ -0,0 +1,23 @@
+/** The attribute a pop-up that covers the page is marked with in the snapshot; the picture leaves it out unless "Show hidden" is on. */
+export declare const OVERLAY_ATTRIBUTE = "data-oc-overlay";
+/**
+ * A script that, in a page, finds a cookie or consent banner's button and presses it: "Reject all", "Only necessary cookies" and the
+ * like first, else "Accept all", "I agree"... in English, Portuguese, Spanish, French, Italian, German and Dutch, and by the ids the common
+ * consent tools give their buttons (OneTrust, Didomi, Cookiebot, Usercentrics, Osano, iubenda). A banner that is left in place covers the
+ * page in the Studio's view of it, and the Studio's own clicks (to pick a value) would land on it. Only buttons whose whole text is one
+ * of these are pressed, so a "Cookie settings" or "Gerir os cookies" button, a link to a policy and the page's own buttons are left alone.
+ * The answer is the text of the button pressed, or an empty string when there was none.
+ *
+ * It only ever runs in the browser the Studio captures the page with, never in a crawl.
+ */
+export declare const DISMISS_CONSENT_SCRIPT: string;
+/**
+ * A script that marks, in the page, every pop-up that covers it: something fixed to the window that fills most of it (a dimming backdrop,
+ * a modal), a modal dialog, or a banner a consent tool put there. The picture of the page leaves them out (the page behind is what the
+ * person wants to pick from), and "Show hidden" brings them back. Run after the consent button has been tried: a banner that went away
+ * needs nothing, one that stayed (its button in a form the script does not know, an icon with no text) is covered here.
+ *
+ * Only the outermost element of an overlay is marked, since hiding it hides all it holds.
+ */
+export declare const MARK_OVERLAYS_SCRIPT = "(() => {\n  const attribute = 'data-oc-overlay'\n  const consentName = /cookie|consent|gdpr|privacy|onetrust|ot-sdk|didomi|cookiebot|usercentrics|trustarc|truste|osano|iubenda|cmp|banner-modal/i\n  const width = window.innerWidth\n  const height = window.innerHeight\n  const marked = []\n  for (const element of document.querySelectorAll('body *')) {\n    if (marked.some((outer) => outer.contains(element))) continue\n    const style = getComputedStyle(element)\n    if (style.position !== 'fixed' || style.display === 'none' || style.visibility === 'hidden') continue\n    const box = element.getBoundingClientRect()\n    if (box.width === 0 || box.height === 0) continue\n    const covers = box.width >= width * 0.6 && box.height >= height * 0.5\n    const modal = element.getAttribute('aria-modal') === 'true' || element.getAttribute('role') === 'dialog' || element.getAttribute('role') === 'alertdialog'\n    const named = consentName.test((element.id || '') + ' ' + (typeof element.className === 'string' ? element.className : ''))\n    // A page built as one fixed, scrolling frame is the page, not a pop-up on it.\n    if (covers && !modal && !named && (element.innerText || '').length > document.body.innerText.length * 0.6) continue\n    // A bar along an edge (a site's own header or footer) is not a pop-up unless a consent tool named it.\n    if (covers || modal || named) {\n      element.setAttribute(attribute, '1')\n      marked.push(element)\n    }\n  }\n\n  return marked.length\n})()";
+//# sourceMappingURL=consent-banner.algorithm.d.ts.map

package/dist/src/page-snapshot/detect-url.use-case.d.ts

@@ -0,0 +1,13 @@
+/** What an address returns, in the engine's own words (`html` is a page; anything else is a document it reads), or `unknown` when it cannot be fetched. */
+export type UrlKind = 'html' | 'json' | 'jsonl' | 'text' | 'pdf' | 'csv' | 'xlsx' | 'pptx' | 'yaml' | 'markdown' | 'xml' | 'docx' | 'unknown';
+/**
+ * What an address returns: the format the engine reads its response as (content type, then what the first bytes
+ * show, then the file extension in the address), and, for an API that serves JSON as `text/plain` (common), JSON when
+ * the text starts like an object or an array. Only the start of the response is read: a large file is not downloaded.
+ * An address that cannot be fetched is `unknown`; the recipe started from it then reports why on its first snapshot.
+ *
+ * @param url - The address.
+ * @returns The kind: `html` is a page to open in a browser, anything else a document to read.
+ */
+export declare function detectUrlKind(url: string): Promise<UrlKind>;
+//# sourceMappingURL=detect-url.use-case.d.ts.map

package/dist/src/page-snapshot/index.d.ts

@@ -1,6 +1,10 @@
+export { detectUrlKind } from './detect-url.use-case.js';
+export type { UrlKind } from './detect-url.use-case.js';
 export { fetchStartPage } from './fetch-start-page.use-case.js';
 export { takeSnapshot } from './take-snapshot.use-case.js';
 export type { SnapshotResult } from './take-snapshot.use-case.js';
+export { inlineLocalImages } from './inline-local-images.use-case.js';
+export type { InlinedImages } from './inline-local-images.use-case.js';
 export { rewriteDocument } from './rewrite-document.mapper.js';
 export type { RewrittenDocument } from './rewrite-document.mapper.js';
 export { hiddenMarksScript, HIDDEN_ATTRIBUTE } from './hidden-marks.algorithm.js';

package/dist/src/page-snapshot/inline-assets.mapper.d.ts

@@ -0,0 +1,29 @@
+/** A stylesheet or font the page loaded, as the capture browser received it. */
+export interface CapturedAsset {
+    kind: 'css' | 'font';
+    /** The bytes; text for a stylesheet. */
+    body: Uint8Array;
+}
+/**
+ * A stylesheet's text with every `url(...)` made absolute, and each font the page loaded embedded as a data address. The picture of a page
+ * is shown in a frame that is not the site, so a font file is a cross-site request the site's server does not allow: its text comes
+ * out in a fallback face and its icons (a menu, a close button) as empty boxes. A font inside the page cannot be refused.
+ *
+ * @param css - The stylesheet text.
+ * @param base - Where the stylesheet came from (or the page, for a `<style>` in it).
+ * @param assets - What the page loaded, by address.
+ * @returns The stylesheet, ready to sit inside the snapshot.
+ */
+export declare function embedFonts(css: string, base: string, assets: ReadonlyMap<string, CapturedAsset>): string;
+/**
+ * Turns a captured page into one that carries its own styles: every `<link rel="stylesheet">` the page loaded becomes a `<style>` with
+ * the stylesheet's text, and the fonts in it (and in the page's own `<style>`s) are embedded. A stylesheet that was not captured is left
+ * as the link it was.
+ *
+ * @param html - The page as captured.
+ * @param pageUrl - The page's address.
+ * @param assets - The stylesheets and fonts the page loaded, by address.
+ * @returns The page with its styles and fonts inside it.
+ */
+export declare function inlineAssets(html: string, pageUrl: string, assets: ReadonlyMap<string, CapturedAsset>): string;
+//# sourceMappingURL=inline-assets.mapper.d.ts.map

package/dist/src/page-snapshot/inline-local-images.use-case.d.ts

@@ -0,0 +1,19 @@
+/** What `inlineLocalImages` made of a document. */
+export interface InlinedImages {
+    html: string;
+    /** How many images were embedded. */
+    inlined: number;
+    /** How many pictures could not be found next to the file (or were too big), so they stay as they were. */
+    missing: number;
+}
+/**
+ * A document read from a file (a Markdown file, say) names its pictures by paths beside it, which the browser showing it cannot open. The
+ * pictures that sit in the document's own folder are embedded in the page as data addresses, so they show; ones that are not there are counted
+ * so the person is told. Nothing outside the document's folder is ever read.
+ *
+ * @param html - The document as HTML, its addresses already made absolute against `documentUrl`.
+ * @param documentUrl - The document's own `file:` address.
+ * @returns The page with the pictures embedded, and how many were embedded and how many could not be.
+ */
+export declare function inlineLocalImages(html: string, documentUrl: string): Promise<InlinedImages>;
+//# sourceMappingURL=inline-local-images.use-case.d.ts.map

package/dist/src/page-snapshot/take-snapshot.use-case.d.ts

@@ -15,6 +15,8 @@ export interface SnapshotResult {
      * snapshot no longer has by the time it is cached.
      */
     rawHtml: string;
+    /** Something to tell the person about the page: it is a bot check or an access-denied page, not the content. */
+    notice?: string;
     /**
      * The format `http.client.ts` read the body as (api mode only; `undefined`
      * in web mode, whose document is always HTML) — what the content pane

package/dist/src/recipe-workspace/import-document.use-case.d.ts

@@ -1,7 +1,7 @@
 export interface ImportedDocument {
     /** The copy's path on disk, inside `folder`. */
     path: string;
-    /** The copy as a `file:` URL: what the recipe's `start.url` becomes. */
+    /** The copy as a `file:` URL relative to the folder (`file:report.pdf`): what the recipe's `start.url` becomes, so the folder can be moved or shared. */
     url: string;
 }
 /**
@@ -9,8 +9,10 @@ export interface ImportedDocument {
  * `file:` URL the same way a run would read any downloaded file (core's
  * `HttpClient` handles `file:` itself). The folder is created when missing,
  * so dropping a file is also a way to start a workspace. A name already in
- * the folder is never overwritten: the copy gets the next free numbered
- * name (`report-2.pdf`), and the returned `path`/`url` say which.
+ * the folder is never overwritten: a file there with the very same bytes is
+ * reused (loading one document twice leaves one copy), a different one gets
+ * the next free numbered name (`report-2.pdf`); the returned `path`/`url`
+ * say which.
  *
  * @param folder - The workspace folder; created (recursively) when it does not exist.
  * @param name - The file's own name, no directories: the copy keeps it, extension included.

package/dist/src/selector-inference/selector-ranking.policy.d.ts

@@ -14,7 +14,7 @@ export interface RankedCandidate extends SelectorCandidate {
  * Ordering: candidates that do not match `targetNodeId` (when given) sort
  * last; among the rest, best tier first, and within a tier the fewest
  * matches first (the most specific selector that still hits the target).
- * A candidate matching nothing is dropped entirely: it is not a real option.
+ * Equal on all that, the selector naming more ids and classes comes first. A candidate matching nothing is dropped entirely: it is not a real option.
  *
  * @param html - The document to verify against (the snapshot, or the live page for the second, cross-check pass).
  * @param candidates - Unranked candidates, e.g. from `candidatesFor`.

package/dist/src/studio-api/command.contract.d.ts

@@ -10,6 +10,11 @@ export declare const openWorkspaceCommandSchema: z.ZodObject<{
     type: z.ZodLiteral<"open-workspace">;
     folder: z.ZodString;
 }, z.core.$strip>;
+/** Says what a page address returns, so a recipe is started the right way: a JSON API is read with a request, a page with a browser. */
+export declare const detectUrlCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"detect-url">;
+    url: z.ZodString;
+}, z.core.$strip>;
 /** Says what a path is (folder, recipe or document) and where to open it: how a link or an IDE entry opens a path (issue #235). `workspace` is the folder a document should belong to, when the caller has one. */
 export declare const openPathCommandSchema: z.ZodObject<{
     type: z.ZodLiteral<"open-path">;
@@ -87,6 +92,7 @@ export declare const inferSelectorCommandSchema: z.ZodObject<{
     recipeId: z.ZodString;
     path: z.ZodString;
     nodeIds: z.ZodUnion<readonly [z.ZodTuple<[z.ZodString], null>, z.ZodTuple<[z.ZodString, z.ZodString], null>]>;
+    within: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * The Inspect panel's DOM tree and data-in-the-page findings, off the same
@@ -201,6 +207,18 @@ export declare const gridViewCommandSchema: z.ZodObject<{
     delimiter: z.ZodOptional<z.ZodString>;
     encoding: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * `grid-rows`: a run of one sheet's rows of a big CSV/spreadsheet, for the grid canvas that holds only the screens around where it is
+ * scrolled to. The first window comes with `grid-view`; the rest are asked for as the person scrolls.
+ */
+export declare const gridRowsCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"grid-rows">;
+    recipeId: z.ZodString;
+    path: z.ZodString;
+    sheet: z.ZodInt;
+    from: z.ZodInt;
+    count: z.ZodInt;
+}, z.core.$strip>;
 /** A `table` extract's options for a workbook, as the studio's grid canvas picks build them — mirrors `document-view/table-preview.use-case.ts`'s `GridTablePreviewOptions`. */
 export declare const gridPreviewOptionsSchema: z.ZodObject<{
     sheet: z.ZodOptional<z.ZodString>;
@@ -399,6 +417,9 @@ export declare const studioCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"fetch-start-page">;
     recipeId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"detect-url">;
+    url: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"save-outline">;
     path: z.ZodString;
@@ -417,6 +438,7 @@ export declare const studioCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     recipeId: z.ZodString;
     path: z.ZodString;
     nodeIds: z.ZodUnion<readonly [z.ZodTuple<[z.ZodString], null>, z.ZodTuple<[z.ZodString, z.ZodString], null>]>;
+    within: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"explain-why">;
     target: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -471,6 +493,13 @@ export declare const studioCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     path: z.ZodString;
     delimiter: z.ZodOptional<z.ZodString>;
     encoding: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"grid-rows">;
+    recipeId: z.ZodString;
+    path: z.ZodString;
+    sheet: z.ZodInt;
+    from: z.ZodInt;
+    count: z.ZodInt;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"grid-preview">;
     recipeId: z.ZodString;
@@ -523,6 +552,7 @@ export type RunSampleCommand = z.infer<typeof runSampleCommandSchema>;
 export type StopRunCommand = z.infer<typeof stopRunCommandSchema>;
 export type SaveRecipeCommand = z.infer<typeof saveRecipeCommandSchema>;
 export type FetchStartPageCommand = z.infer<typeof fetchStartPageCommandSchema>;
+export type DetectUrlCommand = z.infer<typeof detectUrlCommandSchema>;
 export type SaveOutlineCommand = z.infer<typeof saveOutlineCommandSchema>;
 export type TakeSnapshotCommand = z.infer<typeof takeSnapshotCommandSchema>;
 export type VerifySelectorCommand = z.infer<typeof verifySelectorCommandSchema>;
@@ -535,6 +565,7 @@ export type TablePreviewOptions = z.infer<typeof tablePreviewOptionsSchema>;
 export type TablePreviewCommand = z.infer<typeof tablePreviewCommandSchema>;
 export type RegionPreviewCommand = z.infer<typeof regionPreviewCommandSchema>;
 export type GridViewCommand = z.infer<typeof gridViewCommandSchema>;
+export type GridRowsCommand = z.infer<typeof gridRowsCommandSchema>;
 export type GridPreviewOptions = z.infer<typeof gridPreviewOptionsSchema>;
 export type GridPreviewCommand = z.infer<typeof gridPreviewCommandSchema>;
 export type DeckViewCommand = z.infer<typeof deckViewCommandSchema>;

package/dist/src/studio-api/deck-view.contract.d.ts

@@ -49,6 +49,7 @@ export declare const deckSlideViewSchema: z.ZodObject<{
                 date: "date";
             }>;
         }, z.core.$strip>>>;
+        rowCount: z.ZodOptional<z.ZodNumber>;
         merges: z.ZodArray<z.ZodObject<{
             ref: z.ZodString;
             top: z.ZodNumber;
@@ -103,6 +104,7 @@ export declare const deckDocumentViewSchema: z.ZodObject<{
                     date: "date";
                 }>;
             }, z.core.$strip>>>;
+            rowCount: z.ZodOptional<z.ZodNumber>;
             merges: z.ZodArray<z.ZodObject<{
                 ref: z.ZodString;
                 top: z.ZodNumber;

package/dist/src/studio-api/detect-url-view.contract.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/**
+ * `detect-url`'s answer: what the address returns, so "Load ▾ Web page" starts the right recipe: `html` is a page (opened in a
+ * browser); `json`, `pdf`, `csv`, `xlsx`, `markdown`, `xml`... are documents (read with a request); `unknown` when it could not be fetched.
+ */
+export declare const detectUrlViewSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        unknown: "unknown";
+        text: "text";
+        html: "html";
+        json: "json";
+        jsonl: "jsonl";
+        pdf: "pdf";
+        csv: "csv";
+        xlsx: "xlsx";
+        pptx: "pptx";
+        yaml: "yaml";
+        markdown: "markdown";
+        xml: "xml";
+        docx: "docx";
+    }>;
+}, z.core.$strip>;
+export type DetectUrlView = z.infer<typeof detectUrlViewSchema>;
+//# sourceMappingURL=detect-url-view.contract.d.ts.map

package/dist/src/studio-api/grid-view.contract.d.ts

@@ -31,6 +31,7 @@ export declare const gridSheetViewSchema: z.ZodObject<{
             date: "date";
         }>;
     }, z.core.$strip>>>;
+    rowCount: z.ZodOptional<z.ZodNumber>;
     merges: z.ZodArray<z.ZodObject<{
         ref: z.ZodString;
         top: z.ZodNumber;
@@ -43,6 +44,18 @@ export declare const gridSheetViewSchema: z.ZodObject<{
     defaultColumnWidth: z.ZodOptional<z.ZodNumber>;
     defaultRowHeight: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+/** What `grid-rows` answers with: a run of one sheet's rows. */
+export declare const gridRowsViewSchema: z.ZodObject<{
+    rows: z.ZodArray<z.ZodArray<z.ZodObject<{
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            date: "date";
+        }>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 /** What `grid-view` answers with (studio plan §3.4, issue #94's 5c): every sheet's cells, typed, with hidden sheets/rows marked and merged ranges resolved, for the grid canvas to draw. */
 export declare const workbookDocumentViewSchema: z.ZodObject<{
     sheets: z.ZodArray<z.ZodObject<{
@@ -59,6 +72,7 @@ export declare const workbookDocumentViewSchema: z.ZodObject<{
                 date: "date";
             }>;
         }, z.core.$strip>>>;
+        rowCount: z.ZodOptional<z.ZodNumber>;
         merges: z.ZodArray<z.ZodObject<{
             ref: z.ZodString;
             top: z.ZodNumber;
@@ -76,6 +90,7 @@ export declare const workbookDocumentViewSchema: z.ZodObject<{
         delimiter: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export type GridRowsView = z.infer<typeof gridRowsViewSchema>;
 export type GridCellView = z.infer<typeof gridCellViewSchema>;
 export type GridMergeView = z.infer<typeof gridMergeViewSchema>;
 export type GridSheetView = z.infer<typeof gridSheetViewSchema>;

package/dist/src/studio-api/index.d.ts

@@ -1,11 +1,11 @@
-export { sampleBudgetSchema, openWorkspaceCommandSchema, chooseFolderCommandSchema, openPathCommandSchema, importDocumentCommandSchema, runSampleCommandSchema, stopRunCommandSchema, saveRecipeCommandSchema, fetchStartPageCommandSchema, saveOutlineCommandSchema, takeSnapshotCommandSchema, verifySelectorCommandSchema, inferSelectorCommandSchema, missingWhyTargetSchema, rejectedWhyTargetSchema, whyTargetSchema, explainWhyCommandSchema, inspectPageCommandSchema, responsesSeenCommandSchema, documentTreeCommandSchema, pdfViewCommandSchema, tablePreviewOptionsSchema, tablePreviewCommandSchema, regionPreviewCommandSchema, gridViewCommandSchema, gridPreviewOptionsSchema, gridPreviewCommandSchema, deckViewCommandSchema, deckPreviewOptionsSchema, deckPreviewCommandSchema, startRecordingCommandSchema, stopRecordingCommandSchema, studioCommandSchema } from './command.contract.js';
-export type { SampleBudget, OpenWorkspaceCommand, ChooseFolderCommand, OpenPathCommand, ImportDocumentCommand, RunSampleCommand, StopRunCommand, SaveRecipeCommand, FetchStartPageCommand, SaveOutlineCommand, TakeSnapshotCommand, VerifySelectorCommand, InferSelectorCommand, MissingWhyTarget, RejectedWhyTarget, WhyTarget, ExplainWhyCommand, InspectPageCommand, ResponsesSeenCommand, DocumentTreeCommand, PdfViewCommand, TablePreviewOptions, TablePreviewCommand, RegionPreviewCommand, GridViewCommand, GridPreviewOptions, GridPreviewCommand, DeckViewCommand, DeckPreviewOptions, DeckPreviewCommand, StartRecordingCommand, StopRecordingCommand, StudioCommand } from './command.contract.js';
+export { sampleBudgetSchema, openWorkspaceCommandSchema, chooseFolderCommandSchema, openPathCommandSchema, importDocumentCommandSchema, runSampleCommandSchema, stopRunCommandSchema, saveRecipeCommandSchema, fetchStartPageCommandSchema, detectUrlCommandSchema, saveOutlineCommandSchema, takeSnapshotCommandSchema, verifySelectorCommandSchema, inferSelectorCommandSchema, missingWhyTargetSchema, rejectedWhyTargetSchema, whyTargetSchema, explainWhyCommandSchema, inspectPageCommandSchema, responsesSeenCommandSchema, documentTreeCommandSchema, pdfViewCommandSchema, tablePreviewOptionsSchema, tablePreviewCommandSchema, regionPreviewCommandSchema, gridViewCommandSchema, gridRowsCommandSchema, gridPreviewOptionsSchema, gridPreviewCommandSchema, deckViewCommandSchema, deckPreviewOptionsSchema, deckPreviewCommandSchema, startRecordingCommandSchema, stopRecordingCommandSchema, studioCommandSchema } from './command.contract.js';
+export type { SampleBudget, OpenWorkspaceCommand, ChooseFolderCommand, OpenPathCommand, ImportDocumentCommand, RunSampleCommand, StopRunCommand, SaveRecipeCommand, FetchStartPageCommand, DetectUrlCommand, SaveOutlineCommand, TakeSnapshotCommand, VerifySelectorCommand, InferSelectorCommand, MissingWhyTarget, RejectedWhyTarget, WhyTarget, ExplainWhyCommand, InspectPageCommand, ResponsesSeenCommand, DocumentTreeCommand, PdfViewCommand, TablePreviewOptions, TablePreviewCommand, RegionPreviewCommand, GridViewCommand, GridRowsCommand, GridPreviewOptions, GridPreviewCommand, DeckViewCommand, DeckPreviewOptions, DeckPreviewCommand, StartRecordingCommand, StopRecordingCommand, StudioCommand } from './command.contract.js';
 export { snapshotViewSchema } from './snapshot-view.contract.js';
 export type { SnapshotView } from './snapshot-view.contract.js';
 export { verifySelectorViewSchema } from './verify-selector-view.contract.js';
 export type { VerifySelectorView } from './verify-selector-view.contract.js';
-export { fieldPickSchema, inferSelectorViewSchema } from './infer-selector-view.contract.js';
-export type { FieldPick, InferSelectorView } from './infer-selector-view.contract.js';
+export { fieldPickSchema, inferSelectorViewSchema, selectorAlternativeSchema } from './infer-selector-view.contract.js';
+export type { FieldPick, InferSelectorView, SelectorAlternative } from './infer-selector-view.contract.js';
 export { stoppedBySchema, fieldTraceSchema, traceLineEventSchema, recordEventSchema, recordRejectedEventSchema, runFinishedEventSchema, workspaceChangedEventSchema, recordingCardEventSchema, recordingNoteEventSchema, recordingStoppedEventSchema, studioEventSchema } from './event.contract.js';
 export type { StoppedBy, FieldTraceView, TraceLineEvent, RecordEvent, RecordRejectedEvent, RunFinishedEvent, WorkspaceChangedEvent, RecordingCardEvent, RecordingNoteEvent, RecordingStoppedEvent, StudioEvent } from './event.contract.js';
 export { loadedHooksSchema, recipeIssueSchema, recipeListingSchema, workspaceViewSchema } from './workspace-view.contract.js';
@@ -18,6 +18,8 @@ export { importDocumentViewSchema } from './import-document-view.contract.js';
 export type { ImportDocumentView } from './import-document-view.contract.js';
 export { sampleRunRecordSchema, sampleRunViewSchema } from './sample-run-view.contract.js';
 export type { SampleRunRecord, SampleRunView } from './sample-run-view.contract.js';
+export { detectUrlViewSchema } from './detect-url-view.contract.js';
+export type { DetectUrlView } from './detect-url-view.contract.js';
 export { startPageViewSchema } from './start-page-view.contract.js';
 export type { StartPageView } from './start-page-view.contract.js';
 export { sentencePartSchema, outlineCardSchema, outlineBracketSchema, outlineNodeSchema, outlineViewSchema } from './outline-view.contract.js';
@@ -36,8 +38,8 @@ export { tablePreviewTableSchema, tablePreviewBandSchema, tablePreviewMatchSchem
 export type { TablePreviewTableView, TablePreviewBandView, TablePreviewMatchView, TablePreviewView } from './table-preview-view.contract.js';
 export { regionPreviewMatchSchema, regionPreviewViewSchema } from './region-preview-view.contract.js';
 export type { RegionPreviewMatchView, RegionPreviewView } from './region-preview-view.contract.js';
-export { gridCellViewSchema, gridMergeViewSchema, gridSheetViewSchema, workbookDocumentViewSchema } from './grid-view.contract.js';
-export type { GridCellView, GridMergeView, GridSheetView, WorkbookDocumentView } from './grid-view.contract.js';
+export { gridCellViewSchema, gridMergeViewSchema, gridRowsViewSchema, gridSheetViewSchema, workbookDocumentViewSchema } from './grid-view.contract.js';
+export type { GridCellView, GridMergeView, GridRowsView, GridSheetView, WorkbookDocumentView } from './grid-view.contract.js';
 export { gridTablePreviewMatchSchema, gridTablePreviewViewSchema } from './grid-preview-view.contract.js';
 export type { GridTablePreviewMatchView, GridTablePreviewView } from './grid-preview-view.contract.js';
 export { deckShapeViewSchema, deckChartSeriesViewSchema, deckChartViewSchema, deckSlideViewSchema, deckDocumentViewSchema } from './deck-view.contract.js';