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

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\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":[]}
+{"version":3,"sources":["../src/server.ts","../src/providers/completion.ts","../src/providers/hover.ts","../src/providers/definition.ts","../src/diagnostics.ts","../src/plugin-client.ts"],"sourcesContent":["/**\n * FormSpec Language Server\n *\n * Sets up an LSP server connection and registers handlers for:\n * - `textDocument/completion` — FormSpec JSDoc constraint tag completions\n * - `textDocument/hover` — Documentation for recognized constraint tags\n * - `textDocument/definition` — Go-to-definition (stub, returns null)\n *\n * The packaged language server is a reference implementation built on the same\n * composable helpers that downstream consumers can call directly.\n */\n\nimport {\n  createConnection,\n  Diagnostic,\n  ProposedFeatures,\n  TextDocuments,\n  TextDocumentSyncKind,\n  type Connection,\n  type InitializeResult,\n} from \"vscode-languageserver/node.js\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { TextDocument } from \"vscode-languageserver-textdocument\";\nimport { getCompletionItemsAtOffset } from \"./providers/completion.js\";\nimport { getHoverAtOffset } from \"./providers/hover.js\";\nimport { getDefinition } from \"./providers/definition.js\";\nimport { getPluginDiagnosticsForDocument, toLspDiagnostics } from \"./diagnostics.js\";\nimport {\n  fileUriToPathOrNull,\n  getPluginCompletionContextForDocument,\n  getPluginHoverForDocument,\n} from \"./plugin-client.js\";\n\nconst PLUGIN_QUERY_TIMEOUT_ENV_VAR = \"FORMSPEC_PLUGIN_QUERY_TIMEOUT_MS\";\n\nfunction dedupeWorkspaceRoots(workspaceRoots: readonly string[]): string[] {\n  return [...new Set(workspaceRoots)];\n}\n\nfunction resolvePluginQueryTimeoutMs(explicitTimeoutMs: number | undefined): number | undefined {\n  if (explicitTimeoutMs !== undefined) {\n    return explicitTimeoutMs;\n  }\n\n  const rawValue = process.env[PLUGIN_QUERY_TIMEOUT_ENV_VAR];\n  if (rawValue === undefined) {\n    return undefined;\n  }\n\n  const parsed = Number.parseInt(rawValue, 10);\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;\n}\n\nfunction getWorkspaceRootsFromInitializeParams(params: {\n  readonly workspaceFolders?: readonly { readonly uri: string }[] | null;\n  readonly rootUri?: string | null;\n  readonly rootPath?: string | null;\n}): string[] {\n  const workspaceFolders =\n    params.workspaceFolders\n      ?.map((workspaceFolder) => fileUriToPathOrNull(workspaceFolder.uri))\n      .filter((workspaceRoot): workspaceRoot is string => workspaceRoot !== null) ?? [];\n  const rootUri =\n    params.rootUri === null || params.rootUri === undefined\n      ? null\n      : fileUriToPathOrNull(params.rootUri);\n  const rootPath = params.rootPath ?? null;\n\n  return dedupeWorkspaceRoots([\n    ...workspaceFolders,\n    ...(rootUri === null ? [] : [rootUri]),\n    ...(rootPath === null ? [] : [rootPath]),\n  ]);\n}\n\n/**\n * Public configuration for constructing the FormSpec language server.\n *\n * @public\n */\nexport interface CreateServerOptions {\n  /** Optional extension definitions whose custom tags should be surfaced by tooling. */\n  readonly extensions?: readonly ExtensionDefinition[];\n  /** Optional workspace roots to use before initialize() provides them. */\n  readonly workspaceRoots?: readonly string[];\n  /** Set to false to disable tsserver-plugin semantic enrichment. */\n  readonly usePluginTransport?: boolean;\n  /** IPC timeout, in milliseconds, for semantic plugin requests. */\n  readonly pluginQueryTimeoutMs?: number;\n  /** Optional diagnostics publishing mode for the packaged reference LSP. */\n  readonly diagnosticsMode?: \"off\" | \"plugin\";\n  /** Source label to use when publishing plugin-derived diagnostics. */\n  readonly diagnosticSource?: string;\n}\n\n/**\n * Creates and configures the FormSpec language server connection.\n *\n * Registers LSP capability handlers and returns the connection.\n * Call `connection.listen()` to start accepting messages.\n *\n * @returns The configured LSP connection (not yet listening)\n * @public\n */\nexport function createServer(options: CreateServerOptions = {}): Connection {\n  const connection = createConnection(ProposedFeatures.all);\n  const documents = new TextDocuments(TextDocument);\n  let workspaceRoots = [...(options.workspaceRoots ?? [])];\n  const pluginQueryTimeoutMs = resolvePluginQueryTimeoutMs(options.pluginQueryTimeoutMs);\n  const diagnosticsMode = options.diagnosticsMode ?? \"off\";\n  const diagnosticSource = options.diagnosticSource ?? \"formspec\";\n\n  documents.listen(connection);\n\n  async function publishDiagnosticsForDocument(document: TextDocument): Promise<void> {\n    if (diagnosticsMode !== \"plugin\" || options.usePluginTransport === false) {\n      return;\n    }\n\n    const filePath = fileUriToPathOrNull(document.uri);\n    if (filePath === null) {\n      return;\n    }\n\n    const diagnostics =\n      (await getPluginDiagnosticsForDocument(\n        workspaceRoots,\n        filePath,\n        document.getText(),\n        pluginQueryTimeoutMs\n      )) ?? [];\n\n    void connection.sendDiagnostics({\n      uri: document.uri,\n      diagnostics: toLspDiagnostics(document, diagnostics, {\n        source: diagnosticSource,\n      }),\n    });\n  }\n\n  connection.onInitialize((params): InitializeResult => {\n    workspaceRoots = dedupeWorkspaceRoots([\n      ...getWorkspaceRootsFromInitializeParams(params),\n      ...workspaceRoots,\n    ]);\n\n    return {\n      capabilities: {\n        textDocumentSync: TextDocumentSyncKind.Incremental,\n        completionProvider: {\n          // Trigger completions inside JSDoc comments for tags and target specifiers\n          triggerCharacters: [\"@\", \":\"],\n        },\n        hoverProvider: true,\n        definitionProvider: true,\n      },\n      serverInfo: {\n        name: \"formspec-language-server\",\n        version: \"0.1.0\",\n      },\n    };\n  });\n\n  connection.onCompletion(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return [];\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticContext =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginCompletionContextForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            pluginQueryTimeoutMs\n          );\n\n    return getCompletionItemsAtOffset(documentText, offset, options.extensions, semanticContext);\n  });\n\n  connection.onHover(async (params) => {\n    const document = documents.get(params.textDocument.uri);\n    if (!document) {\n      return null;\n    }\n\n    const offset = document.offsetAt(params.position);\n    const documentText = document.getText();\n    const filePath = fileUriToPathOrNull(params.textDocument.uri);\n    const semanticHover =\n      options.usePluginTransport === false || filePath === null\n        ? null\n        : await getPluginHoverForDocument(\n            workspaceRoots,\n            filePath,\n            documentText,\n            offset,\n            pluginQueryTimeoutMs\n          );\n\n    return getHoverAtOffset(documentText, offset, options.extensions, semanticHover);\n  });\n\n  connection.onDefinition((_params) => {\n    // Go-to-definition is not yet implemented.\n    return getDefinition();\n  });\n\n  documents.onDidOpen(({ document }) => {\n    void publishDiagnosticsForDocument(document).catch((error: unknown) => {\n      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);\n    });\n  });\n\n  documents.onDidChangeContent(({ document }) => {\n    void publishDiagnosticsForDocument(document).catch((error: unknown) => {\n      connection.console.error(`[FormSpec] Failed to publish diagnostics: ${String(error)}`);\n    });\n  });\n\n  documents.onDidClose(({ document }) => {\n    if (diagnosticsMode === \"plugin\") {\n      void connection.sendDiagnostics({\n        uri: document.uri,\n        diagnostics: [] satisfies Diagnostic[],\n      });\n    }\n  });\n\n  return connection;\n}\n","/**\n * Completion provider for FormSpec JSDoc constraint tags.\n *\n * Uses the shared tag registry from `@formspec/analysis` so completions stay\n * aligned with the same metadata that powers linting and build-time analysis.\n */\n\nimport {\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedTagDefinition,\n  getConstraintTagDefinitions,\n  getSemanticCommentCompletionContextAtOffset,\n  type TagDefinition,\n} from \"@formspec/analysis/internal\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { CompletionItem, CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the full set of tag-name completions currently known to FormSpec.\n *\n * @public\n */\nexport function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[] {\n  return getConstraintTagDefinitions(extensions).map((tag) => ({\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  }));\n}\n\nfunction toCompletionItem(tag: TagDefinition | FormSpecSerializedTagDefinition): CompletionItem {\n  return {\n    label: `@${tag.canonicalName}`,\n    kind: CompletionItemKind.Keyword,\n    detail: tag.completionDetail,\n  };\n}\n\nfunction toTargetCompletionItems(\n  tagName: string,\n  targetCompletions: readonly string[]\n): CompletionItem[] {\n  return targetCompletions.map((target: string) => ({\n    label: target,\n    kind:\n      target === \"singular\" || target === \"plural\"\n        ? CompletionItemKind.EnumMember\n        : CompletionItemKind.Field,\n    detail: `Target for @${tagName}`,\n  }));\n}\n\nfunction filterTagNameCompletionItems(\n  prefix: string,\n  availableTags: readonly (TagDefinition | FormSpecSerializedTagDefinition)[]\n): CompletionItem[] {\n  const normalizedPrefix = prefix.toLowerCase();\n  return availableTags\n    .map(toCompletionItem)\n    .filter((item) => item.label.slice(1).toLowerCase().startsWith(normalizedPrefix));\n}\n\n/** @internal */\nexport function getCompletionItemsAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticContext?: FormSpecSerializedCompletionContext | null\n): CompletionItem[] {\n  if (semanticContext !== null && semanticContext !== undefined) {\n    if (semanticContext.kind === \"target\") {\n      return toTargetCompletionItems(\n        semanticContext.semantic.tagName,\n        semanticContext.semantic.targetCompletions\n      );\n    }\n\n    if (semanticContext.kind !== \"tag-name\") {\n      return [];\n    }\n\n    return filterTagNameCompletionItems(semanticContext.prefix, semanticContext.availableTags);\n  }\n\n  const resolvedContext = getSemanticCommentCompletionContextAtOffset(\n    documentText,\n    offset,\n    extensions ? { extensions } : undefined\n  );\n\n  if (resolvedContext.kind === \"target\") {\n    return toTargetCompletionItems(\n      resolvedContext.semantic.tag.normalizedTagName,\n      resolvedContext.semantic.targetCompletions\n    );\n  }\n\n  if (resolvedContext.kind !== \"tag-name\") {\n    return [];\n  }\n\n  return filterTagNameCompletionItems(resolvedContext.prefix, resolvedContext.availableTags);\n}\n","/**\n * Hover provider for FormSpec JSDoc tags.\n *\n * Uses the shared registry from `@formspec/analysis` so hover content stays in\n * sync with the tag inventory and overload metadata.\n */\n\nimport {\n  type FormSpecSerializedHoverInfo,\n  getCommentHoverInfoAtOffset,\n  getTagDefinition,\n  normalizeFormSpecTagName,\n} from \"@formspec/analysis/internal\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport type { Hover } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns hover content for a single FormSpec tag name.\n *\n * @public\n */\nexport function getHoverForTag(\n  tagName: string,\n  extensions?: readonly ExtensionDefinition[]\n): Hover | null {\n  const raw = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\n  const definition = getTagDefinition(normalizeFormSpecTagName(raw), extensions);\n  if (!definition) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: definition.hoverMarkdown,\n    },\n  };\n}\n\n/** @internal */\nexport function getHoverAtOffset(\n  documentText: string,\n  offset: number,\n  extensions?: readonly ExtensionDefinition[],\n  semanticHover?: FormSpecSerializedHoverInfo | null\n): Hover | null {\n  const hoverInfo =\n    semanticHover ??\n    getCommentHoverInfoAtOffset(documentText, offset, extensions ? { extensions } : undefined);\n  if (hoverInfo === null) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: hoverInfo.markdown,\n    },\n  };\n}\n","/**\n * Go-to-definition provider for FormSpec.\n *\n * This is a stub — go-to-definition support (e.g., navigating from a\n * `field.text(\"name\")` call to the form definition that references it) will\n * be implemented in a future phase.\n */\n\nimport type { Location } from \"vscode-languageserver/node.js\";\n\n/**\n * Returns the definition location for a symbol at the given position.\n *\n * Always returns `null` in this stub implementation.\n *\n * @returns `null` — not yet implemented\n * @public\n */\nexport function getDefinition(): Location | null {\n  return null;\n}\n","import type {\n  FormSpecAnalysisDiagnostic,\n  FormSpecAnalysisDiagnosticLocation,\n} from \"@formspec/analysis/protocol\";\nimport {\n  DiagnosticRelatedInformation,\n  DiagnosticSeverity,\n  Location,\n  Range,\n  type Diagnostic,\n} from \"vscode-languageserver/node.js\";\nimport type { TextDocument } from \"vscode-languageserver-textdocument\";\nimport { fileUriToPathOrNull } from \"./plugin-client.js\";\nexport { getPluginDiagnosticsForDocument } from \"./plugin-client.js\";\n\n/**\n * Options for converting canonical FormSpec diagnostics into LSP diagnostics.\n *\n * @public\n */\nexport interface ToLspDiagnosticsOptions {\n  /** Source label shown by LSP clients. Defaults to `formspec`. */\n  readonly source?: string;\n}\n\n/**\n * Converts canonical FormSpec diagnostics into LSP diagnostics.\n *\n * Downstream consumers that want complete white-label control can ignore this\n * helper and render their own messages from `code` + `data`.\n *\n * @public\n */\nexport function toLspDiagnostics(\n  document: TextDocument,\n  diagnostics: readonly FormSpecAnalysisDiagnostic[],\n  options: ToLspDiagnosticsOptions = {}\n): Diagnostic[] {\n  const source = options.source ?? \"formspec\";\n  return diagnostics.map((diagnostic) => {\n    const relatedInformation = toRelatedInformation(document, diagnostic.relatedLocations);\n    return {\n      range: spanToRange(document, diagnostic.range.start, diagnostic.range.end),\n      severity: toLspSeverity(diagnostic.severity),\n      source,\n      code: diagnostic.code,\n      message: diagnostic.message,\n      ...(relatedInformation === undefined ? {} : { relatedInformation }),\n      data: {\n        ...diagnostic.data,\n        category: diagnostic.category,\n      },\n    };\n  });\n}\n\nfunction spanToRange(document: TextDocument, start: number, end: number): Range {\n  return Range.create(document.positionAt(start), document.positionAt(end));\n}\n\nfunction toLspSeverity(severity: FormSpecAnalysisDiagnostic[\"severity\"]): DiagnosticSeverity {\n  switch (severity) {\n    case \"error\":\n      return DiagnosticSeverity.Error;\n    case \"warning\":\n      return DiagnosticSeverity.Warning;\n    case \"info\":\n      return DiagnosticSeverity.Information;\n    default:\n      return DiagnosticSeverity.Information;\n  }\n}\n\nfunction toRelatedInformation(\n  document: TextDocument,\n  locations: readonly FormSpecAnalysisDiagnosticLocation[]\n): DiagnosticRelatedInformation[] | undefined {\n  if (locations.length === 0) {\n    return undefined;\n  }\n\n  const currentDocumentFilePath = getDocumentFilePath(document);\n  const relatedInformation = locations\n    .filter((location) => location.filePath === currentDocumentFilePath)\n    .map((location) =>\n      DiagnosticRelatedInformation.create(\n        Location.create(\n          document.uri,\n          spanToRange(document, location.range.start, location.range.end)\n        ),\n        location.message ?? \"Related FormSpec location\"\n      )\n    );\n\n  return relatedInformation.length === 0 ? undefined : relatedInformation;\n}\n\nfunction getDocumentFilePath(document: TextDocument): string | null {\n  return fileUriToPathOrNull(document.uri);\n}\n","import fs from \"node:fs/promises\";\nimport net from \"node:net\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n  computeFormSpecTextHash,\n  isFormSpecAnalysisManifest,\n  isFormSpecSemanticResponse,\n  type FormSpecAnalysisDiagnostic,\n  type FormSpecAnalysisManifest,\n  type FormSpecSerializedCompletionContext,\n  type FormSpecSerializedHoverInfo,\n  type FormSpecSemanticQuery,\n  type FormSpecSemanticResponse,\n} from \"@formspec/analysis/protocol\";\nimport { getFormSpecManifestPath } from \"@formspec/analysis/internal\";\n\nconst DEFAULT_PLUGIN_QUERY_TIMEOUT_MS = 2_000;\n\nfunction getManifestPath(workspaceRoot: string): string {\n  return getFormSpecManifestPath(workspaceRoot);\n}\n\nfunction normalizeWorkspaceRoot(root: string): string {\n  const resolved = path.resolve(root);\n  const parsed = path.parse(resolved);\n  let normalized = resolved;\n\n  while (normalized.length > parsed.root.length && normalized.endsWith(path.sep)) {\n    normalized = normalized.slice(0, -path.sep.length);\n  }\n\n  return normalized;\n}\n\nfunction getMatchingWorkspaceRoot(\n  workspaceRoots: readonly string[],\n  filePath: string\n): string | null {\n  const normalizedFilePath = path.resolve(filePath);\n  const normalizedRoots = [...workspaceRoots]\n    .map(normalizeWorkspaceRoot)\n    .sort((left, right) => right.length - left.length);\n  return (\n    normalizedRoots.find(\n      (workspaceRoot) =>\n        normalizedFilePath === workspaceRoot ||\n        normalizedFilePath.startsWith(`${workspaceRoot}${path.sep}`)\n    ) ?? null\n  );\n}\n\nasync function readManifest(workspaceRoot: string): Promise<FormSpecAnalysisManifest | null> {\n  try {\n    const manifestText = await fs.readFile(getManifestPath(workspaceRoot), \"utf8\");\n    const manifest = JSON.parse(manifestText) as unknown;\n    if (!isFormSpecAnalysisManifest(manifest)) {\n      return null;\n    }\n\n    return manifest;\n  } catch {\n    return null;\n  }\n}\n\nasync function sendSemanticQuery(\n  manifest: FormSpecAnalysisManifest,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  return new Promise((resolve) => {\n    const socket = net.createConnection(manifest.endpoint.address);\n    let buffer = \"\";\n    let settled = false;\n\n    const finish = (response: FormSpecSemanticResponse | null): void => {\n      if (settled) {\n        return;\n      }\n      settled = true;\n      socket.removeAllListeners(\"data\");\n      socket.destroy();\n      resolve(response);\n    };\n\n    socket.setTimeout(timeoutMs, () => {\n      finish(null);\n    });\n\n    socket.setEncoding(\"utf8\");\n    socket.on(\"connect\", () => {\n      socket.write(`${JSON.stringify(query)}\\n`);\n    });\n    socket.on(\"data\", (chunk) => {\n      buffer += String(chunk);\n      const newlineIndex = buffer.indexOf(\"\\n\");\n      if (newlineIndex < 0) {\n        return;\n      }\n\n      const payload = buffer.slice(0, newlineIndex);\n      buffer = buffer.slice(newlineIndex + 1);\n      try {\n        const response = JSON.parse(payload) as unknown;\n        finish(isFormSpecSemanticResponse(response) ? response : null);\n      } catch {\n        finish(null);\n      }\n    });\n    socket.on(\"error\", () => {\n      finish(null);\n    });\n    socket.on(\"close\", () => {\n      finish(null);\n    });\n  });\n}\n\nexport function fileUriToPathOrNull(uri: string): string | null {\n  try {\n    return fileURLToPath(uri);\n  } catch {\n    return null;\n  }\n}\n\nasync function sendFileQuery(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  query: FormSpecSemanticQuery,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSemanticResponse | null> {\n  const workspaceRoot = getMatchingWorkspaceRoot(workspaceRoots, filePath);\n  if (workspaceRoot === null) {\n    return null;\n  }\n\n  const manifest = await readManifest(workspaceRoot);\n  if (manifest === null) {\n    return null;\n  }\n\n  return sendSemanticQuery(manifest, query, timeoutMs);\n}\n\nexport async function getPluginCompletionContextForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedCompletionContext | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"completion\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"completion\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.context : null;\n}\n\nexport async function getPluginHoverForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  offset: number,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<FormSpecSerializedHoverInfo | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"hover\",\n      filePath,\n      offset,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"hover\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText) ? response.hover : null;\n}\n\n/**\n * Retrieves canonical FormSpec diagnostics for the current document revision\n * from the plugin transport. Returns `null` when the transport is missing,\n * stale, or invalid.\n *\n * @public\n */\nexport async function getPluginDiagnosticsForDocument(\n  workspaceRoots: readonly string[],\n  filePath: string,\n  documentText: string,\n  timeoutMs = DEFAULT_PLUGIN_QUERY_TIMEOUT_MS\n): Promise<readonly FormSpecAnalysisDiagnostic[] | null> {\n  const response = await sendFileQuery(\n    workspaceRoots,\n    filePath,\n    {\n      protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n      kind: \"diagnostics\",\n      filePath,\n    },\n    timeoutMs\n  );\n  if (response?.kind !== \"diagnostics\") {\n    return null;\n  }\n\n  return response.sourceHash === computeFormSpecTextHash(documentText)\n    ? response.diagnostics\n    : null;\n}\n"],"mappings":";AAYA;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,SAAS,oBAAoB;;;ACf7B;AAAA,EAGE;AAAA,EACA;AAAA,OAEK;AAEP,SAAyB,0BAA0B;AAO5C,SAAS,mBAAmB,YAA+D;AAChG,SAAO,4BAA4B,UAAU,EAAE,IAAI,CAAC,SAAS;AAAA,IAC3D,OAAO,IAAI,IAAI,aAAa;AAAA,IAC5B,MAAM,mBAAmB;AAAA,IACzB,QAAQ,IAAI;AAAA,EACd,EAAE;AACJ;AAEA,SAAS,iBAAiB,KAAsE;AAC9F,SAAO;AAAA,IACL,OAAO,IAAI,IAAI,aAAa;AAAA,IAC5B,MAAM,mBAAmB;AAAA,IACzB,QAAQ,IAAI;AAAA,EACd;AACF;AAEA,SAAS,wBACP,SACA,mBACkB;AAClB,SAAO,kBAAkB,IAAI,CAAC,YAAoB;AAAA,IAChD,OAAO;AAAA,IACP,MACE,WAAW,cAAc,WAAW,WAChC,mBAAmB,aACnB,mBAAmB;AAAA,IACzB,QAAQ,eAAe,OAAO;AAAA,EAChC,EAAE;AACJ;AAEA,SAAS,6BACP,QACA,eACkB;AAClB,QAAM,mBAAmB,OAAO,YAAY;AAC5C,SAAO,cACJ,IAAI,gBAAgB,EACpB,OAAO,CAAC,SAAS,KAAK,MAAM,MAAM,CAAC,EAAE,YAAY,EAAE,WAAW,gBAAgB,CAAC;AACpF;AAGO,SAAS,2BACd,cACA,QACA,YACA,iBACkB;AAClB,MAAI,oBAAoB,QAAQ,oBAAoB,QAAW;AAC7D,QAAI,gBAAgB,SAAS,UAAU;AACrC,aAAO;AAAA,QACL,gBAAgB,SAAS;AAAA,QACzB,gBAAgB,SAAS;AAAA,MAC3B;AAAA,IACF;AAEA,QAAI,gBAAgB,SAAS,YAAY;AACvC,aAAO,CAAC;AAAA,IACV;AAEA,WAAO,6BAA6B,gBAAgB,QAAQ,gBAAgB,aAAa;AAAA,EAC3F;AAEA,QAAM,kBAAkB;AAAA,IACtB;AAAA,IACA;AAAA,IACA,aAAa,EAAE,WAAW,IAAI;AAAA,EAChC;AAEA,MAAI,gBAAgB,SAAS,UAAU;AACrC,WAAO;AAAA,MACL,gBAAgB,SAAS,IAAI;AAAA,MAC7B,gBAAgB,SAAS;AAAA,IAC3B;AAAA,EACF;AAEA,MAAI,gBAAgB,SAAS,YAAY;AACvC,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,6BAA6B,gBAAgB,QAAQ,gBAAgB,aAAa;AAC3F;;;AC/FA;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASA,SAAS,eACd,SACA,YACc;AACd,QAAM,MAAM,QAAQ,WAAW,GAAG,IAAI,QAAQ,MAAM,CAAC,IAAI;AACzD,QAAM,aAAa,iBAAiB,yBAAyB,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,iBACA,4BAA4B,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;;;AChBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;;;ACVP,OAAO,QAAQ;AACf,OAAO,SAAS;AAChB,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AACP,SAAS,+BAA+B;AAExC,IAAM,kCAAkC;AAExC,SAAS,gBAAgB,eAA+B;AACtD,SAAO,wBAAwB,aAAa;AAC9C;AAEA,SAAS,uBAAuB,MAAsB;AACpD,QAAM,WAAW,KAAK,QAAQ,IAAI;AAClC,QAAM,SAAS,KAAK,MAAM,QAAQ;AAClC,MAAI,aAAa;AAEjB,SAAO,WAAW,SAAS,OAAO,KAAK,UAAU,WAAW,SAAS,KAAK,GAAG,GAAG;AAC9E,iBAAa,WAAW,MAAM,GAAG,CAAC,KAAK,IAAI,MAAM;AAAA,EACnD;AAEA,SAAO;AACT;AAEA,SAAS,yBACP,gBACA,UACe;AACf,QAAM,qBAAqB,KAAK,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,KAAK,GAAG,EAAE;AAAA,EAC/D,KAAK;AAET;AAEA,eAAe,aAAa,eAAiE;AAC3F,MAAI;AACF,UAAM,eAAe,MAAM,GAAG,SAAS,gBAAgB,aAAa,GAAG,MAAM;AAC7E,UAAM,WAAW,KAAK,MAAM,YAAY;AACxC,QAAI,CAAC,2BAA2B,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,IAAI,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,eAAO,2BAA2B,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,WAAO,cAAc,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,eAAe,wBAAwB,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,eAAe,wBAAwB,YAAY,IAAI,SAAS,QAAQ;AAC1F;AASA,eAAsB,gCACpB,gBACA,UACA,cACA,YAAY,iCAC2C;AACvD,QAAM,WAAW,MAAM;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,MACE,iBAAiB;AAAA,MACjB,MAAM;AAAA,MACN;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACA,MAAI,UAAU,SAAS,eAAe;AACpC,WAAO;AAAA,EACT;AAEA,SAAO,SAAS,eAAe,wBAAwB,YAAY,IAC/D,SAAS,cACT;AACN;;;ADlMO,SAAS,iBACd,UACA,aACA,UAAmC,CAAC,GACtB;AACd,QAAM,SAAS,QAAQ,UAAU;AACjC,SAAO,YAAY,IAAI,CAAC,eAAe;AACrC,UAAM,qBAAqB,qBAAqB,UAAU,WAAW,gBAAgB;AACrF,WAAO;AAAA,MACL,OAAO,YAAY,UAAU,WAAW,MAAM,OAAO,WAAW,MAAM,GAAG;AAAA,MACzE,UAAU,cAAc,WAAW,QAAQ;AAAA,MAC3C;AAAA,MACA,MAAM,WAAW;AAAA,MACjB,SAAS,WAAW;AAAA,MACpB,GAAI,uBAAuB,SAAY,CAAC,IAAI,EAAE,mBAAmB;AAAA,MACjE,MAAM;AAAA,QACJ,GAAG,WAAW;AAAA,QACd,UAAU,WAAW;AAAA,MACvB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,SAAS,YAAY,UAAwB,OAAe,KAAoB;AAC9E,SAAO,MAAM,OAAO,SAAS,WAAW,KAAK,GAAG,SAAS,WAAW,GAAG,CAAC;AAC1E;AAEA,SAAS,cAAc,UAAsE;AAC3F,UAAQ,UAAU;AAAA,IAChB,KAAK;AACH,aAAO,mBAAmB;AAAA,IAC5B,KAAK;AACH,aAAO,mBAAmB;AAAA,IAC5B,KAAK;AACH,aAAO,mBAAmB;AAAA,IAC5B;AACE,aAAO,mBAAmB;AAAA,EAC9B;AACF;AAEA,SAAS,qBACP,UACA,WAC4C;AAC5C,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO;AAAA,EACT;AAEA,QAAM,0BAA0B,oBAAoB,QAAQ;AAC5D,QAAM,qBAAqB,UACxB,OAAO,CAAC,aAAa,SAAS,aAAa,uBAAuB,EAClE;AAAA,IAAI,CAAC,aACJ,6BAA6B;AAAA,MAC3B,SAAS;AAAA,QACP,SAAS;AAAA,QACT,YAAY,UAAU,SAAS,MAAM,OAAO,SAAS,MAAM,GAAG;AAAA,MAChE;AAAA,MACA,SAAS,WAAW;AAAA,IACtB;AAAA,EACF;AAEF,SAAO,mBAAmB,WAAW,IAAI,SAAY;AACvD;AAEA,SAAS,oBAAoB,UAAuC;AAClE,SAAO,oBAAoB,SAAS,GAAG;AACzC;;;AJlEA,IAAM,+BAA+B;AAErC,SAAS,qBAAqB,gBAA6C;AACzE,SAAO,CAAC,GAAG,IAAI,IAAI,cAAc,CAAC;AACpC;AAEA,SAAS,4BAA4B,mBAA2D;AAC9F,MAAI,sBAAsB,QAAW;AACnC,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,QAAQ,IAAI,4BAA4B;AACzD,MAAI,aAAa,QAAW;AAC1B,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,OAAO,SAAS,UAAU,EAAE;AAC3C,SAAO,OAAO,SAAS,MAAM,KAAK,SAAS,IAAI,SAAS;AAC1D;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;AA+BO,SAAS,aAAa,UAA+B,CAAC,GAAe;AAC1E,QAAM,aAAa,iBAAiB,iBAAiB,GAAG;AACxD,QAAM,YAAY,IAAI,cAAc,YAAY;AAChD,MAAI,iBAAiB,CAAC,GAAI,QAAQ,kBAAkB,CAAC,CAAE;AACvD,QAAM,uBAAuB,4BAA4B,QAAQ,oBAAoB;AACrF,QAAM,kBAAkB,QAAQ,mBAAmB;AACnD,QAAM,mBAAmB,QAAQ,oBAAoB;AAErD,YAAU,OAAO,UAAU;AAE3B,iBAAe,8BAA8B,UAAuC;AAClF,QAAI,oBAAoB,YAAY,QAAQ,uBAAuB,OAAO;AACxE;AAAA,IACF;AAEA,UAAM,WAAW,oBAAoB,SAAS,GAAG;AACjD,QAAI,aAAa,MAAM;AACrB;AAAA,IACF;AAEA,UAAM,cACH,MAAM;AAAA,MACL;AAAA,MACA;AAAA,MACA,SAAS,QAAQ;AAAA,MACjB;AAAA,IACF,KAAM,CAAC;AAET,SAAK,WAAW,gBAAgB;AAAA,MAC9B,KAAK,SAAS;AAAA,MACd,aAAa,iBAAiB,UAAU,aAAa;AAAA,QACnD,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAEA,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,qBAAqB;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;AAAA,IACF;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;AAAA,IACF;AAEN,WAAO,iBAAiB,cAAc,QAAQ,QAAQ,YAAY,aAAa;AAAA,EACjF,CAAC;AAED,aAAW,aAAa,CAAC,YAAY;AAEnC,WAAO,cAAc;AAAA,EACvB,CAAC;AAED,YAAU,UAAU,CAAC,EAAE,SAAS,MAAM;AACpC,SAAK,8BAA8B,QAAQ,EAAE,MAAM,CAAC,UAAmB;AACrE,iBAAW,QAAQ,MAAM,6CAA6C,OAAO,KAAK,CAAC,EAAE;AAAA,IACvF,CAAC;AAAA,EACH,CAAC;AAED,YAAU,mBAAmB,CAAC,EAAE,SAAS,MAAM;AAC7C,SAAK,8BAA8B,QAAQ,EAAE,MAAM,CAAC,UAAmB;AACrE,iBAAW,QAAQ,MAAM,6CAA6C,OAAO,KAAK,CAAC,EAAE;AAAA,IACvF,CAAC;AAAA,EACH,CAAC;AAED,YAAU,WAAW,CAAC,EAAE,SAAS,MAAM;AACrC,QAAI,oBAAoB,UAAU;AAChC,WAAK,WAAW,gBAAgB;AAAA,QAC9B,KAAK,SAAS;AAAA,QACd,aAAa,CAAC;AAAA,MAChB,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,SAAO;AACT;","names":[]}

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

@@ -0,0 +1,166 @@
+/**
+ * \@formspec/language-server
+ *
+ * Language server for FormSpec — provides completions, hover documentation,
+ * and go-to-definition for FormSpec JSDoc constraint tags (`@Minimum`,
+ * `@Maximum`, `@Pattern`, etc.) in TypeScript files.
+ *
+ * This package implements the Language Server Protocol (LSP) using the
+ * `vscode-languageserver` library. Cheap syntax-local behaviors stay in the
+ * LSP process, while TypeScript-project-aware semantics are supplied by
+ * `@formspec/ts-plugin` over a local manifest + IPC transport.
+ *
+ * The packaged server acts as a reference implementation over the composable
+ * completion, hover, and diagnostics helpers exported from this package.
+ *
+ * @example
+ * ```ts
+ * import { createServer } from '@formspec/language-server';
+ *
+ * const connection = createServer();
+ * connection.listen();
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+import { CompletionItem } from 'vscode-languageserver/node.js';
+import { Connection } from 'vscode-languageserver/node.js';
+import { Diagnostic } from 'vscode-languageserver/node.js';
+import type { ExtensionDefinition } from '@formspec/core';
+import type { Hover } from 'vscode-languageserver/node.js';
+import type { Location } from 'vscode-languageserver/node.js';
+import type { TextDocument } from 'vscode-languageserver-textdocument';
+
+/** @public */
+export declare interface CommentSpan {
+    readonly start: number;
+    readonly end: number;
+}
+
+/**
+ * Creates and configures the FormSpec language server connection.
+ *
+ * Registers LSP capability handlers and returns the connection.
+ * Call `connection.listen()` to start accepting messages.
+ *
+ * @returns The configured LSP connection (not yet listening)
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the FormSpec language server.
+ *
+ * @public
+ */
+export declare interface CreateServerOptions {
+    /** Optional extension definitions whose custom tags should be surfaced by tooling. */
+    readonly extensions?: readonly ExtensionDefinition[];
+    /** Optional workspace roots to use before initialize() provides them. */
+    readonly workspaceRoots?: readonly string[];
+    /** Set to false to disable tsserver-plugin semantic enrichment. */
+    readonly usePluginTransport?: boolean;
+    /** IPC timeout, in milliseconds, for semantic plugin requests. */
+    readonly pluginQueryTimeoutMs?: number;
+    /** Optional diagnostics publishing mode for the packaged reference LSP. */
+    readonly diagnosticsMode?: "off" | "plugin";
+    /** Source label to use when publishing plugin-derived diagnostics. */
+    readonly diagnosticSource?: string;
+}
+
+/**
+ * File-local diagnostic derived from comment parsing or semantic analysis.
+ *
+ * @public
+ */
+export declare interface FormSpecAnalysisDiagnostic {
+    readonly code: string;
+    readonly category: FormSpecAnalysisDiagnosticCategory;
+    readonly message: string;
+    readonly range: CommentSpan;
+    readonly severity: "error" | "warning" | "info";
+    readonly relatedLocations: readonly FormSpecAnalysisDiagnosticLocation[];
+    readonly data: Record<string, FormSpecAnalysisDiagnosticDataValue>;
+}
+
+/**
+ * Machine-readable diagnostic category used by FormSpec tooling surfaces.
+ *
+ * @public
+ */
+export declare type FormSpecAnalysisDiagnosticCategory = "tag-recognition" | "value-parsing" | "type-compatibility" | "target-resolution" | "constraint-validation" | "infrastructure";
+
+/**
+ * Primitive structured values carried in diagnostic facts for white-label
+ * downstream rendering.
+ *
+ * @public
+ */
+export declare type FormSpecAnalysisDiagnosticDataValue = string | number | boolean | readonly string[] | readonly number[] | readonly boolean[];
+
+/**
+ * Additional source location associated with a diagnostic.
+ *
+ * @public
+ */
+export declare interface FormSpecAnalysisDiagnosticLocation {
+    readonly filePath: string;
+    readonly range: CommentSpan;
+    readonly message?: string;
+}
+
+/**
+ * Returns the full set of tag-name completions currently known to FormSpec.
+ *
+ * @public
+ */
+export declare function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[];
+
+/**
+ * Returns the definition location for a symbol at the given position.
+ *
+ * Always returns `null` in this stub implementation.
+ *
+ * @returns `null` — not yet implemented
+ * @public
+ */
+export declare function getDefinition(): Location | null;
+
+/**
+ * Returns hover content for a single FormSpec tag name.
+ *
+ * @public
+ */
+export declare function getHoverForTag(tagName: string, extensions?: readonly ExtensionDefinition[]): Hover | null;
+
+/**
+ * Retrieves canonical FormSpec diagnostics for the current document revision
+ * from the plugin transport. Returns `null` when the transport is missing,
+ * stale, or invalid.
+ *
+ * @public
+ */
+export declare function getPluginDiagnosticsForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, timeoutMs?: number): Promise<readonly FormSpecAnalysisDiagnostic[] | null>;
+
+/**
+ * Converts canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * Downstream consumers that want complete white-label control can ignore this
+ * helper and render their own messages from `code` + `data`.
+ *
+ * @public
+ */
+export declare function toLspDiagnostics(document: TextDocument, diagnostics: readonly FormSpecAnalysisDiagnostic[], options?: ToLspDiagnosticsOptions): Diagnostic[];
+
+/**
+ * Options for converting canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * @public
+ */
+export declare interface ToLspDiagnosticsOptions {
+    /** Source label shown by LSP clients. Defaults to `formspec`. */
+    readonly source?: string;
+}
+
+export { }

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

@@ -0,0 +1,166 @@
+/**
+ * \@formspec/language-server
+ *
+ * Language server for FormSpec — provides completions, hover documentation,
+ * and go-to-definition for FormSpec JSDoc constraint tags (`@Minimum`,
+ * `@Maximum`, `@Pattern`, etc.) in TypeScript files.
+ *
+ * This package implements the Language Server Protocol (LSP) using the
+ * `vscode-languageserver` library. Cheap syntax-local behaviors stay in the
+ * LSP process, while TypeScript-project-aware semantics are supplied by
+ * `@formspec/ts-plugin` over a local manifest + IPC transport.
+ *
+ * The packaged server acts as a reference implementation over the composable
+ * completion, hover, and diagnostics helpers exported from this package.
+ *
+ * @example
+ * ```ts
+ * import { createServer } from '@formspec/language-server';
+ *
+ * const connection = createServer();
+ * connection.listen();
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+import { CompletionItem } from 'vscode-languageserver/node.js';
+import { Connection } from 'vscode-languageserver/node.js';
+import { Diagnostic } from 'vscode-languageserver/node.js';
+import type { ExtensionDefinition } from '@formspec/core';
+import type { Hover } from 'vscode-languageserver/node.js';
+import type { Location } from 'vscode-languageserver/node.js';
+import type { TextDocument } from 'vscode-languageserver-textdocument';
+
+/** @public */
+export declare interface CommentSpan {
+    readonly start: number;
+    readonly end: number;
+}
+
+/**
+ * Creates and configures the FormSpec language server connection.
+ *
+ * Registers LSP capability handlers and returns the connection.
+ * Call `connection.listen()` to start accepting messages.
+ *
+ * @returns The configured LSP connection (not yet listening)
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the FormSpec language server.
+ *
+ * @public
+ */
+export declare interface CreateServerOptions {
+    /** Optional extension definitions whose custom tags should be surfaced by tooling. */
+    readonly extensions?: readonly ExtensionDefinition[];
+    /** Optional workspace roots to use before initialize() provides them. */
+    readonly workspaceRoots?: readonly string[];
+    /** Set to false to disable tsserver-plugin semantic enrichment. */
+    readonly usePluginTransport?: boolean;
+    /** IPC timeout, in milliseconds, for semantic plugin requests. */
+    readonly pluginQueryTimeoutMs?: number;
+    /** Optional diagnostics publishing mode for the packaged reference LSP. */
+    readonly diagnosticsMode?: "off" | "plugin";
+    /** Source label to use when publishing plugin-derived diagnostics. */
+    readonly diagnosticSource?: string;
+}
+
+/**
+ * File-local diagnostic derived from comment parsing or semantic analysis.
+ *
+ * @public
+ */
+export declare interface FormSpecAnalysisDiagnostic {
+    readonly code: string;
+    readonly category: FormSpecAnalysisDiagnosticCategory;
+    readonly message: string;
+    readonly range: CommentSpan;
+    readonly severity: "error" | "warning" | "info";
+    readonly relatedLocations: readonly FormSpecAnalysisDiagnosticLocation[];
+    readonly data: Record<string, FormSpecAnalysisDiagnosticDataValue>;
+}
+
+/**
+ * Machine-readable diagnostic category used by FormSpec tooling surfaces.
+ *
+ * @public
+ */
+export declare type FormSpecAnalysisDiagnosticCategory = "tag-recognition" | "value-parsing" | "type-compatibility" | "target-resolution" | "constraint-validation" | "infrastructure";
+
+/**
+ * Primitive structured values carried in diagnostic facts for white-label
+ * downstream rendering.
+ *
+ * @public
+ */
+export declare type FormSpecAnalysisDiagnosticDataValue = string | number | boolean | readonly string[] | readonly number[] | readonly boolean[];
+
+/**
+ * Additional source location associated with a diagnostic.
+ *
+ * @public
+ */
+export declare interface FormSpecAnalysisDiagnosticLocation {
+    readonly filePath: string;
+    readonly range: CommentSpan;
+    readonly message?: string;
+}
+
+/**
+ * Returns the full set of tag-name completions currently known to FormSpec.
+ *
+ * @public
+ */
+export declare function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[];
+
+/**
+ * Returns the definition location for a symbol at the given position.
+ *
+ * Always returns `null` in this stub implementation.
+ *
+ * @returns `null` — not yet implemented
+ * @public
+ */
+export declare function getDefinition(): Location | null;
+
+/**
+ * Returns hover content for a single FormSpec tag name.
+ *
+ * @public
+ */
+export declare function getHoverForTag(tagName: string, extensions?: readonly ExtensionDefinition[]): Hover | null;
+
+/**
+ * Retrieves canonical FormSpec diagnostics for the current document revision
+ * from the plugin transport. Returns `null` when the transport is missing,
+ * stale, or invalid.
+ *
+ * @public
+ */
+export declare function getPluginDiagnosticsForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, timeoutMs?: number): Promise<readonly FormSpecAnalysisDiagnostic[] | null>;
+
+/**
+ * Converts canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * Downstream consumers that want complete white-label control can ignore this
+ * helper and render their own messages from `code` + `data`.
+ *
+ * @public
+ */
+export declare function toLspDiagnostics(document: TextDocument, diagnostics: readonly FormSpecAnalysisDiagnostic[], options?: ToLspDiagnosticsOptions): Diagnostic[];
+
+/**
+ * Options for converting canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * @public
+ */
+export declare interface ToLspDiagnosticsOptions {
+    /** Source label shown by LSP clients. Defaults to `formspec`. */
+    readonly source?: string;
+}
+
+export { }

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

@@ -0,0 +1,166 @@
+/**
+ * \@formspec/language-server
+ *
+ * Language server for FormSpec — provides completions, hover documentation,
+ * and go-to-definition for FormSpec JSDoc constraint tags (`@Minimum`,
+ * `@Maximum`, `@Pattern`, etc.) in TypeScript files.
+ *
+ * This package implements the Language Server Protocol (LSP) using the
+ * `vscode-languageserver` library. Cheap syntax-local behaviors stay in the
+ * LSP process, while TypeScript-project-aware semantics are supplied by
+ * `@formspec/ts-plugin` over a local manifest + IPC transport.
+ *
+ * The packaged server acts as a reference implementation over the composable
+ * completion, hover, and diagnostics helpers exported from this package.
+ *
+ * @example
+ * ```ts
+ * import { createServer } from '@formspec/language-server';
+ *
+ * const connection = createServer();
+ * connection.listen();
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+import { CompletionItem } from 'vscode-languageserver/node.js';
+import { Connection } from 'vscode-languageserver/node.js';
+import { Diagnostic } from 'vscode-languageserver/node.js';
+import type { ExtensionDefinition } from '@formspec/core';
+import type { Hover } from 'vscode-languageserver/node.js';
+import type { Location } from 'vscode-languageserver/node.js';
+import type { TextDocument } from 'vscode-languageserver-textdocument';
+
+/** @public */
+export declare interface CommentSpan {
+    readonly start: number;
+    readonly end: number;
+}
+
+/**
+ * Creates and configures the FormSpec language server connection.
+ *
+ * Registers LSP capability handlers and returns the connection.
+ * Call `connection.listen()` to start accepting messages.
+ *
+ * @returns The configured LSP connection (not yet listening)
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the FormSpec language server.
+ *
+ * @public
+ */
+export declare interface CreateServerOptions {
+    /** Optional extension definitions whose custom tags should be surfaced by tooling. */
+    readonly extensions?: readonly ExtensionDefinition[];
+    /** Optional workspace roots to use before initialize() provides them. */
+    readonly workspaceRoots?: readonly string[];
+    /** Set to false to disable tsserver-plugin semantic enrichment. */
+    readonly usePluginTransport?: boolean;
+    /** IPC timeout, in milliseconds, for semantic plugin requests. */
+    readonly pluginQueryTimeoutMs?: number;
+    /** Optional diagnostics publishing mode for the packaged reference LSP. */
+    readonly diagnosticsMode?: "off" | "plugin";
+    /** Source label to use when publishing plugin-derived diagnostics. */
+    readonly diagnosticSource?: string;
+}
+
+/**
+ * File-local diagnostic derived from comment parsing or semantic analysis.
+ *
+ * @public
+ */
+export declare interface FormSpecAnalysisDiagnostic {
+    readonly code: string;
+    readonly category: FormSpecAnalysisDiagnosticCategory;
+    readonly message: string;
+    readonly range: CommentSpan;
+    readonly severity: "error" | "warning" | "info";
+    readonly relatedLocations: readonly FormSpecAnalysisDiagnosticLocation[];
+    readonly data: Record<string, FormSpecAnalysisDiagnosticDataValue>;
+}
+
+/**
+ * Machine-readable diagnostic category used by FormSpec tooling surfaces.
+ *
+ * @public
+ */
+export declare type FormSpecAnalysisDiagnosticCategory = "tag-recognition" | "value-parsing" | "type-compatibility" | "target-resolution" | "constraint-validation" | "infrastructure";
+
+/**
+ * Primitive structured values carried in diagnostic facts for white-label
+ * downstream rendering.
+ *
+ * @public
+ */
+export declare type FormSpecAnalysisDiagnosticDataValue = string | number | boolean | readonly string[] | readonly number[] | readonly boolean[];
+
+/**
+ * Additional source location associated with a diagnostic.
+ *
+ * @public
+ */
+export declare interface FormSpecAnalysisDiagnosticLocation {
+    readonly filePath: string;
+    readonly range: CommentSpan;
+    readonly message?: string;
+}
+
+/**
+ * Returns the full set of tag-name completions currently known to FormSpec.
+ *
+ * @public
+ */
+export declare function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[];
+
+/**
+ * Returns the definition location for a symbol at the given position.
+ *
+ * Always returns `null` in this stub implementation.
+ *
+ * @returns `null` — not yet implemented
+ * @public
+ */
+export declare function getDefinition(): Location | null;
+
+/**
+ * Returns hover content for a single FormSpec tag name.
+ *
+ * @public
+ */
+export declare function getHoverForTag(tagName: string, extensions?: readonly ExtensionDefinition[]): Hover | null;
+
+/**
+ * Retrieves canonical FormSpec diagnostics for the current document revision
+ * from the plugin transport. Returns `null` when the transport is missing,
+ * stale, or invalid.
+ *
+ * @public
+ */
+export declare function getPluginDiagnosticsForDocument(workspaceRoots: readonly string[], filePath: string, documentText: string, timeoutMs?: number): Promise<readonly FormSpecAnalysisDiagnostic[] | null>;
+
+/**
+ * Converts canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * Downstream consumers that want complete white-label control can ignore this
+ * helper and render their own messages from `code` + `data`.
+ *
+ * @public
+ */
+export declare function toLspDiagnostics(document: TextDocument, diagnostics: readonly FormSpecAnalysisDiagnostic[], options?: ToLspDiagnosticsOptions): Diagnostic[];
+
+/**
+ * Options for converting canonical FormSpec diagnostics into LSP diagnostics.
+ *
+ * @public
+ */
+export declare interface ToLspDiagnosticsOptions {
+    /** Source label shown by LSP clients. Defaults to `formspec`. */
+    readonly source?: string;
+}
+
+export { }