tablinum 0.0.1

package/.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets).
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md).

package/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.3/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/.context/attachments/pasted_text_2026-03-07_14-02-40.txt

@@ -0,0 +1,571 @@
+import { exec, type ChildProcess } from 'node:child_process';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+
+interface ValidationError {
+	tool: string;
+	file?: string;
+	line?: number;
+	column?: number;
+	message: string;
+	code?: string;
+	severity: 'error' | 'warning';
+}
+
+interface ValidationResult {
+	success: boolean;
+	errors: ValidationError[];
+	summary: string;
+	duration_ms: number;
+	stopped_early: boolean;
+	next_action?: string;
+}
+
+const MAX_ERRORS = 3;
+const E2E_SKIP_RUNTIME = process.env.VALIDATE_SKIP_E2E_RUNTIME === '1';
+const ANSI_ESCAPE_PATTERN = new RegExp(String.raw`\u001B\[[0-9;?]*[A-Za-z]`, 'g');
+
+// Shared state for fail-fast behavior
+let collectedErrors: ValidationError[] = [];
+let failedTools: string[] = [];
+let aborted = false;
+const runningProcesses: ChildProcess[] = [];
+
+function abort() {
+	aborted = true;
+	// Kill all running child processes
+	for (const proc of runningProcesses) {
+		proc.kill('SIGTERM');
+	}
+}
+
+function addErrors(toolName: string, errors: ValidationError[]): boolean {
+	if (aborted || errors.length === 0) return aborted;
+
+	if (!failedTools.includes(toolName)) {
+		failedTools.push(toolName);
+	}
+
+	for (const error of errors) {
+		if (collectedErrors.length >= MAX_ERRORS) {
+			abort();
+			return true;
+		}
+		collectedErrors.push(error);
+	}
+
+	if (collectedErrors.length >= MAX_ERRORS) {
+		abort();
+		return true;
+	}
+
+	return false;
+}
+
+function run(cmd: string): Promise<{ stdout: string; stderr: string; success: boolean }> {
+	return new Promise((resolve) => {
+		if (aborted) {
+			resolve({ stdout: '', stderr: '', success: false });
+			return;
+		}
+
+		const proc = exec(
+			cmd,
+			{ encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 },
+			(error, stdout, stderr) => {
+				const idx = runningProcesses.indexOf(proc);
+				if (idx !== -1) runningProcesses.splice(idx, 1);
+
+				if (aborted) {
+					resolve({ stdout: '', stderr: '', success: false });
+					return;
+				}
+
+				resolve({
+					stdout: stdout ?? '',
+					stderr: stderr ?? '',
+					success: !error
+				});
+			}
+		);
+
+		runningProcesses.push(proc);
+	});
+}
+
+function summarizeFailureOutput(text: string): string | undefined {
+	const lines = normalizeOutputLines(text);
+
+	if (lines.length === 0) return undefined;
+
+	const prioritized = lines.find((line) =>
+		/(^error\b|failed|ELIFECYCLE|\[WebServer\])/i.test(line)
+	);
+	return prioritized ?? lines[0];
+}
+
+function normalizeOutputLines(text: string): string[] {
+	return text
+		.split('\n')
+		.map((line) => line.replace(ANSI_ESCAPE_PATTERN, '').trim())
+		.filter((line) => line.length > 0);
+}
+
+function truncateText(text: string, maxLength = 220): string {
+	return text.length <= maxLength ? text : `${text.slice(0, maxLength - 1)}...`;
+}
+
+function summarizePlaywrightFailure(text: string): string | undefined {
+	const lines = normalizeOutputLines(text);
+	const failureIndex = lines.findIndex((line) => /^\d+\)\s+\[[^\]]+\]\s+›/.test(line));
+	const failureLine = failureIndex >= 0 ? lines[failureIndex] : undefined;
+	const detailLine =
+		(failureIndex >= 0 &&
+			lines
+				.slice(failureIndex + 1)
+				.find((line) => /^Error:/i.test(line) || /expect\(.+\)\..+\sfailed/i.test(line))) ??
+		lines.find((line) => /^Error:/i.test(line));
+
+	if (failureLine && detailLine) {
+		return truncateText(`${failureLine} :: ${detailLine}`);
+	}
+
+	if (failureLine) {
+		return truncateText(failureLine);
+	}
+
+	return undefined;
+}
+
+function countListedTestsForProject(output: string, projectName: string): number {
+	return output
+		.split('\n')
+		.map((line) => line.trim())
+		.filter((line) => line.startsWith(`[${projectName}]`) && line.includes('›')).length;
+}
+
+async function runTestCoverage(): Promise<ValidationError[]> {
+	if (aborted) return [];
+	const errors: ValidationError[] = [];
+
+	const { stdout } = await run('git ls-files "src/**/*.ts" "src/**/*.svelte"');
+	if (aborted) return [];
+
+	const sourceFiles = stdout.split('\n').filter(Boolean);
+
+	const skipPatterns = [
+		/\.test\.ts$/,
+		/\.spec\.ts$/,
+		/\.d\.ts$/,
+		/index\.ts$/,
+		/types\.ts$/,
+		/\.styles\.ts$/,
+		/\.stories\.svelte$/,
+		/\.test-wrapper\.svelte$/,
+		/\+error\.svelte$/,
+		/\/data\/Data\.svelte$/,
+		/\.remote\.ts$/,
+		/\/server\/auth\.ts$/,
+		/\/server\/access\.ts$/,
+		/\/server\/auth-guards\.ts$/,
+		/\/server\/db\/schema\//,
+		/\/testing\/mocks\.ts$/,
+		/\+layout\.(server\.)?ts$/,
+		/\+layout\.svelte$/,
+		/\+page\.server\.ts$/,
+		/\+page\.svelte$/,
+		/\+page\.ts$/
+	];
+
+	for (const file of sourceFiles) {
+		if (aborted) break;
+		if (skipPatterns.some((p) => p.test(file))) continue;
+
+		const dir = dirname(file);
+		const name = basename(file).replace(/\.(ts|svelte)$/, '');
+		const alternateName = name.startsWith('+') ? name.slice(1) : null;
+
+		const testPaths = [
+			join(dir, `${name}.test.ts`),
+			join(dir, `${name}.spec.ts`),
+			join(dir, `${name}.svelte.test.ts`),
+			join(dir, `${name}.svelte.spec.ts`),
+			join(dir, `${name}.ssr.test.ts`),
+			join(dir, `${name}.ssr.spec.ts`),
+			join(dir, '__tests__', `${name}.test.ts`),
+			join(dir, '__tests__', `${name}.spec.ts`)
+		];
+		if (alternateName) {
+			testPaths.push(
+				join(dir, `${alternateName}.test.ts`),
+				join(dir, `${alternateName}.spec.ts`),
+				join(dir, '__tests__', `${alternateName}.test.ts`),
+				join(dir, '__tests__', `${alternateName}.spec.ts`)
+			);
+		}
+
+		const hasTest = testPaths.some((p) => existsSync(p));
+
+		if (!hasTest) {
+			errors.push({
+				tool: 'test-coverage',
+				file,
+				severity: 'error',
+				message: `Missing test file. Expected: ${name}.test.ts${alternateName ? ` or ${alternateName}.test.ts` : ''}`
+			});
+		}
+	}
+
+	return errors;
+}
+
+async function runPrettier(): Promise<ValidationError[]> {
+	if (aborted) return [];
+	const errors: ValidationError[] = [];
+	const { stdout, success } = await run(
+		'pnpm exec prettier --check --plugin prettier-plugin-svelte .'
+	);
+
+	if (aborted) return [];
+
+	if (!success) {
+		for (const line of stdout.split('\n')) {
+			if (line.startsWith('[warn]') || line.includes('Forgot to run') || line.includes('Checking'))
+				continue;
+			if (line.trim()) {
+				errors.push({
+					tool: 'prettier',
+					file: line.trim(),
+					severity: 'error',
+					message: 'File needs formatting. Run: pnpm exec prettier --write ' + line.trim()
+				});
+			}
+		}
+	}
+
+	return errors;
+}
+
+async function runOxlint(): Promise<ValidationError[]> {
+	if (aborted) return [];
+	const errors: ValidationError[] = [];
+	const { stdout } = await run('pnpm exec oxlint --format json');
+
+	if (aborted) return [];
+
+	try {
+		// oxlint outputs JSON with diagnostics array
+		const result = JSON.parse(stdout);
+		for (const diagnostic of result.diagnostics ?? []) {
+			if (diagnostic.severity === 'error') {
+				const label = diagnostic.labels?.[0];
+				errors.push({
+					tool: 'oxlint',
+					file: diagnostic.filename,
+					line: label?.span?.line,
+					column: label?.span?.column,
+					code: diagnostic.code,
+					severity: 'error',
+					message: diagnostic.message
+				});
+			}
+		}
+	} catch {
+		// JSON parse failed, no errors to report
+	}
+
+	return errors;
+}
+
+async function runSvelteCheck(): Promise<ValidationError[]> {
+	if (aborted) return [];
+	const errors: ValidationError[] = [];
+	const { stdout } = await run('pnpm exec svelte-check --output machine-verbose');
+
+	if (aborted) return [];
+
+	for (const line of stdout.split('\n')) {
+		const match = line.match(/^(\w+)\s+(.+):(\d+):(\d+)\s+(.+)$/);
+		if (match && match[1] === 'ERROR') {
+			errors.push({
+				tool: 'svelte-check',
+				file: match[2],
+				line: parseInt(match[3]),
+				column: parseInt(match[4]),
+				severity: 'error',
+				message: match[5]
+			});
+		}
+	}
+
+	return errors;
+}
+
+async function runTypeScript(): Promise<ValidationError[]> {
+	if (aborted) return [];
+	const errors: ValidationError[] = [];
+	const { stdout } = await run('pnpm exec tsc --noEmit --pretty false');
+
+	if (aborted) return [];
+
+	for (const line of stdout.split('\n')) {
+		const match = line.match(/^(.+)\((\d+),(\d+)\):\s+error\s+(TS\d+):\s+(.+)$/);
+		if (match) {
+			errors.push({
+				tool: 'tsc',
+				file: match[1],
+				line: parseInt(match[2]),
+				column: parseInt(match[3]),
+				code: match[4],
+				severity: 'error',
+				message: match[5]
+			});
+		}
+	}
+
+	return errors;
+}
+
+const E2E_REQUIRED_ROUTES = ['/', '/login', '/login/check-email', '/account', '/dashboard'];
+const E2E_MIN_CHROMIUM_TESTS = 10;
+const E2E_MIN_CHROMIUM_AUTH_TESTS = 1;
+
+async function runE2ECoverage(): Promise<ValidationError[]> {
+	if (aborted) return [];
+	const errors: ValidationError[] = [];
+	const e2eDir = 'e2e';
+
+	if (!existsSync(e2eDir)) {
+		errors.push({
+			tool: 'e2e-coverage',
+			severity: 'error',
+			message: 'Missing e2e/ directory. Run: mkdir e2e'
+		});
+		return errors;
+	}
+
+	// Run Playwright discovery for chromium.
+	const {
+		stdout: chromiumListStdout,
+		stderr: chromiumListStderr,
+		success: chromiumListSuccess
+	} = await run('pnpm exec playwright test --project=chromium --list');
+	if (aborted) return [];
+
+	if (!chromiumListSuccess) {
+		const output = `${chromiumListStderr}\n${chromiumListStdout}`.trim();
+		const firstLine = summarizeFailureOutput(output);
+		errors.push({
+			tool: 'e2e-coverage',
+			severity: 'error',
+			message: `Playwright chromium discovery failed${firstLine ? `: ${firstLine}` : ''}`
+		});
+		return errors;
+	}
+
+	const chromiumTotal = countListedTestsForProject(chromiumListStdout, 'chromium');
+
+	if (chromiumTotal < E2E_MIN_CHROMIUM_TESTS) {
+		errors.push({
+			tool: 'e2e-coverage',
+			severity: 'error',
+			message: `Chromium E2E test count too low (${chromiumTotal}). Minimum required: ${E2E_MIN_CHROMIUM_TESTS}`
+		});
+	}
+
+	// Ensure authenticated project is still covered.
+	const {
+		stdout: chromiumAuthListStdout,
+		stderr: chromiumAuthListStderr,
+		success: chromiumAuthListSuccess
+	} = await run('pnpm exec playwright test --project=chromium-auth --list');
+	if (aborted) return [];
+
+	if (!chromiumAuthListSuccess) {
+		const output = `${chromiumAuthListStderr}\n${chromiumAuthListStdout}`.trim();
+		const firstLine = summarizeFailureOutput(output);
+		errors.push({
+			tool: 'e2e-coverage',
+			severity: 'error',
+			message: `Playwright chromium-auth discovery failed${firstLine ? `: ${firstLine}` : ''}`
+		});
+		return errors;
+	}
+
+	const chromiumAuthTotal = countListedTestsForProject(chromiumAuthListStdout, 'chromium-auth');
+
+	if (chromiumAuthTotal < E2E_MIN_CHROMIUM_AUTH_TESTS) {
+		errors.push({
+			tool: 'e2e-coverage',
+			severity: 'error',
+			message: `Chromium-auth E2E test count too low (${chromiumAuthTotal}). Minimum required: ${E2E_MIN_CHROMIUM_AUTH_TESTS}`
+		});
+	}
+
+	const testFiles: string[] = [];
+	const walk = (dir: string) => {
+		for (const entry of readdirSync(dir, { withFileTypes: true })) {
+			const fullPath = join(dir, entry.name);
+			if (entry.isDirectory()) {
+				walk(fullPath);
+				continue;
+			}
+			if (entry.isFile() && entry.name.endsWith('.spec.ts')) {
+				testFiles.push(fullPath);
+			}
+		}
+	};
+	walk(e2eDir);
+
+	if (testFiles.length === 0) {
+		errors.push({
+			tool: 'e2e-coverage',
+			severity: 'error',
+			message: 'No E2E test files found in e2e/ directory'
+		});
+		return errors;
+	}
+
+	const testedRoutes = new Set<string>();
+	for (const file of testFiles) {
+		const content = readFileSync(file, 'utf-8');
+		const matches = content.matchAll(/page\.goto\(['"]([^'"]+)['"]\)/g);
+		for (const match of matches) {
+			testedRoutes.add(match[1]);
+		}
+	}
+
+	for (const route of E2E_REQUIRED_ROUTES) {
+		if (!testedRoutes.has(route)) {
+			errors.push({
+				tool: 'e2e-coverage',
+				severity: 'error',
+				message: `Missing E2E test for critical route: ${route}`
+			});
+		}
+	}
+
+	return errors;
+}
+
+async function runE2EChromium(): Promise<ValidationError[]> {
+	if (aborted || E2E_SKIP_RUNTIME) return [];
+
+	const errors: ValidationError[] = [];
+	const { stdout, stderr, success } = await run(
+		'pnpm exec playwright test --project=chromium --workers=1 --reporter=line'
+	);
+
+	if (aborted) return [];
+
+	if (!success) {
+		const output = `${stderr}\n${stdout}`.trim();
+		const firstLine = summarizePlaywrightFailure(output) ?? summarizeFailureOutput(output);
+		errors.push({
+			tool: 'e2e-chromium',
+			severity: 'error',
+			message: `Chromium E2E run failed${firstLine ? `: ${firstLine}` : ''}`
+		});
+	}
+
+	return errors;
+}
+
+async function runVitest(): Promise<ValidationError[]> {
+	if (aborted) return [];
+	const errors: ValidationError[] = [];
+	const { stdout } = await run('pnpm exec vitest run --reporter=json');
+
+	if (aborted) return [];
+
+	try {
+		const result = JSON.parse(stdout);
+		for (const file of result.testResults ?? []) {
+			for (const test of file.assertionResults ?? []) {
+				if (test.status === 'failed') {
+					errors.push({
+						tool: 'vitest',
+						file: file.name,
+						line: test.location?.line,
+						severity: 'error',
+						message: `${test.ancestorTitles.join(' > ')} > ${test.title}: ${test.failureMessages?.[0]?.split('\n')[0] ?? 'failed'}`
+					});
+				}
+			}
+		}
+	} catch {
+		// JSON parse failed, no errors to report
+	}
+
+	return errors;
+}
+
+interface Check {
+	name: string;
+	fn: () => Promise<ValidationError[]>;
+}
+
+async function validate(): Promise<ValidationResult> {
+	const start = performance.now();
+
+	// Reset global state
+	collectedErrors = [];
+	failedTools = [];
+	aborted = false;
+
+	const allChecks: Check[] = [
+		{ name: 'prettier', fn: runPrettier },
+		{ name: 'oxlint', fn: runOxlint },
+		{ name: 'svelte-check', fn: runSvelteCheck },
+		{ name: 'tsc', fn: runTypeScript },
+		{ name: 'test-coverage', fn: runTestCoverage },
+		{ name: 'e2e-coverage', fn: runE2ECoverage },
+		{ name: 'vitest', fn: runVitest }
+	];
+
+	if (!E2E_SKIP_RUNTIME) {
+		allChecks.push({ name: 'e2e-chromium', fn: runE2EChromium });
+	}
+
+	console.error(`→ Running ${allChecks.length} checks in parallel...`);
+
+	// Run all checks in parallel with fail-fast
+	await Promise.all(
+		allChecks.map(async (check) => {
+			const checkStart = performance.now();
+			const errors = await check.fn();
+			const checkDuration = Math.round(performance.now() - checkStart);
+
+			// Add errors and check if we should abort
+			const wasAborted = addErrors(check.name, errors);
+
+			const status = aborted && errors.length === 0 ? '○' : errors.length === 0 ? '✓' : '✗';
+			const suffix = wasAborted && errors.length === 0 ? ' (cancelled)' : '';
+			console.error(`  ${status} ${check.name} (${checkDuration}ms)${suffix}`);
+		})
+	);
+
+	const duration_ms = Math.round(performance.now() - start);
+
+	const errorSummary = `✗ ${collectedErrors.length} error(s) from ${failedTools.join(', ')}`;
+
+	return {
+		success: collectedErrors.length === 0,
+		errors: collectedErrors,
+		summary:
+			collectedErrors.length === 0
+				? `✓ All ${allChecks.length} checks passed in ${duration_ms}ms`
+				: errorSummary,
+		duration_ms,
+		stopped_early: aborted,
+		next_action:
+			collectedErrors.length > 0
+				? 'Spawn a sub-agent to fix these errors, then re-run validation.'
+				: undefined
+	};
+}
+
+validate().then((result) => {
+	console.log(JSON.stringify(result, null, 2));
+	process.exit(result.success ? 0 : 1);
+});