@rcrsr/rill-cli 0.15.0 → 0.17.0

package/dist/check/config.d.ts

@@ -17,4 +17,3 @@ export declare function createDefaultConfig(): CheckConfig;
  * @throws Error with "Invalid configuration: unknown rule {code}" if unknown rule [EC-4]
  */
 export declare function loadConfig(cwd: string): CheckConfig | null;
-//# sourceMappingURL=config.d.ts.map

package/dist/check/config.js

@@ -148,4 +148,3 @@ export function loadConfig(cwd) {
     validateRuleCodes(config);
     return config;
 }
-//# sourceMappingURL=config.js.map

package/dist/check/fixer.d.ts

@@ -36,4 +36,3 @@ export interface ApplyResult {
  * @throws Error if applied fixes create invalid syntax [EC-6]
  */
 export declare function applyFixes(source: string, diagnostics: Diagnostic[], _context: ValidationContext): ApplyResult;
-//# sourceMappingURL=fixer.d.ts.map

package/dist/check/fixer.js

@@ -116,4 +116,3 @@ function filterCollisions(sortedFixes) {
 function rangesOverlap(a, b) {
     return a.start < b.end && a.end > b.start;
 }
-//# sourceMappingURL=fixer.js.map

package/dist/check/index.d.ts

@@ -7,4 +7,3 @@ export { VALIDATION_RULES } from './rules/index.js';
 export { loadConfig, createDefaultConfig } from './config.js';
 export { validateScript } from './validator.js';
 export { applyFixes, type ApplyResult } from './fixer.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/check/index.js

@@ -18,4 +18,3 @@ export { validateScript } from './validator.js';
 // FIX APPLICATION
 // ============================================================
 export { applyFixes } from './fixer.js';
-//# sourceMappingURL=index.js.map

package/dist/check/rules/anti-patterns.d.ts

@@ -62,4 +62,3 @@ export declare const COMPLEX_CONDITION: ValidationRule;
  * - docs/topic-variables.md (Scope Rules)
  */
 export declare const LOOP_OUTER_CAPTURE: ValidationRule;
-//# sourceMappingURL=anti-patterns.d.ts.map

package/dist/check/rules/anti-patterns.js

@@ -478,4 +478,3 @@ function getParenNestingDepth(node) {
     traverse(node, 0);
     return maxDepth;
 }
-//# sourceMappingURL=anti-patterns.js.map

package/dist/check/rules/closures.d.ts

@@ -63,4 +63,3 @@ export declare const CLOSURE_BRACES: ValidationRule;
  * - docs/topic-closures.md: Late binding section
  */
 export declare const CLOSURE_LATE_BINDING: ValidationRule;
-//# sourceMappingURL=closures.d.ts.map

package/dist/check/rules/closures.js

@@ -367,4 +367,3 @@ function containsExplicitCapture(node) {
     }
     return false;
 }
-//# sourceMappingURL=closures.js.map

package/dist/check/rules/collections.d.ts

@@ -87,4 +87,3 @@ export declare const FILTER_NEGATION: ValidationRule;
  * - docs/guide-conventions.md:90-149
  */
 export declare const METHOD_SHORTHAND: ValidationRule;
-//# sourceMappingURL=collections.d.ts.map

package/dist/check/rules/collections.js

@@ -370,4 +370,3 @@ export const METHOD_SHORTHAND = {
         return [];
     },
 };
-//# sourceMappingURL=collections.js.map

package/dist/check/rules/conditionals.d.ts

@@ -38,4 +38,3 @@ export declare const USE_DEFAULT_OPERATOR: ValidationRule;
  * - docs/guide-conventions.md:199-215
  */
 export declare const CONDITION_TYPE: ValidationRule;
-//# sourceMappingURL=conditionals.d.ts.map

package/dist/check/rules/conditionals.js

@@ -131,4 +131,3 @@ export const CONDITION_TYPE = {
         return [];
     },
 };
-//# sourceMappingURL=conditionals.js.map

package/dist/check/rules/flow.d.ts

@@ -43,4 +43,3 @@ export declare const CAPTURE_INLINE_CHAIN: ValidationRule;
  * - docs/guide-conventions.md:76-88
  */
 export declare const CAPTURE_BEFORE_BRANCH: ValidationRule;
-//# sourceMappingURL=flow.d.ts.map

package/dist/check/rules/flow.js

@@ -203,4 +203,3 @@ export const CAPTURE_BEFORE_BRANCH = {
         return [];
     },
 };
-//# sourceMappingURL=flow.js.map

package/dist/check/rules/formatting.d.ts

@@ -140,4 +140,3 @@ export declare const THROWAWAY_CAPTURE: ValidationRule;
  * of edge cases (null spans, invalid coordinates).
  */
 export declare function isValidSpan(span: SourceSpan | null | undefined): boolean;
-//# sourceMappingURL=formatting.d.ts.map

package/dist/check/rules/formatting.js

@@ -657,4 +657,3 @@ function extractSpanText(span, source) {
 function escapeRegex(str) {
     return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
-//# sourceMappingURL=formatting.js.map

package/dist/check/rules/helpers.d.ts

@@ -23,4 +23,3 @@ export declare function extractContextLine(line: number, source: string): string
  * @returns true if expr is a bare $ reference, false otherwise
  */
 export declare function isBareReference(expr: ExpressionNode | null | undefined): boolean;
-//# sourceMappingURL=helpers.d.ts.map

package/dist/check/rules/helpers.js

@@ -63,4 +63,3 @@ export function isBareReference(expr) {
         variable.defaultValue === null &&
         variable.existenceCheck === null);
 }
-//# sourceMappingURL=helpers.js.map

package/dist/check/rules/index.d.ts

@@ -19,4 +19,3 @@ export { USE_DYNAMIC_IDENTIFIER, USE_UNTYPED_HOST_REF, } from './use-expressions
  * Rules are applied during AST traversal via the validator.
  */
 export declare const VALIDATION_RULES: ValidationRule[];
-//# sourceMappingURL=index.d.ts.map

package/dist/check/rules/index.js

@@ -80,4 +80,3 @@ export const VALIDATION_RULES = [
     USE_DYNAMIC_IDENTIFIER,
     USE_UNTYPED_HOST_REF,
 ];
-//# sourceMappingURL=index.js.map

package/dist/check/rules/loops.d.ts

@@ -74,4 +74,3 @@ export declare const PREFER_DO_WHILE: ValidationRule;
  * - docs/guide-conventions.md:188-196
  */
 export declare const USE_EACH: ValidationRule;
-//# sourceMappingURL=loops.d.ts.map

package/dist/check/rules/loops.js

@@ -307,4 +307,3 @@ export const USE_EACH = {
         return [];
     },
 };
-//# sourceMappingURL=loops.js.map

package/dist/check/rules/naming.d.ts

@@ -18,4 +18,3 @@ import type { ValidationRule } from '../types.js';
  * - docs/guide-conventions.md:10-53
  */
 export declare const NAMING_SNAKE_CASE: ValidationRule;
-//# sourceMappingURL=naming.d.ts.map

package/dist/check/rules/naming.js

@@ -171,4 +171,3 @@ export const NAMING_SNAKE_CASE = {
         };
     },
 };
-//# sourceMappingURL=naming.js.map

package/dist/check/rules/strings.d.ts

@@ -25,4 +25,3 @@ import type { ValidationRule } from '../types.js';
  * - docs/guide-conventions.md:333-345
  */
 export declare const USE_EMPTY_METHOD: ValidationRule;
-//# sourceMappingURL=strings.d.ts.map

package/dist/check/rules/strings.js

@@ -76,4 +76,3 @@ function isEmptyStringLiteral(node) {
     }
     return false;
 }
-//# sourceMappingURL=strings.js.map

package/dist/check/rules/types.d.ts

@@ -38,4 +38,3 @@ export declare const UNNECESSARY_ASSERTION: ValidationRule;
  * - docs/guide-conventions.md:307-311
  */
 export declare const VALIDATE_EXTERNAL: ValidationRule;
-//# sourceMappingURL=types.d.ts.map

package/dist/check/rules/types.js

@@ -190,4 +190,3 @@ export const VALIDATE_EXTERNAL = {
         ];
     },
 };
-//# sourceMappingURL=types.js.map

package/dist/check/rules/use-expressions.d.ts

@@ -28,4 +28,3 @@ export declare const USE_DYNAMIC_IDENTIFIER: ValidationRule;
  * - docs/guide-conventions.md checker modes section
  */
 export declare const USE_UNTYPED_HOST_REF: ValidationRule;
-//# sourceMappingURL=use-expressions.d.ts.map

package/dist/check/rules/use-expressions.js

@@ -98,4 +98,3 @@ export const USE_UNTYPED_HOST_REF = {
         ];
     },
 };
-//# sourceMappingURL=use-expressions.js.map

package/dist/check/types.d.ts

@@ -115,4 +115,3 @@ export interface ValidationRule {
      */
     fix?(node: ASTNode, context: FixContext): Fix | null;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/check/types.js

@@ -3,4 +3,3 @@
  * Type definitions for the rill-check static analysis tool.
  */
 export {};
-//# sourceMappingURL=types.js.map

package/dist/check/validator.d.ts

@@ -15,4 +15,3 @@ import type { CheckConfig, Diagnostic } from './types.js';
  * @returns Array of diagnostics sorted by location
  */
 export declare function validateScript(ast: ScriptNode, source: string, config: CheckConfig): Diagnostic[];
-//# sourceMappingURL=validator.d.ts.map

package/dist/check/validator.js

@@ -107,4 +107,3 @@ function sortDiagnostics(diagnostics) {
         return a.location.column - b.location.column;
     });
 }
-//# sourceMappingURL=validator.js.map

package/dist/check/visitor.d.ts

@@ -30,4 +30,3 @@ export interface RuleVisitor {
  * 3. visitor.exit(node)
  */
 export declare function visitNode(node: ASTNode, context: ValidationContext, visitor: RuleVisitor): void;
-//# sourceMappingURL=visitor.d.ts.map

package/dist/check/visitor.js

@@ -280,7 +280,10 @@ export function visitNode(node, context, visitor) {
             break;
         case 'TypeConstructor':
             for (const arg of node.args) {
-                visitNode(arg.value, context, visitor);
+                // arg.value is a TypeRef (not an ASTNode) — skip it
+                if (arg.defaultValue) {
+                    visitNode(arg.defaultValue, context, visitor);
+                }
             }
             break;
         case 'ClosureSigLiteral':
@@ -304,4 +307,3 @@ export function visitNode(node, context, visitor) {
     // Exit callback after children
     visitor.exit(node, context);
 }
-//# sourceMappingURL=visitor.js.map

package/dist/cli-check.d.ts

@@ -40,4 +40,3 @@ export declare function parseCheckArgs(argv: string[]): ParsedCheckArgs;
  * @returns Formatted output string
  */
 export declare function formatDiagnostics(file: string, diagnostics: Diagnostic[], format: 'text' | 'json', verbose: boolean): string;
-//# sourceMappingURL=cli-check.d.ts.map

package/dist/cli-check.js

@@ -363,4 +363,3 @@ const shouldRunMain = process.env['NODE_ENV'] !== 'test' &&
 if (shouldRunMain) {
     main();
 }
-//# sourceMappingURL=cli-check.js.map

package/dist/cli-error-enrichment.d.ts

@@ -70,4 +70,3 @@ export declare function suggestSimilarNames(target: string, candidates: string[]
  * @throws {TypeError} When source is not a string or error is null
  */
 export declare function enrichError(error: RillError, source: string, scope?: ScopeInfo): EnrichedError;
-//# sourceMappingURL=cli-error-enrichment.d.ts.map

package/dist/cli-error-enrichment.js

@@ -195,4 +195,3 @@ export function enrichError(error, source, scope) {
         helpUrl: error.helpUrl,
     };
 }
-//# sourceMappingURL=cli-error-enrichment.js.map

package/dist/cli-error-formatter.d.ts

@@ -42,4 +42,3 @@ export declare function formatError(error: EnrichedError, options: FormatOptions
  * @throws {RangeError} Invalid span (start after end)
  */
 export declare function renderCaretUnderline(span: SourceSpan, lineContent: string): string;
-//# sourceMappingURL=cli-error-formatter.d.ts.map

package/dist/cli-error-formatter.js

@@ -215,4 +215,3 @@ export function renderCaretUnderline(span, lineContent) {
     const carets = '^'.repeat(caretCount);
     return padding + carets;
 }
-//# sourceMappingURL=cli-error-formatter.js.map

package/dist/cli-eval.d.ts

@@ -12,4 +12,3 @@ import { type ExecutionResult } from '@rcrsr/rill';
  * Evaluate a Rill expression without file context
  */
 export declare function evaluateExpression(expression: string): Promise<ExecutionResult>;
-//# sourceMappingURL=cli-eval.d.ts.map

package/dist/cli-eval.js

@@ -114,4 +114,3 @@ const shouldRunMain = process.env['NODE_ENV'] !== 'test' &&
 if (shouldRunMain) {
     main();
 }
-//# sourceMappingURL=cli-eval.js.map

package/dist/cli-exec.d.ts

@@ -55,4 +55,3 @@ export declare function executeScript(file: string, args: string[], options?: {
  * Sets process.exit(1) on any error.
  */
 export declare function main(): Promise<void>;
-//# sourceMappingURL=cli-exec.d.ts.map

package/dist/cli-exec.js

@@ -298,4 +298,3 @@ const shouldRunMain = process.env['NODE_ENV'] !== 'test' &&
 if (shouldRunMain) {
     main();
 }
-//# sourceMappingURL=cli-exec.js.map

package/dist/cli-explain.d.ts

@@ -21,4 +21,3 @@
  * // Returns: null
  */
 export declare function explainError(errorId: string): string | null;
-//# sourceMappingURL=cli-explain.d.ts.map

package/dist/cli-explain.js

@@ -65,4 +65,3 @@ export function explainError(errorId) {
     }
     return sections.join('\n').trimEnd();
 }
-//# sourceMappingURL=cli-explain.js.map

package/dist/cli-lsp-diagnostic.d.ts

@@ -32,4 +32,3 @@ export interface LspPosition {
  * @returns LSP Diagnostic
  */
 export declare function toLspDiagnostic(error: RillError): LspDiagnostic;
-//# sourceMappingURL=cli-lsp-diagnostic.d.ts.map

package/dist/cli-lsp-diagnostic.js

@@ -95,4 +95,3 @@ function mapSeverityToLsp(severity) {
             return 1;
     }
 }
-//# sourceMappingURL=cli-lsp-diagnostic.js.map

package/dist/cli-module-loader.d.ts

@@ -16,4 +16,3 @@ import type { RillValue } from '@rcrsr/rill';
  * @throws Error if module not found or circular dependency detected
  */
 export declare function loadModule(specifier: string, fromPath: string, cache: Map<string, Record<string, RillValue>>, chain?: Set<string>): Promise<Record<string, RillValue>>;
-//# sourceMappingURL=cli-module-loader.d.ts.map

package/dist/cli-module-loader.js

@@ -56,4 +56,3 @@ export async function loadModule(specifier, fromPath, cache, chain = new Set())
         chain.delete(absolutePath);
     }
 }
-//# sourceMappingURL=cli-module-loader.js.map

package/dist/cli-run.d.ts

@@ -8,4 +8,3 @@ export declare function parseCliArgs(argv?: string[]): RunCliOptions & {
     rootDir?: string | undefined;
 };
 export declare function main(): Promise<void>;
-//# sourceMappingURL=cli-run.d.ts.map

package/dist/cli-run.js

@@ -26,7 +26,7 @@ Options:
   --format <mode>           Output format: human, json, compact (default: human)
   --verbose                 Show full error details (default: false)
   --max-stack-depth <n>     Error stack frame limit (default: 10)
-  --create-bindings         Write bindings source to config-defined file and exit
+  --create-bindings [dir]   Write bindings source to dir and exit (default: ./bindings)
   --explain <code>          Print error code documentation
   --help                    Print this help message and exit
   --version                 Print version and exit`.trimEnd();
@@ -38,17 +38,42 @@ const BASE_OPTIONS = {
     format: { type: 'string' },
     verbose: { type: 'boolean' },
     'max-stack-depth': { type: 'string' },
-    'create-bindings': { type: 'boolean' },
     help: { type: 'boolean' },
     version: { type: 'boolean' },
     explain: { type: 'string' },
 };
 // ============================================================
+// CREATE-BINDINGS EXTRACTION
+// ============================================================
+/**
+ * Extract --create-bindings [dir] from argv before parseArgs.
+ * Handles the optional dir argument that parseArgs cannot natively support.
+ * Returns the filtered argv (with --create-bindings removed) and the resolved dir.
+ */
+function extractCreateBindings(argv) {
+    const idx = argv.indexOf('--create-bindings');
+    if (idx === -1) {
+        return { filteredArgv: argv, createBindings: undefined };
+    }
+    const next = argv[idx + 1];
+    if (next !== undefined && !next.startsWith('-')) {
+        return {
+            filteredArgv: [...argv.slice(0, idx), ...argv.slice(idx + 2)],
+            createBindings: next,
+        };
+    }
+    return {
+        filteredArgv: [...argv.slice(0, idx), ...argv.slice(idx + 1)],
+        createBindings: './bindings',
+    };
+}
+// ============================================================
 // PARSE ARGS
 // ============================================================
 export function parseCliArgs(argv = process.argv.slice(2)) {
+    const { filteredArgv, createBindings } = extractCreateBindings(argv);
     const { values, positionals } = parseArgs({
-        args: argv,
+        args: filteredArgv,
         options: BASE_OPTIONS,
         allowPositionals: true,
         strict: false,
@@ -77,7 +102,7 @@ export function parseCliArgs(argv = process.argv.slice(2)) {
         verbose: values['verbose'] === true,
         maxStackDepth,
         explain: values['explain'],
-        createBindings: values['create-bindings'] === true,
+        createBindings,
     };
 }
 // ============================================================
@@ -96,8 +121,9 @@ function extractHandlerArgs(argv, params) {
             type: param.type === 'bool' ? 'boolean' : 'string',
         };
     }
+    const { filteredArgv } = extractCreateBindings(argv);
     const { values } = parseArgs({
-        args: argv,
+        args: filteredArgv,
         options: handlerOptions,
         allowPositionals: true,
         strict: false,
@@ -165,14 +191,20 @@ export async function main() {
         throw err;
     }
     // Create bindings and exit early if --create-bindings was set
-    if (opts.createBindings === true) {
-        const extBindingsPath = resolve(process.cwd(), project.config.extensions?.bindings ?? 'bindings/ext.rill');
-        mkdirSync(dirname(extBindingsPath), { recursive: true });
-        writeFileSync(extBindingsPath, project.extensionBindings + '\n');
+    if (opts.createBindings !== undefined) {
+        const bindingsDir = resolve(dirname(configPath), opts.createBindings);
+        mkdirSync(bindingsDir, { recursive: true });
+        writeFileSync(resolve(bindingsDir, 'ext.rill'), project.extensionBindings + '\n');
         if (project.config.context !== undefined) {
-            const ctxBindingsPath = resolve(process.cwd(), project.config.context.bindings ?? 'bindings/context.rill');
-            mkdirSync(dirname(ctxBindingsPath), { recursive: true });
-            writeFileSync(ctxBindingsPath, project.contextBindings + '\n');
+            writeFileSync(resolve(bindingsDir, 'context.rill'), project.contextBindings + '\n');
+        }
+        for (const dispose of project.disposes) {
+            try {
+                await dispose();
+            }
+            catch {
+                // Ignore dispose errors during cleanup
+            }
         }
         process.exit(0);
     }
@@ -272,7 +304,9 @@ export async function main() {
         ...opts,
         scriptPath,
     };
-    const runResult = await runScript(runOpts, project.config, project.extTree, project.extensionBindings, [...project.disposes]);
+    const runResult = await runScript(runOpts, project.config, project.extTree, [
+        ...project.disposes,
+    ]);
     if (runResult.output !== undefined) {
         process.stdout.write(runResult.output + '\n');
     }
@@ -294,4 +328,3 @@ if (shouldRunMain) {
         process.exit(1);
     });
 }
-//# sourceMappingURL=cli-run.js.map

package/dist/cli-shared.d.ts

@@ -53,4 +53,3 @@ export declare function detectHelpVersionFlag(argv: string[]): {
  * The version is now generated at build time by packages/core/scripts/generate-version.ts.
  */
 export { VERSION, CLI_VERSION };
-//# sourceMappingURL=cli-shared.d.ts.map

package/dist/cli-shared.js

@@ -140,4 +140,3 @@ export function detectHelpVersionFlag(argv) {
  * The version is now generated at build time by packages/core/scripts/generate-version.ts.
  */
 export { VERSION, CLI_VERSION };
-//# sourceMappingURL=cli-shared.js.map

package/dist/run/runner.d.ts

@@ -2,8 +2,8 @@
  * Script runner for rill-run.
  * Builds runtime options, executes rill scripts, and maps results to exit codes.
  */
-import { type SchemeResolver } from '@rcrsr/rill';
-import type { NestedExtConfig, RillConfigFile } from '@rcrsr/rill-config';
+import { type RillValue, type SchemeResolver } from '@rcrsr/rill';
+import type { RillConfigFile } from '@rcrsr/rill-config';
 import type { RunCliOptions } from './types.js';
 export interface RunResult {
     readonly exitCode: number;
@@ -11,14 +11,13 @@ export interface RunResult {
     readonly errorOutput?: string | undefined;
 }
 /**
- * Build a custom module scheme resolver.
- * - ID 'ext' → returns generated bindings source
- * - ID 'ext.*' → drills into extTree subtree and returns bindings for that node
- * - All other IDs → delegates to moduleResolver with the modules config
+ * Build a custom module scheme resolver using folder aliasing.
+ * Each config key maps to a directory. Dot-paths resolve to files within:
+ * - `module:alias.sub.path` → `{dir}/sub/path.rill`
+ * - `module:alias` → `{dir}/index.rill`
  */
-export declare function buildModuleResolver(bindingsSource: string, modulesConfig: Record<string, string>, extTree: NestedExtConfig, configDir: string): SchemeResolver;
+export declare function buildModuleResolver(modulesConfig: Record<string, string>, configDir: string): SchemeResolver;
 /**
  * Run a rill script file with the given extension tree and config.
  */
-export declare function runScript(opts: RunCliOptions, config: RillConfigFile, extTree: NestedExtConfig, bindingsSrc: string, disposes: Array<() => void | Promise<void>>): Promise<RunResult>;
-//# sourceMappingURL=runner.d.ts.map
+export declare function runScript(opts: RunCliOptions, config: RillConfigFile, extTree: Record<string, RillValue>, disposes: Array<() => void | Promise<void>>): Promise<RunResult>;