vscode-languageserver-protocol 3.17.0-next.12 → 3.17.0-next.15

package/lib/common/api.d.ts

@@ -101,24 +101,26 @@ export declare namespace Proposed {
     const InlineValuesRefreshRequest: typeof iv.InlineValuesRefreshRequest;
     type $NotebookDocumentClientCapabilities = nb.$NotebookDocumentClientCapabilities;
     type NotebookDocumentSyncClientCapabilities = nb.NotebookDocumentSyncClientCapabilities;
-    type $NotebookDocumentServerCapabilities = nb.$NotebookDocumentServerCapabilities;
+    type $NotebookDocumentSyncServerCapabilities = nb.$NotebookDocumentSyncServerCapabilities;
     type NotebookCellKind = nb.NotebookCellKind;
     const NotebookCellKind: typeof nb.NotebookCellKind;
     type NotebookCell = nb.NotebookCell;
     const NotebookCell: typeof nb.NotebookCell;
-    type NotebookCellChange = nb.NotebookCellChange;
+    type NotebookCellArrayChange = nb.NotebookCellArrayChange;
     type NotebookDocument = nb.NotebookDocument;
     const NotebookDocument: typeof nb.NotebookDocument;
     type NotebookDocumentChangeEvent = nb.NotebookDocumentChangeEvent;
     type NotebookDocumentIdentifier = nb.NotebookDocumentIdentifier;
     type VersionedNotebookDocumentIdentifier = nb.VersionedNotebookDocumentIdentifier;
-    type NotebookDocumentOptions = nb.NotebookDocumentOptions;
-    type NotebookDocumentRegistrationOptions = nb.NotebookDocumentRegistrationOptions;
+    type NotebookDocumentSyncOptions = nb.NotebookDocumentSyncOptions;
+    type NotebookDocumentSyncRegistrationOptions = nb.NotebookDocumentSyncRegistrationOptions;
     const NotebookDocumentSyncRegistrationType: typeof nb.NotebookDocumentSyncRegistrationType;
     type DidOpenNotebookDocumentParams = nb.DidOpenNotebookDocumentParams;
     const DidOpenNotebookDocumentNotification: typeof nb.DidOpenNotebookDocumentNotification;
     type DidChangeNotebookDocumentParams = nb.DidChangeNotebookDocumentParams;
     const DidChangeNotebookDocumentNotification: typeof nb.DidChangeNotebookDocumentNotification;
+    type DidSaveNotebookDocumentParams = nb.DidSaveNotebookDocumentParams;
+    const DidSaveNotebookDocumentNotification: typeof nb.DidSaveNotebookDocumentNotification;
     type DidCloseNotebookDocumentParams = nb.DidCloseNotebookDocumentParams;
     const DidCloseNotebookDocumentNotification: typeof nb.DidCloseNotebookDocumentNotification;
 }

package/lib/common/api.js

@@ -93,6 +93,7 @@ var Proposed;
     Proposed.NotebookDocumentSyncRegistrationType = nb.NotebookDocumentSyncRegistrationType;
     Proposed.DidOpenNotebookDocumentNotification = nb.DidOpenNotebookDocumentNotification;
     Proposed.DidChangeNotebookDocumentNotification = nb.DidChangeNotebookDocumentNotification;
+    Proposed.DidSaveNotebookDocumentNotification = nb.DidSaveNotebookDocumentNotification;
     Proposed.DidCloseNotebookDocumentNotification = nb.DidCloseNotebookDocumentNotification;
 })(Proposed = exports.Proposed || (exports.Proposed = {}));
 //# sourceMappingURL=api.js.map

package/lib/common/proposed.diagnostic.d.ts

@@ -5,7 +5,7 @@ import { PartialResultParams, StaticRegistrationOptions, WorkDoneProgressParams,
 /**
  * @since 3.17.0 - proposed state
  */
-export interface DiagnosticClientCapabilities {
+export declare type DiagnosticClientCapabilities = {
     /**
      * Whether implementation supports dynamic registration. If this is set to `true`
      * the client supports the new `(TextDocumentRegistrationOptions & StaticRegistrationOptions)`
@@ -16,18 +16,18 @@ export interface DiagnosticClientCapabilities {
      * Whether the clients supports related documents for document diagnostic pulls.
      */
     relatedDocumentSupport?: boolean;
-}
-export interface $DiagnosticClientCapabilities {
+};
+export declare type $DiagnosticClientCapabilities = {
     textDocument?: TextDocumentClientCapabilities & {
         diagnostic?: DiagnosticClientCapabilities;
     };
-}
+};
 /**
  * Diagnostic options.
  *
  * @since 3.17.0 - proposed state
  */
-export interface DiagnosticOptions extends WorkDoneProgressOptions {
+export declare type DiagnosticOptions = WorkDoneProgressOptions & {
     /**
      * An optional identifier under which the diagnostics are
      * managed by the client.
@@ -44,25 +44,24 @@ export interface DiagnosticOptions extends WorkDoneProgressOptions {
      * The server provides support for workspace diagnostics as well.
      */
     workspaceDiagnostics: boolean;
-}
+};
 /**
  * Diagnostic registration options.
  *
  * @since 3.17.0 - proposed state
  */
-export interface DiagnosticRegistrationOptions extends TextDocumentRegistrationOptions, DiagnosticOptions, StaticRegistrationOptions {
-}
-export interface $DiagnosticServerCapabilities {
+export declare type DiagnosticRegistrationOptions = TextDocumentRegistrationOptions & DiagnosticOptions & StaticRegistrationOptions;
+export declare type $DiagnosticServerCapabilities = {
     diagnosticProvider?: DiagnosticOptions;
-}
+};
 /**
  * Cancellation data returned from a diagnostic request.
  *
  * @since 3.17.0 - proposed state
  */
-export interface DiagnosticServerCancellationData {
+export declare type DiagnosticServerCancellationData = {
     retriggerRequest: boolean;
-}
+};
 /**
  * @since 3.17.0 - proposed state
  */
@@ -74,7 +73,7 @@ export declare namespace DiagnosticServerCancellationData {
  *
  * @since 3.17.0 - proposed state
  */
-export interface DocumentDiagnosticParams extends WorkDoneProgressParams, PartialResultParams {
+export declare type DocumentDiagnosticParams = WorkDoneProgressParams & PartialResultParams & {
     /**
      * The text document.
      */
@@ -87,7 +86,7 @@ export interface DocumentDiagnosticParams extends WorkDoneProgressParams, Partia
      * The result id of a previous response if provided.
      */
     previousResultId?: string;
-}
+};
 /**
  * The document diagnostic report kinds.
  *
@@ -110,7 +109,7 @@ export declare enum DocumentDiagnosticReportKind {
  *
  * @since 3.17.0 - proposed state
  */
-export interface FullDocumentDiagnosticReport {
+export declare type FullDocumentDiagnosticReport = {
     /**
      * A full document diagnostic report.
      */
@@ -125,13 +124,13 @@ export interface FullDocumentDiagnosticReport {
      * The actual items.
      */
     items: Diagnostic[];
-}
+};
 /**
  * A full diagnostic report with a set of related documents.
  *
  * @since 3.17.0 - proposed state
  */
-export interface RelatedFullDocumentDiagnosticReport extends FullDocumentDiagnosticReport {
+export declare type RelatedFullDocumentDiagnosticReport = FullDocumentDiagnosticReport & {
     /**
      * Diagnostics of related documents. This information is useful
      * in programming languages where code in a file A can generate
@@ -144,14 +143,14 @@ export interface RelatedFullDocumentDiagnosticReport extends FullDocumentDiagnos
     relatedDocuments?: {
         [uri: string /** DocumentUri */]: FullDocumentDiagnosticReport | UnchangedDocumentDiagnosticReport;
     };
-}
+};
 /**
  * A diagnostic report indicating that the last returned
  * report is still accurate.
  *
  * @since 3.17.0 - proposed state
  */
-export interface UnchangedDocumentDiagnosticReport {
+export declare type UnchangedDocumentDiagnosticReport = {
     /**
      * A document diagnostic report indicating
      * no changes to the last result. A server can
@@ -164,13 +163,13 @@ export interface UnchangedDocumentDiagnosticReport {
      * diagnostic request for the same document.
      */
     resultId: string;
-}
+};
 /**
  * An unchanged diagnostic report with a set of related documents.
  *
  * @since 3.17.0 - proposed state
  */
-export interface RelatedUnchangedDocumentDiagnosticReport extends UnchangedDocumentDiagnosticReport {
+export declare type RelatedUnchangedDocumentDiagnosticReport = UnchangedDocumentDiagnosticReport & {
     /**
      * Diagnostics of related documents. This information is useful
      * in programming languages where code in a file A can generate
@@ -183,7 +182,7 @@ export interface RelatedUnchangedDocumentDiagnosticReport extends UnchangedDocum
     relatedDocuments?: {
         [uri: string /** DocumentUri */]: FullDocumentDiagnosticReport | UnchangedDocumentDiagnosticReport;
     };
-}
+};
 /**
  * The result of a document diagnostic pull request. A report can
  * either be a full report containing all diagnostics for the
@@ -199,11 +198,11 @@ export declare type DocumentDiagnosticReport = RelatedFullDocumentDiagnosticRepo
  *
  * @since 3.17.0 - proposed state
  */
-export interface DocumentDiagnosticReportPartialResult {
+export declare type DocumentDiagnosticReportPartialResult = {
     relatedDocuments: {
         [uri: string /** DocumentUri */]: FullDocumentDiagnosticReport | UnchangedDocumentDiagnosticReport;
     };
-}
+};
 /**
  * The document diagnostic request definition.
  *
@@ -236,7 +235,7 @@ export declare type PreviousResultId = {
  *
  * @since 3.17.0 - proposed state
  */
-export interface WorkspaceDiagnosticParams extends WorkDoneProgressParams, PartialResultParams {
+export declare type WorkspaceDiagnosticParams = WorkDoneProgressParams & PartialResultParams & {
     /**
      * The additional identifier provided during registration.
      */
@@ -246,13 +245,13 @@ export interface WorkspaceDiagnosticParams extends WorkDoneProgressParams, Parti
      * previous result ids.
      */
     previousResultIds: PreviousResultId[];
-}
+};
 /**
  * A full document diagnostic report for a workspace diagnostic result.
  *
  * @since 3.17.0 - proposed state
  */
-export interface WorkspaceFullDocumentDiagnosticReport extends FullDocumentDiagnosticReport {
+export declare type WorkspaceFullDocumentDiagnosticReport = FullDocumentDiagnosticReport & {
     /**
      * The URI for which diagnostic information is reported.
      */
@@ -262,13 +261,13 @@ export interface WorkspaceFullDocumentDiagnosticReport extends FullDocumentDiagn
      * If the document is not marked as open `null` can be provided.
      */
     version: integer | null;
-}
+};
 /**
  * An unchanged document diagnostic report for a workspace diagnostic result.
  *
  * @since 3.17.0 - proposed state
  */
-export interface WorkspaceUnchangedDocumentDiagnosticReport extends UnchangedDocumentDiagnosticReport {
+export declare type WorkspaceUnchangedDocumentDiagnosticReport = UnchangedDocumentDiagnosticReport & {
     /**
      * The URI for which diagnostic information is reported.
      */
@@ -278,7 +277,7 @@ export interface WorkspaceUnchangedDocumentDiagnosticReport extends UnchangedDoc
      * If the document is not marked as open `null` can be provided.
      */
     version: integer | null;
-}
+};
 /**
  * A workspace diagnostic document report.
  *
@@ -290,17 +289,17 @@ export declare type WorkspaceDocumentDiagnosticReport = WorkspaceFullDocumentDia
  *
  * @since 3.17.0 - proposed state
  */
-export interface WorkspaceDiagnosticReport {
+export declare type WorkspaceDiagnosticReport = {
     items: WorkspaceDocumentDiagnosticReport[];
-}
+};
 /**
  * A partial result for a workspace diagnostic report.
  *
  * @since 3.17.0 - proposed state
  */
-export interface WorkspaceDiagnosticReportPartialResult {
+export declare type WorkspaceDiagnosticReportPartialResult = {
     items: WorkspaceDocumentDiagnosticReport[];
-}
+};
 /**
  * The workspace diagnostic request definition.
  *

package/lib/common/proposed.inlineValue.d.ts

@@ -7,18 +7,18 @@ import { TextDocumentRegistrationOptions, WorkDoneProgressOptions, StaticRegistr
  *
  * @since 3.17.0 - proposed state
  */
-export interface InlineValuesClientCapabilities {
+export declare type InlineValuesClientCapabilities = {
     /**
      * Whether implementation supports dynamic registration for inline value providers.
      */
     dynamicRegistration?: boolean;
-}
+};
 /**
  * Client workspace capabilities specific to inline values.
  *
  * @since 3.17.0 - proposed state
  */
-export interface InlineValuesWorkspaceClientCapabilities {
+export declare type InlineValuesWorkspaceClientCapabilities = {
     /**
      * Whether the client implementation supports a refresh request sent from the
      * server to the client.
@@ -29,27 +29,25 @@ export interface InlineValuesWorkspaceClientCapabilities {
      * change that requires such a calculation.
      */
     refreshSupport?: boolean;
-}
+};
 /**
  * Inline values options used during static registration.
  *
  * @since 3.17.0 - proposed state
  */
-export interface InlineValuesOptions extends WorkDoneProgressOptions {
-}
+export declare type InlineValuesOptions = WorkDoneProgressOptions;
 /**
  * Inline value options used during static or dynamic registration.
  *
  * @since 3.17.0 - proposed state
  */
-export interface InlineValuesRegistrationOptions extends InlineValuesOptions, TextDocumentRegistrationOptions, StaticRegistrationOptions {
-}
+export declare type InlineValuesRegistrationOptions = InlineValuesOptions & TextDocumentRegistrationOptions & StaticRegistrationOptions;
 /**
  * A parameter literal used in inline values requests.
  *
  * @since 3.17.0 - proposed state
  */
-export interface InlineValuesParams extends WorkDoneProgressParams {
+export declare type InlineValuesParams = WorkDoneProgressParams & {
     /**
      * The text document.
      */
@@ -63,7 +61,7 @@ export interface InlineValuesParams extends WorkDoneProgressParams {
      * requested.
      */
     context: InlineValuesContext;
-}
+};
 /**
  * A request to provide inline values in a document. The request's parameter is of
  * type [InlineValuesParams](#InlineValuesParams), the response is of type

package/lib/common/proposed.notebooks.d.ts

@@ -1,12 +1,12 @@
-import { URI, integer, DocumentUri, uinteger } from 'vscode-languageserver-types';
+import { URI, integer, DocumentUri, uinteger, LSPObject, TextDocumentItem, TextDocumentIdentifier, VersionedTextDocumentIdentifier } from 'vscode-languageserver-types';
 import { ProtocolNotificationType, RegistrationType } from './messages';
-import { StaticRegistrationOptions, NotebookDocumentFilter } from './protocol';
+import { StaticRegistrationOptions, NotebookDocumentFilter, TextDocumentContentChangeEvent } from './protocol';
 /**
  * Notebook specific client capabilities.
  *
  * @since 3.17.0 - proposed state
  */
-export interface NotebookDocumentSyncClientCapabilities {
+export declare type NotebookDocumentSyncClientCapabilities = {
     /**
      * Whether implementation supports dynamic registration. If this is
      * set to `true` the client supports the new
@@ -14,12 +14,21 @@ export interface NotebookDocumentSyncClientCapabilities {
      * return value for the corresponding server capability as well.
      */
     dynamicRegistration?: boolean;
-}
-export interface $NotebookDocumentClientCapabilities {
+    /**
+     * The client supports sending execution summary data per cell.
+     */
+    executionSummarySupport?: boolean;
+    /**
+     * The client has support for notebook controllers and might
+     * send `DidSelectNotebookController` notifications.
+     */
+    notebookControllerSupport?: boolean;
+};
+export declare type $NotebookDocumentClientCapabilities = {
     notebookDocument?: {
         synchronization: NotebookDocumentSyncClientCapabilities;
     };
-}
+};
 /**
  * A notebook cell kind.
  *
@@ -37,58 +46,64 @@ export declare namespace NotebookCellKind {
     function is(value: any): value is NotebookCellKind;
 }
 export declare type NotebookCellKind = 1 | 2;
+export declare type ExecutionSummary = {
+    /**
+     * A strict monotonically increasing value
+     * indicating the execution order of a cell
+     * inside a notebook.
+     */
+    executionOrder: uinteger;
+    /**
+     * Whether the execution was successful or
+     * not if known by the client.
+     */
+    success?: boolean;
+};
+export declare namespace ExecutionSummary {
+    function create(executionOrder: number, success?: boolean): ExecutionSummary;
+    function is(value: any): value is ExecutionSummary;
+    function equals(one: ExecutionSummary | undefined, other: ExecutionSummary | undefined): boolean;
+}
 /**
  * A notebook cell.
  *
+ * A cell's document URI must be unique across ALL notebook
+ * cells and can therefore be used to uniquely identify a
+ * notebook cell or the cell's text document.
+ *
  * @since 3.17.0 - proposed state
  */
-export interface NotebookCell {
+export declare type NotebookCell = {
     /**
      * The cell's kind
      */
     kind: NotebookCellKind;
     /**
-     * The cell's text represented as a text document.
-     * The document's content is synced using the
-     * existing text document sync notifications.
+     * The URI of the cell's text document
+     * content.
      */
     document: DocumentUri;
-}
-export declare namespace NotebookCell {
-    function create(kind: NotebookCellKind, document: DocumentUri): NotebookCell;
-    function is(value: any): value is NotebookCell;
-    function equal(one: NotebookCell, two: NotebookCell): boolean;
-}
-/**
- * A change describing how to move a `NotebookCell`
- * array from state S' to S''.
- *
- * @since 3.17.0 - proposed state
- */
-export interface NotebookCellChange {
     /**
-     * The start oftest of the cell that changed.
+     * Additional metadata stored with the cell.
      */
-    start: uinteger;
+    metadata?: LSPObject;
     /**
-     * The deleted cells
+     * Additional execution summary information
+     * if supported by the client.
      */
-    deleteCount: uinteger;
-    /**
-     * The new cells, if any
-     */
-    cells?: NotebookCell[];
-}
-export declare namespace NotebookCellChange {
-    function is(value: any): value is NotebookCellChange;
-    function create(start: uinteger, deleteCount: uinteger, cells?: NotebookCell[]): NotebookCellChange;
+    executionSummary?: ExecutionSummary;
+};
+export declare namespace NotebookCell {
+    function create(kind: NotebookCellKind, document: DocumentUri): NotebookCell;
+    function is(value: any): value is NotebookCell;
+    function diff(one: NotebookCell, two: NotebookCell): Set<keyof NotebookCell>;
 }
 /**
  * A notebook document.
  *
  * @since 3.17.0 - proposed state
  */
-export interface NotebookDocument {
+export declare type NotebookDocument = {
     /**
      * The notebook document's uri.
      */
@@ -102,11 +117,16 @@ export interface NotebookDocument {
      * change, including undo/redo).
      */
     version: integer;
+    /**
+     * Additional metadata stored with the notebook
+     * document.
+     */
+    metadata?: LSPObject;
     /**
      * The cells of a notebook.
      */
     cells: NotebookCell[];
-}
+};
 export declare namespace NotebookDocument {
     function create(uri: URI, notebookType: string, version: integer, cells: NotebookCell[]): NotebookDocument;
     function is(value: any): value is NotebookDocument;
@@ -116,18 +136,18 @@ export declare namespace NotebookDocument {
  *
  * @since 3.17.0 - proposed state
  */
-export interface NotebookDocumentIdentifier {
+export declare type NotebookDocumentIdentifier = {
     /**
      * The notebook document's uri.
      */
     uri: URI;
-}
+};
 /**
  * A versioned notebook document identifier.
  *
  * @since 3.17.0 - proposed state
  */
-export interface VersionedNotebookDocumentIdentifier {
+export declare type VersionedNotebookDocumentIdentifier = {
     /**
      * The version number of this notebook document.
      */
@@ -136,12 +156,12 @@ export interface VersionedNotebookDocumentIdentifier {
      * The notebook document's uri.
      */
     uri: URI;
-}
+};
 /**
  * Options specific to a notebook plus its cells
  * to be synced to the server.
  *
- * If a selector provider a notebook document
+ * If a selector provide a notebook document
  * filter but no cell selector all cells of a
  * matching notebook document will be synced.
  *
@@ -152,8 +172,11 @@ export interface VersionedNotebookDocumentIdentifier {
  *
  * @since 3.17.0 - proposed state
  */
-export declare type NotebookDocumentOptions = {
-    notebookDocumentSelector?: ({
+export declare type NotebookDocumentSyncOptions = {
+    /**
+     * The notebook document to be synced
+     */
+    notebookDocumentSelector: ({
         /** The notebook documents to be synced */
         notebookDocumentFilter: NotebookDocumentFilter;
         /** The cells of the matching notebook to be synced */
@@ -168,31 +191,53 @@ export declare type NotebookDocumentOptions = {
             language: string;
         }[];
     })[];
+    /**
+     * Determines how the notebook is synchronized.
+     *
+     * If set to 'notebook' the notebook document,
+     * its meta data, cell structure and the cell's
+     * text documents are synchronized.
+     *
+     * If set to 'cellContent' only the cell content
+     * is synchronized using the available
+     * `textDocument/did*` notifications.
+     */
+    mode: 'notebook' | 'cellContent';
+    /**
+     * Whether save notification should be forwarded to
+     * the server. Will only be honored if mode === `notebook`.
+     */
+    save?: boolean;
 };
-export interface $NotebookDocumentServerCapabilities {
-    notebookDocumentSync?: NotebookDocumentOptions | NotebookDocumentRegistrationOptions;
-}
 /**
  * Registration options specific to a notebook.
  *
  * @since 3.17.0 - proposed state
  */
-export declare type NotebookDocumentRegistrationOptions = NotebookDocumentOptions & StaticRegistrationOptions;
+export declare type NotebookDocumentSyncRegistrationOptions = NotebookDocumentSyncOptions & StaticRegistrationOptions;
+export interface $NotebookDocumentSyncServerCapabilities {
+    notebookDocumentSync?: NotebookDocumentSyncOptions | NotebookDocumentSyncRegistrationOptions;
+}
 export declare namespace NotebookDocumentSyncRegistrationType {
     const method: 'notebookDocument/sync';
-    const type: RegistrationType<NotebookDocumentRegistrationOptions>;
+    const type: RegistrationType<NotebookDocumentSyncRegistrationOptions>;
 }
 /**
  * The params sent in a open notebook document notification.
  *
  * @since 3.17.0 - proposed state
  */
-export interface DidOpenNotebookDocumentParams {
+export declare type DidOpenNotebookDocumentParams = {
     /**
      * The notebook document that got opened.
      */
     notebookDocument: NotebookDocument;
-}
+    /**
+     * The text documents that represent the content
+     * of a notebook cell.
+     */
+    cellTextDocuments: TextDocumentItem[];
+};
 /**
  * A notification sent when a notebook opens.
  *
@@ -202,13 +247,87 @@ export declare namespace DidOpenNotebookDocumentNotification {
     const method: 'notebookDocument/didOpen';
     const type: ProtocolNotificationType<DidOpenNotebookDocumentParams, void>;
 }
-export interface NotebookDocumentChangeEvent {
-    cells: NotebookCellChange;
+/**
+ * A change describing how to move a `NotebookCell`
+ * array from state S to S'.
+ *
+ * @since 3.17.0 - proposed state
+ */
+export declare type NotebookCellArrayChange = {
+    /**
+     * The start oftest of the cell that changed.
+     */
+    start: uinteger;
+    /**
+     * The deleted cells
+     */
+    deleteCount: uinteger;
+    /**
+     * The new cells, if any
+     */
+    cells?: NotebookCell[];
+};
+export declare namespace NotebookCellArrayChange {
+    function is(value: any): value is NotebookCellArrayChange;
+    function create(start: uinteger, deleteCount: uinteger, cells?: NotebookCell[]): NotebookCellArrayChange;
 }
-export interface DidChangeNotebookDocumentParams {
+/**
+ * A change event for a notebook document.
+ *
+ * @since 3.17.0 - proposed state
+ */
+export declare type NotebookDocumentChangeEvent = {
+    /**
+     * The changed meta data if any.
+     */
+    metadata?: LSPObject;
+    /**
+     * Changes to cells
+     */
+    cells?: {
+        /**
+         * Changes to the cell structure to add or
+         * remove cells.
+         */
+        structure?: {
+            /**
+             * The change to the cell array.
+             */
+            array: NotebookCellArrayChange;
+            /**
+             * Additional opened cell text documents.
+             */
+            didOpen?: TextDocumentItem[];
+            /**
+             * Additional closed cell text documents.
+             */
+            didClose?: TextDocumentIdentifier[];
+        };
+        /**
+         * Changes to notebook cells properties like its
+         * kind, execution summary or metadata.
+         */
+        data?: NotebookCell[];
+        /**
+         * Changes to the text content of notebook cells.
+         */
+        textContent?: {
+            document: VersionedTextDocumentIdentifier;
+            changes: TextDocumentContentChangeEvent[];
+        }[];
+    };
+};
+/**
+ * The params sent in a change notebook document notification.
+ *
+ * @since 3.17.0 - proposed state
+ */
+export declare type DidChangeNotebookDocumentParams = {
     /**
      * The notebook document that did change. The version number points
-     * to the version after all provided changes have been applied.
+     * to the version after all provided changes have been applied. If
+     * only the text document content of a cell changes the notebook version
+     * doesn't necessarily have to change.
      */
     notebookDocument: VersionedNotebookDocumentIdentifier;
     /**
@@ -226,23 +345,48 @@ export interface DidChangeNotebookDocumentParams {
      * - apply the `NotebookChangeEvent`s in a single notification in the order
      *   you receive them.
      */
-    changes: NotebookDocumentChangeEvent[];
-}
+    change: NotebookDocumentChangeEvent;
+};
 export declare namespace DidChangeNotebookDocumentNotification {
     const method: 'notebookDocument/didChange';
     const type: ProtocolNotificationType<DidChangeNotebookDocumentParams, void>;
 }
 /**
- * The params sent in a close notebook document notification.
+ * The params sent in a save notebook document notification.
  *
  * @since 3.17.0 - proposed state
  */
-export interface DidCloseNotebookDocumentParams {
+export declare type DidSaveNotebookDocumentParams = {
     /**
-     * The notebook document that got opened.
+     * The notebook document that got saved.
      */
     notebookDocument: NotebookDocumentIdentifier;
+};
+/**
+ * A notification sent when a notebook document is saved.
+ *
+ * @since 3.17.0 - proposed state
+ */
+export declare namespace DidSaveNotebookDocumentNotification {
+    const method: 'notebookDocument/didSave';
+    const type: ProtocolNotificationType<DidSaveNotebookDocumentParams, void>;
 }
+/**
+ * The params sent in a close notebook document notification.
+ *
+ * @since 3.17.0 - proposed state
+ */
+export declare type DidCloseNotebookDocumentParams = {
+    /**
+     * The notebook document that got closed.
+     */
+    notebookDocument: NotebookDocumentIdentifier;
+    /**
+     * The text documents that represent the content
+     * of a notebook cell that got closed.
+     */
+    cellTextDocuments: TextDocumentIdentifier[];
+};
 /**
  * A notification sent when a notebook closes.
  *

package/lib/common/proposed.notebooks.js

@@ -4,7 +4,7 @@
  * Licensed under the MIT License. See License.txt in the project root for license information.
  * ------------------------------------------------------------------------------------------ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DidCloseNotebookDocumentNotification = exports.DidChangeNotebookDocumentNotification = exports.DidOpenNotebookDocumentNotification = exports.NotebookDocumentSyncRegistrationType = exports.NotebookDocument = exports.NotebookCellChange = exports.NotebookCell = exports.NotebookCellKind = void 0;
+exports.DidCloseNotebookDocumentNotification = exports.DidSaveNotebookDocumentNotification = exports.DidChangeNotebookDocumentNotification = exports.NotebookCellArrayChange = exports.DidOpenNotebookDocumentNotification = exports.NotebookDocumentSyncRegistrationType = exports.NotebookDocument = exports.NotebookCell = exports.ExecutionSummary = exports.NotebookCellKind = void 0;
 const vscode_languageserver_types_1 = require("vscode-languageserver-types");
 const Is = require("./utils/is");
 const messages_1 = require("./messages");
@@ -28,6 +28,32 @@ var NotebookCellKind;
     }
     NotebookCellKind.is = is;
 })(NotebookCellKind = exports.NotebookCellKind || (exports.NotebookCellKind = {}));
+var ExecutionSummary;
+(function (ExecutionSummary) {
+    function create(executionOrder, success) {
+        const result = { executionOrder };
+        if (success === true || success === false) {
+            result.success = success;
+        }
+        return result;
+    }
+    ExecutionSummary.create = create;
+    function is(value) {
+        const candidate = value;
+        return Is.objectLiteral(candidate) && vscode_languageserver_types_1.uinteger.is(candidate.executionOrder) && (candidate.success === undefined || Is.boolean(candidate.success));
+    }
+    ExecutionSummary.is = is;
+    function equals(one, other) {
+        if (one === other) {
+            return true;
+        }
+        if (one === null || one === undefined || other === null || other === undefined) {
+            return false;
+        }
+        return one.executionOrder === other.executionOrder && one.success === other.success;
+    }
+    ExecutionSummary.equals = equals;
+})(ExecutionSummary = exports.ExecutionSummary || (exports.ExecutionSummary = {}));
 var NotebookCell;
 (function (NotebookCell) {
     function create(kind, document) {
@@ -36,30 +62,79 @@ var NotebookCell;
     NotebookCell.create = create;
     function is(value) {
         const candidate = value;
-        return Is.objectLiteral(candidate) && NotebookCellKind.is(candidate.kind) && vscode_languageserver_types_1.DocumentUri.is(candidate.document);
+        return Is.objectLiteral(candidate) && NotebookCellKind.is(candidate.kind) && vscode_languageserver_types_1.DocumentUri.is(candidate.document) &&
+            (candidate.metadata === undefined || Is.objectLiteral(candidate.metadata));
     }
     NotebookCell.is = is;
-    function equal(one, two) {
-        return one.kind === two.kind && one.document === two.document;
-    }
-    NotebookCell.equal = equal;
-})(NotebookCell = exports.NotebookCell || (exports.NotebookCell = {}));
-var NotebookCellChange;
-(function (NotebookCellChange) {
-    function is(value) {
-        const candidate = value;
-        return Is.objectLiteral(candidate) && vscode_languageserver_types_1.uinteger.is(candidate.start) && vscode_languageserver_types_1.uinteger.is(candidate.deleteCount) && (candidate.cells === undefined || Is.typedArray(candidate.cells, NotebookCell.is));
-    }
-    NotebookCellChange.is = is;
-    function create(start, deleteCount, cells) {
-        const result = { start, deleteCount };
-        if (cells !== undefined) {
-            result.cells = cells;
+    function diff(one, two) {
+        const result = new Set();
+        if (one.document !== two.document) {
+            result.add('document');
+        }
+        if (one.kind !== two.kind) {
+            result.add('kind');
+        }
+        if (one.executionSummary !== two.executionSummary) {
+            result.add('executionSummary');
+        }
+        if ((one.metadata !== undefined || two.metadata !== undefined) && !equalsMetadata(one.metadata, two.metadata)) {
+            result.add('metadata');
+        }
+        if ((one.executionSummary !== undefined || two.executionSummary !== undefined) && !ExecutionSummary.equals(one.executionSummary, two.executionSummary)) {
+            result.add('executionSummary');
         }
         return result;
     }
-    NotebookCellChange.create = create;
-})(NotebookCellChange = exports.NotebookCellChange || (exports.NotebookCellChange = {}));
+    NotebookCell.diff = diff;
+    function equalsMetadata(one, other) {
+        if (one === other) {
+            return true;
+        }
+        if (one === null || one === undefined || other === null || other === undefined) {
+            return false;
+        }
+        if (typeof one !== typeof other) {
+            return false;
+        }
+        if (typeof one !== 'object') {
+            return false;
+        }
+        const oneArray = Array.isArray(one);
+        const otherArray = Array.isArray(other);
+        if (oneArray !== otherArray) {
+            return false;
+        }
+        if (oneArray && otherArray) {
+            if (one.length !== other.length) {
+                return false;
+            }
+            for (let i = 0; i < one.length; i++) {
+                if (!equalsMetadata(one[i], other[i])) {
+                    return false;
+                }
+            }
+        }
+        if (Is.objectLiteral(one) && Is.objectLiteral(other)) {
+            const oneKeys = Object.keys(one);
+            const otherKeys = Object.keys(other);
+            if (oneKeys.length !== otherKeys.length) {
+                return false;
+            }
+            oneKeys.sort();
+            otherKeys.sort();
+            if (!equalsMetadata(oneKeys, otherKeys)) {
+                return false;
+            }
+            for (let i = 0; i < oneKeys.length; i++) {
+                const prop = oneKeys[i];
+                if (!equalsMetadata(one[prop], other[prop])) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+})(NotebookCell = exports.NotebookCell || (exports.NotebookCell = {}));
 var NotebookDocument;
 (function (NotebookDocument) {
     function create(uri, notebookType, version, cells) {
@@ -87,11 +162,37 @@ var DidOpenNotebookDocumentNotification;
     DidOpenNotebookDocumentNotification.method = 'notebookDocument/didOpen';
     DidOpenNotebookDocumentNotification.type = new messages_1.ProtocolNotificationType(DidOpenNotebookDocumentNotification.method);
 })(DidOpenNotebookDocumentNotification = exports.DidOpenNotebookDocumentNotification || (exports.DidOpenNotebookDocumentNotification = {}));
+var NotebookCellArrayChange;
+(function (NotebookCellArrayChange) {
+    function is(value) {
+        const candidate = value;
+        return Is.objectLiteral(candidate) && vscode_languageserver_types_1.uinteger.is(candidate.start) && vscode_languageserver_types_1.uinteger.is(candidate.deleteCount) && (candidate.cells === undefined || Is.typedArray(candidate.cells, NotebookCell.is));
+    }
+    NotebookCellArrayChange.is = is;
+    function create(start, deleteCount, cells) {
+        const result = { start, deleteCount };
+        if (cells !== undefined) {
+            result.cells = cells;
+        }
+        return result;
+    }
+    NotebookCellArrayChange.create = create;
+})(NotebookCellArrayChange = exports.NotebookCellArrayChange || (exports.NotebookCellArrayChange = {}));
 var DidChangeNotebookDocumentNotification;
 (function (DidChangeNotebookDocumentNotification) {
     DidChangeNotebookDocumentNotification.method = 'notebookDocument/didChange';
     DidChangeNotebookDocumentNotification.type = new messages_1.ProtocolNotificationType(DidChangeNotebookDocumentNotification.method);
 })(DidChangeNotebookDocumentNotification = exports.DidChangeNotebookDocumentNotification || (exports.DidChangeNotebookDocumentNotification = {}));
+/**
+ * A notification sent when a notebook document is saved.
+ *
+ * @since 3.17.0 - proposed state
+ */
+var DidSaveNotebookDocumentNotification;
+(function (DidSaveNotebookDocumentNotification) {
+    DidSaveNotebookDocumentNotification.method = 'notebookDocument/didSave';
+    DidSaveNotebookDocumentNotification.type = new messages_1.ProtocolNotificationType(DidSaveNotebookDocumentNotification.method);
+})(DidSaveNotebookDocumentNotification = exports.DidSaveNotebookDocumentNotification || (exports.DidSaveNotebookDocumentNotification = {}));
 /**
  * A notification sent when a notebook closes.
  *

package/lib/common/proposed.typeHierarchy.d.ts

@@ -5,35 +5,32 @@ import { TextDocumentRegistrationOptions, StaticRegistrationOptions, TextDocumen
 /**
  * @since 3.17.0 - proposed state
  */
-export interface TypeHierarchyClientCapabilities {
+export declare type TypeHierarchyClientCapabilities = {
     /**
      * Whether implementation supports dynamic registration. If this is set to `true`
      * the client supports the new `(TextDocumentRegistrationOptions & StaticRegistrationOptions)`
      * return value for the corresponding server capability as well.
      */
     dynamicRegistration?: boolean;
-}
+};
 /**
  * Type hierarchy options used during static registration.
  *
  * @since 3.17.0 - proposed state
  */
-export interface TypeHierarchyOptions extends WorkDoneProgressOptions {
-}
+export declare type TypeHierarchyOptions = WorkDoneProgressOptions;
 /**
  * Type hierarchy options used during static or dynamic registration.
  *
  * @since 3.17.0 - proposed state
  */
-export interface TypeHierarchyRegistrationOptions extends TextDocumentRegistrationOptions, TypeHierarchyOptions, StaticRegistrationOptions {
-}
+export declare type TypeHierarchyRegistrationOptions = TextDocumentRegistrationOptions & TypeHierarchyOptions & StaticRegistrationOptions;
 /**
  * The parameter of a `textDocument/prepareTypeHierarchy` request.
  *
  * @since 3.17.0 - proposed state
  */
-export interface TypeHierarchyPrepareParams extends TextDocumentPositionParams, WorkDoneProgressParams {
-}
+export declare type TypeHierarchyPrepareParams = TextDocumentPositionParams & WorkDoneProgressParams;
 /**
  * A request to result a `TypeHierarchyItem` in a document at a given position.
  * Can be used as an input to a subtypes or supertypes type hierarchy.
@@ -50,9 +47,9 @@ export declare namespace TypeHierarchyPrepareRequest {
  *
  * @since 3.17.0 - proposed state
  */
-export interface TypeHierarchySupertypesParams extends WorkDoneProgressParams, PartialResultParams {
+export declare type TypeHierarchySupertypesParams = WorkDoneProgressParams & PartialResultParams & {
     item: TypeHierarchyItem;
-}
+};
 /**
  * A request to resolve the supertypes for a given `TypeHierarchyItem`.
  *
@@ -68,9 +65,9 @@ export declare namespace TypeHierarchySupertypesRequest {
  *
  * @since 3.17.0 - proposed state
  */
-export interface TypeHierarchySubtypesParams extends WorkDoneProgressParams, PartialResultParams {
+export declare type TypeHierarchySubtypesParams = WorkDoneProgressParams & PartialResultParams & {
     item: TypeHierarchyItem;
-}
+};
 /**
  * A request to resolve the subtypes for a given `TypeHierarchyItem`.
  *

package/lib/common/protocol.d.ts

@@ -129,6 +129,19 @@ export declare type NotebookCellTextDocumentFilter = {
      * notebook cell document.
      */
     cellLanguage?: string;
+} | {
+    /**
+     * A filter that matches against the notebook
+     * containing the notebook cell.
+     */
+    notebookDocument?: NotebookDocumentFilter;
+    /**
+     * A language id like `python`.
+     *
+     * Will be matched against the language id of the
+     * notebook cell document.
+     */
+    cellLanguage: string;
 };
 /**
  * The NotebookCellTextDocumentFilter namespace provides helper functions to work with

package/lib/common/protocol.js

@@ -97,7 +97,7 @@ var NotebookCellTextDocumentFilter;
 (function (NotebookCellTextDocumentFilter) {
     function is(value) {
         const candidate = value;
-        return Is.objectLiteral(candidate) && NotebookDocumentFilter.is(candidate.notebookDocument) && (candidate.cellLanguage === undefined || Is.string(candidate.cellLanguage));
+        return Is.objectLiteral(candidate) && (NotebookDocumentFilter.is(candidate.notebookDocument) || Is.string(candidate.cellLanguage));
     }
     NotebookCellTextDocumentFilter.is = is;
 })(NotebookCellTextDocumentFilter = exports.NotebookCellTextDocumentFilter || (exports.NotebookCellTextDocumentFilter = {}));

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "vscode-languageserver-protocol",
 	"description": "VSCode Language Server Protocol implementation",
-	"version": "3.17.0-next.12",
+	"version": "3.17.0-next.15",
 	"author": "Microsoft Corporation",
 	"license": "MIT",
 	"repository": {
@@ -18,8 +18,8 @@
 	},
 	"typings": "./lib/common/api.d.ts",
 	"dependencies": {
-		"vscode-jsonrpc": "8.0.0-next.5",
-		"vscode-languageserver-types": "3.17.0-next.6"
+		"vscode-jsonrpc": "8.0.0-next.7",
+		"vscode-languageserver-types": "3.17.0-next.8"
 	},
 	"scripts": {
 		"prepublishOnly": "git clean -xfd . && npm install && npm run clean && npm run compile && npm test",