@formspec/language-server 0.1.0-alpha.25 → 0.1.0-alpha.26

package/dist/language-server-alpha.d.ts

@@ -32,13 +32,23 @@ import type { Hover } from 'vscode-languageserver/node.js';
 import type { Location } from 'vscode-languageserver/node.js';
 import type { TextDocument } from 'vscode-languageserver-textdocument';
 
-/** @public */
+/**
+ * Half-open character span within a source comment string.
+ *
+ * @public
+ */
 export declare interface CommentSourceSpan {
+    /** Zero-based start offset, inclusive. */
     readonly start: number;
+    /** Zero-based end offset, exclusive. */
     readonly end: number;
 }
 
-/** @public */
+/**
+ * Source span used by serialized comment-analysis payloads.
+ *
+ * @public
+ */
 export declare type CommentSpan = CommentSourceSpan;
 
 /**
@@ -89,12 +99,19 @@ export declare function fileUriToPathOrNull(uri: string): string | null;
  * @public
  */
 export declare interface FormSpecAnalysisDiagnostic {
+    /** Stable diagnostic code for downstream rendering or filtering. */
     readonly code: string;
+    /** High-level diagnostic category. */
     readonly category: FormSpecAnalysisDiagnosticCategory;
+    /** Human-readable diagnostic message. */
     readonly message: string;
+    /** Source range where the diagnostic applies. */
     readonly range: CommentSpan;
+    /** Severity to surface in editor or CLI UIs. */
     readonly severity: "error" | "warning" | "info";
+    /** Additional source locations related to the diagnostic. */
     readonly relatedLocations: readonly FormSpecAnalysisDiagnosticLocation[];
+    /** Structured diagnostic facts for white-label downstream formatting. */
     readonly data: Record<string, FormSpecAnalysisDiagnosticDataValue>;
 }
 
@@ -119,88 +136,14 @@ export declare type FormSpecAnalysisDiagnosticDataValue = string | number | bool
  * @public
  */
 export declare interface FormSpecAnalysisDiagnosticLocation {
+    /** Absolute file path for the related diagnostic location. */
     readonly filePath: string;
+    /** Source range for the related diagnostic location. */
     readonly range: CommentSpan;
+    /** Optional explanatory text for the related location. */
     readonly message?: string;
 }
 
-/** @public */
-declare type FormSpecPlacement = "class" | "class-field" | "class-method" | "interface" | "interface-field" | "type-alias" | "type-alias-field" | "variable" | "function" | "function-parameter" | "method-parameter";
-
-/**
- * Cursor-scoped completion context serialized for transport between the
- * semantic tsserver plugin and the lightweight LSP.
- *
- * @public
- */
-declare type FormSpecSerializedCompletionContext = {
-    readonly kind: "tag-name";
-    readonly prefix: string;
-    readonly availableTags: readonly FormSpecSerializedTagDefinition[];
-} | {
-    readonly kind: "target";
-    readonly semantic: FormSpecSerializedTagSemanticContext;
-} | {
-    readonly kind: "argument";
-    readonly semantic: FormSpecSerializedTagSemanticContext;
-    readonly valueLabels: readonly string[];
-} | {
-    readonly kind: "none";
-};
-
-/**
- * Hover payload for a single comment token under the cursor.
- *
- * @public
- */
-declare interface FormSpecSerializedHoverInfo {
-    readonly kind: "tag-name" | "target" | "argument";
-    readonly markdown: string;
-}
-
-/**
- * Serializable subset of tag metadata needed by hover and completion UIs.
- *
- * @public
- */
-declare interface FormSpecSerializedTagDefinition {
-    readonly canonicalName: string;
-    readonly completionDetail: string;
-    readonly hoverMarkdown: string;
-}
-
-/**
- * Semantic facts about one parsed tag, reduced to JSON-safe data for IPC.
- *
- * @public
- */
-declare interface FormSpecSerializedTagSemanticContext {
-    readonly tagName: string;
-    readonly tagDefinition: FormSpecSerializedTagDefinition | null;
-    readonly placement: FormSpecPlacement | null;
-    readonly supportedTargets: readonly FormSpecTargetKind[];
-    readonly targetCompletions: readonly string[];
-    readonly compatiblePathTargets: readonly string[];
-    readonly valueLabels: readonly string[];
-    readonly signatures: readonly FormSpecSerializedTagSignature[];
-    readonly tagHoverMarkdown: string | null;
-    readonly targetHoverMarkdown: string | null;
-    readonly argumentHoverMarkdown: string | null;
-}
-
-/**
- * Serializable overload/signature summary for one comment tag form.
- *
- * @public
- */
-declare interface FormSpecSerializedTagSignature {
-    readonly label: string;
-    readonly placements: readonly FormSpecPlacement[];
-}
-
-/** @public */
-declare type FormSpecTargetKind = "none" | "path" | "member" | "variant";
-
 /**
  * Returns the full set of tag-name completions currently known to FormSpec.
  *
@@ -208,17 +151,6 @@ declare type FormSpecTargetKind = "none" | "path" | "member" | "variant";
  */
 export declare function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[];
 
-/**
- * Returns completion items for the cursor position at `offset` in `documentText`.
- *
- * When `semanticContext` is supplied (e.g. from {@link getPluginCompletionContextForDocument}),
- * it is used directly to produce target-value or tag-name completions. Pass `null` or omit it
- * to fall back to syntax-only analysis, which works without the TypeScript plugin.
- *
- * @public
- */
-export declare function getCompletionItemsAtOffset(documentText: string, offset: number, extensions?: readonly ExtensionDefinition[], semanticContext?: FormSpecSerializedCompletionContext | null): CompletionItem[];
-
 /**
  * Returns the definition location for a symbol at the given position.
  *
@@ -229,18 +161,6 @@ export declare function getCompletionItemsAtOffset(documentText: string, offset:
  */
 export declare function getDefinition(): Location | null;
 
-/**
- * Returns LSP hover content for the cursor position at `offset` in `documentText`.
- *
- * When `semanticHover` is supplied (e.g. from {@link getPluginHoverForDocument}), it is used
- * directly as the hover source. Pass `null` or omit it to fall back to syntax-only analysis,
- * which works without the TypeScript plugin. Returns `null` when the cursor is not over a
- * recognised FormSpec tag.
- *
- * @public
- */
-export declare function getHoverAtOffset(documentText: string, offset: number, extensions?: readonly ExtensionDefinition[], semanticHover?: FormSpecSerializedHoverInfo | null): Hover | null;
-
 /**
  * Returns hover content for a single FormSpec tag name.
  *
@@ -248,22 +168,6 @@ export declare function getHoverAtOffset(documentText: string, offset: number, e
  */
 export declare function getHoverForTag(tagName: string, extensions?: readonly ExtensionDefinition[]): Hover | null;
 
-/**
- * Queries the FormSpec TypeScript plugin for semantic completion context at `offset` in the
- * document identified by `filePath`.
- *
- * The workspace root containing `filePath` is located automatically from `workspaceRoots`. The
- * plugin manifest is read from disk on each call. Returns `null` when no matching workspace root
- * is found, the manifest is missing or invalid, the IPC socket is unavailable, the plugin times
- * out (default 2 s), or the plugin's response was computed against a different version of the
- * document than `documentText` (stale response guard).
- *
- * Pass the result to {@link getCompletionItemsAtOffset} as `semanticContext`.
- *
- * @public
- */
-export declare function getPluginCompletionContextForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, offset: number, timeoutMs?: number): Promise<FormSpecSerializedCompletionContext | null>;
-
 /**
  * Retrieves canonical FormSpec diagnostics for the current document revision
  * from the plugin transport. Returns `null` when the transport is missing,
@@ -273,22 +177,6 @@ export declare function getPluginCompletionContextForDocument(workspaceRoots: re
  */
 export declare function getPluginDiagnosticsForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, timeoutMs?: number): Promise<readonly FormSpecAnalysisDiagnostic[] | null>;
 
-/**
- * Queries the FormSpec TypeScript plugin for semantic hover information at `offset` in the
- * document identified by `filePath`.
- *
- * The workspace root containing `filePath` is located automatically from `workspaceRoots`. The
- * plugin manifest is read from disk on each call. Returns `null` when no matching workspace root
- * is found, the manifest is missing or invalid, the IPC socket is unavailable, the plugin times
- * out (default 2 s), or the plugin's response was computed against a different version of the
- * document than `documentText` (stale response guard).
- *
- * Pass the result to {@link getHoverAtOffset} as `semanticHover`.
- *
- * @public
- */
-export declare function getPluginHoverForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, offset: number, timeoutMs?: number): Promise<FormSpecSerializedHoverInfo | null>;
-
 /**
  * Converts canonical FormSpec diagnostics into LSP diagnostics.
  *

package/dist/language-server-beta.d.ts

@@ -32,13 +32,23 @@ import type { Hover } from 'vscode-languageserver/node.js';
 import type { Location } from 'vscode-languageserver/node.js';
 import type { TextDocument } from 'vscode-languageserver-textdocument';
 
-/** @public */
+/**
+ * Half-open character span within a source comment string.
+ *
+ * @public
+ */
 export declare interface CommentSourceSpan {
+    /** Zero-based start offset, inclusive. */
     readonly start: number;
+    /** Zero-based end offset, exclusive. */
     readonly end: number;
 }
 
-/** @public */
+/**
+ * Source span used by serialized comment-analysis payloads.
+ *
+ * @public
+ */
 export declare type CommentSpan = CommentSourceSpan;
 
 /**
@@ -89,12 +99,19 @@ export declare function fileUriToPathOrNull(uri: string): string | null;
  * @public
  */
 export declare interface FormSpecAnalysisDiagnostic {
+    /** Stable diagnostic code for downstream rendering or filtering. */
     readonly code: string;
+    /** High-level diagnostic category. */
     readonly category: FormSpecAnalysisDiagnosticCategory;
+    /** Human-readable diagnostic message. */
     readonly message: string;
+    /** Source range where the diagnostic applies. */
     readonly range: CommentSpan;
+    /** Severity to surface in editor or CLI UIs. */
     readonly severity: "error" | "warning" | "info";
+    /** Additional source locations related to the diagnostic. */
     readonly relatedLocations: readonly FormSpecAnalysisDiagnosticLocation[];
+    /** Structured diagnostic facts for white-label downstream formatting. */
     readonly data: Record<string, FormSpecAnalysisDiagnosticDataValue>;
 }
 
@@ -119,88 +136,14 @@ export declare type FormSpecAnalysisDiagnosticDataValue = string | number | bool
  * @public
  */
 export declare interface FormSpecAnalysisDiagnosticLocation {
+    /** Absolute file path for the related diagnostic location. */
     readonly filePath: string;
+    /** Source range for the related diagnostic location. */
     readonly range: CommentSpan;
+    /** Optional explanatory text for the related location. */
     readonly message?: string;
 }
 
-/** @public */
-declare type FormSpecPlacement = "class" | "class-field" | "class-method" | "interface" | "interface-field" | "type-alias" | "type-alias-field" | "variable" | "function" | "function-parameter" | "method-parameter";
-
-/**
- * Cursor-scoped completion context serialized for transport between the
- * semantic tsserver plugin and the lightweight LSP.
- *
- * @public
- */
-declare type FormSpecSerializedCompletionContext = {
-    readonly kind: "tag-name";
-    readonly prefix: string;
-    readonly availableTags: readonly FormSpecSerializedTagDefinition[];
-} | {
-    readonly kind: "target";
-    readonly semantic: FormSpecSerializedTagSemanticContext;
-} | {
-    readonly kind: "argument";
-    readonly semantic: FormSpecSerializedTagSemanticContext;
-    readonly valueLabels: readonly string[];
-} | {
-    readonly kind: "none";
-};
-
-/**
- * Hover payload for a single comment token under the cursor.
- *
- * @public
- */
-declare interface FormSpecSerializedHoverInfo {
-    readonly kind: "tag-name" | "target" | "argument";
-    readonly markdown: string;
-}
-
-/**
- * Serializable subset of tag metadata needed by hover and completion UIs.
- *
- * @public
- */
-declare interface FormSpecSerializedTagDefinition {
-    readonly canonicalName: string;
-    readonly completionDetail: string;
-    readonly hoverMarkdown: string;
-}
-
-/**
- * Semantic facts about one parsed tag, reduced to JSON-safe data for IPC.
- *
- * @public
- */
-declare interface FormSpecSerializedTagSemanticContext {
-    readonly tagName: string;
-    readonly tagDefinition: FormSpecSerializedTagDefinition | null;
-    readonly placement: FormSpecPlacement | null;
-    readonly supportedTargets: readonly FormSpecTargetKind[];
-    readonly targetCompletions: readonly string[];
-    readonly compatiblePathTargets: readonly string[];
-    readonly valueLabels: readonly string[];
-    readonly signatures: readonly FormSpecSerializedTagSignature[];
-    readonly tagHoverMarkdown: string | null;
-    readonly targetHoverMarkdown: string | null;
-    readonly argumentHoverMarkdown: string | null;
-}
-
-/**
- * Serializable overload/signature summary for one comment tag form.
- *
- * @public
- */
-declare interface FormSpecSerializedTagSignature {
-    readonly label: string;
-    readonly placements: readonly FormSpecPlacement[];
-}
-
-/** @public */
-declare type FormSpecTargetKind = "none" | "path" | "member" | "variant";
-
 /**
  * Returns the full set of tag-name completions currently known to FormSpec.
  *
@@ -208,17 +151,6 @@ declare type FormSpecTargetKind = "none" | "path" | "member" | "variant";
  */
 export declare function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[];
 
-/**
- * Returns completion items for the cursor position at `offset` in `documentText`.
- *
- * When `semanticContext` is supplied (e.g. from {@link getPluginCompletionContextForDocument}),
- * it is used directly to produce target-value or tag-name completions. Pass `null` or omit it
- * to fall back to syntax-only analysis, which works without the TypeScript plugin.
- *
- * @public
- */
-export declare function getCompletionItemsAtOffset(documentText: string, offset: number, extensions?: readonly ExtensionDefinition[], semanticContext?: FormSpecSerializedCompletionContext | null): CompletionItem[];
-
 /**
  * Returns the definition location for a symbol at the given position.
  *
@@ -229,18 +161,6 @@ export declare function getCompletionItemsAtOffset(documentText: string, offset:
  */
 export declare function getDefinition(): Location | null;
 
-/**
- * Returns LSP hover content for the cursor position at `offset` in `documentText`.
- *
- * When `semanticHover` is supplied (e.g. from {@link getPluginHoverForDocument}), it is used
- * directly as the hover source. Pass `null` or omit it to fall back to syntax-only analysis,
- * which works without the TypeScript plugin. Returns `null` when the cursor is not over a
- * recognised FormSpec tag.
- *
- * @public
- */
-export declare function getHoverAtOffset(documentText: string, offset: number, extensions?: readonly ExtensionDefinition[], semanticHover?: FormSpecSerializedHoverInfo | null): Hover | null;
-
 /**
  * Returns hover content for a single FormSpec tag name.
  *
@@ -248,22 +168,6 @@ export declare function getHoverAtOffset(documentText: string, offset: number, e
  */
 export declare function getHoverForTag(tagName: string, extensions?: readonly ExtensionDefinition[]): Hover | null;
 
-/**
- * Queries the FormSpec TypeScript plugin for semantic completion context at `offset` in the
- * document identified by `filePath`.
- *
- * The workspace root containing `filePath` is located automatically from `workspaceRoots`. The
- * plugin manifest is read from disk on each call. Returns `null` when no matching workspace root
- * is found, the manifest is missing or invalid, the IPC socket is unavailable, the plugin times
- * out (default 2 s), or the plugin's response was computed against a different version of the
- * document than `documentText` (stale response guard).
- *
- * Pass the result to {@link getCompletionItemsAtOffset} as `semanticContext`.
- *
- * @public
- */
-export declare function getPluginCompletionContextForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, offset: number, timeoutMs?: number): Promise<FormSpecSerializedCompletionContext | null>;
-
 /**
  * Retrieves canonical FormSpec diagnostics for the current document revision
  * from the plugin transport. Returns `null` when the transport is missing,
@@ -273,22 +177,6 @@ export declare function getPluginCompletionContextForDocument(workspaceRoots: re
  */
 export declare function getPluginDiagnosticsForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, timeoutMs?: number): Promise<readonly FormSpecAnalysisDiagnostic[] | null>;
 
-/**
- * Queries the FormSpec TypeScript plugin for semantic hover information at `offset` in the
- * document identified by `filePath`.
- *
- * The workspace root containing `filePath` is located automatically from `workspaceRoots`. The
- * plugin manifest is read from disk on each call. Returns `null` when no matching workspace root
- * is found, the manifest is missing or invalid, the IPC socket is unavailable, the plugin times
- * out (default 2 s), or the plugin's response was computed against a different version of the
- * document than `documentText` (stale response guard).
- *
- * Pass the result to {@link getHoverAtOffset} as `semanticHover`.
- *
- * @public
- */
-export declare function getPluginHoverForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, offset: number, timeoutMs?: number): Promise<FormSpecSerializedHoverInfo | null>;
-
 /**
  * Converts canonical FormSpec diagnostics into LSP diagnostics.
  *

package/dist/language-server-internal.d.ts

@@ -32,13 +32,23 @@ import type { Hover } from 'vscode-languageserver/node.js';
 import type { Location } from 'vscode-languageserver/node.js';
 import type { TextDocument } from 'vscode-languageserver-textdocument';
 
-/** @public */
+/**
+ * Half-open character span within a source comment string.
+ *
+ * @public
+ */
 export declare interface CommentSourceSpan {
+    /** Zero-based start offset, inclusive. */
     readonly start: number;
+    /** Zero-based end offset, exclusive. */
     readonly end: number;
 }
 
-/** @public */
+/**
+ * Source span used by serialized comment-analysis payloads.
+ *
+ * @public
+ */
 export declare type CommentSpan = CommentSourceSpan;
 
 /**
@@ -89,12 +99,19 @@ export declare function fileUriToPathOrNull(uri: string): string | null;
  * @public
  */
 export declare interface FormSpecAnalysisDiagnostic {
+    /** Stable diagnostic code for downstream rendering or filtering. */
     readonly code: string;
+    /** High-level diagnostic category. */
     readonly category: FormSpecAnalysisDiagnosticCategory;
+    /** Human-readable diagnostic message. */
     readonly message: string;
+    /** Source range where the diagnostic applies. */
     readonly range: CommentSpan;
+    /** Severity to surface in editor or CLI UIs. */
     readonly severity: "error" | "warning" | "info";
+    /** Additional source locations related to the diagnostic. */
     readonly relatedLocations: readonly FormSpecAnalysisDiagnosticLocation[];
+    /** Structured diagnostic facts for white-label downstream formatting. */
     readonly data: Record<string, FormSpecAnalysisDiagnosticDataValue>;
 }
 
@@ -119,88 +136,14 @@ export declare type FormSpecAnalysisDiagnosticDataValue = string | number | bool
  * @public
  */
 export declare interface FormSpecAnalysisDiagnosticLocation {
+    /** Absolute file path for the related diagnostic location. */
     readonly filePath: string;
+    /** Source range for the related diagnostic location. */
     readonly range: CommentSpan;
+    /** Optional explanatory text for the related location. */
     readonly message?: string;
 }
 
-/** @public */
-declare type FormSpecPlacement = "class" | "class-field" | "class-method" | "interface" | "interface-field" | "type-alias" | "type-alias-field" | "variable" | "function" | "function-parameter" | "method-parameter";
-
-/**
- * Cursor-scoped completion context serialized for transport between the
- * semantic tsserver plugin and the lightweight LSP.
- *
- * @public
- */
-declare type FormSpecSerializedCompletionContext = {
-    readonly kind: "tag-name";
-    readonly prefix: string;
-    readonly availableTags: readonly FormSpecSerializedTagDefinition[];
-} | {
-    readonly kind: "target";
-    readonly semantic: FormSpecSerializedTagSemanticContext;
-} | {
-    readonly kind: "argument";
-    readonly semantic: FormSpecSerializedTagSemanticContext;
-    readonly valueLabels: readonly string[];
-} | {
-    readonly kind: "none";
-};
-
-/**
- * Hover payload for a single comment token under the cursor.
- *
- * @public
- */
-declare interface FormSpecSerializedHoverInfo {
-    readonly kind: "tag-name" | "target" | "argument";
-    readonly markdown: string;
-}
-
-/**
- * Serializable subset of tag metadata needed by hover and completion UIs.
- *
- * @public
- */
-declare interface FormSpecSerializedTagDefinition {
-    readonly canonicalName: string;
-    readonly completionDetail: string;
-    readonly hoverMarkdown: string;
-}
-
-/**
- * Semantic facts about one parsed tag, reduced to JSON-safe data for IPC.
- *
- * @public
- */
-declare interface FormSpecSerializedTagSemanticContext {
-    readonly tagName: string;
-    readonly tagDefinition: FormSpecSerializedTagDefinition | null;
-    readonly placement: FormSpecPlacement | null;
-    readonly supportedTargets: readonly FormSpecTargetKind[];
-    readonly targetCompletions: readonly string[];
-    readonly compatiblePathTargets: readonly string[];
-    readonly valueLabels: readonly string[];
-    readonly signatures: readonly FormSpecSerializedTagSignature[];
-    readonly tagHoverMarkdown: string | null;
-    readonly targetHoverMarkdown: string | null;
-    readonly argumentHoverMarkdown: string | null;
-}
-
-/**
- * Serializable overload/signature summary for one comment tag form.
- *
- * @public
- */
-declare interface FormSpecSerializedTagSignature {
-    readonly label: string;
-    readonly placements: readonly FormSpecPlacement[];
-}
-
-/** @public */
-declare type FormSpecTargetKind = "none" | "path" | "member" | "variant";
-
 /**
  * Returns the full set of tag-name completions currently known to FormSpec.
  *
@@ -208,17 +151,6 @@ declare type FormSpecTargetKind = "none" | "path" | "member" | "variant";
  */
 export declare function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[];
 
-/**
- * Returns completion items for the cursor position at `offset` in `documentText`.
- *
- * When `semanticContext` is supplied (e.g. from {@link getPluginCompletionContextForDocument}),
- * it is used directly to produce target-value or tag-name completions. Pass `null` or omit it
- * to fall back to syntax-only analysis, which works without the TypeScript plugin.
- *
- * @public
- */
-export declare function getCompletionItemsAtOffset(documentText: string, offset: number, extensions?: readonly ExtensionDefinition[], semanticContext?: FormSpecSerializedCompletionContext | null): CompletionItem[];
-
 /**
  * Returns the definition location for a symbol at the given position.
  *
@@ -229,18 +161,6 @@ export declare function getCompletionItemsAtOffset(documentText: string, offset:
  */
 export declare function getDefinition(): Location | null;
 
-/**
- * Returns LSP hover content for the cursor position at `offset` in `documentText`.
- *
- * When `semanticHover` is supplied (e.g. from {@link getPluginHoverForDocument}), it is used
- * directly as the hover source. Pass `null` or omit it to fall back to syntax-only analysis,
- * which works without the TypeScript plugin. Returns `null` when the cursor is not over a
- * recognised FormSpec tag.
- *
- * @public
- */
-export declare function getHoverAtOffset(documentText: string, offset: number, extensions?: readonly ExtensionDefinition[], semanticHover?: FormSpecSerializedHoverInfo | null): Hover | null;
-
 /**
  * Returns hover content for a single FormSpec tag name.
  *
@@ -248,22 +168,6 @@ export declare function getHoverAtOffset(documentText: string, offset: number, e
  */
 export declare function getHoverForTag(tagName: string, extensions?: readonly ExtensionDefinition[]): Hover | null;
 
-/**
- * Queries the FormSpec TypeScript plugin for semantic completion context at `offset` in the
- * document identified by `filePath`.
- *
- * The workspace root containing `filePath` is located automatically from `workspaceRoots`. The
- * plugin manifest is read from disk on each call. Returns `null` when no matching workspace root
- * is found, the manifest is missing or invalid, the IPC socket is unavailable, the plugin times
- * out (default 2 s), or the plugin's response was computed against a different version of the
- * document than `documentText` (stale response guard).
- *
- * Pass the result to {@link getCompletionItemsAtOffset} as `semanticContext`.
- *
- * @public
- */
-export declare function getPluginCompletionContextForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, offset: number, timeoutMs?: number): Promise<FormSpecSerializedCompletionContext | null>;
-
 /**
  * Retrieves canonical FormSpec diagnostics for the current document revision
  * from the plugin transport. Returns `null` when the transport is missing,
@@ -273,22 +177,6 @@ export declare function getPluginCompletionContextForDocument(workspaceRoots: re
  */
 export declare function getPluginDiagnosticsForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, timeoutMs?: number): Promise<readonly FormSpecAnalysisDiagnostic[] | null>;
 
-/**
- * Queries the FormSpec TypeScript plugin for semantic hover information at `offset` in the
- * document identified by `filePath`.
- *
- * The workspace root containing `filePath` is located automatically from `workspaceRoots`. The
- * plugin manifest is read from disk on each call. Returns `null` when no matching workspace root
- * is found, the manifest is missing or invalid, the IPC socket is unavailable, the plugin times
- * out (default 2 s), or the plugin's response was computed against a different version of the
- * document than `documentText` (stale response guard).
- *
- * Pass the result to {@link getHoverAtOffset} as `semanticHover`.
- *
- * @public
- */
-export declare function getPluginHoverForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, offset: number, timeoutMs?: number): Promise<FormSpecSerializedHoverInfo | null>;
-
 /**
  * Converts canonical FormSpec diagnostics into LSP diagnostics.
  *