@opencraw/studio 0.0.32 → 0.0.34

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

@@ -207,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>;
@@ -481,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;
@@ -546,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/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, 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 { 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';
@@ -38,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';

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,6 +82,17 @@ 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;
@@ -58,6 +105,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<"item-field">;
@@ -72,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-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

@@ -207,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>;
@@ -481,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;
@@ -546,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/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, 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 { 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';
@@ -38,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,6 +82,17 @@ 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;
@@ -58,6 +105,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<"item-field">;
@@ -72,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-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