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

package/dist/index.d.ts

@@ -262,13 +262,20 @@ export declare interface BlockViewOptions {
 }
 
 export declare class CodeBlockAstNode extends BlockAstNodeBase {
+    /** First token of the fenced code block info string, used for syntax highlighting. */
     readonly language: string;
+    /** Complete fenced code block info string, including metadata after the language token. */
+    readonly infoString: string;
     readonly content: readonly (MarkerAstNode | GlueAstNode)[];
     readonly leadingTrivia?: GlueAstNode | undefined;
     readonly kind = "codeBlock";
     private _previous?;
     private _contentEdit?;
-    constructor(language: string, content: readonly (MarkerAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
+    constructor(
+    /** First token of the fenced code block info string, used for syntax highlighting. */
+    language: string, 
+    /** Complete fenced code block info string, including metadata after the language token. */
+    infoString: string, content: readonly (MarkerAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
     get children(): readonly AstNode[];
     get openFence(): MarkerAstNode | undefined;
     get closeFence(): MarkerAstNode | undefined;
@@ -581,6 +588,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 +1812,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
@@ -1894,10 +1917,10 @@ declare interface IEmbeddedCodeEditor {
 /** Creates an {@link IEmbeddedCodeEditor} for a fenced block, or opts out. */
 declare interface IEmbeddedCodeEditorFactory {
     /**
-     * Return an editor for a fenced block of `language`, or `undefined` to fall
+     * Return an editor for a fenced block, or `undefined` to fall
      * back to the default (highlighting / {@link BlockViewOptions.renderCustomCodeBlock}).
      */
-    create(language: string, initialContent: string): IEmbeddedCodeEditor | undefined;
+    create(language: string, infoString: string, initialContent: string): IEmbeddedCodeEditor | undefined;
 }
 
 /**
@@ -2017,6 +2040,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 +2511,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 +3018,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[]);
 }
 
 /**