@justscale/typescript 0.1.1

package/dist/di-errors/formatter.js

@@ -0,0 +1,384 @@
+/**
+ * Parses and formats DI type errors into human-readable messages.
+ * Detects errors via branded markers (__brand, _missing, _hint) from MissingDepsError.
+ * Error codes: DI1001 missing deps, DI1002 circular, DI1003 unsatisfied constraint.
+ */
+import ts from 'typescript';
+/**
+ * Custom error codes for dependency injection.
+ * Range: DI1000-DI9999
+ *
+ * These are offset by 200000 to avoid collision with TypeScript codes
+ * (100000 range is used by TSP process errors).
+ */
+export const DIErrorCode = {
+    /**
+     * DI1001: Missing dependencies.
+     *
+     * A component requires dependencies that haven't been added to the builder.
+     * Add the missing services/repositories before this component.
+     *
+     * Example:
+     *   .add(UserService)  // Error: requires ModelRepository<User>
+     *
+     * Fix:
+     *   .add(ModelRepository.of(User).bind(PgUser))
+     *   .add(UserService)  // Now works
+     */
+    MissingDependencies: 1001,
+    /**
+     * DI1002: Circular dependency detected.
+     *
+     * Two or more components depend on each other in a cycle.
+     * Refactor to break the cycle using interfaces or lazy injection.
+     */
+    CircularDependency: 1002,
+    /**
+     * DI1003: Unsatisfied constraint.
+     *
+     * A type constraint (RequiresSatisfied) was not met.
+     */
+    UnsatisfiedConstraint: 1003,
+};
+/**
+ * Base offset for DI error codes to avoid collision with TS/TSP codes.
+ */
+const DI_CODE_OFFSET = 200000;
+/**
+ * Format error code for display.
+ */
+export function formatDIErrorCode(code) {
+    return `DI${code}`;
+}
+/**
+ * Check if a diagnostic is a DI-specific error.
+ */
+export function isDIDiagnostic(diagnostic) {
+    return diagnostic.source === 'justscale-di';
+}
+/**
+ * Get the DI error code from a diagnostic.
+ */
+export function getDIErrorCode(diagnostic) {
+    if (!isDIDiagnostic(diagnostic))
+        return null;
+    return (diagnostic.code - DI_CODE_OFFSET);
+}
+/**
+ * Markers that indicate a DI-related type error.
+ * These come from the MissingDepsError interface in builder/types.ts:
+ *   interface MissingDepsError<_C, TMissing> {
+ *     readonly __brand: 'MissingDependencies'
+ *     readonly _missing: TMissing
+ *     readonly _hint: 'Add the missing dependencies before this component'
+ *   }
+ */
+/**
+ * Common token patterns and their human-readable formats.
+ */
+const TOKEN_PATTERNS = [
+    // ModelRepositoryToken<User, {}> or ModelRepositoryToken<User> -> ModelRepository<User>
+    {
+        pattern: /^ModelRepositoryToken<([^,<>]+)(?:,\s*\{[^}]*\})?>$/,
+        format: (m) => `ModelRepository<${m[1].trim()}>`,
+    },
+    // RepositoryToken<User> -> Repository<User>
+    {
+        pattern: /^RepositoryToken<([^<>]+)>$/,
+        format: (m) => `Repository<${m[1].trim()}>`,
+    },
+    // typeof AbstractEmailSender -> AbstractEmailSender
+    {
+        pattern: /^typeof\s+(\w+)$/,
+        format: (m) => m[1],
+    },
+    // ServiceDef<SomeType, {...}> -> Service creating SomeType
+    {
+        pattern: /^ServiceDef<([^,<>]+)(?:,\s*\{[^}]*\})?>$/,
+        format: (m) => `Service<${m[1].trim()}>`,
+    },
+    // FeatureToken<[...], [...]> -> Feature (we'll get name from context)
+    {
+        pattern: /^FeatureToken<\[([^\]]*)\],\s*\[([^\]]*)\]>$/,
+        format: () => 'Feature',
+    },
+];
+/**
+ * Format a single token type string to a human-readable name.
+ */
+export function formatTokenName(typeStr) {
+    const trimmed = typeStr.trim();
+    // Try each pattern
+    for (const { pattern, format } of TOKEN_PATTERNS) {
+        const match = trimmed.match(pattern);
+        if (match) {
+            return format(match);
+        }
+    }
+    // Fallback: clean up common noise
+    return trimmed
+        .replace(/\s*\{\s*\}/g, '') // Remove empty objects
+        .replace(/\s*\[\.\.\.\]/g, '') // Remove [...]
+        .replace(/\s+/g, ' '); // Normalize whitespace
+}
+/**
+ * Parse a union type string into individual types.
+ * Handles nested generics correctly.
+ *
+ * Example: "A<B> | C | D<E, F>" -> ["A<B>", "C", "D<E, F>"]
+ */
+export function parseUnionType(typeStr) {
+    const results = [];
+    let current = '';
+    let depth = 0;
+    for (const char of typeStr) {
+        if (char === '<' || char === '[' || char === '(') {
+            depth++;
+            current += char;
+        }
+        else if (char === '>' || char === ']' || char === ')') {
+            depth--;
+            current += char;
+        }
+        else if (char === '|' && depth === 0) {
+            const trimmed = current.trim();
+            if (trimmed) {
+                results.push(trimmed);
+            }
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    const trimmed = current.trim();
+    if (trimmed) {
+        results.push(trimmed);
+    }
+    return results;
+}
+/**
+ * Extract the inner types from a generic type.
+ * Example: "MissingDepsError<A, B>" -> ["A", "B"]
+ */
+export function extractGenericArgs(typeStr) {
+    const start = typeStr.indexOf('<');
+    if (start === -1)
+        return [];
+    // Find matching >
+    let depth = 1;
+    let end = start + 1;
+    for (; end < typeStr.length && depth > 0; end++) {
+        if (typeStr[end] === '<')
+            depth++;
+        else if (typeStr[end] === '>')
+            depth--;
+    }
+    const inner = typeStr.slice(start + 1, end - 1);
+    // Split by top-level commas
+    const args = [];
+    let current = '';
+    depth = 0;
+    for (const char of inner) {
+        if (char === '<' || char === '[' || char === '(') {
+            depth++;
+            current += char;
+        }
+        else if (char === '>' || char === ']' || char === ')') {
+            depth--;
+            current += char;
+        }
+        else if (char === ',' && depth === 0) {
+            args.push(current.trim());
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current.trim()) {
+        args.push(current.trim());
+    }
+    return args;
+}
+/**
+ * Check if a type string contains DI error markers.
+ * Looks for the branded fields from MissingDepsError:
+ *   - __brand: 'MissingDependencies'
+ *   - _missing: <type>
+ *   - _hint: 'Add the missing dependencies...'
+ */
+export function hasDIErrorMarkers(typeStr) {
+    // Look for the branded markers
+    return (
+    // __brand: "MissingDependencies" or __brand: 'MissingDependencies'
+    /\b__brand\s*:\s*["']MissingDependencies["']/.test(typeStr) ||
+        // _missing: <some type>
+        /\b_missing\s*:/.test(typeStr) ||
+        // _hint: "Add the missing dependencies..."
+        /\b_hint\s*:\s*["']Add the missing dependencies/.test(typeStr) ||
+        // The generic type name itself
+        typeStr.includes('MissingDepsError'));
+}
+/**
+ * Extract the _missing type value from a type string.
+ * Looks for patterns like: _missing: TypeA | TypeB
+ */
+function extractMissingFromBrandedType(typeStr) {
+    // Match _missing: <type> where type ends at ; or }
+    const match = typeStr.match(/_missing\s*:\s*([^;}\n]+)/);
+    if (match) {
+        return match[1].trim();
+    }
+    return null;
+}
+/**
+ * Parse a MissingDepsError type string.
+ * Handles both:
+ *   1. Generic form: MissingDepsError<Component, Missing>
+ *   2. Structural form: { __brand: 'MissingDependencies'; _missing: Type; _hint: ... }
+ *
+ * @param typeStr The full type string
+ * @returns Parsed error info, or null if not a MissingDepsError
+ */
+export function parseMissingDepsError(typeStr) {
+    // First, check for structural form with _missing field
+    const missingFromBranded = extractMissingFromBrandedType(typeStr);
+    if (missingFromBranded) {
+        const missingDeps = parseUnionType(missingFromBranded);
+        return {
+            component: null,
+            componentName: 'component',
+            missingDeps,
+            missingDepNames: missingDeps.map(formatTokenName),
+        };
+    }
+    // Try generic form: MissingDepsError<Component, Missing>
+    if (!typeStr.includes('MissingDepsError')) {
+        return null;
+    }
+    // Find the MissingDepsError part
+    const match = typeStr.match(/MissingDepsError</);
+    if (!match)
+        return null;
+    const startIdx = typeStr.indexOf('MissingDepsError<');
+    let depth = 1;
+    let endIdx = startIdx + 'MissingDepsError<'.length;
+    for (; endIdx < typeStr.length && depth > 0; endIdx++) {
+        if (typeStr[endIdx] === '<')
+            depth++;
+        else if (typeStr[endIdx] === '>')
+            depth--;
+    }
+    const errorPart = typeStr.slice(startIdx, endIdx);
+    const args = extractGenericArgs(errorPart);
+    if (args.length < 2) {
+        return null;
+    }
+    const [component, missing] = args;
+    const missingDeps = parseUnionType(missing);
+    return {
+        component,
+        componentName: formatTokenName(component),
+        missingDeps,
+        missingDepNames: missingDeps.map(formatTokenName),
+    };
+}
+/**
+ * Format a parsed DI error into a human-readable message.
+ * Includes the DI error code prefix.
+ */
+export function formatDIError(parsed, code = DIErrorCode.MissingDependencies) {
+    const codePrefix = formatDIErrorCode(code);
+    const lines = [];
+    lines.push(`${codePrefix}: Missing dependencies for ${parsed.componentName}:`);
+    lines.push('');
+    for (const depName of parsed.missingDepNames) {
+        lines.push(`  - ${depName}`);
+    }
+    lines.push('');
+    lines.push('Hint: Add the missing dependencies before this component using .add()');
+    lines.push('      For repositories, use ModelRepository.of(Model).bind(StorageModel)');
+    return lines.join('\n');
+}
+/**
+ * Check if a diagnostic is a DI-related type error.
+ * Uses the branded markers (__brand, _missing, _hint) for reliable detection.
+ */
+export function isDITypeDiagnostic(diagnostic) {
+    const messageText = getDiagnosticMessageText(diagnostic);
+    return (
+    // Check for branded markers first (most reliable)
+    hasDIErrorMarkers(messageText) ||
+        // Fallback patterns for edge cases
+        messageText.includes('RequiresSatisfied') ||
+        (messageText.includes('is not assignable') && messageText.includes('FeatureToken')));
+}
+/**
+ * Get the full message text from a diagnostic.
+ */
+function getDiagnosticMessageText(diagnostic) {
+    if (typeof diagnostic.messageText === 'string') {
+        return diagnostic.messageText;
+    }
+    // DiagnosticMessageChain - flatten it
+    return flattenDiagnosticMessageChain(diagnostic.messageText);
+}
+/**
+ * Flatten a diagnostic message chain into a single string.
+ */
+function flattenDiagnosticMessageChain(chain) {
+    let result = chain.messageText;
+    if (chain.next) {
+        for (const next of chain.next) {
+            result += '\n' + flattenDiagnosticMessageChain(next);
+        }
+    }
+    return result;
+}
+/**
+ * Try to rewrite a diagnostic with better DI error formatting.
+ * Returns null if the diagnostic shouldn't be rewritten.
+ */
+export function rewriteDIDiagnostic(diagnostic) {
+    if (!isDITypeDiagnostic(diagnostic)) {
+        return null;
+    }
+    const messageText = getDiagnosticMessageText(diagnostic);
+    const parsed = parseMissingDepsError(messageText);
+    if (!parsed) {
+        return null;
+    }
+    const errorCode = DIErrorCode.MissingDependencies;
+    const newMessage = formatDIError(parsed, errorCode);
+    return {
+        ...diagnostic,
+        messageText: newMessage,
+        code: DI_CODE_OFFSET + errorCode,
+        source: 'justscale-di',
+    };
+}
+/**
+ * Create a DI diagnostic from scratch.
+ */
+export function createDIDiagnostic(code, file, start, length, message) {
+    return {
+        file,
+        start,
+        length,
+        messageText: `${formatDIErrorCode(code)}: ${message}`,
+        category: ts.DiagnosticCategory.Error,
+        code: DI_CODE_OFFSET + code,
+        source: 'justscale-di',
+    };
+}
+/**
+ * Process diagnostics and rewrite DI errors with better messages.
+ */
+export function processDIDiagnostics(diagnostics) {
+    return diagnostics.map((diag) => {
+        const rewritten = rewriteDIDiagnostic(diag);
+        return rewritten ?? diag;
+    });
+}
+//# sourceMappingURL=formatter.js.map

package/dist/di-errors/formatter.js.map

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

package/dist/di-errors/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * DI error codes and diagnostics. See formatter.ts for details.
+ */
+export { DIErrorCode, formatDIErrorCode, isDIDiagnostic, getDIErrorCode, createDIDiagnostic, formatTokenName, parseUnionType, extractGenericArgs, hasDIErrorMarkers, parseMissingDepsError, formatDIError, isDITypeDiagnostic, rewriteDIDiagnostic, processDIDiagnostics, type ParsedDIError, } from './formatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/di-errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/di-errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,EAElB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EAErB,aAAa,EAEb,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EAEpB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/di-errors/index.js

@@ -0,0 +1,13 @@
+/**
+ * DI error codes and diagnostics. See formatter.ts for details.
+ */
+export { 
+// Error codes
+DIErrorCode, formatDIErrorCode, isDIDiagnostic, getDIErrorCode, createDIDiagnostic, 
+// Parsing utilities
+formatTokenName, parseUnionType, extractGenericArgs, hasDIErrorMarkers, parseMissingDepsError, 
+// Formatting
+formatDIError, 
+// Diagnostic processing
+isDITypeDiagnostic, rewriteDIDiagnostic, processDIDiagnostics, } from './formatter.js';
+//# sourceMappingURL=index.js.map

package/dist/di-errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/di-errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO;AACL,cAAc;AACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB;AAClB,oBAAoB;AACpB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB;AACrB,aAAa;AACb,aAAa;AACb,wBAAwB;AACxB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,gBAAgB,CAAC"}

package/dist/editor.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @justscale/typescript/editor
+ *
+ * Exports the QuickFixDefinition interface for packages that contribute
+ * IDE quick fixes via the "justscale" field in package.json.
+ *
+ * Usage:
+ *   import type { QuickFixDefinition } from '@justscale/typescript/editor'
+ */
+export type { QuickFixDefinition } from './language-service/quick-fix-discovery.js';
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/editor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=editor.js.map

package/dist/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @justscale/typescript
+ *
+ * Drop-in TypeScript replacement with JustScale process compilation support.
+ *
+ * Features:
+ * - ptsc: Drop-in replacement for tsc with process diagnostics (TSPxxxx)
+ * - ptscserver: Drop-in replacement for tsserver with IDE support
+ * - LSP plugin: Language service plugin for VS Code and other IDEs
+ * - Programmatic API: Transpile processes programmatically
+ * - Configuration: Custom tsconfig.json section for JustScale options
+ *
+ * Quick Start:
+ * ```bash
+ * # Install
+ * npm install @justscale/typescript typescript
+ *
+ * # Use ptsc instead of tsc
+ * npx ptsc
+ *
+ * # Or configure VS Code
+ * # Add to settings.json:
+ * # "typescript.tsdk": "node_modules/@justscale/typescript/lib"
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createProcessTransformer, compileProcessSource, compileProcessFile, formatDiagnostics, analyzeHandler, ProcessErrorCode, createProcessDiagnostic, formatErrorCode, isProcessDiagnostic, getProcessErrorCode, DiagnosticCollector, cli, detectChanges, mightContainServices, } from './compiler/index.js';
+export type { ServiceChange, ChangeDetectionResult, } from './compiler/hmr-change-detector.js';
+export type { ProcessCompilerOptions, CompileResult, AnalysisResult, BlockDefinition, SignalInfo, VariableInfo, } from './compiler/index.js';
+export { parseConfig, findConfig, isProcessFile, defaultConfig, mergeConfig, } from './config/index.js';
+export type { JustScaleConfig, ParsedConfig, PluginConfig, } from './config/index.js';
+export { transpile, transpileProject, createProgram, getProcessDiagnostics, } from './api.js';
+export type { TranspileResult, TranspileProjectResult, TranspileOptions, } from './api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,GAAG,EAGH,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,aAAa,EACb,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * @justscale/typescript
+ *
+ * Drop-in TypeScript replacement with JustScale process compilation support.
+ *
+ * Features:
+ * - ptsc: Drop-in replacement for tsc with process diagnostics (TSPxxxx)
+ * - ptscserver: Drop-in replacement for tsserver with IDE support
+ * - LSP plugin: Language service plugin for VS Code and other IDEs
+ * - Programmatic API: Transpile processes programmatically
+ * - Configuration: Custom tsconfig.json section for JustScale options
+ *
+ * Quick Start:
+ * ```bash
+ * # Install
+ * npm install @justscale/typescript typescript
+ *
+ * # Use ptsc instead of tsc
+ * npx ptsc
+ *
+ * # Or configure VS Code
+ * # Add to settings.json:
+ * # "typescript.tsdk": "node_modules/@justscale/typescript/lib"
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Re-export compiler functionality
+export { createProcessTransformer, compileProcessSource, compileProcessFile, formatDiagnostics, analyzeHandler, ProcessErrorCode, createProcessDiagnostic, formatErrorCode, isProcessDiagnostic, getProcessErrorCode, DiagnosticCollector, cli, 
+// HMR change detection (pure library fn, consumed by @justscale/core
+// /hmr-watcher in dev mode to pick method-patch vs full-reload).
+detectChanges, mightContainServices, } from './compiler/index.js';
+// Re-export configuration
+export { parseConfig, findConfig, isProcessFile, defaultConfig, mergeConfig, } from './config/index.js';
+// Re-export programmatic API
+export { transpile, transpileProject, createProgram, getProcessDiagnostics, } from './api.js';
+// Protobuf and Cap'n Proto integrations are not shipped in 0.x.
+// They live in private compiler plugins and will graduate to a separate
+// `@justscale/format-*` family once the plugin contract stabilises.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,mCAAmC;AACnC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,GAAG;AACH,qEAAqE;AACrE,iEAAiE;AACjE,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAgB7B,0BAA0B;AAC1B,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAQ3B,6BAA6B;AAC7B,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAQlB,gEAAgE;AAChE,wEAAwE;AACxE,oEAAoE"}

package/dist/language-service/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * TypeScript Language Service Plugin for @justscale/typescript
+ *
+ * Provides enhanced IDE support:
+ * - TSPxxxx diagnostics for JustScale processes
+ * - Proto and Cap'n Proto schema integration (.proto, .capnp files)
+ * - Human-readable DI error messages
+ *
+ * Based on TypeScriptToLua's plugin pattern.
+ *
+ * Usage in tsconfig.json:
+ * {
+ *   "compilerOptions": {
+ *     "plugins": [{ "name": "@justscale/typescript/language-service" }]
+ *   }
+ * }
+ */
+import type ts from 'typescript';
+import '../plugins/index.js';
+type TS = typeof ts;
+type LanguageService = ts.LanguageService;
+interface ServerHost {
+    readFile(path: string, encoding?: string): string | undefined;
+}
+interface Project {
+    log(message: string): void;
+    getProjectName(): string;
+}
+interface LanguageServiceHost {
+    getScriptSnapshot(fileName: string): ts.IScriptSnapshot | undefined;
+    getScriptVersion(fileName: string): string;
+}
+interface PluginCreateInfo {
+    languageService: LanguageService;
+    languageServiceHost: LanguageServiceHost;
+    project: Project;
+    serverHost: ServerHost;
+}
+interface PluginModule {
+    create(info: PluginCreateInfo): LanguageService;
+}
+interface PluginModuleFactory {
+    (mod: {
+        typescript: TS;
+    }): PluginModule;
+}
+/**
+ * Plugin factory - entry point for TypeScript Language Service.
+ */
+declare const init: PluginModuleFactory;
+export default init;
+//# sourceMappingURL=index.d.ts.map

package/dist/language-service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/language-service/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,qBAAqB,CAAC;AAW7B,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC;AACpB,KAAK,eAAe,GAAG,EAAE,CAAC,eAAe,CAAC;AAU1C,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9D;AAED,UAAU,OAAO;IACf,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,cAAc,IAAI,MAAM,CAAA;CACzB;AA+WD,UAAU,mBAAmB;IAC3B,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,eAAe,GAAG,SAAS,CAAA;IACnE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;CAC3C;AAED,UAAU,gBAAgB;IACxB,eAAe,EAAE,eAAe,CAAA;IAChC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;CACvB;AAED,UAAU,YAAY;IACpB,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAAA;CAChD;AAED,UAAU,mBAAmB;IAC3B,CAAC,GAAG,EAAE;QAAE,UAAU,EAAE,EAAE,CAAA;KAAE,GAAG,YAAY,CAAA;CACxC;AAeD;;GAEG;AACH,QAAA,MAAM,IAAI,EAAE,mBAaX,CAAC;AAGF,eAAe,IAAI,CAGlB"}