@formspec/language-server 0.1.0-alpha.11

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/index.cjs

@@ -0,0 +1,223 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createServer: () => createServer,
+  getCompletionItems: () => getCompletionItems,
+  getDefinition: () => getDefinition,
+  getHoverForTag: () => getHoverForTag
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/server.ts
+var import_node2 = require("vscode-languageserver/node.js");
+
+// src/providers/completion.ts
+var import_node = require("vscode-languageserver/node.js");
+var CONSTRAINT_DETAIL = {
+  Minimum: "Minimum numeric value (inclusive). Example: `@Minimum 0`",
+  Maximum: "Maximum numeric value (inclusive). Example: `@Maximum 100`",
+  ExclusiveMinimum: "Minimum numeric value (exclusive). Example: `@ExclusiveMinimum 0`",
+  ExclusiveMaximum: "Maximum numeric value (exclusive). Example: `@ExclusiveMaximum 100`",
+  MinLength: "Minimum string length. Example: `@MinLength 1`",
+  MaxLength: "Maximum string length. Example: `@MaxLength 255`",
+  Pattern: "Regular expression pattern for string validation. Example: `@Pattern ^[a-z]+$`",
+  EnumOptions: 'Inline JSON array of allowed enum values. Example: `@EnumOptions ["a","b","c"]`'
+};
+function getCompletionItems() {
+  return Object.entries(CONSTRAINT_DETAIL).map(([name, detail]) => ({
+    label: `@${name}`,
+    kind: import_node.CompletionItemKind.Keyword,
+    detail
+  }));
+}
+
+// src/providers/hover.ts
+var import_core = require("@formspec/core");
+var CONSTRAINT_HOVER_DOCS = {
+  Minimum: [
+    "**@Minimum** `<number>`",
+    "",
+    "Sets an inclusive lower bound on a numeric field.",
+    "",
+    "Maps to `minimum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @Minimum 0 */",
+    "amount: number;",
+    "```"
+  ].join("\n"),
+  Maximum: [
+    "**@Maximum** `<number>`",
+    "",
+    "Sets an inclusive upper bound on a numeric field.",
+    "",
+    "Maps to `maximum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @Maximum 100 */",
+    "percentage: number;",
+    "```"
+  ].join("\n"),
+  ExclusiveMinimum: [
+    "**@ExclusiveMinimum** `<number>`",
+    "",
+    "Sets an exclusive lower bound on a numeric field.",
+    "",
+    "Maps to `exclusiveMinimum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @ExclusiveMinimum 0 */",
+    "positiveAmount: number;",
+    "```"
+  ].join("\n"),
+  ExclusiveMaximum: [
+    "**@ExclusiveMaximum** `<number>`",
+    "",
+    "Sets an exclusive upper bound on a numeric field.",
+    "",
+    "Maps to `exclusiveMaximum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @ExclusiveMaximum 1 */",
+    "ratio: number;",
+    "```"
+  ].join("\n"),
+  MinLength: [
+    "**@MinLength** `<number>`",
+    "",
+    "Sets a minimum character length on a string field.",
+    "",
+    "Maps to `minLength` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @MinLength 1 */",
+    "name: string;",
+    "```"
+  ].join("\n"),
+  MaxLength: [
+    "**@MaxLength** `<number>`",
+    "",
+    "Sets a maximum character length on a string field.",
+    "",
+    "Maps to `maxLength` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @MaxLength 255 */",
+    "description: string;",
+    "```"
+  ].join("\n"),
+  Pattern: [
+    "**@Pattern** `<regex>`",
+    "",
+    "Sets a regular expression pattern that a string field must match.",
+    "",
+    "Maps to `pattern` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @Pattern ^[a-z0-9]+$ */",
+    "slug: string;",
+    "```"
+  ].join("\n"),
+  EnumOptions: [
+    "**@EnumOptions** `<json-array>`",
+    "",
+    "Specifies the allowed values for an enum field as an inline JSON array.",
+    "",
+    "Maps to `enum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    '/** @EnumOptions ["draft","sent","archived"] */',
+    "status: string;",
+    "```"
+  ].join("\n")
+};
+function isBuiltinConstraintName(name) {
+  return Object.prototype.hasOwnProperty.call(import_core.BUILTIN_CONSTRAINT_DEFINITIONS, name);
+}
+function getHoverForTag(tagName) {
+  const name = tagName.startsWith("@") ? tagName.slice(1) : tagName;
+  if (!isBuiltinConstraintName(name)) {
+    return null;
+  }
+  return {
+    contents: {
+      kind: "markdown",
+      value: CONSTRAINT_HOVER_DOCS[name]
+    }
+  };
+}
+
+// src/providers/definition.ts
+function getDefinition() {
+  return null;
+}
+
+// src/server.ts
+function createServer() {
+  const connection = (0, import_node2.createConnection)(import_node2.ProposedFeatures.all);
+  connection.onInitialize(() => {
+    return {
+      capabilities: {
+        textDocumentSync: import_node2.TextDocumentSyncKind.Incremental,
+        completionProvider: {
+          // Trigger completions inside JSDoc comments when `@` is typed
+          triggerCharacters: ["@"]
+        },
+        // Hover and go-to-definition are not yet implemented (token extraction
+        // from _params is required). Disabled until those features are wired up
+        // so clients don't enable UI affordances that never resolve.
+        hoverProvider: false,
+        definitionProvider: false
+      },
+      serverInfo: {
+        name: "formspec-language-server",
+        version: "0.1.0"
+      }
+    };
+  });
+  connection.onCompletion(() => {
+    return getCompletionItems();
+  });
+  connection.onHover((_params) => {
+    return getHoverForTag("");
+  });
+  connection.onDefinition((_params) => {
+    return getDefinition();
+  });
+  return connection;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createServer,
+  getCompletionItems,
+  getDefinition,
+  getHoverForTag
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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        // Hover and go-to-definition are not yet implemented (token extraction\n        // from _params is required). Disabled until those features are wired up\n        // so clients don't enable UI affordances that never resolve.\n        hoverProvider: false,\n        definitionProvider: false,\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 type { CompletionItem } from \"vscode-languageserver/node.js\";\nimport { CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Human-readable detail strings for each built-in constraint tag.\n *\n * Keys match the constraint name (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  MinLength: \"Minimum string length. Example: `@MinLength 1`\",\n  MaxLength: \"Maximum string length. Example: `@MaxLength 255`\",\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\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 { BUILTIN_CONSTRAINT_DEFINITIONS, type BuiltinConstraintName } 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  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  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 * Checks whether a given string is a recognized built-in constraint name.\n *\n * @param name - The name to check\n * @returns `true` if `name` is a `BuiltinConstraintName`\n */\nfunction isBuiltinConstraintName(name: string): name is BuiltinConstraintName {\n  return Object.prototype.hasOwnProperty.call(BUILTIN_CONSTRAINT_DEFINITIONS, name);\n}\n\n/**\n * Returns hover documentation for a FormSpec JSDoc tag name.\n *\n * The tag name lookup is case-sensitive and matches the canonical casing used\n * in `BUILTIN_CONSTRAINT_DEFINITIONS` (e.g., `\"Minimum\"`, `\"Pattern\"`).\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 name = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\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"]}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @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. Constraint names are sourced from
+ * `BUILTIN_CONSTRAINT_DEFINITIONS` in `@formspec/core`, ensuring the
+ * language server stays in sync with the single source of truth.
+ *
+ * Diagnostics are intentionally omitted per design decision A7.
+ *
+ * @example
+ * ```ts
+ * import { createServer } from '@formspec/language-server';
+ *
+ * const connection = createServer();
+ * connection.listen();
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createServer } from "./server.js";
+export { getCompletionItems } from "./providers/completion.js";
+export { getHoverForTag } from "./providers/hover.js";
+export { getDefinition } from "./providers/definition.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,197 @@
+// src/server.ts
+import {
+  createConnection,
+  ProposedFeatures,
+  TextDocumentSyncKind
+} from "vscode-languageserver/node.js";
+
+// src/providers/completion.ts
+import { CompletionItemKind } from "vscode-languageserver/node.js";
+var CONSTRAINT_DETAIL = {
+  Minimum: "Minimum numeric value (inclusive). Example: `@Minimum 0`",
+  Maximum: "Maximum numeric value (inclusive). Example: `@Maximum 100`",
+  ExclusiveMinimum: "Minimum numeric value (exclusive). Example: `@ExclusiveMinimum 0`",
+  ExclusiveMaximum: "Maximum numeric value (exclusive). Example: `@ExclusiveMaximum 100`",
+  MinLength: "Minimum string length. Example: `@MinLength 1`",
+  MaxLength: "Maximum string length. Example: `@MaxLength 255`",
+  Pattern: "Regular expression pattern for string validation. Example: `@Pattern ^[a-z]+$`",
+  EnumOptions: 'Inline JSON array of allowed enum values. Example: `@EnumOptions ["a","b","c"]`'
+};
+function getCompletionItems() {
+  return Object.entries(CONSTRAINT_DETAIL).map(([name, detail]) => ({
+    label: `@${name}`,
+    kind: CompletionItemKind.Keyword,
+    detail
+  }));
+}
+
+// src/providers/hover.ts
+import { BUILTIN_CONSTRAINT_DEFINITIONS } from "@formspec/core";
+var CONSTRAINT_HOVER_DOCS = {
+  Minimum: [
+    "**@Minimum** `<number>`",
+    "",
+    "Sets an inclusive lower bound on a numeric field.",
+    "",
+    "Maps to `minimum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @Minimum 0 */",
+    "amount: number;",
+    "```"
+  ].join("\n"),
+  Maximum: [
+    "**@Maximum** `<number>`",
+    "",
+    "Sets an inclusive upper bound on a numeric field.",
+    "",
+    "Maps to `maximum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @Maximum 100 */",
+    "percentage: number;",
+    "```"
+  ].join("\n"),
+  ExclusiveMinimum: [
+    "**@ExclusiveMinimum** `<number>`",
+    "",
+    "Sets an exclusive lower bound on a numeric field.",
+    "",
+    "Maps to `exclusiveMinimum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @ExclusiveMinimum 0 */",
+    "positiveAmount: number;",
+    "```"
+  ].join("\n"),
+  ExclusiveMaximum: [
+    "**@ExclusiveMaximum** `<number>`",
+    "",
+    "Sets an exclusive upper bound on a numeric field.",
+    "",
+    "Maps to `exclusiveMaximum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @ExclusiveMaximum 1 */",
+    "ratio: number;",
+    "```"
+  ].join("\n"),
+  MinLength: [
+    "**@MinLength** `<number>`",
+    "",
+    "Sets a minimum character length on a string field.",
+    "",
+    "Maps to `minLength` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @MinLength 1 */",
+    "name: string;",
+    "```"
+  ].join("\n"),
+  MaxLength: [
+    "**@MaxLength** `<number>`",
+    "",
+    "Sets a maximum character length on a string field.",
+    "",
+    "Maps to `maxLength` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @MaxLength 255 */",
+    "description: string;",
+    "```"
+  ].join("\n"),
+  Pattern: [
+    "**@Pattern** `<regex>`",
+    "",
+    "Sets a regular expression pattern that a string field must match.",
+    "",
+    "Maps to `pattern` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    "/** @Pattern ^[a-z0-9]+$ */",
+    "slug: string;",
+    "```"
+  ].join("\n"),
+  EnumOptions: [
+    "**@EnumOptions** `<json-array>`",
+    "",
+    "Specifies the allowed values for an enum field as an inline JSON array.",
+    "",
+    "Maps to `enum` in JSON Schema.",
+    "",
+    "**Example:**",
+    "```typescript",
+    '/** @EnumOptions ["draft","sent","archived"] */',
+    "status: string;",
+    "```"
+  ].join("\n")
+};
+function isBuiltinConstraintName(name) {
+  return Object.prototype.hasOwnProperty.call(BUILTIN_CONSTRAINT_DEFINITIONS, name);
+}
+function getHoverForTag(tagName) {
+  const name = tagName.startsWith("@") ? tagName.slice(1) : tagName;
+  if (!isBuiltinConstraintName(name)) {
+    return null;
+  }
+  return {
+    contents: {
+      kind: "markdown",
+      value: CONSTRAINT_HOVER_DOCS[name]
+    }
+  };
+}
+
+// src/providers/definition.ts
+function getDefinition() {
+  return null;
+}
+
+// src/server.ts
+function createServer() {
+  const connection = createConnection(ProposedFeatures.all);
+  connection.onInitialize(() => {
+    return {
+      capabilities: {
+        textDocumentSync: TextDocumentSyncKind.Incremental,
+        completionProvider: {
+          // Trigger completions inside JSDoc comments when `@` is typed
+          triggerCharacters: ["@"]
+        },
+        // Hover and go-to-definition are not yet implemented (token extraction
+        // from _params is required). Disabled until those features are wired up
+        // so clients don't enable UI affordances that never resolve.
+        hoverProvider: false,
+        definitionProvider: false
+      },
+      serverInfo: {
+        name: "formspec-language-server",
+        version: "0.1.0"
+      }
+    };
+  });
+  connection.onCompletion(() => {
+    return getCompletionItems();
+  });
+  connection.onHover((_params) => {
+    return getHoverForTag("");
+  });
+  connection.onDefinition((_params) => {
+    return getDefinition();
+  });
+  return connection;
+}
+export {
+  createServer,
+  getCompletionItems,
+  getDefinition,
+  getHoverForTag
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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        // Hover and go-to-definition are not yet implemented (token extraction\n        // from _params is required). Disabled until those features are wired up\n        // so clients don't enable UI affordances that never resolve.\n        hoverProvider: false,\n        definitionProvider: false,\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 type { CompletionItem } from \"vscode-languageserver/node.js\";\nimport { CompletionItemKind } from \"vscode-languageserver/node.js\";\n\n/**\n * Human-readable detail strings for each built-in constraint tag.\n *\n * Keys match the constraint name (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  MinLength: \"Minimum string length. Example: `@MinLength 1`\",\n  MaxLength: \"Maximum string length. Example: `@MaxLength 255`\",\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\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 { BUILTIN_CONSTRAINT_DEFINITIONS, type BuiltinConstraintName } 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  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  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 * Checks whether a given string is a recognized built-in constraint name.\n *\n * @param name - The name to check\n * @returns `true` if `name` is a `BuiltinConstraintName`\n */\nfunction isBuiltinConstraintName(name: string): name is BuiltinConstraintName {\n  return Object.prototype.hasOwnProperty.call(BUILTIN_CONSTRAINT_DEFINITIONS, name);\n}\n\n/**\n * Returns hover documentation for a FormSpec JSDoc tag name.\n *\n * The tag name lookup is case-sensitive and matches the canonical casing used\n * in `BUILTIN_CONSTRAINT_DEFINITIONS` (e.g., `\"Minimum\"`, `\"Pattern\"`).\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 name = tagName.startsWith(\"@\") ? tagName.slice(1) : tagName;\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":[]}

package/dist/language-server.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @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. Constraint names are sourced from
+ * `BUILTIN_CONSTRAINT_DEFINITIONS` in `@formspec/core`, ensuring the
+ * language server stays in sync with the single source of truth.
+ *
+ * Diagnostics are intentionally omitted per design decision A7.
+ *
+ * @example
+ * ```ts
+ * import { createServer } from '@formspec/language-server';
+ *
+ * const connection = createServer();
+ * connection.listen();
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+import type { CompletionItem } from 'vscode-languageserver/node.js';
+import { Connection } from 'vscode-languageserver/node.js';
+import type { Hover } from 'vscode-languageserver/node.js';
+import type { Location } from 'vscode-languageserver/node.js';
+
+/**
+ * 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)
+ */
+export declare function createServer(): Connection;
+
+/**
+ * Returns completion items for all FormSpec JSDoc constraint tags.
+ *
+ * Items are derived from `BUILTIN_CONSTRAINT_DEFINITIONS`, ensuring this list
+ * stays in sync with the single source of truth in `@formspec/core`.
+ *
+ * Each item uses `CompletionItemKind.Keyword` since these are annotation
+ * tags used within JSDoc comments rather than language symbols.
+ *
+ * @returns An array of LSP completion items for FormSpec constraint tags
+ */
+export declare function getCompletionItems(): CompletionItem[];
+
+/**
+ * Returns the definition location for a symbol at the given position.
+ *
+ * Always returns `null` in this stub implementation.
+ *
+ * @returns `null` — not yet implemented
+ */
+export declare function getDefinition(): Location | null;
+
+/**
+ * Returns hover documentation for a FormSpec JSDoc tag name.
+ *
+ * The tag name lookup is case-sensitive and matches the canonical casing used
+ * in `BUILTIN_CONSTRAINT_DEFINITIONS` (e.g., `"Minimum"`, `"Pattern"`).
+ * The `@` prefix is stripped before lookup if present.
+ * Returns `null` when the tag is not a recognized FormSpec constraint tag.
+ *
+ * @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 { }

package/dist/providers/completion.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Completion provider for FormSpec JSDoc constraint tags.
+ *
+ * Returns completion items for all recognized FormSpec JSDoc constraint tags
+ * (e.g., `@Minimum`, `@Maximum`, `@Pattern`), derived from
+ * `BUILTIN_CONSTRAINT_DEFINITIONS`. This is a skeleton — context-aware
+ * filtering will be added in a future phase.
+ */
+import type { CompletionItem } from "vscode-languageserver/node.js";
+/**
+ * Returns completion items for all FormSpec JSDoc constraint tags.
+ *
+ * Items are derived from `BUILTIN_CONSTRAINT_DEFINITIONS`, ensuring this list
+ * stays in sync with the single source of truth in `@formspec/core`.
+ *
+ * Each item uses `CompletionItemKind.Keyword` since these are annotation
+ * tags used within JSDoc comments rather than language symbols.
+ *
+ * @returns An array of LSP completion items for FormSpec constraint tags
+ */
+export declare function getCompletionItems(): CompletionItem[];
+//# sourceMappingURL=completion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/providers/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAoBpE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAOrD"}

package/dist/providers/definition.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Go-to-definition provider for FormSpec.
+ *
+ * This is a stub — go-to-definition support (e.g., navigating from a
+ * `field.text("name")` call to the form definition that references it) will
+ * be implemented in a future phase.
+ */
+import type { Location } from "vscode-languageserver/node.js";
+/**
+ * Returns the definition location for a symbol at the given position.
+ *
+ * Always returns `null` in this stub implementation.
+ *
+ * @returns `null` — not yet implemented
+ */
+export declare function getDefinition(): Location | null;
+//# sourceMappingURL=definition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/providers/definition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,QAAQ,GAAG,IAAI,CAE/C"}

package/dist/providers/hover.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Hover provider for FormSpec JSDoc constraint tags.
+ *
+ * Returns Markdown documentation for a recognized FormSpec JSDoc tag when
+ * 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 { Hover } from "vscode-languageserver/node.js";
+/**
+ * Returns hover documentation for a FormSpec JSDoc tag name.
+ *
+ * The tag name lookup is case-sensitive and matches the canonical casing used
+ * in `BUILTIN_CONSTRAINT_DEFINITIONS` (e.g., `"Minimum"`, `"Pattern"`).
+ * The `@` prefix is stripped before lookup if present.
+ * Returns `null` when the tag is not a recognized FormSpec constraint tag.
+ *
+ * @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;
+//# sourceMappingURL=hover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../src/providers/hover.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAoI3D;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAc5D"}

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+/**
+ * FormSpec Language Server
+ *
+ * Sets up an LSP server connection and registers handlers for:
+ * - `textDocument/completion` — FormSpec JSDoc constraint tag completions
+ * - `textDocument/hover` — Documentation for recognized constraint tags
+ * - `textDocument/definition` — Go-to-definition (stub, returns null)
+ *
+ * Diagnostics are intentionally omitted per design decision A7.
+ */
+import { type Connection } from "vscode-languageserver/node.js";
+/**
+ * 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)
+ */
+export declare function createServer(): Connection;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +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,CAgDzC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@formspec/language-server",
+  "version": "0.1.0-alpha.11",
+  "description": "Language server for FormSpec — completions, hover, and go-to-definition for JSDoc constraint tags",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/language-server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/language-server.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "vscode-languageserver": "^9.0.1",
+    "vscode-languageserver-textdocument": "^1.0.12",
+    "@formspec/core": "0.1.0-alpha.11"
+  },
+  "devDependencies": {
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "formspec",
+    "language-server",
+    "lsp",
+    "typescript",
+    "json-schema"
+  ],
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly && api-extractor run --local",
+    "clean": "rm -rf dist temp",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "api-extractor": "api-extractor run",
+    "api-extractor:local": "api-extractor run --local",
+    "api-documenter": "api-documenter markdown -i temp -o docs"
+  }
+}