@formspec/language-server 0.1.0-alpha.14 → 0.1.0-alpha.17

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

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

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

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

package/dist/index.cjs

@@ -31,6 +31,7 @@ module.exports = __toCommonJS(index_exports);
 var import_node2 = require("vscode-languageserver/node.js");
 
 // src/providers/completion.ts
+var import_core = require("@formspec/core");
 var import_node = require("vscode-languageserver/node.js");
 var CONSTRAINT_DETAIL = {
   minimum: "Minimum numeric value (inclusive). Example: `@minimum 0`",
@@ -42,19 +43,31 @@ var CONSTRAINT_DETAIL = {
   maxLength: "Maximum string length. Example: `@maxLength 255`",
   minItems: "Minimum number of array items. Example: `@minItems 1`",
   maxItems: "Maximum number of array items. Example: `@maxItems 10`",
+  uniqueItems: "Require all array items to be distinct. Example: `@uniqueItems`",
   pattern: "Regular expression pattern for string validation. Example: `@pattern ^[a-z]+$`",
-  enumOptions: 'Inline JSON array of allowed enum values. Example: `@enumOptions ["a","b","c"]`'
+  enumOptions: 'Inline JSON array of allowed enum values. Example: `@enumOptions ["a","b","c"]`',
+  const: 'Require a constant JSON value. Example: `@const "USD"`'
 };
-function getCompletionItems() {
-  return Object.entries(CONSTRAINT_DETAIL).map(([name, detail]) => ({
-    label: `@${name}`,
-    kind: import_node.CompletionItemKind.Keyword,
-    detail
-  }));
+function getCompletionItems(extensions) {
+  const builtins = Object.keys(import_core.BUILTIN_CONSTRAINT_DEFINITIONS).map(
+    (name) => ({
+      label: `@${name}`,
+      kind: import_node.CompletionItemKind.Keyword,
+      detail: CONSTRAINT_DETAIL[name]
+    })
+  );
+  const customItems = extensions?.flatMap(
+    (extension) => (extension.constraintTags ?? []).map((tag) => ({
+      label: `@${tag.tagName}`,
+      kind: import_node.CompletionItemKind.Keyword,
+      detail: `Extension constraint tag from ${extension.extensionId}`
+    }))
+  ) ?? [];
+  return [...builtins, ...customItems];
 }
 
 // src/providers/hover.ts
-var import_core = require("@formspec/core");
+var import_core2 = require("@formspec/core");
 var CONSTRAINT_HOVER_DOCS = {
   minimum: [
     "**@minimum** `<number>`",
@@ -173,6 +186,19 @@ var CONSTRAINT_HOVER_DOCS = {
     "tags: string[];",
     "```"
   ].join("\n"),
+  uniqueItems: [
+    "**@uniqueItems**",
+    "",
+    "Requires all items in an array field to be distinct.",
+    "",
+    "Maps to `uniqueItems` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @uniqueItems */",
+    "tags: string[];",
+    "```"
+  ].join("\n"),
   pattern: [
     "**@pattern** `<regex>`",
     "",
@@ -198,13 +224,46 @@ var CONSTRAINT_HOVER_DOCS = {
     '/** @enumOptions ["draft","sent","archived"] */',
     "status: string;",
     "```"
+  ].join("\n"),
+  const: [
+    "**@const** `<json-literal>`",
+    "",
+    "Requires the field value to equal a single constant JSON value.",
+    "",
+    "Maps to `const` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    '/** @const "USD" */',
+    "currency: string;",
+    "```"
   ].join("\n")
 };
-function getHoverForTag(tagName) {
+function getHoverForTag(tagName, extensions) {
   const raw = tagName.startsWith("@") ? tagName.slice(1) : tagName;
-  const name = (0, import_core.normalizeConstraintTagName)(raw);
-  if (!(0, import_core.isBuiltinConstraintName)(name)) {
-    return null;
+  const name = (0, import_core2.normalizeConstraintTagName)(raw);
+  if (!(0, import_core2.isBuiltinConstraintName)(name)) {
+    const registration = extensions?.flatMap(
+      (extension) => (extension.constraintTags ?? []).map((tag) => ({
+        extensionId: extension.extensionId,
+        tag
+      }))
+    ).find(({ tag }) => tag.tagName === name);
+    if (registration === void 0) {
+      return null;
+    }
+    return {
+      contents: {
+        kind: "markdown",
+        value: [
+          `**@${registration.tag.tagName}** \`<value>\``,
+          "",
+          `Extension-defined constraint tag from \`${registration.extensionId}\`.`,
+          "",
+          "Validated through the registered FormSpec extension surface."
+        ].join("\n")
+      }
+    };
   }
   return {
     contents: {
@@ -220,7 +279,7 @@ function getDefinition() {
 }
 
 // src/server.ts
-function createServer() {
+function createServer(options = {}) {
   const connection = (0, import_node2.createConnection)(import_node2.ProposedFeatures.all);
   connection.onInitialize(() => {
     return {
@@ -240,10 +299,10 @@ function createServer() {
     };
   });
   connection.onCompletion(() => {
-    return getCompletionItems();
+    return getCompletionItems(options.extensions);
   });
   connection.onHover((_params) => {
-    return getHoverForTag("");
+    return getHoverForTag("", options.extensions);
   });
   connection.onDefinition((_params) => {
     return getDefinition();

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"],"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. Constraint names are sourced from\n * `BUILTIN_CONSTRAINT_DEFINITIONS` in `@formspec/core`, ensuring the\n * language server stays in sync with the single source of truth.\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 { 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  TextDocumentSyncKind,\n  type Connection,\n  type InitializeResult,\n} from \"vscode-languageserver/node.js\";\nimport { getCompletionItems } from \"./providers/completion.js\";\nimport { getHoverForTag } from \"./providers/hover.js\";\nimport { getDefinition } from \"./providers/definition.js\";\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 */\nexport function createServer(): Connection {\n  const connection = createConnection(ProposedFeatures.all);\n\n  connection.onInitialize((): InitializeResult => {\n    return {\n      capabilities: {\n        textDocumentSync: TextDocumentSyncKind.Incremental,\n        completionProvider: {\n          // Trigger completions inside JSDoc comments when `@` is typed\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(() => {\n    // Return all FormSpec constraint tag completions.\n    // Future phases will add context-aware filtering based on field type and\n    // cursor position within JSDoc comment ranges.\n    return getCompletionItems();\n  });\n\n  connection.onHover((_params) => {\n    // Extract the word under the cursor and look up hover documentation.\n    // This is a stub — precise JSDoc token detection (checking that the\n    // cursor is within a JSDoc comment and extracting the tag name) will be\n    // added in a future phase.\n    //\n    // For now we return null to signal no hover is available until the\n    // token extraction is implemented.\n    return getHoverForTag(\"\");\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 * Returns completion items for all recognized FormSpec JSDoc constraint tags\n * (e.g., `@minimum`, `@maximum`, `@pattern`), derived from\n * `BUILTIN_CONSTRAINT_DEFINITIONS`. This is a skeleton — context-aware\n * filtering will be added in a future phase.\n */\n\nimport { CompletionItem, CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Human-readable detail strings for each built-in constraint tag.\n *\n * Keys match the camelCase constraint names (matching keys in `BUILTIN_CONSTRAINT_DEFINITIONS`).\n * Values are shown as the detail string in completion items.\n */\nconst CONSTRAINT_DETAIL: Record<string, string> = {\n  minimum: \"Minimum numeric value (inclusive). Example: `@minimum 0`\",\n  maximum: \"Maximum numeric value (inclusive). Example: `@maximum 100`\",\n  exclusiveMinimum: \"Minimum numeric value (exclusive). Example: `@exclusiveMinimum 0`\",\n  exclusiveMaximum: \"Maximum numeric value (exclusive). Example: `@exclusiveMaximum 100`\",\n  multipleOf: \"Value must be a multiple of this number. Example: `@multipleOf 0.01`\",\n  minLength: \"Minimum string length. Example: `@minLength 1`\",\n  maxLength: \"Maximum string length. Example: `@maxLength 255`\",\n  minItems: \"Minimum number of array items. Example: `@minItems 1`\",\n  maxItems: \"Maximum number of array items. Example: `@maxItems 10`\",\n  pattern: \"Regular expression pattern for string validation. Example: `@pattern ^[a-z]+$`\",\n  enumOptions: 'Inline JSON array of allowed enum values. Example: `@enumOptions [\"a\",\"b\",\"c\"]`',\n};\n\n/**\n * Returns completion items for all FormSpec JSDoc constraint tags.\n *\n * Items are derived from `BUILTIN_CONSTRAINT_DEFINITIONS`, ensuring this list\n * stays in sync with the single source of truth in `@formspec/core`.\n *\n * Each item uses `CompletionItemKind.Keyword` since these are annotation\n * tags used within JSDoc comments rather than language symbols.\n *\n * @returns An array of LSP completion items for FormSpec constraint tags\n */\nexport function getCompletionItems(): CompletionItem[] {\n  return Object.entries(CONSTRAINT_DETAIL).map(([name, detail]) => ({\n    label: `@${name}`,\n    kind: CompletionItemKind.Keyword,\n    detail,\n  }));\n}\n","/**\n * Hover provider for FormSpec JSDoc constraint tags.\n *\n * Returns Markdown documentation for a recognized FormSpec JSDoc tag when\n * the cursor is positioned over it. This is a skeleton — precise token\n * detection within JSDoc comment ranges will be added in a future phase.\n */\n\nimport {\n  normalizeConstraintTagName,\n  isBuiltinConstraintName,\n  type BuiltinConstraintName,\n} from \"@formspec/core\";\nimport type { Hover } from \"vscode-languageserver/node.js\";\n\n/**\n * Markdown documentation for each built-in FormSpec constraint tag.\n *\n * Keys are the canonical constraint names from `BUILTIN_CONSTRAINT_DEFINITIONS`.\n * Values are Markdown strings suitable for LSP hover responses.\n */\nconst CONSTRAINT_HOVER_DOCS: Record<BuiltinConstraintName, string> = {\n  minimum: [\n    \"**@minimum** `<number>`\",\n    \"\",\n    \"Sets an inclusive lower bound on a numeric field.\",\n    \"\",\n    \"Maps to `minimum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minimum 0 */\",\n    \"amount: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maximum: [\n    \"**@maximum** `<number>`\",\n    \"\",\n    \"Sets an inclusive upper bound on a numeric field.\",\n    \"\",\n    \"Maps to `maximum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maximum 100 */\",\n    \"percentage: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  exclusiveMinimum: [\n    \"**@exclusiveMinimum** `<number>`\",\n    \"\",\n    \"Sets an exclusive lower bound on a numeric field.\",\n    \"\",\n    \"Maps to `exclusiveMinimum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @exclusiveMinimum 0 */\",\n    \"positiveAmount: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  exclusiveMaximum: [\n    \"**@exclusiveMaximum** `<number>`\",\n    \"\",\n    \"Sets an exclusive upper bound on a numeric field.\",\n    \"\",\n    \"Maps to `exclusiveMaximum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @exclusiveMaximum 1 */\",\n    \"ratio: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  multipleOf: [\n    \"**@multipleOf** `<number>`\",\n    \"\",\n    \"Requires the numeric value to be a multiple of the given number.\",\n    \"\",\n    \"Maps to `multipleOf` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @multipleOf 0.01 */\",\n    \"price: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  minLength: [\n    \"**@minLength** `<number>`\",\n    \"\",\n    \"Sets a minimum character length on a string field.\",\n    \"\",\n    \"Maps to `minLength` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minLength 1 */\",\n    \"name: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maxLength: [\n    \"**@maxLength** `<number>`\",\n    \"\",\n    \"Sets a maximum character length on a string field.\",\n    \"\",\n    \"Maps to `maxLength` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maxLength 255 */\",\n    \"description: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  minItems: [\n    \"**@minItems** `<number>`\",\n    \"\",\n    \"Sets a minimum number of items in an array field.\",\n    \"\",\n    \"Maps to `minItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minItems 1 */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maxItems: [\n    \"**@maxItems** `<number>`\",\n    \"\",\n    \"Sets a maximum number of items in an array field.\",\n    \"\",\n    \"Maps to `maxItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maxItems 10 */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  pattern: [\n    \"**@pattern** `<regex>`\",\n    \"\",\n    \"Sets a regular expression pattern that a string field must match.\",\n    \"\",\n    \"Maps to `pattern` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @pattern ^[a-z0-9]+$ */\",\n    \"slug: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  enumOptions: [\n    \"**@enumOptions** `<json-array>`\",\n    \"\",\n    \"Specifies the allowed values for an enum field as an inline JSON array.\",\n    \"\",\n    \"Maps to `enum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    '/** @enumOptions [\"draft\",\"sent\",\"archived\"] */',\n    \"status: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n} satisfies Record<BuiltinConstraintName, string>;\n\n/**\n * Returns hover documentation for a FormSpec JSDoc tag name.\n *\n * Accepts both camelCase (`\"minimum\"`) and PascalCase (`\"Minimum\"`) forms.\n * The `@` prefix is stripped before lookup if present.\n * Returns `null` when the tag is not a recognized FormSpec constraint tag.\n *\n * @param tagName - The tag name to look up (e.g., `\"minimum\"`, `\"@pattern\"`)\n * @returns An LSP `Hover` response, or `null` if the tag is not recognized\n */\nexport function getHoverForTag(tagName: string): Hover | null {\n  // Strip leading `@` prefix if present\n  const raw = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\n  const name = normalizeConstraintTagName(raw);\n\n  if (!isBuiltinConstraintName(name)) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: CONSTRAINT_HOVER_DOCS[name],\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 */\nexport function getDefinition(): Location | null {\n  return null;\n}\n"],"mappings":"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","names":["import_node"]}
+{"version":3,"sources":["../src/index.ts","../src/server.ts","../src/providers/completion.ts","../src/providers/hover.ts","../src/providers/definition.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. Constraint names are sourced from\n * `BUILTIN_CONSTRAINT_DEFINITIONS` in `@formspec/core`, ensuring the\n * language server stays in sync with the single source of truth.\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  TextDocumentSyncKind,\n  type Connection,\n  type InitializeResult,\n} from \"vscode-languageserver/node.js\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { getCompletionItems } from \"./providers/completion.js\";\nimport { getHoverForTag } from \"./providers/hover.js\";\nimport { getDefinition } from \"./providers/definition.js\";\n\nexport interface CreateServerOptions {\n  /** Optional extension definitions whose custom tags should be surfaced by tooling. */\n  readonly extensions?: readonly ExtensionDefinition[];\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 */\nexport function createServer(options: CreateServerOptions = {}): Connection {\n  const connection = createConnection(ProposedFeatures.all);\n\n  connection.onInitialize((): InitializeResult => {\n    return {\n      capabilities: {\n        textDocumentSync: TextDocumentSyncKind.Incremental,\n        completionProvider: {\n          // Trigger completions inside JSDoc comments when `@` is typed\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(() => {\n    // Return all FormSpec constraint tag completions.\n    // Future phases will add context-aware filtering based on field type and\n    // cursor position within JSDoc comment ranges.\n    return getCompletionItems(options.extensions);\n  });\n\n  connection.onHover((_params) => {\n    // Extract the word under the cursor and look up hover documentation.\n    // This is a stub — precise JSDoc token detection (checking that the\n    // cursor is within a JSDoc comment and extracting the tag name) will be\n    // added in a future phase.\n    //\n    // For now we return null to signal no hover is available until the\n    // token extraction is implemented.\n    return getHoverForTag(\"\", options.extensions);\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 * Returns completion items for all recognized FormSpec JSDoc constraint tags\n * (e.g., `@minimum`, `@maximum`, `@pattern`), derived from\n * `BUILTIN_CONSTRAINT_DEFINITIONS`. This is a skeleton — context-aware\n * filtering will be added in a future phase.\n */\n\nimport {\n  BUILTIN_CONSTRAINT_DEFINITIONS,\n  type BuiltinConstraintName,\n  type ExtensionDefinition,\n} from \"@formspec/core\";\nimport { CompletionItem, CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Human-readable detail strings for each built-in constraint tag.\n *\n * Keys match the camelCase constraint names (matching keys in `BUILTIN_CONSTRAINT_DEFINITIONS`).\n * Values are shown as the detail string in completion items.\n */\nconst CONSTRAINT_DETAIL: Record<BuiltinConstraintName, string> = {\n  minimum: \"Minimum numeric value (inclusive). Example: `@minimum 0`\",\n  maximum: \"Maximum numeric value (inclusive). Example: `@maximum 100`\",\n  exclusiveMinimum: \"Minimum numeric value (exclusive). Example: `@exclusiveMinimum 0`\",\n  exclusiveMaximum: \"Maximum numeric value (exclusive). Example: `@exclusiveMaximum 100`\",\n  multipleOf: \"Value must be a multiple of this number. Example: `@multipleOf 0.01`\",\n  minLength: \"Minimum string length. Example: `@minLength 1`\",\n  maxLength: \"Maximum string length. Example: `@maxLength 255`\",\n  minItems: \"Minimum number of array items. Example: `@minItems 1`\",\n  maxItems: \"Maximum number of array items. Example: `@maxItems 10`\",\n  uniqueItems: \"Require all array items to be distinct. Example: `@uniqueItems`\",\n  pattern: \"Regular expression pattern for string validation. Example: `@pattern ^[a-z]+$`\",\n  enumOptions: 'Inline JSON array of allowed enum values. Example: `@enumOptions [\"a\",\"b\",\"c\"]`',\n  const: 'Require a constant JSON value. Example: `@const \"USD\"`',\n};\n\n/**\n * Returns completion items for all FormSpec JSDoc constraint tags.\n *\n * Items are derived from `BUILTIN_CONSTRAINT_DEFINITIONS`, ensuring this list\n * stays in sync with the single source of truth in `@formspec/core`.\n *\n * Each item uses `CompletionItemKind.Keyword` since these are annotation\n * tags used within JSDoc comments rather than language symbols.\n *\n * @returns An array of LSP completion items for FormSpec constraint tags\n */\nexport function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[] {\n  const builtins = (Object.keys(BUILTIN_CONSTRAINT_DEFINITIONS) as BuiltinConstraintName[]).map(\n    (name) => ({\n      label: `@${name}`,\n      kind: CompletionItemKind.Keyword,\n      detail: CONSTRAINT_DETAIL[name],\n    })\n  );\n\n  const customItems =\n    extensions?.flatMap((extension) =>\n      (extension.constraintTags ?? []).map((tag) => ({\n        label: `@${tag.tagName}`,\n        kind: CompletionItemKind.Keyword,\n        detail: `Extension constraint tag from ${extension.extensionId}`,\n      }))\n    ) ?? [];\n\n  return [...builtins, ...customItems];\n}\n","/**\n * Hover provider for FormSpec JSDoc constraint tags.\n *\n * Returns Markdown documentation for a recognized FormSpec JSDoc tag when\n * the cursor is positioned over it. This is a skeleton — precise token\n * detection within JSDoc comment ranges will be added in a future phase.\n */\n\nimport {\n  normalizeConstraintTagName,\n  isBuiltinConstraintName,\n  type BuiltinConstraintName,\n  type ExtensionDefinition,\n} from \"@formspec/core\";\nimport type { Hover } from \"vscode-languageserver/node.js\";\n\n/**\n * Markdown documentation for each built-in FormSpec constraint tag.\n *\n * Keys are the canonical constraint names from `BUILTIN_CONSTRAINT_DEFINITIONS`.\n * Values are Markdown strings suitable for LSP hover responses.\n */\nconst CONSTRAINT_HOVER_DOCS: Record<BuiltinConstraintName, string> = {\n  minimum: [\n    \"**@minimum** `<number>`\",\n    \"\",\n    \"Sets an inclusive lower bound on a numeric field.\",\n    \"\",\n    \"Maps to `minimum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minimum 0 */\",\n    \"amount: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maximum: [\n    \"**@maximum** `<number>`\",\n    \"\",\n    \"Sets an inclusive upper bound on a numeric field.\",\n    \"\",\n    \"Maps to `maximum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maximum 100 */\",\n    \"percentage: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  exclusiveMinimum: [\n    \"**@exclusiveMinimum** `<number>`\",\n    \"\",\n    \"Sets an exclusive lower bound on a numeric field.\",\n    \"\",\n    \"Maps to `exclusiveMinimum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @exclusiveMinimum 0 */\",\n    \"positiveAmount: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  exclusiveMaximum: [\n    \"**@exclusiveMaximum** `<number>`\",\n    \"\",\n    \"Sets an exclusive upper bound on a numeric field.\",\n    \"\",\n    \"Maps to `exclusiveMaximum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @exclusiveMaximum 1 */\",\n    \"ratio: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  multipleOf: [\n    \"**@multipleOf** `<number>`\",\n    \"\",\n    \"Requires the numeric value to be a multiple of the given number.\",\n    \"\",\n    \"Maps to `multipleOf` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @multipleOf 0.01 */\",\n    \"price: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  minLength: [\n    \"**@minLength** `<number>`\",\n    \"\",\n    \"Sets a minimum character length on a string field.\",\n    \"\",\n    \"Maps to `minLength` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minLength 1 */\",\n    \"name: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maxLength: [\n    \"**@maxLength** `<number>`\",\n    \"\",\n    \"Sets a maximum character length on a string field.\",\n    \"\",\n    \"Maps to `maxLength` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maxLength 255 */\",\n    \"description: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  minItems: [\n    \"**@minItems** `<number>`\",\n    \"\",\n    \"Sets a minimum number of items in an array field.\",\n    \"\",\n    \"Maps to `minItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minItems 1 */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maxItems: [\n    \"**@maxItems** `<number>`\",\n    \"\",\n    \"Sets a maximum number of items in an array field.\",\n    \"\",\n    \"Maps to `maxItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maxItems 10 */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  uniqueItems: [\n    \"**@uniqueItems**\",\n    \"\",\n    \"Requires all items in an array field to be distinct.\",\n    \"\",\n    \"Maps to `uniqueItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @uniqueItems */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  pattern: [\n    \"**@pattern** `<regex>`\",\n    \"\",\n    \"Sets a regular expression pattern that a string field must match.\",\n    \"\",\n    \"Maps to `pattern` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @pattern ^[a-z0-9]+$ */\",\n    \"slug: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  enumOptions: [\n    \"**@enumOptions** `<json-array>`\",\n    \"\",\n    \"Specifies the allowed values for an enum field as an inline JSON array.\",\n    \"\",\n    \"Maps to `enum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    '/** @enumOptions [\"draft\",\"sent\",\"archived\"] */',\n    \"status: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  const: [\n    \"**@const** `<json-literal>`\",\n    \"\",\n    \"Requires the field value to equal a single constant JSON value.\",\n    \"\",\n    \"Maps to `const` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    '/** @const \"USD\" */',\n    \"currency: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n} satisfies Record<BuiltinConstraintName, string>;\n\n/**\n * Returns hover documentation for a FormSpec JSDoc tag name.\n *\n * Accepts both camelCase (`\"minimum\"`) and PascalCase (`\"Minimum\"`) forms.\n * The `@` prefix is stripped before lookup if present.\n * Returns `null` when the tag is not a recognized FormSpec constraint tag.\n *\n * @param tagName - The tag name to look up (e.g., `\"minimum\"`, `\"@pattern\"`)\n * @returns An LSP `Hover` response, or `null` if the tag is not recognized\n */\nexport function getHoverForTag(\n  tagName: string,\n  extensions?: readonly ExtensionDefinition[]\n): Hover | null {\n  // Strip leading `@` prefix if present\n  const raw = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\n  const name = normalizeConstraintTagName(raw);\n\n  if (!isBuiltinConstraintName(name)) {\n    const registration = extensions\n      ?.flatMap((extension) =>\n        (extension.constraintTags ?? []).map((tag) => ({\n          extensionId: extension.extensionId,\n          tag,\n        }))\n      )\n      .find(({ tag }) => tag.tagName === name);\n\n    if (registration === undefined) {\n      return null;\n    }\n\n    return {\n      contents: {\n        kind: \"markdown\",\n        value: [\n          `**@${registration.tag.tagName}** \\`<value>\\``,\n          \"\",\n          `Extension-defined constraint tag from \\`${registration.extensionId}\\`.`,\n          \"\",\n          \"Validated through the registered FormSpec extension surface.\",\n        ].join(\"\\n\"),\n      },\n    };\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: CONSTRAINT_HOVER_DOCS[name],\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 */\nexport function getDefinition(): Location | null {\n  return null;\n}\n"],"mappings":"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","names":["import_node","import_core"]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @formspec/language-server
+ * \@formspec/language-server
  *
  * Language server for FormSpec — provides completions, hover documentation,
  * and go-to-definition for FormSpec JSDoc constraint tags (`@Minimum`,
@@ -23,6 +23,7 @@
  * @packageDocumentation
  */
 export { createServer } from "./server.js";
+export type { CreateServerOptions } from "./server.js";
 export { getCompletionItems } from "./providers/completion.js";
 export { getHoverForTag } from "./providers/hover.js";
 export { getDefinition } from "./providers/definition.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -6,6 +6,9 @@ import {
 } from "vscode-languageserver/node.js";
 
 // src/providers/completion.ts
+import {
+  BUILTIN_CONSTRAINT_DEFINITIONS
+} from "@formspec/core";
 import { CompletionItemKind } from "vscode-languageserver/node.js";
 var CONSTRAINT_DETAIL = {
   minimum: "Minimum numeric value (inclusive). Example: `@minimum 0`",
@@ -17,15 +20,27 @@ var CONSTRAINT_DETAIL = {
   maxLength: "Maximum string length. Example: `@maxLength 255`",
   minItems: "Minimum number of array items. Example: `@minItems 1`",
   maxItems: "Maximum number of array items. Example: `@maxItems 10`",
+  uniqueItems: "Require all array items to be distinct. Example: `@uniqueItems`",
   pattern: "Regular expression pattern for string validation. Example: `@pattern ^[a-z]+$`",
-  enumOptions: 'Inline JSON array of allowed enum values. Example: `@enumOptions ["a","b","c"]`'
+  enumOptions: 'Inline JSON array of allowed enum values. Example: `@enumOptions ["a","b","c"]`',
+  const: 'Require a constant JSON value. Example: `@const "USD"`'
 };
-function getCompletionItems() {
-  return Object.entries(CONSTRAINT_DETAIL).map(([name, detail]) => ({
-    label: `@${name}`,
-    kind: CompletionItemKind.Keyword,
-    detail
-  }));
+function getCompletionItems(extensions) {
+  const builtins = Object.keys(BUILTIN_CONSTRAINT_DEFINITIONS).map(
+    (name) => ({
+      label: `@${name}`,
+      kind: CompletionItemKind.Keyword,
+      detail: CONSTRAINT_DETAIL[name]
+    })
+  );
+  const customItems = extensions?.flatMap(
+    (extension) => (extension.constraintTags ?? []).map((tag) => ({
+      label: `@${tag.tagName}`,
+      kind: CompletionItemKind.Keyword,
+      detail: `Extension constraint tag from ${extension.extensionId}`
+    }))
+  ) ?? [];
+  return [...builtins, ...customItems];
 }
 
 // src/providers/hover.ts
@@ -151,6 +166,19 @@ var CONSTRAINT_HOVER_DOCS = {
     "tags: string[];",
     "```"
   ].join("\n"),
+  uniqueItems: [
+    "**@uniqueItems**",
+    "",
+    "Requires all items in an array field to be distinct.",
+    "",
+    "Maps to `uniqueItems` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @uniqueItems */",
+    "tags: string[];",
+    "```"
+  ].join("\n"),
   pattern: [
     "**@pattern** `<regex>`",
     "",
@@ -176,13 +204,46 @@ var CONSTRAINT_HOVER_DOCS = {
     '/** @enumOptions ["draft","sent","archived"] */',
     "status: string;",
     "```"
+  ].join("\n"),
+  const: [
+    "**@const** `<json-literal>`",
+    "",
+    "Requires the field value to equal a single constant JSON value.",
+    "",
+    "Maps to `const` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    '/** @const "USD" */',
+    "currency: string;",
+    "```"
   ].join("\n")
 };
-function getHoverForTag(tagName) {
+function getHoverForTag(tagName, extensions) {
   const raw = tagName.startsWith("@") ? tagName.slice(1) : tagName;
   const name = normalizeConstraintTagName(raw);
   if (!isBuiltinConstraintName(name)) {
-    return null;
+    const registration = extensions?.flatMap(
+      (extension) => (extension.constraintTags ?? []).map((tag) => ({
+        extensionId: extension.extensionId,
+        tag
+      }))
+    ).find(({ tag }) => tag.tagName === name);
+    if (registration === void 0) {
+      return null;
+    }
+    return {
+      contents: {
+        kind: "markdown",
+        value: [
+          `**@${registration.tag.tagName}** \`<value>\``,
+          "",
+          `Extension-defined constraint tag from \`${registration.extensionId}\`.`,
+          "",
+          "Validated through the registered FormSpec extension surface."
+        ].join("\n")
+      }
+    };
   }
   return {
     contents: {
@@ -198,7 +259,7 @@ function getDefinition() {
 }
 
 // src/server.ts
-function createServer() {
+function createServer(options = {}) {
   const connection = createConnection(ProposedFeatures.all);
   connection.onInitialize(() => {
     return {
@@ -218,10 +279,10 @@ function createServer() {
     };
   });
   connection.onCompletion(() => {
-    return getCompletionItems();
+    return getCompletionItems(options.extensions);
   });
   connection.onHover((_params) => {
-    return getHoverForTag("");
+    return getHoverForTag("", options.extensions);
   });
   connection.onDefinition((_params) => {
     return getDefinition();

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"],"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  TextDocumentSyncKind,\n  type Connection,\n  type InitializeResult,\n} from \"vscode-languageserver/node.js\";\nimport { getCompletionItems } from \"./providers/completion.js\";\nimport { getHoverForTag } from \"./providers/hover.js\";\nimport { getDefinition } from \"./providers/definition.js\";\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 */\nexport function createServer(): Connection {\n  const connection = createConnection(ProposedFeatures.all);\n\n  connection.onInitialize((): InitializeResult => {\n    return {\n      capabilities: {\n        textDocumentSync: TextDocumentSyncKind.Incremental,\n        completionProvider: {\n          // Trigger completions inside JSDoc comments when `@` is typed\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(() => {\n    // Return all FormSpec constraint tag completions.\n    // Future phases will add context-aware filtering based on field type and\n    // cursor position within JSDoc comment ranges.\n    return getCompletionItems();\n  });\n\n  connection.onHover((_params) => {\n    // Extract the word under the cursor and look up hover documentation.\n    // This is a stub — precise JSDoc token detection (checking that the\n    // cursor is within a JSDoc comment and extracting the tag name) will be\n    // added in a future phase.\n    //\n    // For now we return null to signal no hover is available until the\n    // token extraction is implemented.\n    return getHoverForTag(\"\");\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 * Returns completion items for all recognized FormSpec JSDoc constraint tags\n * (e.g., `@minimum`, `@maximum`, `@pattern`), derived from\n * `BUILTIN_CONSTRAINT_DEFINITIONS`. This is a skeleton — context-aware\n * filtering will be added in a future phase.\n */\n\nimport { CompletionItem, CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Human-readable detail strings for each built-in constraint tag.\n *\n * Keys match the camelCase constraint names (matching keys in `BUILTIN_CONSTRAINT_DEFINITIONS`).\n * Values are shown as the detail string in completion items.\n */\nconst CONSTRAINT_DETAIL: Record<string, string> = {\n  minimum: \"Minimum numeric value (inclusive). Example: `@minimum 0`\",\n  maximum: \"Maximum numeric value (inclusive). Example: `@maximum 100`\",\n  exclusiveMinimum: \"Minimum numeric value (exclusive). Example: `@exclusiveMinimum 0`\",\n  exclusiveMaximum: \"Maximum numeric value (exclusive). Example: `@exclusiveMaximum 100`\",\n  multipleOf: \"Value must be a multiple of this number. Example: `@multipleOf 0.01`\",\n  minLength: \"Minimum string length. Example: `@minLength 1`\",\n  maxLength: \"Maximum string length. Example: `@maxLength 255`\",\n  minItems: \"Minimum number of array items. Example: `@minItems 1`\",\n  maxItems: \"Maximum number of array items. Example: `@maxItems 10`\",\n  pattern: \"Regular expression pattern for string validation. Example: `@pattern ^[a-z]+$`\",\n  enumOptions: 'Inline JSON array of allowed enum values. Example: `@enumOptions [\"a\",\"b\",\"c\"]`',\n};\n\n/**\n * Returns completion items for all FormSpec JSDoc constraint tags.\n *\n * Items are derived from `BUILTIN_CONSTRAINT_DEFINITIONS`, ensuring this list\n * stays in sync with the single source of truth in `@formspec/core`.\n *\n * Each item uses `CompletionItemKind.Keyword` since these are annotation\n * tags used within JSDoc comments rather than language symbols.\n *\n * @returns An array of LSP completion items for FormSpec constraint tags\n */\nexport function getCompletionItems(): CompletionItem[] {\n  return Object.entries(CONSTRAINT_DETAIL).map(([name, detail]) => ({\n    label: `@${name}`,\n    kind: CompletionItemKind.Keyword,\n    detail,\n  }));\n}\n","/**\n * Hover provider for FormSpec JSDoc constraint tags.\n *\n * Returns Markdown documentation for a recognized FormSpec JSDoc tag when\n * the cursor is positioned over it. This is a skeleton — precise token\n * detection within JSDoc comment ranges will be added in a future phase.\n */\n\nimport {\n  normalizeConstraintTagName,\n  isBuiltinConstraintName,\n  type BuiltinConstraintName,\n} from \"@formspec/core\";\nimport type { Hover } from \"vscode-languageserver/node.js\";\n\n/**\n * Markdown documentation for each built-in FormSpec constraint tag.\n *\n * Keys are the canonical constraint names from `BUILTIN_CONSTRAINT_DEFINITIONS`.\n * Values are Markdown strings suitable for LSP hover responses.\n */\nconst CONSTRAINT_HOVER_DOCS: Record<BuiltinConstraintName, string> = {\n  minimum: [\n    \"**@minimum** `<number>`\",\n    \"\",\n    \"Sets an inclusive lower bound on a numeric field.\",\n    \"\",\n    \"Maps to `minimum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minimum 0 */\",\n    \"amount: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maximum: [\n    \"**@maximum** `<number>`\",\n    \"\",\n    \"Sets an inclusive upper bound on a numeric field.\",\n    \"\",\n    \"Maps to `maximum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maximum 100 */\",\n    \"percentage: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  exclusiveMinimum: [\n    \"**@exclusiveMinimum** `<number>`\",\n    \"\",\n    \"Sets an exclusive lower bound on a numeric field.\",\n    \"\",\n    \"Maps to `exclusiveMinimum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @exclusiveMinimum 0 */\",\n    \"positiveAmount: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  exclusiveMaximum: [\n    \"**@exclusiveMaximum** `<number>`\",\n    \"\",\n    \"Sets an exclusive upper bound on a numeric field.\",\n    \"\",\n    \"Maps to `exclusiveMaximum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @exclusiveMaximum 1 */\",\n    \"ratio: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  multipleOf: [\n    \"**@multipleOf** `<number>`\",\n    \"\",\n    \"Requires the numeric value to be a multiple of the given number.\",\n    \"\",\n    \"Maps to `multipleOf` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @multipleOf 0.01 */\",\n    \"price: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  minLength: [\n    \"**@minLength** `<number>`\",\n    \"\",\n    \"Sets a minimum character length on a string field.\",\n    \"\",\n    \"Maps to `minLength` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minLength 1 */\",\n    \"name: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maxLength: [\n    \"**@maxLength** `<number>`\",\n    \"\",\n    \"Sets a maximum character length on a string field.\",\n    \"\",\n    \"Maps to `maxLength` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maxLength 255 */\",\n    \"description: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  minItems: [\n    \"**@minItems** `<number>`\",\n    \"\",\n    \"Sets a minimum number of items in an array field.\",\n    \"\",\n    \"Maps to `minItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minItems 1 */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maxItems: [\n    \"**@maxItems** `<number>`\",\n    \"\",\n    \"Sets a maximum number of items in an array field.\",\n    \"\",\n    \"Maps to `maxItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maxItems 10 */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  pattern: [\n    \"**@pattern** `<regex>`\",\n    \"\",\n    \"Sets a regular expression pattern that a string field must match.\",\n    \"\",\n    \"Maps to `pattern` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @pattern ^[a-z0-9]+$ */\",\n    \"slug: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  enumOptions: [\n    \"**@enumOptions** `<json-array>`\",\n    \"\",\n    \"Specifies the allowed values for an enum field as an inline JSON array.\",\n    \"\",\n    \"Maps to `enum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    '/** @enumOptions [\"draft\",\"sent\",\"archived\"] */',\n    \"status: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n} satisfies Record<BuiltinConstraintName, string>;\n\n/**\n * Returns hover documentation for a FormSpec JSDoc tag name.\n *\n * Accepts both camelCase (`\"minimum\"`) and PascalCase (`\"Minimum\"`) forms.\n * The `@` prefix is stripped before lookup if present.\n * Returns `null` when the tag is not a recognized FormSpec constraint tag.\n *\n * @param tagName - The tag name to look up (e.g., `\"minimum\"`, `\"@pattern\"`)\n * @returns An LSP `Hover` response, or `null` if the tag is not recognized\n */\nexport function getHoverForTag(tagName: string): Hover | null {\n  // Strip leading `@` prefix if present\n  const raw = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\n  const name = normalizeConstraintTagName(raw);\n\n  if (!isBuiltinConstraintName(name)) {\n    return null;\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: CONSTRAINT_HOVER_DOCS[name],\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 */\nexport function getDefinition(): Location | null {\n  return 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"],"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  TextDocumentSyncKind,\n  type Connection,\n  type InitializeResult,\n} from \"vscode-languageserver/node.js\";\nimport type { ExtensionDefinition } from \"@formspec/core\";\nimport { getCompletionItems } from \"./providers/completion.js\";\nimport { getHoverForTag } from \"./providers/hover.js\";\nimport { getDefinition } from \"./providers/definition.js\";\n\nexport interface CreateServerOptions {\n  /** Optional extension definitions whose custom tags should be surfaced by tooling. */\n  readonly extensions?: readonly ExtensionDefinition[];\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 */\nexport function createServer(options: CreateServerOptions = {}): Connection {\n  const connection = createConnection(ProposedFeatures.all);\n\n  connection.onInitialize((): InitializeResult => {\n    return {\n      capabilities: {\n        textDocumentSync: TextDocumentSyncKind.Incremental,\n        completionProvider: {\n          // Trigger completions inside JSDoc comments when `@` is typed\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(() => {\n    // Return all FormSpec constraint tag completions.\n    // Future phases will add context-aware filtering based on field type and\n    // cursor position within JSDoc comment ranges.\n    return getCompletionItems(options.extensions);\n  });\n\n  connection.onHover((_params) => {\n    // Extract the word under the cursor and look up hover documentation.\n    // This is a stub — precise JSDoc token detection (checking that the\n    // cursor is within a JSDoc comment and extracting the tag name) will be\n    // added in a future phase.\n    //\n    // For now we return null to signal no hover is available until the\n    // token extraction is implemented.\n    return getHoverForTag(\"\", options.extensions);\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 * Returns completion items for all recognized FormSpec JSDoc constraint tags\n * (e.g., `@minimum`, `@maximum`, `@pattern`), derived from\n * `BUILTIN_CONSTRAINT_DEFINITIONS`. This is a skeleton — context-aware\n * filtering will be added in a future phase.\n */\n\nimport {\n  BUILTIN_CONSTRAINT_DEFINITIONS,\n  type BuiltinConstraintName,\n  type ExtensionDefinition,\n} from \"@formspec/core\";\nimport { CompletionItem, CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Human-readable detail strings for each built-in constraint tag.\n *\n * Keys match the camelCase constraint names (matching keys in `BUILTIN_CONSTRAINT_DEFINITIONS`).\n * Values are shown as the detail string in completion items.\n */\nconst CONSTRAINT_DETAIL: Record<BuiltinConstraintName, string> = {\n  minimum: \"Minimum numeric value (inclusive). Example: `@minimum 0`\",\n  maximum: \"Maximum numeric value (inclusive). Example: `@maximum 100`\",\n  exclusiveMinimum: \"Minimum numeric value (exclusive). Example: `@exclusiveMinimum 0`\",\n  exclusiveMaximum: \"Maximum numeric value (exclusive). Example: `@exclusiveMaximum 100`\",\n  multipleOf: \"Value must be a multiple of this number. Example: `@multipleOf 0.01`\",\n  minLength: \"Minimum string length. Example: `@minLength 1`\",\n  maxLength: \"Maximum string length. Example: `@maxLength 255`\",\n  minItems: \"Minimum number of array items. Example: `@minItems 1`\",\n  maxItems: \"Maximum number of array items. Example: `@maxItems 10`\",\n  uniqueItems: \"Require all array items to be distinct. Example: `@uniqueItems`\",\n  pattern: \"Regular expression pattern for string validation. Example: `@pattern ^[a-z]+$`\",\n  enumOptions: 'Inline JSON array of allowed enum values. Example: `@enumOptions [\"a\",\"b\",\"c\"]`',\n  const: 'Require a constant JSON value. Example: `@const \"USD\"`',\n};\n\n/**\n * Returns completion items for all FormSpec JSDoc constraint tags.\n *\n * Items are derived from `BUILTIN_CONSTRAINT_DEFINITIONS`, ensuring this list\n * stays in sync with the single source of truth in `@formspec/core`.\n *\n * Each item uses `CompletionItemKind.Keyword` since these are annotation\n * tags used within JSDoc comments rather than language symbols.\n *\n * @returns An array of LSP completion items for FormSpec constraint tags\n */\nexport function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[] {\n  const builtins = (Object.keys(BUILTIN_CONSTRAINT_DEFINITIONS) as BuiltinConstraintName[]).map(\n    (name) => ({\n      label: `@${name}`,\n      kind: CompletionItemKind.Keyword,\n      detail: CONSTRAINT_DETAIL[name],\n    })\n  );\n\n  const customItems =\n    extensions?.flatMap((extension) =>\n      (extension.constraintTags ?? []).map((tag) => ({\n        label: `@${tag.tagName}`,\n        kind: CompletionItemKind.Keyword,\n        detail: `Extension constraint tag from ${extension.extensionId}`,\n      }))\n    ) ?? [];\n\n  return [...builtins, ...customItems];\n}\n","/**\n * Hover provider for FormSpec JSDoc constraint tags.\n *\n * Returns Markdown documentation for a recognized FormSpec JSDoc tag when\n * the cursor is positioned over it. This is a skeleton — precise token\n * detection within JSDoc comment ranges will be added in a future phase.\n */\n\nimport {\n  normalizeConstraintTagName,\n  isBuiltinConstraintName,\n  type BuiltinConstraintName,\n  type ExtensionDefinition,\n} from \"@formspec/core\";\nimport type { Hover } from \"vscode-languageserver/node.js\";\n\n/**\n * Markdown documentation for each built-in FormSpec constraint tag.\n *\n * Keys are the canonical constraint names from `BUILTIN_CONSTRAINT_DEFINITIONS`.\n * Values are Markdown strings suitable for LSP hover responses.\n */\nconst CONSTRAINT_HOVER_DOCS: Record<BuiltinConstraintName, string> = {\n  minimum: [\n    \"**@minimum** `<number>`\",\n    \"\",\n    \"Sets an inclusive lower bound on a numeric field.\",\n    \"\",\n    \"Maps to `minimum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minimum 0 */\",\n    \"amount: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maximum: [\n    \"**@maximum** `<number>`\",\n    \"\",\n    \"Sets an inclusive upper bound on a numeric field.\",\n    \"\",\n    \"Maps to `maximum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maximum 100 */\",\n    \"percentage: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  exclusiveMinimum: [\n    \"**@exclusiveMinimum** `<number>`\",\n    \"\",\n    \"Sets an exclusive lower bound on a numeric field.\",\n    \"\",\n    \"Maps to `exclusiveMinimum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @exclusiveMinimum 0 */\",\n    \"positiveAmount: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  exclusiveMaximum: [\n    \"**@exclusiveMaximum** `<number>`\",\n    \"\",\n    \"Sets an exclusive upper bound on a numeric field.\",\n    \"\",\n    \"Maps to `exclusiveMaximum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @exclusiveMaximum 1 */\",\n    \"ratio: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  multipleOf: [\n    \"**@multipleOf** `<number>`\",\n    \"\",\n    \"Requires the numeric value to be a multiple of the given number.\",\n    \"\",\n    \"Maps to `multipleOf` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @multipleOf 0.01 */\",\n    \"price: number;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  minLength: [\n    \"**@minLength** `<number>`\",\n    \"\",\n    \"Sets a minimum character length on a string field.\",\n    \"\",\n    \"Maps to `minLength` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minLength 1 */\",\n    \"name: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maxLength: [\n    \"**@maxLength** `<number>`\",\n    \"\",\n    \"Sets a maximum character length on a string field.\",\n    \"\",\n    \"Maps to `maxLength` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maxLength 255 */\",\n    \"description: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  minItems: [\n    \"**@minItems** `<number>`\",\n    \"\",\n    \"Sets a minimum number of items in an array field.\",\n    \"\",\n    \"Maps to `minItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @minItems 1 */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  maxItems: [\n    \"**@maxItems** `<number>`\",\n    \"\",\n    \"Sets a maximum number of items in an array field.\",\n    \"\",\n    \"Maps to `maxItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @maxItems 10 */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  uniqueItems: [\n    \"**@uniqueItems**\",\n    \"\",\n    \"Requires all items in an array field to be distinct.\",\n    \"\",\n    \"Maps to `uniqueItems` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @uniqueItems */\",\n    \"tags: string[];\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  pattern: [\n    \"**@pattern** `<regex>`\",\n    \"\",\n    \"Sets a regular expression pattern that a string field must match.\",\n    \"\",\n    \"Maps to `pattern` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    \"/** @pattern ^[a-z0-9]+$ */\",\n    \"slug: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  enumOptions: [\n    \"**@enumOptions** `<json-array>`\",\n    \"\",\n    \"Specifies the allowed values for an enum field as an inline JSON array.\",\n    \"\",\n    \"Maps to `enum` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    '/** @enumOptions [\"draft\",\"sent\",\"archived\"] */',\n    \"status: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n\n  const: [\n    \"**@const** `<json-literal>`\",\n    \"\",\n    \"Requires the field value to equal a single constant JSON value.\",\n    \"\",\n    \"Maps to `const` in JSON Schema.\",\n    \"\",\n    \"**Example:**\",\n    \"```typescript\",\n    '/** @const \"USD\" */',\n    \"currency: string;\",\n    \"```\",\n  ].join(\"\\n\"),\n} satisfies Record<BuiltinConstraintName, string>;\n\n/**\n * Returns hover documentation for a FormSpec JSDoc tag name.\n *\n * Accepts both camelCase (`\"minimum\"`) and PascalCase (`\"Minimum\"`) forms.\n * The `@` prefix is stripped before lookup if present.\n * Returns `null` when the tag is not a recognized FormSpec constraint tag.\n *\n * @param tagName - The tag name to look up (e.g., `\"minimum\"`, `\"@pattern\"`)\n * @returns An LSP `Hover` response, or `null` if the tag is not recognized\n */\nexport function getHoverForTag(\n  tagName: string,\n  extensions?: readonly ExtensionDefinition[]\n): Hover | null {\n  // Strip leading `@` prefix if present\n  const raw = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\n  const name = normalizeConstraintTagName(raw);\n\n  if (!isBuiltinConstraintName(name)) {\n    const registration = extensions\n      ?.flatMap((extension) =>\n        (extension.constraintTags ?? []).map((tag) => ({\n          extensionId: extension.extensionId,\n          tag,\n        }))\n      )\n      .find(({ tag }) => tag.tagName === name);\n\n    if (registration === undefined) {\n      return null;\n    }\n\n    return {\n      contents: {\n        kind: \"markdown\",\n        value: [\n          `**@${registration.tag.tagName}** \\`<value>\\``,\n          \"\",\n          `Extension-defined constraint tag from \\`${registration.extensionId}\\`.`,\n          \"\",\n          \"Validated through the registered FormSpec extension surface.\",\n        ].join(\"\\n\"),\n      },\n    };\n  }\n\n  return {\n    contents: {\n      kind: \"markdown\",\n      value: CONSTRAINT_HOVER_DOCS[name],\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 */\nexport function getDefinition(): Location | null {\n  return null;\n}\n"],"mappings":"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","names":[]}

package/dist/language-server.d.ts

@@ -1,5 +1,5 @@
 /**
- * @formspec/language-server
+ * \@formspec/language-server
  *
  * Language server for FormSpec — provides completions, hover documentation,
  * and go-to-definition for FormSpec JSDoc constraint tags (`@Minimum`,
@@ -25,6 +25,7 @@
 
 import { CompletionItem } from 'vscode-languageserver/node.js';
 import { Connection } from 'vscode-languageserver/node.js';
+import { ExtensionDefinition } from '@formspec/core';
 import type { Hover } from 'vscode-languageserver/node.js';
 import type { Location } from 'vscode-languageserver/node.js';
 
@@ -36,7 +37,12 @@ import type { Location } from 'vscode-languageserver/node.js';
  *
  * @returns The configured LSP connection (not yet listening)
  */
-export declare function createServer(): Connection;
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+export declare interface CreateServerOptions {
+    /** Optional extension definitions whose custom tags should be surfaced by tooling. */
+    readonly extensions?: readonly ExtensionDefinition[];
+}
 
 /**
  * Returns completion items for all FormSpec JSDoc constraint tags.
@@ -49,7 +55,7 @@ export declare function createServer(): Connection;
  *
  * @returns An array of LSP completion items for FormSpec constraint tags
  */
-export declare function getCompletionItems(): CompletionItem[];
+export declare function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[];
 
 /**
  * Returns the definition location for a symbol at the given position.
@@ -70,6 +76,6 @@ export declare function getDefinition(): Location | null;
  * @param tagName - The tag name to look up (e.g., `"minimum"`, `"@pattern"`)
  * @returns An LSP `Hover` response, or `null` if the tag is not recognized
  */
-export declare function getHoverForTag(tagName: string): Hover | null;
+export declare function getHoverForTag(tagName: string, extensions?: readonly ExtensionDefinition[]): Hover | null;
 
 export { }

package/dist/providers/completion.d.ts

@@ -6,6 +6,7 @@
  * `BUILTIN_CONSTRAINT_DEFINITIONS`. This is a skeleton — context-aware
  * filtering will be added in a future phase.
  */
+import { type ExtensionDefinition } from "@formspec/core";
 import { CompletionItem } from "vscode-languageserver/node.js";
 /**
  * Returns completion items for all FormSpec JSDoc constraint tags.
@@ -18,5 +19,5 @@ import { CompletionItem } from "vscode-languageserver/node.js";
  *
  * @returns An array of LSP completion items for FormSpec constraint tags
  */
-export declare function getCompletionItems(): CompletionItem[];
+export declare function getCompletionItems(extensions?: readonly ExtensionDefinition[]): CompletionItem[];
 //# sourceMappingURL=completion.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/providers/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAsB,MAAM,+BAA+B,CAAC;AAsBnF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAMrD"}
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/providers/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAsB,MAAM,+BAA+B,CAAC;AAwBnF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,cAAc,EAAE,CAmBhG"}

package/dist/providers/hover.d.ts

@@ -5,6 +5,7 @@
  * the cursor is positioned over it. This is a skeleton — precise token
  * detection within JSDoc comment ranges will be added in a future phase.
  */
+import { type ExtensionDefinition } from "@formspec/core";
 import type { Hover } from "vscode-languageserver/node.js";
 /**
  * Returns hover documentation for a FormSpec JSDoc tag name.
@@ -16,5 +17,5 @@ import type { Hover } from "vscode-languageserver/node.js";
  * @param tagName - The tag name to look up (e.g., `"minimum"`, `"@pattern"`)
  * @returns An LSP `Hover` response, or `null` if the tag is not recognized
  */
-export declare function getHoverForTag(tagName: string): Hover | null;
+export declare function getHoverForTag(tagName: string, extensions?: readonly ExtensionDefinition[]): Hover | null;
 //# sourceMappingURL=hover.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../src/providers/hover.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAoK3D;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAe5D"}
+{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../src/providers/hover.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAgM3D;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAC1C,KAAK,GAAG,IAAI,CAuCd"}

package/dist/server.d.ts

@@ -9,6 +9,11 @@
  * Diagnostics are intentionally omitted per design decision A7.
  */
 import { type Connection } from "vscode-languageserver/node.js";
+import type { ExtensionDefinition } from "@formspec/core";
+export interface CreateServerOptions {
+    /** Optional extension definitions whose custom tags should be surfaced by tooling. */
+    readonly extensions?: readonly ExtensionDefinition[];
+}
 /**
  * Creates and configures the FormSpec language server connection.
  *
@@ -17,5 +22,5 @@ import { type Connection } from "vscode-languageserver/node.js";
  *
  * @returns The configured LSP connection (not yet listening)
  */
-export declare function createServer(): Connection;
+export declare function createServer(options?: CreateServerOptions): Connection;
 //# sourceMappingURL=server.d.ts.map

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,EAIL,KAAK,UAAU,EAEhB,MAAM,+BAA+B,CAAC;AAKvC;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,UAAU,CA6CzC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAIL,KAAK,UAAU,EAEhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAK1D,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACtD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CA6C1E"}

package/package.json

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