@opencraw/studio 0.0.31 → 0.0.33

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

@@ -1,4 +1,16 @@
 import { z } from 'zod';
+/** Another selector that reaches the clicked node, verified against the snapshot, for the person to choose instead of the best one. */
+export declare const selectorAlternativeSchema: z.ZodObject<{
+    selector: z.ZodString;
+    tier: z.ZodEnum<{
+        id: "id";
+        "data-attr": "data-attr";
+        class: "class";
+        structure: "structure";
+        position: "position";
+    }>;
+    matches: z.ZodNumber;
+}, z.core.$strip>;
 /** One clicked node's field: the best selector found for it, verified against the snapshot. */
 export declare const fieldPickSchema: z.ZodObject<{
     selector: z.ZodString;
@@ -11,6 +23,18 @@ export declare const fieldPickSchema: z.ZodObject<{
     }>;
     take: z.ZodString;
     matches: z.ZodNumber;
+    alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        selector: z.ZodString;
+        tier: z.ZodEnum<{
+            id: "id";
+            "data-attr": "data-attr";
+            class: "class";
+            structure: "structure";
+            position: "position";
+        }>;
+        matches: z.ZodNumber;
+    }, z.core.$strip>>>;
+    generatedId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * What `infer-selector` answers with (issue #91, studio plan §3.2):
@@ -33,6 +57,18 @@ export declare const inferSelectorViewSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         }>;
         take: z.ZodString;
         matches: z.ZodNumber;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            tier: z.ZodEnum<{
+                id: "id";
+                "data-attr": "data-attr";
+                class: "class";
+                structure: "structure";
+                position: "position";
+            }>;
+            matches: z.ZodNumber;
+        }, z.core.$strip>>>;
+        generatedId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"list">;
@@ -46,7 +82,44 @@ export declare const inferSelectorViewSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             position: "position";
         }>;
         matches: z.ZodNumber;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            tier: z.ZodEnum<{
+                id: "id";
+                "data-attr": "data-attr";
+                class: "class";
+                structure: "structure";
+                position: "position";
+            }>;
+            matches: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    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;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            tier: z.ZodEnum<{
+                id: "id";
+                "data-attr": "data-attr";
+                class: "class";
+                structure: "structure";
+                position: "position";
+            }>;
+            matches: z.ZodNumber;
+        }, z.core.$strip>>>;
+        generatedId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"item-field">;
     field: z.ZodObject<{
         selector: z.ZodString;
         tier: z.ZodEnum<{
@@ -58,11 +131,24 @@ export declare const inferSelectorViewSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         }>;
         take: z.ZodString;
         matches: z.ZodNumber;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            tier: z.ZodEnum<{
+                id: "id";
+                "data-attr": "data-attr";
+                class: "class";
+                structure: "structure";
+                position: "position";
+            }>;
+            matches: z.ZodNumber;
+        }, z.core.$strip>>>;
+        generatedId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"unsupported">;
     reason: z.ZodString;
 }, z.core.$strip>], "kind">;
+export type SelectorAlternative = z.infer<typeof selectorAlternativeSchema>;
 export type FieldPick = z.infer<typeof fieldPickSchema>;
 export type InferSelectorView = z.infer<typeof inferSelectorViewSchema>;
 //# sourceMappingURL=infer-selector-view.contract.d.ts.map

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/src/studio-server/grid-view.handler.d.ts

@@ -1,5 +1,7 @@
-import type { GridViewCommand, WorkbookDocumentView } from '../studio-api/index.js';
+import type { GridRowsCommand, GridRowsView, GridViewCommand, WorkbookDocumentView } from '../studio-api/index.js';
 import type { StudioState } from './workspace.store.js';
+/** How many rows of a sheet the first `grid-view` answer carries; a bigger sheet's other rows come from `grid-rows` as the grid is scrolled. */
+export declare const GRID_WINDOW_ROWS = 200;
 /**
  * Handles `grid-view`: the grid canvas's sheets and cells (`document-view`'s
  * `workbook-view.mapper.ts`, studio plan §3.4, issue #94's 5c), off the same
@@ -17,4 +19,13 @@ import type { StudioState } from './workspace.store.js';
  * @throws Error when no workspace is open, `command.path` has no cached snapshot yet, an override is given for a snapshot that is not a CSV, or the snapshot's document is not a read workbook.
  */
 export declare function handleGridView(state: StudioState, command: GridViewCommand): Promise<WorkbookDocumentView>;
+/**
+ * Handles `grid-rows`: a run of one sheet's rows from the cached snapshot, for the grid that holds only a few screens of a big file at a time.
+ *
+ * @param state - The server state.
+ * @param command - The command; `command.path` must already have a cached snapshot.
+ * @returns The rows (none past the end of the sheet).
+ * @throws Error when there is no cached snapshot or it is not a workbook.
+ */
+export declare function handleGridRows(state: StudioState, command: GridRowsCommand): GridRowsView;
 //# sourceMappingURL=grid-view.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
@@ -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/studio-api/deck-view.contract.d.ts

@@ -49,6 +49,7 @@ export declare const deckSlideViewSchema: z.ZodObject<{
                 string: "string";
             }>;
         }, 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<{
                     string: "string";
                 }>;
             }, z.core.$strip>>>;
+            rowCount: z.ZodOptional<z.ZodNumber>;
             merges: z.ZodArray<z.ZodObject<{
                 ref: z.ZodString;
                 top: z.ZodNumber;

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/grid-view.contract.d.ts

@@ -31,6 +31,7 @@ export declare const gridSheetViewSchema: z.ZodObject<{
             string: "string";
         }>;
     }, 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<{
+            boolean: "boolean";
+            date: "date";
+            number: "number";
+            string: "string";
+        }>;
+    }, 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<{
                 string: "string";
             }>;
         }, 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/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';
-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, gridRowsCommandSchema, 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, GridRowsCommand, 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';
 export type { VerifySelectorView } from './verify-selector-view.contract';
-export { fieldPickSchema, inferSelectorViewSchema } from './infer-selector-view.contract';
-export type { FieldPick, InferSelectorView } from './infer-selector-view.contract';
+export { fieldPickSchema, inferSelectorViewSchema, selectorAlternativeSchema } from './infer-selector-view.contract';
+export type { FieldPick, InferSelectorView, SelectorAlternative } from './infer-selector-view.contract';
 export { stoppedBySchema, fieldTraceSchema, traceLineEventSchema, recordEventSchema, recordRejectedEventSchema, runFinishedEventSchema, workspaceChangedEventSchema, recordingCardEventSchema, recordingNoteEventSchema, recordingStoppedEventSchema, studioEventSchema } from './event.contract';
 export type { StoppedBy, FieldTraceView, TraceLineEvent, RecordEvent, RecordRejectedEvent, RunFinishedEvent, WorkspaceChangedEvent, RecordingCardEvent, RecordingNoteEvent, RecordingStoppedEvent, StudioEvent } from './event.contract';
 export { loadedHooksSchema, recipeIssueSchema, recipeListingSchema, workspaceViewSchema } from './workspace-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';
@@ -36,8 +38,8 @@ export { tablePreviewTableSchema, tablePreviewBandSchema, tablePreviewMatchSchem
 export type { TablePreviewTableView, TablePreviewBandView, TablePreviewMatchView, TablePreviewView } from './table-preview-view.contract';
 export { regionPreviewMatchSchema, regionPreviewViewSchema } from './region-preview-view.contract';
 export type { RegionPreviewMatchView, RegionPreviewView } from './region-preview-view.contract';
-export { gridCellViewSchema, gridMergeViewSchema, gridSheetViewSchema, workbookDocumentViewSchema } from './grid-view.contract';
-export type { GridCellView, GridMergeView, GridSheetView, WorkbookDocumentView } from './grid-view.contract';
+export { gridCellViewSchema, gridMergeViewSchema, gridRowsViewSchema, gridSheetViewSchema, workbookDocumentViewSchema } from './grid-view.contract';
+export type { GridCellView, GridMergeView, GridRowsView, GridSheetView, WorkbookDocumentView } from './grid-view.contract';
 export { gridTablePreviewMatchSchema, gridTablePreviewViewSchema } from './grid-preview-view.contract';
 export type { GridTablePreviewMatchView, GridTablePreviewView } from './grid-preview-view.contract';
 export { deckShapeViewSchema, deckChartSeriesViewSchema, deckChartViewSchema, deckSlideViewSchema, deckDocumentViewSchema } from './deck-view.contract';

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

@@ -1,4 +1,16 @@
 import { z } from 'zod';
+/** Another selector that reaches the clicked node, verified against the snapshot, for the person to choose instead of the best one. */
+export declare const selectorAlternativeSchema: z.ZodObject<{
+    selector: z.ZodString;
+    tier: z.ZodEnum<{
+        class: "class";
+        "data-attr": "data-attr";
+        id: "id";
+        position: "position";
+        structure: "structure";
+    }>;
+    matches: z.ZodNumber;
+}, z.core.$strip>;
 /** One clicked node's field: the best selector found for it, verified against the snapshot. */
 export declare const fieldPickSchema: z.ZodObject<{
     selector: z.ZodString;
@@ -11,6 +23,18 @@ export declare const fieldPickSchema: z.ZodObject<{
     }>;
     take: z.ZodString;
     matches: z.ZodNumber;
+    alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        selector: z.ZodString;
+        tier: z.ZodEnum<{
+            class: "class";
+            "data-attr": "data-attr";
+            id: "id";
+            position: "position";
+            structure: "structure";
+        }>;
+        matches: z.ZodNumber;
+    }, z.core.$strip>>>;
+    generatedId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * What `infer-selector` answers with (issue #91, studio plan §3.2):
@@ -33,6 +57,18 @@ export declare const inferSelectorViewSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         }>;
         take: z.ZodString;
         matches: z.ZodNumber;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            tier: z.ZodEnum<{
+                class: "class";
+                "data-attr": "data-attr";
+                id: "id";
+                position: "position";
+                structure: "structure";
+            }>;
+            matches: z.ZodNumber;
+        }, z.core.$strip>>>;
+        generatedId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"list">;
@@ -46,7 +82,44 @@ export declare const inferSelectorViewSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             structure: "structure";
         }>;
         matches: z.ZodNumber;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            tier: z.ZodEnum<{
+                class: "class";
+                "data-attr": "data-attr";
+                id: "id";
+                position: "position";
+                structure: "structure";
+            }>;
+            matches: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    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;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            tier: z.ZodEnum<{
+                class: "class";
+                "data-attr": "data-attr";
+                id: "id";
+                position: "position";
+                structure: "structure";
+            }>;
+            matches: z.ZodNumber;
+        }, z.core.$strip>>>;
+        generatedId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"item-field">;
     field: z.ZodObject<{
         selector: z.ZodString;
         tier: z.ZodEnum<{
@@ -58,11 +131,24 @@ export declare const inferSelectorViewSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         }>;
         take: z.ZodString;
         matches: z.ZodNumber;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            tier: z.ZodEnum<{
+                class: "class";
+                "data-attr": "data-attr";
+                id: "id";
+                position: "position";
+                structure: "structure";
+            }>;
+            matches: z.ZodNumber;
+        }, z.core.$strip>>>;
+        generatedId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"unsupported">;
     reason: z.ZodString;
 }, z.core.$strip>], "kind">;
+export type SelectorAlternative = z.infer<typeof selectorAlternativeSchema>;
 export type FieldPick = z.infer<typeof fieldPickSchema>;
 export type InferSelectorView = z.infer<typeof inferSelectorViewSchema>;
 //# sourceMappingURL=infer-selector-view.contract.d.ts.map

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

package/dist/studio-server/grid-view.handler.d.ts

@@ -1,5 +1,7 @@
-import type { GridViewCommand, WorkbookDocumentView } from '../studio-api';
+import type { GridRowsCommand, GridRowsView, GridViewCommand, WorkbookDocumentView } from '../studio-api';
 import type { StudioState } from './workspace.store';
+/** How many rows of a sheet the first `grid-view` answer carries; a bigger sheet's other rows come from `grid-rows` as the grid is scrolled. */
+export declare const GRID_WINDOW_ROWS = 200;
 /**
  * Handles `grid-view`: the grid canvas's sheets and cells (`document-view`'s
  * `workbook-view.mapper.ts`, studio plan §3.4, issue #94's 5c), off the same
@@ -17,4 +19,13 @@ import type { StudioState } from './workspace.store';
  * @throws Error when no workspace is open, `command.path` has no cached snapshot yet, an override is given for a snapshot that is not a CSV, or the snapshot's document is not a read workbook.
  */
 export declare function handleGridView(state: StudioState, command: GridViewCommand): Promise<WorkbookDocumentView>;
+/**
+ * Handles `grid-rows`: a run of one sheet's rows from the cached snapshot, for the grid that holds only a few screens of a big file at a time.
+ *
+ * @param state - The server state.
+ * @param command - The command; `command.path` must already have a cached snapshot.
+ * @returns The rows (none past the end of the sheet).
+ * @throws Error when there is no cached snapshot or it is not a workbook.
+ */
+export declare function handleGridRows(state: StudioState, command: GridRowsCommand): GridRowsView;
 //# sourceMappingURL=grid-view.handler.d.ts.map