@alint-js/core 0.0.33 → 0.0.34

package/dist/{agent-weXkvGkc.mjs → agent-B6GG68NX.mjs}

@@ -13,35 +13,41 @@ var RetryableAgentError = class extends Error {
 function isRetryableAgentError(error) {
 	return error instanceof RetryableAgentError;
 }
-function withAgentRetry(adapter, retries = 2) {
-	const invoke = withRetry(async (request) => {
-		try {
-			request.signal?.throwIfAborted();
-			const result = await adapter(request);
-			request.signal?.throwIfAborted();
-			return {
-				ok: true,
-				result
-			};
-		} catch (error) {
-			if (request.signal?.aborted) return {
-				error: request.signal.reason,
-				ok: false
-			};
-			if (isRetryableAgentError(error)) throw error;
-			return {
-				error,
-				ok: false
-			};
-		}
-	}, {
-		retry: retries,
-		retryDelay: 500,
-		retryDelayFactor: 2,
-		retryDelayMax: 3e4
-	});
+function withAgentRetry(adapter, retries = 2, options = {}) {
 	return async (request) => {
-		const attempt = await invoke(request);
+		let invocation = 0;
+		const attempt = await withRetry(async (request) => {
+			const attempt = invocation;
+			invocation += 1;
+			try {
+				request.signal?.throwIfAborted();
+				if (attempt > 0) options.onRetry?.({
+					attempt,
+					maxAttempts: retries + 1
+				});
+				const result = await adapter(request);
+				request.signal?.throwIfAborted();
+				return {
+					ok: true,
+					result
+				};
+			} catch (error) {
+				if (request.signal?.aborted) return {
+					error: request.signal.reason,
+					ok: false
+				};
+				if (isRetryableAgentError(error)) throw error;
+				return {
+					error,
+					ok: false
+				};
+			}
+		}, {
+			retry: retries,
+			retryDelay: 500,
+			retryDelayFactor: 2,
+			retryDelayMax: 3e4
+		})(request);
 		if (!attempt.ok) throw attempt.error;
 		return attempt.result;
 	};

package/dist/agent.d.mts

@@ -1,4 +1,4 @@
-import { A as AgentTool, D as AgentAdapter, O as AgentRequest, j as AgentUsage, k as AgentResult, v as RuleContext } from "./types-CR_Grd6q.mjs";
+import { A as AgentAdapter, M as AgentResult, N as AgentTool, P as AgentUsage, j as AgentRequest, v as RuleContext } from "./types-m5T_UL76.mjs";
 //#region src/agent/retry.d.ts
 /**
  * Declares that the complete adapter invocation can be safely replayed.

package/dist/agent.mjs

@@ -1,2 +1,2 @@
-import { a as isRetryableAgentError, i as RetryableAgentError, n as defineTool, r as requireAgent, t as combineAbortSignals } from "./agent-weXkvGkc.mjs";
+import { a as isRetryableAgentError, i as RetryableAgentError, n as defineTool, r as requireAgent, t as combineAbortSignals } from "./agent-B6GG68NX.mjs";
 export { RetryableAgentError, combineAbortSignals, defineTool, isRetryableAgentError, requireAgent };

package/dist/define-CnBawoAI.d.mts

@@ -0,0 +1,33 @@
+import { S as RuleOptionsInput, _ as RuleConfigEntry, i as AlintConfigItem, p as PluginDefinition, t as AlintConfig, w as RuleOptionsSchema, y as RuleDefinition } from "./types-m5T_UL76.mjs";
+//#region src/dsl/define.d.ts
+type AnyRuleDefinition = RuleDefinition<any>;
+type ConfigItemWithPluginRules<Plugins, Rules> = Omit<AlintConfigItem, 'plugins' | 'rules'> & {
+  plugins?: Plugins;
+  rules?: RulesForPlugins<NonNullable<Plugins>, Rules>;
+};
+type ConfigItemWithPlugins<Plugins> = Omit<AlintConfigItem, 'plugins' | 'rules'> & {
+  plugins?: Plugins;
+  rules?: Record<string, RuleConfigEntry<readonly unknown[]> | undefined>;
+};
+type RuleEntryForPlugins<Plugins, Key extends string> = Key extends `${infer Alias}/${infer RuleName}` ? Alias extends keyof Plugins & string ? Plugins[Alias] extends PluginDefinition<infer Rules> ? RuleName extends keyof Rules & string ? Rules[RuleName] extends RuleDefinition<infer OptionsSchema> ? RuleConfigEntry<RuleOptionsInput<OptionsSchema>> : RuleConfigEntry<readonly unknown[]> : RuleConfigEntry<readonly unknown[]> : RuleConfigEntry<readonly unknown[]> : RuleConfigEntry<readonly unknown[]> : RuleConfigEntry<readonly unknown[]>;
+type RulesForPlugins<Plugins, Rules> = { readonly [Key in keyof Rules]: Key extends string ? RuleEntryForPlugins<Plugins, Key> : never; };
+type TypedConfigInput<Item> = Item extends readonly [] ? readonly [] : Item extends readonly [unknown, ...unknown[]] ? { readonly [Index in keyof Item]: TypedConfigInput<Item[Index]>; } : Item extends readonly (infer Element)[] ? readonly TypedConfigInput<Element>[] : TypedConfigItem<Item>;
+type TypedConfigItem<Item> = Item extends {
+  plugins?: infer Plugins;
+  rules?: infer Rules;
+} ? ConfigItemWithPluginRules<Plugins, Rules> : TypedConfigItemWithoutRuleConfig<Item>;
+type TypedConfigItemWithoutRuleConfig<Item> = Item extends {
+  plugins?: infer Plugins;
+} ? ConfigItemWithPlugins<Plugins> : AlintConfigItem;
+declare function defineConfig<const Config extends readonly unknown[]>(config: Config & TypedConfigInput<Config>): AlintConfig;
+declare function definePlugin<const Rules extends Record<string, AnyRuleDefinition> = Record<string, AnyRuleDefinition>>(plugin: Omit<PluginDefinition<Rules>, 'rules'> & {
+  rules?: Rules;
+}): PluginDefinition<Rules>;
+declare function defineRule(rule: Omit<RuleDefinition<[]>, 'options'> & {
+  options?: undefined;
+}): RuleDefinition<[]>;
+declare function defineRule<const OptionsSchema extends RuleOptionsSchema>(rule: RuleDefinition<OptionsSchema> & {
+  options: OptionsSchema;
+}): RuleDefinition<OptionsSchema>;
+//#endregion
+export { definePlugin as n, defineRule as r, defineConfig as t };

package/dist/define-Da342Fcx.mjs

@@ -0,0 +1,12 @@
+//#region src/dsl/define.ts
+function defineConfig(config) {
+	return config;
+}
+function definePlugin(plugin) {
+	return plugin;
+}
+function defineRule(rule) {
+	return rule;
+}
+//#endregion
+export { definePlugin as n, defineRule as r, defineConfig as t };

package/dist/dsl.d.mts

@@ -0,0 +1,3 @@
+import { C as RuleOptionsOutput, D as RuleSpecializedHandlers, E as RuleSeverity, O as RuleWithHandler, S as RuleOptionsInput, T as RuleRegistry, _ as RuleConfigEntry, a as AlintLinterOptions, b as RuleHandlers, c as DiagnosticLocation, d as IgnoreConfig, f as LanguageDefinition, g as RuleCacheConfig, h as ProjectTarget, i as AlintConfigItem, k as Target, l as DirectoryTarget, m as ProcessorDefinition, n as AlintConfigExtends, o as Awaitable, p as PluginDefinition, r as AlintConfigInput, s as DiagnosticDescriptor, t as AlintConfig, u as EnabledRule, v as RuleContext, w as RuleOptionsSchema, x as RuleInferenceUsageRecord, y as RuleDefinition } from "./types-m5T_UL76.mjs";
+import { n as definePlugin, r as defineRule, t as defineConfig } from "./define-CnBawoAI.mjs";
+export { type AlintConfig, type AlintConfigExtends, type AlintConfigInput, type AlintConfigItem, type AlintLinterOptions, type Awaitable, type DiagnosticDescriptor, type DiagnosticLocation, type DirectoryTarget, type EnabledRule, type IgnoreConfig, type LanguageDefinition, type PluginDefinition, type ProcessorDefinition, type ProjectTarget, type RuleCacheConfig, type RuleConfigEntry, type RuleContext, type RuleDefinition, type RuleHandlers, type RuleInferenceUsageRecord, type RuleOptionsInput, type RuleOptionsOutput, type RuleOptionsSchema, type RuleRegistry, type RuleSeverity, type RuleSpecializedHandlers, type RuleWithHandler, type Target, defineConfig, definePlugin, defineRule };

package/dist/dsl.mjs

@@ -0,0 +1,2 @@
+import { n as definePlugin, r as defineRule, t as defineConfig } from "./define-Da342Fcx.mjs";
+export { defineConfig, definePlugin, defineRule };

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { B as RunnerStatsConfig, C as RuleSeverity, E as Target, F as ResolvedProvider, H as SetupModelDefinition, I as ModelSize, L as ProviderDefinition, M as ModelRequirement, N as ResolveModelOptions, P as ResolvedModel, R as ProviderType, S as RuleRegistry, T as RuleWithHandler, V as SetupConfig, _ as RuleConfigEntry, a as AlintLinterOptions, b as RuleHandlers, c as DiagnosticLocation, d as IgnoreConfig, f as LanguageDefinition, g as RuleCacheConfig, h as ProjectTarget, i as AlintConfigItem, l as DirectoryTarget, m as ProcessorDefinition, n as AlintConfigExtends, o as Awaitable, p as PluginDefinition, r as AlintConfigInput, s as DiagnosticDescriptor, t as AlintConfig, u as EnabledRule, v as RuleContext, w as RuleSpecializedHandlers, x as RuleInferenceUsageRecord, y as RuleDefinition, z as RunnerConfig } from "./types-CR_Grd6q.mjs";
+import { B as ProviderDefinition, D as RuleSpecializedHandlers, E as RuleSeverity, F as ModelRequirement, G as SetupModelDefinition, H as RunnerConfig, I as ResolveModelOptions, L as ResolvedModel, O as RuleWithHandler, R as ResolvedProvider, T as RuleRegistry, U as RunnerStatsConfig, V as ProviderType, W as SetupConfig, _ as RuleConfigEntry, a as AlintLinterOptions, b as RuleHandlers, c as DiagnosticLocation, d as IgnoreConfig, f as LanguageDefinition, g as RuleCacheConfig, h as ProjectTarget, i as AlintConfigItem, k as Target, l as DirectoryTarget, m as ProcessorDefinition, n as AlintConfigExtends, o as Awaitable, p as PluginDefinition, r as AlintConfigInput, s as DiagnosticDescriptor, t as AlintConfig, u as EnabledRule, v as RuleContext, x as RuleInferenceUsageRecord, y as RuleDefinition, z as ModelSize } from "./types-m5T_UL76.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-CnBawoAI.mjs";
 //#region src/config/config-array.d.ts
 interface EffectiveAlintConfig {
   agent?: AlintConfigItem['agent'];
@@ -95,6 +96,12 @@ interface JobEndPayload extends JobStartPayload {
 interface JobQueuedPayload {
   job: ProgressJob;
 }
+interface JobRetryPayload {
+  attempt: number;
+  job: ProgressJob;
+  maxAttempts: number;
+  startedAt?: number;
+}
 interface JobStartPayload {
   job: ProgressJob;
   startedAt?: number;
@@ -104,6 +111,8 @@ interface ProgressJob {
   index: number;
   inputPath: string;
   ruleId: string;
+  ruleIndex: number;
+  ruleTotal: number;
   target: {
     identity: string;
     kind: ProgressTargetKind;
@@ -115,6 +124,7 @@ interface ProgressReporter {
   onDiagnostic?: (payload: DiagnosticProgressPayload) => void;
   onJobEnd?: (payload: JobEndPayload) => void;
   onJobQueued?: (payload: JobQueuedPayload) => void;
+  onJobRetry?: (payload: JobRetryPayload) => void;
   onJobStart?: (payload: JobStartPayload) => void;
   onRunEnd?: (payload: RunEndPayload) => void;
   onRunStart?: (payload: RunStartPayload) => void;
@@ -143,6 +153,11 @@ interface RunOptions {
   modelOverride?: string;
   outputLanguage?: string;
   progress?: ProgressReporter;
+  /**
+   * Run project-scoped rules (`onTargetProject` and the project pass of `onTargetWith`).
+   * Defaults to `true`. Pass `false` for runs that target partial subsets of a project.
+   */
+  projectTargets?: boolean;
   runner?: RunnerOptions;
   setupConfig?: SetupConfig;
   /**
@@ -209,13 +224,11 @@ declare function createSourceRuntime(): SourceRuntime;
 declare function sliceLines(file: SourceFile, range: LineRange): SourceText;
 declare function sliceRange(file: SourceFile, range: SourceRange): SourceText;
 //#endregion
-//#region src/dsl/define.d.ts
-declare function defineConfig(config: readonly AlintConfigInput[]): AlintConfig;
-declare function definePlugin(plugin: PluginDefinition): PluginDefinition;
-declare function defineRule(rule: RuleDefinition): RuleDefinition;
-//#endregion
 //#region src/dsl/registry.d.ts
-declare function buildRuleRegistry(config: Pick<EffectiveAlintConfig, 'plugins' | 'rules'>): RuleRegistry;
+type RuleRegistryConfig = Pick<EffectiveAlintConfig, 'plugins'> & {
+  rules: Record<string, RuleConfigEntry<readonly unknown[]>>;
+};
+declare function buildRuleRegistry(config: RuleRegistryConfig): RuleRegistry;
 //#endregion
 //#region src/models/resolve.d.ts
 declare function resolveModel(registry: SetupConfig, options?: ResolveModelOptions): ResolvedModel;

package/dist/index.mjs

@@ -1,4 +1,5 @@
-import { o as withAgentRetry, t as combineAbortSignals } from "./agent-weXkvGkc.mjs";
+import { o as withAgentRetry, t as combineAbortSignals } from "./agent-B6GG68NX.mjs";
+import { n as definePlugin, r as defineRule, t as defineConfig } from "./define-Da342Fcx.mjs";
 import { a as sliceRange, i as sliceLines, n as createSourceFile, r as createSourceRuntime, t as extractJsSourceTargets } from "./extract-CIWssxNK.mjs";
 import { minimatch } from "minimatch";
 import { isAbsolute, relative, resolve } from "pathe";
@@ -6,9 +7,9 @@ import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { dirname, extname, isAbsolute as isAbsolute$1, join, relative as relative$1, resolve as resolve$1, sep } from "node:path";
 import { AsyncLocalStorage } from "node:async_hooks";
 import process, { cwd } from "node:process";
+import { array, check, description, getDotPath, is, literal, number, object, optional, pipe, record, safeParse, string, union, unknown } from "valibot";
 import { createHash, randomUUID } from "node:crypto";
 import { statSync } from "node:fs";
-import { array, check, description, is, literal, number, object, optional, pipe, record, string, union, unknown } from "valibot";
 import { errorMessageFrom } from "@moeru/std/error";
 //#region src/config/config-array.ts
 const effectiveBasePathSymbol = Symbol("effectiveBasePath");
@@ -333,11 +334,13 @@ function buildRuleRegistry(config) {
 	for (const [id, entry] of Object.entries(config.rules)) {
 		const rule = rules.get(id);
 		if (!rule) throw new Error(`Unknown rule "${id}".`);
-		const severity = normalizeSeverity(entry);
+		const normalizedEntry = normalizeRuleConfigEntry(entry);
+		const severity = normalizedEntry.severity;
 		if (severity === "off") continue;
 		enabledRules.push({
 			id,
 			localId: localIds.get(id) ?? id,
+			options: parseRuleOptions(id, rule.options, normalizedEntry.options),
 			rule,
 			severity
 		});
@@ -347,9 +350,44 @@ function buildRuleRegistry(config) {
 		rules
 	};
 }
-function normalizeSeverity(entry) {
-	if (Array.isArray(entry)) return entry[0] ?? "warn";
-	return entry ?? "warn";
+function formatRuleOptionIssues(index, issues) {
+	return issues.map((issue) => {
+		const path = getDotPath(issue);
+		return path === null ? `"${index}": ${issue.message}` : `"${index}.${path}": ${issue.message}`;
+	}).join("; ");
+}
+function isRuleConfigTuple(entry) {
+	return Array.isArray(entry);
+}
+function normalizeRuleConfigEntry(entry) {
+	if (isRuleConfigTuple(entry)) {
+		const [severity = "warn", ...options] = entry;
+		return {
+			options,
+			severity
+		};
+	}
+	return {
+		options: [],
+		severity: entry ?? "warn"
+	};
+}
+function parseRuleOption(id, index, schema, value) {
+	const result = safeParse(schema, value);
+	if (result.success) return result.output;
+	if (value === void 0) {
+		const emptyObjectResult = safeParse(schema, {});
+		if (emptyObjectResult.success) return emptyObjectResult.output;
+	}
+	throw new TypeError(`Invalid options for rule "${id}": ${formatRuleOptionIssues(index, result.issues)}`);
+}
+function parseRuleOptions(id, schema, options) {
+	if (!schema) {
+		if (options.length > 0) throw new TypeError(`Rule "${id}" does not accept options.`);
+		return [];
+	}
+	if (options.length > schema.length) throw new TypeError(`Invalid options for rule "${id}": Unexpected option at index ${schema.length}.`);
+	return schema.map((optionSchema, index) => parseRuleOption(id, index, optionSchema, options[index]));
 }
 //#endregion
 //#region src/models/resolve.ts
@@ -581,7 +619,7 @@ function statSyncIsDirectory(path) {
 }
 //#endregion
 //#region package.json
-var version = "0.0.33";
+var version = "0.0.34";
 //#endregion
 //#region src/core/execution/job.ts
 var CacheReplayProcessingError = class {
@@ -593,9 +631,17 @@ var CacheReplayProcessingError = class {
 function createRuleJobs(plans) {
 	const jobs = [];
 	const total = plans.reduce((sum, plan) => sum + plan.planned, 0);
+	const ruleTotals = /* @__PURE__ */ new Map();
+	const ruleIndexes = /* @__PURE__ */ new Map();
+	for (const plan of plans) for (const target of plan.targets) for (const execution of target.executions) {
+		const ruleId = execution.runtime.enabledRule.id;
+		ruleTotals.set(ruleId, (ruleTotals.get(ruleId) ?? 0) + 1);
+	}
 	for (const plan of plans) for (const target of plan.targets) for (const execution of target.executions) {
 		const ruleId = execution.runtime.enabledRule.id;
 		const index = jobs.length + 1;
+		const ruleIndex = (ruleIndexes.get(ruleId) ?? 0) + 1;
+		ruleIndexes.set(ruleId, ruleIndex);
 		jobs.push({
 			execution,
 			job: {
@@ -608,6 +654,8 @@ function createRuleJobs(plans) {
 				index,
 				inputPath: plan.path,
 				ruleId,
+				ruleIndex,
+				ruleTotal: ruleTotals.get(ruleId) ?? 0,
 				target: {
 					identity: target.identity,
 					kind: target.kind,
@@ -1134,7 +1182,7 @@ async function runAlint(options = {}) {
 	});
 	const filePlans = createSourceExecutionPlans(files, cwd$1);
 	const directoryPlans = createDirectoryExecutionPlans(directories, filePlans.length);
-	const projectPlan = resolvedProjectConfig.ignored ? void 0 : createProjectExecutionPlan({
+	const projectPlan = resolvedProjectConfig.ignored || options.projectTargets === false ? void 0 : createProjectExecutionPlan({
 		configHash: stableHash({ settings: projectConfig.settings }),
 		files,
 		index: filePlans.length + directoryPlans.length + 1,
@@ -1239,7 +1287,25 @@ function createRuleRuntimes(options) {
 			agent: options.effectiveAgent ? withAgentRetry((request) => options.effectiveAgent({
 				...request,
 				signal: combineAbortSignals(executionState.getStore()?.signal, request.signal)
-			}), options.options.runner?.agentRetries) : void 0,
+			}), options.options.runner?.agentRetries, { onRetry: ({ attempt, maxAttempts }) => {
+				const state = executionState.getStore();
+				if (!state) return;
+				const startedAt = Date.now();
+				try {
+					options.progress?.onJobRetry?.({
+						attempt,
+						job: state.job,
+						maxAttempts,
+						startedAt
+					});
+				} catch (cause) {
+					if (!state.reporterFailed) {
+						state.reporterCause = cause;
+						state.reporterFailed = true;
+					}
+					throw cause;
+				}
+			} }) : void 0,
 			cwd: options.cwd,
 			id: enabledRule.id,
 			localId: enabledRule.localId,
@@ -1277,6 +1343,7 @@ function createRuleRuntimes(options) {
 				if (state) state.currentModel = toDiagnosticModel(resolvedModel, request);
 				return resolvedModel;
 			},
+			options: enabledRule.options,
 			outputLanguage: options.options.outputLanguage,
 			report: (descriptor) => {
 				const state = executionState.getStore();
@@ -1326,6 +1393,7 @@ function createRuleRuntimes(options) {
 				id: enabledRule.id,
 				localId: enabledRule.localId,
 				model: enabledRule.rule.model,
+				options: enabledRule.options,
 				severity: enabledRule.severity
 			})
 		};
@@ -1417,15 +1485,4 @@ function usageTotals(records) {
 	};
 }
 //#endregion
-//#region src/dsl/define.ts
-function defineConfig(config) {
-	return config;
-}
-function definePlugin(plugin) {
-	return plugin;
-}
-function defineRule(rule) {
-	return rule;
-}
-//#endregion
 export { AlintAbortError, AlintRunCancelledError, AlintRunError, buildRuleRegistry, createBuiltInLanguageRegistry, createSourceFile, createSourceRuntime, defineConfig, definePlugin, defineRule, hasDiscoveryFilePatterns, matchesDiscoveryFile, normalizeConfig, registerLanguage, resolveConfigForDirectory, resolveConfigForFile, resolveConfigForProject, resolveLanguage, resolveModel, runAlint, sliceLines, sliceRange };

package/dist/structured-output.d.mts

@@ -1,4 +1,4 @@
-import { P as ResolvedModel, v as RuleContext } from "./types-CR_Grd6q.mjs";
+import { L as ResolvedModel, v as RuleContext } from "./types-m5T_UL76.mjs";
 import { GenericSchema, InferOutput } from "valibot";
 import { JsonSchema } from "@valibot/to-json-schema";
 import { Message } from "@xsai/shared-chat";

package/dist/{types-CR_Grd6q.d.mts → types-m5T_UL76.d.mts}

@@ -1,4 +1,5 @@
 import { c as ProcessorContext, h as SourceTarget, i as LanguageContext, l as ProcessorPostprocessContext, m as SourceRuntime, n as FileTarget, o as ProcessedSource, r as FunctionTarget, t as ClassTarget, u as SourceFile } from "./types-DSvXUVZ7.mjs";
+import { GenericSchema, InferInput, InferOutput } from "valibot";
 //#region src/config/types.d.ts
 type ModelSize = 'large' | 'medium' | 'small';
 interface ProviderDefinition {
@@ -146,7 +147,8 @@ interface DirectoryTarget {
 interface EnabledRule {
   id: string;
   localId: string;
-  rule: RuleDefinition;
+  options: readonly unknown[];
+  rule: RuleDefinition<any>;
   severity: Exclude<RuleSeverity, 'off'>;
 }
 interface IgnoreConfig {
@@ -157,11 +159,11 @@ interface LanguageDefinition {
   extract: (file: SourceFile, context: LanguageContext) => Awaitable<SourceTarget[]>;
   name: string;
 }
-interface PluginDefinition {
+interface PluginDefinition<Rules extends Record<string, RuleDefinition<any>> = Record<string, RuleDefinition<any>>> {
   configs?: Record<string, AlintConfigInput>;
   languages?: Record<string, LanguageDefinition>;
   processors?: Record<string, ProcessorDefinition>;
-  rules?: Record<string, RuleDefinition>;
+  rules?: Rules;
 }
 interface ProcessorDefinition {
   postprocess?: (diagnostics: DiagnosticDescriptor[], context: ProcessorPostprocessContext) => Awaitable<DiagnosticDescriptor[]>;
@@ -176,8 +178,8 @@ interface ProjectTarget {
 type RuleCacheConfig = boolean | {
   level?: 'target';
 };
-type RuleConfigEntry = [RuleSeverity] | RuleSeverity;
-interface RuleContext {
+type RuleConfigEntry<Options extends readonly unknown[] = readonly []> = readonly [RuleSeverity, ...Partial<Options>] | RuleSeverity;
+interface RuleContext<Options extends readonly unknown[] = readonly []> {
   agent?: AgentAdapter;
   cwd: string;
   id: string;
@@ -189,6 +191,7 @@ interface RuleContext {
     recordUsage: (usage: RuleInferenceUsageRecord) => void;
   };
   model: (selector?: ModelRequirement | string) => Promise<ResolvedModel>;
+  options: Options;
   outputLanguage?: string;
   report: (diagnostic: DiagnosticDescriptor) => void;
   settings: Record<string, unknown>;
@@ -201,12 +204,13 @@ interface RuleContext {
   signal?: AbortSignal;
   src: SourceRuntime;
 }
-interface RuleDefinition {
+interface RuleDefinition<OptionsSchema extends RuleOptionsSchema = []> {
   cache?: RuleCacheConfig;
   /** Additional stable rule inputs, such as imported prompts, that invalidate cached results when changed. */
   cacheKey?: unknown;
-  create: (context: RuleContext) => RuleHandlers;
+  create: (context: RuleContext<RuleOptionsOutput<OptionsSchema>>) => RuleHandlers;
   model?: ModelRequirement;
+  options?: OptionsSchema;
 }
 type RuleHandlers = RuleSpecializedHandlers | RuleWithHandler;
 interface RuleInferenceUsageRecord {
@@ -219,9 +223,12 @@ interface RuleInferenceUsageRecord {
   ruleId?: string;
   totalTokens?: number;
 }
+type RuleOptionsInput<OptionsSchema extends RuleOptionsSchema> = { readonly [Index in keyof OptionsSchema]: InferInput<OptionsSchema[Index]>; };
+type RuleOptionsOutput<OptionsSchema extends RuleOptionsSchema> = { readonly [Index in keyof OptionsSchema]: InferOutput<OptionsSchema[Index]>; };
+type RuleOptionsSchema = readonly GenericSchema[];
 interface RuleRegistry {
   enabledRules: EnabledRule[];
-  rules: Map<string, RuleDefinition>;
+  rules: Map<string, RuleDefinition<any>>;
 }
 type RuleSeverity = 'error' | 'off' | 'warn';
 interface RuleSpecializedHandlers {
@@ -242,4 +249,4 @@ interface RuleWithHandler {
 }
 type Target = DirectoryTarget | ProjectTarget | SourceTarget;
 //#endregion
-export { AgentTool as A, RunnerStatsConfig as B, RuleSeverity as C, AgentAdapter as D, Target as E, ResolvedProvider as F, SetupModelDefinition as H, ModelSize as I, ProviderDefinition as L, ModelRequirement as M, ResolveModelOptions as N, AgentRequest as O, ResolvedModel as P, ProviderType as R, RuleRegistry as S, RuleWithHandler as T, SetupConfig as V, RuleConfigEntry as _, AlintLinterOptions as a, RuleHandlers as b, DiagnosticLocation as c, IgnoreConfig as d, LanguageDefinition as f, RuleCacheConfig as g, ProjectTarget as h, AlintConfigItem as i, AgentUsage as j, AgentResult as k, DirectoryTarget as l, ProcessorDefinition as m, AlintConfigExtends as n, Awaitable as o, PluginDefinition as p, AlintConfigInput as r, DiagnosticDescriptor as s, AlintConfig as t, EnabledRule as u, RuleContext as v, RuleSpecializedHandlers as w, RuleInferenceUsageRecord as x, RuleDefinition as y, RunnerConfig as z };
+export { AgentAdapter as A, ProviderDefinition as B, RuleOptionsOutput as C, RuleSpecializedHandlers as D, RuleSeverity as E, ModelRequirement as F, SetupModelDefinition as G, RunnerConfig as H, ResolveModelOptions as I, ResolvedModel as L, AgentResult as M, AgentTool as N, RuleWithHandler as O, AgentUsage as P, ResolvedProvider as R, RuleOptionsInput as S, RuleRegistry as T, RunnerStatsConfig as U, ProviderType as V, SetupConfig as W, RuleConfigEntry as _, AlintLinterOptions as a, RuleHandlers as b, DiagnosticLocation as c, IgnoreConfig as d, LanguageDefinition as f, RuleCacheConfig as g, ProjectTarget as h, AlintConfigItem as i, AgentRequest as j, Target as k, DirectoryTarget as l, ProcessorDefinition as m, AlintConfigExtends as n, Awaitable as o, PluginDefinition as p, AlintConfigInput as r, DiagnosticDescriptor as s, AlintConfig as t, EnabledRule as u, RuleContext as v, RuleOptionsSchema as w, RuleInferenceUsageRecord as x, RuleDefinition as y, ModelSize as z };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alint-js/core",
   "type": "module",
-  "version": "0.0.33",
+  "version": "0.0.34",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -11,6 +11,10 @@
       "types": "./dist/agent.d.mts",
       "default": "./dist/agent.mjs"
     },
+    "./dsl": {
+      "types": "./dist/dsl.d.mts",
+      "default": "./dist/dsl.mjs"
+    },
     "./structured-output": {
       "types": "./dist/structured-output.d.mts",
       "default": "./dist/structured-output.mjs"