toiljs 0.0.1

package/src/shared/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared primitives used across every toiljs target (client, compiler, cli, server tooling).
+ * Placeholder — real shared types/utilities land here.
+ */
+
+export const FRAMEWORK_NAME = 'toiljs';
+
+export interface ToilTarget {
+    readonly name: 'client' | 'compiler' | 'cli' | 'server';
+}

package/std/client/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Ambient "native" types for the toiljs client framework.
+ *
+ * These are injected into the client target so users don't import them (a `declare global`
+ * block discovered via tsconfig). Placeholder declarations; real framework globals land here.
+ */
+
+declare global {
+    /** Global toil client handle, available without imports inside client code. */
+    const toil: {
+        readonly version: string;
+    };
+}
+
+export {};

package/std/client/package.json

@@ -0,0 +1,3 @@
+{
+    "types": "index.d.ts"
+}

package/test/channel.test.ts

@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+
+import { resolveChannelUrl } from '../src/client/channel';
+
+describe('resolveChannelUrl', () => {
+    it('uses ws:// over http and the default /_toil path', () => {
+        expect(resolveChannelUrl(undefined, { protocol: 'http:', host: 'localhost:3000' })).toBe(
+            'ws://localhost:3000/_toil',
+        );
+    });
+
+    it('uses wss:// over https', () => {
+        expect(resolveChannelUrl('/_toil', { protocol: 'https:', host: 'app.example.com' })).toBe(
+            'wss://app.example.com/_toil',
+        );
+    });
+
+    it('normalizes a path without a leading slash', () => {
+        expect(resolveChannelUrl('live', { protocol: 'http:', host: 'h:1' })).toBe('ws://h:1/live');
+    });
+});

package/test/io.test.ts

@@ -0,0 +1,85 @@
+import { describe, expect, it } from 'vitest';
+
+import { BinaryReader } from '../src/io/BinaryReader';
+import { BinaryWriter } from '../src/io/BinaryWriter';
+import { FastMap } from '../src/io/FastMap';
+import { FastSet } from '../src/io/FastSet';
+
+describe('BinaryWriter / BinaryReader', () => {
+    it('round-trips fixed-width integers', () => {
+        const w = new BinaryWriter();
+        w.writeU8(255);
+        w.writeU16(65535);
+        w.writeU32(4294967295);
+        w.writeU64(18446744073709551615n);
+        w.writeI8(-128);
+        w.writeI32(-2147483648);
+
+        const r = new BinaryReader(w.getBuffer());
+        expect(r.readU8()).toBe(255);
+        expect(r.readU16()).toBe(65535);
+        expect(r.readU32()).toBe(4294967295);
+        expect(r.readU64()).toBe(18446744073709551615n);
+        expect(r.readI8()).toBe(-128);
+        expect(r.readI32()).toBe(-2147483648);
+    });
+
+    it('round-trips u256 and strings', () => {
+        const big = 123456789012345678901234567890n;
+        const w = new BinaryWriter();
+        w.writeU256(big);
+        w.writeStringWithLength('hello toil 🛠');
+        w.writeBoolean(true);
+
+        const r = new BinaryReader(w.getBuffer());
+        expect(r.readU256()).toBe(big);
+        expect(r.readStringWithLength()).toBe('hello toil 🛠');
+        expect(r.readBoolean()).toBe(true);
+    });
+
+    it('round-trips arrays', () => {
+        const w = new BinaryWriter();
+        w.writeU32Array([1, 2, 3]);
+        w.writeStringArray(['a', 'bb', 'ccc']);
+
+        const r = new BinaryReader(w.getBuffer());
+        expect(r.readU32Array()).toEqual([1, 2, 3]);
+        expect(r.readStringArray()).toEqual(['a', 'bb', 'ccc']);
+    });
+
+    it('rejects out-of-range values', () => {
+        const w = new BinaryWriter();
+        expect(() => w.writeU8(256)).toThrow();
+        expect(() => w.writeI8(128)).toThrow();
+    });
+
+    it('throws when reading past the end', () => {
+        const r = new BinaryReader(new Uint8Array(2));
+        expect(() => r.readU32()).toThrow();
+    });
+});
+
+describe('FastMap', () => {
+    it('supports bigint keys and basic ops', () => {
+        const m = new FastMap<bigint, string>();
+        m.set(1n, 'one').set(2n, 'two');
+        expect(m.size).toBe(2);
+        expect(m.get(1n)).toBe('one');
+        expect(m.has(2n)).toBe(true);
+        expect(m.delete(1n)).toBe(true);
+        expect(m.has(1n)).toBe(false);
+        expect([...m.entries()]).toEqual([[2n, 'two']]);
+    });
+});
+
+describe('FastSet', () => {
+    it('dedupes and preserves insertion order', () => {
+        const s = new FastSet<bigint>();
+        s.add(2n).add(1n).add(2n);
+        expect(s.size).toBe(2);
+        expect(s.has(1n)).toBe(true);
+        expect([...s.values()]).toEqual([2n, 1n]);
+        expect(s.delete(2n)).toBe(true);
+        expect([...s.values()]).toEqual([1n]);
+    });
+});

package/test/placeholder.test.ts

@@ -0,0 +1,9 @@
+import { describe, expect, it } from 'vitest';
+
+import { FRAMEWORK_NAME } from '../src/shared/index';
+
+describe('toiljs scaffold', () => {
+    it('exposes the framework name', () => {
+        expect(FRAMEWORK_NAME).toBe('toiljs');
+    });
+});

package/test/routes.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest';
+
+import { matchRoute } from '../src/client/match';
+import { filePathToRoute } from '../src/compiler/routes';
+
+describe('filePathToRoute', () => {
+    it('maps index, static, nested, and dynamic files to patterns', () => {
+        expect(filePathToRoute('index.tsx')).toBe('/');
+        expect(filePathToRoute('about.tsx')).toBe('/about');
+        expect(filePathToRoute('blog/index.tsx')).toBe('/blog');
+        expect(filePathToRoute('blog/[id].tsx')).toBe('/blog/:id');
+        expect(filePathToRoute('docs/guide/intro.jsx')).toBe('/docs/guide/intro');
+        expect(filePathToRoute('docs/[...slug].tsx')).toBe('/docs/*slug');
+    });
+});
+
+describe('matchRoute', () => {
+    it('matches static routes', () => {
+        expect(matchRoute('/', '/')).toEqual({});
+        expect(matchRoute('/about', '/about')).toEqual({});
+    });
+
+    it('rejects non-matches', () => {
+        expect(matchRoute('/about', '/x')).toBeNull();
+        expect(matchRoute('/blog/:id', '/blog')).toBeNull();
+        expect(matchRoute('/', '/about')).toBeNull();
+    });
+
+    it('extracts dynamic params', () => {
+        expect(matchRoute('/blog/:id', '/blog/42')).toEqual({ id: '42' });
+        expect(matchRoute('/u/:user/p/:post', '/u/ann/p/7')).toEqual({ user: 'ann', post: '7' });
+        expect(matchRoute('/blog/:id', '/blog/a%20b')).toEqual({ id: 'a b' });
+    });
+
+    it('captures the tail with catch-all routes', () => {
+        expect(matchRoute('/docs/*slug', '/docs/a/b/c')).toEqual({ slug: 'a/b/c' });
+        expect(matchRoute('/docs/*slug', '/docs/intro')).toEqual({ slug: 'intro' });
+        expect(matchRoute('/files/*path', '/files/a%20b/c')).toEqual({ path: 'a b/c' });
+        // catch-all needs at least one trailing segment
+        expect(matchRoute('/docs/*slug', '/docs')).toBeNull();
+    });
+});

package/tests/server/example.spec.ts

@@ -0,0 +1,7 @@
+import { add } from '../../src/server';
+
+describe('server', () => {
+    it('adds two integers', () => {
+        expect<i32>(add(1, 2)).toBe(3);
+    });
+});

package/toilconfig.json

@@ -0,0 +1,30 @@
+{
+    "entries": ["src/server/main.ts"],
+    "targets": {
+        "release": {
+            "outFile": "build/server/release.wasm",
+            "textFile": "build/server/release.wat"
+        }
+    },
+    "options": {
+        "sourceMap": false,
+        "optimizeLevel": 3,
+        "shrinkLevel": 1,
+        "converge": true,
+        "noAssert": false,
+        "enable": [
+            "sign-extension",
+            "mutable-globals",
+            "nontrapping-f2i",
+            "bulk-memory",
+            "simd",
+            "reference-types",
+            "multi-value"
+        ],
+        "runtime": "stub",
+        "memoryBase": 0,
+        "initialMemory": 1,
+        "debug": false,
+        "trapMode": "allow"
+    }
+}

package/tsconfig.backend.json

@@ -0,0 +1,13 @@
+{
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "target": "ESNext",
+        "moduleResolution": "bundler",
+        "rootDir": "src/backend",
+        "outDir": "build/backend",
+        "types": ["node"],
+        "tsBuildInfoFile": "build/backend/.tsbuildinfo"
+    },
+    "include": ["src/backend/**/*"]
+}

package/tsconfig.base.json

@@ -0,0 +1,35 @@
+{
+    "compilerOptions": {
+        "declaration": true,
+        "noImplicitAny": true,
+        "removeComments": true,
+        "suppressImplicitAnyIndexErrors": false,
+        "preserveConstEnums": true,
+        "resolveJsonModule": true,
+        "skipLibCheck": true,
+        "sourceMap": false,
+        "moduleDetection": "force",
+        "experimentalDecorators": true,
+        "lib": [
+            "ESNext",
+            "DOM",
+            "DOM.Iterable",
+            "DOM.AsyncIterable",
+            "WebWorker",
+            "WebWorker.AsyncIterable",
+            "WebWorker.ImportScripts"
+        ],
+        "strict": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "strictBindCallApply": true,
+        "strictPropertyInitialization": true,
+        "alwaysStrict": true,
+        "moduleResolution": "bundler",
+        "allowJs": true,
+        "incremental": true,
+        "allowSyntheticDefaultImports": true,
+        "esModuleInterop": true
+    },
+    "include": ["src/**/*.ts", "src/*", "src/**/*.js", "src/*.ts", "src/*.js", "src/*.cjs"]
+}

package/tsconfig.cli.json

@@ -0,0 +1,13 @@
+{
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "target": "ESNext",
+        "moduleResolution": "bundler",
+        "rootDir": "src/cli",
+        "outDir": "build/cli",
+        "types": ["node"],
+        "tsBuildInfoFile": "build/cli/.tsbuildinfo"
+    },
+    "include": ["src/cli/**/*"]
+}

package/tsconfig.client.json

@@ -0,0 +1,14 @@
+{
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "target": "ESNext",
+        "moduleResolution": "bundler",
+        "jsx": "react-jsx",
+        "lib": ["ESNext", "DOM", "DOM.Iterable"],
+        "rootDir": "src/client",
+        "outDir": "build/client",
+        "tsBuildInfoFile": "build/client/.tsbuildinfo"
+    },
+    "include": ["src/client/**/*"]
+}

package/tsconfig.compiler.json

@@ -0,0 +1,13 @@
+{
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "target": "ESNext",
+        "moduleResolution": "bundler",
+        "rootDir": "src/compiler",
+        "outDir": "build/compiler",
+        "types": ["node"],
+        "tsBuildInfoFile": "build/compiler/.tsbuildinfo"
+    },
+    "include": ["src/compiler/**/*"]
+}

package/tsconfig.io.json

@@ -0,0 +1,12 @@
+{
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "target": "ESNext",
+        "moduleResolution": "bundler",
+        "rootDir": "src/io",
+        "outDir": "build/io",
+        "tsBuildInfoFile": "build/io/.tsbuildinfo"
+    },
+    "include": ["src/io/**/*"]
+}

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "target": "ESNext",
+        "moduleResolution": "bundler",
+        "jsx": "react-jsx",
+        "noEmit": true,
+        "incremental": false
+    },
+    "include": [
+        "src/**/*.ts",
+        "src/**/*.tsx",
+        "test/**/*.ts",
+        "std/client/index.d.ts"
+    ],
+    "exclude": [
+        "node_modules",
+        "build",
+        "src/server"
+    ]
+}

package/tsconfig.logger.json

@@ -0,0 +1,12 @@
+{
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "target": "ESNext",
+        "moduleResolution": "bundler",
+        "rootDir": "src/logger",
+        "outDir": "build/logger",
+        "tsBuildInfoFile": "build/logger/.tsbuildinfo"
+    },
+    "include": ["src/logger/**/*"]
+}

package/tsconfig.server.json

@@ -0,0 +1,10 @@
+{
+    "extends": "toilscript/std/assembly.json",
+    "compilerOptions": {
+        "experimentalDecorators": true,
+        "noEmit": true
+    },
+    "include": [
+        "src/server/**/*.ts"
+    ]
+}

package/tsconfig.shared.json

@@ -0,0 +1,12 @@
+{
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "target": "ESNext",
+        "moduleResolution": "bundler",
+        "rootDir": "src/shared",
+        "outDir": "build/shared",
+        "tsBuildInfoFile": "build/shared/.tsbuildinfo"
+    },
+    "include": ["src/shared/**/*"]
+}

package/vitest.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: 'node',
+        include: ['test/**/*.test.ts', 'test/**/*.spec.ts'],
+        coverage: {
+            provider: 'v8',
+            reporter: ['text', 'json', 'html'],
+            exclude: [
+                'node_modules/',
+                'build/',
+                'browser/',
+                'test/',
+                '**/*.d.ts',
+                '**/*.config.*',
+                '**/mockData',
+            ],
+        },
+    },
+});