@stylelint/language-server 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2019-current The Stylelint community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,39 @@
+# @stylelint/language-server
+
+The [Stylelint](https://stylelint.io/) language server, providing lint diagnostics, code actions, and more via the [Language Server Protocol](https://microsoft.github.io/language-server-protocol/).
+
+## Usage
+
+### As a standalone server
+
+Install the package globally or use `npx`:
+
+```sh
+npx @stylelint/language-server --stdio
+```
+
+The server communicates over stdio by default. Stylelint must be installed in the project you're linting. The language server resolves it from the workspace directory automatically.
+
+### As a library
+
+```ts
+import { createConnection, ProposedFeatures } from "vscode-languageserver";
+import { StylelintLanguageServer } from "@stylelint/language-server";
+
+const connection = createConnection(ProposedFeatures.all);
+
+const server = new StylelintLanguageServer({
+  connection,
+  logLevel: "info"
+});
+
+server.start();
+```
+
+## Configuration
+
+The server accepts configuration via LSP `workspace/configuration` requests. See the [vscode-stylelint documentation](https://github.com/stylelint/vscode-stylelint#readme) for available settings.
+
+## License
+
+[MIT](LICENSE)

package/bin/stylelint-language-server.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+import process from 'process';
+import { createConnection, ProposedFeatures } from 'vscode-languageserver';
+import { StylelintLanguageServer } from '../build/server/index.js';
+
+const connection = createConnection(ProposedFeatures.all);
+
+const server = new StylelintLanguageServer({
+	connection,
+	logLevel: process.env.STYLELINT_LOG_LEVEL || 'info',
+});
+
+server.start().catch((error) => {
+	const message = error instanceof Error ? error.stack || error.message : String(error);
+
+	try {
+		connection.console.error(`Stylelint language server failed to start: ${message}`);
+	} catch {
+		// ignore
+	}
+
+	process.stderr.write(`Stylelint language server failed to start: ${message}\n`);
+	process.exitCode = 1;
+});

package/build/di/container.d.ts

@@ -0,0 +1,12 @@
+import { InjectionToken } from './inject.js';
+import { ModuleMetadata } from './module.js';
+export interface CreateContainerOptions {
+    overrides?: Iterable<[InjectionToken<unknown>, unknown]>;
+}
+export interface Container {
+    resolve<T>(token: InjectionToken<T>): T;
+}
+/**
+ * Creates a dependency injection container from the provided modules.
+ */
+export declare function createContainer(modules: ModuleMetadata | ModuleMetadata[], options?: CreateContainerOptions): Container;

package/build/di/container.js

@@ -0,0 +1,76 @@
+import { getInitializationHooks } from './hooks.js';
+/**
+ * Describes an injection token for error messages.
+ */
+function describeToken(token) {
+    if (typeof token === 'function') {
+        return token.name || '<anonymous class>';
+    }
+    return token.description ?? token.toString();
+}
+/**
+ * Merges provider definitions from multiple modules into a single map.
+ */
+function mergeProviders(modules) {
+    const merged = new Map();
+    const moduleList = Array.isArray(modules) ? modules : [modules];
+    for (const moduleMetadata of moduleList) {
+        for (const [token, definition] of moduleMetadata.providers) {
+            if (merged.has(token)) {
+                throw new Error(`Token ${describeToken(token)} registered multiple times across modules`);
+            }
+            merged.set(token, definition);
+        }
+    }
+    return merged;
+}
+/**
+ * Creates a dependency injection container from the provided modules.
+ */
+export function createContainer(modules, options = {}) {
+    const mergedProviders = mergeProviders(modules);
+    const overrides = new Map(options.overrides ?? []);
+    const singletons = new Map();
+    const resolutionStack = [];
+    const resolve = (token) => {
+        if (overrides.has(token)) {
+            return overrides.get(token);
+        }
+        if (singletons.has(token)) {
+            return singletons.get(token);
+        }
+        const provider = mergedProviders.get(token);
+        if (!provider) {
+            throw new Error(`No provider found for ${describeToken(token)}`);
+        }
+        if (resolutionStack.includes(token)) {
+            const cycle = [...resolutionStack, token].map(describeToken).join(' -> ');
+            throw new Error(`Circular dependency detected: ${cycle}`);
+        }
+        resolutionStack.push(token);
+        try {
+            const dependencies = provider.inject.map((dependencyToken) => resolve(dependencyToken));
+            const instance = provider.create(...dependencies);
+            if (typeof token === 'function') {
+                const hooks = getInitializationHooks(token);
+                for (const hook of hooks) {
+                    hook({
+                        instance,
+                        token: token,
+                        dependencies,
+                        resolve,
+                    });
+                }
+            }
+            if (provider.scope === 'singleton') {
+                singletons.set(token, instance);
+            }
+            return instance;
+        }
+        finally {
+            resolutionStack.pop();
+        }
+    };
+    return { resolve };
+}
+//# sourceMappingURL=container.js.map

package/build/di/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/di/container.ts"],"names":[],"mappings":"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"}

package/build/di/hooks.d.ts

@@ -0,0 +1,16 @@
+import { Constructable, InjectionToken } from './inject.js';
+export interface InitializationHookContext<TInstance> {
+    instance: TInstance;
+    token: Constructable<TInstance>;
+    dependencies: readonly unknown[];
+    resolve<T>(token: InjectionToken<T>): T;
+}
+export type InitializationHook<TInstance> = (context: InitializationHookContext<TInstance>) => void;
+/**
+ * Registers an initialization hook for a specific constructable type.
+ */
+export declare function registerInitializationHook<T>(target: Constructable<T>, hook: InitializationHook<T>): void;
+/**
+ * Retrieves the initialization hooks registered for a specific constructable type.
+ */
+export declare function getInitializationHooks<T>(target: Constructable<T>): readonly InitializationHook<T>[];

package/build/di/hooks.js

@@ -0,0 +1,25 @@
+const initializationHooksKey = Symbol('diInitializationHooks');
+/**
+ * Registers an initialization hook for a specific constructable type.
+ */
+export function registerInitializationHook(target, hook) {
+    const hookableTarget = target;
+    if (hookableTarget[initializationHooksKey]) {
+        hookableTarget[initializationHooksKey].push(hook);
+        return;
+    }
+    Object.defineProperty(hookableTarget, initializationHooksKey, {
+        value: [hook],
+        writable: false,
+        configurable: false,
+        enumerable: false,
+    });
+}
+/**
+ * Retrieves the initialization hooks registered for a specific constructable type.
+ */
+export function getInitializationHooks(target) {
+    return (target[initializationHooksKey] ??
+        []);
+}
+//# sourceMappingURL=hooks.js.map

package/build/di/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/di/hooks.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAe/D;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACzC,MAAwB,EACxB,IAA2B;IAE3B,MAAM,cAAc,GAAG,MAAkC,CAAC;IAE1D,IAAI,cAAc,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAC5C,cAAc,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElD,OAAO;IACR,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,sBAAsB,EAAE;QAC7D,KAAK,EAAE,CAAC,IAAI,CAAC;QACb,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;KACjB,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACrC,MAAwB;IAExB,OAAO,CAAE,MAAmC,CAAC,sBAAsB,CAAC;QACnE,EAAE,CAAqC,CAAC;AAC1C,CAAC"}

package/build/di/index.d.ts

@@ -0,0 +1,7 @@
+export * from './container.js';
+export * from './hooks.js';
+export * from './inject.js';
+export * from './module.js';
+export * from './runtime/index.js';
+export * from './tokens.js';
+export * from './types.js';

package/build/di/index.js

@@ -0,0 +1,8 @@
+export * from './container.js';
+export * from './hooks.js';
+export * from './inject.js';
+export * from './module.js';
+export * from './runtime/index.js';
+export * from './tokens.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/build/di/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/di/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/build/di/inject.d.ts

@@ -0,0 +1,48 @@
+import { ClassDecoratorFunction } from './types.js';
+import { Token } from './tokens.js';
+export type Scope = 'singleton' | 'transient';
+export type Constructable<T> = abstract new (...args: any[]) => T;
+export interface InjectMetadata {
+    scope: Scope;
+    inject: InjectionToken[];
+}
+type InjectionTokenTuple<TParameters extends unknown[]> = TParameters extends [] ? [] : TParameters extends [infer Head, ...infer Tail] ? [InjectionToken<Head>, ...InjectionTokenTuple<Tail>] : InjectionToken<TParameters[number]>[];
+export interface InjectOptions<T extends Constructable<any>> {
+    scope?: Scope;
+    inject?: InjectionTokenTuple<ConstructorParameters<T>>;
+}
+export type InjectFunction<T> = Constructable<T> & {
+    __injectMetadata__: InjectMetadata;
+};
+export type InjectionToken<T = unknown> = Token<T> | Constructable<T>;
+export type ResolvedToken<TToken extends InjectionToken> = TToken extends Token<infer R> ? R : TToken extends Constructable<infer R> ? R : never;
+export type ResolvedTokens<TTokens extends readonly InjectionToken[]> = {
+    [Index in keyof TTokens]: TTokens[Index] extends InjectionToken<infer R> ? R : never;
+};
+/**
+ * Indicates that a class has dependencies to be injected by the DI container.
+ *
+ * @example
+ * ```ts
+ * @inject({
+ *   scope: 'singleton',
+ *   inject: [
+ *     ClassDependency,
+ *     dependencyToken,
+ *   ],
+ * })
+ * class MyClass {
+ *   constructor(
+ *     classDep: ClassDependency,
+ *     dependency: DependencyType,
+ *   ) {
+ *     // ...
+ *   }
+ * }
+ */
+export declare function inject<T extends new (...args: any[]) => any>(options?: InjectOptions<T>): ClassDecoratorFunction<T>;
+/**
+ * Retrieves injection metadata from a class, if available.
+ */
+export declare function getInjectMetadata<T>(func: Constructable<T>): InjectMetadata | undefined;
+export {};

package/build/di/inject.js

@@ -0,0 +1,55 @@
+/**
+ * Determines if a function has injection metadata.
+ */
+function isInjectFunction(func) {
+    return '__injectMetadata__' in func;
+}
+/**
+ * Indicates that a class has dependencies to be injected by the DI container.
+ *
+ * @example
+ * ```ts
+ * @inject({
+ *   scope: 'singleton',
+ *   inject: [
+ *     ClassDependency,
+ *     dependencyToken,
+ *   ],
+ * })
+ * class MyClass {
+ *   constructor(
+ *     classDep: ClassDependency,
+ *     dependency: DependencyType,
+ *   ) {
+ *     // ...
+ *   }
+ * }
+ */
+// Any type is used since otherwise there will be conflicts with constructor signatures.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function inject(options = {}) {
+    // Function type is required for decorators.
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    return function InjectDecorator(target) {
+        const injectMetadata = {
+            scope: options.scope ?? 'singleton',
+            inject: (options.inject ?? []),
+        };
+        Object.defineProperty(target, '__injectMetadata__', {
+            value: injectMetadata,
+            enumerable: false,
+            configurable: false,
+            writable: false,
+        });
+    };
+}
+/**
+ * Retrieves injection metadata from a class, if available.
+ */
+export function getInjectMetadata(func) {
+    if (isInjectFunction(func)) {
+        return func.__injectMetadata__;
+    }
+    return undefined;
+}
+//# sourceMappingURL=inject.js.map

package/build/di/inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../../src/di/inject.ts"],"names":[],"mappings":"AAwCA;;GAEG;AACH,SAAS,gBAAgB,CAAI,IAAsB;IAClD,OAAO,oBAAoB,IAAI,IAAI,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wFAAwF;AACxF,8DAA8D;AAC9D,MAAM,UAAU,MAAM,CACrB,UAA4B,EAAE;IAE9B,4CAA4C;IAC5C,sEAAsE;IACtE,OAAO,SAAS,eAAe,CAAC,MAAgB;QAC/C,MAAM,cAAc,GAAmB;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,WAAW;YACnC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAqB;SAClD,CAAC;QAEF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,oBAAoB,EAAE;YACnD,KAAK,EAAE,cAAc;YACrB,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,KAAK;YACnB,QAAQ,EAAE,KAAK;SACf,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAI,IAAsB;IAC1D,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,kBAAkB,CAAC;IAChC,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/build/di/module.d.ts

@@ -0,0 +1,51 @@
+import { PublicOnlyIfObject } from '../shared/types.js';
+import { Constructable, InjectionToken, Scope } from './inject.js';
+export interface FactoryRegistration<T = unknown, Deps extends readonly unknown[] = []> {
+    token: InjectionToken<T>;
+    useFactory: (...deps: Deps) => PublicOnlyIfObject<T>;
+    inject?: InjectionToken[];
+    scope?: Scope;
+}
+export type ModuleRegistryEntry<T = unknown, D extends readonly unknown[] = any[]> = Constructable<T> | FactoryRegistration<T, D>;
+export interface ModuleOptions {
+    imports?: ModuleMetadata[];
+    register?: ModuleRegistryEntry[];
+}
+export interface ProviderDefinition<T = unknown> {
+    token: InjectionToken<T>;
+    scope: Scope;
+    inject: InjectionToken[];
+    create: (...deps: unknown[]) => T;
+}
+export interface ModuleMetadata {
+    providers: Map<InjectionToken<unknown>, ProviderDefinition>;
+}
+/**
+ * Creates metadata for a dependency injection module.
+ *
+ * @example
+ * ```ts
+ * const myModule = module({
+ *   register: [
+ *     MyClass,
+ *     { token: myToken, useFactory: () => new Dependency() },
+ *     {
+ *       token: otherToken,
+ *       useFactory: (MyClass) => ...,
+ *       inject: [MyClass],
+ *     },
+ *   ],
+ * });
+ * ```
+ * @param options Module options.
+ */
+export declare function module(options?: ModuleOptions): ModuleMetadata;
+/**
+ * Shorthand to create a factory registration that does not require dependencies.
+ */
+export declare function provideValue<T>(token: InjectionToken<T>, factory: () => PublicOnlyIfObject<T>, scope?: Scope): FactoryRegistration<T>;
+/**
+ * Shorthand to create a factory registration that does not require dependencies.
+ * Allows providing a partial implementation of an object type.
+ */
+export declare function provideTestValue<T>(token: InjectionToken<T>, factory: () => Partial<PublicOnlyIfObject<T>>, scope?: Scope): FactoryRegistration<T>;

package/build/di/module.js

@@ -0,0 +1,93 @@
+import { getInjectMetadata } from './inject.js';
+/**
+ * Describes an injection token for error messages.
+ */
+function describeToken(token) {
+    if (typeof token === 'function') {
+        return token.name || '<anonymous class>';
+    }
+    return token.description ?? token.toString();
+}
+/**
+ * Creates a provider definition for a class constructor.
+ */
+function createClassProvider(ctor) {
+    const injectMetadata = getInjectMetadata(ctor);
+    if (!injectMetadata) {
+        throw new Error(`Class ${ctor.name || '<anonymous>'} must be decorated with @inject to be registered`);
+    }
+    const concreteCtor = ctor;
+    return {
+        token: ctor,
+        scope: injectMetadata.scope,
+        inject: [...injectMetadata.inject],
+        create: (...deps) => new concreteCtor(...deps),
+    };
+}
+/**
+ * Creates a provider definition for a factory function.
+ */
+function createFactoryProvider(entry) {
+    return {
+        token: entry.token,
+        scope: entry.scope ?? 'singleton',
+        inject: entry.inject ? [...entry.inject] : [],
+        create: (...deps) => entry.useFactory(...deps),
+    };
+}
+/**
+ * Creates metadata for a dependency injection module.
+ *
+ * @example
+ * ```ts
+ * const myModule = module({
+ *   register: [
+ *     MyClass,
+ *     { token: myToken, useFactory: () => new Dependency() },
+ *     {
+ *       token: otherToken,
+ *       useFactory: (MyClass) => ...,
+ *       inject: [MyClass],
+ *     },
+ *   ],
+ * });
+ * ```
+ * @param options Module options.
+ */
+export function module(options = {}) {
+    const providers = new Map();
+    if (options.imports) {
+        for (const importedModule of options.imports) {
+            for (const [token, definition] of importedModule.providers) {
+                if (providers.has(token)) {
+                    throw new Error(`Token ${describeToken(token)} registered multiple times while importing modules`);
+                }
+                providers.set(token, definition);
+            }
+        }
+    }
+    if (options.register) {
+        for (const entry of options.register) {
+            const provider = typeof entry === 'function' ? createClassProvider(entry) : createFactoryProvider(entry);
+            if (providers.has(provider.token)) {
+                throw new Error(`Token ${describeToken(provider.token)} registered multiple times in module()`);
+            }
+            providers.set(provider.token, provider);
+        }
+    }
+    return { providers };
+}
+/**
+ * Shorthand to create a factory registration that does not require dependencies.
+ */
+export function provideValue(token, factory, scope) {
+    return (scope ? { token, useFactory: factory, scope } : { token, useFactory: factory });
+}
+/**
+ * Shorthand to create a factory registration that does not require dependencies.
+ * Allows providing a partial implementation of an object type.
+ */
+export function provideTestValue(token, factory, scope) {
+    return (scope ? { token, useFactory: factory, scope } : { token, useFactory: factory });
+}
+//# sourceMappingURL=module.js.map

package/build/di/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/di/module.ts"],"names":[],"mappings":"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"}

package/build/di/runtime/application.d.ts

@@ -0,0 +1,17 @@
+import type { InjectionToken } from '../inject.js';
+import type { ModuleMetadata } from '../module.js';
+import type { RuntimeFeature } from './types.js';
+export interface RuntimeApplicationOptions {
+    modules: ModuleMetadata[];
+    overrides?: Iterable<[InjectionToken<unknown>, unknown]>;
+    features?: RuntimeFeature[];
+}
+export interface RuntimeApplication {
+    start(): Promise<void>;
+    dispose(): Promise<void>;
+    resolve<T>(token: InjectionToken<T>): T;
+}
+/**
+ * Creates a runtime application backed by the shared dependency injection container.
+ */
+export declare function createRuntimeApplication(options: RuntimeApplicationOptions): RuntimeApplication;