@flowdular/sandbox 0.2.0

package/src/client/attachments.ts

@@ -0,0 +1,73 @@
+import { activeLocale, t } from './i18n.ts';
+
+/* The composer's mirror of the limits server/attachments.ts enforces. The
+   server stays the authority; refusing here only saves an upload that would be
+   rejected, and the two lists must move together. */
+export const ATTACHMENT_EXTENSIONS = [
+	'png',
+	'jpg',
+	'jpeg',
+	'gif',
+	'webp',
+	'md',
+	'txt',
+	'json',
+	'csv',
+	'pdf',
+	'svg',
+];
+
+export const MAX_ATTACHMENTS = 10;
+export const MAX_ATTACHMENT_BYTES = 5 * 1024 * 1024;
+
+export const ATTACH_ACCEPT =
+	'image/png,image/jpeg,image/gif,image/webp,image/svg+xml,.png,.jpg,.jpeg,.gif,.webp,.svg,.md,.txt,.json,.csv,.pdf';
+
+export function formatBytes(size: number): string {
+	const value =
+		size < 1024
+			? size
+			: size < 1024 * 1024
+				? size / 1024
+				: size / (1024 * 1024);
+	const count = new Intl.NumberFormat(activeLocale(), {
+		maximumFractionDigits: size < 1024 * 1024 ? 0 : 1,
+	}).format(value);
+	return size < 1024
+		? t('sandbox.attachments.bytes', { count })
+		: size < 1024 * 1024
+			? t('sandbox.attachments.kilobytes', { count })
+			: t('sandbox.attachments.megabytes', { count });
+}
+
+export function attachmentKind(file: File): 'image' | 'file' {
+	return file.type.startsWith('image/') && file.type !== 'image/svg+xml'
+		? 'image'
+		: 'file';
+}
+
+/* Why this file cannot be attached, or null when it can. `held` is how many the
+   composer already holds. */
+export function attachmentRefusal(file: File, held: number): string | null {
+	if (held >= MAX_ATTACHMENTS) {
+		return t('sandbox.attachments.limit', { count: MAX_ATTACHMENTS });
+	}
+	const dot = file.name.lastIndexOf('.');
+	const extension = dot > 0 ? file.name.slice(dot + 1).toLowerCase() : '';
+	if (!ATTACHMENT_EXTENSIONS.includes(extension)) {
+		return t('sandbox.attachments.type', {
+			name: file.name,
+			types: ATTACHMENT_EXTENSIONS.join(', '),
+		});
+	}
+	if (file.size === 0) {
+		return t('sandbox.attachments.empty', { name: file.name });
+	}
+	if (file.size > MAX_ATTACHMENT_BYTES) {
+		return t('sandbox.attachments.tooLarge', {
+			name: file.name,
+			size: MAX_ATTACHMENT_BYTES / (1024 * 1024),
+		});
+	}
+	return null;
+}

package/src/client/dashboard.ts

@@ -0,0 +1,46 @@
+import type { DashboardRow, WorkUsage } from '../server/dashboard.ts';
+
+export function filterWork(
+	rows: readonly DashboardRow[],
+	query: string,
+	status: string,
+	archived: boolean,
+	locale: string,
+): readonly DashboardRow[] {
+	const term = query.trim().toLocaleLowerCase(locale);
+	return rows.filter(
+		(row) =>
+			(!status || row.status === status) &&
+			(archived || status === 'archived' || row.status !== 'archived') &&
+			(!term ||
+				[
+					row.session.title,
+					row.session.brief,
+					...row.session.modules.map((module) => module.id),
+				].some((value) => value.toLocaleLowerCase(locale).includes(term))),
+	);
+}
+
+export function formatTokens(usage: WorkUsage, locale: string): string {
+	if (!usage.reportedTurns && usage.missingUsage) return '?';
+	return (
+		new Intl.NumberFormat(locale).format(usage.totalTokens) +
+		(usage.missingUsage ? ' +' : '')
+	);
+}
+
+export function formatCost(usage: WorkUsage, locale: string): string {
+	if (
+		!usage.pricedTurns &&
+		(usage.unpricedTurns || usage.reportedTurns || usage.missingUsage)
+	)
+		return '?';
+	return (
+		new Intl.NumberFormat(locale, {
+			style: 'currency',
+			currency: 'USD',
+			minimumFractionDigits: 2,
+			maximumFractionDigits: 4,
+		}).format(usage.knownCostUsd) + (usage.unpricedTurns ? ' +' : '')
+	);
+}

package/src/client/github-settings.ts

@@ -0,0 +1,48 @@
+import type { SafeSandboxConfiguration } from '../server/config.ts';
+import type { GitHubSettingsInput } from './GitHubSettingsModal.tsrx';
+
+/* Hidden custom fields must not erase the saved local settings when switching
+   back to repository defaults. A blank credential preserves the sealed token. */
+export function githubSettingsInput(
+	form: FormData,
+	current: SafeSandboxConfiguration['github'],
+): GitHubSettingsInput {
+	const value = (name: string, fallback = '') => {
+		const entry = form.get(name);
+		return typeof entry === 'string' ? entry.trim() : fallback;
+	};
+	const custom = form.get('githubOverridesProject') === 'on';
+	const token = value('githubToken');
+	return {
+		githubEnabled: form.get('githubEnabled') === 'on',
+		githubOverridesProject: custom,
+		githubRemote: custom
+			? value('githubRemote', current.remote)
+			: current.remote,
+		githubRepository: custom
+			? value('githubRepository', current.repository ?? '')
+			: (current.repository ?? ''),
+		githubBaseBranch: custom
+			? value('githubBaseBranch', current.baseBranch)
+			: current.baseBranch,
+		githubBranchPrefix: custom
+			? value('githubBranchPrefix', current.branchPrefix)
+			: current.branchPrefix,
+		githubMode: custom
+			? (value('githubMode', current.mode) as GitHubSettingsInput['githubMode'])
+			: current.mode,
+		githubForkOwner: custom
+			? value('githubForkOwner', current.forkOwner ?? '')
+			: (current.forkOwner ?? ''),
+		githubReviewers: custom
+			? value('githubReviewers', current.reviewers.join(','))
+					.split(',')
+					.map((entry) => entry.trim())
+					.filter(Boolean)
+			: current.reviewers,
+		...(token ? { githubToken: token } : {}),
+		...(form.get('githubClearToken') === 'on'
+			? { githubClearToken: true }
+			: {}),
+	};
+}

package/src/client/highlight.ts

@@ -0,0 +1,105 @@
+export interface Token {
+	/* Position in the line, so a rendered token has a stable key. */
+	readonly id: number;
+	readonly text: string;
+	readonly kind: 'plain' | 'keyword' | 'string' | 'comment' | 'number' | 'type';
+}
+
+const KEYWORDS = new Set([
+	'import',
+	'export',
+	'from',
+	'const',
+	'let',
+	'var',
+	'function',
+	'return',
+	'if',
+	'else',
+	'for',
+	'of',
+	'in',
+	'while',
+	'class',
+	'extends',
+	'implements',
+	'interface',
+	'type',
+	'enum',
+	'new',
+	'await',
+	'async',
+	'try',
+	'catch',
+	'finally',
+	'throw',
+	'typeof',
+	'instanceof',
+	'readonly',
+	'public',
+	'private',
+	'protected',
+	'static',
+	'true',
+	'false',
+	'null',
+	'undefined',
+	'this',
+	'super',
+	'as',
+	'satisfies',
+	'default',
+	'CREATE',
+	'TABLE',
+	'SELECT',
+	'INSERT',
+	'UPDATE',
+	'DELETE',
+	'FROM',
+	'WHERE',
+	'INDEX',
+	'NOT',
+	'NULL',
+	'PRIMARY',
+	'KEY',
+	'REFERENCES',
+]);
+
+const PATTERN =
+	/(\/\/[^\n]*|\/\*[\s\S]*?\*\/|--[^\n]*)|('(?:[^'\\]|\\.)*'|"(?:[^"\\]|\\.)*"|`(?:[^`\\]|\\.)*`)|(\b\d[\d_.]*\b)|([A-Za-z_$][\w$]*)/g;
+
+/* A deliberately small highlighter: the sandbox diff shows TypeScript, TSRX,
+   JSON, YAML, CSS, and SQL, and a dependency-free tokenizer keeps the preview
+   free of third-party runtime code. */
+export function tokenize(line: string): readonly Token[] {
+	const tokens: Token[] = [];
+	const push = (value: string, kind: Token['kind']) => {
+		tokens.push({ id: tokens.length, text: value, kind });
+	};
+	let lastIndex = 0;
+	PATTERN.lastIndex = 0;
+	for (;;) {
+		const match = PATTERN.exec(line);
+		if (!match) break;
+		if (match.index > lastIndex) {
+			push(line.slice(lastIndex, match.index), 'plain');
+		}
+		const [value, comment, string, number, word] = match;
+		if (comment) push(value, 'comment');
+		else if (string) push(value, 'string');
+		else if (number) push(value, 'number');
+		else if (word) {
+			push(
+				value,
+				KEYWORDS.has(word) ? 'keyword' : /^[A-Z]/.test(word) ? 'type' : 'plain',
+			);
+		}
+		lastIndex = match.index + value.length;
+	}
+	if (lastIndex < line.length) push(line.slice(lastIndex), 'plain');
+	return tokens;
+}
+
+export function tokenClass(kind: Token['kind']): string {
+	return kind === 'plain' ? '' : `tok-${kind}`;
+}

package/src/client/i18n.ts

@@ -0,0 +1,32 @@
+import {
+	activeLocale,
+	registerModuleTranslations,
+	restorePersistedLocale,
+	setActiveLocale,
+	SUPPORTED_LOCALES,
+	t,
+	useTranslation,
+} from '@flowdular/sdk/client';
+import en from './locales/en.json';
+import pl from './locales/pl.json';
+
+/** The standalone sandbox shares the platform translation runtime and keys. */
+export function registerSandboxTranslations(): void {
+	/* The translation runtime may be replaced independently by Vite HMR. The
+	   catalog is the source of truth, so a stale local boolean must not suppress
+	   recovery and expose raw keys in the workspace menu. */
+	if (t('sandbox.workspace.language.en') !== 'sandbox.workspace.language.en')
+		return;
+	registerModuleTranslations([
+		{
+			moduleId: 'sandbox.app',
+			translations: { en, pl },
+		},
+	]);
+}
+
+export function restoreSandboxLocale(): void {
+	restorePersistedLocale();
+}
+
+export { activeLocale, setActiveLocale, SUPPORTED_LOCALES, t, useTranslation };