feat: support placeholder queries that only request a subset of data

packages/safe-ds-vscode/src/extension/messages.ts

@@ -68,7 +68,27 @@ export interface ProgramMainInformation {
 export interface PlaceholderQueryMessage {
     type: 'placeholder_query';
     id: string;
-    data: string;
+    data: PlaceholderQuery;
+}
+
+/**
+ * A query on a placeholder value.
+ */
+export interface PlaceholderQuery {
+    /**
+     * The name of the requested placeholder.
+     */
+    name: string;
+
+    /**
+     * The offset of the requested data.
+     */
+    window_begin?: number;
+
+    /**
+     * The size of the requested data.
+     */
+    window_size?: number;
 }
 
 // Python Server to Extension
@@ -105,6 +125,10 @@ export interface PlaceholderValue {
     name: string;
     type: string;
     value: string;
+    windowed?: boolean;
+    window_begin?: number;
+    window_size?: number;
+    window_max?: number;
 }
 
 // Python Server to Extension
@@ -152,8 +176,21 @@ export const createProgramMessage = function (id: string, data: ProgramPackageMa
     return { type: 'program', id, data };
 };
 
-export const createPlaceholderQueryMessage = function (id: string, placeholderName: string): PythonServerMessage {
-    return { type: 'placeholder_query', id, data: placeholderName };
+export const createPlaceholderQueryMessage = function (
+    id: string,
+    placeholderName: string,
+    windowBegin: number | undefined = undefined,
+    windowSize: number | undefined = undefined,
+): PythonServerMessage {
+    return {
+        type: 'placeholder_query',
+        id,
+        data: {
+            name: placeholderName,
+            window_begin: !windowBegin ? undefined : Math.round(windowBegin),
+            window_size: !windowSize ? undefined : Math.round(windowSize),
+        },
+    };
 };
 
 // Extension to Python Server