@formspec/language-server 0.1.0-alpha.20 → 0.1.0-alpha.22

package/README.md

@@ -2,6 +2,11 @@
 
 Language-server support for FormSpec TSDoc tags.
 
+The packaged server is a reference implementation built on top of the
+composable completion, hover, and diagnostics helpers exported by this package.
+Downstream tools can reuse those helpers directly and own the final publishing
+and presentation behavior themselves.
+
 ## Install
 
 ```bash
@@ -13,19 +18,45 @@ pnpm add @formspec/language-server
 - completion items for FormSpec tags
 - hover documentation for recognized tags
 - go-to-definition support for known tags
+- optional plugin-backed diagnostics publishing
 
-Diagnostics are intentionally handled elsewhere; this package focuses on editor assistance.
+Diagnostics are off by default. When enabled, the packaged server consumes
+canonical FormSpec diagnostics from `@formspec/ts-plugin` and converts them to
+LSP diagnostics using the same exported helpers that downstream consumers can
+call directly.
 
 ## Usage
 
 ```ts
-import { createServer, getCompletionItems, getHoverForTag } from "@formspec/language-server";
+import {
+  createServer,
+  getCompletionItems,
+  getHoverForTag,
+  getPluginDiagnosticsForDocument,
+  toLspDiagnostics,
+} from "@formspec/language-server";
 
 const server = createServer();
 const completions = getCompletionItems();
 const hover = getHoverForTag("minimum");
 ```
 
+To enable packaged diagnostics publishing:
+
+```ts
+const server = createServer({
+  diagnosticsMode: "plugin",
+  diagnosticSource: "formspec",
+});
+```
+
+For full white-label control, bypass `createServer()` and use:
+
+- `getPluginDiagnosticsForDocument(...)`
+- `toLspDiagnostics(...)`
+
+or map canonical FormSpec diagnostics to your own editor/UI model directly.
+
 ## License
 
 UNLICENSED

package/dist/__tests__/diagnostics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostics.test.d.ts.map

package/dist/__tests__/diagnostics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/diagnostics.test.ts"],"names":[],"mappings":""}

package/dist/diagnostics.d.ts

@@ -0,0 +1,23 @@
+import type { FormSpecAnalysisDiagnostic } from "@formspec/analysis/protocol";
+import { type Diagnostic } from "vscode-languageserver/node.js";
+import type { TextDocument } from "vscode-languageserver-textdocument";
+export { getPluginDiagnosticsForDocument } from "./plugin-client.js";
+/**
+ * Options for converting canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * @public
+ */
+export interface ToLspDiagnosticsOptions {
+    /** Source label shown by LSP clients. Defaults to `formspec`. */
+    readonly source?: string;
+}
+/**
+ * Converts canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * Downstream consumers that want complete white-label control can ignore this
+ * helper and render their own messages from `code` + `data`.
+ *
+ * @public
+ */
+export declare function toLspDiagnostics(document: TextDocument, diagnostics: readonly FormSpecAnalysisDiagnostic[], options?: ToLspDiagnosticsOptions): Diagnostic[];
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,SAAS,0BAA0B,EAAE,EAClD,OAAO,GAAE,uBAA4B,GACpC,UAAU,EAAE,CAiBd"}

package/dist/index.cjs

@@ -33,19 +33,21 @@ __export(index_exports, {
   createServer: () => createServer,
   getCompletionItems: () => getCompletionItems,
   getDefinition: () => getDefinition,
-  getHoverForTag: () => getHoverForTag
+  getHoverForTag: () => getHoverForTag,
+  getPluginDiagnosticsForDocument: () => getPluginDiagnosticsForDocument,
+  toLspDiagnostics: () => toLspDiagnostics
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/server.ts
-var import_node2 = require("vscode-languageserver/node.js");
+var import_node3 = require("vscode-languageserver/node.js");
 var import_vscode_languageserver_textdocument = require("vscode-languageserver-textdocument");
 
 // src/providers/completion.ts
-var import_analysis = require("@formspec/analysis");
+var import_internal = require("@formspec/analysis/internal");
 var import_node = require("vscode-languageserver/node.js");
 function getCompletionItems(extensions) {
-  return (0, import_analysis.getConstraintTagDefinitions)(extensions).map((tag) => ({
+  return (0, import_internal.getConstraintTagDefinitions)(extensions).map((tag) => ({
     label: `@${tag.canonicalName}`,
     kind: import_node.CompletionItemKind.Keyword,
     detail: tag.completionDetail
@@ -58,45 +60,52 @@ function toCompletionItem(tag) {
     detail: tag.completionDetail
   };
 }
+function toTargetCompletionItems(tagName, targetCompletions) {
+  return targetCompletions.map((target) => ({
+    label: target,
+    kind: target === "singular" || target === "plural" ? import_node.CompletionItemKind.EnumMember : import_node.CompletionItemKind.Field,
+    detail: `Target for @${tagName}`
+  }));
+}
+function filterTagNameCompletionItems(prefix, availableTags) {
+  const normalizedPrefix = prefix.toLowerCase();
+  return availableTags.map(toCompletionItem).filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));
+}
 function getCompletionItemsAtOffset(documentText, offset, extensions, semanticContext) {
   if (semanticContext !== null && semanticContext !== void 0) {
     if (semanticContext.kind === "target") {
-      return semanticContext.semantic.targetCompletions.map((target) => ({
-        label: target,
-        kind: target === "singular" || target === "plural" ? import_node.CompletionItemKind.EnumMember : import_node.CompletionItemKind.Field,
-        detail: `Target for @${semanticContext.semantic.tagName}`
-      }));
+      return toTargetCompletionItems(
+        semanticContext.semantic.tagName,
+        semanticContext.semantic.targetCompletions
+      );
     }
     if (semanticContext.kind !== "tag-name") {
       return [];
     }
-    const normalizedPrefix2 = semanticContext.prefix.toLowerCase();
-    return semanticContext.availableTags.map(toCompletionItem).filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix2));
+    return filterTagNameCompletionItems(semanticContext.prefix, semanticContext.availableTags);
   }
-  const resolvedContext = (0, import_analysis.getSemanticCommentCompletionContextAtOffset)(
+  const resolvedContext = (0, import_internal.getSemanticCommentCompletionContextAtOffset)(
     documentText,
     offset,
     extensions ? { extensions } : void 0
   );
   if (resolvedContext.kind === "target") {
-    return resolvedContext.semantic.targetCompletions.map((target) => ({
-      label: target,
-      kind: target === "singular" || target === "plural" ? import_node.CompletionItemKind.EnumMember : import_node.CompletionItemKind.Field,
-      detail: `Target for @${resolvedContext.semantic.tag.normalizedTagName}`
-    }));
+    return toTargetCompletionItems(
+      resolvedContext.semantic.tag.normalizedTagName,
+      resolvedContext.semantic.targetCompletions
+    );
   }
   if (resolvedContext.kind !== "tag-name") {
     return [];
   }
-  const normalizedPrefix = resolvedContext.prefix.toLowerCase();
-  return resolvedContext.availableTags.map(toCompletionItem).filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));
+  return filterTagNameCompletionItems(resolvedContext.prefix, resolvedContext.availableTags);
 }
 
 // src/providers/hover.ts
-var import_analysis2 = require("@formspec/analysis");
+var import_internal2 = require("@formspec/analysis/internal");
 function getHoverForTag(tagName, extensions) {
   const raw = tagName.startsWith("@") ? tagName.slice(1) : tagName;
-  const definition = (0, import_analysis2.getTagDefinition)((0, import_analysis2.normalizeFormSpecTagName)(raw), extensions);
+  const definition = (0, import_internal2.getTagDefinition)((0, import_internal2.normalizeFormSpecTagName)(raw), extensions);
   if (!definition) {
     return null;
   }
@@ -108,7 +117,7 @@ function getHoverForTag(tagName, extensions) {
   };
 }
 function getHoverAtOffset(documentText, offset, extensions, semanticHover) {
-  const hoverInfo = semanticHover ?? (0, import_analysis2.getCommentHoverInfoAtOffset)(documentText, offset, extensions ? { extensions } : void 0);
+  const hoverInfo = semanticHover ?? (0, import_internal2.getCommentHoverInfoAtOffset)(documentText, offset, extensions ? { extensions } : void 0);
   if (hoverInfo === null) {
     return null;
   }
@@ -125,15 +134,18 @@ function getDefinition() {
   return null;
 }
 
+// src/diagnostics.ts
+var import_node2 = require("vscode-languageserver/node.js");
+
 // src/plugin-client.ts
 var import_promises = __toESM(require("fs/promises"), 1);
 var import_node_net = __toESM(require("net"), 1);
 var import_node_path = __toESM(require("path"), 1);
 var import_node_url = require("url");
-var import_analysis3 = require("@formspec/analysis");
+var import_protocol = require("@formspec/analysis/protocol");
 var DEFAULT_PLUGIN_QUERY_TIMEOUT_MS = 2e3;
 function getManifestPath(workspaceRoot) {
-  return (0, import_analysis3.getFormSpecManifestPath)(workspaceRoot);
+  return (0, import_protocol.getFormSpecManifestPath)(workspaceRoot);
 }
 function normalizeWorkspaceRoot(root) {
   const resolved = import_node_path.default.resolve(root);
@@ -155,7 +167,7 @@ async function readManifest(workspaceRoot) {
   try {
     const manifestText = await import_promises.default.readFile(getManifestPath(workspaceRoot), "utf8");
     const manifest = JSON.parse(manifestText);
-    if (!(0, import_analysis3.isFormSpecAnalysisManifest)(manifest)) {
+    if (!(0, import_protocol.isFormSpecAnalysisManifest)(manifest)) {
       return null;
     }
     return manifest;
@@ -195,7 +207,7 @@ async function sendSemanticQuery(manifest, query, timeoutMs = DEFAULT_PLUGIN_QUE
       buffer = buffer.slice(newlineIndex + 1);
       try {
         const response = JSON.parse(payload);
-        finish((0, import_analysis3.isFormSpecSemanticResponse)(response) ? response : null);
+        finish((0, import_protocol.isFormSpecSemanticResponse)(response) ? response : null);
       } catch {
         finish(null);
       }
@@ -231,7 +243,7 @@ async function getPluginCompletionContextForDocument(workspaceRoots, filePath, d
     workspaceRoots,
     filePath,
     {
-      protocolVersion: import_analysis3.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+      protocolVersion: import_protocol.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
       kind: "completion",
       filePath,
       offset
@@ -241,14 +253,14 @@ async function getPluginCompletionContextForDocument(workspaceRoots, filePath, d
   if (response?.kind !== "completion") {
     return null;
   }
-  return response.sourceHash === (0, import_analysis3.computeFormSpecTextHash)(documentText) ? response.context : null;
+  return response.sourceHash === (0, import_protocol.computeFormSpecTextHash)(documentText) ? response.context : null;
 }
 async function getPluginHoverForDocument(workspaceRoots, filePath, documentText, offset, timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS) {
   const response = await sendFileQuery(
     workspaceRoots,
     filePath,
     {
-      protocolVersion: import_analysis3.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+      protocolVersion: import_protocol.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
       kind: "hover",
       filePath,
       offset
@@ -258,13 +270,95 @@ async function getPluginHoverForDocument(workspaceRoots, filePath, documentText,
   if (response?.kind !== "hover") {
     return null;
   }
-  return response.sourceHash === (0, import_analysis3.computeFormSpecTextHash)(documentText) ? response.hover : null;
+  return response.sourceHash === (0, import_protocol.computeFormSpecTextHash)(documentText) ? response.hover : null;
+}
+async function getPluginDiagnosticsForDocument(workspaceRoots, filePath, documentText, timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS) {
+  const response = await sendFileQuery(
+    workspaceRoots,
+    filePath,
+    {
+      protocolVersion: import_protocol.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+      kind: "diagnostics",
+      filePath
+    },
+    timeoutMs
+  );
+  if (response?.kind !== "diagnostics") {
+    return null;
+  }
+  return response.sourceHash === (0, import_protocol.computeFormSpecTextHash)(documentText) ? response.diagnostics : null;
+}
+
+// src/diagnostics.ts
+function toLspDiagnostics(document, diagnostics, options = {}) {
+  const source = options.source ?? "formspec";
+  return diagnostics.map((diagnostic) => {
+    const relatedInformation = toRelatedInformation(document, diagnostic.relatedLocations);
+    return {
+      range: spanToRange(document, diagnostic.range.start, diagnostic.range.end),
+      severity: toLspSeverity(diagnostic.severity),
+      source,
+      code: diagnostic.code,
+      message: diagnostic.message,
+      ...relatedInformation === void 0 ? {} : { relatedInformation },
+      data: {
+        ...diagnostic.data,
+        category: diagnostic.category
+      }
+    };
+  });
+}
+function spanToRange(document, start, end) {
+  return import_node2.Range.create(document.positionAt(start), document.positionAt(end));
+}
+function toLspSeverity(severity) {
+  switch (severity) {
+    case "error":
+      return import_node2.DiagnosticSeverity.Error;
+    case "warning":
+      return import_node2.DiagnosticSeverity.Warning;
+    case "info":
+      return import_node2.DiagnosticSeverity.Information;
+    default:
+      return import_node2.DiagnosticSeverity.Information;
+  }
+}
+function toRelatedInformation(document, locations) {
+  if (locations.length === 0) {
+    return void 0;
+  }
+  const currentDocumentFilePath = getDocumentFilePath(document);
+  const relatedInformation = locations.filter((location) => location.filePath === currentDocumentFilePath).map(
+    (location) => import_node2.DiagnosticRelatedInformation.create(
+      import_node2.Location.create(
+        document.uri,
+        spanToRange(document, location.range.start, location.range.end)
+      ),
+      location.message ?? "Related FormSpec location"
+    )
+  );
+  return relatedInformation.length === 0 ? void 0 : relatedInformation;
+}
+function getDocumentFilePath(document) {
+  return fileUriToPathOrNull(document.uri);
 }
 
 // src/server.ts
+var PLUGIN_QUERY_TIMEOUT_ENV_VAR = "FORMSPEC_PLUGIN_QUERY_TIMEOUT_MS";
 function dedupeWorkspaceRoots(workspaceRoots) {
   return [...new Set(workspaceRoots)];
 }
+function resolvePluginQueryTimeoutMs(explicitTimeoutMs) {
+  if (explicitTimeoutMs !== void 0) {
+    return explicitTimeoutMs;
+  }
+  const rawValue = process.env[PLUGIN_QUERY_TIMEOUT_ENV_VAR];
+  if (rawValue === void 0) {
+    return void 0;
+  }
+  const parsed = Number.parseInt(rawValue, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
+}
 function getWorkspaceRootsFromInitializeParams(params) {
   const workspaceFolders = params.workspaceFolders?.map((workspaceFolder) => fileUriToPathOrNull(workspaceFolder.uri)).filter((workspaceRoot) => workspaceRoot !== null) ?? [];
   const rootUri = params.rootUri === null || params.rootUri === void 0 ? null : fileUriToPathOrNull(params.rootUri);
@@ -276,10 +370,34 @@ function getWorkspaceRootsFromInitializeParams(params) {
   ]);
 }
 function createServer(options = {}) {
-  const connection = (0, import_node2.createConnection)(import_node2.ProposedFeatures.all);
-  const documents = new import_node2.TextDocuments(import_vscode_languageserver_textdocument.TextDocument);
+  const connection = (0, import_node3.createConnection)(import_node3.ProposedFeatures.all);
+  const documents = new import_node3.TextDocuments(import_vscode_languageserver_textdocument.TextDocument);
   let workspaceRoots = [...options.workspaceRoots ?? []];
+  const pluginQueryTimeoutMs = resolvePluginQueryTimeoutMs(options.pluginQueryTimeoutMs);
+  const diagnosticsMode = options.diagnosticsMode ?? "off";
+  const diagnosticSource = options.diagnosticSource ?? "formspec";
   documents.listen(connection);
+  async function publishDiagnosticsForDocument(document) {
+    if (diagnosticsMode !== "plugin" || options.usePluginTransport === false) {
+      return;
+    }
+    const filePath = fileUriToPathOrNull(document.uri);
+    if (filePath === null) {
+      return;
+    }
+    const diagnostics = await getPluginDiagnosticsForDocument(
+      workspaceRoots,
+      filePath,
+      document.getText(),
+      pluginQueryTimeoutMs
+    ) ?? [];
+    void connection.sendDiagnostics({
+      uri: document.uri,
+      diagnostics: toLspDiagnostics(document, diagnostics, {
+        source: diagnosticSource
+      })
+    });
+  }
   connection.onInitialize((params) => {
     workspaceRoots = dedupeWorkspaceRoots([
       ...getWorkspaceRootsFromInitializeParams(params),
@@ -287,7 +405,7 @@ function createServer(options = {}) {
     ]);
     return {
       capabilities: {
-        textDocumentSync: import_node2.TextDocumentSyncKind.Incremental,
+        textDocumentSync: import_node3.TextDocumentSyncKind.Incremental,
         completionProvider: {
           // Trigger completions inside JSDoc comments for tags and target specifiers
           triggerCharacters: ["@", ":"]
@@ -314,7 +432,7 @@ function createServer(options = {}) {
       filePath,
       documentText,
       offset,
-      options.pluginQueryTimeoutMs
+      pluginQueryTimeoutMs
     );
     return getCompletionItemsAtOffset(documentText, offset, options.extensions, semanticContext);
   });
@@ -331,13 +449,31 @@ function createServer(options = {}) {
       filePath,
       documentText,
       offset,
-      options.pluginQueryTimeoutMs
+      pluginQueryTimeoutMs
     );
     return getHoverAtOffset(documentText, offset, options.extensions, semanticHover);
   });
   connection.onDefinition((_params) => {
     return getDefinition();
   });
+  documents.onDidOpen(({ document }) => {
+    void publishDiagnosticsForDocument(document).catch((error) => {
+      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);
+    });
+  });
+  documents.onDidChangeContent(({ document }) => {
+    void publishDiagnosticsForDocument(document).catch((error) => {
+      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);
+    });
+  });
+  documents.onDidClose(({ document }) => {
+    if (diagnosticsMode === "plugin") {
+      void connection.sendDiagnostics({
+        uri: document.uri,
+        diagnostics: []
+      });
+    }
+  });
   return connection;
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -345,6 +481,8 @@ function createServer(options = {}) {
   createServer,
   getCompletionItems,
   getDefinition,
-  getHoverForTag
+  getHoverForTag,
+  getPluginDiagnosticsForDocument,
+  toLspDiagnostics
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/server.ts","../src/providers/completion.ts","../src/providers/hover.ts","../src/providers/definition.ts","../src/plugin-client.ts"],"sourcesContent":["/**\n * \\@formspec/language-server\n *\n * Language server for FormSpec — provides completions, hover documentation,\n * and go-to-definition for FormSpec JSDoc constraint tags (`@Minimum`,\n * `@Maximum`, `@Pattern`, etc.) in TypeScript files.\n *\n * This package implements the Language Server Protocol (LSP) using the\n * `vscode-languageserver` library. Cheap syntax-local behaviors stay in the\n * LSP process, while TypeScript-project-aware semantics are supplied by\n * `@formspec/ts-plugin` over a local manifest + IPC transport.\n *\n * Diagnostics are intentionally omitted per design decision A7.\n *\n * @example\n * ```ts\n * import { createServer } from '@formspec/language-server';\n *\n * const connection = createServer();\n * connection.listen();\n * ```\n *\n * @packageDocumentation\n */\n\nexport { createServer } from \"./server.js\";\nexport type { CreateServerOptions } from \"./server.js\";\nexport { getCompletionItems } from \"./providers/completion.js\";\nexport { getHoverForTag } from \"./providers/hover.js\";\nexport { getDefinition } from \"./providers/definition.js\";\n","/**\n * FormSpec Language Server\n *\n * Sets up an LSP server connection and registers handlers for:\n * - `textDocument/completion` — FormSpec JSDoc constraint tag completions\n * - `textDocument/hover` — Documentation for recognized constraint tags\n * - `textDocument/definition` — Go-to-definition (stub, returns null)\n *\n * Diagnostics are intentionally omitted per design decision A7.\n */\n\nimport {\n  createConnection,\n  ProposedFeatures,\n  TextDocuments,\n  TextDocumentSyncKind,\n  type Connection,\n  type InitializeResult,\n} from \"vscode-languageserver/node.js\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { TextDocument } from \"vscode-languageserver-textdocument\";\nimport { getCompletionItemsAtOffset } from \"./providers/completion.js\";\nimport { getHoverAtOffset } from \"./providers/hover.js\";\nimport { getDefinition } from \"./providers/definition.js\";\nimport {\n  fileUriToPathOrNull,\n  getPluginCompletionContextForDocument,\n  getPluginHoverForDocument,\n} from \"./plugin-client.js\";\n\nfunction dedupeWorkspaceRoots(workspaceRoots: readonly string[]): string[] {\n  return [...new Set(workspaceRoots)];\n}\n\nfunction getWorkspaceRootsFromInitializeParams(params: {\n  readonly workspaceFolders?: readonly { readonly uri: string }[] | null;\n  readonly rootUri?: string | null;\n  readonly rootPath?: string | null;\n}): string[] {\n  const workspaceFolders =\n    params.workspaceFolders\n      ?.map((workspaceFolder) => fileUriToPathOrNull(workspaceFolder.uri))\n      .filter((workspaceRoot): workspaceRoot is string => workspaceRoot !== null) ?? [];\n  const rootUri =\n    params.rootUri === null || params.rootUri === undefined\n      ? null\n      : fileUriToPathOrNull(params.rootUri);\n  const rootPath = params.rootPath ?? null;\n\n  return dedupeWorkspaceRoots([\n    ...workspaceFolders,\n    ...(rootUri === null ? [] : [rootUri]),\n    ...(rootPath === null ? [] : [rootPath]),\n  ]);\n}\n\n/**\n * Public configuration for constructing the FormSpec language server.\n *\n * @public\n */\nexport interface CreateServerOptions {\n  /** Optional extension definitions whose custom tags should be surfaced by tooling. */\n  readonly extensions?: readonly ExtensionDefinition[];\n  /** Optional workspace roots to use before initialize() provides them. */\n  readonly workspaceRoots?: readonly string[];\n  /** Set to false to disable tsserver-plugin semantic enrichment. */\n  readonly usePluginTransport?: boolean;\n  /** IPC timeout, in milliseconds, for semantic plugin requests. */\n  readonly pluginQueryTimeoutMs?: number;\n}\n\n/**\n * Creates and configures the FormSpec language server connection.\n *\n * Registers LSP capability handlers and returns the connection.\n * Call `connection.listen()` to start accepting messages.\n *\n * @returns The configured LSP connection (not yet listening)\n * @public\n */\nexport function createServer(options: CreateServerOptions = {}): Connection {\n  const connection = createConnection(ProposedFeatures.all);\n  const documents = new TextDocuments(TextDocument);\n  let workspaceRoots = [...(options.workspaceRoots ?? [])];\n\n  documents.listen(connection);\n\n  connection.onInitialize((params): InitializeResult => {\n    workspaceRoots = dedupeWorkspaceRoots([\n      ...getWorkspaceRootsFromInitializeParams(params),\n      ...workspaceRoots,\n    ]);\n\n    return {\n      capabilities: {\n        textDocumentSync: TextDocumentSyncKind.Incremental,\n        completionProvider: {\n          // Trigger completions inside JSDoc comments for tags and target specifiers\n          triggerCharacters: [\"@\", \":\"],\n        },\n        hoverProvider: true,\n        definitionProvider: true,\n      },\n      serverInfo: {\n        name: \"formspec-language-server\",\n        version: \"0.1.0\",\n      },\n    };\n  });\n\n  connection.onCompletion(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return [];\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticContext =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginCompletionContextForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            options.pluginQueryTimeoutMs\n          );\n\n    return getCompletionItemsAtOffset(documentText, offset, options.extensions, semanticContext);\n  });\n\n  connection.onHover(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return null;\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticHover =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginHoverForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            options.pluginQueryTimeoutMs\n          );\n\n    return getHoverAtOffset(documentText, offset, options.extensions, semanticHover);\n  });\n\n  connection.onDefinition((_params) => {\n    // Go-to-definition is not yet implemented.\n    return getDefinition();\n  });\n\n  return connection;\n}\n","/**\n * Completion provider for FormSpec JSDoc constraint tags.\n *\n * Uses the shared tag registry from `@formspec/analysis` so completions stay\n * aligned with the same metadata that powers linting and build-time analysis.\n */\n\nimport {\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedTagDefinition,\n  getConstraintTagDefinitions,\n  getSemanticCommentCompletionContextAtOffset,\n  type TagDefinition,\n} from \"@formspec/analysis\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { CompletionItem, CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the full set of tag-name completions currently known to FormSpec.\n *\n * @public\n */\nexport function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[] {\n  return getConstraintTagDefinitions(extensions).map((tag) => ({\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  }));\n}\n\nfunction toCompletionItem(tag: TagDefinition | FormSpecSerializedTagDefinition): CompletionItem {\n  return {\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  };\n}\n\n/** @internal */\nexport function getCompletionItemsAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticContext?: FormSpecSerializedCompletionContext | null\n): CompletionItem[] {\n  if (semanticContext !== null && semanticContext !== undefined) {\n    if (semanticContext.kind === \"target\") {\n      return semanticContext.semantic.targetCompletions.map((target: string) => ({\n        label: target,\n        kind:\n          target === \"singular\" || target === \"plural\"\n            ? CompletionItemKind.EnumMember\n            : CompletionItemKind.Field,\n        detail: `Target for @${semanticContext.semantic.tagName}`,\n      }));\n    }\n\n    if (semanticContext.kind !== \"tag-name\") {\n      return [];\n    }\n\n    const normalizedPrefix = semanticContext.prefix.toLowerCase();\n    return semanticContext.availableTags\n      .map(toCompletionItem)\n      .filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));\n  }\n\n  const resolvedContext = getSemanticCommentCompletionContextAtOffset(\n    documentText,\n    offset,\n    extensions ? { extensions } : undefined\n  );\n\n  if (resolvedContext.kind === \"target\") {\n    return resolvedContext.semantic.targetCompletions.map((target: string) => ({\n      label: target,\n      kind:\n        target === \"singular\" || target === \"plural\"\n          ? CompletionItemKind.EnumMember\n          : CompletionItemKind.Field,\n      detail: `Target for @${resolvedContext.semantic.tag.normalizedTagName}`,\n    }));\n  }\n\n  if (resolvedContext.kind !== \"tag-name\") {\n    return [];\n  }\n\n  const normalizedPrefix = resolvedContext.prefix.toLowerCase();\n  return resolvedContext.availableTags\n    .map(toCompletionItem)\n    .filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));\n}\n","/**\n * Hover provider for FormSpec JSDoc tags.\n *\n * Uses the shared registry from `@formspec/analysis` so hover content stays in\n * sync with the tag inventory and overload metadata.\n */\n\nimport {\n  type FormSpecSerializedHoverInfo,\n  getCommentHoverInfoAtOffset,\n  getTagDefinition,\n  normalizeFormSpecTagName,\n} from \"@formspec/analysis\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport type { Hover } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns hover content for a single FormSpec tag name.\n *\n * @public\n */\nexport function getHoverForTag(\n  tagName: string,\n  extensions?: readonly ExtensionDefinition[]\n): Hover | null {\n  const raw = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\n  const definition = getTagDefinition(normalizeFormSpecTagName(raw), extensions);\n  if (!definition) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: definition.hoverMarkdown,\n    },\n  };\n}\n\n/** @internal */\nexport function getHoverAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticHover?: FormSpecSerializedHoverInfo | null\n): Hover | null {\n  const hoverInfo =\n    semanticHover ??\n    getCommentHoverInfoAtOffset(documentText, offset, extensions ? { extensions } : undefined);\n  if (hoverInfo === null) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: hoverInfo.markdown,\n    },\n  };\n}\n","/**\n * Go-to-definition provider for FormSpec.\n *\n * This is a stub — go-to-definition support (e.g., navigating from a\n * `field.text(\"name\")` call to the form definition that references it) will\n * be implemented in a future phase.\n */\n\nimport type { Location } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the definition location for a symbol at the given position.\n *\n * Always returns `null` in this stub implementation.\n *\n * @returns `null` — not yet implemented\n * @public\n */\nexport function getDefinition(): Location | null {\n  return null;\n}\n","import fs from \"node:fs/promises\";\nimport net from \"node:net\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n  computeFormSpecTextHash,\n  getFormSpecManifestPath,\n  isFormSpecAnalysisManifest,\n  isFormSpecSemanticResponse,\n  type FormSpecAnalysisManifest,\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedHoverInfo,\n  type FormSpecSemanticQuery,\n  type FormSpecSemanticResponse,\n} from \"@formspec/analysis\";\n\nconst DEFAULT_PLUGIN_QUERY_TIMEOUT_MS = 2_000;\n\nfunction getManifestPath(workspaceRoot: string): string {\n  return getFormSpecManifestPath(workspaceRoot);\n}\n\nfunction normalizeWorkspaceRoot(root: string): string {\n  const resolved = path.resolve(root);\n  const parsed = path.parse(resolved);\n  let normalized = resolved;\n\n  while (normalized.length > parsed.root.length && normalized.endsWith(path.sep)) {\n    normalized = normalized.slice(0, -path.sep.length);\n  }\n\n  return normalized;\n}\n\nfunction getMatchingWorkspaceRoot(\n  workspaceRoots: readonly string[],\n  filePath: string\n): string | null {\n  const normalizedFilePath = path.resolve(filePath);\n  const normalizedRoots = [...workspaceRoots]\n    .map(normalizeWorkspaceRoot)\n    .sort((left, right) => right.length - left.length);\n  return (\n    normalizedRoots.find(\n      (workspaceRoot) =>\n        normalizedFilePath === workspaceRoot ||\n        normalizedFilePath.startsWith(`${workspaceRoot}${path.sep}`)\n    ) ?? null\n  );\n}\n\nasync function readManifest(workspaceRoot: string): Promise<FormSpecAnalysisManifest | null> {\n  try {\n    const manifestText = await fs.readFile(getManifestPath(workspaceRoot), \"utf8\");\n    const manifest = JSON.parse(manifestText) as unknown;\n    if (!isFormSpecAnalysisManifest(manifest)) {\n      return null;\n    }\n\n    return manifest;\n  } catch {\n    return null;\n  }\n}\n\nasync function sendSemanticQuery(\n  manifest: FormSpecAnalysisManifest,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  return new Promise((resolve) => {\n    const socket = net.createConnection(manifest.endpoint.address);\n    let buffer = \"\";\n    let settled = false;\n\n    const finish = (response: FormSpecSemanticResponse | null): void => {\n      if (settled) {\n        return;\n      }\n      settled = true;\n      socket.removeAllListeners(\"data\");\n      socket.destroy();\n      resolve(response);\n    };\n\n    socket.setTimeout(timeoutMs, () => {\n      finish(null);\n    });\n\n    socket.setEncoding(\"utf8\");\n    socket.on(\"connect\", () => {\n      socket.write(`${JSON.stringify(query)}\\n`);\n    });\n    socket.on(\"data\", (chunk) => {\n      buffer += String(chunk);\n      const newlineIndex = buffer.indexOf(\"\\n\");\n      if (newlineIndex < 0) {\n        return;\n      }\n\n      const payload = buffer.slice(0, newlineIndex);\n      buffer = buffer.slice(newlineIndex + 1);\n      try {\n        const response = JSON.parse(payload) as unknown;\n        finish(isFormSpecSemanticResponse(response) ? response : null);\n      } catch {\n        finish(null);\n      }\n    });\n    socket.on(\"error\", () => {\n      finish(null);\n    });\n    socket.on(\"close\", () => {\n      finish(null);\n    });\n  });\n}\n\nexport function fileUriToPathOrNull(uri: string): string | null {\n  try {\n    return fileURLToPath(uri);\n  } catch {\n    return null;\n  }\n}\n\nasync function sendFileQuery(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  const workspaceRoot = getMatchingWorkspaceRoot(workspaceRoots, filePath);\n  if (workspaceRoot === null) {\n    return null;\n  }\n\n  const manifest = await readManifest(workspaceRoot);\n  if (manifest === null) {\n    return null;\n  }\n\n  return sendSemanticQuery(manifest, query, timeoutMs);\n}\n\nexport async function getPluginCompletionContextForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedCompletionContext | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"completion\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"completion\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.context : null;\n}\n\nexport async function getPluginHoverForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedHoverInfo | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"hover\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"hover\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.hover : null;\n}\n"],"mappings":"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","names":["import_node","normalizedPrefix","import_analysis","import_analysis","path","fs","net"]}
+{"version":3,"sources":["../src/index.ts","../src/server.ts","../src/providers/completion.ts","../src/providers/hover.ts","../src/providers/definition.ts","../src/diagnostics.ts","../src/plugin-client.ts"],"sourcesContent":["/**\n * \\@formspec/language-server\n *\n * Language server for FormSpec — provides completions, hover documentation,\n * and go-to-definition for FormSpec JSDoc constraint tags (`@Minimum`,\n * `@Maximum`, `@Pattern`, etc.) in TypeScript files.\n *\n * This package implements the Language Server Protocol (LSP) using the\n * `vscode-languageserver` library. Cheap syntax-local behaviors stay in the\n * LSP process, while TypeScript-project-aware semantics are supplied by\n * `@formspec/ts-plugin` over a local manifest + IPC transport.\n *\n * The packaged server acts as a reference implementation over the composable\n * completion, hover, and diagnostics helpers exported from this package.\n *\n * @example\n * ```ts\n * import { createServer } from '@formspec/language-server';\n *\n * const connection = createServer();\n * connection.listen();\n * ```\n *\n * @packageDocumentation\n */\n\nexport { createServer } from \"./server.js\";\nexport type { CreateServerOptions } from \"./server.js\";\nexport type {\n  CommentSpan,\n  FormSpecAnalysisDiagnostic,\n  FormSpecAnalysisDiagnosticCategory,\n  FormSpecAnalysisDiagnosticDataValue,\n  FormSpecAnalysisDiagnosticLocation,\n} from \"@formspec/analysis/protocol\";\nexport {\n  getPluginDiagnosticsForDocument,\n  toLspDiagnostics,\n  type ToLspDiagnosticsOptions,\n} from \"./diagnostics.js\";\nexport { getCompletionItems } from \"./providers/completion.js\";\nexport { getHoverForTag } from \"./providers/hover.js\";\nexport { getDefinition } from \"./providers/definition.js\";\n","/**\n * FormSpec Language Server\n *\n * Sets up an LSP server connection and registers handlers for:\n * - `textDocument/completion` — FormSpec JSDoc constraint tag completions\n * - `textDocument/hover` — Documentation for recognized constraint tags\n * - `textDocument/definition` — Go-to-definition (stub, returns null)\n *\n * The packaged language server is a reference implementation built on the same\n * composable helpers that downstream consumers can call directly.\n */\n\nimport {\n  createConnection,\n  Diagnostic,\n  ProposedFeatures,\n  TextDocuments,\n  TextDocumentSyncKind,\n  type Connection,\n  type InitializeResult,\n} from \"vscode-languageserver/node.js\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { TextDocument } from \"vscode-languageserver-textdocument\";\nimport { getCompletionItemsAtOffset } from \"./providers/completion.js\";\nimport { getHoverAtOffset } from \"./providers/hover.js\";\nimport { getDefinition } from \"./providers/definition.js\";\nimport { getPluginDiagnosticsForDocument, toLspDiagnostics } from \"./diagnostics.js\";\nimport {\n  fileUriToPathOrNull,\n  getPluginCompletionContextForDocument,\n  getPluginHoverForDocument,\n} from \"./plugin-client.js\";\n\nconst PLUGIN_QUERY_TIMEOUT_ENV_VAR = \"FORMSPEC_PLUGIN_QUERY_TIMEOUT_MS\";\n\nfunction dedupeWorkspaceRoots(workspaceRoots: readonly string[]): string[] {\n  return [...new Set(workspaceRoots)];\n}\n\nfunction resolvePluginQueryTimeoutMs(explicitTimeoutMs: number | undefined): number | undefined {\n  if (explicitTimeoutMs !== undefined) {\n    return explicitTimeoutMs;\n  }\n\n  const rawValue = process.env[PLUGIN_QUERY_TIMEOUT_ENV_VAR];\n  if (rawValue === undefined) {\n    return undefined;\n  }\n\n  const parsed = Number.parseInt(rawValue, 10);\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;\n}\n\nfunction getWorkspaceRootsFromInitializeParams(params: {\n  readonly workspaceFolders?: readonly { readonly uri: string }[] | null;\n  readonly rootUri?: string | null;\n  readonly rootPath?: string | null;\n}): string[] {\n  const workspaceFolders =\n    params.workspaceFolders\n      ?.map((workspaceFolder) => fileUriToPathOrNull(workspaceFolder.uri))\n      .filter((workspaceRoot): workspaceRoot is string => workspaceRoot !== null) ?? [];\n  const rootUri =\n    params.rootUri === null || params.rootUri === undefined\n      ? null\n      : fileUriToPathOrNull(params.rootUri);\n  const rootPath = params.rootPath ?? null;\n\n  return dedupeWorkspaceRoots([\n    ...workspaceFolders,\n    ...(rootUri === null ? [] : [rootUri]),\n    ...(rootPath === null ? [] : [rootPath]),\n  ]);\n}\n\n/**\n * Public configuration for constructing the FormSpec language server.\n *\n * @public\n */\nexport interface CreateServerOptions {\n  /** Optional extension definitions whose custom tags should be surfaced by tooling. */\n  readonly extensions?: readonly ExtensionDefinition[];\n  /** Optional workspace roots to use before initialize() provides them. */\n  readonly workspaceRoots?: readonly string[];\n  /** Set to false to disable tsserver-plugin semantic enrichment. */\n  readonly usePluginTransport?: boolean;\n  /** IPC timeout, in milliseconds, for semantic plugin requests. */\n  readonly pluginQueryTimeoutMs?: number;\n  /** Optional diagnostics publishing mode for the packaged reference LSP. */\n  readonly diagnosticsMode?: \"off\" | \"plugin\";\n  /** Source label to use when publishing plugin-derived diagnostics. */\n  readonly diagnosticSource?: string;\n}\n\n/**\n * Creates and configures the FormSpec language server connection.\n *\n * Registers LSP capability handlers and returns the connection.\n * Call `connection.listen()` to start accepting messages.\n *\n * @returns The configured LSP connection (not yet listening)\n * @public\n */\nexport function createServer(options: CreateServerOptions = {}): Connection {\n  const connection = createConnection(ProposedFeatures.all);\n  const documents = new TextDocuments(TextDocument);\n  let workspaceRoots = [...(options.workspaceRoots ?? [])];\n  const pluginQueryTimeoutMs = resolvePluginQueryTimeoutMs(options.pluginQueryTimeoutMs);\n  const diagnosticsMode = options.diagnosticsMode ?? \"off\";\n  const diagnosticSource = options.diagnosticSource ?? \"formspec\";\n\n  documents.listen(connection);\n\n  async function publishDiagnosticsForDocument(document: TextDocument): Promise<void> {\n    if (diagnosticsMode !== \"plugin\" || options.usePluginTransport === false) {\n      return;\n    }\n\n    const filePath = fileUriToPathOrNull(document.uri);\n    if (filePath === null) {\n      return;\n    }\n\n    const diagnostics =\n      (await getPluginDiagnosticsForDocument(\n        workspaceRoots,\n        filePath,\n        document.getText(),\n        pluginQueryTimeoutMs\n      )) ?? [];\n\n    void connection.sendDiagnostics({\n      uri: document.uri,\n      diagnostics: toLspDiagnostics(document, diagnostics, {\n        source: diagnosticSource,\n      }),\n    });\n  }\n\n  connection.onInitialize((params): InitializeResult => {\n    workspaceRoots = dedupeWorkspaceRoots([\n      ...getWorkspaceRootsFromInitializeParams(params),\n      ...workspaceRoots,\n    ]);\n\n    return {\n      capabilities: {\n        textDocumentSync: TextDocumentSyncKind.Incremental,\n        completionProvider: {\n          // Trigger completions inside JSDoc comments for tags and target specifiers\n          triggerCharacters: [\"@\", \":\"],\n        },\n        hoverProvider: true,\n        definitionProvider: true,\n      },\n      serverInfo: {\n        name: \"formspec-language-server\",\n        version: \"0.1.0\",\n      },\n    };\n  });\n\n  connection.onCompletion(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return [];\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticContext =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginCompletionContextForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            pluginQueryTimeoutMs\n          );\n\n    return getCompletionItemsAtOffset(documentText, offset, options.extensions, semanticContext);\n  });\n\n  connection.onHover(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return null;\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticHover =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginHoverForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            pluginQueryTimeoutMs\n          );\n\n    return getHoverAtOffset(documentText, offset, options.extensions, semanticHover);\n  });\n\n  connection.onDefinition((_params) => {\n    // Go-to-definition is not yet implemented.\n    return getDefinition();\n  });\n\n  documents.onDidOpen(({ document }) => {\n    void publishDiagnosticsForDocument(document).catch((error: unknown) => {\n      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);\n    });\n  });\n\n  documents.onDidChangeContent(({ document }) => {\n    void publishDiagnosticsForDocument(document).catch((error: unknown) => {\n      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);\n    });\n  });\n\n  documents.onDidClose(({ document }) => {\n    if (diagnosticsMode === \"plugin\") {\n      void connection.sendDiagnostics({\n        uri: document.uri,\n        diagnostics: [] satisfies Diagnostic[],\n      });\n    }\n  });\n\n  return connection;\n}\n","/**\n * Completion provider for FormSpec JSDoc constraint tags.\n *\n * Uses the shared tag registry from `@formspec/analysis` so completions stay\n * aligned with the same metadata that powers linting and build-time analysis.\n */\n\nimport {\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedTagDefinition,\n  getConstraintTagDefinitions,\n  getSemanticCommentCompletionContextAtOffset,\n  type TagDefinition,\n} from \"@formspec/analysis/internal\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { CompletionItem, CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the full set of tag-name completions currently known to FormSpec.\n *\n * @public\n */\nexport function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[] {\n  return getConstraintTagDefinitions(extensions).map((tag) => ({\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  }));\n}\n\nfunction toCompletionItem(tag: TagDefinition | FormSpecSerializedTagDefinition): CompletionItem {\n  return {\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  };\n}\n\nfunction toTargetCompletionItems(\n  tagName: string,\n  targetCompletions: readonly string[]\n): CompletionItem[] {\n  return targetCompletions.map((target: string) => ({\n    label: target,\n    kind:\n      target === \"singular\" || target === \"plural\"\n        ? CompletionItemKind.EnumMember\n        : CompletionItemKind.Field,\n    detail: `Target for @${tagName}`,\n  }));\n}\n\nfunction filterTagNameCompletionItems(\n  prefix: string,\n  availableTags: readonly (TagDefinition | FormSpecSerializedTagDefinition)[]\n): CompletionItem[] {\n  const normalizedPrefix = prefix.toLowerCase();\n  return availableTags\n    .map(toCompletionItem)\n    .filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));\n}\n\n/** @internal */\nexport function getCompletionItemsAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticContext?: FormSpecSerializedCompletionContext | null\n): CompletionItem[] {\n  if (semanticContext !== null && semanticContext !== undefined) {\n    if (semanticContext.kind === \"target\") {\n      return toTargetCompletionItems(\n        semanticContext.semantic.tagName,\n        semanticContext.semantic.targetCompletions\n      );\n    }\n\n    if (semanticContext.kind !== \"tag-name\") {\n      return [];\n    }\n\n    return filterTagNameCompletionItems(semanticContext.prefix, semanticContext.availableTags);\n  }\n\n  const resolvedContext = getSemanticCommentCompletionContextAtOffset(\n    documentText,\n    offset,\n    extensions ? { extensions } : undefined\n  );\n\n  if (resolvedContext.kind === \"target\") {\n    return toTargetCompletionItems(\n      resolvedContext.semantic.tag.normalizedTagName,\n      resolvedContext.semantic.targetCompletions\n    );\n  }\n\n  if (resolvedContext.kind !== \"tag-name\") {\n    return [];\n  }\n\n  return filterTagNameCompletionItems(resolvedContext.prefix, resolvedContext.availableTags);\n}\n","/**\n * Hover provider for FormSpec JSDoc tags.\n *\n * Uses the shared registry from `@formspec/analysis` so hover content stays in\n * sync with the tag inventory and overload metadata.\n */\n\nimport {\n  type FormSpecSerializedHoverInfo,\n  getCommentHoverInfoAtOffset,\n  getTagDefinition,\n  normalizeFormSpecTagName,\n} from \"@formspec/analysis/internal\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport type { Hover } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns hover content for a single FormSpec tag name.\n *\n * @public\n */\nexport function getHoverForTag(\n  tagName: string,\n  extensions?: readonly ExtensionDefinition[]\n): Hover | null {\n  const raw = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\n  const definition = getTagDefinition(normalizeFormSpecTagName(raw), extensions);\n  if (!definition) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: definition.hoverMarkdown,\n    },\n  };\n}\n\n/** @internal */\nexport function getHoverAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticHover?: FormSpecSerializedHoverInfo | null\n): Hover | null {\n  const hoverInfo =\n    semanticHover ??\n    getCommentHoverInfoAtOffset(documentText, offset, extensions ? { extensions } : undefined);\n  if (hoverInfo === null) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: hoverInfo.markdown,\n    },\n  };\n}\n","/**\n * Go-to-definition provider for FormSpec.\n *\n * This is a stub — go-to-definition support (e.g., navigating from a\n * `field.text(\"name\")` call to the form definition that references it) will\n * be implemented in a future phase.\n */\n\nimport type { Location } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the definition location for a symbol at the given position.\n *\n * Always returns `null` in this stub implementation.\n *\n * @returns `null` — not yet implemented\n * @public\n */\nexport function getDefinition(): Location | null {\n  return null;\n}\n","import type {\n  FormSpecAnalysisDiagnostic,\n  FormSpecAnalysisDiagnosticLocation,\n} from \"@formspec/analysis/protocol\";\nimport {\n  DiagnosticRelatedInformation,\n  DiagnosticSeverity,\n  Location,\n  Range,\n  type Diagnostic,\n} from \"vscode-languageserver/node.js\";\nimport type { TextDocument } from \"vscode-languageserver-textdocument\";\nimport { fileUriToPathOrNull } from \"./plugin-client.js\";\nexport { getPluginDiagnosticsForDocument } from \"./plugin-client.js\";\n\n/**\n * Options for converting canonical FormSpec diagnostics into LSP diagnostics.\n *\n * @public\n */\nexport interface ToLspDiagnosticsOptions {\n  /** Source label shown by LSP clients. Defaults to `formspec`. */\n  readonly source?: string;\n}\n\n/**\n * Converts canonical FormSpec diagnostics into LSP diagnostics.\n *\n * Downstream consumers that want complete white-label control can ignore this\n * helper and render their own messages from `code` + `data`.\n *\n * @public\n */\nexport function toLspDiagnostics(\n  document: TextDocument,\n  diagnostics: readonly FormSpecAnalysisDiagnostic[],\n  options: ToLspDiagnosticsOptions = {}\n): Diagnostic[] {\n  const source = options.source ?? \"formspec\";\n  return diagnostics.map((diagnostic) => {\n    const relatedInformation = toRelatedInformation(document, diagnostic.relatedLocations);\n    return {\n      range: spanToRange(document, diagnostic.range.start, diagnostic.range.end),\n      severity: toLspSeverity(diagnostic.severity),\n      source,\n      code: diagnostic.code,\n      message: diagnostic.message,\n      ...(relatedInformation === undefined ? {} : { relatedInformation }),\n      data: {\n        ...diagnostic.data,\n        category: diagnostic.category,\n      },\n    };\n  });\n}\n\nfunction spanToRange(document: TextDocument, start: number, end: number): Range {\n  return Range.create(document.positionAt(start), document.positionAt(end));\n}\n\nfunction toLspSeverity(severity: FormSpecAnalysisDiagnostic[\"severity\"]): DiagnosticSeverity {\n  switch (severity) {\n    case \"error\":\n      return DiagnosticSeverity.Error;\n    case \"warning\":\n      return DiagnosticSeverity.Warning;\n    case \"info\":\n      return DiagnosticSeverity.Information;\n    default:\n      return DiagnosticSeverity.Information;\n  }\n}\n\nfunction toRelatedInformation(\n  document: TextDocument,\n  locations: readonly FormSpecAnalysisDiagnosticLocation[]\n): DiagnosticRelatedInformation[] | undefined {\n  if (locations.length === 0) {\n    return undefined;\n  }\n\n  const currentDocumentFilePath = getDocumentFilePath(document);\n  const relatedInformation = locations\n    .filter((location) => location.filePath === currentDocumentFilePath)\n    .map((location) =>\n      DiagnosticRelatedInformation.create(\n        Location.create(\n          document.uri,\n          spanToRange(document, location.range.start, location.range.end)\n        ),\n        location.message ?? \"Related FormSpec location\"\n      )\n    );\n\n  return relatedInformation.length === 0 ? undefined : relatedInformation;\n}\n\nfunction getDocumentFilePath(document: TextDocument): string | null {\n  return fileUriToPathOrNull(document.uri);\n}\n","import fs from \"node:fs/promises\";\nimport net from \"node:net\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n  computeFormSpecTextHash,\n  getFormSpecManifestPath,\n  isFormSpecAnalysisManifest,\n  isFormSpecSemanticResponse,\n  type FormSpecAnalysisDiagnostic,\n  type FormSpecAnalysisManifest,\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedHoverInfo,\n  type FormSpecSemanticQuery,\n  type FormSpecSemanticResponse,\n} from \"@formspec/analysis/protocol\";\n\nconst DEFAULT_PLUGIN_QUERY_TIMEOUT_MS = 2_000;\n\nfunction getManifestPath(workspaceRoot: string): string {\n  return getFormSpecManifestPath(workspaceRoot);\n}\n\nfunction normalizeWorkspaceRoot(root: string): string {\n  const resolved = path.resolve(root);\n  const parsed = path.parse(resolved);\n  let normalized = resolved;\n\n  while (normalized.length > parsed.root.length && normalized.endsWith(path.sep)) {\n    normalized = normalized.slice(0, -path.sep.length);\n  }\n\n  return normalized;\n}\n\nfunction getMatchingWorkspaceRoot(\n  workspaceRoots: readonly string[],\n  filePath: string\n): string | null {\n  const normalizedFilePath = path.resolve(filePath);\n  const normalizedRoots = [...workspaceRoots]\n    .map(normalizeWorkspaceRoot)\n    .sort((left, right) => right.length - left.length);\n  return (\n    normalizedRoots.find(\n      (workspaceRoot) =>\n        normalizedFilePath === workspaceRoot ||\n        normalizedFilePath.startsWith(`${workspaceRoot}${path.sep}`)\n    ) ?? null\n  );\n}\n\nasync function readManifest(workspaceRoot: string): Promise<FormSpecAnalysisManifest | null> {\n  try {\n    const manifestText = await fs.readFile(getManifestPath(workspaceRoot), \"utf8\");\n    const manifest = JSON.parse(manifestText) as unknown;\n    if (!isFormSpecAnalysisManifest(manifest)) {\n      return null;\n    }\n\n    return manifest;\n  } catch {\n    return null;\n  }\n}\n\nasync function sendSemanticQuery(\n  manifest: FormSpecAnalysisManifest,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  return new Promise((resolve) => {\n    const socket = net.createConnection(manifest.endpoint.address);\n    let buffer = \"\";\n    let settled = false;\n\n    const finish = (response: FormSpecSemanticResponse | null): void => {\n      if (settled) {\n        return;\n      }\n      settled = true;\n      socket.removeAllListeners(\"data\");\n      socket.destroy();\n      resolve(response);\n    };\n\n    socket.setTimeout(timeoutMs, () => {\n      finish(null);\n    });\n\n    socket.setEncoding(\"utf8\");\n    socket.on(\"connect\", () => {\n      socket.write(`${JSON.stringify(query)}\\n`);\n    });\n    socket.on(\"data\", (chunk) => {\n      buffer += String(chunk);\n      const newlineIndex = buffer.indexOf(\"\\n\");\n      if (newlineIndex < 0) {\n        return;\n      }\n\n      const payload = buffer.slice(0, newlineIndex);\n      buffer = buffer.slice(newlineIndex + 1);\n      try {\n        const response = JSON.parse(payload) as unknown;\n        finish(isFormSpecSemanticResponse(response) ? response : null);\n      } catch {\n        finish(null);\n      }\n    });\n    socket.on(\"error\", () => {\n      finish(null);\n    });\n    socket.on(\"close\", () => {\n      finish(null);\n    });\n  });\n}\n\nexport function fileUriToPathOrNull(uri: string): string | null {\n  try {\n    return fileURLToPath(uri);\n  } catch {\n    return null;\n  }\n}\n\nasync function sendFileQuery(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  const workspaceRoot = getMatchingWorkspaceRoot(workspaceRoots, filePath);\n  if (workspaceRoot === null) {\n    return null;\n  }\n\n  const manifest = await readManifest(workspaceRoot);\n  if (manifest === null) {\n    return null;\n  }\n\n  return sendSemanticQuery(manifest, query, timeoutMs);\n}\n\nexport async function getPluginCompletionContextForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedCompletionContext | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"completion\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"completion\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.context : null;\n}\n\nexport async function getPluginHoverForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedHoverInfo | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"hover\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"hover\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.hover : null;\n}\n\n/**\n * Retrieves canonical FormSpec diagnostics for the current document revision\n * from the plugin transport. Returns `null` when the transport is missing,\n * stale, or invalid.\n *\n * @public\n */\nexport async function getPluginDiagnosticsForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<readonly FormSpecAnalysisDiagnostic[] | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"diagnostics\",\n      filePath,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"diagnostics\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText)\n    ? response.diagnostics\n    : null;\n}\n"],"mappings":"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","names":["import_node","import_internal","import_node","path","fs","net"]}

package/dist/index.d.ts

@@ -10,7 +10,8 @@
  * LSP process, while TypeScript-project-aware semantics are supplied by
  * `@formspec/ts-plugin` over a local manifest + IPC transport.
  *
- * Diagnostics are intentionally omitted per design decision A7.
+ * The packaged server acts as a reference implementation over the composable
+ * completion, hover, and diagnostics helpers exported from this package.
  *
  * @example
  * ```ts
@@ -24,6 +25,8 @@
  */
 export { createServer } from "./server.js";
 export type { CreateServerOptions } from "./server.js";
+export type { CommentSpan, FormSpecAnalysisDiagnostic, FormSpecAnalysisDiagnosticCategory, FormSpecAnalysisDiagnosticDataValue, FormSpecAnalysisDiagnosticLocation, } from "@formspec/analysis/protocol";
+export { getPluginDiagnosticsForDocument, toLspDiagnostics, type ToLspDiagnosticsOptions, } from "./diagnostics.js";
 export { getCompletionItems } from "./providers/completion.js";
 export { getHoverForTag } from "./providers/hover.js";
 export { getDefinition } from "./providers/definition.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EACV,WAAW,EACX,0BAA0B,EAC1B,kCAAkC,EAClC,mCAAmC,EACnC,kCAAkC,GACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,+BAA+B,EAC/B,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -11,7 +11,7 @@ import { TextDocument } from "vscode-languageserver-textdocument";
 import {
   getConstraintTagDefinitions,
   getSemanticCommentCompletionContextAtOffset
-} from "@formspec/analysis";
+} from "@formspec/analysis/internal";
 import { CompletionItemKind } from "vscode-languageserver/node.js";
 function getCompletionItems(extensions) {
   return getConstraintTagDefinitions(extensions).map((tag) => ({
@@ -27,20 +27,29 @@ function toCompletionItem(tag) {
     detail: tag.completionDetail
   };
 }
+function toTargetCompletionItems(tagName, targetCompletions) {
+  return targetCompletions.map((target) => ({
+    label: target,
+    kind: target === "singular" || target === "plural" ? CompletionItemKind.EnumMember : CompletionItemKind.Field,
+    detail: `Target for @${tagName}`
+  }));
+}
+function filterTagNameCompletionItems(prefix, availableTags) {
+  const normalizedPrefix = prefix.toLowerCase();
+  return availableTags.map(toCompletionItem).filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));
+}
 function getCompletionItemsAtOffset(documentText, offset, extensions, semanticContext) {
   if (semanticContext !== null && semanticContext !== void 0) {
     if (semanticContext.kind === "target") {
-      return semanticContext.semantic.targetCompletions.map((target) => ({
-        label: target,
-        kind: target === "singular" || target === "plural" ? CompletionItemKind.EnumMember : CompletionItemKind.Field,
-        detail: `Target for @${semanticContext.semantic.tagName}`
-      }));
+      return toTargetCompletionItems(
+        semanticContext.semantic.tagName,
+        semanticContext.semantic.targetCompletions
+      );
     }
     if (semanticContext.kind !== "tag-name") {
       return [];
     }
-    const normalizedPrefix2 = semanticContext.prefix.toLowerCase();
-    return semanticContext.availableTags.map(toCompletionItem).filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix2));
+    return filterTagNameCompletionItems(semanticContext.prefix, semanticContext.availableTags);
   }
   const resolvedContext = getSemanticCommentCompletionContextAtOffset(
     documentText,
@@ -48,17 +57,15 @@ function getCompletionItemsAtOffset(documentText, offset, extensions, semanticCo
     extensions ? { extensions } : void 0
   );
   if (resolvedContext.kind === "target") {
-    return resolvedContext.semantic.targetCompletions.map((target) => ({
-      label: target,
-      kind: target === "singular" || target === "plural" ? CompletionItemKind.EnumMember : CompletionItemKind.Field,
-      detail: `Target for @${resolvedContext.semantic.tag.normalizedTagName}`
-    }));
+    return toTargetCompletionItems(
+      resolvedContext.semantic.tag.normalizedTagName,
+      resolvedContext.semantic.targetCompletions
+    );
   }
   if (resolvedContext.kind !== "tag-name") {
     return [];
   }
-  const normalizedPrefix = resolvedContext.prefix.toLowerCase();
-  return resolvedContext.availableTags.map(toCompletionItem).filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));
+  return filterTagNameCompletionItems(resolvedContext.prefix, resolvedContext.availableTags);
 }
 
 // src/providers/hover.ts
@@ -66,7 +73,7 @@ import {
   getCommentHoverInfoAtOffset,
   getTagDefinition,
   normalizeFormSpecTagName
-} from "@formspec/analysis";
+} from "@formspec/analysis/internal";
 function getHoverForTag(tagName, extensions) {
   const raw = tagName.startsWith("@") ? tagName.slice(1) : tagName;
   const definition = getTagDefinition(normalizeFormSpecTagName(raw), extensions);
@@ -98,6 +105,14 @@ function getDefinition() {
   return null;
 }
 
+// src/diagnostics.ts
+import {
+  DiagnosticRelatedInformation,
+  DiagnosticSeverity,
+  Location,
+  Range
+} from "vscode-languageserver/node.js";
+
 // src/plugin-client.ts
 import fs from "fs/promises";
 import net from "net";
@@ -109,7 +124,7 @@ import {
   getFormSpecManifestPath,
   isFormSpecAnalysisManifest,
   isFormSpecSemanticResponse
-} from "@formspec/analysis";
+} from "@formspec/analysis/protocol";
 var DEFAULT_PLUGIN_QUERY_TIMEOUT_MS = 2e3;
 function getManifestPath(workspaceRoot) {
   return getFormSpecManifestPath(workspaceRoot);
@@ -239,11 +254,93 @@ async function getPluginHoverForDocument(workspaceRoots, filePath, documentText,
   }
   return response.sourceHash === computeFormSpecTextHash(documentText) ? response.hover : null;
 }
+async function getPluginDiagnosticsForDocument(workspaceRoots, filePath, documentText, timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS) {
+  const response = await sendFileQuery(
+    workspaceRoots,
+    filePath,
+    {
+      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+      kind: "diagnostics",
+      filePath
+    },
+    timeoutMs
+  );
+  if (response?.kind !== "diagnostics") {
+    return null;
+  }
+  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.diagnostics : null;
+}
+
+// src/diagnostics.ts
+function toLspDiagnostics(document, diagnostics, options = {}) {
+  const source = options.source ?? "formspec";
+  return diagnostics.map((diagnostic) => {
+    const relatedInformation = toRelatedInformation(document, diagnostic.relatedLocations);
+    return {
+      range: spanToRange(document, diagnostic.range.start, diagnostic.range.end),
+      severity: toLspSeverity(diagnostic.severity),
+      source,
+      code: diagnostic.code,
+      message: diagnostic.message,
+      ...relatedInformation === void 0 ? {} : { relatedInformation },
+      data: {
+        ...diagnostic.data,
+        category: diagnostic.category
+      }
+    };
+  });
+}
+function spanToRange(document, start, end) {
+  return Range.create(document.positionAt(start), document.positionAt(end));
+}
+function toLspSeverity(severity) {
+  switch (severity) {
+    case "error":
+      return DiagnosticSeverity.Error;
+    case "warning":
+      return DiagnosticSeverity.Warning;
+    case "info":
+      return DiagnosticSeverity.Information;
+    default:
+      return DiagnosticSeverity.Information;
+  }
+}
+function toRelatedInformation(document, locations) {
+  if (locations.length === 0) {
+    return void 0;
+  }
+  const currentDocumentFilePath = getDocumentFilePath(document);
+  const relatedInformation = locations.filter((location) => location.filePath === currentDocumentFilePath).map(
+    (location) => DiagnosticRelatedInformation.create(
+      Location.create(
+        document.uri,
+        spanToRange(document, location.range.start, location.range.end)
+      ),
+      location.message ?? "Related FormSpec location"
+    )
+  );
+  return relatedInformation.length === 0 ? void 0 : relatedInformation;
+}
+function getDocumentFilePath(document) {
+  return fileUriToPathOrNull(document.uri);
+}
 
 // src/server.ts
+var PLUGIN_QUERY_TIMEOUT_ENV_VAR = "FORMSPEC_PLUGIN_QUERY_TIMEOUT_MS";
 function dedupeWorkspaceRoots(workspaceRoots) {
   return [...new Set(workspaceRoots)];
 }
+function resolvePluginQueryTimeoutMs(explicitTimeoutMs) {
+  if (explicitTimeoutMs !== void 0) {
+    return explicitTimeoutMs;
+  }
+  const rawValue = process.env[PLUGIN_QUERY_TIMEOUT_ENV_VAR];
+  if (rawValue === void 0) {
+    return void 0;
+  }
+  const parsed = Number.parseInt(rawValue, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
+}
 function getWorkspaceRootsFromInitializeParams(params) {
   const workspaceFolders = params.workspaceFolders?.map((workspaceFolder) => fileUriToPathOrNull(workspaceFolder.uri)).filter((workspaceRoot) => workspaceRoot !== null) ?? [];
   const rootUri = params.rootUri === null || params.rootUri === void 0 ? null : fileUriToPathOrNull(params.rootUri);
@@ -258,7 +355,31 @@ function createServer(options = {}) {
   const connection = createConnection(ProposedFeatures.all);
   const documents = new TextDocuments(TextDocument);
   let workspaceRoots = [...options.workspaceRoots ?? []];
+  const pluginQueryTimeoutMs = resolvePluginQueryTimeoutMs(options.pluginQueryTimeoutMs);
+  const diagnosticsMode = options.diagnosticsMode ?? "off";
+  const diagnosticSource = options.diagnosticSource ?? "formspec";
   documents.listen(connection);
+  async function publishDiagnosticsForDocument(document) {
+    if (diagnosticsMode !== "plugin" || options.usePluginTransport === false) {
+      return;
+    }
+    const filePath = fileUriToPathOrNull(document.uri);
+    if (filePath === null) {
+      return;
+    }
+    const diagnostics = await getPluginDiagnosticsForDocument(
+      workspaceRoots,
+      filePath,
+      document.getText(),
+      pluginQueryTimeoutMs
+    ) ?? [];
+    void connection.sendDiagnostics({
+      uri: document.uri,
+      diagnostics: toLspDiagnostics(document, diagnostics, {
+        source: diagnosticSource
+      })
+    });
+  }
   connection.onInitialize((params) => {
     workspaceRoots = dedupeWorkspaceRoots([
       ...getWorkspaceRootsFromInitializeParams(params),
@@ -293,7 +414,7 @@ function createServer(options = {}) {
       filePath,
       documentText,
       offset,
-      options.pluginQueryTimeoutMs
+      pluginQueryTimeoutMs
     );
     return getCompletionItemsAtOffset(documentText, offset, options.extensions, semanticContext);
   });
@@ -310,19 +431,39 @@ function createServer(options = {}) {
       filePath,
       documentText,
       offset,
-      options.pluginQueryTimeoutMs
+      pluginQueryTimeoutMs
     );
     return getHoverAtOffset(documentText, offset, options.extensions, semanticHover);
   });
   connection.onDefinition((_params) => {
     return getDefinition();
   });
+  documents.onDidOpen(({ document }) => {
+    void publishDiagnosticsForDocument(document).catch((error) => {
+      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);
+    });
+  });
+  documents.onDidChangeContent(({ document }) => {
+    void publishDiagnosticsForDocument(document).catch((error) => {
+      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);
+    });
+  });
+  documents.onDidClose(({ document }) => {
+    if (diagnosticsMode === "plugin") {
+      void connection.sendDiagnostics({
+        uri: document.uri,
+        diagnostics: []
+      });
+    }
+  });
   return connection;
 }
 export {
   createServer,
   getCompletionItems,
   getDefinition,
-  getHoverForTag
+  getHoverForTag,
+  getPluginDiagnosticsForDocument,
+  toLspDiagnostics
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts","../src/providers/completion.ts","../src/providers/hover.ts","../src/providers/definition.ts","../src/plugin-client.ts"],"sourcesContent":["/**\n * FormSpec Language Server\n *\n * Sets up an LSP server connection and registers handlers for:\n * - `textDocument/completion` — FormSpec JSDoc constraint tag completions\n * - `textDocument/hover` — Documentation for recognized constraint tags\n * - `textDocument/definition` — Go-to-definition (stub, returns null)\n *\n * Diagnostics are intentionally omitted per design decision A7.\n */\n\nimport {\n  createConnection,\n  ProposedFeatures,\n  TextDocuments,\n  TextDocumentSyncKind,\n  type Connection,\n  type InitializeResult,\n} from \"vscode-languageserver/node.js\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { TextDocument } from \"vscode-languageserver-textdocument\";\nimport { getCompletionItemsAtOffset } from \"./providers/completion.js\";\nimport { getHoverAtOffset } from \"./providers/hover.js\";\nimport { getDefinition } from \"./providers/definition.js\";\nimport {\n  fileUriToPathOrNull,\n  getPluginCompletionContextForDocument,\n  getPluginHoverForDocument,\n} from \"./plugin-client.js\";\n\nfunction dedupeWorkspaceRoots(workspaceRoots: readonly string[]): string[] {\n  return [...new Set(workspaceRoots)];\n}\n\nfunction getWorkspaceRootsFromInitializeParams(params: {\n  readonly workspaceFolders?: readonly { readonly uri: string }[] | null;\n  readonly rootUri?: string | null;\n  readonly rootPath?: string | null;\n}): string[] {\n  const workspaceFolders =\n    params.workspaceFolders\n      ?.map((workspaceFolder) => fileUriToPathOrNull(workspaceFolder.uri))\n      .filter((workspaceRoot): workspaceRoot is string => workspaceRoot !== null) ?? [];\n  const rootUri =\n    params.rootUri === null || params.rootUri === undefined\n      ? null\n      : fileUriToPathOrNull(params.rootUri);\n  const rootPath = params.rootPath ?? null;\n\n  return dedupeWorkspaceRoots([\n    ...workspaceFolders,\n    ...(rootUri === null ? [] : [rootUri]),\n    ...(rootPath === null ? [] : [rootPath]),\n  ]);\n}\n\n/**\n * Public configuration for constructing the FormSpec language server.\n *\n * @public\n */\nexport interface CreateServerOptions {\n  /** Optional extension definitions whose custom tags should be surfaced by tooling. */\n  readonly extensions?: readonly ExtensionDefinition[];\n  /** Optional workspace roots to use before initialize() provides them. */\n  readonly workspaceRoots?: readonly string[];\n  /** Set to false to disable tsserver-plugin semantic enrichment. */\n  readonly usePluginTransport?: boolean;\n  /** IPC timeout, in milliseconds, for semantic plugin requests. */\n  readonly pluginQueryTimeoutMs?: number;\n}\n\n/**\n * Creates and configures the FormSpec language server connection.\n *\n * Registers LSP capability handlers and returns the connection.\n * Call `connection.listen()` to start accepting messages.\n *\n * @returns The configured LSP connection (not yet listening)\n * @public\n */\nexport function createServer(options: CreateServerOptions = {}): Connection {\n  const connection = createConnection(ProposedFeatures.all);\n  const documents = new TextDocuments(TextDocument);\n  let workspaceRoots = [...(options.workspaceRoots ?? [])];\n\n  documents.listen(connection);\n\n  connection.onInitialize((params): InitializeResult => {\n    workspaceRoots = dedupeWorkspaceRoots([\n      ...getWorkspaceRootsFromInitializeParams(params),\n      ...workspaceRoots,\n    ]);\n\n    return {\n      capabilities: {\n        textDocumentSync: TextDocumentSyncKind.Incremental,\n        completionProvider: {\n          // Trigger completions inside JSDoc comments for tags and target specifiers\n          triggerCharacters: [\"@\", \":\"],\n        },\n        hoverProvider: true,\n        definitionProvider: true,\n      },\n      serverInfo: {\n        name: \"formspec-language-server\",\n        version: \"0.1.0\",\n      },\n    };\n  });\n\n  connection.onCompletion(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return [];\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticContext =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginCompletionContextForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            options.pluginQueryTimeoutMs\n          );\n\n    return getCompletionItemsAtOffset(documentText, offset, options.extensions, semanticContext);\n  });\n\n  connection.onHover(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return null;\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticHover =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginHoverForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            options.pluginQueryTimeoutMs\n          );\n\n    return getHoverAtOffset(documentText, offset, options.extensions, semanticHover);\n  });\n\n  connection.onDefinition((_params) => {\n    // Go-to-definition is not yet implemented.\n    return getDefinition();\n  });\n\n  return connection;\n}\n","/**\n * Completion provider for FormSpec JSDoc constraint tags.\n *\n * Uses the shared tag registry from `@formspec/analysis` so completions stay\n * aligned with the same metadata that powers linting and build-time analysis.\n */\n\nimport {\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedTagDefinition,\n  getConstraintTagDefinitions,\n  getSemanticCommentCompletionContextAtOffset,\n  type TagDefinition,\n} from \"@formspec/analysis\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { CompletionItem, CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the full set of tag-name completions currently known to FormSpec.\n *\n * @public\n */\nexport function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[] {\n  return getConstraintTagDefinitions(extensions).map((tag) => ({\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  }));\n}\n\nfunction toCompletionItem(tag: TagDefinition | FormSpecSerializedTagDefinition): CompletionItem {\n  return {\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  };\n}\n\n/** @internal */\nexport function getCompletionItemsAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticContext?: FormSpecSerializedCompletionContext | null\n): CompletionItem[] {\n  if (semanticContext !== null && semanticContext !== undefined) {\n    if (semanticContext.kind === \"target\") {\n      return semanticContext.semantic.targetCompletions.map((target: string) => ({\n        label: target,\n        kind:\n          target === \"singular\" || target === \"plural\"\n            ? CompletionItemKind.EnumMember\n            : CompletionItemKind.Field,\n        detail: `Target for @${semanticContext.semantic.tagName}`,\n      }));\n    }\n\n    if (semanticContext.kind !== \"tag-name\") {\n      return [];\n    }\n\n    const normalizedPrefix = semanticContext.prefix.toLowerCase();\n    return semanticContext.availableTags\n      .map(toCompletionItem)\n      .filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));\n  }\n\n  const resolvedContext = getSemanticCommentCompletionContextAtOffset(\n    documentText,\n    offset,\n    extensions ? { extensions } : undefined\n  );\n\n  if (resolvedContext.kind === \"target\") {\n    return resolvedContext.semantic.targetCompletions.map((target: string) => ({\n      label: target,\n      kind:\n        target === \"singular\" || target === \"plural\"\n          ? CompletionItemKind.EnumMember\n          : CompletionItemKind.Field,\n      detail: `Target for @${resolvedContext.semantic.tag.normalizedTagName}`,\n    }));\n  }\n\n  if (resolvedContext.kind !== \"tag-name\") {\n    return [];\n  }\n\n  const normalizedPrefix = resolvedContext.prefix.toLowerCase();\n  return resolvedContext.availableTags\n    .map(toCompletionItem)\n    .filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));\n}\n","/**\n * Hover provider for FormSpec JSDoc tags.\n *\n * Uses the shared registry from `@formspec/analysis` so hover content stays in\n * sync with the tag inventory and overload metadata.\n */\n\nimport {\n  type FormSpecSerializedHoverInfo,\n  getCommentHoverInfoAtOffset,\n  getTagDefinition,\n  normalizeFormSpecTagName,\n} from \"@formspec/analysis\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport type { Hover } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns hover content for a single FormSpec tag name.\n *\n * @public\n */\nexport function getHoverForTag(\n  tagName: string,\n  extensions?: readonly ExtensionDefinition[]\n): Hover | null {\n  const raw = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\n  const definition = getTagDefinition(normalizeFormSpecTagName(raw), extensions);\n  if (!definition) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: definition.hoverMarkdown,\n    },\n  };\n}\n\n/** @internal */\nexport function getHoverAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticHover?: FormSpecSerializedHoverInfo | null\n): Hover | null {\n  const hoverInfo =\n    semanticHover ??\n    getCommentHoverInfoAtOffset(documentText, offset, extensions ? { extensions } : undefined);\n  if (hoverInfo === null) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: hoverInfo.markdown,\n    },\n  };\n}\n","/**\n * Go-to-definition provider for FormSpec.\n *\n * This is a stub — go-to-definition support (e.g., navigating from a\n * `field.text(\"name\")` call to the form definition that references it) will\n * be implemented in a future phase.\n */\n\nimport type { Location } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the definition location for a symbol at the given position.\n *\n * Always returns `null` in this stub implementation.\n *\n * @returns `null` — not yet implemented\n * @public\n */\nexport function getDefinition(): Location | null {\n  return null;\n}\n","import fs from \"node:fs/promises\";\nimport net from \"node:net\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n  computeFormSpecTextHash,\n  getFormSpecManifestPath,\n  isFormSpecAnalysisManifest,\n  isFormSpecSemanticResponse,\n  type FormSpecAnalysisManifest,\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedHoverInfo,\n  type FormSpecSemanticQuery,\n  type FormSpecSemanticResponse,\n} from \"@formspec/analysis\";\n\nconst DEFAULT_PLUGIN_QUERY_TIMEOUT_MS = 2_000;\n\nfunction getManifestPath(workspaceRoot: string): string {\n  return getFormSpecManifestPath(workspaceRoot);\n}\n\nfunction normalizeWorkspaceRoot(root: string): string {\n  const resolved = path.resolve(root);\n  const parsed = path.parse(resolved);\n  let normalized = resolved;\n\n  while (normalized.length > parsed.root.length && normalized.endsWith(path.sep)) {\n    normalized = normalized.slice(0, -path.sep.length);\n  }\n\n  return normalized;\n}\n\nfunction getMatchingWorkspaceRoot(\n  workspaceRoots: readonly string[],\n  filePath: string\n): string | null {\n  const normalizedFilePath = path.resolve(filePath);\n  const normalizedRoots = [...workspaceRoots]\n    .map(normalizeWorkspaceRoot)\n    .sort((left, right) => right.length - left.length);\n  return (\n    normalizedRoots.find(\n      (workspaceRoot) =>\n        normalizedFilePath === workspaceRoot ||\n        normalizedFilePath.startsWith(`${workspaceRoot}${path.sep}`)\n    ) ?? null\n  );\n}\n\nasync function readManifest(workspaceRoot: string): Promise<FormSpecAnalysisManifest | null> {\n  try {\n    const manifestText = await fs.readFile(getManifestPath(workspaceRoot), \"utf8\");\n    const manifest = JSON.parse(manifestText) as unknown;\n    if (!isFormSpecAnalysisManifest(manifest)) {\n      return null;\n    }\n\n    return manifest;\n  } catch {\n    return null;\n  }\n}\n\nasync function sendSemanticQuery(\n  manifest: FormSpecAnalysisManifest,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  return new Promise((resolve) => {\n    const socket = net.createConnection(manifest.endpoint.address);\n    let buffer = \"\";\n    let settled = false;\n\n    const finish = (response: FormSpecSemanticResponse | null): void => {\n      if (settled) {\n        return;\n      }\n      settled = true;\n      socket.removeAllListeners(\"data\");\n      socket.destroy();\n      resolve(response);\n    };\n\n    socket.setTimeout(timeoutMs, () => {\n      finish(null);\n    });\n\n    socket.setEncoding(\"utf8\");\n    socket.on(\"connect\", () => {\n      socket.write(`${JSON.stringify(query)}\\n`);\n    });\n    socket.on(\"data\", (chunk) => {\n      buffer += String(chunk);\n      const newlineIndex = buffer.indexOf(\"\\n\");\n      if (newlineIndex < 0) {\n        return;\n      }\n\n      const payload = buffer.slice(0, newlineIndex);\n      buffer = buffer.slice(newlineIndex + 1);\n      try {\n        const response = JSON.parse(payload) as unknown;\n        finish(isFormSpecSemanticResponse(response) ? response : null);\n      } catch {\n        finish(null);\n      }\n    });\n    socket.on(\"error\", () => {\n      finish(null);\n    });\n    socket.on(\"close\", () => {\n      finish(null);\n    });\n  });\n}\n\nexport function fileUriToPathOrNull(uri: string): string | null {\n  try {\n    return fileURLToPath(uri);\n  } catch {\n    return null;\n  }\n}\n\nasync function sendFileQuery(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  const workspaceRoot = getMatchingWorkspaceRoot(workspaceRoots, filePath);\n  if (workspaceRoot === null) {\n    return null;\n  }\n\n  const manifest = await readManifest(workspaceRoot);\n  if (manifest === null) {\n    return null;\n  }\n\n  return sendSemanticQuery(manifest, query, timeoutMs);\n}\n\nexport async function getPluginCompletionContextForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedCompletionContext | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"completion\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"completion\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.context : null;\n}\n\nexport async function getPluginHoverForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedHoverInfo | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"hover\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"hover\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.hover : null;\n}\n"],"mappings":"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","names":["normalizedPrefix"]}
+{"version":3,"sources":["../src/server.ts","../src/providers/completion.ts","../src/providers/hover.ts","../src/providers/definition.ts","../src/diagnostics.ts","../src/plugin-client.ts"],"sourcesContent":["/**\n * FormSpec Language Server\n *\n * Sets up an LSP server connection and registers handlers for:\n * - `textDocument/completion` — FormSpec JSDoc constraint tag completions\n * - `textDocument/hover` — Documentation for recognized constraint tags\n * - `textDocument/definition` — Go-to-definition (stub, returns null)\n *\n * The packaged language server is a reference implementation built on the same\n * composable helpers that downstream consumers can call directly.\n */\n\nimport {\n  createConnection,\n  Diagnostic,\n  ProposedFeatures,\n  TextDocuments,\n  TextDocumentSyncKind,\n  type Connection,\n  type InitializeResult,\n} from \"vscode-languageserver/node.js\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { TextDocument } from \"vscode-languageserver-textdocument\";\nimport { getCompletionItemsAtOffset } from \"./providers/completion.js\";\nimport { getHoverAtOffset } from \"./providers/hover.js\";\nimport { getDefinition } from \"./providers/definition.js\";\nimport { getPluginDiagnosticsForDocument, toLspDiagnostics } from \"./diagnostics.js\";\nimport {\n  fileUriToPathOrNull,\n  getPluginCompletionContextForDocument,\n  getPluginHoverForDocument,\n} from \"./plugin-client.js\";\n\nconst PLUGIN_QUERY_TIMEOUT_ENV_VAR = \"FORMSPEC_PLUGIN_QUERY_TIMEOUT_MS\";\n\nfunction dedupeWorkspaceRoots(workspaceRoots: readonly string[]): string[] {\n  return [...new Set(workspaceRoots)];\n}\n\nfunction resolvePluginQueryTimeoutMs(explicitTimeoutMs: number | undefined): number | undefined {\n  if (explicitTimeoutMs !== undefined) {\n    return explicitTimeoutMs;\n  }\n\n  const rawValue = process.env[PLUGIN_QUERY_TIMEOUT_ENV_VAR];\n  if (rawValue === undefined) {\n    return undefined;\n  }\n\n  const parsed = Number.parseInt(rawValue, 10);\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;\n}\n\nfunction getWorkspaceRootsFromInitializeParams(params: {\n  readonly workspaceFolders?: readonly { readonly uri: string }[] | null;\n  readonly rootUri?: string | null;\n  readonly rootPath?: string | null;\n}): string[] {\n  const workspaceFolders =\n    params.workspaceFolders\n      ?.map((workspaceFolder) => fileUriToPathOrNull(workspaceFolder.uri))\n      .filter((workspaceRoot): workspaceRoot is string => workspaceRoot !== null) ?? [];\n  const rootUri =\n    params.rootUri === null || params.rootUri === undefined\n      ? null\n      : fileUriToPathOrNull(params.rootUri);\n  const rootPath = params.rootPath ?? null;\n\n  return dedupeWorkspaceRoots([\n    ...workspaceFolders,\n    ...(rootUri === null ? [] : [rootUri]),\n    ...(rootPath === null ? [] : [rootPath]),\n  ]);\n}\n\n/**\n * Public configuration for constructing the FormSpec language server.\n *\n * @public\n */\nexport interface CreateServerOptions {\n  /** Optional extension definitions whose custom tags should be surfaced by tooling. */\n  readonly extensions?: readonly ExtensionDefinition[];\n  /** Optional workspace roots to use before initialize() provides them. */\n  readonly workspaceRoots?: readonly string[];\n  /** Set to false to disable tsserver-plugin semantic enrichment. */\n  readonly usePluginTransport?: boolean;\n  /** IPC timeout, in milliseconds, for semantic plugin requests. */\n  readonly pluginQueryTimeoutMs?: number;\n  /** Optional diagnostics publishing mode for the packaged reference LSP. */\n  readonly diagnosticsMode?: \"off\" | \"plugin\";\n  /** Source label to use when publishing plugin-derived diagnostics. */\n  readonly diagnosticSource?: string;\n}\n\n/**\n * Creates and configures the FormSpec language server connection.\n *\n * Registers LSP capability handlers and returns the connection.\n * Call `connection.listen()` to start accepting messages.\n *\n * @returns The configured LSP connection (not yet listening)\n * @public\n */\nexport function createServer(options: CreateServerOptions = {}): Connection {\n  const connection = createConnection(ProposedFeatures.all);\n  const documents = new TextDocuments(TextDocument);\n  let workspaceRoots = [...(options.workspaceRoots ?? [])];\n  const pluginQueryTimeoutMs = resolvePluginQueryTimeoutMs(options.pluginQueryTimeoutMs);\n  const diagnosticsMode = options.diagnosticsMode ?? \"off\";\n  const diagnosticSource = options.diagnosticSource ?? \"formspec\";\n\n  documents.listen(connection);\n\n  async function publishDiagnosticsForDocument(document: TextDocument): Promise<void> {\n    if (diagnosticsMode !== \"plugin\" || options.usePluginTransport === false) {\n      return;\n    }\n\n    const filePath = fileUriToPathOrNull(document.uri);\n    if (filePath === null) {\n      return;\n    }\n\n    const diagnostics =\n      (await getPluginDiagnosticsForDocument(\n        workspaceRoots,\n        filePath,\n        document.getText(),\n        pluginQueryTimeoutMs\n      )) ?? [];\n\n    void connection.sendDiagnostics({\n      uri: document.uri,\n      diagnostics: toLspDiagnostics(document, diagnostics, {\n        source: diagnosticSource,\n      }),\n    });\n  }\n\n  connection.onInitialize((params): InitializeResult => {\n    workspaceRoots = dedupeWorkspaceRoots([\n      ...getWorkspaceRootsFromInitializeParams(params),\n      ...workspaceRoots,\n    ]);\n\n    return {\n      capabilities: {\n        textDocumentSync: TextDocumentSyncKind.Incremental,\n        completionProvider: {\n          // Trigger completions inside JSDoc comments for tags and target specifiers\n          triggerCharacters: [\"@\", \":\"],\n        },\n        hoverProvider: true,\n        definitionProvider: true,\n      },\n      serverInfo: {\n        name: \"formspec-language-server\",\n        version: \"0.1.0\",\n      },\n    };\n  });\n\n  connection.onCompletion(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return [];\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticContext =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginCompletionContextForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            pluginQueryTimeoutMs\n          );\n\n    return getCompletionItemsAtOffset(documentText, offset, options.extensions, semanticContext);\n  });\n\n  connection.onHover(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return null;\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticHover =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginHoverForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            pluginQueryTimeoutMs\n          );\n\n    return getHoverAtOffset(documentText, offset, options.extensions, semanticHover);\n  });\n\n  connection.onDefinition((_params) => {\n    // Go-to-definition is not yet implemented.\n    return getDefinition();\n  });\n\n  documents.onDidOpen(({ document }) => {\n    void publishDiagnosticsForDocument(document).catch((error: unknown) => {\n      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);\n    });\n  });\n\n  documents.onDidChangeContent(({ document }) => {\n    void publishDiagnosticsForDocument(document).catch((error: unknown) => {\n      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);\n    });\n  });\n\n  documents.onDidClose(({ document }) => {\n    if (diagnosticsMode === \"plugin\") {\n      void connection.sendDiagnostics({\n        uri: document.uri,\n        diagnostics: [] satisfies Diagnostic[],\n      });\n    }\n  });\n\n  return connection;\n}\n","/**\n * Completion provider for FormSpec JSDoc constraint tags.\n *\n * Uses the shared tag registry from `@formspec/analysis` so completions stay\n * aligned with the same metadata that powers linting and build-time analysis.\n */\n\nimport {\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedTagDefinition,\n  getConstraintTagDefinitions,\n  getSemanticCommentCompletionContextAtOffset,\n  type TagDefinition,\n} from \"@formspec/analysis/internal\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { CompletionItem, CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the full set of tag-name completions currently known to FormSpec.\n *\n * @public\n */\nexport function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[] {\n  return getConstraintTagDefinitions(extensions).map((tag) => ({\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  }));\n}\n\nfunction toCompletionItem(tag: TagDefinition | FormSpecSerializedTagDefinition): CompletionItem {\n  return {\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  };\n}\n\nfunction toTargetCompletionItems(\n  tagName: string,\n  targetCompletions: readonly string[]\n): CompletionItem[] {\n  return targetCompletions.map((target: string) => ({\n    label: target,\n    kind:\n      target === \"singular\" || target === \"plural\"\n        ? CompletionItemKind.EnumMember\n        : CompletionItemKind.Field,\n    detail: `Target for @${tagName}`,\n  }));\n}\n\nfunction filterTagNameCompletionItems(\n  prefix: string,\n  availableTags: readonly (TagDefinition | FormSpecSerializedTagDefinition)[]\n): CompletionItem[] {\n  const normalizedPrefix = prefix.toLowerCase();\n  return availableTags\n    .map(toCompletionItem)\n    .filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));\n}\n\n/** @internal */\nexport function getCompletionItemsAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticContext?: FormSpecSerializedCompletionContext | null\n): CompletionItem[] {\n  if (semanticContext !== null && semanticContext !== undefined) {\n    if (semanticContext.kind === \"target\") {\n      return toTargetCompletionItems(\n        semanticContext.semantic.tagName,\n        semanticContext.semantic.targetCompletions\n      );\n    }\n\n    if (semanticContext.kind !== \"tag-name\") {\n      return [];\n    }\n\n    return filterTagNameCompletionItems(semanticContext.prefix, semanticContext.availableTags);\n  }\n\n  const resolvedContext = getSemanticCommentCompletionContextAtOffset(\n    documentText,\n    offset,\n    extensions ? { extensions } : undefined\n  );\n\n  if (resolvedContext.kind === \"target\") {\n    return toTargetCompletionItems(\n      resolvedContext.semantic.tag.normalizedTagName,\n      resolvedContext.semantic.targetCompletions\n    );\n  }\n\n  if (resolvedContext.kind !== \"tag-name\") {\n    return [];\n  }\n\n  return filterTagNameCompletionItems(resolvedContext.prefix, resolvedContext.availableTags);\n}\n","/**\n * Hover provider for FormSpec JSDoc tags.\n *\n * Uses the shared registry from `@formspec/analysis` so hover content stays in\n * sync with the tag inventory and overload metadata.\n */\n\nimport {\n  type FormSpecSerializedHoverInfo,\n  getCommentHoverInfoAtOffset,\n  getTagDefinition,\n  normalizeFormSpecTagName,\n} from \"@formspec/analysis/internal\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport type { Hover } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns hover content for a single FormSpec tag name.\n *\n * @public\n */\nexport function getHoverForTag(\n  tagName: string,\n  extensions?: readonly ExtensionDefinition[]\n): Hover | null {\n  const raw = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\n  const definition = getTagDefinition(normalizeFormSpecTagName(raw), extensions);\n  if (!definition) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: definition.hoverMarkdown,\n    },\n  };\n}\n\n/** @internal */\nexport function getHoverAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticHover?: FormSpecSerializedHoverInfo | null\n): Hover | null {\n  const hoverInfo =\n    semanticHover ??\n    getCommentHoverInfoAtOffset(documentText, offset, extensions ? { extensions } : undefined);\n  if (hoverInfo === null) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: hoverInfo.markdown,\n    },\n  };\n}\n","/**\n * Go-to-definition provider for FormSpec.\n *\n * This is a stub — go-to-definition support (e.g., navigating from a\n * `field.text(\"name\")` call to the form definition that references it) will\n * be implemented in a future phase.\n */\n\nimport type { Location } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the definition location for a symbol at the given position.\n *\n * Always returns `null` in this stub implementation.\n *\n * @returns `null` — not yet implemented\n * @public\n */\nexport function getDefinition(): Location | null {\n  return null;\n}\n","import type {\n  FormSpecAnalysisDiagnostic,\n  FormSpecAnalysisDiagnosticLocation,\n} from \"@formspec/analysis/protocol\";\nimport {\n  DiagnosticRelatedInformation,\n  DiagnosticSeverity,\n  Location,\n  Range,\n  type Diagnostic,\n} from \"vscode-languageserver/node.js\";\nimport type { TextDocument } from \"vscode-languageserver-textdocument\";\nimport { fileUriToPathOrNull } from \"./plugin-client.js\";\nexport { getPluginDiagnosticsForDocument } from \"./plugin-client.js\";\n\n/**\n * Options for converting canonical FormSpec diagnostics into LSP diagnostics.\n *\n * @public\n */\nexport interface ToLspDiagnosticsOptions {\n  /** Source label shown by LSP clients. Defaults to `formspec`. */\n  readonly source?: string;\n}\n\n/**\n * Converts canonical FormSpec diagnostics into LSP diagnostics.\n *\n * Downstream consumers that want complete white-label control can ignore this\n * helper and render their own messages from `code` + `data`.\n *\n * @public\n */\nexport function toLspDiagnostics(\n  document: TextDocument,\n  diagnostics: readonly FormSpecAnalysisDiagnostic[],\n  options: ToLspDiagnosticsOptions = {}\n): Diagnostic[] {\n  const source = options.source ?? \"formspec\";\n  return diagnostics.map((diagnostic) => {\n    const relatedInformation = toRelatedInformation(document, diagnostic.relatedLocations);\n    return {\n      range: spanToRange(document, diagnostic.range.start, diagnostic.range.end),\n      severity: toLspSeverity(diagnostic.severity),\n      source,\n      code: diagnostic.code,\n      message: diagnostic.message,\n      ...(relatedInformation === undefined ? {} : { relatedInformation }),\n      data: {\n        ...diagnostic.data,\n        category: diagnostic.category,\n      },\n    };\n  });\n}\n\nfunction spanToRange(document: TextDocument, start: number, end: number): Range {\n  return Range.create(document.positionAt(start), document.positionAt(end));\n}\n\nfunction toLspSeverity(severity: FormSpecAnalysisDiagnostic[\"severity\"]): DiagnosticSeverity {\n  switch (severity) {\n    case \"error\":\n      return DiagnosticSeverity.Error;\n    case \"warning\":\n      return DiagnosticSeverity.Warning;\n    case \"info\":\n      return DiagnosticSeverity.Information;\n    default:\n      return DiagnosticSeverity.Information;\n  }\n}\n\nfunction toRelatedInformation(\n  document: TextDocument,\n  locations: readonly FormSpecAnalysisDiagnosticLocation[]\n): DiagnosticRelatedInformation[] | undefined {\n  if (locations.length === 0) {\n    return undefined;\n  }\n\n  const currentDocumentFilePath = getDocumentFilePath(document);\n  const relatedInformation = locations\n    .filter((location) => location.filePath === currentDocumentFilePath)\n    .map((location) =>\n      DiagnosticRelatedInformation.create(\n        Location.create(\n          document.uri,\n          spanToRange(document, location.range.start, location.range.end)\n        ),\n        location.message ?? \"Related FormSpec location\"\n      )\n    );\n\n  return relatedInformation.length === 0 ? undefined : relatedInformation;\n}\n\nfunction getDocumentFilePath(document: TextDocument): string | null {\n  return fileUriToPathOrNull(document.uri);\n}\n","import fs from \"node:fs/promises\";\nimport net from \"node:net\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n  computeFormSpecTextHash,\n  getFormSpecManifestPath,\n  isFormSpecAnalysisManifest,\n  isFormSpecSemanticResponse,\n  type FormSpecAnalysisDiagnostic,\n  type FormSpecAnalysisManifest,\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedHoverInfo,\n  type FormSpecSemanticQuery,\n  type FormSpecSemanticResponse,\n} from \"@formspec/analysis/protocol\";\n\nconst DEFAULT_PLUGIN_QUERY_TIMEOUT_MS = 2_000;\n\nfunction getManifestPath(workspaceRoot: string): string {\n  return getFormSpecManifestPath(workspaceRoot);\n}\n\nfunction normalizeWorkspaceRoot(root: string): string {\n  const resolved = path.resolve(root);\n  const parsed = path.parse(resolved);\n  let normalized = resolved;\n\n  while (normalized.length > parsed.root.length && normalized.endsWith(path.sep)) {\n    normalized = normalized.slice(0, -path.sep.length);\n  }\n\n  return normalized;\n}\n\nfunction getMatchingWorkspaceRoot(\n  workspaceRoots: readonly string[],\n  filePath: string\n): string | null {\n  const normalizedFilePath = path.resolve(filePath);\n  const normalizedRoots = [...workspaceRoots]\n    .map(normalizeWorkspaceRoot)\n    .sort((left, right) => right.length - left.length);\n  return (\n    normalizedRoots.find(\n      (workspaceRoot) =>\n        normalizedFilePath === workspaceRoot ||\n        normalizedFilePath.startsWith(`${workspaceRoot}${path.sep}`)\n    ) ?? null\n  );\n}\n\nasync function readManifest(workspaceRoot: string): Promise<FormSpecAnalysisManifest | null> {\n  try {\n    const manifestText = await fs.readFile(getManifestPath(workspaceRoot), \"utf8\");\n    const manifest = JSON.parse(manifestText) as unknown;\n    if (!isFormSpecAnalysisManifest(manifest)) {\n      return null;\n    }\n\n    return manifest;\n  } catch {\n    return null;\n  }\n}\n\nasync function sendSemanticQuery(\n  manifest: FormSpecAnalysisManifest,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  return new Promise((resolve) => {\n    const socket = net.createConnection(manifest.endpoint.address);\n    let buffer = \"\";\n    let settled = false;\n\n    const finish = (response: FormSpecSemanticResponse | null): void => {\n      if (settled) {\n        return;\n      }\n      settled = true;\n      socket.removeAllListeners(\"data\");\n      socket.destroy();\n      resolve(response);\n    };\n\n    socket.setTimeout(timeoutMs, () => {\n      finish(null);\n    });\n\n    socket.setEncoding(\"utf8\");\n    socket.on(\"connect\", () => {\n      socket.write(`${JSON.stringify(query)}\\n`);\n    });\n    socket.on(\"data\", (chunk) => {\n      buffer += String(chunk);\n      const newlineIndex = buffer.indexOf(\"\\n\");\n      if (newlineIndex < 0) {\n        return;\n      }\n\n      const payload = buffer.slice(0, newlineIndex);\n      buffer = buffer.slice(newlineIndex + 1);\n      try {\n        const response = JSON.parse(payload) as unknown;\n        finish(isFormSpecSemanticResponse(response) ? response : null);\n      } catch {\n        finish(null);\n      }\n    });\n    socket.on(\"error\", () => {\n      finish(null);\n    });\n    socket.on(\"close\", () => {\n      finish(null);\n    });\n  });\n}\n\nexport function fileUriToPathOrNull(uri: string): string | null {\n  try {\n    return fileURLToPath(uri);\n  } catch {\n    return null;\n  }\n}\n\nasync function sendFileQuery(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  const workspaceRoot = getMatchingWorkspaceRoot(workspaceRoots, filePath);\n  if (workspaceRoot === null) {\n    return null;\n  }\n\n  const manifest = await readManifest(workspaceRoot);\n  if (manifest === null) {\n    return null;\n  }\n\n  return sendSemanticQuery(manifest, query, timeoutMs);\n}\n\nexport async function getPluginCompletionContextForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedCompletionContext | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"completion\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"completion\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.context : null;\n}\n\nexport async function getPluginHoverForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedHoverInfo | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"hover\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"hover\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.hover : null;\n}\n\n/**\n * Retrieves canonical FormSpec diagnostics for the current document revision\n * from the plugin transport. Returns `null` when the transport is missing,\n * stale, or invalid.\n *\n * @public\n */\nexport async function getPluginDiagnosticsForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<readonly FormSpecAnalysisDiagnostic[] | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"diagnostics\",\n      filePath,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"diagnostics\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText)\n    ? response.diagnostics\n    : null;\n}\n"],"mappings":"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","names":[]}

package/dist/language-server.d.ts

@@ -10,7 +10,8 @@
  * LSP process, while TypeScript-project-aware semantics are supplied by
  * `@formspec/ts-plugin` over a local manifest + IPC transport.
  *
- * Diagnostics are intentionally omitted per design decision A7.
+ * The packaged server acts as a reference implementation over the composable
+ * completion, hover, and diagnostics helpers exported from this package.
  *
  * @example
  * ```ts
@@ -25,9 +26,17 @@
 
 import { CompletionItem } from 'vscode-languageserver/node.js';
 import { Connection } from 'vscode-languageserver/node.js';
+import { Diagnostic } from 'vscode-languageserver/node.js';
 import type { ExtensionDefinition } from '@formspec/core';
 import type { Hover } from 'vscode-languageserver/node.js';
 import type { Location } from 'vscode-languageserver/node.js';
+import type { TextDocument } from 'vscode-languageserver-textdocument';
+
+/** @public */
+export declare interface CommentSpan {
+    readonly start: number;
+    readonly end: number;
+}
 
 /**
  * Creates and configures the FormSpec language server connection.
@@ -54,6 +63,51 @@ export declare interface CreateServerOptions {
     readonly usePluginTransport?: boolean;
     /** IPC timeout, in milliseconds, for semantic plugin requests. */
     readonly pluginQueryTimeoutMs?: number;
+    /** Optional diagnostics publishing mode for the packaged reference LSP. */
+    readonly diagnosticsMode?: "off" | "plugin";
+    /** Source label to use when publishing plugin-derived diagnostics. */
+    readonly diagnosticSource?: string;
+}
+
+/**
+ * File-local diagnostic derived from comment parsing or semantic analysis.
+ *
+ * @public
+ */
+export declare interface FormSpecAnalysisDiagnostic {
+    readonly code: string;
+    readonly category: FormSpecAnalysisDiagnosticCategory;
+    readonly message: string;
+    readonly range: CommentSpan;
+    readonly severity: "error" | "warning" | "info";
+    readonly relatedLocations: readonly FormSpecAnalysisDiagnosticLocation[];
+    readonly data: Record<string, FormSpecAnalysisDiagnosticDataValue>;
+}
+
+/**
+ * Machine-readable diagnostic category used by FormSpec tooling surfaces.
+ *
+ * @public
+ */
+export declare type FormSpecAnalysisDiagnosticCategory = "tag-recognition" | "value-parsing" | "type-compatibility" | "target-resolution" | "constraint-validation" | "infrastructure";
+
+/**
+ * Primitive structured values carried in diagnostic facts for white-label
+ * downstream rendering.
+ *
+ * @public
+ */
+export declare type FormSpecAnalysisDiagnosticDataValue = string | number | boolean | readonly string[] | readonly number[] | readonly boolean[];
+
+/**
+ * Additional source location associated with a diagnostic.
+ *
+ * @public
+ */
+export declare interface FormSpecAnalysisDiagnosticLocation {
+    readonly filePath: string;
+    readonly range: CommentSpan;
+    readonly message?: string;
 }
 
 /**
@@ -80,4 +134,33 @@ export declare function getDefinition(): Location | null;
  */
 export declare function getHoverForTag(tagName: string, extensions?: readonly ExtensionDefinition[]): Hover | null;
 
+/**
+ * Retrieves canonical FormSpec diagnostics for the current document revision
+ * from the plugin transport. Returns `null` when the transport is missing,
+ * stale, or invalid.
+ *
+ * @public
+ */
+export declare function getPluginDiagnosticsForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, timeoutMs?: number): Promise<readonly FormSpecAnalysisDiagnostic[] | null>;
+
+/**
+ * Converts canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * Downstream consumers that want complete white-label control can ignore this
+ * helper and render their own messages from `code` + `data`.
+ *
+ * @public
+ */
+export declare function toLspDiagnostics(document: TextDocument, diagnostics: readonly FormSpecAnalysisDiagnostic[], options?: ToLspDiagnosticsOptions): Diagnostic[];
+
+/**
+ * Options for converting canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * @public
+ */
+export declare interface ToLspDiagnosticsOptions {
+    /** Source label shown by LSP clients. Defaults to `formspec`. */
+    readonly source?: string;
+}
+
 export { }

package/dist/plugin-client.d.ts

@@ -1,5 +1,13 @@
-import { type FormSpecSerializedCompletionContext, type FormSpecSerializedHoverInfo } from "@formspec/analysis";
+import { type FormSpecAnalysisDiagnostic, type FormSpecSerializedCompletionContext, type FormSpecSerializedHoverInfo } from "@formspec/analysis/protocol";
 export declare function fileUriToPathOrNull(uri: string): string | null;
 export declare function getPluginCompletionContextForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, offset: number, timeoutMs?: number): Promise<FormSpecSerializedCompletionContext | null>;
 export declare function getPluginHoverForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, offset: number, timeoutMs?: number): Promise<FormSpecSerializedHoverInfo | null>;
+/**
+ * Retrieves canonical FormSpec diagnostics for the current document revision
+ * from the plugin transport. Returns `null` when the transport is missing,
+ * stale, or invalid.
+ *
+ * @public
+ */
+export declare function getPluginDiagnosticsForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, timeoutMs?: number): Promise<readonly FormSpecAnalysisDiagnostic[] | null>;
 //# sourceMappingURL=plugin-client.d.ts.map

package/dist/plugin-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-client.d.ts","sourceRoot":"","sources":["../src/plugin-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAOL,KAAK,mCAAmC,EACxC,KAAK,2BAA2B,EAGjC,MAAM,oBAAoB,CAAC;AAwG5B,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D;AAqBD,wBAAsB,qCAAqC,CACzD,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,SAAkC,GAC1C,OAAO,CAAC,mCAAmC,GAAG,IAAI,CAAC,CAiBrD;AAED,wBAAsB,yBAAyB,CAC7C,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,SAAkC,GAC1C,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAiB7C"}
+{"version":3,"file":"plugin-client.d.ts","sourceRoot":"","sources":["../src/plugin-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,0BAA0B,EAE/B,KAAK,mCAAmC,EACxC,KAAK,2BAA2B,EAGjC,MAAM,6BAA6B,CAAC;AAwGrC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D;AAqBD,wBAAsB,qCAAqC,CACzD,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,SAAkC,GAC1C,OAAO,CAAC,mCAAmC,GAAG,IAAI,CAAC,CAiBrD;AAED,wBAAsB,yBAAyB,CAC7C,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,SAAkC,GAC1C,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAiB7C;AAED;;;;;;GAMG;AACH,wBAAsB,+BAA+B,CACnD,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,SAAS,SAAkC,GAC1C,OAAO,CAAC,SAAS,0BAA0B,EAAE,GAAG,IAAI,CAAC,CAkBvD"}

package/dist/providers/completion.d.ts

@@ -4,7 +4,7 @@
  * Uses the shared tag registry from `@formspec/analysis` so completions stay
  * aligned with the same metadata that powers linting and build-time analysis.
  */
-import { type FormSpecSerializedCompletionContext } from "@formspec/analysis";
+import { type FormSpecSerializedCompletionContext } from "@formspec/analysis/internal";
 import type { ExtensionDefinition } from "@formspec/core";
 import { CompletionItem } from "vscode-languageserver/node.js";
 /**

package/dist/providers/completion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/providers/completion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,mCAAmC,EAKzC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAsB,MAAM,+BAA+B,CAAC;AAEnF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,cAAc,EAAE,CAMhG;AAUD,gBAAgB;AAChB,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,EAC3C,eAAe,CAAC,EAAE,mCAAmC,GAAG,IAAI,GAC3D,cAAc,EAAE,CAgDlB"}
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/providers/completion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,mCAAmC,EAKzC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAsB,MAAM,+BAA+B,CAAC;AAEnF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,cAAc,EAAE,CAMhG;AAkCD,gBAAgB;AAChB,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,EAC3C,eAAe,CAAC,EAAE,mCAAmC,GAAG,IAAI,GAC3D,cAAc,EAAE,CAkClB"}

package/dist/providers/hover.d.ts

@@ -4,7 +4,7 @@
  * Uses the shared registry from `@formspec/analysis` so hover content stays in
  * sync with the tag inventory and overload metadata.
  */
-import { type FormSpecSerializedHoverInfo } from "@formspec/analysis";
+import { type FormSpecSerializedHoverInfo } from "@formspec/analysis/internal";
 import type { ExtensionDefinition } from "@formspec/core";
 import type { Hover } from "vscode-languageserver/node.js";
 /**

package/dist/providers/hover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../src/providers/hover.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,2BAA2B,EAIjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAC1C,KAAK,GAAG,IAAI,CAad;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,EAC3C,aAAa,CAAC,EAAE,2BAA2B,GAAG,IAAI,GACjD,KAAK,GAAG,IAAI,CAcd"}
+{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../src/providers/hover.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,2BAA2B,EAIjC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAC1C,KAAK,GAAG,IAAI,CAad;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,EAC3C,aAAa,CAAC,EAAE,2BAA2B,GAAG,IAAI,GACjD,KAAK,GAAG,IAAI,CAcd"}

package/dist/server.d.ts

@@ -6,7 +6,8 @@
  * - `textDocument/hover` — Documentation for recognized constraint tags
  * - `textDocument/definition` — Go-to-definition (stub, returns null)
  *
- * Diagnostics are intentionally omitted per design decision A7.
+ * The packaged language server is a reference implementation built on the same
+ * composable helpers that downstream consumers can call directly.
  */
 import { type Connection } from "vscode-languageserver/node.js";
 import type { ExtensionDefinition } from "@formspec/core";
@@ -24,6 +25,10 @@ export interface CreateServerOptions {
     readonly usePluginTransport?: boolean;
     /** IPC timeout, in milliseconds, for semantic plugin requests. */
     readonly pluginQueryTimeoutMs?: number;
+    /** Optional diagnostics publishing mode for the packaged reference LSP. */
+    readonly diagnosticsMode?: "off" | "plugin";
+    /** Source label to use when publishing plugin-derived diagnostics. */
+    readonly diagnosticSource?: string;
 }
 /**
  * Creates and configures the FormSpec language server connection.

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAqC1D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,yEAAyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,mEAAmE;IACnE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAkF1E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAML,KAAK,UAAU,EAEhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAsD1D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,yEAAyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,mEAAmE;IACnE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAoI1E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formspec/language-server",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.22",
   "description": "Language server for FormSpec — completions, hover, and go-to-definition for JSDoc constraint tags",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -20,8 +20,8 @@
   "dependencies": {
     "vscode-languageserver": "^9.0.1",
     "vscode-languageserver-textdocument": "^1.0.12",
-    "@formspec/analysis": "0.1.0-alpha.20",
-    "@formspec/core": "0.1.0-alpha.19"
+    "@formspec/analysis": "0.1.0-alpha.22",
+    "@formspec/core": "0.1.0-alpha.21"
   },
   "devDependencies": {
     "vitest": "^3.0.0"