@swiftuijs/twill 0.2.0 → 0.3.1

package/README.md

@@ -22,7 +22,7 @@ async function readOwned(acquire: () => Promise<TextDocument>) {
 
 The successful path stays in view; release sits next to acquisition. Registration is block-scoped, cleanup is awaited explicitly, and `return await` keeps an owned resource alive until its work finishes. The output uses ordinary JS control flow.
 
-**Release line:** 0.1. Twill is an experimental language with a tested compiler, editor and build workflow. Start with one module and evaluate it against your application’s requirements. See [support and compatibility](https://twill.evecalm.com/readiness).
+**Release line:** 0.2. Twill is an experimental language with a tested compiler, editor and build workflow. Start with one module and evaluate it against your application’s requirements. See [support and compatibility](https://twill.evecalm.com/readiness).
 
 ## Why use Twill?
 
@@ -52,7 +52,9 @@ function describe(outcome: Outcome): string {
 }
 ```
 
-Ordinary closures become arrows; guards become branches. Direct-return switch expressions become native switches. Twill 0.2.0 also removes the IIFE from standalone identifier initializers; other expression contexts retain it. Inline emission introduces no runtime library. `defer` allocates callbacks and dynamic registrations use a local stack; general component child collection uses arrays. These costs are [documented and measured](https://twill.evecalm.com/performance).
+Ordinary closures become arrows; guards become branches. Direct-return switch expressions become native switches. Twill 0.2.0 also removes the IIFE from standalone identifier initializers; other expression contexts retain it. Inline emission introduces no runtime library. Dynamic/async `defer` and scope-sensitive registrations retain callbacks; dynamic registrations use a local stack; general component child collection uses arrays. These costs are [documented and measured](https://twill.evecalm.com/performance).
+
+Twill 0.3.0 emits native `try/finally` for eligible direct synchronous cleanup and reduces repeated editor/configuration work. The older 0.2.0 retains callback-based cleanup. Dynamic registration, general expression lowering and cold initialization still have measured costs; use the [performance guide](https://twill.evecalm.com/performance) to choose and profile hot paths.
 
 | File                         | Use                                                         |
 | ---------------------------- | ----------------------------------------------------------- |
@@ -68,11 +70,11 @@ Twill and native files can import each other through the build adapters, virtual
 
 The [playground](https://twill.evecalm.com/playground) runs the actual compiler locally, with live highlighting and generated-source inspection. It does not execute your code or type-check project imports.
 
-Install the compiler as a development dependency in your application. It supports Node 20.19+ or 22.12+. Default inline emission introduces no language runtime dependency into your application bundle. The [optional runtime](https://twill.evecalm.com/runtime) in 0.2.0 shares dynamic synchronous cleanup when explicitly selected.
+Install the compiler as a development dependency in your application. Use Node 24 LTS for a new setup; the package supports `^20.19.0 || >=22.12.0`. Run from the directory containing your `package.json` (run `npm init -y` first for a new project). Default inline emission introduces no language runtime dependency into your application bundle. The [optional runtime](https://twill.evecalm.com/runtime) in 0.2.0 shares dynamic synchronous cleanup when explicitly selected.
 
 ```sh
-pnpm add -D @swiftuijs/twill
-# npm install --save-dev @swiftuijs/twill
+pnpm add -D @swiftuijs/twill@0.3.1
+# npm install --save-dev @swiftuijs/twill@0.3.1
 ```
 
 Add the Vite adapter to your existing configuration:
@@ -92,6 +94,19 @@ pnpm exec twill check -p tsconfig.json
 
 Follow [getting started](https://twill.evecalm.com/getting-started) to complete the editor, formatter and linter setup. For React, use the [React Vite adapter](https://twill.evecalm.com/frameworks#react-with-vite-8) to keep Fast Refresh working.
 
+## Run a script
+
+For a project-local command, install the compiler above, save this as `hello.twill` and run `npm exec -- twill hello.twill 'hello world'` (or `pnpm exec twill hello.twill 'hello world'`):
+
+```typescript
+#!/usr/bin/env twill
+console.log(process.argv.slice(2));
+```
+
+Expected output is `[ 'hello world' ]`. On Linux/macOS, use `chmod +x hello.twill` then `npm exec --call './hello.twill "hello world"'` or `pnpm exec ./hello.twill 'hello world'` for a local shebang. For direct `./hello.twill` execution, install `@swiftuijs/twill` globally with `npm install --global @swiftuijs/twill@0.3.1` and keep `twill` on PATH. Windows uses the explicit CLI.
+
+Install `@swiftuijs/twill-shell` in the script's project only when using its subprocess API; a global compiler does not install project imports. Follow [shell scripting](https://twill.evecalm.com/scripting) for complete installation, a portable subprocess example, Node type checking and troubleshooting. Native JS/TS consumers need only the SDK.
+
 ## A complete working loop
 
 | Tool                 | What it provides                                                                                           |
@@ -136,7 +151,7 @@ Install only the tools your project needs. Keep Twill packages on the same relea
 | `@swiftuijs/twill-shell`                                                                 | Native argv execution, bounded output and owned process teardown |
 | `@swiftuijs/twill-runtime`                                                               | Optional, versioned synchronous cleanup helpers                  |
 
-The [shell scripting](https://twill.evecalm.com/scripting) toolkit adds `#!/usr/bin/env twill` executable scripts and content-validated startup caching in 0.2.0. Install/import `@swiftuijs/twill-shell` for subprocesses; its Rust engine and eight-platform prebuilds install automatically. Native JS/TS consumers need no compiler. See [performance](https://twill.evecalm.com/performance#rust-shell-backend) for measured warm gains and cold/polling limits.
+The [shell scripting](https://twill.evecalm.com/scripting) toolkit adds `#!/usr/bin/env twill` executable scripts and content-validated startup caching in 0.2.0. Install/import `@swiftuijs/twill-shell` for subprocesses; native JS/TS consumers need no compiler. npm 0.2.0 still uses the retired Rust addon. Twill 0.3.0 simplifies the SDK to Node spawn/streams with zero production dependencies; cancel and await work before worker/process exit. See the [version and ownership boundary](https://twill.evecalm.com/scripting#execution-and-version-boundary).
 
 Install the [Twill VS Code extension](https://marketplace.visualstudio.com/items?itemName=forth-ink.twill) from Marketplace, or run `code --install-extension forth-ink.twill`. The extension bundles its editing tools. Your application installs the compiler for builds and whole-project checks. See the [editor guide](https://twill.evecalm.com/tooling) for configuration.
 
@@ -152,7 +167,7 @@ Install the [official Twill AI skill](https://twill.evecalm.com/ai) with `npx sk
 
 ## Contributing
 
-The repository is a pnpm workspace with Vite builds. See the [development guide](https://github.com/swiftuijs/twill/blob/main/docs/contributing/tooling.md) for checkout, dependency and build commands. Compiler, formatter, linter, export, highlight, optional runtime and shell packages, editor packages, examples and the English documentation site own their code and tests.
+The repository is a pnpm workspace with Vite builds. Tooling packages and editor integrations are developed in Twill, exercising the same public adapters, checker and declaration emitter as applications. The compiler remains bootstrapped from JS/TS; see [developing tooling in Twill](https://github.com/swiftuijs/twill/blob/main/docs/contributing/dogfooding.md). See the [development guide](https://github.com/swiftuijs/twill/blob/main/docs/contributing/tooling.md) for checkout, dependency and build commands. Compiler, formatter, linter, export, highlight, optional runtime and shell packages, editor packages, examples and the English documentation site own their code and tests.
 
 ```sh
 pnpm check

package/bin/run.mjs

@@ -1,6 +1,6 @@
 import { resolve, extname } from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { register } from 'node:module';
+import { registerLoader } from '../dist/loader-registration.js';
 import { realpathSync } from 'node:fs';
 
 export async function run(filename, args) {
@@ -10,6 +10,6 @@ export async function run(filename, args) {
   const entries = native ? [] : [url, pathToFileURL(realpathSync(script)).href];
   process.argv = [process.execPath, script, ...args];
   process.setSourceMapsEnabled(true);
-  register('../dist/loader.js', import.meta.url, { data: { entries, cache: true } });
+  await registerLoader({ entries, cache: true });
   await import(url);
 }

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { a as transform } from "./compiler-DY1N07np.js";
-import { n as loadConfig } from "./configuration-CTJjSu_h.js";
-import { TwillProject } from "./project.js";
-import { inspectProject } from "./doctor.js";
-import { emitDeclarations } from "./declarations.js";
-import { t as transpile } from "./transpile-DG81yfVs.js";
+import { a as transform } from "./compiler-BdkU4Ruh.js";
+import { n as loadConfig } from "./configuration-BVMf6Q_j.js";
+import { t as TwillProject } from "./project-ZmlpFooa.js";
+import { t as inspectProject } from "./doctor-Co_pdZtt.js";
+import { t as emitDeclarations } from "./declarations-BTAS8Mb_.js";
+import { t as transpile } from "./transpile-CLNavDUr.js";
 import { createRequire } from "node:module";
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";

package/dist/{compilation-cache-CuCGz02_.js → compilation-cache-7SugqJ4n.js}

@@ -167,6 +167,6 @@ function openCompilationCache() {
 	} catch {}
 }
 //#endregion
-export { observe as n, openCompilationCache as r, digest as t };
+export { openCompilationCache as i, observationsMatch as n, observe as r, digest as t };
 
-//# sourceMappingURL=compilation-cache-CuCGz02_.js.map
+//# sourceMappingURL=compilation-cache-7SugqJ4n.js.map

package/dist/{compilation-cache-CuCGz02_.js.map → compilation-cache-7SugqJ4n.js.map}

@@ -1 +1 @@
-{"version":3,"file":"compilation-cache-CuCGz02_.js","names":[],"sources":["../src/compilation-cache.ts"],"sourcesContent":["import {\n  closeSync,\n  constants,\n  existsSync,\n  fstatSync,\n  lstatSync,\n  mkdirSync,\n  openSync,\n  readFileSync,\n  readdirSync,\n  realpathSync,\n  statSync,\n  renameSync,\n  unlinkSync,\n  writeFileSync,\n  type Stats,\n} from 'node:fs';\nimport { createHash, randomUUID } from 'node:crypto';\nimport { createRequire } from 'node:module';\nimport { homedir } from 'node:os';\nimport { dirname, isAbsolute, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nexport type ConfigurationObservation = {\n  path: string;\n  kind: 'file' | 'directory';\n  value: string;\n};\nconst limit = 512 * 1024;\nconst packages = [\n  'typescript',\n  'acorn',\n  'acorn-typescript',\n  'acorn-jsx',\n  'magic-string',\n  '@ampproject/remapping',\n  '@jridgewell/trace-mapping',\n];\nexport const digest = (source: string | Uint8Array) =>\n  createHash('sha256').update(source).digest('hex');\n\nexport function observe(path: string, kind: ConfigurationObservation['kind']): string {\n  try {\n    if (kind === 'directory') return statSync(path).isDirectory() ? 'directory' : 'absent';\n    return digest(readFileSync(path));\n  } catch (error) {\n    return ['ENOENT', 'ENOTDIR'].includes((error as NodeJS.ErrnoException).code ?? '')\n      ? 'absent'\n      : 'unavailable';\n  }\n}\nexport function observationsMatch(observations: ConfigurationObservation[]): boolean {\n  return observations.every(({ path, kind, value }) => {\n    const current = observe(path, kind);\n    return current !== 'unavailable' && current === value;\n  });\n}\n\n/** Hash actual installed code without evaluating any compiler or dependency module. */\nexport function toolchainIdentity(\n  location = import.meta.url,\n  names = packages,\n): string | undefined {\n  try {\n    const hash = createHash('sha256').update('twill-loader-cache-v1\\0' + process.version);\n    const add = (path: string, bytes: Uint8Array) =>\n      hash.update(JSON.stringify([path, digest(bytes)]));\n    const directory = dirname(fileURLToPath(location));\n    for (const file of readdirSync(directory).sort())\n      if (file.endsWith('.js')) add(file, readFileSync(join(directory, file)));\n    const seen = new Set<string>();\n    const visit = (name: string, from: string) => {\n      const require = createRequire(from);\n      let root = dirname(require.resolve(name));\n      for (;;) {\n        const metadata = join(root, 'package.json');\n        if (existsSync(metadata) && JSON.parse(readFileSync(metadata, 'utf8')).name === name) break;\n        const parent = dirname(root);\n        if (parent === root) throw new Error('Package metadata unavailable');\n        root = parent;\n      }\n      root = realpathSync(root);\n      if (seen.has(root)) return;\n      seen.add(root);\n      const metadata = join(root, 'package.json');\n      const value = JSON.parse(readFileSync(metadata, 'utf8'));\n      add(name, readFileSync(metadata));\n      const walk = (folder: string) => {\n        for (const entry of readdirSync(folder, { withFileTypes: true }).sort((a, b) =>\n          a.name.localeCompare(b.name),\n        )) {\n          const path = join(folder, entry.name);\n          if (entry.isSymbolicLink() && statSync(path).isDirectory())\n            throw new Error('Directory symlink requires uncached compilation');\n          if (entry.isDirectory() && entry.name !== 'node_modules') walk(path);\n          else if (/\\.(?:[cm]?js|json)$/.test(entry.name))\n            add(path.slice(root.length), readFileSync(path));\n        }\n      };\n      // TypeScript emission/configuration executes this single compiler bundle;\n      // hashing its CLI/server copies would add unrelated cold-start work.\n      if (name === 'typescript')\n        add('typescript/lib/typescript.js', readFileSync(require.resolve(name)));\n      else walk(root);\n      for (const dependency of Object.keys(value.dependencies ?? {}).sort())\n        visit(dependency, metadata);\n    };\n    for (const name of names) visit(name, location);\n    return hash.digest('hex');\n  } catch {\n    return undefined;\n  }\n}\n\nfunction safeDirectory(directory: string): boolean {\n  const info = lstatSync(directory);\n  if (!info.isDirectory() || info.isSymbolicLink()) return false;\n  if (process.platform === 'win32') return true; // User-selected/profile ACL, not a POSIX mode claim.\n  const uid = process.getuid!();\n  if (info.uid !== uid || (info.mode & 0o077) !== 0) return false;\n  let path = realpathSync(directory);\n  for (;;) {\n    const parent = lstatSync(path);\n    if (parent.uid !== uid && parent.uid !== 0) return false;\n    if ((parent.mode & 0o022) !== 0 && (parent.mode & 0o1000) === 0) return false;\n    const next = dirname(path);\n    if (next === path) return true;\n    path = next;\n  }\n}\nfunction safeFile(info: Stats): boolean {\n  return (\n    info.isFile() &&\n    info.nlink === 1 &&\n    info.size <= limit &&\n    (process.platform === 'win32' || (info.uid === process.getuid!() && (info.mode & 0o077) === 0))\n  );\n}\n\n/** Fixed slots bound completed storage; collisions are misses, never shared module results. */\nexport class CompilationCache {\n  constructor(\n    private readonly directory: string,\n    private readonly identity: string,\n  ) {}\n\n  private key(url: string, source: string, dialect: boolean) {\n    return digest(JSON.stringify([this.identity, url, digest(source), dialect, 'ES2022']));\n  }\n  private slot(url: string) {\n    return join(this.directory, (parseInt(digest(url).slice(0, 2), 16) % 128) + '.json');\n  }\n  read(url: string, source: string, dialect: boolean): string | undefined {\n    let fd: number | undefined;\n    try {\n      if (!safeDirectory(this.directory)) return;\n      const file = this.slot(url);\n      if (lstatSync(file).isSymbolicLink()) return;\n      fd = openSync(file, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));\n      if (!safeFile(fstatSync(fd))) return;\n      const value = JSON.parse(readFileSync(fd, 'utf8'));\n      if (\n        value.key !== this.key(url, source, dialect) ||\n        typeof value.source !== 'string' ||\n        value.digest !== digest(value.source) ||\n        !Array.isArray(value.observations) ||\n        !value.observations.every(\n          (entry: ConfigurationObservation) =>\n            entry &&\n            typeof entry.path === 'string' &&\n            isAbsolute(entry.path) &&\n            ['file', 'directory'].includes(entry.kind) &&\n            typeof entry.value === 'string',\n        ) ||\n        !observationsMatch(value.observations)\n      )\n        return;\n      return value.source;\n    } catch {\n      return;\n    } finally {\n      if (fd !== undefined) {\n        try {\n          closeSync(fd);\n        } catch {\n          /* Cache cleanup is optional too. */\n        }\n      }\n    }\n  }\n  write(\n    url: string,\n    source: string,\n    dialect: boolean,\n    emitted: string,\n    observations: ConfigurationObservation[],\n  ): void {\n    let temporary: string | undefined;\n    try {\n      const value = JSON.stringify({\n        key: this.key(url, source, dialect),\n        source: emitted,\n        digest: digest(emitted),\n        observations,\n      });\n      if (\n        Buffer.byteLength(value) > limit ||\n        !safeDirectory(this.directory) ||\n        !observationsMatch(observations)\n      )\n        return;\n      temporary = join(this.directory, randomUUID() + '.tmp');\n      writeFileSync(temporary, value, { flag: 'wx', mode: 0o600 });\n      renameSync(temporary, this.slot(url));\n    } catch {\n      // An executable cache is optional; its failure never changes script behavior.\n    } finally {\n      if (temporary !== undefined) {\n        try {\n          unlinkSync(temporary);\n        } catch {\n          // Renamed, concurrently removed, or inaccessible; never replace the program's result.\n        }\n      }\n    }\n  }\n}\n\nexport function openCompilationCache(): CompilationCache | undefined {\n  try {\n    const directory = process.env.TWILL_CACHE_DIR ?? join(homedir(), '.twill', 'script-cache-v1');\n    if (!isAbsolute(directory)) return;\n    mkdirSync(directory, { recursive: true, mode: 0o700 });\n    if (!safeDirectory(directory)) return;\n    const identity = toolchainIdentity();\n    if (identity) return new CompilationCache(resolve(directory), identity);\n  } catch {\n    // Permissions, unsupported environment or unavailable identity: compile normally.\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"compilation-cache-7SugqJ4n.js","names":[],"sources":["../src/compilation-cache.ts"],"sourcesContent":["import {\n  closeSync,\n  constants,\n  existsSync,\n  fstatSync,\n  lstatSync,\n  mkdirSync,\n  openSync,\n  readFileSync,\n  readdirSync,\n  realpathSync,\n  statSync,\n  renameSync,\n  unlinkSync,\n  writeFileSync,\n  type Stats,\n} from 'node:fs';\nimport { createHash, randomUUID } from 'node:crypto';\nimport { createRequire } from 'node:module';\nimport { homedir } from 'node:os';\nimport { dirname, isAbsolute, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nexport type ConfigurationObservation = {\n  path: string;\n  kind: 'file' | 'directory';\n  value: string;\n};\nconst limit = 512 * 1024;\nconst packages = [\n  'typescript',\n  'acorn',\n  'acorn-typescript',\n  'acorn-jsx',\n  'magic-string',\n  '@ampproject/remapping',\n  '@jridgewell/trace-mapping',\n];\nexport const digest = (source: string | Uint8Array) =>\n  createHash('sha256').update(source).digest('hex');\n\nexport function observe(path: string, kind: ConfigurationObservation['kind']): string {\n  try {\n    if (kind === 'directory') return statSync(path).isDirectory() ? 'directory' : 'absent';\n    return digest(readFileSync(path));\n  } catch (error) {\n    return ['ENOENT', 'ENOTDIR'].includes((error as NodeJS.ErrnoException).code ?? '')\n      ? 'absent'\n      : 'unavailable';\n  }\n}\nexport function observationsMatch(observations: ConfigurationObservation[]): boolean {\n  return observations.every(({ path, kind, value }) => {\n    const current = observe(path, kind);\n    return current !== 'unavailable' && current === value;\n  });\n}\n\n/** Hash actual installed code without evaluating any compiler or dependency module. */\nexport function toolchainIdentity(\n  location = import.meta.url,\n  names = packages,\n): string | undefined {\n  try {\n    const hash = createHash('sha256').update('twill-loader-cache-v1\\0' + process.version);\n    const add = (path: string, bytes: Uint8Array) =>\n      hash.update(JSON.stringify([path, digest(bytes)]));\n    const directory = dirname(fileURLToPath(location));\n    for (const file of readdirSync(directory).sort())\n      if (file.endsWith('.js')) add(file, readFileSync(join(directory, file)));\n    const seen = new Set<string>();\n    const visit = (name: string, from: string) => {\n      const require = createRequire(from);\n      let root = dirname(require.resolve(name));\n      for (;;) {\n        const metadata = join(root, 'package.json');\n        if (existsSync(metadata) && JSON.parse(readFileSync(metadata, 'utf8')).name === name) break;\n        const parent = dirname(root);\n        if (parent === root) throw new Error('Package metadata unavailable');\n        root = parent;\n      }\n      root = realpathSync(root);\n      if (seen.has(root)) return;\n      seen.add(root);\n      const metadata = join(root, 'package.json');\n      const value = JSON.parse(readFileSync(metadata, 'utf8'));\n      add(name, readFileSync(metadata));\n      const walk = (folder: string) => {\n        for (const entry of readdirSync(folder, { withFileTypes: true }).sort((a, b) =>\n          a.name.localeCompare(b.name),\n        )) {\n          const path = join(folder, entry.name);\n          if (entry.isSymbolicLink() && statSync(path).isDirectory())\n            throw new Error('Directory symlink requires uncached compilation');\n          if (entry.isDirectory() && entry.name !== 'node_modules') walk(path);\n          else if (/\\.(?:[cm]?js|json)$/.test(entry.name))\n            add(path.slice(root.length), readFileSync(path));\n        }\n      };\n      // TypeScript emission/configuration executes this single compiler bundle;\n      // hashing its CLI/server copies would add unrelated cold-start work.\n      if (name === 'typescript')\n        add('typescript/lib/typescript.js', readFileSync(require.resolve(name)));\n      else walk(root);\n      for (const dependency of Object.keys(value.dependencies ?? {}).sort())\n        visit(dependency, metadata);\n    };\n    for (const name of names) visit(name, location);\n    return hash.digest('hex');\n  } catch {\n    return undefined;\n  }\n}\n\nfunction safeDirectory(directory: string): boolean {\n  const info = lstatSync(directory);\n  if (!info.isDirectory() || info.isSymbolicLink()) return false;\n  if (process.platform === 'win32') return true; // User-selected/profile ACL, not a POSIX mode claim.\n  const uid = process.getuid!();\n  if (info.uid !== uid || (info.mode & 0o077) !== 0) return false;\n  let path = realpathSync(directory);\n  for (;;) {\n    const parent = lstatSync(path);\n    if (parent.uid !== uid && parent.uid !== 0) return false;\n    if ((parent.mode & 0o022) !== 0 && (parent.mode & 0o1000) === 0) return false;\n    const next = dirname(path);\n    if (next === path) return true;\n    path = next;\n  }\n}\nfunction safeFile(info: Stats): boolean {\n  return (\n    info.isFile() &&\n    info.nlink === 1 &&\n    info.size <= limit &&\n    (process.platform === 'win32' || (info.uid === process.getuid!() && (info.mode & 0o077) === 0))\n  );\n}\n\n/** Fixed slots bound completed storage; collisions are misses, never shared module results. */\nexport class CompilationCache {\n  constructor(\n    private readonly directory: string,\n    private readonly identity: string,\n  ) {}\n\n  private key(url: string, source: string, dialect: boolean) {\n    return digest(JSON.stringify([this.identity, url, digest(source), dialect, 'ES2022']));\n  }\n  private slot(url: string) {\n    return join(this.directory, (parseInt(digest(url).slice(0, 2), 16) % 128) + '.json');\n  }\n  read(url: string, source: string, dialect: boolean): string | undefined {\n    let fd: number | undefined;\n    try {\n      if (!safeDirectory(this.directory)) return;\n      const file = this.slot(url);\n      if (lstatSync(file).isSymbolicLink()) return;\n      fd = openSync(file, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));\n      if (!safeFile(fstatSync(fd))) return;\n      const value = JSON.parse(readFileSync(fd, 'utf8'));\n      if (\n        value.key !== this.key(url, source, dialect) ||\n        typeof value.source !== 'string' ||\n        value.digest !== digest(value.source) ||\n        !Array.isArray(value.observations) ||\n        !value.observations.every(\n          (entry: ConfigurationObservation) =>\n            entry &&\n            typeof entry.path === 'string' &&\n            isAbsolute(entry.path) &&\n            ['file', 'directory'].includes(entry.kind) &&\n            typeof entry.value === 'string',\n        ) ||\n        !observationsMatch(value.observations)\n      )\n        return;\n      return value.source;\n    } catch {\n      return;\n    } finally {\n      if (fd !== undefined) {\n        try {\n          closeSync(fd);\n        } catch {\n          /* Cache cleanup is optional too. */\n        }\n      }\n    }\n  }\n  write(\n    url: string,\n    source: string,\n    dialect: boolean,\n    emitted: string,\n    observations: ConfigurationObservation[],\n  ): void {\n    let temporary: string | undefined;\n    try {\n      const value = JSON.stringify({\n        key: this.key(url, source, dialect),\n        source: emitted,\n        digest: digest(emitted),\n        observations,\n      });\n      if (\n        Buffer.byteLength(value) > limit ||\n        !safeDirectory(this.directory) ||\n        !observationsMatch(observations)\n      )\n        return;\n      temporary = join(this.directory, randomUUID() + '.tmp');\n      writeFileSync(temporary, value, { flag: 'wx', mode: 0o600 });\n      renameSync(temporary, this.slot(url));\n    } catch {\n      // An executable cache is optional; its failure never changes script behavior.\n    } finally {\n      if (temporary !== undefined) {\n        try {\n          unlinkSync(temporary);\n        } catch {\n          // Renamed, concurrently removed, or inaccessible; never replace the program's result.\n        }\n      }\n    }\n  }\n}\n\nexport function openCompilationCache(): CompilationCache | undefined {\n  try {\n    const directory = process.env.TWILL_CACHE_DIR ?? join(homedir(), '.twill', 'script-cache-v1');\n    if (!isAbsolute(directory)) return;\n    mkdirSync(directory, { recursive: true, mode: 0o700 });\n    if (!safeDirectory(directory)) return;\n    const identity = toolchainIdentity();\n    if (identity) return new CompilationCache(resolve(directory), identity);\n  } catch {\n    // Permissions, unsupported environment or unavailable identity: compile normally.\n  }\n}\n"],"mappings":"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"}

package/dist/{compiler-DY1N07np.js → compiler-BdkU4Ruh.js}

@@ -19,9 +19,12 @@ function guardAt(input, offset, implicitMember = false) {
 	const lexer = Parser.tokenizer(input.slice(offset), { ecmaVersion: "latest" });
 	const stack = [];
 	let first = true;
+	let missingElse = false;
+	let afterNonNull = false;
 	try {
 		for (;;) {
-			const label = lexer.getToken().type.label;
+			const token = lexer.getToken();
+			const label = token.type.label;
 			if (first && [
 				"=",
 				".",
@@ -35,6 +38,22 @@ function guardAt(input, offset, implicitMember = false) {
 				"in",
 				"instanceof"
 			].includes(label) && !(implicitMember && label === ".")) return false;
+			if (first || afterNonNull) {
+				missingElse = !/[\r\n\u2028\u2029]/.test(input.slice(offset, offset + token.start)) && (token.type === tokTypes.name && !["as", "satisfies"].includes(token.value) || [
+					"const",
+					"num",
+					"string",
+					"true",
+					"false",
+					"null",
+					"this",
+					"new",
+					"typeof",
+					"void",
+					"delete"
+				].includes(label) || token.type === tokTypes.prefix && token.value === "~" || implicitMember && first && label === ".");
+				afterNonNull = token.type === tokTypes.prefix && token.value === "!";
+			}
 			if (!stack.length && [
 				"if",
 				"for",
@@ -45,15 +64,12 @@ function guardAt(input, offset, implicitMember = false) {
 				"throw",
 				"var",
 				"export"
-			].includes(label)) return false;
-			if (!first && !stack.length && label === "const") return false;
+			].includes(label)) return missingElse ? "missingElse" : false;
+			if (!first && !stack.length && label === "const") return missingElse ? "missingElse" : false;
 			first = false;
 			if (!stack.length && label === "else") return true;
-			if (!stack.length && [
-				"eof",
-				";",
-				"}"
-			].includes(label)) return false;
+			if (label === "eof") return !stack.length && missingElse ? "missingElse" : false;
+			if (!stack.length && [";", "}"].includes(label)) return missingElse ? "missingElse" : false;
 			if ([
 				"(",
 				"[",
@@ -189,6 +205,15 @@ function parserFor(language) {
 	if (parsers.has(language)) return parsers.get(language);
 	const Base = bases[language];
 	class TwillParser extends Base {
+		declareName(name, bindingType, position) {
+			if (bindingType === 6 || bindingType === 7) {
+				const scope = this.currentScope();
+				(scope.types ??= []).push(name);
+				if (this.inModule && scope.flags & 1) delete this.undefinedExports[name];
+				return;
+			}
+			super.declareName(name, bindingType, position);
+		}
 		skipHeader = null;
 		closures = [];
 		lineStarts = null;
@@ -281,7 +306,9 @@ function parserFor(language) {
 				node.cleanup = cleanup;
 				return this.finishNode(node, "DeferStatement");
 			}
-			if (!this.isContextual("guard") || !guardAt(this.input, this.end, !!this.implicitClosure)) {
+			const guard = this.isContextual("guard") && guardAt(this.input, this.end, !!this.implicitClosure);
+			if (guard === "missingElse") this.raise(this.start, "Missing 'else' in guard statement. Put 'else' before the failure block: 'guard condition else { return ...; }'.");
+			if (!guard) {
 				const statement = super.parseStatement(context, ...args);
 				if (context && statement.type === "TwillEnumDeclaration") this.raise(statement.start, "An associated-value enum requires a block; add braces around this body.");
 				return statement;
@@ -290,6 +317,7 @@ function parserFor(language) {
 			node.singleStatement = !!context;
 			this.next();
 			node.binding = null;
+			if (this.type === tokTypes._else) this.raise(this.start, "Guard needs a condition or 'const' binding before 'else'.");
 			if (this.type === tokTypes._const) {
 				if (context) this.raise(node.start, "A guard binding requires a block; add braces around this body.");
 				const declaration = this.startNode();
@@ -299,8 +327,9 @@ function parserFor(language) {
 				if (node.binding.declarations.length !== 1) this.raise(node.start, "guard const requires one binding declaration.");
 			} else node.test = this.parseExpression();
 			node.elseStart = this.start;
-			this.expect(tokTypes._else);
-			if (this.type !== tokTypes.braceL) this.unexpected();
+			if (this.type !== tokTypes._else) this.raise(this.start, "Expected 'else' after the guard condition or binding.");
+			this.next();
+			if (this.type !== tokTypes.braceL) this.raise(this.start, "Guard 'else' must be followed by a block, for example 'else { return ...; }'.");
 			node.failure = this.parseBlock();
 			if (!exits(node.failure)) this.raise(node.failure.start, "Every guard else path must exit with return, throw, break or continue.");
 			return this.finishNode(node, "GuardStatement");
@@ -662,9 +691,10 @@ function parse(source, language = "ts", sourceType = "module") {
 		if (node.type === "DeferStatement") defers.push(node);
 		if (node.type === "TwillSwitchExpression") switches.push(node);
 		if (node.type === "TwillEnumDeclaration") enums.push(node);
-		for (const [key, value] of Object.entries(node)) {
+		for (const key of Object.keys(node)) {
 			if (key === "trailing" || key === "loc") continue;
-			if (Array.isArray(value)) value.forEach(visit);
+			const value = node[key];
+			if (Array.isArray(value)) for (const child of value) visit(child);
 			else if (value?.type) visit(value);
 		}
 	};
@@ -697,15 +727,15 @@ var functions = /* @__PURE__ */ new Set([
 	"ArrowFunctionExpression"
 ]);
 function children(node, visit) {
-	for (const [key, value] of Object.entries(node)) {
+	for (const key of Object.keys(node)) {
 		if (key === "loc" || key === "trailing") continue;
-		if (Array.isArray(value)) value.forEach((child) => {
-			if (child?.type) visit(child);
-		});
-		else if (value?.type) visit(value);
+		const value = node[key];
+		if (Array.isArray(value)) {
+			for (const child of value) if (child?.type) visit(child);
+		} else if (value?.type) visit(value);
 	}
 }
-/** Scope-local cleanup callbacks; dynamic registrations use lazy stacks. */
+/** Native finally where scope permits; callbacks retain dynamic registration semantics. */
 function lowerDefers(source, ast, code, language, usedNames, contentStarts, comments, runtime, sourceType, fail) {
 	const scopes = [];
 	const visit = (node, scope, parent) => {
@@ -760,6 +790,35 @@ function lowerDefers(source, ast, code, language, usedNames, contentStarts, comm
 		if (!scope.defers.length) continue;
 		const { block } = scope;
 		const statements = block.body;
+		const first = statements.indexOf(scope.defers[0]);
+		let native = first >= 0 && scope.defers.every((node) => !node.awaited && statements.includes(node));
+		if (native) {
+			native = !statements.some((node, index) => node.type === "FunctionDeclaration" || node.type === "TSDeclareFunction" || node.type === "VariableDeclaration" && node.kind.endsWith("using") || index > first && (node.type === "VariableDeclaration" && node.kind !== "var" || node.type.endsWith("Declaration") && node.type !== "VariableDeclaration" || node.type === "GuardStatement" && node.binding));
+			const check = (node) => {
+				if (node.type === "WithStatement" || node.type === "ThisExpression" || node.type === "VariableDeclarator" && !node.init || node.type === "VariableDeclaration" && node.kind === "var" && (!statements.includes(node) || node.start > scope.defers[0].start) || node.type === "CallExpression" && node.callee.type === "Identifier" && node.callee.name === "eval") native = false;
+				children(node, check);
+			};
+			if (native) check(block);
+			const cleanupScope = (node) => {
+				if (node.type === "FunctionDeclaration" || node.directive || node.type === "VariableDeclaration" && node.kind === "var") native = false;
+				if (!functions.has(node.type)) children(node, cleanupScope);
+			};
+			if (native) for (const node of scope.defers) cleanupScope(node.cleanup.body);
+		}
+		if (native) {
+			for (const node of [...scope.defers].reverse()) {
+				code.overwrite(node.start, node.cleanup.body.start, ";try {");
+				if (!node.cleanup.body.body.length) {
+					code.remove(node.cleanup.body.start, node.cleanup.body.end);
+					code.appendLeft(block.end - 1, "\n} finally " + source.slice(node.cleanup.body.start, node.cleanup.body.end) + "\n");
+					continue;
+				}
+				code.prependRight(node.cleanup.body.start, "\n} finally ");
+				code.appendLeft(node.cleanup.body.end, "\n");
+				if (node.cleanup.body.end !== block.end - 1) code.move(node.cleanup.body.start, node.cleanup.body.end, block.end - 1);
+			}
+			continue;
+		}
 		const single = scope.defers.length === 1 && statements.includes(scope.defers[0]);
 		const stack = fresh(single ? "Cleanup" : "Defers");
 		const failure = single ? "" : fresh("Failure");
@@ -1231,12 +1290,12 @@ var TwillSyntaxError = class extends SyntaxError {
 };
 function walk(node, visit) {
 	visit(node);
-	for (const [key, value] of Object.entries(node)) {
-		if (["loc", "trailing"].includes(key)) continue;
-		if (Array.isArray(value)) value.forEach((child) => {
-			if (child?.type) walk(child, visit);
-		});
-		else if (value?.type) walk(value, visit);
+	for (const key of Object.keys(node)) {
+		if (key === "loc" || key === "trailing") continue;
+		const value = node[key];
+		if (Array.isArray(value)) {
+			for (const child of value) if (child?.type) walk(child, visit);
+		} else if (value?.type) walk(value, visit);
 	}
 }
 function calleeName(node) {
@@ -1604,4 +1663,4 @@ function generatedPosition(result, line, column) {
 //#endregion
 export { transform as a, originalPosition as i, generatedPosition as n, parse as o, inferLanguage as r, TwillSyntaxError as t };
 
-//# sourceMappingURL=compiler-DY1N07np.js.map
+//# sourceMappingURL=compiler-BdkU4Ruh.js.map