@alint-js/core 0.1.4 → 0.1.5

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { A as RuleWithHandler, B as ResolvedProvider, C as RuleInferenceUsageRecord, D as RuleRegistry, G as RunnerStatsConfig, H as ProviderDefinition, K as SetupConfig, L as ModelRequirement, O as RuleSeverity, R as ResolveModelOptions, S as RuleHandlers, U as ProviderType, V as ModelSize, W as RunnerConfig, _ as ProjectTargetEntry, a as AlintLinterOptions, b as RuleContext, c as DiagnosticLocation, d as IgnoreConfig, f as LanguageDefinition, g as ProjectTarget, h as ProjectFileEntry, i as AlintConfigItem, j as Target, k as RuleSpecializedHandlers, l as DirectoryTarget, m as ProcessorDefinition, n as AlintConfigExtends, o as Awaitable, p as PluginDefinition, q as SetupModelDefinition, r as AlintConfigInput, s as DiagnosticDescriptor, t as AlintConfig, u as EnabledRule, v as RuleCacheConfig, x as RuleDefinition, y as RuleConfigEntry, z as ResolvedModel } from "./types-DKylUrAn.mjs";
-import { _ as SourceTargetOfKind, a as LineRange, c as ProcessorContext, d as SourceLocation, f as SourcePosition, g as SourceTargetKind, h as SourceTarget, i as LanguageContext, l as ProcessorPostprocessContext, m as SourceRuntime, n as FileTarget, o as ProcessedSource, p as SourceRange, r as FunctionTarget, s as ProcessedSourceOrigin, t as ClassTarget, u as SourceFile, v as SourceTargetOrigin, y as SourceText } from "./types-DSvXUVZ7.mjs";
-import { n as definePlugin, r as defineRule, t as defineConfig } from "./define-8BzWDcPs.mjs";
+import { A as RuleWithHandler, B as ResolvedProvider, C as RuleInferenceUsageRecord, D as RuleRegistry, G as RunnerStatsConfig, H as ProviderDefinition, K as SetupConfig, L as ModelRequirement, O as RuleSeverity, R as ResolveModelOptions, S as RuleHandlers, U as ProviderType, V as ModelSize, W as RunnerConfig, _ as ProjectTargetEntry, a as AlintLinterOptions, b as RuleContext, c as DiagnosticLocation, d as IgnoreConfig, f as LanguageDefinition, g as ProjectTarget, h as ProjectFileEntry, i as AlintConfigItem, j as Target, k as RuleSpecializedHandlers, l as DirectoryTarget, m as ProcessorDefinition, n as AlintConfigExtends, o as Awaitable, p as PluginDefinition, q as SetupModelDefinition, r as AlintConfigInput, s as DiagnosticDescriptor, t as AlintConfig, u as EnabledRule, v as RuleCacheConfig, x as RuleDefinition, y as RuleConfigEntry, z as ResolvedModel } from "./types-deBCDA4_.mjs";
+import { C as SourceTarget, D as SourceTargetOrigin, E as SourceTargetOfKind, O as SourceText, S as SourceRuntime, T as SourceTargetMetadata, _ as SourceLocation, a as FunctionInfo, b as SourcePosition, c as LineRange, d as ProcessedSource, f as ProcessedSourceOrigin, g as SourceFile, h as SourceExtractOptions, i as FileTarget, l as PlannedSourceTarget, m as ProcessorPostprocessContext, n as CallSite, o as FunctionTarget, p as ProcessorContext, r as ClassTarget, s as LanguageContext, t as BaseSourceFile, u as PlannedSourceTargetOfKind, v as SourceMetadataObject, w as SourceTargetKind, x as SourceRange, y as SourceMetadataValue } from "./types-DM4idR4w.mjs";
+import { n as definePlugin, r as defineRule, t as defineConfig } from "./define-CJ2QJPZ8.mjs";
 //#region src/config/config-array.d.ts
 interface EffectiveAlintConfig {
   agent?: AlintConfigItem['agent'];
@@ -60,7 +60,7 @@ interface AlintFileFailure {
 }
 interface AlintRuleFailure {
   job: ProgressJobRef;
-  kind: 'cache-replay' | 'handler' | 'timeout';
+  kind: 'cache-replay' | 'handler' | 'source-changed' | 'timeout';
   message: string;
 }
 type AlintRunFailure = AlintFileFailure | AlintRuleFailure;
@@ -158,6 +158,7 @@ interface ProgressReporter {
   onJobQueued?: (payload: JobQueuedPayload) => void;
   onJobRetry?: (payload: JobRetryPayload) => void;
   onJobStart?: (payload: JobStartPayload) => void;
+  onPlanningEnd?: (payload: ExecutionProgressPayload) => void;
   onPrepareEnd?: (payload: PrepareEndPayload) => void;
   onPrepareStart?: (payload: PrepareStartPayload) => void;
   onRunEnd?: (payload: RunEndPayload) => void;
@@ -165,11 +166,12 @@ interface ProgressReporter {
 }
 interface ProgressSnapshot {
   execution: ExecutionCounts;
+  filesPlanned: number;
   filesTotal: number;
-  final: boolean;
   jobsCompleted: number;
   jobsStarted: number;
   jobsTotal: number;
+  planningComplete: boolean;
 }
 type ProgressTargetKind = SourceTargetKind;
 interface RunEndPayload {
@@ -236,6 +238,21 @@ interface UsageProgressPayload {
   record: InferenceUsageRecord;
 }
 //#endregion
+//#region src/core/preparation.d.ts
+/**
+ * The `ctx.src.extract` a run hands to rules, for parsing files it was never asked to lint, which
+ * an index builder sweeping the workspace needs.
+ *
+ * It resolves each file's OWN config rather than a caller's, because the language a file resolves to
+ * is a config decision and two config groups may register different plugins. It extracts on demand
+ * and holds nothing: source planning releases rich extractor values after compact jobs are admitted,
+ * and a run-wide parse memo here would put that retention back. A caller keeps only what it derives.
+ *
+ * `getSrc` defers reading the runtime because the runtime is built around this closure. It is assigned
+ * before any rule runs, so by the first call it is present.
+ */
+declare function createSourceExtractor(cwd: string, config: AlintConfig, getSrc: () => SourceRuntime): SourceRuntime['extract'];
+//#endregion
 //#region src/core/run.d.ts
 declare class AlintRunCancelledError extends Error {
   readonly result: RunResult;
@@ -257,11 +274,42 @@ declare class AlintRunError extends Error {
 }
 declare function runAlint(options?: RunOptions): Promise<RunResult>;
 //#endregion
+//#region src/core/source/identity.d.ts
+/** A target's identity from its position. */
+declare function targetIdentity(kind: SourceTargetKind, name: string | undefined, range: SourceRange): string;
+/**
+ * Swaps a target's positional identity for its name, where that name is unique among these targets.
+ *
+ * Identities key caches, so a function that only moved should keep the identity it had. Two targets
+ * sharing a name cannot be told apart that way, so both keep the positional form.
+ *
+ * Run every function and class target through this. Skip it in one producer and the same function
+ * ends up with a different identity depending on which language read it.
+ */
+declare function withStableIdentities(targets: readonly SourceTarget[]): SourceTarget[];
+//#endregion
 //#region src/core/source/runtime.d.ts
+interface SourceRuntimeOptions {
+  /**
+   * Extraction for arbitrary files, injected by the run.
+   *
+   * The runtime cannot do this itself: extraction resolves the file's own config, and importing
+   * config resolution here would point the source module back at the layers built on top of it.
+   * `runAlint` has the config in scope before it builds the runtime, so it passes the closure down.
+   */
+  extract?: SourceRuntime['extract'];
+  /**
+   * Replaces the complete source read operation, including descriptor validation. The other
+   * members need no override: `getText` and the slicers are pure functions over whatever
+   * `readFile` returned, and `extract` already defaults to a throwing stub outside a run.
+   */
+  readFile?: SourceRuntime['readFile'];
+}
 declare function createSourceFile(path: string, text: string): SourceFile;
-declare function createSourceRuntime(): SourceRuntime;
+declare function createSourceRuntime(options?: SourceRuntimeOptions): SourceRuntime;
 declare function sliceLines(file: SourceFile, range: LineRange): SourceText;
 declare function sliceRange(file: SourceFile, range: SourceRange): SourceText;
+declare function withLanguage(file: SourceFile, language: string): SourceFile;
 //#endregion
 //#region src/dsl/registry.d.ts
 type RuleRegistryConfig = Pick<EffectiveAlintConfig, 'plugins'> & {
@@ -269,7 +317,61 @@ type RuleRegistryConfig = Pick<EffectiveAlintConfig, 'plugins'> & {
 };
 declare function buildRuleRegistry(config: RuleRegistryConfig): RuleRegistry;
 //#endregion
+//#region src/models/benchmark.d.ts
+interface BenchmarkModelsOptions {
+  onProgress?: (progress: ModelBenchmarkProgress) => void;
+  providerConcurrency?: Readonly<Record<string, number>>;
+  request?: (request: ModelBenchmarkRequest) => Promise<ModelBenchmarkMeasurement>;
+  sampleCount?: number;
+  seed?: number;
+  timeoutMs?: number;
+}
+interface ModelBenchmarkActive {
+  modelId: string;
+  modelIndex: number;
+  phase: 'non-repeat' | 'repeat';
+  providerId: string;
+  sample: number;
+  samples: number;
+  success: ModelBenchmarkResult['success'];
+  warmup: boolean;
+}
+interface ModelBenchmarkMeasurement {
+  durationMs: number;
+  firstOutputMs?: number;
+  outputTokens?: number;
+}
+interface ModelBenchmarkProgress {
+  active: readonly ModelBenchmarkActive[];
+  modelsTotal: number;
+  results: readonly (ModelBenchmarkResult | undefined)[];
+}
+interface ModelBenchmarkRequest {
+  model: ResolvedModel;
+  prompt: string;
+  signal: AbortSignal;
+}
+interface ModelBenchmarkResult {
+  error?: string;
+  modelId: string;
+  nonRepeatMs?: number;
+  providerId: string;
+  repeatMs?: number;
+  success: {
+    attempted: number;
+    completed: number;
+  };
+  throughput?: number;
+}
+/**
+ * Benchmarks model jobs concurrently within independent provider limits.
+ *
+ * Each model's repeat warm-up, measured repeats, and non-repeats remain serial so concurrent samples cannot
+ * distort that model's cache behavior. Non-repeat prompts put their nonce before the shared corpus.
+ */
+declare function benchmarkModels(config: SetupConfig, options?: BenchmarkModelsOptions): Promise<ModelBenchmarkResult[]>;
+//#endregion
 //#region src/models/resolve.d.ts
 declare function resolveModel(registry: SetupConfig, options?: ResolveModelOptions): ResolvedModel;
 //#endregion
-export { AlintAbortError, type AlintConfig, type AlintConfigExtends, type AlintConfigInput, type AlintConfigItem, type AlintFileFailure, type AlintLinterOptions, type AlintRuleFailure, AlintRunCancelledError, AlintRunError, type AlintRunFailure, type Awaitable, type ClassTarget, type Diagnostic, type DiagnosticDescriptor, type DiagnosticLocation, type DiagnosticProgressPayload, type DirectoryTarget, type EffectiveAlintConfig, type EnabledRule, type ExecutionCounts, type ExecutionProgressPayload, type FileReadyPayload, type FileTarget, type FunctionTarget, type IgnoreConfig, type InferenceUsageRecord, type JobEndPayload, type JobQueuedPayload, type JobRetryPayload, type JobStartPayload, type LanguageContext, type LanguageDefinition, type LanguageRegistry, type LineRange, type ModelRequirement, type ModelSize, type PluginDefinition, type PrepareEndPayload, type PrepareStartPayload, type ProcessedSource, type ProcessedSourceOrigin, type ProcessorContext, type ProcessorDefinition, type ProcessorPostprocessContext, type ProgressJobRef, type ProgressReporter, type ProgressSnapshot, type ProgressTargetKind, type ProjectFileEntry, type ProjectTarget, type ProjectTargetEntry, type ProviderDefinition, type ProviderType, type ResolveConfigResult, type ResolveLanguageOptions, type ResolveModelOptions, type ResolvedModel, type ResolvedProvider, type RuleCacheConfig, type RuleConfigEntry, type RuleContext, type RuleDefinition, type RuleHandlers, type RuleInferenceUsageRecord, type RuleRegistry, type RuleSeverity, type RuleSpecializedHandlers, type RuleWithHandler, type RunEndPayload, type RunExecution, type RunOptions, type RunResult, type RunUsage, type RunUsageTotals, type RunnerConfig, type RunnerStatsConfig, type SetupConfig, type SetupModelDefinition, type SourceFile, type SourceLocation, type SourcePosition, type SourceRange, type SourceRuntime, type SourceTarget, type SourceTargetKind, type SourceTargetOfKind, type SourceTargetOrigin, type SourceText, type Target, type UsageProgressPayload, buildRuleRegistry, createBuiltInLanguageRegistry, createSourceFile, createSourceRuntime, defineConfig, definePlugin, defineRule, hasDiscoveryFilePatterns, matchesDiscoveryFile, normalizeConfig, registerLanguage, resolveConfigForDirectory, resolveConfigForFile, resolveConfigForProject, resolveLanguage, resolveModel, runAlint, sliceLines, sliceRange };
+export { AlintAbortError, type AlintConfig, type AlintConfigExtends, type AlintConfigInput, type AlintConfigItem, type AlintFileFailure, type AlintLinterOptions, type AlintRuleFailure, AlintRunCancelledError, AlintRunError, type AlintRunFailure, type Awaitable, type BaseSourceFile, type BenchmarkModelsOptions, type CallSite, type ClassTarget, type Diagnostic, type DiagnosticDescriptor, type DiagnosticLocation, type DiagnosticProgressPayload, type DirectoryTarget, type EffectiveAlintConfig, type EnabledRule, type ExecutionCounts, type ExecutionProgressPayload, type FileReadyPayload, type FileTarget, type FunctionInfo, type FunctionTarget, type IgnoreConfig, type InferenceUsageRecord, type JobEndPayload, type JobQueuedPayload, type JobRetryPayload, type JobStartPayload, type LanguageContext, type LanguageDefinition, type LanguageRegistry, type LineRange, type ModelBenchmarkActive, type ModelBenchmarkMeasurement, type ModelBenchmarkProgress, type ModelBenchmarkRequest, type ModelBenchmarkResult, type ModelRequirement, type ModelSize, type PlannedSourceTarget, type PlannedSourceTargetOfKind, type PluginDefinition, type PrepareEndPayload, type PrepareStartPayload, type ProcessedSource, type ProcessedSourceOrigin, type ProcessorContext, type ProcessorDefinition, type ProcessorPostprocessContext, type ProgressJobRef, type ProgressReporter, type ProgressSnapshot, type ProgressTargetKind, type ProjectFileEntry, type ProjectTarget, type ProjectTargetEntry, type ProviderDefinition, type ProviderType, type ResolveConfigResult, type ResolveLanguageOptions, type ResolveModelOptions, type ResolvedModel, type ResolvedProvider, type RuleCacheConfig, type RuleConfigEntry, type RuleContext, type RuleDefinition, type RuleHandlers, type RuleInferenceUsageRecord, type RuleRegistry, type RuleSeverity, type RuleSpecializedHandlers, type RuleWithHandler, type RunEndPayload, type RunExecution, type RunOptions, type RunResult, type RunUsage, type RunUsageTotals, type RunnerConfig, type RunnerStatsConfig, type SetupConfig, type SetupModelDefinition, type SourceExtractOptions, type SourceFile, type SourceLocation, type SourceMetadataObject, type SourceMetadataValue, type SourcePosition, type SourceRange, type SourceRuntime, type SourceRuntimeOptions, type SourceTarget, type SourceTargetKind, type SourceTargetMetadata, type SourceTargetOfKind, type SourceTargetOrigin, type SourceText, type Target, type UsageProgressPayload, benchmarkModels, buildRuleRegistry, createBuiltInLanguageRegistry, createSourceExtractor, createSourceFile, createSourceRuntime, defineConfig, definePlugin, defineRule, hasDiscoveryFilePatterns, matchesDiscoveryFile, normalizeConfig, registerLanguage, resolveConfigForDirectory, resolveConfigForFile, resolveConfigForProject, resolveLanguage, resolveModel, runAlint, sliceLines, sliceRange, targetIdentity, withLanguage, withStableIdentities };