cortico 0.1.0

package/src/web/path-picker.ts

@@ -0,0 +1,296 @@
+import { execFile } from 'node:child_process';
+import { stat } from 'node:fs/promises';
+import { dirname, isAbsolute, resolve, sep } from 'node:path';
+import { platform } from 'node:process';
+import type { PathPicker, PathPickerOptions } from './shared/path-picker.ts';
+
+interface ExecFailure extends Error {
+  code?: string | number;
+  stdout?: string;
+  stderr?: string;
+}
+
+export class PathPickerRequestError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'PathPickerRequestError';
+  }
+}
+
+export class PathPickerUnavailableError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'PathPickerUnavailableError';
+  }
+}
+
+function stringOption(value: unknown, name: string): string | undefined {
+  if (value == null || value === '') return undefined;
+  if (typeof value !== 'string') throw new PathPickerRequestError(`${name} 必须是字符串`);
+  if (value.includes('\0')) throw new PathPickerRequestError(`${name} 不能含 NUL 字符`);
+  return value;
+}
+
+function normalizeExtension(value: string): string {
+  const extension = value.trim().toLowerCase();
+  if (!/^\.?[a-z0-9][a-z0-9._+-]*$/i.test(extension)) {
+    throw new PathPickerRequestError(`不合法的文件后缀: ${value}`);
+  }
+  return extension.startsWith('.') ? extension : `.${extension}`;
+}
+
+/** 平台命令只接收经过校验的 JSON 边界值。 */
+export function parsePathPickerOptions(raw: unknown): PathPickerOptions {
+  if (!raw || typeof raw !== 'object') throw new PathPickerRequestError('请求体必须是对象');
+  const body = raw as Record<string, unknown>;
+  if (body.kind !== 'file' && body.kind !== 'directory') {
+    throw new PathPickerRequestError('kind 必须是 file 或 directory');
+  }
+  if (body.extensions != null && !Array.isArray(body.extensions)) {
+    throw new PathPickerRequestError('extensions 必须是字符串数组');
+  }
+  const extensions = body.extensions === undefined
+    ? undefined
+    : [...new Set((body.extensions as unknown[]).map((item) => {
+        if (typeof item !== 'string') throw new PathPickerRequestError('extensions 必须是字符串数组');
+        return normalizeExtension(item);
+      }))];
+  const title = stringOption(body.title, 'title');
+  const currentPath = stringOption(body.currentPath, 'currentPath');
+  const recommendedDir = stringOption(body.recommendedDir, 'recommendedDir');
+  return {
+    kind: body.kind,
+    ...(title ? { title } : {}),
+    ...(currentPath ? { currentPath } : {}),
+    ...(recommendedDir ? { recommendedDir } : {}),
+    ...(extensions ? { extensions } : {}),
+  };
+}
+
+/** 浏览器只会收到存在、类型匹配的绝对路径。 */
+export async function validatePickedPath(
+  selected: string | null,
+  options: PathPickerOptions,
+): Promise<string | null> {
+  if (selected == null || selected.trim() === '') return null;
+  const path = isAbsolute(selected) ? resolve(selected) : resolve(process.cwd(), selected);
+  let info;
+  try {
+    info = await stat(path);
+  } catch {
+    throw new PathPickerRequestError(`选择的路径不存在: ${path}`);
+  }
+  if (options.kind === 'file' && !info.isFile()) {
+    throw new PathPickerRequestError(`选择的路径不是文件: ${path}`);
+  }
+  if (options.kind === 'directory' && !info.isDirectory()) {
+    throw new PathPickerRequestError(`选择的路径不是目录: ${path}`);
+  }
+  if (options.kind === 'file' && options.extensions?.length) {
+    const lower = path.toLowerCase();
+    if (!options.extensions.some((extension) => lower.endsWith(extension.toLowerCase()))) {
+      throw new PathPickerRequestError(`文件类型应为 ${options.extensions.join(' / ')}`);
+    }
+  }
+  return path;
+}
+
+function run(command: string, args: string[], env?: NodeJS.ProcessEnv): Promise<string> {
+  return new Promise((resolveOutput, reject) => {
+    execFile(command, args, {
+      encoding: 'utf8',
+      env: env ? { ...process.env, ...env } : process.env,
+      maxBuffer: 64 * 1024,
+      windowsHide: true,
+    }, (error, stdout, stderr) => {
+      if (!error) {
+        resolveOutput(stdout);
+        return;
+      }
+      const failure = error as ExecFailure;
+      failure.stdout = stdout;
+      failure.stderr = stderr;
+      reject(failure);
+    });
+  });
+}
+
+function commandMissing(error: unknown): boolean {
+  return (error as ExecFailure | null)?.code === 'ENOENT';
+}
+
+function cancelled(error: unknown): boolean {
+  const failure = error as ExecFailure | null;
+  if (failure?.code === 1 && !failure.stderr?.trim()) return true;
+  return failure?.code === 1 && /user canceled|-128/i.test(failure.stderr ?? '');
+}
+
+async function initialDirectory(options: PathPickerOptions): Promise<string> {
+  const requested = options.currentPath?.trim() || options.recommendedDir?.trim();
+  if (!requested) return '';
+  let candidate = resolve(requested);
+  for (;;) {
+    try {
+      const info = await stat(candidate);
+      return info.isDirectory() ? candidate : dirname(candidate);
+    } catch {
+      const parent = dirname(candidate);
+      if (parent === candidate) return '';
+      candidate = parent;
+    }
+  }
+}
+
+function patterns(options: PathPickerOptions): string[] {
+  return (options.extensions ?? []).map((extension) => `*${extension}`);
+}
+
+const WINDOWS_SCRIPT = String.raw`
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+Add-Type -AssemblyName System.Windows.Forms
+$title = $env:CORTICO_PICKER_TITLE
+$initial = $env:CORTICO_PICKER_INITIAL
+if ($env:CORTICO_PICKER_KIND -eq 'directory') {
+  $dialog = New-Object System.Windows.Forms.FolderBrowserDialog
+  $dialog.Description = $title
+  $dialog.ShowNewFolderButton = $true
+  if ($initial -and [System.IO.Directory]::Exists($initial)) { $dialog.SelectedPath = $initial }
+} else {
+  $dialog = New-Object System.Windows.Forms.OpenFileDialog
+  $dialog.Title = $title
+  $dialog.CheckFileExists = $true
+  $dialog.Multiselect = $false
+  if ($initial -and [System.IO.Directory]::Exists($initial)) { $dialog.InitialDirectory = $initial }
+  $patterns = $env:CORTICO_PICKER_PATTERNS
+  if ($patterns) { $dialog.Filter = "支持的文件|$patterns|所有文件|*.*" }
+}
+if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {
+  if ($env:CORTICO_PICKER_KIND -eq 'directory') {
+    [Console]::Out.Write($dialog.SelectedPath)
+  } else {
+    [Console]::Out.Write($dialog.FileName)
+  }
+}
+$dialog.Dispose()
+`;
+
+async function pickWindows(options: PathPickerOptions, initial: string): Promise<string | null> {
+  try {
+    const stdout = await run('powershell.exe', [
+      '-NoProfile', '-STA', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command', WINDOWS_SCRIPT,
+    ], {
+      CORTICO_PICKER_KIND: options.kind,
+      CORTICO_PICKER_TITLE: options.title ?? (options.kind === 'file' ? '选择文件' : '选择目录'),
+      CORTICO_PICKER_INITIAL: initial,
+      CORTICO_PICKER_PATTERNS: patterns(options).join(';'),
+    });
+    return stdout.trim() || null;
+  } catch (error) {
+    throw new PathPickerUnavailableError(commandMissing(error)
+      ? '本机找不到 PowerShell，无法打开路径选择器'
+      : `无法打开本机路径选择器: ${String((error as Error).message ?? error)}`);
+  }
+}
+
+const MACOS_SCRIPT = String.raw`
+on run argv
+  set pickerKind to item 1 of argv
+  set dialogTitle to item 2 of argv
+  set initialPath to item 3 of argv
+  set extensionText to item 4 of argv
+  set AppleScript's text item delimiters to ","
+  set fileTypes to text items of extensionText
+  set AppleScript's text item delimiters to ""
+  if pickerKind is "directory" then
+    if initialPath is "" then
+      set picked to choose folder with prompt dialogTitle
+    else
+      set picked to choose folder with prompt dialogTitle default location (POSIX file initialPath)
+    end if
+  else if extensionText is "" then
+    if initialPath is "" then
+      set picked to choose file with prompt dialogTitle
+    else
+      set picked to choose file with prompt dialogTitle default location (POSIX file initialPath)
+    end if
+  else
+    if initialPath is "" then
+      set picked to choose file with prompt dialogTitle of type fileTypes
+    else
+      set picked to choose file with prompt dialogTitle of type fileTypes default location (POSIX file initialPath)
+    end if
+  end if
+  return POSIX path of picked
+end run
+`;
+
+async function pickMacos(options: PathPickerOptions, initial: string): Promise<string | null> {
+  try {
+    const extensions = (options.extensions ?? []).map((extension) => extension.slice(1)).join(',');
+    const stdout = await run('osascript', [
+      '-e', MACOS_SCRIPT, '--', options.kind,
+      options.title ?? (options.kind === 'file' ? '选择文件' : '选择目录'),
+      initial,
+      extensions,
+    ]);
+    return stdout.trim() || null;
+  } catch (error) {
+    if (cancelled(error)) return null;
+    throw new PathPickerUnavailableError(commandMissing(error)
+      ? '本机找不到 osascript，无法打开路径选择器'
+      : `无法打开本机路径选择器: ${String((error as Error).message ?? error)}`);
+  }
+}
+
+async function pickZenity(options: PathPickerOptions, initial: string): Promise<string | null> {
+  const args = ['--file-selection', `--title=${options.title ?? (options.kind === 'file' ? '选择文件' : '选择目录')}`];
+  if (options.kind === 'directory') args.push('--directory');
+  if (initial) args.push(`--filename=${initial}${sep}`);
+  const filter = patterns(options);
+  if (filter.length) args.push(`--file-filter=支持的文件 | ${filter.join(' ')}`);
+  const stdout = await run('zenity', args);
+  return stdout.trim() || null;
+}
+
+async function pickKdialog(options: PathPickerOptions, initial: string): Promise<string | null> {
+  const title = options.title ?? (options.kind === 'file' ? '选择文件' : '选择目录');
+  const filter = patterns(options);
+  const args = options.kind === 'directory'
+    ? ['--getexistingdirectory', initial || resolve('.'), '--title', title]
+    : [
+        '--getopenfilename', initial || resolve('.'),
+        filter.length ? `${filter.join(' ')}|支持的文件` : '*|所有文件',
+        '--title', title,
+      ];
+  const stdout = await run('kdialog', args);
+  return stdout.trim() || null;
+}
+
+async function pickLinux(options: PathPickerOptions, initial: string): Promise<string | null> {
+  let zenityError: unknown;
+  try {
+    return await pickZenity(options, initial);
+  } catch (error) {
+    if (cancelled(error)) return null;
+    zenityError = error;
+  }
+  try {
+    return await pickKdialog(options, initial);
+  } catch (error) {
+    if (cancelled(error)) return null;
+    const commandsMissing = commandMissing(zenityError) && commandMissing(error);
+    throw new PathPickerUnavailableError(commandsMissing
+      ? '本机没有可用的路径选择器；请安装 zenity 或 kdialog'
+      : `无法打开本机路径选择器: ${String((error as Error).message ?? error)}`);
+  }
+}
+
+export async function pickNativePath(options: PathPickerOptions): Promise<string | null> {
+  const initial = await initialDirectory(options);
+  if (platform === 'win32') return pickWindows(options, initial);
+  if (platform === 'darwin') return pickMacos(options, initial);
+  if (platform === 'linux') return pickLinux(options, initial);
+  throw new PathPickerUnavailableError(`当前平台不支持本机路径选择器: ${platform}`);
+}
+
+export const nativePathPicker: PathPicker = { pick: pickNativePath };

package/src/web/public/index.html

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>控制台 · Cortico</title>
+<meta name="theme-color" content="#f4f5f4">
+<link rel="stylesheet" href="/assets/styles.css">
+</head>
+<body>
+<!-- 服务端按构建清单在 body 末尾注入带内容 hash 的内核脚本。 -->
+<noscript>控制台需要 JavaScript。 The console needs JavaScript.</noscript>
+<div id="boot-note">
+  控制台正在载入…… Loading the console…
+</div>
+</body>
+</html>