@teacss/language-server 0.4.7 → 0.5.0

package/README.md

@@ -1,51 +1,27 @@
 # @teacss/language-server
 
-**LSP server for TeaCSS editor features.**
-
-## Purpose
-
-The server wraps `@teacss/language-service` as a Language Server Protocol host.
-Its standalone `server` entry can run over stdio, while the bundled VS Code
-host runs the same server over Node IPC.
-
-Use this package when an editor client needs a standalone TeaCSS Language
-Server Protocol process or when an editor adapter needs the exported capability
-registrars. It owns LSP transport, workspace settings, document synchronization,
-and config watchers; `@teacss/language-service` owns the transport-neutral
-feature calculations, while `@teacss/vscode` supplies the ready-made VS Code
-host.
-
-## Usage
+Language Server Protocol host for TeaCSS editor features.
 
 ```sh
 teacss-language-server --stdio
 ```
 
-It provides completion, hover previews, color support, workspace-wide
-references, diagnostics, Quick Fixes, canonical class-value edits, and
-token-level semantic highlighting. Editor adapters can request class edits
-through `teacss/normalizeClasses`; the resolved edits preserve unknown classes.
+The server wraps `@teacss/language-service` with LSP transport, document
+synchronization, workspace settings, and configuration watchers. It provides
+completion, hover, colors, references, diagnostics, Quick Fixes, semantic
+tokens, and `teacss/normalizeClasses` edits.
 
-Settings live under the `teacss` namespace, including `teacss.syntaxHighlight`,
-`teacss.colorPreview`, and `teacss.autocomplete.maxItems`.
-Settings are normalized at the server boundary. Incremental updates preserve
-omitted values, including sibling fields under `autocomplete`. Completion
-limits are whole numbers from `0` through `10,000`, rem preview ratios must be
-finite positive numbers, and malformed types or unsupported enums safely
-retain the current setting. Finite completion limits are floored and clamped
-to the documented range.
+Settings use the `teacss` namespace. Updates preserve omitted values.
+Completion limits are clamped to whole numbers from 0 through 10,000; rem
+preview ratios must be finite and positive; malformed settings retain their
+current values.
 
-The server watches active entry and preset sources directly. Before any entry
-exists, a broad CSS fallback supports discovery without reloading for unrelated
-stylesheets. Once configured, root-scoped entry-topology watchers and exact
-targets from nested `package.json#teacss.entry` declarations keep nearest-entry
-resolution live without retaining the broad CSS subscription. Nested-manifest
-scans and entry-topology reload filtering skip `node_modules`, `dist`, `.temp`,
-`.cache`, and `.git`; active config sources remain watched even there.
-Workspace-folder additions and removals update active roots without restarting
-the server. Config reloads and root changes republish diagnostics for open
-documents. Unrelated settings do not refresh semantic tokens.
+The server watches active entry and preset sources. Before discovery it watches
+CSS broadly within the workspace; after discovery it narrows to entry topology
+and exact configuration sources. Workspace-folder changes update roots without
+a restart, and configuration changes republish diagnostics for open documents.
 
-## Status
+Use `@teacss/language-service` for transport-neutral integration or
+`@teacss/vscode` for the bundled VS Code host.
 
-Pre-1.0. Used by the TeaCSS VS Code extension.
+Pre-1.0.

package/dist/index.d.ts

@@ -6,28 +6,27 @@ type WaitUntilInitialized = () => PromiseLike<void>;
 //#endregion
 //#region src/capabilities/colorProvider.d.ts
 /** Thin LSP adapter: forwards document-color requests to the language service. */
-declare function registerColorProvider(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
+export declare function registerColorProvider(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
 //#endregion
 //#region src/capabilities/completion.d.ts
 /**
  * Thin LSP adapter: forwards completion + completion-resolve requests to the
  * language service. The service owns the autocomplete instances and their cache.
  */
-declare function registerCompletion(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
+export declare function registerCompletion(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
 //#endregion
 //#region src/capabilities/hover.d.ts
 /** Thin LSP adapter: forwards `textDocument/hover` to the language service. */
-declare function registerHover(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
+export declare function registerHover(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
 //#endregion
 //#region src/capabilities/references.d.ts
 /** Thin LSP adapter: forwards `textDocument/references` to the language service. */
-declare function registerReferences(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
+export declare function registerReferences(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
 //#endregion
 //#region src/capabilities/semanticTokens.d.ts
 /**
  * Thin LSP adapter: forwards a `textDocument/semanticTokens/full` request to the
  * language service, which produces TeaCSS token-part highlighting.
  */
-declare function registerSemanticTokens(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
-//#endregion
-export { registerColorProvider, registerCompletion, registerHover, registerReferences, registerSemanticTokens };
+export declare function registerSemanticTokens(connection: Connection, documents: TextDocuments<TextDocument>, getService: () => TeacssLanguageService | undefined, waitUntilInitialized?: WaitUntilInitialized): void;
+//#endregion