@opencraw/studio 0.0.30 → 0.0.32

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,3 +1,5 @@
+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';

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/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/src/document-view/pdf-view.mapper.d.ts

@@ -12,6 +12,8 @@ export interface PdfRowView {
     top: number;
     bottom: number;
     cells: PdfCellView[];
+    /** A running header or footer (see `@opencraw/core`'s `marginRows`); absent for body text. */
+    running?: boolean;
 }
 /** One page's geometry and diagnostics for the PDF canvas (studio plan §3.4, issue #94's 5b). */
 export interface PdfPageView {

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, 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, DetectUrlCommand, 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, DetectUrlView, 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';
 //# 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,3 +1,5 @@
+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';

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/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/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
@@ -399,6 +405,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 +426,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<{
@@ -523,6 +533,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>;

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/index.d.ts

@@ -1,5 +1,5 @@
-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, 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, 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';
@@ -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';

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

@@ -59,6 +59,20 @@ export declare const inferSelectorViewSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         take: z.ZodString;
         matches: z.ZodNumber;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"item-field">;
+    field: z.ZodObject<{
+        selector: z.ZodString;
+        tier: z.ZodEnum<{
+            id: "id";
+            "data-attr": "data-attr";
+            class: "class";
+            structure: "structure";
+            position: "position";
+        }>;
+        take: z.ZodString;
+        matches: z.ZodNumber;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"unsupported">;
     reason: z.ZodString;

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

@@ -17,6 +17,7 @@ export declare const pdfRowViewSchema: z.ZodObject<{
         height: z.ZodNumber;
         text: z.ZodString;
     }, z.core.$strip>>;
+    running: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const pdfPageViewSchema: z.ZodObject<{
     number: z.ZodNumber;
@@ -32,6 +33,7 @@ export declare const pdfPageViewSchema: z.ZodObject<{
             height: z.ZodNumber;
             text: z.ZodString;
         }, z.core.$strip>>;
+        running: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     rowCount: z.ZodNumber;
     cellCount: z.ZodNumber;
@@ -53,6 +55,7 @@ export declare const pdfDocumentViewSchema: z.ZodObject<{
                 height: z.ZodNumber;
                 text: z.ZodString;
             }, z.core.$strip>>;
+            running: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         rowCount: z.ZodNumber;
         cellCount: z.ZodNumber;

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

@@ -25,6 +25,7 @@ export declare const snapshotViewSchema: z.ZodObject<{
         xml: "xml";
         docx: "docx";
     }>>;
+    notice: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type SnapshotView = z.infer<typeof snapshotViewSchema>;
 //# sourceMappingURL=snapshot-view.contract.d.ts.map

package/dist/src/studio-server/detect-url.handler.d.ts

@@ -0,0 +1,10 @@
+import type { DetectUrlCommand, DetectUrlView } from '../studio-api/index.js';
+/**
+ * Handles `detect-url`: what the address returns, for "Load ▾ Web page" to start a recipe that reads a document (a JSON API, a PDF,
+ * a spreadsheet, Markdown...) instead of a browser recipe over a response that is not a page.
+ *
+ * @param command - The address.
+ * @returns What it returns.
+ */
+export declare function handleDetectUrl(command: DetectUrlCommand): Promise<DetectUrlView>;
+//# sourceMappingURL=detect-url.handler.d.ts.map

package/dist/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
@@ -399,6 +405,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 +426,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<{
@@ -523,6 +533,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>;

package/dist/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<{
+        csv: "csv";
+        docx: "docx";
+        html: "html";
+        json: "json";
+        jsonl: "jsonl";
+        markdown: "markdown";
+        pdf: "pdf";
+        pptx: "pptx";
+        text: "text";
+        unknown: "unknown";
+        xlsx: "xlsx";
+        xml: "xml";
+        yaml: "yaml";
+    }>;
+}, z.core.$strip>;
+export type DetectUrlView = z.infer<typeof detectUrlViewSchema>;
+//# sourceMappingURL=detect-url-view.contract.d.ts.map

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

@@ -1,5 +1,5 @@
-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';
-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';
+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, gridPreviewOptionsSchema, gridPreviewCommandSchema, deckViewCommandSchema, deckPreviewOptionsSchema, deckPreviewCommandSchema, startRecordingCommandSchema, stopRecordingCommandSchema, studioCommandSchema } from './command.contract';
+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, GridPreviewOptions, GridPreviewCommand, DeckViewCommand, DeckPreviewOptions, DeckPreviewCommand, StartRecordingCommand, StopRecordingCommand, StudioCommand } from './command.contract';
 export { snapshotViewSchema } from './snapshot-view.contract';
 export type { SnapshotView } from './snapshot-view.contract';
 export { verifySelectorViewSchema } from './verify-selector-view.contract';
@@ -18,6 +18,8 @@ export { importDocumentViewSchema } from './import-document-view.contract';
 export type { ImportDocumentView } from './import-document-view.contract';
 export { sampleRunRecordSchema, sampleRunViewSchema } from './sample-run-view.contract';
 export type { SampleRunRecord, SampleRunView } from './sample-run-view.contract';
+export { detectUrlViewSchema } from './detect-url-view.contract';
+export type { DetectUrlView } from './detect-url-view.contract';
 export { startPageViewSchema } from './start-page-view.contract';
 export type { StartPageView } from './start-page-view.contract';
 export { sentencePartSchema, outlineCardSchema, outlineBracketSchema, outlineNodeSchema, outlineViewSchema } from './outline-view.contract';

package/dist/studio-api/infer-selector-view.contract.d.ts

@@ -59,6 +59,20 @@ export declare const inferSelectorViewSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         take: z.ZodString;
         matches: z.ZodNumber;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"item-field">;
+    field: z.ZodObject<{
+        selector: z.ZodString;
+        tier: z.ZodEnum<{
+            class: "class";
+            "data-attr": "data-attr";
+            id: "id";
+            position: "position";
+            structure: "structure";
+        }>;
+        take: z.ZodString;
+        matches: z.ZodNumber;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"unsupported">;
     reason: z.ZodString;

package/dist/studio-api/pdf-view.contract.d.ts

@@ -17,6 +17,7 @@ export declare const pdfRowViewSchema: z.ZodObject<{
         height: z.ZodNumber;
         text: z.ZodString;
     }, z.core.$strip>>;
+    running: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const pdfPageViewSchema: z.ZodObject<{
     number: z.ZodNumber;
@@ -32,6 +33,7 @@ export declare const pdfPageViewSchema: z.ZodObject<{
             height: z.ZodNumber;
             text: z.ZodString;
         }, z.core.$strip>>;
+        running: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     rowCount: z.ZodNumber;
     cellCount: z.ZodNumber;
@@ -53,6 +55,7 @@ export declare const pdfDocumentViewSchema: z.ZodObject<{
                 height: z.ZodNumber;
                 text: z.ZodString;
             }, z.core.$strip>>;
+            running: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         rowCount: z.ZodNumber;
         cellCount: z.ZodNumber;

package/dist/studio-api/snapshot-view.contract.d.ts

@@ -25,6 +25,7 @@ export declare const snapshotViewSchema: z.ZodObject<{
         xml: "xml";
         yaml: "yaml";
     }>>;
+    notice: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type SnapshotView = z.infer<typeof snapshotViewSchema>;
 //# sourceMappingURL=snapshot-view.contract.d.ts.map

package/dist/studio-server/detect-url.handler.d.ts

@@ -0,0 +1,10 @@
+import type { DetectUrlCommand, DetectUrlView } from '../studio-api';
+/**
+ * Handles `detect-url`: what the address returns, for "Load ▾ Web page" to start a recipe that reads a document (a JSON API, a PDF,
+ * a spreadsheet, Markdown...) instead of a browser recipe over a response that is not a page.
+ *
+ * @param command - The address.
+ * @returns What it returns.
+ */
+export declare function handleDetectUrl(command: DetectUrlCommand): Promise<DetectUrlView>;
+//# sourceMappingURL=detect-url.handler.d.ts.map