functionalscript 0.9.3 → 0.10.1

package/bnf/module.f.d.ts

@@ -9,6 +9,8 @@ import { type Array2 } from '../types/array/module.f.ts';
 export type TerminalRange = number;
 export declare const fullRange: TerminalRange;
 export declare const unicodeRange: TerminalRange;
+export declare const max: string;
+export declare const unicodeMax: string;
 /** A sequence of rules. */
 export type Sequence = readonly Rule[];
 /** A variant */
@@ -18,7 +20,6 @@ export type Variant = {
 export type DataRule = Variant | Sequence | TerminalRange | string;
 export type LazyRule = () => DataRule;
 export type Rule = DataRule | LazyRule;
-export declare const max: string;
 export declare const rangeEncode: (a: number, b: number) => TerminalRange;
 export declare const oneEncode: (a: number) => TerminalRange;
 export declare const eof: TerminalRange;

package/bnf/module.f.js

@@ -3,6 +3,8 @@ import { isArray2 } from "../types/array/module.f.js";
 import { map, toArray, repeat as listRepeat } from "../types/list/module.f.js";
 export const fullRange = 0x000000_FFFFFF;
 export const unicodeRange = 0x000000_10FFFF;
+export const max = codePointListToString([0xFFFFFF]);
+export const unicodeMax = codePointListToString([0x10FFFF]);
 // Internals:
 const { fromEntries, values } = Object;
 const { fromCodePoint } = String;
@@ -12,7 +14,6 @@ const { fromCodePoint } = String;
 const offset = 24;
 const mask = (1 << offset) - 1;
 const isValid = (r) => r >= 0 && r <= mask;
-export const max = codePointListToString([0x10FFFF]);
 export const rangeEncode = (a, b) => {
     if (!isValid(a) || !isValid(b) || a > b) {
         throw `Invalid range ${a} ${b}.`;

package/cas/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Content-addressable storage utilities for hashing, addressing, and path parsing.
+ *
+ * @module
+ */
 import { type Sha2 } from "../crypto/sha2/module.f.ts";
 import type { Vec } from "../types/bit_vec/module.f.ts";
 import { type Effect, type Operations } from "../types/effect/module.f.ts";

package/cas/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Content-addressable storage utilities for hashing, addressing, and path parsing.
+ *
+ * @module
+ */
 import { computeSync, sha256 } from "../crypto/sha2/module.f.js";
 import { parse } from "../path/module.f.js";
 import { cBase32ToVec, vecToCBase32 } from "../types/cbase32/module.f.js";

package/ci/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Continuous integration helper commands for repository automation tasks.
+ *
+ * @module
+ */
 import { utf8 } from "../text/module.f.js";
 import { writeFile } from "../types/effect/node/module.f.js";
 const os = ['ubuntu', 'macos', 'windows'];
@@ -5,15 +10,15 @@ const architecture = ['intel', 'arm'];
 // https://docs.github.com/en/actions/reference/runners/github-hosted-runners#standard-github-hosted-runners-for-public-repositories
 const images = {
     ubuntu: {
-        intel: 'ubuntu-latest',
+        intel: 'ubuntu-24.04',
         arm: 'ubuntu-24.04-arm'
     },
     macos: {
-        intel: 'macos-15-intel',
-        arm: 'macos-latest'
+        intel: 'macos-26-intel',
+        arm: 'macos-26'
     },
     windows: {
-        intel: 'windows-latest',
+        intel: 'windows-2025',
         arm: 'windows-11-arm',
     }
 };
@@ -27,11 +32,7 @@ const installBun = installOnWindowsArm({
     name: 'bun',
     path: 'bun.sh'
 });
-const installDeno = installOnWindowsArm({
-    def: { uses: 'denoland/setup-deno@v2', with: { 'deno-version': '2' } },
-    name: 'deno',
-    path: 'deno.land'
-});
+const installDeno = install({ uses: 'denoland/setup-deno@v2', with: { 'deno-version': '2' } });
 const cargoTest = (target, config) => {
     const to = target ? ` --target ${target}` : '';
     const co = config ? ` --config ${config}` : '';
@@ -65,6 +66,9 @@ const node = (version) => (extra) => basicNode(version)([
     ...extra,
 ]);
 const findTgz = (v) => v === 'windows' ? '(Get-ChildItem *.tgz).FullName' : './*.tgz';
+const playwrightVersion = '1.58.2';
+const playwrightAndVersion = `playwright@${playwrightVersion}`;
+const rustToolchain = '1.93.1';
 const toSteps = (m) => {
     const filter = (st) => m.flatMap((mt) => mt.type === st ? [mt.step] : []);
     const aptGet = m.flatMap(v => v.type === 'apt-get' ? [v.package] : []).join(' ');
@@ -73,7 +77,7 @@ const toSteps = (m) => {
     return [
         ...(aptGet !== '' ? [{ run: `sudo apt-get update && sudo apt-get install -y ${aptGet}` }] : []),
         ...(rust ? [{
-                uses: 'dtolnay/rust-toolchain@1.93.1',
+                uses: `dtolnay/rust-toolchain@${rustToolchain}`,
                 with: {
                     components: 'rustfmt,clippy',
                     targets
@@ -92,11 +96,34 @@ const nodeSteps = (v) => [
     test({ run: `npm ${nodeTest(v)}` }),
 ];
 const ubuntu = (ms) => ({
-    'runs-on': 'ubuntu-latest',
+    'runs-on': 'ubuntu-24.04',
     steps: toSteps(ms)
 });
 const nodeVersions = Object.fromEntries(nodes.map(v => [`node${v}`, ubuntu(nodeSteps(v))]));
-const steps = (v) => (a) => {
+const defaultNodeVersion = '24';
+const playwright = ubuntu(basicNode(defaultNodeVersion)([
+    //install({ uses: 'actions/cache@v4', with: { path: '~/.cache/ms-playwright', key: `${images.ubuntu.intel}-${playwrightAndVersion}` } }),
+    install({ run: `npm install -g ${playwrightAndVersion}` }),
+    install({ run: 'playwright install --with-deps' }),
+    // we have to use `npx` to make sure that we respect `@playwright/test` version from
+    // the `package.json`.
+    ...['chromium', 'firefox', 'webkit'].map(browser => test({ run: `npx playwright test --browser=${browser}` })),
+]));
+const i686 = (a, v) => {
+    if (a === 'intel') {
+        switch (v) {
+            case 'windows': return customTarget('i686-pc-windows-msvc');
+            case 'ubuntu': return [
+                { type: 'apt-get', package: 'libc6-dev-i386' },
+                ...customTarget('i686-unknown-linux-gnu'),
+            ];
+        }
+    }
+    return [];
+};
+const job = (v) => (a) => {
+    const id = `${v}-${a}`;
+    const image = images[v][a];
     const result = [
         // Rust
         test({ run: 'cargo fmt -- --check' }),
@@ -108,23 +135,12 @@ const steps = (v) => (a) => {
         ...wasmTarget('wasm32-wasip2'),
         ...wasmTarget('wasm32-unknown-unknown'),
         ...wasmTarget('wasm32-wasip1-threads'),
-        ...(a !== 'intel' ? [] :
-            v === 'windows' ?
-                customTarget('i686-pc-windows-msvc') :
-                v === 'ubuntu' ? [
-                    { type: 'apt-get', package: 'libc6-dev-i386' },
-                    ...customTarget('i686-unknown-linux-gnu'),
-                ] :
-                    []),
+        ...i686(a, v),
         // Node.js
-        ...node('24')([
+        ...node(defaultNodeVersion)([
             // TypeScript Preview
             install({ run: 'npm install -g @typescript/native-preview' }),
             test({ run: 'tsgo' }),
-            // Playwright
-            install({ run: 'npm install -g playwright' }),
-            install({ run: 'playwright install --with-deps' }),
-            ...['chromium', 'firefox', 'webkit'].map(browser => (test({ run: `npx playwright test --browser=${browser}` }))),
             // publishing
             test({ run: 'npm pack' }),
             test({ run: `npm install -g ${findTgz(v)}` }),
@@ -134,7 +150,7 @@ const steps = (v) => (a) => {
         ]),
         // Deno
         ...clean([
-            installDeno(v)(a),
+            installDeno,
             test({ run: 'deno install' }),
             test({ run: 'deno task test' }),
             test({ run: 'deno task fjs compile issues/demo/data/tree.json _tree.f.js' }),
@@ -148,16 +164,12 @@ const steps = (v) => (a) => {
             test({ run: 'bun ./fjs/module.ts t' }),
         ]),
     ];
-    return toSteps(result);
+    return [id, { 'runs-on': image, steps: toSteps(result) }];
 };
 const jobs = {
-    ...Object.fromEntries([
-        ...os.flatMap(v => architecture.map(a => [`${v}-${a}`, {
-                'runs-on': images[v][a],
-                steps: steps(v)(a),
-            }]))
-    ]),
+    ...Object.fromEntries(os.flatMap(v => architecture.map(job(v)))),
     ...nodeVersions,
+    playwright,
 };
 const gha = {
     name: 'CI',

package/ci/module.js

@@ -1,3 +1,3 @@
-import { nodeRun } from "../io/module.js";
-import run from "./module.f.js";
-await nodeRun(run);
+import run from "../io/module.js";
+import app from "./module.f.js";
+run(app);

package/crypto/sign/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Signing helpers built on secp256k1 and SHA-256 primitives.
+ *
+ * @module
+ */
 import type { Array2 } from '../../types/array/module.f.ts';
 import { type Vec } from '../../types/bit_vec/module.f.ts';
 import type { Curve } from '../secp/module.f.ts';

package/dev/index/module.js

@@ -1,3 +1,3 @@
 import { index } from "../module.f.js";
-import node from "../../io/module.js";
-await node(index);
+import { legacyRun } from "../../io/module.js";
+legacyRun(index);

package/dev/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Development utilities for indexing modules and loading FunctionalScript files.
+ *
+ * @module
+ */
 import { type Io } from '../io/module.f.ts';
 export declare const todo: () => never;
 export type Module = {

package/dev/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Development utilities for indexing modules and loading FunctionalScript files.
+ *
+ * @module
+ */
 import { fromIo } from "../io/module.f.js";
 import { updateVersion } from "./version/module.f.js";
 import { decodeUtf8, encodeUtf8 } from "../types/uint8array/module.f.js";

package/dev/tf/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Test-framework helpers for running and reporting FunctionalScript tests.
+ *
+ * @module
+ */
 import { fold } from "../../types/list/module.f.js";
 import { reset, fgGreen, fgRed, bold, stdio, stderr } from "../../text/sgr/module.f.js";
 import { env, loadModuleMap } from "../module.f.js";

package/dev/version/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Version management helpers for updating project package versions.
+ *
+ * @module
+ */
 import { utf8, utf8ToString } from "../../text/module.f.js";
 import { all } from "../../types/effect/module.f.js";
 import { readFile, writeFile } from "../../types/effect/node/module.f.js";

package/djs/ast/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * AST types and helpers for the DJS representation.
+ *
+ * @module
+ */
 import type { Primitive, Array, Unknown } from '../module.f.ts';
 export type AstModule = [readonly string[], AstBody];
 export type AstConst = Primitive | AstModuleRef | AstArray | AstObject;

package/djs/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * High-level DJS API for parsing, transpiling, and serializing modules.
+ *
+ * @module
+ */
 import type { Io } from '../io/module.f.ts';
 import type { Primitive as JsonPrimitive } from '../json/module.f.ts';
 export type Object = {

package/djs/parser/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * DJS parser that builds structured trees from DJS tokens.
+ *
+ * @module
+ */
 import { type Result } from '../../types/result/module.f.ts';
 import { type List } from '../../types/list/module.f.ts';
 import type { DjsTokenWithMetadata } from '../tokenizer/module.f.ts';

package/djs/parser/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * DJS parser that builds structured trees from DJS tokens.
+ *
+ * @module
+ */
 import { error, ok } from "../../types/result/module.f.js";
 import { fold, first, drop, toArray, length, concat } from "../../types/list/module.f.js";
 import { setReplace, at } from "../../types/ordered_map/module.f.js";

package/djs/parser-new/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Experimental DJS parser implementation.
+ *
+ * @module
+ */
 import { descentParser } from "../../bnf/data/module.f.js";
 import { eof, join0Plus, max, none, not, notSet, oneEncode, option, range, remove, repeat, repeat0Plus, repeat1Plus, set, unicodeRange } from "../../bnf/module.f.js";
 import { todo } from "../../dev/module.f.js";

package/djs/serializer/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * DJS serializer for formatting AST values back to source text.
+ *
+ * @module
+ */
 import type { Unknown } from '../module.f.ts';
 import type { Entry as ObjectEntry } from '../../types/object/module.f.ts';
 import { type List } from '../../types/list/module.f.ts';

package/djs/transpiler/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * DJS transpiler for transforming parsed trees into JavaScript output.
+ *
+ * @module
+ */
 import { type Unknown } from '../module.f.ts';
 import { type Result } from '../../types/result/module.f.ts';
 import { type List } from '../../types/list/module.f.ts';

package/djs/transpiler/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * DJS transpiler for transforming parsed trees into JavaScript output.
+ *
+ * @module
+ */
 import {} from "../module.f.js";
 import { error, ok } from "../../types/result/module.f.js";
 import { fold, drop, map as listMap, toArray, includes } from "../../types/list/module.f.js";

package/fjs/module.f.d.ts

@@ -1,2 +1,7 @@
+/**
+ * FunctionalScript compiler entry points and command handlers.
+ *
+ * @module
+ */
 import { type Io } from '../io/module.f.ts';
 export declare const main: (io: Io) => Promise<number>;

package/fjs/module.f.js

@@ -1,10 +1,16 @@
+/**
+ * FunctionalScript compiler entry points and command handlers.
+ *
+ * @module
+ */
 import { fromIo } from "../io/module.f.js";
 import { compile } from "../djs/module.f.js";
 import { main as testMain } from "../dev/tf/module.f.js";
 import { main as casMain } from "../cas/module.f.js";
-export const main = (io) => {
+export const main = async (io) => {
     const { error } = io.console;
     const [command, ...rest] = io.process.argv.slice(2);
+    const eRun = fromIo(io);
     switch (command) {
         case 'test':
         case 't':
@@ -14,7 +20,12 @@ export const main = (io) => {
             return compile(io)(rest);
         case 'cas':
         case 's':
-            return fromIo(io)(casMain(rest));
+            return eRun(casMain(rest));
+        case 'run':
+        case 'r':
+            const [file, ...args] = rest;
+            const m = await io.asyncImport(file);
+            return eRun(m.default(args));
         case undefined:
             error('Error: command is required');
             return Promise.resolve(1);

package/fjs/module.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
 import { main } from "./module.f.js";
-import node from "../io/module.js";
-await node(main);
+import { legacyRun } from "../io/module.js";
+legacyRun(main);

package/fsc/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * FunctionalScript command utilities for compile workflows.
+ *
+ * @module
+ */
 import { strictEqual } from "../types/function/operator/module.f.js";
 import { merge as rangeMapMerge, fromRange, get, } from "../types/range_map/module.f.js";
 import { reduce as listReduce, toArray, map } from "../types/list/module.f.js";

package/fsm/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Finite state machine helpers used by parser and tokenizer logic.
+ *
+ * @module
+ */
 import { type List } from '../types/list/module.f.ts';
 import { type ByteSet } from '../types/byte_set/module.f.ts';
 import { type RangeMapArray } from '../types/range_map/module.f.ts';

package/fsm/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Finite state machine helpers used by parser and tokenizer logic.
+ *
+ * @module
+ */
 import { equal, isEmpty, fold, toArray, scan, foldScan, empty as emptyList } from "../types/list/module.f.js";
 import { toRangeMap, union as byteSetUnion, one, empty, range } from "../types/byte_set/module.f.js";
 import { intersect, union as sortedSetUnion } from "../types/sorted_set/module.f.js";

package/io/module.d.ts

@@ -1,8 +1,8 @@
 import { type Io, type Run } from './module.f.ts';
 import type { NodeProgram } from '../types/effect/node/module.f.ts';
 export declare const io: Io;
-declare const runDefault: Run;
-export default runDefault;
+export declare const legacyRun: Run;
 export type NodeRun = (p: NodeProgram) => Promise<number>;
 export declare const ioRun: (io: Io) => NodeRun;
-export declare const nodeRun: NodeRun;
+declare const effectRun: NodeRun;
+export default effectRun;

package/io/module.js

@@ -10,6 +10,7 @@ import { fromIo, run } from "./module.f.js";
 import fs from 'node:fs';
 import process from "node:process";
 import { concat } from "../path/module.f.js";
+import { error, ok } from "../types/result/module.f.js";
 const prefix = 'file:///';
 export const io = {
     console,
@@ -24,26 +25,26 @@ export const io = {
     fetch,
     tryCatch: f => {
         try {
-            return ['ok', f()];
+            return ok(f());
         }
         catch (e) {
-            return ['error', e];
+            return error(e);
         }
     },
     asyncTryCatch: async (f) => {
         try {
-            return ['ok', await f()];
+            return ok(await f());
         }
         catch (e) {
-            return ['error', e];
+            return error(e);
         }
     },
 };
-const runDefault = run(io);
-export default runDefault;
+export const legacyRun = run(io);
 export const ioRun = (io) => {
     const r = fromIo(io);
     const { argv } = io.process;
     return p => r(p(argv));
 };
-export const nodeRun = ioRun(io);
+const effectRun = ioRun(io);
+export default effectRun;

package/io/virtual/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Virtual I/O adapter implementations for deterministic testing.
+ *
+ * @module
+ */
 import type { Io } from '../module.f.ts';
 import { type OrderedMap } from '../../types/ordered_map/module.f.ts';
 export declare const createVirtualIo: (files: OrderedMap<Uint8Array>) => Io;

package/json/parser/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * JSON parser that consumes tokenizer output into JSON values.
+ *
+ * @module
+ */
 import { type Result } from '../../types/result/module.f.ts';
 import { type List } from '../../types/list/module.f.ts';
 import { type JsonToken } from '../tokenizer/module.f.ts';

package/json/parser/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * JSON parser that consumes tokenizer output into JSON values.
+ *
+ * @module
+ */
 import { error, ok } from "../../types/result/module.f.js";
 import { fold, first, drop, toArray, concat } from "../../types/list/module.f.js";
 import {} from "../../types/function/operator/module.f.js";

package/json/serializer/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * JSON serializer for deterministic string output.
+ *
+ * @module
+ */
 import { type List } from '../../types/list/module.f.ts';
 export declare const stringSerialize: (_: string) => List<string>;
 export declare const numberSerialize: (_: number) => List<string>;

package/json/serializer/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * JSON serializer for deterministic string output.
+ *
+ * @module
+ */
 import { flat, reduce, empty } from "../../types/list/module.f.js";
 import {} from "../../types/object/module.f.js";
 import {} from "../../types/function/operator/module.f.js";

package/json/tokenizer/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Tokenizer for JSON lexical analysis.
+ *
+ * @module
+ */
 import {} from "../../types/function/operator/module.f.js";
 import { concat, empty, flat, stateScan } from "../../types/list/module.f.js";
 import { multiply } from "../../types/bigfloat/module.f.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "functionalscript",
-  "version": "0.9.3",
+  "version": "0.10.1",
   "type": "module",
   "files": [
     "**/*.js",

package/path/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Path parsing and normalization helpers for portable module paths.
+ *
+ * @module
+ */
 import type { Reduce, Unary } from "../types/function/operator/module.f.ts";
 export declare const parse: (path: string) => readonly string[];
 export declare const normalize: Unary<string, string>;

package/types/base128/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Base-128 encoding and decoding utilities over bit vectors.
+ *
+ * @module
+ */
 import { type Vec } from '../bit_vec/module.f.ts';
 /**
  * Encodes a bigint into an MSB Base128 vector.

package/types/base128/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Base-128 encoding and decoding utilities over bit vectors.
+ *
+ * @module
+ */
 import { vec8, msb, empty } from "../bit_vec/module.f.js";
 const { concat, popFront } = msb;
 const pop8 = popFront(8n);

package/types/bigfloat/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Big-float helpers built from bigint mantissa and exponent parts.
+ *
+ * @module
+ */
 import { abs, sign } from "../bigint/module.f.js";
 const twoPow53 = 9007199254740992n;
 const twoPow54 = 18014398509481984n;

package/types/btree/find/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Lookup operations for persistent B-tree structures.
+ *
+ * @module
+ */
 import type { Leaf1, Leaf2, Branch3, Branch5, TNode } from '../types/module.f.ts';
 import type { List } from '../../list/module.f.ts';
 import { type Compare } from '../../function/compare/module.f.ts';

package/types/btree/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Core persistent B-tree construction and traversal helpers.
+ *
+ * @module
+ */
 import { type List } from '../list/module.f.ts';
 import type { Tree } from './types/module.f.ts';
 export declare const empty: null;

package/types/btree/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Core persistent B-tree construction and traversal helpers.
+ *
+ * @module
+ */
 import { flat } from "../list/module.f.js";
 import { map } from "../nullable/module.f.js";
 const nodeValues = node => () => {

package/types/btree/remove/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Removal operations for persistent B-tree structures.
+ *
+ * @module
+ */
 import type { TNode, Tree } from '../types/module.f.ts';
 import type { Compare } from '../../function/compare/module.f.ts';
 export declare const nodeRemove: <T>(c: Compare<T>) => (node: TNode<T>) => Tree<T>;

package/types/btree/set/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Insertion and update operations for persistent B-tree structures.
+ *
+ * @module
+ */
 import type { TNode, Tree } from '../types/module.f.ts';
 import type { Compare } from '../../function/compare/module.f.ts';
 export declare const set: <T>(c: Compare<T>) => (f: (value: T | null) => T) => (tree: Tree<T>) => TNode<T>;

package/types/btree/types/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Shared type definitions for persistent B-tree modules.
+ *
+ * @module
+ */
 import type { Array1, Array2 } from '../../array/module.f.ts';
 export type Leaf1<T> = Array1<T>;
 export type Leaf2<T> = Array2<T>;

package/types/byte_set/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Compact byte-set operations and predicates.
+ *
+ * @module
+ */
 import { compose } from "../function/module.f.js";
 import { reverse, countdown, flat, map } from "../list/module.f.js";
 export const has = n => s => ((s >> BigInt(n)) & 1n) === 1n;

package/types/cbase32/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Content-addressable Base32 encoding and decoding helpers.
+ *
+ * @module
+ */
 import { type Vec } from "../bit_vec/module.f.ts";
 import type { Nullable } from "../nullable/module.f.ts";
 export declare const vec5xToCBase32: (v: Vec) => string;

package/types/cbase32/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Content-addressable Base32 encoding and decoding helpers.
+ *
+ * @module
+ */
 import { msb, lsb, length, vec, empty } from "../bit_vec/module.f.js";
 //                         0123456789abcdef
 const m = '0123456789abcdefghjkmnpqrstvwxyz';

package/types/effect/mock/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Mock effect runtimes for testing effectful programs.
+ *
+ * @module
+ */
 import type { Effect, Operations } from "../module.f.ts";
 export type MemOperationMap<O extends Operations, S> = {
     readonly [K in keyof O]: (state: S, payload: O[K][0]) => readonly [S, O[K][1]];

package/types/effect/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Core effect type constructors and combinators.
+ *
+ * @module
+ */
 export type Operations = {
     readonly [command in string]: readonly [input: unknown, output: unknown];
 };

package/types/effect/node/virtual/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Virtual Node-effect operations for filesystem and process tests.
+ *
+ * @module
+ */
 import { parse } from "../../../../path/module.f.js";
 import { isVec } from "../../../bit_vec/module.f.js";
 import { error, ok } from "../../../result/module.f.js";

package/types/function/compare/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Comparison function types and helpers.
+ *
+ * @module
+ */
 import type { Index3, Index5, Array2 } from '../../array/module.f.ts';
 export type Sign = -1 | 0 | 1;
 export type Compare<T> = (_: T) => Sign;

package/types/function/operator/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Common higher-order operator type aliases.
+ *
+ * @module
+ */
 export type Binary<A, B, R> = (a: A) => (b: B) => R;
 export type Fold<I, O> = Binary<I, O, O>;
 export declare const join: (separator: string) => Reduce<string>;

package/types/list/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Immutable list data structure utilities and combinators.
+ *
+ * @module
+ */
 import { identity, fn, compose } from "../function/module.f.js";
 import { addition, logicalNot, strictEqual, stateScanToScan, foldToScan, reduceToScan, } from "../function/operator/module.f.js";
 export const fromArrayLike = (array) => {

package/types/map/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Persistent map operations built on ordered collections.
+ *
+ * @module
+ */
 const concat = (x, y) => ({
     *[Symbol.iterator]() {
         yield* x;

package/types/nibble_set/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Nibble-set operations for compact 4-bit membership tracking.
+ *
+ * @module
+ */
 export type NibbleSet = number;
 export type Nibble = number;
 export declare const empty = 0;

package/types/nominal/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Nominal typing helpers for branded TypeScript types.
+ *
+ * @module
+ */
 export type Nominal<N extends string, R extends string, B> = symbol & {
     [k in N]: readonly [R, B];
 };

package/types/nullable/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Utilities for nullable (`null`/`undefined`) value handling.
+ *
+ * @module
+ */
 import type { Option } from '../option/module.f.ts';
 export type Nullable<T> = T | null;
 export declare const map: <T, R>(f: (value: T) => R) => (value: Nullable<T>) => Nullable<R>;

package/types/ordered_map/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Ordered map operations with deterministic key traversal.
+ *
+ * @module
+ */
 import type { Tree } from '../btree/types/module.f.ts';
 import { type List } from '../list/module.f.ts';
 import type { Reduce } from '../function/operator/module.f.ts';

package/types/range/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Range and interval utilities for numeric boundaries.
+ *
+ * @module
+ */
 export type Range = readonly [number, number];
 export declare const contains: (range: Range) => (i: number) => boolean;
 export declare const one: (i: number) => Range;

package/types/sorted_list/module.f.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Sorted immutable list helpers and merge operations.
+ *
+ * @module
+ */
 import type { Sign } from '../function/compare/module.f.ts';
 import { type List } from '../list/module.f.ts';
 import type { Nullable } from '../nullable/module.f.ts';

package/website/module.f.js

@@ -1,3 +1,8 @@
+/**
+ * Static website generation program for project landing content.
+ *
+ * @module
+ */
 import { htmlToString } from "../html/module.f.js";
 import { writeFile } from "../types/effect/node/module.f.js";
 import { utf8 } from "../text/module.f.js";

package/website/module.js

@@ -1,3 +1,3 @@
-import { nodeRun } from "../io/module.js";
-import run from "./module.f.js";
-await nodeRun(run);
+import run from "../io/module.js";
+import app from "./module.f.js";
+run(app);