@formspec/ts-plugin 0.1.0-alpha.20

package/README.md

@@ -0,0 +1,3 @@
+# @formspec/ts-plugin
+
+TypeScript language service plugin for FormSpec semantic comment analysis.

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

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

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

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

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

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

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

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

package/dist/index.cjs

@@ -0,0 +1,453 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  init: () => init
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/service.ts
+var import_promises = __toESM(require("fs/promises"), 1);
+var import_node_net = __toESM(require("net"), 1);
+var ts = require("typescript");
+var import_analysis2 = require("@formspec/analysis");
+
+// src/workspace.ts
+var import_node_os = __toESM(require("os"), 1);
+var import_node_path = __toESM(require("path"), 1);
+var import_analysis = require("@formspec/analysis");
+function getFormSpecWorkspaceRuntimePaths(workspaceRoot, platform = process.platform, userScope = getFormSpecUserScope()) {
+  const workspaceId = (0, import_analysis.getFormSpecWorkspaceId)(workspaceRoot);
+  const runtimeDirectory = (0, import_analysis.getFormSpecWorkspaceRuntimeDirectory)(workspaceRoot);
+  const sanitizedUserScope = sanitizeScopeSegment(userScope);
+  const endpoint = platform === "win32" ? {
+    kind: "windows-pipe",
+    address: `\\\\.\\pipe\\formspec-${sanitizedUserScope}-${workspaceId}`
+  } : {
+    kind: "unix-socket",
+    address: import_node_path.default.join(import_node_os.default.tmpdir(), `formspec-${sanitizedUserScope}-${workspaceId}.sock`)
+  };
+  return {
+    workspaceRoot,
+    workspaceId,
+    runtimeDirectory,
+    manifestPath: (0, import_analysis.getFormSpecManifestPath)(workspaceRoot),
+    endpoint
+  };
+}
+function createFormSpecAnalysisManifest(workspaceRoot, typescriptVersion, generation, extensionFingerprint = "builtin") {
+  const paths = getFormSpecWorkspaceRuntimePaths(workspaceRoot);
+  return {
+    protocolVersion: import_analysis.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+    analysisSchemaVersion: import_analysis.FORMSPEC_ANALYSIS_SCHEMA_VERSION,
+    workspaceRoot,
+    workspaceId: paths.workspaceId,
+    endpoint: paths.endpoint,
+    typescriptVersion,
+    extensionFingerprint,
+    generation,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function getFormSpecUserScope() {
+  try {
+    return sanitizeScopeSegment(import_node_os.default.userInfo().username);
+  } catch {
+    return sanitizeScopeSegment(
+      process.env["USER"] ?? process.env["USERNAME"] ?? process.env["LOGNAME"] ?? "formspec"
+    );
+  }
+}
+function sanitizeScopeSegment(value) {
+  const trimmed = value.trim().toLowerCase();
+  const sanitized = trimmed.replace(/[^a-z0-9_-]+/gu, "-").replace(/-+/gu, "-");
+  return sanitized.length > 0 ? sanitized : "formspec";
+}
+
+// src/service.ts
+var FormSpecPluginService = class {
+  constructor(options) {
+    this.options = options;
+    this.runtimePaths = getFormSpecWorkspaceRuntimePaths(options.workspaceRoot);
+    this.manifest = createFormSpecAnalysisManifest(
+      options.workspaceRoot,
+      options.typescriptVersion,
+      Date.now()
+    );
+  }
+  manifest;
+  runtimePaths;
+  snapshotCache = /* @__PURE__ */ new Map();
+  refreshTimers = /* @__PURE__ */ new Map();
+  server = null;
+  getManifest() {
+    return this.manifest;
+  }
+  async start() {
+    if (this.server !== null) {
+      return;
+    }
+    await import_promises.default.mkdir(this.runtimePaths.runtimeDirectory, { recursive: true });
+    if (this.runtimePaths.endpoint.kind === "unix-socket") {
+      await import_promises.default.rm(this.runtimePaths.endpoint.address, { force: true });
+    }
+    this.server = import_node_net.default.createServer((socket) => {
+      let buffer = "";
+      socket.setEncoding("utf8");
+      socket.on("data", (chunk) => {
+        buffer += String(chunk);
+        const newlineIndex = buffer.indexOf("\n");
+        if (newlineIndex < 0) {
+          return;
+        }
+        const payload = buffer.slice(0, newlineIndex);
+        const remaining = buffer.slice(newlineIndex + 1);
+        if (remaining.trim().length > 0) {
+          this.options.logger?.info(
+            `[FormSpec] Ignoring extra semantic query payload data for ${this.runtimePaths.workspaceRoot}`
+          );
+        }
+        buffer = remaining;
+        this.respondToSocket(socket, payload);
+      });
+    });
+    await new Promise((resolve, reject) => {
+      const handleError = (error) => {
+        reject(error);
+      };
+      this.server?.once("error", handleError);
+      this.server?.listen(this.runtimePaths.endpoint.address, () => {
+        this.server?.off("error", handleError);
+        resolve();
+      });
+    });
+    await this.writeManifest();
+  }
+  async stop() {
+    for (const timer of this.refreshTimers.values()) {
+      clearTimeout(timer);
+    }
+    this.refreshTimers.clear();
+    this.snapshotCache.clear();
+    const server = this.server;
+    this.server = null;
+    if (server?.listening === true) {
+      await new Promise((resolve, reject) => {
+        server.close((error) => {
+          if (error === void 0) {
+            resolve();
+            return;
+          }
+          reject(error);
+        });
+      });
+    }
+    await this.cleanupRuntimeArtifacts();
+  }
+  scheduleSnapshotRefresh(filePath) {
+    const existing = this.refreshTimers.get(filePath);
+    if (existing !== void 0) {
+      clearTimeout(existing);
+    }
+    const timer = setTimeout(() => {
+      try {
+        this.getFileSnapshot(filePath);
+      } catch (error) {
+        this.options.logger?.info(
+          `[FormSpec] Failed to refresh semantic snapshot for ${filePath}: ${String(error)}`
+        );
+      }
+      this.refreshTimers.delete(filePath);
+    }, this.options.snapshotDebounceMs ?? 250);
+    this.refreshTimers.set(filePath, timer);
+  }
+  handleQuery(query) {
+    switch (query.kind) {
+      case "health":
+        return {
+          protocolVersion: import_analysis2.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+          kind: "health",
+          manifest: this.manifest
+        };
+      case "completion": {
+        const environment = this.getSourceEnvironment(query.filePath);
+        if (environment === null) {
+          return {
+            protocolVersion: import_analysis2.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+            kind: "error",
+            error: `Unable to resolve TypeScript source file for ${query.filePath}`
+          };
+        }
+        const declaration = (0, import_analysis2.findDeclarationForCommentOffset)(environment.sourceFile, query.offset);
+        const placement = declaration === null ? null : (0, import_analysis2.resolveDeclarationPlacement)(declaration);
+        const subjectType = declaration === null ? void 0 : (0, import_analysis2.getSubjectType)(declaration, environment.checker);
+        const context = (0, import_analysis2.getSemanticCommentCompletionContextAtOffset)(
+          environment.sourceFile.text,
+          query.offset,
+          {
+            checker: environment.checker,
+            ...placement === null ? {} : { placement },
+            ...subjectType === void 0 ? {} : { subjectType }
+          }
+        );
+        return {
+          protocolVersion: import_analysis2.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+          kind: "completion",
+          sourceHash: (0, import_analysis2.computeFormSpecTextHash)(environment.sourceFile.text),
+          context: (0, import_analysis2.serializeCompletionContext)(context)
+        };
+      }
+      case "hover": {
+        const environment = this.getSourceEnvironment(query.filePath);
+        if (environment === null) {
+          return {
+            protocolVersion: import_analysis2.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+            kind: "error",
+            error: `Unable to resolve TypeScript source file for ${query.filePath}`
+          };
+        }
+        const declaration = (0, import_analysis2.findDeclarationForCommentOffset)(environment.sourceFile, query.offset);
+        const placement = declaration === null ? null : (0, import_analysis2.resolveDeclarationPlacement)(declaration);
+        const subjectType = declaration === null ? void 0 : (0, import_analysis2.getSubjectType)(declaration, environment.checker);
+        const hover = (0, import_analysis2.getCommentHoverInfoAtOffset)(environment.sourceFile.text, query.offset, {
+          checker: environment.checker,
+          ...placement === null ? {} : { placement },
+          ...subjectType === void 0 ? {} : { subjectType }
+        });
+        return {
+          protocolVersion: import_analysis2.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+          kind: "hover",
+          sourceHash: (0, import_analysis2.computeFormSpecTextHash)(environment.sourceFile.text),
+          hover: (0, import_analysis2.serializeHoverInfo)(hover)
+        };
+      }
+      case "diagnostics": {
+        const snapshot = this.getFileSnapshot(query.filePath);
+        return {
+          protocolVersion: import_analysis2.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+          kind: "diagnostics",
+          sourceHash: snapshot.sourceHash,
+          diagnostics: snapshot.diagnostics
+        };
+      }
+      case "file-snapshot":
+        return {
+          protocolVersion: import_analysis2.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+          kind: "file-snapshot",
+          snapshot: this.getFileSnapshot(query.filePath)
+        };
+      default: {
+        throw new Error(`Unhandled semantic query: ${JSON.stringify(query)}`);
+      }
+    }
+  }
+  respondToSocket(socket, payload) {
+    try {
+      const query = JSON.parse(payload);
+      if (!(0, import_analysis2.isFormSpecSemanticQuery)(query)) {
+        throw new Error("Invalid FormSpec semantic query payload");
+      }
+      const response = this.handleQuery(query);
+      socket.end(`${JSON.stringify(response)}
+`);
+    } catch (error) {
+      socket.end(
+        `${JSON.stringify({
+          protocolVersion: import_analysis2.FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+          kind: "error",
+          error: error instanceof Error ? error.message : String(error)
+        })}
+`
+      );
+    }
+  }
+  async writeManifest() {
+    const tempManifestPath = `${this.runtimePaths.manifestPath}.tmp`;
+    await import_promises.default.writeFile(tempManifestPath, `${JSON.stringify(this.manifest, null, 2)}
+`, "utf8");
+    await import_promises.default.rename(tempManifestPath, this.runtimePaths.manifestPath);
+  }
+  async cleanupRuntimeArtifacts() {
+    await import_promises.default.rm(this.runtimePaths.manifestPath, { force: true });
+    if (this.runtimePaths.endpoint.kind === "unix-socket") {
+      await import_promises.default.rm(this.runtimePaths.endpoint.address, { force: true });
+    }
+  }
+  getSourceEnvironment(filePath) {
+    const program = this.options.getProgram();
+    if (program === void 0) {
+      return null;
+    }
+    const sourceFile = program.getSourceFile(filePath);
+    if (sourceFile === void 0) {
+      return null;
+    }
+    return {
+      sourceFile,
+      checker: program.getTypeChecker()
+    };
+  }
+  getFileSnapshot(filePath) {
+    const environment = this.getSourceEnvironment(filePath);
+    if (environment === null) {
+      return {
+        filePath,
+        sourceHash: "",
+        generatedAt: this.getNow().toISOString(),
+        comments: [],
+        diagnostics: [
+          {
+            code: "MISSING_SOURCE_FILE",
+            message: `Unable to resolve TypeScript source file for ${filePath}`,
+            range: { start: 0, end: 0 },
+            severity: "warning"
+          }
+        ]
+      };
+    }
+    const sourceHash = (0, import_analysis2.computeFormSpecTextHash)(environment.sourceFile.text);
+    const cached = this.snapshotCache.get(filePath);
+    if (cached?.sourceHash === sourceHash) {
+      return cached.snapshot;
+    }
+    const snapshot = (0, import_analysis2.buildFormSpecAnalysisFileSnapshot)(environment.sourceFile, {
+      checker: environment.checker
+    });
+    this.snapshotCache.set(filePath, {
+      sourceHash,
+      snapshot
+    });
+    return snapshot;
+  }
+  getNow() {
+    return this.options.now?.() ?? /* @__PURE__ */ new Date();
+  }
+};
+function createLanguageServiceProxy(languageService, semanticService) {
+  const wrapWithSnapshotRefresh = (fn) => {
+    return (fileName, ...args) => {
+      semanticService.scheduleSnapshotRefresh(fileName);
+      return fn(fileName, ...args);
+    };
+  };
+  const getSemanticDiagnostics = wrapWithSnapshotRefresh(
+    (fileName) => languageService.getSemanticDiagnostics(fileName)
+  );
+  const getCompletionsAtPosition = wrapWithSnapshotRefresh(
+    (fileName, position, options) => languageService.getCompletionsAtPosition(fileName, position, options)
+  );
+  const getQuickInfoAtPosition = wrapWithSnapshotRefresh(
+    (fileName, position) => languageService.getQuickInfoAtPosition(fileName, position)
+  );
+  return new Proxy(languageService, {
+    get(target, property, receiver) {
+      switch (property) {
+        case "getSemanticDiagnostics":
+          return getSemanticDiagnostics;
+        case "getCompletionsAtPosition":
+          return getCompletionsAtPosition;
+        case "getQuickInfoAtPosition":
+          return getQuickInfoAtPosition;
+        default:
+          return Reflect.get(target, property, receiver);
+      }
+    }
+  });
+}
+
+// src/index.ts
+var services = /* @__PURE__ */ new Map();
+function formatPluginError(error) {
+  return error instanceof Error ? error.stack ?? error.message : String(error);
+}
+function getOrCreateService(info, typescriptVersion) {
+  const workspaceRoot = info.project.getCurrentDirectory();
+  const existing = services.get(workspaceRoot);
+  if (existing !== void 0) {
+    existing.referenceCount += 1;
+    attachProjectCloseHandler(info, workspaceRoot, existing);
+    return existing.service;
+  }
+  const service = new FormSpecPluginService({
+    workspaceRoot,
+    typescriptVersion,
+    getProgram: () => info.languageService.getProgram(),
+    logger: info.project.projectService.logger
+  });
+  const serviceEntry = {
+    service,
+    referenceCount: 1
+  };
+  attachProjectCloseHandler(info, workspaceRoot, serviceEntry);
+  service.start().catch((error) => {
+    info.project.projectService.logger.info(
+      `[FormSpec] Plugin service failed to start for ${workspaceRoot}: ${formatPluginError(error)}`
+    );
+    services.delete(workspaceRoot);
+  });
+  services.set(workspaceRoot, serviceEntry);
+  return service;
+}
+function attachProjectCloseHandler(info, workspaceRoot, serviceEntry) {
+  const originalClose = info.project.close.bind(info.project);
+  let closed = false;
+  info.project.close = () => {
+    if (closed) {
+      originalClose();
+      return;
+    }
+    closed = true;
+    serviceEntry.referenceCount -= 1;
+    if (serviceEntry.referenceCount <= 0) {
+      services.delete(workspaceRoot);
+      void serviceEntry.service.stop().catch((error) => {
+        info.project.projectService.logger.info(
+          `[FormSpec] Failed to stop plugin service for ${workspaceRoot}: ${formatPluginError(error)}`
+        );
+      });
+    }
+    originalClose();
+  };
+}
+function init(modules) {
+  const typescriptVersion = modules.typescript.version;
+  return {
+    create(info) {
+      const service = getOrCreateService(info, typescriptVersion);
+      return createLanguageServiceProxy(info.languageService, service);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  init
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/service.ts","../src/workspace.ts"],"sourcesContent":["import type * as tsServer from \"typescript/lib/tsserverlibrary.js\";\nimport { createLanguageServiceProxy, FormSpecPluginService } from \"./service.js\";\n\ninterface ServiceEntry {\n  readonly service: FormSpecPluginService;\n  referenceCount: number;\n}\n\nconst services = new Map<string, ServiceEntry>();\n\nfunction formatPluginError(error: unknown): string {\n  return error instanceof Error ? (error.stack ?? error.message) : String(error);\n}\n\nfunction getOrCreateService(\n  info: tsServer.server.PluginCreateInfo,\n  typescriptVersion: string\n): FormSpecPluginService {\n  const workspaceRoot = info.project.getCurrentDirectory();\n  const existing = services.get(workspaceRoot);\n  if (existing !== undefined) {\n    existing.referenceCount += 1;\n    attachProjectCloseHandler(info, workspaceRoot, existing);\n    return existing.service;\n  }\n\n  const service = new FormSpecPluginService({\n    workspaceRoot,\n    typescriptVersion,\n    getProgram: () => info.languageService.getProgram(),\n    logger: info.project.projectService.logger,\n  });\n\n  const serviceEntry: ServiceEntry = {\n    service,\n    referenceCount: 1,\n  };\n  attachProjectCloseHandler(info, workspaceRoot, serviceEntry);\n\n  service.start().catch((error: unknown) => {\n    info.project.projectService.logger.info(\n      `[FormSpec] Plugin service failed to start for ${workspaceRoot}: ${formatPluginError(error)}`\n    );\n    services.delete(workspaceRoot);\n  });\n  services.set(workspaceRoot, serviceEntry);\n  return service;\n}\n\nfunction attachProjectCloseHandler(\n  info: tsServer.server.PluginCreateInfo,\n  workspaceRoot: string,\n  serviceEntry: ServiceEntry\n): void {\n  const originalClose = info.project.close.bind(info.project);\n  let closed = false;\n\n  info.project.close = () => {\n    if (closed) {\n      originalClose();\n      return;\n    }\n\n    closed = true;\n    serviceEntry.referenceCount -= 1;\n    if (serviceEntry.referenceCount <= 0) {\n      services.delete(workspaceRoot);\n      void serviceEntry.service.stop().catch((error: unknown) => {\n        info.project.projectService.logger.info(\n          `[FormSpec] Failed to stop plugin service for ${workspaceRoot}: ${formatPluginError(error)}`\n        );\n      });\n    }\n    originalClose();\n  };\n}\n\n/**\n * Initializes the FormSpec TypeScript language service plugin.\n *\n * @public\n */\nexport function init(modules: {\n  readonly typescript: typeof tsServer;\n}): tsServer.server.PluginModule {\n  const typescriptVersion = modules.typescript.version;\n  return {\n    create(info) {\n      const service = getOrCreateService(info, typescriptVersion);\n      return createLanguageServiceProxy(info.languageService, service);\n    },\n  };\n}\n","import fs from \"node:fs/promises\";\nimport net from \"node:net\";\nimport * as ts from \"typescript\";\nimport {\n  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n  buildFormSpecAnalysisFileSnapshot,\n  computeFormSpecTextHash,\n  findDeclarationForCommentOffset,\n  getSubjectType,\n  getCommentHoverInfoAtOffset,\n  getSemanticCommentCompletionContextAtOffset,\n  isFormSpecSemanticQuery,\n  resolveDeclarationPlacement,\n  serializeCompletionContext,\n  serializeHoverInfo,\n  type BuildFormSpecAnalysisFileSnapshotOptions,\n  type FormSpecAnalysisFileSnapshot,\n  type FormSpecAnalysisManifest,\n  type FormSpecSemanticQuery,\n  type FormSpecSemanticResponse,\n} from \"@formspec/analysis\";\nimport {\n  createFormSpecAnalysisManifest,\n  getFormSpecWorkspaceRuntimePaths,\n  type FormSpecWorkspaceRuntimePaths,\n} from \"./workspace.js\";\n\ninterface LoggerLike {\n  info(message: string): void;\n}\n\nexport interface FormSpecPluginServiceOptions {\n  readonly workspaceRoot: string;\n  readonly typescriptVersion: string;\n  readonly getProgram: () => ts.Program | undefined;\n  readonly logger?: LoggerLike;\n  readonly snapshotDebounceMs?: number;\n  readonly now?: () => Date;\n}\n\ninterface CachedFileSnapshot {\n  readonly sourceHash: string;\n  readonly snapshot: FormSpecAnalysisFileSnapshot;\n}\n\nexport class FormSpecPluginService {\n  private readonly manifest: FormSpecAnalysisManifest;\n  private readonly runtimePaths: FormSpecWorkspaceRuntimePaths;\n  private readonly snapshotCache = new Map<string, CachedFileSnapshot>();\n  private readonly refreshTimers = new Map<string, NodeJS.Timeout>();\n  private server: net.Server | null = null;\n\n  public constructor(private readonly options: FormSpecPluginServiceOptions) {\n    this.runtimePaths = getFormSpecWorkspaceRuntimePaths(options.workspaceRoot);\n    this.manifest = createFormSpecAnalysisManifest(\n      options.workspaceRoot,\n      options.typescriptVersion,\n      Date.now()\n    );\n  }\n\n  public getManifest(): FormSpecAnalysisManifest {\n    return this.manifest;\n  }\n\n  public async start(): Promise<void> {\n    if (this.server !== null) {\n      return;\n    }\n\n    await fs.mkdir(this.runtimePaths.runtimeDirectory, { recursive: true });\n    if (this.runtimePaths.endpoint.kind === \"unix-socket\") {\n      await fs.rm(this.runtimePaths.endpoint.address, { force: true });\n    }\n\n    this.server = net.createServer((socket) => {\n      let buffer = \"\";\n      socket.setEncoding(\"utf8\");\n      socket.on(\"data\", (chunk) => {\n        buffer += String(chunk);\n        const newlineIndex = buffer.indexOf(\"\\n\");\n        if (newlineIndex < 0) {\n          return;\n        }\n\n        const payload = buffer.slice(0, newlineIndex);\n        const remaining = buffer.slice(newlineIndex + 1);\n        if (remaining.trim().length > 0) {\n          this.options.logger?.info(\n            `[FormSpec] Ignoring extra semantic query payload data for ${this.runtimePaths.workspaceRoot}`\n          );\n        }\n        buffer = remaining;\n        // The FormSpec IPC transport is intentionally one-request-per-connection.\n        this.respondToSocket(socket, payload);\n      });\n    });\n\n    await new Promise<void>((resolve, reject) => {\n      const handleError = (error: Error) => {\n        reject(error);\n      };\n      this.server?.once(\"error\", handleError);\n      this.server?.listen(this.runtimePaths.endpoint.address, () => {\n        this.server?.off(\"error\", handleError);\n        resolve();\n      });\n    });\n\n    await this.writeManifest();\n  }\n\n  public async stop(): Promise<void> {\n    for (const timer of this.refreshTimers.values()) {\n      clearTimeout(timer);\n    }\n    this.refreshTimers.clear();\n    this.snapshotCache.clear();\n\n    const server = this.server;\n    this.server = null;\n    if (server?.listening === true) {\n      await new Promise<void>((resolve, reject) => {\n        server.close((error) => {\n          if (error === undefined) {\n            resolve();\n            return;\n          }\n          reject(error);\n        });\n      });\n    }\n\n    await this.cleanupRuntimeArtifacts();\n  }\n\n  public scheduleSnapshotRefresh(filePath: string): void {\n    const existing = this.refreshTimers.get(filePath);\n    if (existing !== undefined) {\n      clearTimeout(existing);\n    }\n\n    const timer = setTimeout(() => {\n      try {\n        this.getFileSnapshot(filePath);\n      } catch (error: unknown) {\n        this.options.logger?.info(\n          `[FormSpec] Failed to refresh semantic snapshot for ${filePath}: ${String(error)}`\n        );\n      }\n      this.refreshTimers.delete(filePath);\n    }, this.options.snapshotDebounceMs ?? 250);\n\n    this.refreshTimers.set(filePath, timer);\n  }\n\n  public handleQuery(query: FormSpecSemanticQuery): FormSpecSemanticResponse {\n    switch (query.kind) {\n      case \"health\":\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"health\",\n          manifest: this.manifest,\n        };\n      case \"completion\": {\n        const environment = this.getSourceEnvironment(query.filePath);\n        if (environment === null) {\n          return {\n            protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n            kind: \"error\",\n            error: `Unable to resolve TypeScript source file for ${query.filePath}`,\n          };\n        }\n\n        const declaration = findDeclarationForCommentOffset(environment.sourceFile, query.offset);\n        const placement = declaration === null ? null : resolveDeclarationPlacement(declaration);\n        const subjectType =\n          declaration === null ? undefined : getSubjectType(declaration, environment.checker);\n        const context = getSemanticCommentCompletionContextAtOffset(\n          environment.sourceFile.text,\n          query.offset,\n          {\n            checker: environment.checker,\n            ...(placement === null ? {} : { placement }),\n            ...(subjectType === undefined ? {} : { subjectType }),\n          }\n        );\n\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"completion\",\n          sourceHash: computeFormSpecTextHash(environment.sourceFile.text),\n          context: serializeCompletionContext(context),\n        };\n      }\n      case \"hover\": {\n        const environment = this.getSourceEnvironment(query.filePath);\n        if (environment === null) {\n          return {\n            protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n            kind: \"error\",\n            error: `Unable to resolve TypeScript source file for ${query.filePath}`,\n          };\n        }\n\n        const declaration = findDeclarationForCommentOffset(environment.sourceFile, query.offset);\n        const placement = declaration === null ? null : resolveDeclarationPlacement(declaration);\n        const subjectType =\n          declaration === null ? undefined : getSubjectType(declaration, environment.checker);\n        const hover = getCommentHoverInfoAtOffset(environment.sourceFile.text, query.offset, {\n          checker: environment.checker,\n          ...(placement === null ? {} : { placement }),\n          ...(subjectType === undefined ? {} : { subjectType }),\n        });\n\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"hover\",\n          sourceHash: computeFormSpecTextHash(environment.sourceFile.text),\n          hover: serializeHoverInfo(hover),\n        };\n      }\n      case \"diagnostics\": {\n        const snapshot = this.getFileSnapshot(query.filePath);\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"diagnostics\",\n          sourceHash: snapshot.sourceHash,\n          diagnostics: snapshot.diagnostics,\n        };\n      }\n      case \"file-snapshot\":\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"file-snapshot\",\n          snapshot: this.getFileSnapshot(query.filePath),\n        };\n      default: {\n        throw new Error(`Unhandled semantic query: ${JSON.stringify(query)}`);\n      }\n    }\n  }\n\n  private respondToSocket(socket: net.Socket, payload: string): void {\n    try {\n      const query = JSON.parse(payload) as unknown;\n      if (!isFormSpecSemanticQuery(query)) {\n        throw new Error(\"Invalid FormSpec semantic query payload\");\n      }\n      const response = this.handleQuery(query);\n      socket.end(`${JSON.stringify(response)}\\n`);\n    } catch (error) {\n      socket.end(\n        `${JSON.stringify({\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"error\",\n          error: error instanceof Error ? error.message : String(error),\n        } satisfies FormSpecSemanticResponse)}\\n`\n      );\n    }\n  }\n\n  private async writeManifest(): Promise<void> {\n    const tempManifestPath = `${this.runtimePaths.manifestPath}.tmp`;\n    await fs.writeFile(tempManifestPath, `${JSON.stringify(this.manifest, null, 2)}\\n`, \"utf8\");\n    await fs.rename(tempManifestPath, this.runtimePaths.manifestPath);\n  }\n\n  private async cleanupRuntimeArtifacts(): Promise<void> {\n    await fs.rm(this.runtimePaths.manifestPath, { force: true });\n    if (this.runtimePaths.endpoint.kind === \"unix-socket\") {\n      await fs.rm(this.runtimePaths.endpoint.address, { force: true });\n    }\n  }\n\n  private getSourceEnvironment(filePath: string): {\n    readonly sourceFile: ts.SourceFile;\n    readonly checker: ts.TypeChecker;\n  } | null {\n    const program = this.options.getProgram();\n    if (program === undefined) {\n      return null;\n    }\n\n    const sourceFile = program.getSourceFile(filePath);\n    if (sourceFile === undefined) {\n      return null;\n    }\n\n    return {\n      sourceFile,\n      checker: program.getTypeChecker(),\n    };\n  }\n\n  private getFileSnapshot(filePath: string): FormSpecAnalysisFileSnapshot {\n    const environment = this.getSourceEnvironment(filePath);\n    if (environment === null) {\n      return {\n        filePath,\n        sourceHash: \"\",\n        generatedAt: this.getNow().toISOString(),\n        comments: [],\n        diagnostics: [\n          {\n            code: \"MISSING_SOURCE_FILE\",\n            message: `Unable to resolve TypeScript source file for ${filePath}`,\n            range: { start: 0, end: 0 },\n            severity: \"warning\",\n          },\n        ],\n      };\n    }\n\n    const sourceHash = computeFormSpecTextHash(environment.sourceFile.text);\n    const cached = this.snapshotCache.get(filePath);\n    if (cached?.sourceHash === sourceHash) {\n      return cached.snapshot;\n    }\n\n    const snapshot = buildFormSpecAnalysisFileSnapshot(environment.sourceFile, {\n      checker: environment.checker,\n    } satisfies BuildFormSpecAnalysisFileSnapshotOptions);\n    this.snapshotCache.set(filePath, {\n      sourceHash,\n      snapshot,\n    });\n    return snapshot;\n  }\n\n  private getNow(): Date {\n    return this.options.now?.() ?? new Date();\n  }\n}\n\nexport function createLanguageServiceProxy(\n  languageService: ts.LanguageService,\n  semanticService: FormSpecPluginService\n): ts.LanguageService {\n  const wrapWithSnapshotRefresh = <Args extends readonly unknown[], Result>(\n    fn: (fileName: string, ...args: Args) => Result\n  ) => {\n    return (fileName: string, ...args: Args): Result => {\n      semanticService.scheduleSnapshotRefresh(fileName);\n      return fn(fileName, ...args);\n    };\n  };\n\n  // The plugin keeps semantic snapshots fresh for the lightweight LSP. The\n  // underlying tsserver results still come from the original language service.\n  const getSemanticDiagnostics = wrapWithSnapshotRefresh((fileName) =>\n    languageService.getSemanticDiagnostics(fileName)\n  );\n\n  const getCompletionsAtPosition = wrapWithSnapshotRefresh(\n    (fileName: string, position: number, options: ts.GetCompletionsAtPositionOptions | undefined) =>\n      languageService.getCompletionsAtPosition(fileName, position, options)\n  );\n\n  const getQuickInfoAtPosition = wrapWithSnapshotRefresh((fileName, position: number) =>\n    languageService.getQuickInfoAtPosition(fileName, position)\n  );\n\n  return new Proxy(languageService, {\n    get(target, property, receiver) {\n      switch (property) {\n        case \"getSemanticDiagnostics\":\n          return getSemanticDiagnostics;\n        case \"getCompletionsAtPosition\":\n          return getCompletionsAtPosition;\n        case \"getQuickInfoAtPosition\":\n          return getQuickInfoAtPosition;\n        default:\n          return Reflect.get(target, property, receiver) as unknown;\n      }\n    },\n  });\n}\n","import os from \"node:os\";\nimport path from \"node:path\";\nimport {\n  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n  FORMSPEC_ANALYSIS_SCHEMA_VERSION,\n  getFormSpecManifestPath,\n  getFormSpecWorkspaceId,\n  getFormSpecWorkspaceRuntimeDirectory,\n  type FormSpecAnalysisManifest,\n  type FormSpecIpcEndpoint,\n} from \"@formspec/analysis\";\n\nexport interface FormSpecWorkspaceRuntimePaths {\n  readonly workspaceRoot: string;\n  readonly workspaceId: string;\n  readonly runtimeDirectory: string;\n  readonly manifestPath: string;\n  readonly endpoint: FormSpecIpcEndpoint;\n}\n\nexport function getFormSpecWorkspaceRuntimePaths(\n  workspaceRoot: string,\n  platform = process.platform,\n  userScope = getFormSpecUserScope()\n): FormSpecWorkspaceRuntimePaths {\n  const workspaceId = getFormSpecWorkspaceId(workspaceRoot);\n  const runtimeDirectory = getFormSpecWorkspaceRuntimeDirectory(workspaceRoot);\n  const sanitizedUserScope = sanitizeScopeSegment(userScope);\n  const endpoint: FormSpecIpcEndpoint =\n    platform === \"win32\"\n      ? {\n          kind: \"windows-pipe\",\n          address: `\\\\\\\\.\\\\pipe\\\\formspec-${sanitizedUserScope}-${workspaceId}`,\n        }\n      : {\n          kind: \"unix-socket\",\n          address: path.join(os.tmpdir(), `formspec-${sanitizedUserScope}-${workspaceId}.sock`),\n        };\n\n  return {\n    workspaceRoot,\n    workspaceId,\n    runtimeDirectory,\n    manifestPath: getFormSpecManifestPath(workspaceRoot),\n    endpoint,\n  };\n}\n\nexport function createFormSpecAnalysisManifest(\n  workspaceRoot: string,\n  typescriptVersion: string,\n  generation: number,\n  extensionFingerprint = \"builtin\"\n): FormSpecAnalysisManifest {\n  const paths = getFormSpecWorkspaceRuntimePaths(workspaceRoot);\n  return {\n    protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n    analysisSchemaVersion: FORMSPEC_ANALYSIS_SCHEMA_VERSION,\n    workspaceRoot,\n    workspaceId: paths.workspaceId,\n    endpoint: paths.endpoint,\n    typescriptVersion,\n    extensionFingerprint,\n    generation,\n    updatedAt: new Date().toISOString(),\n  };\n}\n\nfunction getFormSpecUserScope(): string {\n  try {\n    return sanitizeScopeSegment(os.userInfo().username);\n  } catch {\n    return sanitizeScopeSegment(\n      process.env[\"USER\"] ?? process.env[\"USERNAME\"] ?? process.env[\"LOGNAME\"] ?? \"formspec\"\n    );\n  }\n}\n\nfunction sanitizeScopeSegment(value: string): string {\n  const trimmed = value.trim().toLowerCase();\n  const sanitized = trimmed.replace(/[^a-z0-9_-]+/gu, \"-\").replace(/-+/gu, \"-\");\n  return sanitized.length > 0 ? sanitized : \"formspec\";\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,sBAAe;AACf,sBAAgB;AAChB,SAAoB;AACpB,IAAAA,mBAiBO;;;ACpBP,qBAAe;AACf,uBAAiB;AACjB,sBAQO;AAUA,SAAS,iCACd,eACA,WAAW,QAAQ,UACnB,YAAY,qBAAqB,GACF;AAC/B,QAAM,kBAAc,wCAAuB,aAAa;AACxD,QAAM,uBAAmB,sDAAqC,aAAa;AAC3E,QAAM,qBAAqB,qBAAqB,SAAS;AACzD,QAAM,WACJ,aAAa,UACT;AAAA,IACE,MAAM;AAAA,IACN,SAAS,yBAAyB,kBAAkB,IAAI,WAAW;AAAA,EACrE,IACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS,iBAAAC,QAAK,KAAK,eAAAC,QAAG,OAAO,GAAG,YAAY,kBAAkB,IAAI,WAAW,OAAO;AAAA,EACtF;AAEN,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,kBAAc,yCAAwB,aAAa;AAAA,IACnD;AAAA,EACF;AACF;AAEO,SAAS,+BACd,eACA,mBACA,YACA,uBAAuB,WACG;AAC1B,QAAM,QAAQ,iCAAiC,aAAa;AAC5D,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,uBAAuB;AAAA,IACvB;AAAA,IACA,aAAa,MAAM;AAAA,IACnB,UAAU,MAAM;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AACF;AAEA,SAAS,uBAA+B;AACtC,MAAI;AACF,WAAO,qBAAqB,eAAAA,QAAG,SAAS,EAAE,QAAQ;AAAA,EACpD,QAAQ;AACN,WAAO;AAAA,MACL,QAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI,UAAU,KAAK,QAAQ,IAAI,SAAS,KAAK;AAAA,IAC9E;AAAA,EACF;AACF;AAEA,SAAS,qBAAqB,OAAuB;AACnD,QAAM,UAAU,MAAM,KAAK,EAAE,YAAY;AACzC,QAAM,YAAY,QAAQ,QAAQ,kBAAkB,GAAG,EAAE,QAAQ,QAAQ,GAAG;AAC5E,SAAO,UAAU,SAAS,IAAI,YAAY;AAC5C;;;ADrCO,IAAM,wBAAN,MAA4B;AAAA,EAO1B,YAA6B,SAAuC;AAAvC;AAClC,SAAK,eAAe,iCAAiC,QAAQ,aAAa;AAC1E,SAAK,WAAW;AAAA,MACd,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,KAAK,IAAI;AAAA,IACX;AAAA,EACF;AAAA,EAbiB;AAAA,EACA;AAAA,EACA,gBAAgB,oBAAI,IAAgC;AAAA,EACpD,gBAAgB,oBAAI,IAA4B;AAAA,EACzD,SAA4B;AAAA,EAW7B,cAAwC;AAC7C,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAa,QAAuB;AAClC,QAAI,KAAK,WAAW,MAAM;AACxB;AAAA,IACF;AAEA,UAAM,gBAAAC,QAAG,MAAM,KAAK,aAAa,kBAAkB,EAAE,WAAW,KAAK,CAAC;AACtE,QAAI,KAAK,aAAa,SAAS,SAAS,eAAe;AACrD,YAAM,gBAAAA,QAAG,GAAG,KAAK,aAAa,SAAS,SAAS,EAAE,OAAO,KAAK,CAAC;AAAA,IACjE;AAEA,SAAK,SAAS,gBAAAC,QAAI,aAAa,CAAC,WAAW;AACzC,UAAI,SAAS;AACb,aAAO,YAAY,MAAM;AACzB,aAAO,GAAG,QAAQ,CAAC,UAAU;AAC3B,kBAAU,OAAO,KAAK;AACtB,cAAM,eAAe,OAAO,QAAQ,IAAI;AACxC,YAAI,eAAe,GAAG;AACpB;AAAA,QACF;AAEA,cAAM,UAAU,OAAO,MAAM,GAAG,YAAY;AAC5C,cAAM,YAAY,OAAO,MAAM,eAAe,CAAC;AAC/C,YAAI,UAAU,KAAK,EAAE,SAAS,GAAG;AAC/B,eAAK,QAAQ,QAAQ;AAAA,YACnB,6DAA6D,KAAK,aAAa,aAAa;AAAA,UAC9F;AAAA,QACF;AACA,iBAAS;AAET,aAAK,gBAAgB,QAAQ,OAAO;AAAA,MACtC,CAAC;AAAA,IACH,CAAC;AAED,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,YAAM,cAAc,CAAC,UAAiB;AACpC,eAAO,KAAK;AAAA,MACd;AACA,WAAK,QAAQ,KAAK,SAAS,WAAW;AACtC,WAAK,QAAQ,OAAO,KAAK,aAAa,SAAS,SAAS,MAAM;AAC5D,aAAK,QAAQ,IAAI,SAAS,WAAW;AACrC,gBAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AAED,UAAM,KAAK,cAAc;AAAA,EAC3B;AAAA,EAEA,MAAa,OAAsB;AACjC,eAAW,SAAS,KAAK,cAAc,OAAO,GAAG;AAC/C,mBAAa,KAAK;AAAA,IACpB;AACA,SAAK,cAAc,MAAM;AACzB,SAAK,cAAc,MAAM;AAEzB,UAAM,SAAS,KAAK;AACpB,SAAK,SAAS;AACd,QAAI,QAAQ,cAAc,MAAM;AAC9B,YAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,eAAO,MAAM,CAAC,UAAU;AACtB,cAAI,UAAU,QAAW;AACvB,oBAAQ;AACR;AAAA,UACF;AACA,iBAAO,KAAK;AAAA,QACd,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAEA,UAAM,KAAK,wBAAwB;AAAA,EACrC;AAAA,EAEO,wBAAwB,UAAwB;AACrD,UAAM,WAAW,KAAK,cAAc,IAAI,QAAQ;AAChD,QAAI,aAAa,QAAW;AAC1B,mBAAa,QAAQ;AAAA,IACvB;AAEA,UAAM,QAAQ,WAAW,MAAM;AAC7B,UAAI;AACF,aAAK,gBAAgB,QAAQ;AAAA,MAC/B,SAAS,OAAgB;AACvB,aAAK,QAAQ,QAAQ;AAAA,UACnB,sDAAsD,QAAQ,KAAK,OAAO,KAAK,CAAC;AAAA,QAClF;AAAA,MACF;AACA,WAAK,cAAc,OAAO,QAAQ;AAAA,IACpC,GAAG,KAAK,QAAQ,sBAAsB,GAAG;AAEzC,SAAK,cAAc,IAAI,UAAU,KAAK;AAAA,EACxC;AAAA,EAEO,YAAY,OAAwD;AACzE,YAAQ,MAAM,MAAM;AAAA,MAClB,KAAK;AACH,eAAO;AAAA,UACL,iBAAiB;AAAA,UACjB,MAAM;AAAA,UACN,UAAU,KAAK;AAAA,QACjB;AAAA,MACF,KAAK,cAAc;AACjB,cAAM,cAAc,KAAK,qBAAqB,MAAM,QAAQ;AAC5D,YAAI,gBAAgB,MAAM;AACxB,iBAAO;AAAA,YACL,iBAAiB;AAAA,YACjB,MAAM;AAAA,YACN,OAAO,gDAAgD,MAAM,QAAQ;AAAA,UACvE;AAAA,QACF;AAEA,cAAM,kBAAc,kDAAgC,YAAY,YAAY,MAAM,MAAM;AACxF,cAAM,YAAY,gBAAgB,OAAO,WAAO,8CAA4B,WAAW;AACvF,cAAM,cACJ,gBAAgB,OAAO,aAAY,iCAAe,aAAa,YAAY,OAAO;AACpF,cAAM,cAAU;AAAA,UACd,YAAY,WAAW;AAAA,UACvB,MAAM;AAAA,UACN;AAAA,YACE,SAAS,YAAY;AAAA,YACrB,GAAI,cAAc,OAAO,CAAC,IAAI,EAAE,UAAU;AAAA,YAC1C,GAAI,gBAAgB,SAAY,CAAC,IAAI,EAAE,YAAY;AAAA,UACrD;AAAA,QACF;AAEA,eAAO;AAAA,UACL,iBAAiB;AAAA,UACjB,MAAM;AAAA,UACN,gBAAY,0CAAwB,YAAY,WAAW,IAAI;AAAA,UAC/D,aAAS,6CAA2B,OAAO;AAAA,QAC7C;AAAA,MACF;AAAA,MACA,KAAK,SAAS;AACZ,cAAM,cAAc,KAAK,qBAAqB,MAAM,QAAQ;AAC5D,YAAI,gBAAgB,MAAM;AACxB,iBAAO;AAAA,YACL,iBAAiB;AAAA,YACjB,MAAM;AAAA,YACN,OAAO,gDAAgD,MAAM,QAAQ;AAAA,UACvE;AAAA,QACF;AAEA,cAAM,kBAAc,kDAAgC,YAAY,YAAY,MAAM,MAAM;AACxF,cAAM,YAAY,gBAAgB,OAAO,WAAO,8CAA4B,WAAW;AACvF,cAAM,cACJ,gBAAgB,OAAO,aAAY,iCAAe,aAAa,YAAY,OAAO;AACpF,cAAM,YAAQ,8CAA4B,YAAY,WAAW,MAAM,MAAM,QAAQ;AAAA,UACnF,SAAS,YAAY;AAAA,UACrB,GAAI,cAAc,OAAO,CAAC,IAAI,EAAE,UAAU;AAAA,UAC1C,GAAI,gBAAgB,SAAY,CAAC,IAAI,EAAE,YAAY;AAAA,QACrD,CAAC;AAED,eAAO;AAAA,UACL,iBAAiB;AAAA,UACjB,MAAM;AAAA,UACN,gBAAY,0CAAwB,YAAY,WAAW,IAAI;AAAA,UAC/D,WAAO,qCAAmB,KAAK;AAAA,QACjC;AAAA,MACF;AAAA,MACA,KAAK,eAAe;AAClB,cAAM,WAAW,KAAK,gBAAgB,MAAM,QAAQ;AACpD,eAAO;AAAA,UACL,iBAAiB;AAAA,UACjB,MAAM;AAAA,UACN,YAAY,SAAS;AAAA,UACrB,aAAa,SAAS;AAAA,QACxB;AAAA,MACF;AAAA,MACA,KAAK;AACH,eAAO;AAAA,UACL,iBAAiB;AAAA,UACjB,MAAM;AAAA,UACN,UAAU,KAAK,gBAAgB,MAAM,QAAQ;AAAA,QAC/C;AAAA,MACF,SAAS;AACP,cAAM,IAAI,MAAM,6BAA6B,KAAK,UAAU,KAAK,CAAC,EAAE;AAAA,MACtE;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,gBAAgB,QAAoB,SAAuB;AACjE,QAAI;AACF,YAAM,QAAQ,KAAK,MAAM,OAAO;AAChC,UAAI,KAAC,0CAAwB,KAAK,GAAG;AACnC,cAAM,IAAI,MAAM,yCAAyC;AAAA,MAC3D;AACA,YAAM,WAAW,KAAK,YAAY,KAAK;AACvC,aAAO,IAAI,GAAG,KAAK,UAAU,QAAQ,CAAC;AAAA,CAAI;AAAA,IAC5C,SAAS,OAAO;AACd,aAAO;AAAA,QACL,GAAG,KAAK,UAAU;AAAA,UAChB,iBAAiB;AAAA,UACjB,MAAM;AAAA,UACN,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,QAC9D,CAAoC,CAAC;AAAA;AAAA,MACvC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,gBAA+B;AAC3C,UAAM,mBAAmB,GAAG,KAAK,aAAa,YAAY;AAC1D,UAAM,gBAAAD,QAAG,UAAU,kBAAkB,GAAG,KAAK,UAAU,KAAK,UAAU,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAC1F,UAAM,gBAAAA,QAAG,OAAO,kBAAkB,KAAK,aAAa,YAAY;AAAA,EAClE;AAAA,EAEA,MAAc,0BAAyC;AACrD,UAAM,gBAAAA,QAAG,GAAG,KAAK,aAAa,cAAc,EAAE,OAAO,KAAK,CAAC;AAC3D,QAAI,KAAK,aAAa,SAAS,SAAS,eAAe;AACrD,YAAM,gBAAAA,QAAG,GAAG,KAAK,aAAa,SAAS,SAAS,EAAE,OAAO,KAAK,CAAC;AAAA,IACjE;AAAA,EACF;AAAA,EAEQ,qBAAqB,UAGpB;AACP,UAAM,UAAU,KAAK,QAAQ,WAAW;AACxC,QAAI,YAAY,QAAW;AACzB,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,QAAQ,cAAc,QAAQ;AACjD,QAAI,eAAe,QAAW;AAC5B,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL;AAAA,MACA,SAAS,QAAQ,eAAe;AAAA,IAClC;AAAA,EACF;AAAA,EAEQ,gBAAgB,UAAgD;AACtE,UAAM,cAAc,KAAK,qBAAqB,QAAQ;AACtD,QAAI,gBAAgB,MAAM;AACxB,aAAO;AAAA,QACL;AAAA,QACA,YAAY;AAAA,QACZ,aAAa,KAAK,OAAO,EAAE,YAAY;AAAA,QACvC,UAAU,CAAC;AAAA,QACX,aAAa;AAAA,UACX;AAAA,YACE,MAAM;AAAA,YACN,SAAS,gDAAgD,QAAQ;AAAA,YACjE,OAAO,EAAE,OAAO,GAAG,KAAK,EAAE;AAAA,YAC1B,UAAU;AAAA,UACZ;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,UAAM,iBAAa,0CAAwB,YAAY,WAAW,IAAI;AACtE,UAAM,SAAS,KAAK,cAAc,IAAI,QAAQ;AAC9C,QAAI,QAAQ,eAAe,YAAY;AACrC,aAAO,OAAO;AAAA,IAChB;AAEA,UAAM,eAAW,oDAAkC,YAAY,YAAY;AAAA,MACzE,SAAS,YAAY;AAAA,IACvB,CAAoD;AACpD,SAAK,cAAc,IAAI,UAAU;AAAA,MAC/B;AAAA,MACA;AAAA,IACF,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EAEQ,SAAe;AACrB,WAAO,KAAK,QAAQ,MAAM,KAAK,oBAAI,KAAK;AAAA,EAC1C;AACF;AAEO,SAAS,2BACd,iBACA,iBACoB;AACpB,QAAM,0BAA0B,CAC9B,OACG;AACH,WAAO,CAAC,aAAqB,SAAuB;AAClD,sBAAgB,wBAAwB,QAAQ;AAChD,aAAO,GAAG,UAAU,GAAG,IAAI;AAAA,IAC7B;AAAA,EACF;AAIA,QAAM,yBAAyB;AAAA,IAAwB,CAAC,aACtD,gBAAgB,uBAAuB,QAAQ;AAAA,EACjD;AAEA,QAAM,2BAA2B;AAAA,IAC/B,CAAC,UAAkB,UAAkB,YACnC,gBAAgB,yBAAyB,UAAU,UAAU,OAAO;AAAA,EACxE;AAEA,QAAM,yBAAyB;AAAA,IAAwB,CAAC,UAAU,aAChE,gBAAgB,uBAAuB,UAAU,QAAQ;AAAA,EAC3D;AAEA,SAAO,IAAI,MAAM,iBAAiB;AAAA,IAChC,IAAI,QAAQ,UAAU,UAAU;AAC9B,cAAQ,UAAU;AAAA,QAChB,KAAK;AACH,iBAAO;AAAA,QACT,KAAK;AACH,iBAAO;AAAA,QACT,KAAK;AACH,iBAAO;AAAA,QACT;AACE,iBAAO,QAAQ,IAAI,QAAQ,UAAU,QAAQ;AAAA,MACjD;AAAA,IACF;AAAA,EACF,CAAC;AACH;;;ADjXA,IAAM,WAAW,oBAAI,IAA0B;AAE/C,SAAS,kBAAkB,OAAwB;AACjD,SAAO,iBAAiB,QAAS,MAAM,SAAS,MAAM,UAAW,OAAO,KAAK;AAC/E;AAEA,SAAS,mBACP,MACA,mBACuB;AACvB,QAAM,gBAAgB,KAAK,QAAQ,oBAAoB;AACvD,QAAM,WAAW,SAAS,IAAI,aAAa;AAC3C,MAAI,aAAa,QAAW;AAC1B,aAAS,kBAAkB;AAC3B,8BAA0B,MAAM,eAAe,QAAQ;AACvD,WAAO,SAAS;AAAA,EAClB;AAEA,QAAM,UAAU,IAAI,sBAAsB;AAAA,IACxC;AAAA,IACA;AAAA,IACA,YAAY,MAAM,KAAK,gBAAgB,WAAW;AAAA,IAClD,QAAQ,KAAK,QAAQ,eAAe;AAAA,EACtC,CAAC;AAED,QAAM,eAA6B;AAAA,IACjC;AAAA,IACA,gBAAgB;AAAA,EAClB;AACA,4BAA0B,MAAM,eAAe,YAAY;AAE3D,UAAQ,MAAM,EAAE,MAAM,CAAC,UAAmB;AACxC,SAAK,QAAQ,eAAe,OAAO;AAAA,MACjC,iDAAiD,aAAa,KAAK,kBAAkB,KAAK,CAAC;AAAA,IAC7F;AACA,aAAS,OAAO,aAAa;AAAA,EAC/B,CAAC;AACD,WAAS,IAAI,eAAe,YAAY;AACxC,SAAO;AACT;AAEA,SAAS,0BACP,MACA,eACA,cACM;AACN,QAAM,gBAAgB,KAAK,QAAQ,MAAM,KAAK,KAAK,OAAO;AAC1D,MAAI,SAAS;AAEb,OAAK,QAAQ,QAAQ,MAAM;AACzB,QAAI,QAAQ;AACV,oBAAc;AACd;AAAA,IACF;AAEA,aAAS;AACT,iBAAa,kBAAkB;AAC/B,QAAI,aAAa,kBAAkB,GAAG;AACpC,eAAS,OAAO,aAAa;AAC7B,WAAK,aAAa,QAAQ,KAAK,EAAE,MAAM,CAAC,UAAmB;AACzD,aAAK,QAAQ,eAAe,OAAO;AAAA,UACjC,gDAAgD,aAAa,KAAK,kBAAkB,KAAK,CAAC;AAAA,QAC5F;AAAA,MACF,CAAC;AAAA,IACH;AACA,kBAAc;AAAA,EAChB;AACF;AAOO,SAAS,KAAK,SAEY;AAC/B,QAAM,oBAAoB,QAAQ,WAAW;AAC7C,SAAO;AAAA,IACL,OAAO,MAAM;AACX,YAAM,UAAU,mBAAmB,MAAM,iBAAiB;AAC1D,aAAO,2BAA2B,KAAK,iBAAiB,OAAO;AAAA,IACjE;AAAA,EACF;AACF;","names":["import_analysis","path","os","fs","net"]}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type * as tsServer from "typescript/lib/tsserverlibrary.js";
+/**
+ * Initializes the FormSpec TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: {
+    readonly typescript: typeof tsServer;
+}): tsServer.server.PluginModule;
+//# 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,OAAO,KAAK,KAAK,QAAQ,MAAM,mCAAmC,CAAC;AA6EnE;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,QAAQ,CAAC;CACtC,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAQ/B"}

package/dist/index.js

@@ -0,0 +1,434 @@
+// src/service.ts
+import fs from "fs/promises";
+import net from "net";
+import "typescript";
+import {
+  FORMSPEC_ANALYSIS_PROTOCOL_VERSION as FORMSPEC_ANALYSIS_PROTOCOL_VERSION2,
+  buildFormSpecAnalysisFileSnapshot,
+  computeFormSpecTextHash,
+  findDeclarationForCommentOffset,
+  getSubjectType,
+  getCommentHoverInfoAtOffset,
+  getSemanticCommentCompletionContextAtOffset,
+  isFormSpecSemanticQuery,
+  resolveDeclarationPlacement,
+  serializeCompletionContext,
+  serializeHoverInfo
+} from "@formspec/analysis";
+
+// src/workspace.ts
+import os from "os";
+import path from "path";
+import {
+  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+  FORMSPEC_ANALYSIS_SCHEMA_VERSION,
+  getFormSpecManifestPath,
+  getFormSpecWorkspaceId,
+  getFormSpecWorkspaceRuntimeDirectory
+} from "@formspec/analysis";
+function getFormSpecWorkspaceRuntimePaths(workspaceRoot, platform = process.platform, userScope = getFormSpecUserScope()) {
+  const workspaceId = getFormSpecWorkspaceId(workspaceRoot);
+  const runtimeDirectory = getFormSpecWorkspaceRuntimeDirectory(workspaceRoot);
+  const sanitizedUserScope = sanitizeScopeSegment(userScope);
+  const endpoint = platform === "win32" ? {
+    kind: "windows-pipe",
+    address: `\\\\.\\pipe\\formspec-${sanitizedUserScope}-${workspaceId}`
+  } : {
+    kind: "unix-socket",
+    address: path.join(os.tmpdir(), `formspec-${sanitizedUserScope}-${workspaceId}.sock`)
+  };
+  return {
+    workspaceRoot,
+    workspaceId,
+    runtimeDirectory,
+    manifestPath: getFormSpecManifestPath(workspaceRoot),
+    endpoint
+  };
+}
+function createFormSpecAnalysisManifest(workspaceRoot, typescriptVersion, generation, extensionFingerprint = "builtin") {
+  const paths = getFormSpecWorkspaceRuntimePaths(workspaceRoot);
+  return {
+    protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,
+    analysisSchemaVersion: FORMSPEC_ANALYSIS_SCHEMA_VERSION,
+    workspaceRoot,
+    workspaceId: paths.workspaceId,
+    endpoint: paths.endpoint,
+    typescriptVersion,
+    extensionFingerprint,
+    generation,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function getFormSpecUserScope() {
+  try {
+    return sanitizeScopeSegment(os.userInfo().username);
+  } catch {
+    return sanitizeScopeSegment(
+      process.env["USER"] ?? process.env["USERNAME"] ?? process.env["LOGNAME"] ?? "formspec"
+    );
+  }
+}
+function sanitizeScopeSegment(value) {
+  const trimmed = value.trim().toLowerCase();
+  const sanitized = trimmed.replace(/[^a-z0-9_-]+/gu, "-").replace(/-+/gu, "-");
+  return sanitized.length > 0 ? sanitized : "formspec";
+}
+
+// src/service.ts
+var FormSpecPluginService = class {
+  constructor(options) {
+    this.options = options;
+    this.runtimePaths = getFormSpecWorkspaceRuntimePaths(options.workspaceRoot);
+    this.manifest = createFormSpecAnalysisManifest(
+      options.workspaceRoot,
+      options.typescriptVersion,
+      Date.now()
+    );
+  }
+  manifest;
+  runtimePaths;
+  snapshotCache = /* @__PURE__ */ new Map();
+  refreshTimers = /* @__PURE__ */ new Map();
+  server = null;
+  getManifest() {
+    return this.manifest;
+  }
+  async start() {
+    if (this.server !== null) {
+      return;
+    }
+    await fs.mkdir(this.runtimePaths.runtimeDirectory, { recursive: true });
+    if (this.runtimePaths.endpoint.kind === "unix-socket") {
+      await fs.rm(this.runtimePaths.endpoint.address, { force: true });
+    }
+    this.server = net.createServer((socket) => {
+      let buffer = "";
+      socket.setEncoding("utf8");
+      socket.on("data", (chunk) => {
+        buffer += String(chunk);
+        const newlineIndex = buffer.indexOf("\n");
+        if (newlineIndex < 0) {
+          return;
+        }
+        const payload = buffer.slice(0, newlineIndex);
+        const remaining = buffer.slice(newlineIndex + 1);
+        if (remaining.trim().length > 0) {
+          this.options.logger?.info(
+            `[FormSpec] Ignoring extra semantic query payload data for ${this.runtimePaths.workspaceRoot}`
+          );
+        }
+        buffer = remaining;
+        this.respondToSocket(socket, payload);
+      });
+    });
+    await new Promise((resolve, reject) => {
+      const handleError = (error) => {
+        reject(error);
+      };
+      this.server?.once("error", handleError);
+      this.server?.listen(this.runtimePaths.endpoint.address, () => {
+        this.server?.off("error", handleError);
+        resolve();
+      });
+    });
+    await this.writeManifest();
+  }
+  async stop() {
+    for (const timer of this.refreshTimers.values()) {
+      clearTimeout(timer);
+    }
+    this.refreshTimers.clear();
+    this.snapshotCache.clear();
+    const server = this.server;
+    this.server = null;
+    if (server?.listening === true) {
+      await new Promise((resolve, reject) => {
+        server.close((error) => {
+          if (error === void 0) {
+            resolve();
+            return;
+          }
+          reject(error);
+        });
+      });
+    }
+    await this.cleanupRuntimeArtifacts();
+  }
+  scheduleSnapshotRefresh(filePath) {
+    const existing = this.refreshTimers.get(filePath);
+    if (existing !== void 0) {
+      clearTimeout(existing);
+    }
+    const timer = setTimeout(() => {
+      try {
+        this.getFileSnapshot(filePath);
+      } catch (error) {
+        this.options.logger?.info(
+          `[FormSpec] Failed to refresh semantic snapshot for ${filePath}: ${String(error)}`
+        );
+      }
+      this.refreshTimers.delete(filePath);
+    }, this.options.snapshotDebounceMs ?? 250);
+    this.refreshTimers.set(filePath, timer);
+  }
+  handleQuery(query) {
+    switch (query.kind) {
+      case "health":
+        return {
+          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION2,
+          kind: "health",
+          manifest: this.manifest
+        };
+      case "completion": {
+        const environment = this.getSourceEnvironment(query.filePath);
+        if (environment === null) {
+          return {
+            protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION2,
+            kind: "error",
+            error: `Unable to resolve TypeScript source file for ${query.filePath}`
+          };
+        }
+        const declaration = findDeclarationForCommentOffset(environment.sourceFile, query.offset);
+        const placement = declaration === null ? null : resolveDeclarationPlacement(declaration);
+        const subjectType = declaration === null ? void 0 : getSubjectType(declaration, environment.checker);
+        const context = getSemanticCommentCompletionContextAtOffset(
+          environment.sourceFile.text,
+          query.offset,
+          {
+            checker: environment.checker,
+            ...placement === null ? {} : { placement },
+            ...subjectType === void 0 ? {} : { subjectType }
+          }
+        );
+        return {
+          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION2,
+          kind: "completion",
+          sourceHash: computeFormSpecTextHash(environment.sourceFile.text),
+          context: serializeCompletionContext(context)
+        };
+      }
+      case "hover": {
+        const environment = this.getSourceEnvironment(query.filePath);
+        if (environment === null) {
+          return {
+            protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION2,
+            kind: "error",
+            error: `Unable to resolve TypeScript source file for ${query.filePath}`
+          };
+        }
+        const declaration = findDeclarationForCommentOffset(environment.sourceFile, query.offset);
+        const placement = declaration === null ? null : resolveDeclarationPlacement(declaration);
+        const subjectType = declaration === null ? void 0 : getSubjectType(declaration, environment.checker);
+        const hover = getCommentHoverInfoAtOffset(environment.sourceFile.text, query.offset, {
+          checker: environment.checker,
+          ...placement === null ? {} : { placement },
+          ...subjectType === void 0 ? {} : { subjectType }
+        });
+        return {
+          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION2,
+          kind: "hover",
+          sourceHash: computeFormSpecTextHash(environment.sourceFile.text),
+          hover: serializeHoverInfo(hover)
+        };
+      }
+      case "diagnostics": {
+        const snapshot = this.getFileSnapshot(query.filePath);
+        return {
+          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION2,
+          kind: "diagnostics",
+          sourceHash: snapshot.sourceHash,
+          diagnostics: snapshot.diagnostics
+        };
+      }
+      case "file-snapshot":
+        return {
+          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION2,
+          kind: "file-snapshot",
+          snapshot: this.getFileSnapshot(query.filePath)
+        };
+      default: {
+        throw new Error(`Unhandled semantic query: ${JSON.stringify(query)}`);
+      }
+    }
+  }
+  respondToSocket(socket, payload) {
+    try {
+      const query = JSON.parse(payload);
+      if (!isFormSpecSemanticQuery(query)) {
+        throw new Error("Invalid FormSpec semantic query payload");
+      }
+      const response = this.handleQuery(query);
+      socket.end(`${JSON.stringify(response)}
+`);
+    } catch (error) {
+      socket.end(
+        `${JSON.stringify({
+          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION2,
+          kind: "error",
+          error: error instanceof Error ? error.message : String(error)
+        })}
+`
+      );
+    }
+  }
+  async writeManifest() {
+    const tempManifestPath = `${this.runtimePaths.manifestPath}.tmp`;
+    await fs.writeFile(tempManifestPath, `${JSON.stringify(this.manifest, null, 2)}
+`, "utf8");
+    await fs.rename(tempManifestPath, this.runtimePaths.manifestPath);
+  }
+  async cleanupRuntimeArtifacts() {
+    await fs.rm(this.runtimePaths.manifestPath, { force: true });
+    if (this.runtimePaths.endpoint.kind === "unix-socket") {
+      await fs.rm(this.runtimePaths.endpoint.address, { force: true });
+    }
+  }
+  getSourceEnvironment(filePath) {
+    const program = this.options.getProgram();
+    if (program === void 0) {
+      return null;
+    }
+    const sourceFile = program.getSourceFile(filePath);
+    if (sourceFile === void 0) {
+      return null;
+    }
+    return {
+      sourceFile,
+      checker: program.getTypeChecker()
+    };
+  }
+  getFileSnapshot(filePath) {
+    const environment = this.getSourceEnvironment(filePath);
+    if (environment === null) {
+      return {
+        filePath,
+        sourceHash: "",
+        generatedAt: this.getNow().toISOString(),
+        comments: [],
+        diagnostics: [
+          {
+            code: "MISSING_SOURCE_FILE",
+            message: `Unable to resolve TypeScript source file for ${filePath}`,
+            range: { start: 0, end: 0 },
+            severity: "warning"
+          }
+        ]
+      };
+    }
+    const sourceHash = computeFormSpecTextHash(environment.sourceFile.text);
+    const cached = this.snapshotCache.get(filePath);
+    if (cached?.sourceHash === sourceHash) {
+      return cached.snapshot;
+    }
+    const snapshot = buildFormSpecAnalysisFileSnapshot(environment.sourceFile, {
+      checker: environment.checker
+    });
+    this.snapshotCache.set(filePath, {
+      sourceHash,
+      snapshot
+    });
+    return snapshot;
+  }
+  getNow() {
+    return this.options.now?.() ?? /* @__PURE__ */ new Date();
+  }
+};
+function createLanguageServiceProxy(languageService, semanticService) {
+  const wrapWithSnapshotRefresh = (fn) => {
+    return (fileName, ...args) => {
+      semanticService.scheduleSnapshotRefresh(fileName);
+      return fn(fileName, ...args);
+    };
+  };
+  const getSemanticDiagnostics = wrapWithSnapshotRefresh(
+    (fileName) => languageService.getSemanticDiagnostics(fileName)
+  );
+  const getCompletionsAtPosition = wrapWithSnapshotRefresh(
+    (fileName, position, options) => languageService.getCompletionsAtPosition(fileName, position, options)
+  );
+  const getQuickInfoAtPosition = wrapWithSnapshotRefresh(
+    (fileName, position) => languageService.getQuickInfoAtPosition(fileName, position)
+  );
+  return new Proxy(languageService, {
+    get(target, property, receiver) {
+      switch (property) {
+        case "getSemanticDiagnostics":
+          return getSemanticDiagnostics;
+        case "getCompletionsAtPosition":
+          return getCompletionsAtPosition;
+        case "getQuickInfoAtPosition":
+          return getQuickInfoAtPosition;
+        default:
+          return Reflect.get(target, property, receiver);
+      }
+    }
+  });
+}
+
+// src/index.ts
+var services = /* @__PURE__ */ new Map();
+function formatPluginError(error) {
+  return error instanceof Error ? error.stack ?? error.message : String(error);
+}
+function getOrCreateService(info, typescriptVersion) {
+  const workspaceRoot = info.project.getCurrentDirectory();
+  const existing = services.get(workspaceRoot);
+  if (existing !== void 0) {
+    existing.referenceCount += 1;
+    attachProjectCloseHandler(info, workspaceRoot, existing);
+    return existing.service;
+  }
+  const service = new FormSpecPluginService({
+    workspaceRoot,
+    typescriptVersion,
+    getProgram: () => info.languageService.getProgram(),
+    logger: info.project.projectService.logger
+  });
+  const serviceEntry = {
+    service,
+    referenceCount: 1
+  };
+  attachProjectCloseHandler(info, workspaceRoot, serviceEntry);
+  service.start().catch((error) => {
+    info.project.projectService.logger.info(
+      `[FormSpec] Plugin service failed to start for ${workspaceRoot}: ${formatPluginError(error)}`
+    );
+    services.delete(workspaceRoot);
+  });
+  services.set(workspaceRoot, serviceEntry);
+  return service;
+}
+function attachProjectCloseHandler(info, workspaceRoot, serviceEntry) {
+  const originalClose = info.project.close.bind(info.project);
+  let closed = false;
+  info.project.close = () => {
+    if (closed) {
+      originalClose();
+      return;
+    }
+    closed = true;
+    serviceEntry.referenceCount -= 1;
+    if (serviceEntry.referenceCount <= 0) {
+      services.delete(workspaceRoot);
+      void serviceEntry.service.stop().catch((error) => {
+        info.project.projectService.logger.info(
+          `[FormSpec] Failed to stop plugin service for ${workspaceRoot}: ${formatPluginError(error)}`
+        );
+      });
+    }
+    originalClose();
+  };
+}
+function init(modules) {
+  const typescriptVersion = modules.typescript.version;
+  return {
+    create(info) {
+      const service = getOrCreateService(info, typescriptVersion);
+      return createLanguageServiceProxy(info.languageService, service);
+    }
+  };
+}
+export {
+  init
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/service.ts","../src/workspace.ts","../src/index.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\nimport net from \"node:net\";\nimport * as ts from \"typescript\";\nimport {\n  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n  buildFormSpecAnalysisFileSnapshot,\n  computeFormSpecTextHash,\n  findDeclarationForCommentOffset,\n  getSubjectType,\n  getCommentHoverInfoAtOffset,\n  getSemanticCommentCompletionContextAtOffset,\n  isFormSpecSemanticQuery,\n  resolveDeclarationPlacement,\n  serializeCompletionContext,\n  serializeHoverInfo,\n  type BuildFormSpecAnalysisFileSnapshotOptions,\n  type FormSpecAnalysisFileSnapshot,\n  type FormSpecAnalysisManifest,\n  type FormSpecSemanticQuery,\n  type FormSpecSemanticResponse,\n} from \"@formspec/analysis\";\nimport {\n  createFormSpecAnalysisManifest,\n  getFormSpecWorkspaceRuntimePaths,\n  type FormSpecWorkspaceRuntimePaths,\n} from \"./workspace.js\";\n\ninterface LoggerLike {\n  info(message: string): void;\n}\n\nexport interface FormSpecPluginServiceOptions {\n  readonly workspaceRoot: string;\n  readonly typescriptVersion: string;\n  readonly getProgram: () => ts.Program | undefined;\n  readonly logger?: LoggerLike;\n  readonly snapshotDebounceMs?: number;\n  readonly now?: () => Date;\n}\n\ninterface CachedFileSnapshot {\n  readonly sourceHash: string;\n  readonly snapshot: FormSpecAnalysisFileSnapshot;\n}\n\nexport class FormSpecPluginService {\n  private readonly manifest: FormSpecAnalysisManifest;\n  private readonly runtimePaths: FormSpecWorkspaceRuntimePaths;\n  private readonly snapshotCache = new Map<string, CachedFileSnapshot>();\n  private readonly refreshTimers = new Map<string, NodeJS.Timeout>();\n  private server: net.Server | null = null;\n\n  public constructor(private readonly options: FormSpecPluginServiceOptions) {\n    this.runtimePaths = getFormSpecWorkspaceRuntimePaths(options.workspaceRoot);\n    this.manifest = createFormSpecAnalysisManifest(\n      options.workspaceRoot,\n      options.typescriptVersion,\n      Date.now()\n    );\n  }\n\n  public getManifest(): FormSpecAnalysisManifest {\n    return this.manifest;\n  }\n\n  public async start(): Promise<void> {\n    if (this.server !== null) {\n      return;\n    }\n\n    await fs.mkdir(this.runtimePaths.runtimeDirectory, { recursive: true });\n    if (this.runtimePaths.endpoint.kind === \"unix-socket\") {\n      await fs.rm(this.runtimePaths.endpoint.address, { force: true });\n    }\n\n    this.server = net.createServer((socket) => {\n      let buffer = \"\";\n      socket.setEncoding(\"utf8\");\n      socket.on(\"data\", (chunk) => {\n        buffer += String(chunk);\n        const newlineIndex = buffer.indexOf(\"\\n\");\n        if (newlineIndex < 0) {\n          return;\n        }\n\n        const payload = buffer.slice(0, newlineIndex);\n        const remaining = buffer.slice(newlineIndex + 1);\n        if (remaining.trim().length > 0) {\n          this.options.logger?.info(\n            `[FormSpec] Ignoring extra semantic query payload data for ${this.runtimePaths.workspaceRoot}`\n          );\n        }\n        buffer = remaining;\n        // The FormSpec IPC transport is intentionally one-request-per-connection.\n        this.respondToSocket(socket, payload);\n      });\n    });\n\n    await new Promise<void>((resolve, reject) => {\n      const handleError = (error: Error) => {\n        reject(error);\n      };\n      this.server?.once(\"error\", handleError);\n      this.server?.listen(this.runtimePaths.endpoint.address, () => {\n        this.server?.off(\"error\", handleError);\n        resolve();\n      });\n    });\n\n    await this.writeManifest();\n  }\n\n  public async stop(): Promise<void> {\n    for (const timer of this.refreshTimers.values()) {\n      clearTimeout(timer);\n    }\n    this.refreshTimers.clear();\n    this.snapshotCache.clear();\n\n    const server = this.server;\n    this.server = null;\n    if (server?.listening === true) {\n      await new Promise<void>((resolve, reject) => {\n        server.close((error) => {\n          if (error === undefined) {\n            resolve();\n            return;\n          }\n          reject(error);\n        });\n      });\n    }\n\n    await this.cleanupRuntimeArtifacts();\n  }\n\n  public scheduleSnapshotRefresh(filePath: string): void {\n    const existing = this.refreshTimers.get(filePath);\n    if (existing !== undefined) {\n      clearTimeout(existing);\n    }\n\n    const timer = setTimeout(() => {\n      try {\n        this.getFileSnapshot(filePath);\n      } catch (error: unknown) {\n        this.options.logger?.info(\n          `[FormSpec] Failed to refresh semantic snapshot for ${filePath}: ${String(error)}`\n        );\n      }\n      this.refreshTimers.delete(filePath);\n    }, this.options.snapshotDebounceMs ?? 250);\n\n    this.refreshTimers.set(filePath, timer);\n  }\n\n  public handleQuery(query: FormSpecSemanticQuery): FormSpecSemanticResponse {\n    switch (query.kind) {\n      case \"health\":\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"health\",\n          manifest: this.manifest,\n        };\n      case \"completion\": {\n        const environment = this.getSourceEnvironment(query.filePath);\n        if (environment === null) {\n          return {\n            protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n            kind: \"error\",\n            error: `Unable to resolve TypeScript source file for ${query.filePath}`,\n          };\n        }\n\n        const declaration = findDeclarationForCommentOffset(environment.sourceFile, query.offset);\n        const placement = declaration === null ? null : resolveDeclarationPlacement(declaration);\n        const subjectType =\n          declaration === null ? undefined : getSubjectType(declaration, environment.checker);\n        const context = getSemanticCommentCompletionContextAtOffset(\n          environment.sourceFile.text,\n          query.offset,\n          {\n            checker: environment.checker,\n            ...(placement === null ? {} : { placement }),\n            ...(subjectType === undefined ? {} : { subjectType }),\n          }\n        );\n\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"completion\",\n          sourceHash: computeFormSpecTextHash(environment.sourceFile.text),\n          context: serializeCompletionContext(context),\n        };\n      }\n      case \"hover\": {\n        const environment = this.getSourceEnvironment(query.filePath);\n        if (environment === null) {\n          return {\n            protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n            kind: \"error\",\n            error: `Unable to resolve TypeScript source file for ${query.filePath}`,\n          };\n        }\n\n        const declaration = findDeclarationForCommentOffset(environment.sourceFile, query.offset);\n        const placement = declaration === null ? null : resolveDeclarationPlacement(declaration);\n        const subjectType =\n          declaration === null ? undefined : getSubjectType(declaration, environment.checker);\n        const hover = getCommentHoverInfoAtOffset(environment.sourceFile.text, query.offset, {\n          checker: environment.checker,\n          ...(placement === null ? {} : { placement }),\n          ...(subjectType === undefined ? {} : { subjectType }),\n        });\n\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"hover\",\n          sourceHash: computeFormSpecTextHash(environment.sourceFile.text),\n          hover: serializeHoverInfo(hover),\n        };\n      }\n      case \"diagnostics\": {\n        const snapshot = this.getFileSnapshot(query.filePath);\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"diagnostics\",\n          sourceHash: snapshot.sourceHash,\n          diagnostics: snapshot.diagnostics,\n        };\n      }\n      case \"file-snapshot\":\n        return {\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"file-snapshot\",\n          snapshot: this.getFileSnapshot(query.filePath),\n        };\n      default: {\n        throw new Error(`Unhandled semantic query: ${JSON.stringify(query)}`);\n      }\n    }\n  }\n\n  private respondToSocket(socket: net.Socket, payload: string): void {\n    try {\n      const query = JSON.parse(payload) as unknown;\n      if (!isFormSpecSemanticQuery(query)) {\n        throw new Error(\"Invalid FormSpec semantic query payload\");\n      }\n      const response = this.handleQuery(query);\n      socket.end(`${JSON.stringify(response)}\\n`);\n    } catch (error) {\n      socket.end(\n        `${JSON.stringify({\n          protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n          kind: \"error\",\n          error: error instanceof Error ? error.message : String(error),\n        } satisfies FormSpecSemanticResponse)}\\n`\n      );\n    }\n  }\n\n  private async writeManifest(): Promise<void> {\n    const tempManifestPath = `${this.runtimePaths.manifestPath}.tmp`;\n    await fs.writeFile(tempManifestPath, `${JSON.stringify(this.manifest, null, 2)}\\n`, \"utf8\");\n    await fs.rename(tempManifestPath, this.runtimePaths.manifestPath);\n  }\n\n  private async cleanupRuntimeArtifacts(): Promise<void> {\n    await fs.rm(this.runtimePaths.manifestPath, { force: true });\n    if (this.runtimePaths.endpoint.kind === \"unix-socket\") {\n      await fs.rm(this.runtimePaths.endpoint.address, { force: true });\n    }\n  }\n\n  private getSourceEnvironment(filePath: string): {\n    readonly sourceFile: ts.SourceFile;\n    readonly checker: ts.TypeChecker;\n  } | null {\n    const program = this.options.getProgram();\n    if (program === undefined) {\n      return null;\n    }\n\n    const sourceFile = program.getSourceFile(filePath);\n    if (sourceFile === undefined) {\n      return null;\n    }\n\n    return {\n      sourceFile,\n      checker: program.getTypeChecker(),\n    };\n  }\n\n  private getFileSnapshot(filePath: string): FormSpecAnalysisFileSnapshot {\n    const environment = this.getSourceEnvironment(filePath);\n    if (environment === null) {\n      return {\n        filePath,\n        sourceHash: \"\",\n        generatedAt: this.getNow().toISOString(),\n        comments: [],\n        diagnostics: [\n          {\n            code: \"MISSING_SOURCE_FILE\",\n            message: `Unable to resolve TypeScript source file for ${filePath}`,\n            range: { start: 0, end: 0 },\n            severity: \"warning\",\n          },\n        ],\n      };\n    }\n\n    const sourceHash = computeFormSpecTextHash(environment.sourceFile.text);\n    const cached = this.snapshotCache.get(filePath);\n    if (cached?.sourceHash === sourceHash) {\n      return cached.snapshot;\n    }\n\n    const snapshot = buildFormSpecAnalysisFileSnapshot(environment.sourceFile, {\n      checker: environment.checker,\n    } satisfies BuildFormSpecAnalysisFileSnapshotOptions);\n    this.snapshotCache.set(filePath, {\n      sourceHash,\n      snapshot,\n    });\n    return snapshot;\n  }\n\n  private getNow(): Date {\n    return this.options.now?.() ?? new Date();\n  }\n}\n\nexport function createLanguageServiceProxy(\n  languageService: ts.LanguageService,\n  semanticService: FormSpecPluginService\n): ts.LanguageService {\n  const wrapWithSnapshotRefresh = <Args extends readonly unknown[], Result>(\n    fn: (fileName: string, ...args: Args) => Result\n  ) => {\n    return (fileName: string, ...args: Args): Result => {\n      semanticService.scheduleSnapshotRefresh(fileName);\n      return fn(fileName, ...args);\n    };\n  };\n\n  // The plugin keeps semantic snapshots fresh for the lightweight LSP. The\n  // underlying tsserver results still come from the original language service.\n  const getSemanticDiagnostics = wrapWithSnapshotRefresh((fileName) =>\n    languageService.getSemanticDiagnostics(fileName)\n  );\n\n  const getCompletionsAtPosition = wrapWithSnapshotRefresh(\n    (fileName: string, position: number, options: ts.GetCompletionsAtPositionOptions | undefined) =>\n      languageService.getCompletionsAtPosition(fileName, position, options)\n  );\n\n  const getQuickInfoAtPosition = wrapWithSnapshotRefresh((fileName, position: number) =>\n    languageService.getQuickInfoAtPosition(fileName, position)\n  );\n\n  return new Proxy(languageService, {\n    get(target, property, receiver) {\n      switch (property) {\n        case \"getSemanticDiagnostics\":\n          return getSemanticDiagnostics;\n        case \"getCompletionsAtPosition\":\n          return getCompletionsAtPosition;\n        case \"getQuickInfoAtPosition\":\n          return getQuickInfoAtPosition;\n        default:\n          return Reflect.get(target, property, receiver) as unknown;\n      }\n    },\n  });\n}\n","import os from \"node:os\";\nimport path from \"node:path\";\nimport {\n  FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n  FORMSPEC_ANALYSIS_SCHEMA_VERSION,\n  getFormSpecManifestPath,\n  getFormSpecWorkspaceId,\n  getFormSpecWorkspaceRuntimeDirectory,\n  type FormSpecAnalysisManifest,\n  type FormSpecIpcEndpoint,\n} from \"@formspec/analysis\";\n\nexport interface FormSpecWorkspaceRuntimePaths {\n  readonly workspaceRoot: string;\n  readonly workspaceId: string;\n  readonly runtimeDirectory: string;\n  readonly manifestPath: string;\n  readonly endpoint: FormSpecIpcEndpoint;\n}\n\nexport function getFormSpecWorkspaceRuntimePaths(\n  workspaceRoot: string,\n  platform = process.platform,\n  userScope = getFormSpecUserScope()\n): FormSpecWorkspaceRuntimePaths {\n  const workspaceId = getFormSpecWorkspaceId(workspaceRoot);\n  const runtimeDirectory = getFormSpecWorkspaceRuntimeDirectory(workspaceRoot);\n  const sanitizedUserScope = sanitizeScopeSegment(userScope);\n  const endpoint: FormSpecIpcEndpoint =\n    platform === \"win32\"\n      ? {\n          kind: \"windows-pipe\",\n          address: `\\\\\\\\.\\\\pipe\\\\formspec-${sanitizedUserScope}-${workspaceId}`,\n        }\n      : {\n          kind: \"unix-socket\",\n          address: path.join(os.tmpdir(), `formspec-${sanitizedUserScope}-${workspaceId}.sock`),\n        };\n\n  return {\n    workspaceRoot,\n    workspaceId,\n    runtimeDirectory,\n    manifestPath: getFormSpecManifestPath(workspaceRoot),\n    endpoint,\n  };\n}\n\nexport function createFormSpecAnalysisManifest(\n  workspaceRoot: string,\n  typescriptVersion: string,\n  generation: number,\n  extensionFingerprint = \"builtin\"\n): FormSpecAnalysisManifest {\n  const paths = getFormSpecWorkspaceRuntimePaths(workspaceRoot);\n  return {\n    protocolVersion: FORMSPEC_ANALYSIS_PROTOCOL_VERSION,\n    analysisSchemaVersion: FORMSPEC_ANALYSIS_SCHEMA_VERSION,\n    workspaceRoot,\n    workspaceId: paths.workspaceId,\n    endpoint: paths.endpoint,\n    typescriptVersion,\n    extensionFingerprint,\n    generation,\n    updatedAt: new Date().toISOString(),\n  };\n}\n\nfunction getFormSpecUserScope(): string {\n  try {\n    return sanitizeScopeSegment(os.userInfo().username);\n  } catch {\n    return sanitizeScopeSegment(\n      process.env[\"USER\"] ?? process.env[\"USERNAME\"] ?? process.env[\"LOGNAME\"] ?? \"formspec\"\n    );\n  }\n}\n\nfunction sanitizeScopeSegment(value: string): string {\n  const trimmed = value.trim().toLowerCase();\n  const sanitized = trimmed.replace(/[^a-z0-9_-]+/gu, \"-\").replace(/-+/gu, \"-\");\n  return sanitized.length > 0 ? sanitized : \"formspec\";\n}\n","import type * as tsServer from \"typescript/lib/tsserverlibrary.js\";\nimport { createLanguageServiceProxy, FormSpecPluginService } from \"./service.js\";\n\ninterface ServiceEntry {\n  readonly service: FormSpecPluginService;\n  referenceCount: number;\n}\n\nconst services = new Map<string, ServiceEntry>();\n\nfunction formatPluginError(error: unknown): string {\n  return error instanceof Error ? (error.stack ?? error.message) : String(error);\n}\n\nfunction getOrCreateService(\n  info: tsServer.server.PluginCreateInfo,\n  typescriptVersion: string\n): FormSpecPluginService {\n  const workspaceRoot = info.project.getCurrentDirectory();\n  const existing = services.get(workspaceRoot);\n  if (existing !== undefined) {\n    existing.referenceCount += 1;\n    attachProjectCloseHandler(info, workspaceRoot, existing);\n    return existing.service;\n  }\n\n  const service = new FormSpecPluginService({\n    workspaceRoot,\n    typescriptVersion,\n    getProgram: () => info.languageService.getProgram(),\n    logger: info.project.projectService.logger,\n  });\n\n  const serviceEntry: ServiceEntry = {\n    service,\n    referenceCount: 1,\n  };\n  attachProjectCloseHandler(info, workspaceRoot, serviceEntry);\n\n  service.start().catch((error: unknown) => {\n    info.project.projectService.logger.info(\n      `[FormSpec] Plugin service failed to start for ${workspaceRoot}: ${formatPluginError(error)}`\n    );\n    services.delete(workspaceRoot);\n  });\n  services.set(workspaceRoot, serviceEntry);\n  return service;\n}\n\nfunction attachProjectCloseHandler(\n  info: tsServer.server.PluginCreateInfo,\n  workspaceRoot: string,\n  serviceEntry: ServiceEntry\n): void {\n  const originalClose = info.project.close.bind(info.project);\n  let closed = false;\n\n  info.project.close = () => {\n    if (closed) {\n      originalClose();\n      return;\n    }\n\n    closed = true;\n    serviceEntry.referenceCount -= 1;\n    if (serviceEntry.referenceCount <= 0) {\n      services.delete(workspaceRoot);\n      void serviceEntry.service.stop().catch((error: unknown) => {\n        info.project.projectService.logger.info(\n          `[FormSpec] Failed to stop plugin service for ${workspaceRoot}: ${formatPluginError(error)}`\n        );\n      });\n    }\n    originalClose();\n  };\n}\n\n/**\n * Initializes the FormSpec TypeScript language service plugin.\n *\n * @public\n */\nexport function init(modules: {\n  readonly typescript: typeof tsServer;\n}): tsServer.server.PluginModule {\n  const typescriptVersion = modules.typescript.version;\n  return {\n    create(info) {\n      const service = getOrCreateService(info, typescriptVersion);\n      return createLanguageServiceProxy(info.languageService, service);\n    },\n  };\n}\n"],"mappings":"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","names":["FORMSPEC_ANALYSIS_PROTOCOL_VERSION","FORMSPEC_ANALYSIS_PROTOCOL_VERSION"]}

package/dist/service.d.ts

@@ -0,0 +1,36 @@
+import * as ts from "typescript";
+import { type FormSpecAnalysisManifest, type FormSpecSemanticQuery, type FormSpecSemanticResponse } from "@formspec/analysis";
+interface LoggerLike {
+    info(message: string): void;
+}
+export interface FormSpecPluginServiceOptions {
+    readonly workspaceRoot: string;
+    readonly typescriptVersion: string;
+    readonly getProgram: () => ts.Program | undefined;
+    readonly logger?: LoggerLike;
+    readonly snapshotDebounceMs?: number;
+    readonly now?: () => Date;
+}
+export declare class FormSpecPluginService {
+    private readonly options;
+    private readonly manifest;
+    private readonly runtimePaths;
+    private readonly snapshotCache;
+    private readonly refreshTimers;
+    private server;
+    constructor(options: FormSpecPluginServiceOptions);
+    getManifest(): FormSpecAnalysisManifest;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    scheduleSnapshotRefresh(filePath: string): void;
+    handleQuery(query: FormSpecSemanticQuery): FormSpecSemanticResponse;
+    private respondToSocket;
+    private writeManifest;
+    private cleanupRuntimeArtifacts;
+    private getSourceEnvironment;
+    private getFileSnapshot;
+    private getNow;
+}
+export declare function createLanguageServiceProxy(languageService: ts.LanguageService, semanticService: FormSpecPluginService): ts.LanguageService;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAcL,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAO5B,UAAU,UAAU;IAClB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,OAAO,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAOD,qBAAa,qBAAqB;IAOb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqC;IACnE,OAAO,CAAC,MAAM,CAA2B;gBAEL,OAAO,EAAE,4BAA4B;IASlE,WAAW,IAAI,wBAAwB;IAIjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAoB/C,WAAW,CAAC,KAAK,EAAE,qBAAqB,GAAG,wBAAwB;IAuF1E,OAAO,CAAC,eAAe;YAmBT,aAAa;YAMb,uBAAuB;IAOrC,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,MAAM;CAGf;AAED,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,EAAE,CAAC,eAAe,EACnC,eAAe,EAAE,qBAAqB,GACrC,EAAE,CAAC,eAAe,CAuCpB"}

package/dist/ts-plugin.d.ts

@@ -0,0 +1,12 @@
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+
+/**
+ * Initializes the FormSpec TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: {
+    readonly typescript: typeof tsServer;
+}): tsServer.server.PluginModule;
+
+export { }

package/dist/workspace.d.ts

@@ -0,0 +1,11 @@
+import { type FormSpecAnalysisManifest, type FormSpecIpcEndpoint } from "@formspec/analysis";
+export interface FormSpecWorkspaceRuntimePaths {
+    readonly workspaceRoot: string;
+    readonly workspaceId: string;
+    readonly runtimeDirectory: string;
+    readonly manifestPath: string;
+    readonly endpoint: FormSpecIpcEndpoint;
+}
+export declare function getFormSpecWorkspaceRuntimePaths(workspaceRoot: string, platform?: NodeJS.Platform, userScope?: string): FormSpecWorkspaceRuntimePaths;
+export declare function createFormSpecAnalysisManifest(workspaceRoot: string, typescriptVersion: string, generation: number, extensionFingerprint?: string): FormSpecAnalysisManifest;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACxC;AAED,wBAAgB,gCAAgC,CAC9C,aAAa,EAAE,MAAM,EACrB,QAAQ,kBAAmB,EAC3B,SAAS,SAAyB,GACjC,6BAA6B,CAsB/B;AAED,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,EAClB,oBAAoB,SAAY,GAC/B,wBAAwB,CAa1B"}

package/index.cjs

@@ -0,0 +1 @@
+module.exports = require("./dist/index.cjs").init;

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@formspec/ts-plugin",
+  "version": "0.1.0-alpha.20",
+  "description": "TypeScript language service plugin for FormSpec semantic comment analysis",
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/ts-plugin.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/ts-plugin.d.ts",
+      "import": "./dist/index.js",
+      "require": "./index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "index.cjs",
+    "README.md"
+  ],
+  "dependencies": {
+    "@formspec/analysis": "0.1.0-alpha.20"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.52.12",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "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"
+  }
+}