@skastr0/quartz-engine 0.2.0

package/dist/leaf-operations.d.ts

@@ -0,0 +1,26 @@
+import type { ErrorExplanationIssue, ExpandedType, FileInspectionResult, ListSymbolsOptions, PackageInfo, SearchTypesOptions, SymbolListResult, TypeAnalyzer, TypeAtPositionResult, TypeEvaluationResult, TypeExplanationResult, TypeInfo } from "./contracts";
+import { AnalyzerContext } from "./context";
+export interface LeafOperations {
+    readonly getPackages: () => Promise<readonly PackageInfo[]>;
+    readonly listSymbols: (options?: ListSymbolsOptions) => Promise<SymbolListResult>;
+    readonly getTypeInfo: (symbolName: string, packageName?: string) => Promise<TypeInfo | null>;
+    readonly expandType: (symbolName: string, packageName?: string) => Promise<ExpandedType | null>;
+    readonly searchTypes: (options: SearchTypesOptions) => Promise<readonly TypeInfo[]>;
+    readonly evalType: (expression: string, packageName?: string) => Promise<TypeEvaluationResult>;
+    readonly getFileDeclarations: (file: string, options?: {
+        readonly symbol?: string;
+        readonly includePrivate?: boolean;
+        readonly packageName?: string;
+    }) => Promise<FileInspectionResult | null>;
+    readonly checkCompatibility: (from: string, to: string, packageName?: string) => Promise<{
+        readonly compatible: boolean;
+        readonly from: string;
+        readonly to: string;
+        readonly reason?: string;
+        readonly issues?: readonly ErrorExplanationIssue[];
+    }>;
+    readonly getDiagnostics: TypeAnalyzer["getDiagnostics"];
+    readonly getTypeAtPosition: (filePath: string, line: number, column: number, packageName?: string) => Promise<TypeAtPositionResult | null>;
+    readonly explainType: (expression: string, packageName?: string) => Promise<TypeExplanationResult>;
+}
+export declare const createLeafOperations: (context: AnalyzerContext) => LeafOperations;

package/dist/reference-operations.d.ts

@@ -0,0 +1,11 @@
+import type { AnalyzerContext } from "./context";
+import type { GraphResult, RefactorPreviewResult, RefactorPreviewOptions, RelatedInfo } from "./contracts";
+export declare const createReferenceOperations: (context: AnalyzerContext) => {
+    findRelated: (symbolName: string, packageName?: string) => Promise<RelatedInfo | null>;
+    generateGraph: (symbolName: string, options?: {
+        readonly depth?: number;
+        readonly format?: "mermaid" | "dot";
+        readonly packageName?: string;
+    }) => Promise<GraphResult | null>;
+    previewRefactor: (options: RefactorPreviewOptions) => Promise<RefactorPreviewResult>;
+};

package/dist/transform-search/index.d.ts

@@ -0,0 +1,8 @@
+import type { AnalyzerContext } from "../context";
+import type { TransformSearchOptions, TransformSearchResponse } from "../contracts";
+export type TransformSearchOperation = (options: TransformSearchOptions & {
+    readonly packageName?: string;
+}) => Promise<TransformSearchResponse>;
+export declare const createTransformSearchOperation: (context: AnalyzerContext) => (options: TransformSearchOptions & {
+    readonly packageName?: string;
+}) => Promise<TransformSearchResponse>;

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+export type DiagnosticSeverity = "error" | "warning" | "suggestion" | "message";
+export interface EngineDiagnostic {
+    readonly file: string | null;
+    readonly line: number | null;
+    readonly column: number | null;
+    readonly endLine: number | null;
+    readonly endColumn: number | null;
+    readonly code: number;
+    readonly severity: DiagnosticSeverity;
+    readonly message: string;
+}
+export interface WorkspaceFileChanges {
+    readonly changed?: readonly string[];
+    readonly created?: readonly string[];
+    readonly deleted?: readonly string[];
+}
+export interface WorkspaceMetadata {
+    readonly root: string;
+    readonly configFile: string;
+    readonly configFiles: readonly string[];
+    readonly revision: number;
+    readonly analysisTypescriptVersion: string;
+    readonly closed: boolean;
+}
+export interface WorkspaceOptions {
+    readonly tsconfigPath?: string;
+    readonly tsconfigPaths?: readonly string[];
+    readonly collectTiming?: boolean;
+    readonly tsserverPath?: string;
+}

package/dist/verification-operations.d.ts

@@ -0,0 +1,19 @@
+import { type Project } from "typescript/unstable/async";
+import type { AnalyzerContext } from "./context";
+import type { TypeAnalyzer } from "./contracts";
+import { type VirtualFileRegistry } from "./virtual-files";
+export interface VirtualWorkspace {
+    withVirtualFile<T>(tsconfigPath: string, filePath: string, content: string, operation: (project: Project, filePath: string) => Promise<T>): Promise<T>;
+}
+export interface VerificationOperationDependencies {
+    readonly compatibility: TypeAnalyzer["checkCompatibility"];
+    readonly diagnostics: TypeAnalyzer["getDiagnostics"];
+    readonly transformSearch: TypeAnalyzer["transformSearch"];
+    readonly virtualFiles?: VirtualFileRegistry;
+}
+export interface VerificationOperations {
+    readonly checkSnippet: TypeAnalyzer["checkSnippet"];
+    readonly explainError: TypeAnalyzer["explainError"];
+    readonly verifyContract: TypeAnalyzer["verifyContract"];
+}
+export declare const createVerificationOperations: (context: AnalyzerContext, dependencies: VerificationOperationDependencies) => VerificationOperations;

package/dist/virtual-files.d.ts

@@ -0,0 +1,43 @@
+import { type Project } from "typescript/unstable/async";
+/**
+ * Prefer a source directory that is typically covered by tsconfig include
+ * globs (`types/**`, `src/**`, …). Temporary file updates for paths outside
+ * include patterns work but are dramatically slower in TS-Go.
+ */
+export declare const resolveVirtualFileDirectory: (packageRoot: string) => string;
+export interface VirtualPackageImports {
+    readonly content: string;
+    readonly lineOffset: number;
+}
+/**
+ * Render imports for the package's public entrypoint into an ephemeral source.
+ * Type-only exports are kept type-only so verbatimModuleSyntax remains valid.
+ */
+export declare const synthesizePackageImports: (project: Project, packageRoot: string, virtualFilePath: string) => Promise<VirtualPackageImports>;
+export interface VirtualFileLease {
+    readonly path: string;
+    readonly content: string;
+    readonly token: symbol;
+    dispose(): void;
+}
+export interface VirtualFileEntry {
+    readonly path: string;
+    readonly content: string;
+    readonly token: symbol;
+}
+export interface VirtualFileRegistry {
+    acquire(content: string, extension?: ".ts" | ".tsx"): VirtualFileLease;
+    create(content: string, extension?: ".ts" | ".tsx"): VirtualFileLease;
+    get(path: string): string | undefined;
+    has(path: string): boolean;
+    entries(): readonly VirtualFileEntry[];
+    readonly size: number;
+    clear(): void;
+}
+/**
+ * A per-context registry for ephemeral source files. A lease owns exactly one
+ * entry; disposing an old lease can never remove a newer entry at the same
+ * path, which makes cleanup safe even when callers race.
+ */
+export declare const createVirtualFileRegistry: (root: string, prefix?: string) => VirtualFileRegistry;
+export declare const withVirtualFile: <T>(registry: VirtualFileRegistry, content: string, operation: (lease: VirtualFileLease) => Promise<T>, extension?: ".ts" | ".tsx") => Promise<T>;

package/dist/workspace.d.ts

@@ -0,0 +1,25 @@
+import { type Project } from "typescript/unstable/async";
+import type { EngineDiagnostic, WorkspaceFileChanges, WorkspaceMetadata, WorkspaceOptions } from "./types";
+export declare class QuartzWorkspace {
+    #private;
+    readonly root: string;
+    readonly configFile: string;
+    readonly configFiles: readonly string[];
+    private constructor();
+    static open(root: string, options?: WorkspaceOptions): Promise<QuartzWorkspace>;
+    get metadata(): WorkspaceMetadata;
+    diagnostics(configFile?: string): Promise<readonly EngineDiagnostic[]>;
+    /** TS-Go client/server timing snapshot when collectTiming was enabled at open. */
+    getTimingInfo(): Promise<unknown>;
+    resetTimingInfo(): Promise<void>;
+    withProject<T>(operation: (project: Project, revision: number) => Promise<T>, configFile?: string): Promise<T>;
+    /**
+     * Run analysis against a temporary file update without mutating the base
+     * snapshot or revision. Concurrent temporary operations are isolated and may
+     * proceed in parallel against the same immutable base.
+     */
+    withVirtualFile<T>(tsconfigPath: string, filePath: string, content: string, operation: (project: Project, filePath: string) => Promise<T>): Promise<T>;
+    refresh(changes?: WorkspaceFileChanges): Promise<WorkspaceMetadata>;
+    close(): Promise<void>;
+}
+export declare const openQuartzWorkspace: (root: string, options?: WorkspaceOptions) => Promise<QuartzWorkspace>;

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@skastr0/quartz-engine",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun ../../scripts/clean-build-output.ts engine && bun build ./src/index.ts --outdir ./dist --target bun --format esm --external typescript && tsc -p tsconfig.build.json",
+    "prepack": "bun run build"
+  },
+  "dependencies": {
+    "typescript": "7.1.0-dev.20260723.1"
+  },
+  "license": "MIT",
+  "description": "Persistent TypeScript 7 native workspace engine for Quartz.",
+  "keywords": [
+    "quartz",
+    "typescript",
+    "type-analysis",
+    "code-intelligence"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/skastr0/quartz.git",
+    "directory": "packages/engine"
+  },
+  "homepage": "https://github.com/skastr0/quartz#readme",
+  "bugs": {
+    "url": "https://github.com/skastr0/quartz/issues"
+  },
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}