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

package/dist/index.cjs

@@ -42,10 +42,10 @@ var import_node2 = 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 +58,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 +115,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;
   }
@@ -130,10 +137,10 @@ 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 +162,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 +202,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 +238,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 +248,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 +265,25 @@ 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;
 }
 
 // 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);
@@ -279,6 +298,7 @@ function createServer(options = {}) {
   const connection = (0, import_node2.createConnection)(import_node2.ProposedFeatures.all);
   const documents = new import_node2.TextDocuments(import_vscode_languageserver_textdocument.TextDocument);
   let workspaceRoots = [...options.workspaceRoots ?? []];
+  const pluginQueryTimeoutMs = resolvePluginQueryTimeoutMs(options.pluginQueryTimeoutMs);
   documents.listen(connection);
   connection.onInitialize((params) => {
     workspaceRoots = dedupeWorkspaceRoots([
@@ -314,7 +334,7 @@ function createServer(options = {}) {
       filePath,
       documentText,
       offset,
-      options.pluginQueryTimeoutMs
+      pluginQueryTimeoutMs
     );
     return getCompletionItemsAtOffset(documentText, offset, options.extensions, semanticContext);
   });
@@ -331,7 +351,7 @@ function createServer(options = {}) {
       filePath,
       documentText,
       offset,
-      options.pluginQueryTimeoutMs
+      pluginQueryTimeoutMs
     );
     return getHoverAtOffset(documentText, offset, options.extensions, semanticHover);
   });

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACWA,IAAAA,eAOO;AAEP,gDAA6B;;;ACb7B,sBAMO;AAEP,kBAAmD;AAO5C,SAAS,mBAAmB,YAA+D;AAChG,aAAO,6CAA4B,UAAU,EAAE,IAAI,CAAC,SAAS;AAAA,IAC3D,OAAO,IAAI,IAAI,aAAa;AAAA,IAC5B,MAAM,+BAAmB;AAAA,IACzB,QAAQ,IAAI;AAAA,EACd,EAAE;AACJ;AAEA,SAAS,iBAAiB,KAAsE;AAC9F,SAAO;AAAA,IACL,OAAO,IAAI,IAAI,aAAa;AAAA,IAC5B,MAAM,+BAAmB;AAAA,IACzB,QAAQ,IAAI;AAAA,EACd;AACF;AAGO,SAAS,2BACd,cACA,QACA,YACA,iBACkB;AAClB,MAAI,oBAAoB,QAAQ,oBAAoB,QAAW;AAC7D,QAAI,gBAAgB,SAAS,UAAU;AACrC,aAAO,gBAAgB,SAAS,kBAAkB,IAAI,CAAC,YAAoB;AAAA,QACzE,OAAO;AAAA,QACP,MACE,WAAW,cAAc,WAAW,WAChC,+BAAmB,aACnB,+BAAmB;AAAA,QACzB,QAAQ,eAAe,gBAAgB,SAAS,OAAO;AAAA,MACzD,EAAE;AAAA,IACJ;AAEA,QAAI,gBAAgB,SAAS,YAAY;AACvC,aAAO,CAAC;AAAA,IACV;AAEA,UAAMC,oBAAmB,gBAAgB,OAAO,YAAY;AAC5D,WAAO,gBAAgB,cACpB,IAAI,gBAAgB,EACpB,OAAO,CAAC,SAAS,KAAK,MAAM,MAAM,CAAC,EAAE,YAAY,EAAE,WAAWA,iBAAgB,CAAC;AAAA,EACpF;AAEA,QAAM,sBAAkB;AAAA,IACtB;AAAA,IACA;AAAA,IACA,aAAa,EAAE,WAAW,IAAI;AAAA,EAChC;AAEA,MAAI,gBAAgB,SAAS,UAAU;AACrC,WAAO,gBAAgB,SAAS,kBAAkB,IAAI,CAAC,YAAoB;AAAA,MACzE,OAAO;AAAA,MACP,MACE,WAAW,cAAc,WAAW,WAChC,+BAAmB,aACnB,+BAAmB;AAAA,MACzB,QAAQ,eAAe,gBAAgB,SAAS,IAAI,iBAAiB;AAAA,IACvE,EAAE;AAAA,EACJ;AAEA,MAAI,gBAAgB,SAAS,YAAY;AACvC,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,mBAAmB,gBAAgB,OAAO,YAAY;AAC5D,SAAO,gBAAgB,cACpB,IAAI,gBAAgB,EACpB,OAAO,CAAC,SAAS,KAAK,MAAM,MAAM,CAAC,EAAE,YAAY,EAAE,WAAW,gBAAgB,CAAC;AACpF;;;ACrFA,IAAAC,mBAKO;AASA,SAAS,eACd,SACA,YACc;AACd,QAAM,MAAM,QAAQ,WAAW,GAAG,IAAI,QAAQ,MAAM,CAAC,IAAI;AACzD,QAAM,iBAAa,uCAAiB,2CAAyB,GAAG,GAAG,UAAU;AAC7E,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,UAAU;AAAA,MACR,MAAM;AAAA,MACN,OAAO,WAAW;AAAA,IACpB;AAAA,EACF;AACF;AAGO,SAAS,iBACd,cACA,QACA,YACA,eACc;AACd,QAAM,YACJ,qBACA,8CAA4B,cAAc,QAAQ,aAAa,EAAE,WAAW,IAAI,MAAS;AAC3F,MAAI,cAAc,MAAM;AACtB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,UAAU;AAAA,MACR,MAAM;AAAA,MACN,OAAO,UAAU;AAAA,IACnB;AAAA,EACF;AACF;;;ACzCO,SAAS,gBAAiC;AAC/C,SAAO;AACT;;;ACpBA,sBAAe;AACf,sBAAgB;AAChB,uBAAiB;AACjB,sBAA8B;AAC9B,IAAAC,mBAWO;AAEP,IAAM,kCAAkC;AAExC,SAAS,gBAAgB,eAA+B;AACtD,aAAO,0CAAwB,aAAa;AAC9C;AAEA,SAAS,uBAAuB,MAAsB;AACpD,QAAM,WAAW,iBAAAC,QAAK,QAAQ,IAAI;AAClC,QAAM,SAAS,iBAAAA,QAAK,MAAM,QAAQ;AAClC,MAAI,aAAa;AAEjB,SAAO,WAAW,SAAS,OAAO,KAAK,UAAU,WAAW,SAAS,iBAAAA,QAAK,GAAG,GAAG;AAC9E,iBAAa,WAAW,MAAM,GAAG,CAAC,iBAAAA,QAAK,IAAI,MAAM;AAAA,EACnD;AAEA,SAAO;AACT;AAEA,SAAS,yBACP,gBACA,UACe;AACf,QAAM,qBAAqB,iBAAAA,QAAK,QAAQ,QAAQ;AAChD,QAAM,kBAAkB,CAAC,GAAG,cAAc,EACvC,IAAI,sBAAsB,EAC1B,KAAK,CAAC,MAAM,UAAU,MAAM,SAAS,KAAK,MAAM;AACnD,SACE,gBAAgB;AAAA,IACd,CAAC,kBACC,uBAAuB,iBACvB,mBAAmB,WAAW,GAAG,aAAa,GAAG,iBAAAA,QAAK,GAAG,EAAE;AAAA,EAC/D,KAAK;AAET;AAEA,eAAe,aAAa,eAAiE;AAC3F,MAAI;AACF,UAAM,eAAe,MAAM,gBAAAC,QAAG,SAAS,gBAAgB,aAAa,GAAG,MAAM;AAC7E,UAAM,WAAW,KAAK,MAAM,YAAY;AACxC,QAAI,KAAC,6CAA2B,QAAQ,GAAG;AACzC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,kBACb,UACA,OACA,YAAY,iCAC8B;AAC1C,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,SAAS,gBAAAC,QAAI,iBAAiB,SAAS,SAAS,OAAO;AAC7D,QAAI,SAAS;AACb,QAAI,UAAU;AAEd,UAAM,SAAS,CAAC,aAAoD;AAClE,UAAI,SAAS;AACX;AAAA,MACF;AACA,gBAAU;AACV,aAAO,mBAAmB,MAAM;AAChC,aAAO,QAAQ;AACf,cAAQ,QAAQ;AAAA,IAClB;AAEA,WAAO,WAAW,WAAW,MAAM;AACjC,aAAO,IAAI;AAAA,IACb,CAAC;AAED,WAAO,YAAY,MAAM;AACzB,WAAO,GAAG,WAAW,MAAM;AACzB,aAAO,MAAM,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,CAAI;AAAA,IAC3C,CAAC;AACD,WAAO,GAAG,QAAQ,CAAC,UAAU;AAC3B,gBAAU,OAAO,KAAK;AACtB,YAAM,eAAe,OAAO,QAAQ,IAAI;AACxC,UAAI,eAAe,GAAG;AACpB;AAAA,MACF;AAEA,YAAM,UAAU,OAAO,MAAM,GAAG,YAAY;AAC5C,eAAS,OAAO,MAAM,eAAe,CAAC;AACtC,UAAI;AACF,cAAM,WAAW,KAAK,MAAM,OAAO;AACnC,mBAAO,6CAA2B,QAAQ,IAAI,WAAW,IAAI;AAAA,MAC/D,QAAQ;AACN,eAAO,IAAI;AAAA,MACb;AAAA,IACF,CAAC;AACD,WAAO,GAAG,SAAS,MAAM;AACvB,aAAO,IAAI;AAAA,IACb,CAAC;AACD,WAAO,GAAG,SAAS,MAAM;AACvB,aAAO,IAAI;AAAA,IACb,CAAC;AAAA,EACH,CAAC;AACH;AAEO,SAAS,oBAAoB,KAA4B;AAC9D,MAAI;AACF,eAAO,+BAAc,GAAG;AAAA,EAC1B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,cACb,gBACA,UACA,OACA,YAAY,iCAC8B;AAC1C,QAAM,gBAAgB,yBAAyB,gBAAgB,QAAQ;AACvE,MAAI,kBAAkB,MAAM;AAC1B,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,MAAM,aAAa,aAAa;AACjD,MAAI,aAAa,MAAM;AACrB,WAAO;AAAA,EACT;AAEA,SAAO,kBAAkB,UAAU,OAAO,SAAS;AACrD;AAEA,eAAsB,sCACpB,gBACA,UACA,cACA,QACA,YAAY,iCACyC;AACrD,QAAM,WAAW,MAAM;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,MACE,iBAAiB;AAAA,MACjB,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACA,MAAI,UAAU,SAAS,cAAc;AACnC,WAAO;AAAA,EACT;AAEA,SAAO,SAAS,mBAAe,0CAAwB,YAAY,IAAI,SAAS,UAAU;AAC5F;AAEA,eAAsB,0BACpB,gBACA,UACA,cACA,QACA,YAAY,iCACiC;AAC7C,QAAM,WAAW,MAAM;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,MACE,iBAAiB;AAAA,MACjB,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACA,MAAI,UAAU,SAAS,SAAS;AAC9B,WAAO;AAAA,EACT;AAEA,SAAO,SAAS,mBAAe,0CAAwB,YAAY,IAAI,SAAS,QAAQ;AAC1F;;;AJpKA,SAAS,qBAAqB,gBAA6C;AACzE,SAAO,CAAC,GAAG,IAAI,IAAI,cAAc,CAAC;AACpC;AAEA,SAAS,sCAAsC,QAIlC;AACX,QAAM,mBACJ,OAAO,kBACH,IAAI,CAAC,oBAAoB,oBAAoB,gBAAgB,GAAG,CAAC,EAClE,OAAO,CAAC,kBAA2C,kBAAkB,IAAI,KAAK,CAAC;AACpF,QAAM,UACJ,OAAO,YAAY,QAAQ,OAAO,YAAY,SAC1C,OACA,oBAAoB,OAAO,OAAO;AACxC,QAAM,WAAW,OAAO,YAAY;AAEpC,SAAO,qBAAqB;AAAA,IAC1B,GAAG;AAAA,IACH,GAAI,YAAY,OAAO,CAAC,IAAI,CAAC,OAAO;AAAA,IACpC,GAAI,aAAa,OAAO,CAAC,IAAI,CAAC,QAAQ;AAAA,EACxC,CAAC;AACH;AA2BO,SAAS,aAAa,UAA+B,CAAC,GAAe;AAC1E,QAAM,iBAAa,+BAAiB,8BAAiB,GAAG;AACxD,QAAM,YAAY,IAAI,2BAAc,sDAAY;AAChD,MAAI,iBAAiB,CAAC,GAAI,QAAQ,kBAAkB,CAAC,CAAE;AAEvD,YAAU,OAAO,UAAU;AAE3B,aAAW,aAAa,CAAC,WAA6B;AACpD,qBAAiB,qBAAqB;AAAA,MACpC,GAAG,sCAAsC,MAAM;AAAA,MAC/C,GAAG;AAAA,IACL,CAAC;AAED,WAAO;AAAA,MACL,cAAc;AAAA,QACZ,kBAAkB,kCAAqB;AAAA,QACvC,oBAAoB;AAAA;AAAA,UAElB,mBAAmB,CAAC,KAAK,GAAG;AAAA,QAC9B;AAAA,QACA,eAAe;AAAA,QACf,oBAAoB;AAAA,MACtB;AAAA,MACA,YAAY;AAAA,QACV,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF,CAAC;AAED,aAAW,aAAa,OAAO,WAAW;AACxC,UAAM,WAAW,UAAU,IAAI,OAAO,aAAa,GAAG;AACtD,QAAI,CAAC,UAAU;AACb,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,SAAS,SAAS,SAAS,OAAO,QAAQ;AAChD,UAAM,eAAe,SAAS,QAAQ;AACtC,UAAM,WAAW,oBAAoB,OAAO,aAAa,GAAG;AAC5D,UAAM,kBACJ,QAAQ,uBAAuB,SAAS,aAAa,OACjD,OACA,MAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IACV;AAEN,WAAO,2BAA2B,cAAc,QAAQ,QAAQ,YAAY,eAAe;AAAA,EAC7F,CAAC;AAED,aAAW,QAAQ,OAAO,WAAW;AACnC,UAAM,WAAW,UAAU,IAAI,OAAO,aAAa,GAAG;AACtD,QAAI,CAAC,UAAU;AACb,aAAO;AAAA,IACT;AAEA,UAAM,SAAS,SAAS,SAAS,OAAO,QAAQ;AAChD,UAAM,eAAe,SAAS,QAAQ;AACtC,UAAM,WAAW,oBAAoB,OAAO,aAAa,GAAG;AAC5D,UAAM,gBACJ,QAAQ,uBAAuB,SAAS,aAAa,OACjD,OACA,MAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IACV;AAEN,WAAO,iBAAiB,cAAc,QAAQ,QAAQ,YAAY,aAAa;AAAA,EACjF,CAAC;AAED,aAAW,aAAa,CAAC,YAAY;AAEnC,WAAO,cAAc;AAAA,EACvB,CAAC;AAED,SAAO;AACT;","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/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\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}\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\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            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  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 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/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"],"mappings":"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","names":["import_node","import_internal","path","fs","net"]}

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);
@@ -109,7 +116,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);
@@ -241,9 +248,21 @@ async function getPluginHoverForDocument(workspaceRoots, filePath, documentText,
 }
 
 // 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,6 +277,7 @@ function createServer(options = {}) {
   const connection = createConnection(ProposedFeatures.all);
   const documents = new TextDocuments(TextDocument);
   let workspaceRoots = [...options.workspaceRoots ?? []];
+  const pluginQueryTimeoutMs = resolvePluginQueryTimeoutMs(options.pluginQueryTimeoutMs);
   documents.listen(connection);
   connection.onInitialize((params) => {
     workspaceRoots = dedupeWorkspaceRoots([
@@ -293,7 +313,7 @@ function createServer(options = {}) {
       filePath,
       documentText,
       offset,
-      options.pluginQueryTimeoutMs
+      pluginQueryTimeoutMs
     );
     return getCompletionItemsAtOffset(documentText, offset, options.extensions, semanticContext);
   });
@@ -310,7 +330,7 @@ function createServer(options = {}) {
       filePath,
       documentText,
       offset,
-      options.pluginQueryTimeoutMs
+      pluginQueryTimeoutMs
     );
     return getHoverAtOffset(documentText, offset, options.extensions, semanticHover);
   });

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/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\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}\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\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            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  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 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/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"],"mappings":"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","names":[]}

package/dist/plugin-client.d.ts

@@ -1,4 +1,4 @@
-import { type FormSpecSerializedCompletionContext, type FormSpecSerializedHoverInfo } from "@formspec/analysis";
+import { 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>;

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,EAOL,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"}

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.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;;;;;;;;;GASG;AAEH,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAqD1D;;;;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,CAmF1E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formspec/language-server",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.21",
   "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.21",
+    "@formspec/core": "0.1.0-alpha.21"
   },
   "devDependencies": {
     "vitest": "^3.0.0"