nola-lang 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Evgen Mykhailenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# nola-lang
+
+The [Nola](https://github.com/nola-lang/nola) toolchain. Nola is a TypeScript
+superset (`.tsi`) where `infer` functions and `ask` extractors turn prompts
+into typed values, resolved by a configured LLM at run time.
+
+Install as a **devDependency** — your app depends on
+[`@nola-lang/runtime`](https://www.npmjs.com/package/@nola-lang/runtime) and
+[`@nola-lang/providers`](https://www.npmjs.com/package/@nola-lang/providers)
+instead (the scaffold sets all of this up):
+
+```bash
+npm create nola-lang my-app     # or: npx nola init
+```
+
+## Commands
+
+```
+nola init [dir]                 scaffold a new Nola project
+nola build [dir] [--out dist]   compile .tsi -> js + source maps + d.ts
+nola run <entry>                run a .tsi/.ts entry with the loader + nola.config.ts
+nola check [dir]                type-check .tsi and .ts together, positions mapped back
+```
+
+## Direct node execution (the tsx model)
+
+```bash
+node --import nola-lang/register src/main.tsi
+```
+
+The loader inlines source maps pointing at the on-disk `.tsi`, so VS Code
+breakpoints bind directly in Nola source.

package/dist/build.d.ts

@@ -0,0 +1,6 @@
+export interface BuildResult {
+    written: string[];
+    errors: string[];
+}
+export declare function cmdBuild(dirArg?: string, outArg?: string): Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAAC,MAAM,SAAM,EAAE,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAwGlF"}

package/dist/build.js

@@ -0,0 +1,107 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { basename, dirname, join, relative, resolve } from "node:path";
+import remappingImport from "@ampproject/remapping";
+import { Codes } from "@nola-lang/ast";
+import { companionSourceCandidates, companionSpecifierFor, compileCompanion, compileNola } from "@nola-lang/compiler";
+import { findProjectRoot, loadCompilerOptions } from "@nola-lang/node-loader";
+import { transformSync } from "esbuild";
+import { collectCompanionEntries } from "./companions.js";
+import { printDiagnostics } from "./diag.js";
+import { createLoweredProgram } from "./tshost.js";
+import { walkProject } from "./walk.js";
+const remapping = remappingImport;
+export async function cmdBuild(dirArg = ".", outArg = "dist") {
+    const dir = resolve(dirArg);
+    const out = resolve(outArg);
+    const sourceRoot = findProjectRoot(dir);
+    const { underivableContextType } = await loadCompilerOptions(dir);
+    const written = [];
+    const errors = [];
+    const lowered = [];
+    const metas = [];
+    const { tsi, reserved } = await walkProject(dir);
+    for (const file of reserved) {
+        errors.push(`${file} ${Codes.ReservedCompanionPath}: the *.nola.* filename namespace is reserved for generated companion modules — rename this file`);
+    }
+    if (errors.length > 0)
+        return { written, errors };
+    for (const file of tsi) {
+        const source = await readFile(file, "utf8");
+        const result = compileNola(source, file, { sourceRoot, underivableContextType });
+        if (result.diagnostics.length > 0) {
+            errors.push(printDiagnostics(result.diagnostics, () => source));
+            continue;
+        }
+        lowered.push({ file, loweredCode: result.code });
+        metas.push(result.meta.companions);
+        const js = transformSync(result.code, { loader: "ts", format: "esm", sourcemap: "external", sourcefile: file });
+        let consumed = false;
+        const merged = remapping(js.map, () => {
+            if (consumed)
+                return null;
+            consumed = true;
+            return result.map;
+        });
+        const outPath = `${join(out, relative(dir, file))}.js`;
+        await mkdir(dirname(outPath), { recursive: true });
+        await writeFile(outPath, `${js.code}\n//# sourceMappingURL=${basename(outPath)}.map\n`);
+        await writeFile(`${outPath}.map`, merged.toString());
+        written.push(outPath, `${outPath}.map`);
+    }
+    // Companion worklist: every reachable type source gets one real module in
+    // dist, named by the same forward transform the lowered imports use — so
+    // production output needs no loader at all.
+    const emittedCompanions = new Set();
+    const companionQueue = lowered.flatMap((entry, i) => (metas[i] ?? []).map((specifier) => ({ importer: entry.file, specifier })));
+    while (companionQueue.length > 0) {
+        const { importer, specifier } = companionQueue.shift();
+        const src = companionSourceCandidates(specifier)
+            .map((c) => resolve(dirname(importer), c))
+            .find((p) => existsSync(p));
+        if (!src) {
+            errors.push(`${importer} ${Codes.CompanionUnavailable}: cannot locate the type source for "${specifier}"`);
+            continue;
+        }
+        if (emittedCompanions.has(src))
+            continue;
+        emittedCompanions.add(src);
+        const companion = compileCompanion(await readFile(src, "utf8"), src, { sourceRoot });
+        if (companion.code === "" || companion.diagnostics.length > 0) {
+            errors.push(printDiagnostics(companion.diagnostics, () => ""));
+            continue;
+        }
+        const js = transformSync(companion.code, { loader: "ts", format: "esm" });
+        const outName = companionSpecifierFor(basename(src));
+        const outPath = join(out, relative(dir, join(dirname(src), outName)));
+        await mkdir(dirname(outPath), { recursive: true });
+        await writeFile(outPath, js.code);
+        written.push(outPath);
+        companionQueue.push(...companion.companions.map((c) => ({ importer: src, specifier: c })));
+    }
+    if (lowered.length > 0) {
+        const companionEntries = await collectCompanionEntries(lowered.map((entry, i) => ({ file: entry.file, companions: metas[i] ?? [] })), sourceRoot);
+        const { program, virtualName } = createLoweredProgram(lowered, dir, "declarations", companionEntries.virtual);
+        for (const entry of lowered) {
+            const sourceFile = program.getSourceFile(virtualName(entry.file));
+            if (!sourceFile)
+                continue;
+            let declarationText = "";
+            program.emit(sourceFile, (fileName, text) => {
+                if (fileName.endsWith(".d.ts"))
+                    declarationText = text;
+            }, undefined, true);
+            if (declarationText) {
+                // Next to the built .js in --out (report.tsi.js + report.tsi.d.ts pair
+                // under NodeNext), NEVER adjacent to the source: the editor serves
+                // .tsi virtually, and an on-disk declaration would only shadow it.
+                const dtsPath = `${join(out, relative(dir, entry.file))}.d.ts`;
+                await mkdir(dirname(dtsPath), { recursive: true });
+                await writeFile(dtsPath, declarationText);
+                written.push(dtsPath);
+            }
+        }
+    }
+    return { written, errors };
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/check.d.ts

@@ -0,0 +1,4 @@
+export declare function cmdCheck(dirArg?: string): Promise<{
+    errors: string[];
+}>;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAYA,wBAAsB,QAAQ,CAAC,MAAM,SAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8D1E"}

package/dist/check.js

@@ -0,0 +1,71 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { originalPositionFor, TraceMap } from "@jridgewell/trace-mapping";
+import { Codes } from "@nola-lang/ast";
+import { compileNola } from "@nola-lang/compiler";
+import { findProjectRoot, loadCompilerOptions } from "@nola-lang/node-loader";
+import ts from "typescript";
+import { collectCompanionEntries } from "./companions.js";
+import { printDiagnostics } from "./diag.js";
+import { createLoweredProgram } from "./tshost.js";
+import { walkProject } from "./walk.js";
+export async function cmdCheck(dirArg = ".") {
+    const dir = resolve(dirArg);
+    // Check the same text `nola build` emits, so the two can't drift.
+    const sourceRoot = findProjectRoot(dir);
+    const { underivableContextType } = await loadCompilerOptions(dir);
+    const errors = [];
+    const { tsi, reserved } = await walkProject(dir);
+    for (const file of reserved) {
+        errors.push(`${file} ${Codes.ReservedCompanionPath}: the *.nola.* filename namespace is reserved for generated companion modules — rename this file`);
+    }
+    if (errors.length > 0)
+        return { errors };
+    const entries = [];
+    const maps = new Map();
+    const seeds = [];
+    for (const file of tsi) {
+        const source = await readFile(file, "utf8");
+        const result = compileNola(source, file, { sourceRoot, underivableContextType });
+        if (result.diagnostics.length > 0) {
+            errors.push(printDiagnostics(result.diagnostics, () => source));
+            continue;
+        }
+        entries.push({ file, loweredCode: result.code });
+        maps.set(file, result.map);
+        seeds.push({ file, companions: result.meta.companions });
+    }
+    if (entries.length === 0)
+        return { errors };
+    const companionEntries = await collectCompanionEntries(seeds, sourceRoot);
+    errors.push(...companionEntries.errors);
+    const { program, virtualName } = createLoweredProgram(entries, dir, "check", companionEntries.virtual);
+    const virtualToFile = new Map(entries.map((e) => [virtualName(e.file).replace(/\\/g, "/"), e.file]));
+    for (const d of ts.getPreEmitDiagnostics(program)) {
+        if (!d.file || d.start === undefined)
+            continue;
+        const fileName = d.file.fileName.replace(/\\/g, "/");
+        const message = ts.flattenDiagnosticMessageText(d.messageText, " ");
+        const companionSource = companionEntries.sources.get(fileName);
+        if (companionSource) {
+            // Diagnostics policy: never report into a file the user cannot open.
+            errors.push(`${companionSource}:1:1 TS${d.code}: in derived type module: ${message}`);
+            continue;
+        }
+        const original = virtualToFile.get(fileName);
+        if (!original) {
+            // A real on-disk file (a plain .ts project root): position it directly.
+            const pos = d.file.getLineAndCharacterOfPosition(d.start);
+            errors.push(`${d.file.fileName}:${pos.line + 1}:${pos.character + 1} TS${d.code}: ${message}`);
+            continue;
+        }
+        const generated = d.file.getLineAndCharacterOfPosition(d.start);
+        const tracer = new TraceMap(maps.get(original));
+        const pos = originalPositionFor(tracer, { line: generated.line + 1, column: generated.character });
+        const line = pos.line ?? generated.line + 1;
+        const column = (pos.column ?? generated.character) + 1;
+        errors.push(`${original}:${line}:${column} TS${d.code}: ${message}`);
+    }
+    return { errors };
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

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

package/dist/companions.d.ts

@@ -0,0 +1,18 @@
+export interface CompanionEntries {
+    /** normalized absolute virtual path (<resolved companion>.ts) -> generated TS */
+    virtual: Map<string, string>;
+    /** virtual path -> on-disk source file it derives from (for diagnostic remap) */
+    sources: Map<string, string>;
+    errors: string[];
+}
+/**
+ * Host-side worklist: resolve every companion specifier reachable from the
+ * lowered entries (transitively through generated companions), generate each
+ * module once, and key it under the exact virtual path TypeScript's NodeNext
+ * `.js`→`.ts` mapping will look up.
+ */
+export declare function collectCompanionEntries(seeds: Array<{
+    file: string;
+    companions: string[];
+}>, sourceRoot: string): Promise<CompanionEntries>;
+//# sourceMappingURL=companions.d.ts.map

package/dist/companions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companions.d.ts","sourceRoot":"","sources":["../src/companions.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,iFAAiF;IACjF,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EACpD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CA6B3B"}

package/dist/companions.js

@@ -0,0 +1,44 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { Codes } from "@nola-lang/ast";
+import { companionSourceCandidates, compileCompanion } from "@nola-lang/compiler";
+function norm(p) {
+    return p.replace(/\\/g, "/");
+}
+/**
+ * Host-side worklist: resolve every companion specifier reachable from the
+ * lowered entries (transitively through generated companions), generate each
+ * module once, and key it under the exact virtual path TypeScript's NodeNext
+ * `.js`→`.ts` mapping will look up.
+ */
+export async function collectCompanionEntries(seeds, sourceRoot) {
+    const out = { virtual: new Map(), sources: new Map(), errors: [] };
+    const queue = seeds.flatMap((s) => s.companions.map((c) => ({ importer: s.file, specifier: c })));
+    const seen = new Set();
+    while (queue.length > 0) {
+        const { importer, specifier } = queue.shift();
+        const resolved = resolve(dirname(importer), specifier); // …/models.nola.js
+        const virtualName = `${norm(resolved).slice(0, -".js".length)}.ts`;
+        if (seen.has(virtualName))
+            continue;
+        seen.add(virtualName);
+        const src = companionSourceCandidates(specifier)
+            .map((c) => resolve(dirname(importer), c))
+            .find((p) => existsSync(p));
+        if (!src) {
+            out.errors.push(`${importer} ${Codes.CompanionUnavailable}: cannot locate the type source for "${specifier}"`);
+            continue;
+        }
+        const compiled = compileCompanion(await readFile(src, "utf8"), src, { sourceRoot });
+        if (compiled.code === "" || compiled.diagnostics.length > 0) {
+            out.errors.push(`${src} ${Codes.CompanionUnavailable}: cannot derive a type module (${compiled.diagnostics[0]?.message ?? "parse failed"})`);
+            continue;
+        }
+        out.virtual.set(virtualName, compiled.code);
+        out.sources.set(virtualName, src);
+        queue.push(...compiled.companions.map((c) => ({ importer: src, specifier: c })));
+    }
+    return out;
+}
+//# sourceMappingURL=companions.js.map

package/dist/companions.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+export type { AskContext, AskReceipt, AskResult, NolaConfig, NolaHook, NolaLogLevel, NolaMiddleware, NolaProvider, ProviderRef, } from "@nola-lang/core";
+export { constant, defineConfig, exponential, fallback, type RetryPolicy, roundRobin, withRetry, } from "@nola-lang/runtime";
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,KAAK,WAAW,EAChB,UAAU,EACV,SAAS,GACV,MAAM,oBAAoB,CAAC"}

package/dist/config.js

@@ -0,0 +1,2 @@
+export { constant, defineConfig, exponential, fallback, roundRobin, withRetry, } from "@nola-lang/runtime";
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,QAAQ,EAER,UAAU,EACV,SAAS,GACV,MAAM,oBAAoB,CAAC"}

package/dist/diag.d.ts

@@ -0,0 +1,3 @@
+import type { Diagnostic } from "@nola-lang/ast";
+export declare function printDiagnostics(diagnostics: Diagnostic[], readSource: (file: string) => string | null): string;
+//# sourceMappingURL=diag.d.ts.map

package/dist/diag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diag.d.ts","sourceRoot":"","sources":["../src/diag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,MAAM,CAQ/G"}

package/dist/diag.js

@@ -0,0 +1,11 @@
+import { codeFrame } from "./frame.js";
+export function printDiagnostics(diagnostics, readSource) {
+    return diagnostics
+        .map((d) => {
+        const head = `${d.file}:${d.loc.start.line}:${d.loc.start.column + 1} ${d.code}: ${d.message}`;
+        const source = readSource(d.file);
+        return source ? `${head}\n${codeFrame(source, d.loc.start.line, d.loc.start.column)}` : head;
+    })
+        .join("\n\n");
+}
+//# sourceMappingURL=diag.js.map

package/dist/diag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diag.js","sourceRoot":"","sources":["../src/diag.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,UAAU,gBAAgB,CAAC,WAAyB,EAAE,UAA2C;IACrG,OAAO,WAAW;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/F,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/F,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/frame.d.ts

@@ -0,0 +1,3 @@
+/** Minimal code frame: the offending line plus a caret. line 1-based, column 0-based. */
+export declare function codeFrame(source: string, line: number, column: number): string;
+//# sourceMappingURL=frame.d.ts.map

package/dist/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../src/frame.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK9E"}

package/dist/frame.js

@@ -0,0 +1,8 @@
+/** Minimal code frame: the offending line plus a caret. line 1-based, column 0-based. */
+export function codeFrame(source, line, column) {
+    const lines = source.split(/\r?\n/);
+    const text = lines[line - 1] ?? "";
+    const gutter = `${line} | `;
+    return `${gutter}${text}\n${" ".repeat(gutter.length + column)}^`;
+}
+//# sourceMappingURL=frame.js.map

package/dist/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../src/frame.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,IAAY,EAAE,MAAc;IACpE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC;IAC5B,OAAO,GAAG,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;AACpE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { type BuildResult, cmdBuild } from "./build.js";
+export { cmdCheck } from "./check.js";
+export { printDiagnostics } from "./diag.js";
+export { codeFrame } from "./frame.js";
+export { cmdRun } from "./run.js";
+export { createLoweredProgram, type LoweredEntry, type LoweredProgram } from "./tshost.js";
+export { findNolaFiles } from "./walk.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,OAAO,EAAE,KAAK,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { cmdBuild } from "./build.js";
+export { cmdCheck } from "./check.js";
+export { printDiagnostics } from "./diag.js";
+export { codeFrame } from "./frame.js";
+export { cmdRun } from "./run.js";
+export { createLoweredProgram } from "./tshost.js";
+export { findNolaFiles } from "./walk.js";
+//# 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,OAAO,EAAoB,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAA0C,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,3 @@
+/** `nola init [dir]` — the same scaffold `npm create nola-lang` runs. */
+export declare function cmdInit(dir: string): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1D"}

package/dist/init.js

@@ -0,0 +1,14 @@
+import { scaffold } from "create-nola-lang";
+/** `nola init [dir]` — the same scaffold `npm create nola-lang` runs. */
+export async function cmdInit(dir) {
+    const { root, files } = await scaffold(dir);
+    console.log(`Scaffolded a Nola project into ${root} (${files.length} files).`);
+    console.log("");
+    console.log("Next steps:");
+    if (dir !== ".")
+        console.log(`  cd ${dir}`);
+    console.log("  npm install");
+    console.log("  npm start        # runs offline via the replay ledger — no API key needed");
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW;IACvC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,kCAAkC,IAAI,KAAK,KAAK,CAAC,MAAM,UAAU,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC3F,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

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

package/dist/main.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { cmdBuild } from "./build.js";
+import { cmdCheck } from "./check.js";
+import { cmdInit } from "./init.js";
+import { cmdRun } from "./run.js";
+const HELP = `nola <command>
+
+Commands:
+  init [dir]                  scaffold a new Nola project (same starter as npm create nola-lang)
+  build [dir] [--out <dir>]   compile all .tsi files (js+map+d.ts to --out)
+  run <entry>                 run a .tsi/.js entry with the Nola loader + nola.config.ts
+  check [dir]                 type-check lowered .tsi files AND the project's .ts files, positions mapped back
+`;
+async function main() {
+    const { positionals, values } = parseArgs({
+        allowPositionals: true,
+        options: { out: { type: "string", default: "dist" } },
+    });
+    const [command, arg] = positionals;
+    switch (command) {
+        case "build": {
+            const { written, errors } = await cmdBuild(arg ?? ".", values.out);
+            if (errors.length > 0) {
+                console.error(errors.join("\n\n"));
+                return 1;
+            }
+            console.log(`nola build: ${written.length} files written`);
+            return 0;
+        }
+        case "check": {
+            const { errors } = await cmdCheck(arg ?? ".");
+            if (errors.length > 0) {
+                console.error(errors.join("\n"));
+                return 1;
+            }
+            console.log("nola check: no errors");
+            return 0;
+        }
+        case "run":
+            return cmdRun(arg ?? "");
+        case "init":
+            return cmdInit(arg ?? ".");
+        default:
+            console.log(HELP);
+            return command ? 1 : 0;
+    }
+}
+main().then((code) => process.exit(code), (err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,IAAI,GAAG;;;;;;;CAOZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QACxC,gBAAgB,EAAE,IAAI;QACtB,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;KACtD,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC;IACnC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,GAAG,IAAI,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YACnE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;gBACnC,OAAO,CAAC,CAAC;YACX,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,MAAM,gBAAgB,CAAC,CAAC;YAC3D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;YAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjC,OAAO,CAAC,CAAC;YACX,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YACrC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QAC3B,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QAC7B;YACE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CACT,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,GAAG,EAAE,EAAE;IACN,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,3 @@
+export type { NolaProvider, ProviderRef, ProviderRequest } from "@nola-lang/core";
+export { mockProvider, type OpenAiOptions, openai, providers, } from "@nola-lang/runtime";
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,MAAM,EACN,SAAS,GACV,MAAM,oBAAoB,CAAC"}

package/dist/providers.js

@@ -0,0 +1,2 @@
+export { mockProvider, openai, providers, } from "@nola-lang/runtime";
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EAEZ,MAAM,EACN,SAAS,GACV,MAAM,oBAAoB,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

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

package/dist/register.js

@@ -0,0 +1,3 @@
+import { registerNola } from "@nola-lang/node-loader";
+await registerNola();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,YAAY,EAAE,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdRun(entryArg: string): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAIA,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9D"}

package/dist/run.js

@@ -0,0 +1,14 @@
+import { dirname, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { registerNola } from "@nola-lang/node-loader";
+export async function cmdRun(entryArg) {
+    if (!entryArg) {
+        console.error("nola run <entry>");
+        return 1;
+    }
+    const entry = resolve(entryArg);
+    await registerNola({ dir: dirname(entry) });
+    await import(pathToFileURL(entry).href);
+    return 0;
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,3 @@
+export type { InferType, UnsupportedType } from "@nola-lang/runtime";
+export { __nola } from "@nola-lang/runtime";
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AASA,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,7 @@
+// The lowering emits `import { __nola } from "nola-lang/runtime"` into user code.
+// This subpath re-exports the runtime brand from the package the user actually
+// installs (nola-lang), so the injected import resolves without relying on
+// hoisting of the private @nola-lang/runtime scope. Mirrors React's
+// `react/jsx-runtime`.
+export { __nola } from "@nola-lang/runtime";
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,+EAA+E;AAC/E,2EAA2E;AAC3E,oEAAoE;AACpE,uBAAuB;AAMvB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/tshost.d.ts

@@ -0,0 +1,12 @@
+import ts from "typescript";
+export interface LoweredEntry {
+    file: string;
+    loweredCode: string;
+}
+export interface LoweredProgram {
+    program: ts.Program;
+    virtualName(file: string): string;
+    options: ts.CompilerOptions;
+}
+export declare function createLoweredProgram(entries: LoweredEntry[], projectDir: string, mode: "check" | "declarations", extraVirtual?: Map<string, string>): LoweredProgram;
+//# sourceMappingURL=tshost.d.ts.map

package/dist/tshost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tshost.d.ts","sourceRoot":"","sources":["../src/tshost.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAM5B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC;CAC7B;AAMD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,GAAG,cAAc,EAC9B,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,cAAc,CA0FhB"}

package/dist/tshost.js

@@ -0,0 +1,90 @@
+import { loweredVirtualNameFor, RUNTIME_AMBIENT_STUB } from "@nola-lang/compiler";
+import ts from "typescript";
+const RUNTIME_STUB = RUNTIME_AMBIENT_STUB;
+const STUB_RUNTIME_PATH = "/__nola_stubs__/runtime.d.ts";
+function norm(p) {
+    return p.replace(/\\/g, "/");
+}
+export function createLoweredProgram(entries, projectDir, mode, extraVirtual) {
+    const virtual = new Map();
+    const virtualName = (file) => loweredVirtualNameFor(file);
+    for (const e of entries)
+        virtual.set(virtualName(e.file), e.loweredCode);
+    // Companion modules and other synthesized support files; reachable from the
+    // roots via imports, so they are not added to rootNames.
+    if (extraVirtual)
+        for (const [k, v] of extraVirtual)
+            virtual.set(norm(k), v);
+    let options = {
+        strict: true,
+        target: ts.ScriptTarget.ES2022,
+        module: ts.ModuleKind.NodeNext,
+        moduleResolution: ts.ModuleResolutionKind.NodeNext,
+        skipLibCheck: true,
+    };
+    // In check mode the project's plain .ts files join the program roots (the
+    // vue-tsc role): their `./x.tsi` imports resolve to the LIVE lowered
+    // virtuals below, so no declaration files are needed anywhere. Stale
+    // .d.tsi.ts artifacts of the old adjacent emit are excluded outright.
+    let projectTsFiles = [];
+    const configPath = ts.findConfigFile(projectDir, ts.sys.fileExists, "tsconfig.json");
+    if (configPath) {
+        const parsed = ts.parseJsonConfigFileContent(ts.readConfigFile(configPath, ts.sys.readFile).config, ts.sys, projectDir);
+        options = { ...parsed.options, ...options, strict: parsed.options.strict ?? true };
+        if (mode === "check") {
+            projectTsFiles = parsed.fileNames.map(norm).filter((f) => !f.endsWith(".d.tsi.ts"));
+        }
+    }
+    options =
+        mode === "check"
+            ? { ...options, noEmit: true }
+            : { ...options, noEmit: false, declaration: true, emitDeclarationOnly: true };
+    // Bare projects (tests) can't resolve the runtime the lowering imports
+    // (`@nola-lang/runtime`) — fall back to stubs.
+    const probe = ts.resolveModuleName("@nola-lang/runtime", `${norm(projectDir)}/probe.ts`, options, ts.sys);
+    if (!probe.resolvedModule) {
+        virtual.set(STUB_RUNTIME_PATH, RUNTIME_STUB);
+        options = {
+            ...options,
+            baseUrl: "/",
+            paths: {
+                "@nola-lang/runtime": [STUB_RUNTIME_PATH],
+            },
+        };
+    }
+    const host = ts.createCompilerHost(options);
+    const defaultReadFile = host.readFile.bind(host);
+    const defaultFileExists = host.fileExists.bind(host);
+    const defaultGetSourceFile = host.getSourceFile.bind(host);
+    host.readFile = (f) => virtual.get(norm(f)) ?? defaultReadFile(f);
+    host.fileExists = (f) => virtual.has(norm(f)) || defaultFileExists(f);
+    host.getSourceFile = (f, lang, onError, shouldCreate) => virtual.has(norm(f))
+        ? ts.createSourceFile(f, virtual.get(norm(f)), lang)
+        : defaultGetSourceFile(f, lang, onError, shouldCreate);
+    const defaultResolve = (specifier, containing) => ts.resolveModuleName(specifier, containing, options, {
+        fileExists: host.fileExists,
+        readFile: (f) => host.readFile(f) ?? undefined,
+    }).resolvedModule;
+    host.resolveModuleNameLiterals = (literals, containingFile) => literals.map((lit) => {
+        const spec = lit.text;
+        if (spec.endsWith(".tsi")) {
+            const base = norm(containingFile).replace(/\/[^/]*$/, "");
+            const target = norm(new URL(spec, `file:///${base}/`).pathname.replace(/^\/([A-Za-z]:)/, "$1"));
+            const virt = `${target}.ts`;
+            if (virtual.has(virt)) {
+                return {
+                    resolvedModule: { resolvedFileName: virt, extension: ts.Extension.Ts, isExternalLibraryImport: false },
+                };
+            }
+        }
+        return { resolvedModule: defaultResolve(spec, containingFile) ?? undefined };
+    });
+    const rootNames = [
+        ...entries.map((e) => virtualName(e.file)),
+        ...projectTsFiles,
+        ...(virtual.has(STUB_RUNTIME_PATH) ? [STUB_RUNTIME_PATH] : []),
+    ];
+    const program = ts.createProgram(rootNames, options, host);
+    return { program, virtualName, options };
+}
+//# sourceMappingURL=tshost.js.map

package/dist/tshost.js.map

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

package/dist/walk.d.ts

@@ -0,0 +1,6 @@
+export declare function walkProject(dir: string): Promise<{
+    tsi: string[];
+    reserved: string[];
+}>;
+export declare function findNolaFiles(dir: string): Promise<string[]>;
+//# sourceMappingURL=walk.d.ts.map

package/dist/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../src/walk.ts"],"names":[],"mappings":"AAMA,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkB7F;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAElE"}

package/dist/walk.js

@@ -0,0 +1,29 @@
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { isReservedNolaName } from "@nola-lang/compiler";
+const SKIP = new Set(["node_modules", ".git", "dist"]);
+export async function walkProject(dir) {
+    const tsi = [];
+    const reserved = [];
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            if (!SKIP.has(entry.name)) {
+                const nested = await walkProject(join(dir, entry.name));
+                tsi.push(...nested.tsi);
+                reserved.push(...nested.reserved);
+            }
+        }
+        else if (isReservedNolaName(entry.name)) {
+            reserved.push(join(dir, entry.name));
+        }
+        else if (entry.name.endsWith(".tsi")) {
+            tsi.push(join(dir, entry.name));
+        }
+    }
+    return { tsi: tsi.sort(), reserved: reserved.sort() };
+}
+export async function findNolaFiles(dir) {
+    return (await walkProject(dir)).tsi;
+}
+//# sourceMappingURL=walk.js.map

package/dist/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../src/walk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBACxD,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBACxB,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;aAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,OAAO,CAAC,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "nola-lang",
+  "version": "0.1.0-alpha.0",
+  "description": "The Nola language toolchain: nola init/build/run/check and the Node loader for .tsi files",
+  "keywords": [
+    "nola",
+    "llm",
+    "ai",
+    "typescript",
+    "language",
+    "prompt",
+    "cli"
+  ],
+  "license": "MIT",
+  "author": "Evgen Mykhailenko",
+  "homepage": "https://github.com/nola-lang/nola#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nola-lang/nola.git",
+    "directory": "packages/nola-lang"
+  },
+  "bugs": {
+    "url": "https://github.com/nola-lang/nola/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "nola": "./dist/main.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./register": "./dist/register.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "create-nola-lang": "0.1.0-alpha.0",
+    "@nola-lang/ast": "0.1.0-alpha.0",
+    "@nola-lang/compiler": "0.1.0-alpha.0",
+    "@nola-lang/node-loader": "0.1.0-alpha.0",
+    "@nola-lang/parser": "0.1.0-alpha.0",
+    "@nola-lang/runtime": "0.1.0-alpha.0",
+    "@ampproject/remapping": "^2.3.0",
+    "@jridgewell/trace-mapping": "^0.3.25",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}