@vscode/markdown-editor 0.0.2-54 → 0.0.2-55

package/dist/index.d.ts

@@ -581,6 +581,13 @@ export declare class CommentsView extends Disposable {
     private _applyHover;
 }
 
+/** The lossless source slices of a complete block HTML comment. */
+declare interface CompleteHtmlCommentSource extends HtmlCommentSourceBase {
+    readonly kind: 'complete';
+    readonly closing: '-->';
+    readonly trailingWhitespace: string;
+}
+
 /**
  * A {@link MonacoSyntaxHighlighter} preloaded with a handful of common Monarch
  * grammars (plus the usual short aliases). Unknown languages fall back to an
@@ -1798,6 +1805,15 @@ export declare function hiddenCursorRanges(doc: DocumentAstNode, markerVisibleBl
 
 export declare type HistoryKeyboardAction = 'undo' | 'redo';
 
+/** A block HTML comment, discriminated by whether its closing delimiter is present. */
+declare type HtmlCommentSource = OpenHtmlCommentSource | CompleteHtmlCommentSource;
+
+declare interface HtmlCommentSourceBase {
+    readonly leadingWhitespace: string;
+    readonly opening: '<!--';
+    readonly body: string;
+}
+
 /**
  * The editor operations a clipboard strategy drives. The strategy never
  * touches the model or the DOM directly — it asks through this seam, so the
@@ -2017,6 +2033,9 @@ export declare const insertParagraph: EditCommand;
  *  - block quote — continue the quote (`\n> `); an empty quote line exits it.
  *  - list — continue the list with the next marker (incrementing ordered
  *    numbers, re-emitting task checkboxes); an empty item exits the list.
+ *  - complete HTML comment — at the comment's end, leave it by arming a
+ *    transient paragraph; inside it (or while the comment is open), insert a
+ *    normal source line break.
  * A non-collapsed selection, or any other block, falls back to a plain soft line
  * break, preserving today's behaviour.
  */
@@ -2485,6 +2504,11 @@ export declare class OffsetRange {
     toString(): string;
 }
 
+/** The lossless source slices of a block HTML comment whose closer has not been typed. */
+declare interface OpenHtmlCommentSource extends HtmlCommentSourceBase {
+    readonly kind: 'open';
+}
+
 /** Outdent the current line, or every line touched by the selection. */
 export declare function outdent(config?: IndentationConfig): EditCommand;
 
@@ -2987,21 +3011,29 @@ declare class UnhandledBlockAstNode extends BlockAstNodeBase {
     constructor(tokenType: string, content: readonly (MarkerAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
     get children(): readonly AstNode[];
     get code(): MarkerAstNode | undefined;
+    /**
+     * Lossless slices when this raw HTML block starts one comment after optional
+     * whitespace. An open comment consumes the remaining source as its body. A
+     * complete comment permits only trailing whitespace after its closer.
+     */
+    get htmlComment(): HtmlCommentSource | undefined;
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
     withLeadingTrivia(trivia: GlueAstNode | undefined): UnhandledBlockAstNode;
     protected _localEquals(o: this): boolean;
 }
 
 /**
- * View-data for an {@link UnhandledBlockAstNode}. It has no active/inactive
- * split — the raw source *is* both the source and the rendered form — so it
- * carries no `showMarkup` flag; the renderer always shows the verbatim text.
+ * View-data for an {@link UnhandledBlockAstNode}. The source remains verbatim
+ * in both states. Complete HTML comments use {@link showMarkup} to switch
+ * between their quiet reading treatment and editable source presentation;
+ * other unhandled blocks ignore the flag and keep their warning treatment.
  */
 declare class UnhandledBlockViewData {
     readonly ast: UnhandledBlockAstNode;
+    readonly showMarkup: boolean;
     readonly content: readonly AnyViewData[];
     readonly kind = "unhandledBlock";
-    constructor(ast: UnhandledBlockAstNode, content: readonly AnyViewData[]);
+    constructor(ast: UnhandledBlockAstNode, showMarkup: boolean, content: readonly AnyViewData[]);
 }
 
 /**