fpasoterm 1.6.0

package/examples/config/default-appearance.toml

@@ -0,0 +1,36 @@
+# Default appearance config.
+# Apply from a running fpasoterm terminal with a POSIX shell:
+# printf '\033]777;config=/path/to/fpasoterm/examples/config/default-appearance.toml\a\r\n'
+# On Windows, use examples/apply-default-appearance.ps1 or .bat.
+
+[window]
+title = "fpasoterm"
+titlebarColor = "#1565c0"
+
+[terminal]
+lineHeight = 1
+# Preserve application-selected ANSI/RGB colors and block/box glyph art.
+minimumContrastRatio = 1
+rescaleOverlappingGlyphs = false
+backgroundOpacity = 0.65
+
+[terminal.theme]
+background = "rgba(16, 19, 23, 0.65)"
+foreground = "#e8edf2"
+cursor = "#f5d76e"
+selectionBackground = "#35506b"
+
+[keybindings]
+prefix = "Mod+Shift"
+logMenu = "L"
+logToggle = "S"
+logShow = "P"
+copy = "C"
+paste = "V"
+menu = "M"
+help = "H"
+newWindow = "N"
+broadcast = "B"
+kill = "K"
+tile = "T"
+closeAll = "X"

package/examples/config/minimal.toml

@@ -0,0 +1,30 @@
+# Minimal fpasoterm config example.
+# Copy this to ~/.config/fpasoterm/User/config.toml and edit as needed.
+
+[window]
+title = "fpasoterm"
+width = 1000
+height = 680
+titlebarColor = "#1565c0"
+
+[terminal]
+fontSize = 14
+lineHeight = 1
+minimumContrastRatio = 1
+rescaleOverlappingGlyphs = false
+backgroundOpacity = 0.65
+fontFamily = "\"DejaVu Sans Mono\", \"Noto Sans Mono CJK JP\", \"Noto Sans CJK JP\", \"BIZ UDGothic\", \"Hiragino Sans\", Meiryo, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace"
+termName = "xterm-256color"
+# Keep UTF-8 unless a legacy program explicitly emits Shift_JIS or EUC-JP.
+encoding = "utf-8"
+# Leave empty for the platform default shell.
+# Windows examples: "powershell.exe", "pwsh.exe", or "cmd.exe".
+shell = ""
+
+[keybindings]
+prefix = "Mod+Shift"
+newWindow = "N"
+tile = "T"
+
+[plugins]
+enabled = []

package/examples/config/profiles.toml

@@ -0,0 +1,20 @@
+# Apply this file with: fpasoterm --config ./examples/config/profiles.toml --profile large-font
+
+[window]
+title = "fpasoterm"
+titlebarColor = "#1565c0"
+
+[terminal]
+fontSize = 14
+backgroundOpacity = 0.65
+
+# Profiles override normal config sections for one launch. They do not modify
+# config.toml or User/window-state.json.
+[profiles.large-font.terminal]
+fontSize = 18
+
+[profiles.transparent.window]
+titlebarColor = "#00695c"
+
+[profiles.transparent.terminal]
+backgroundOpacity = 0.65

package/examples/config/runtime-appearance.toml

@@ -0,0 +1,24 @@
+# Runtime appearance test config.
+# Apply from a running fpasoterm terminal with a POSIX shell:
+# printf '\033]777;config=/path/to/fpasoterm/examples/config/runtime-appearance.toml\a\r\n'
+# On Windows, use examples/apply-runtime-appearance.ps1 or .bat.
+
+[window]
+title = "RUNTIME SAMPLE ACTIVE"
+titlebarColor = "#d81b60"
+
+# Uncomment these only when testing live window resizing.
+# width = 1180
+# height = 720
+
+[terminal]
+backgroundOpacity = 0.95
+
+# Uncomment this only when testing live font resizing.
+# fontSize = 18
+
+[terminal.theme]
+background = "#32004f"
+foreground = "#fff176"
+cursor = "#00e5ff"
+selectionBackground = "#7b1fa2"

package/examples/config/sync-folder.toml

@@ -0,0 +1,17 @@
+# Sync folder sample.
+# Use a local folder that is already synchronized by Google Drive for desktop
+# or another sync tool. fpasoterm does not call Google Drive APIs.
+
+[sync]
+enabled = true
+provider = "folder"
+path = "~/Google Drive/fpasoterm-sync"
+channel = "default"
+diagnostics = true
+maxBytes = 1048576
+
+[logging]
+enabled = true
+directory = "~/Google Drive/fpasoterm-sync/logs"
+autoStart = false
+maxBytes = 10485760

package/examples/config/tui-compatibility.toml

@@ -0,0 +1,7 @@
+# Preserve application-selected ANSI/RGB colors and tightly spaced glyph art.
+# Launch once with:
+#   fpasoterm --config examples/config/tui-compatibility.toml
+
+[terminal]
+minimumContrastRatio = 1
+rescaleOverlappingGlyphs = false

package/examples/config/with-plugins.toml

@@ -0,0 +1,33 @@
+# fpasoterm config example with TypeScript plugins enabled.
+# The plugin paths are relative to ~/.config/fpasoterm/User/.
+
+[window]
+title = "fpasoterm plugins"
+width = 1200
+height = 760
+titlebarColor = "#1565c0"
+
+[terminal]
+fontSize = 15
+lineHeight = 1
+minimumContrastRatio = 1
+rescaleOverlappingGlyphs = false
+backgroundOpacity = 0.65
+scrollback = 3000
+termName = "xterm-256color"
+# Keep UTF-8 unless a legacy program explicitly emits Shift_JIS or EUC-JP.
+encoding = "utf-8"
+# Leave empty for the platform default shell.
+# Windows examples: "powershell.exe", "pwsh.exe", or "cmd.exe".
+shell = ""
+
+[terminal.theme]
+background = "rgba(16, 19, 23, 0.65)"
+foreground = "#e8edf2"
+cursor = "#f5d76e"
+
+[plugins]
+enabled = [
+  "plugins/hello.ts",
+  "plugins/theme.ts",
+]

package/examples/plugins/hello.ts

@@ -0,0 +1,17 @@
+/// <reference path="../../docs/fpasoterm-plugin.d.ts" />
+// @fpasoterm-plugin version: 1.0.0
+// @fpasoterm-plugin description: Writes a confirmation after the terminal is ready.
+
+// This sample demonstrates the minimum plugin shape.
+// Wait for the PTY before writing, so shell initialization cannot erase it.
+const api = window.fpasotermPluginApi;
+
+api.log('hello.ts loaded');
+api.registerCommand('hello.show', 'Show Hello Banner', () => {
+  api.terminal.writeln('[fpasoterm plugin] hello.ts loaded');
+  api.terminal.focus();
+});
+api.onReady(() => {
+  api.terminal.writeln('');
+  api.terminal.writeln('[fpasoterm plugin] hello.ts loaded');
+});

package/examples/plugins/status-banner.ts

@@ -0,0 +1,14 @@
+/// <reference path="../../docs/fpasoterm-plugin.d.ts" />
+// @fpasoterm-plugin version: 1.0.0
+// @fpasoterm-plugin description: Adds a Plugins menu command that prints terminal status.
+
+// Registers a menu action that shows resolved settings after startup.
+const api = window.fpasotermPluginApi;
+const { width, height } = api.config.window;
+const enabledCount = api.config.plugins.enabled.length;
+
+api.log(`status-banner.ts loaded for ${width}x${height}, plugins=${enabledCount}`);
+api.registerCommand('status-banner.show', 'Show Plugin Status', () => {
+  api.terminal.writeln(`[fpasoterm] Status: ${width}x${height}, enabled plugins: ${enabledCount}.`);
+  api.terminal.focus();
+});

package/examples/plugins/theme.ts

@@ -0,0 +1,32 @@
+/// <reference path="../../docs/fpasoterm-plugin.d.ts" />
+// @fpasoterm-plugin version: 1.0.0
+// @fpasoterm-plugin description: Applies the visible teal sample terminal palette.
+
+// This sample applies a visibly different terminal palette after startup.
+// Use config.toml for normal settings; use plugins for temporary behavior changes.
+const api = window.fpasotermPluginApi;
+
+function applyTealTheme() {
+  api.terminal.options.theme = {
+    ...api.config.terminal.theme,
+    background: 'rgba(8, 42, 48, 0.86)',
+    foreground: '#d8f6f3',
+    cursor: '#ffdc73',
+    selectionBackground: '#246b73',
+    blue: '#75c9ff',
+    cyan: '#73e6dd',
+    green: '#a9df7d',
+  };
+  api.fitAddon.fit();
+}
+
+api.log('theme.ts loaded: applying the teal sample palette');
+api.registerCommand('theme.apply-teal', 'Apply Teal Theme', () => {
+  applyTealTheme();
+  api.terminal.writeln('[fpasoterm plugin] theme.ts applied the teal sample palette.');
+  api.terminal.focus();
+});
+applyTealTheme();
+api.onReady(() => {
+  api.terminal.writeln('[fpasoterm plugin] theme.ts applied the teal sample palette.');
+});

package/examples/plugins/welcome-banner.ts

@@ -0,0 +1,16 @@
+/// <reference path="../../docs/fpasoterm-plugin.d.ts" />
+// @fpasoterm-plugin version: 1.0.0
+// @fpasoterm-plugin description: Displays a local welcome banner after startup.
+
+// Shows a small, local-only startup message after the PTY is ready.
+const api = window.fpasotermPluginApi;
+
+api.log('welcome-banner.ts loaded');
+api.registerCommand('welcome-banner.show', 'Show Welcome Banner', () => {
+  api.terminal.writeln(`[fpasoterm ${api.version}] Welcome banner plugin is active.`);
+  api.terminal.focus();
+});
+api.onReady(() => {
+  api.terminal.writeln('');
+  api.terminal.writeln(`[fpasoterm ${api.version}] Welcome banner plugin is active.`);
+});

package/extra/linux/io.github.oyoguhito.fpasoterm.desktop

@@ -0,0 +1,10 @@
+[Desktop Entry]
+Type=Application
+Name=fpasoterm
+Comment=Cross-platform terminal with Japanese IME support
+Exec=fpasoterm
+Icon=io.github.oyoguhito.fpasoterm
+Terminal=false
+Categories=System;TerminalEmulator;
+StartupNotify=true
+StartupWMClass=fpasoterm

package/extra/windows/fpasoterm.cmd

@@ -0,0 +1,40 @@
+@echo off
+setlocal DisableDelayedExpansion
+set "FPASOTERM_ARGS=%*"
+
+rem Console wrapper for the GUI-subsystem fpasoterm.exe beside this file.
+rem CLI operations run as a direct child so output and exit codes return to the
+rem invoking PowerShell/cmd console; normal launches remain detached.
+set "FPASOTERM_EXE=%~dp0fpasoterm.exe"
+if not exist "%FPASOTERM_EXE%" (
+  echo fpasoterm: executable not found: "%FPASOTERM_EXE%" 1>&2
+  exit /b 1
+)
+
+:scan
+if "%~1"=="" goto run
+for %%F in (
+  --help -h --version -v --update-check --doctor --list -l --close -q --show-config
+  --completion --completion-install --completion-uninstall
+  --profile-list --config-check --config-path --config-example
+  --diagnostics --open-log-dir --copy-diagnostics
+  --plugin-list --plugin-path --plugin-info --plugin-uninstall --plugin-search --plugin-install
+  --plugin-ports-dir --plugin-install-file
+  --force --enable
+  --enable-plugin --disable-plugin --plugin-enable --plugin-disable
+  --plugin-enable-all --plugin-disable-all
+  --reset-window-state -r --reset-config -R --update-config --prune-config
+  --setup-sync --foreground -F
+  --broadcast --broadcast-target --broadcast-sync
+) do if /I "%~1"=="%%F" set "FPASOTERM_WAIT=1"
+shift
+goto scan
+
+:run
+if defined FPASOTERM_WAIT (
+  call "%FPASOTERM_EXE%" %FPASOTERM_ARGS%
+  exit /b %ERRORLEVEL%
+)
+
+start "" "%FPASOTERM_EXE%" %FPASOTERM_ARGS%
+exit /b 0

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "fpasoterm",
+  "version": "1.6.0",
+  "description": "Cross-platform terminal with Japanese IME support.",
+  "license": "MIT",
+  "homepage": "https://github.com/oyoguhito/fpasoterm#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oyoguhito/fpasoterm.git"
+  },
+  "bugs": {
+    "url": "https://github.com/oyoguhito/fpasoterm/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "terminal",
+    "xterm",
+    "ime",
+    "japanese",
+    "chromeos"
+  ],
+  "bin": {
+    "fpasoterm": "bin/fpasoterm"
+  },
+  "files": [
+    "bin/",
+    "completions/",
+    "docs/",
+    "examples/",
+    "extra/",
+    "scripts/",
+    "src/",
+    "src-tauri/Cargo.lock",
+    "src-tauri/Cargo.toml",
+    "src-tauri/build.rs",
+    "src-tauri/capabilities/",
+    "src-tauri/default-config.toml",
+    "src-tauri/src/",
+    "src-tauri/tauri.conf.json",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "INSTALL.md",
+    "INSTALL.ja.md",
+    "README.md",
+    "README.ja.md",
+    "LICENSE",
+    "package.json",
+    "package-lock.json"
+  ],
+  "scripts": {
+    "start": "node ./bin/fpasoterm",
+    "tauri": "tauri",
+    "dev": "tauri dev",
+    "build": "tauri build",
+    "check": "npm run check:syntax && npm test && cargo check --manifest-path src-tauri/Cargo.toml",
+    "check:syntax": "node --check bin/fpasoterm && node --check scripts/uninstall-desktop.js && node --check scripts/uninstall-windows-path.js && node --check src/config.js && node --check src/renderer/renderer.js",
+    "test": "node scripts/tests/smoke.js",
+    "scan:secrets": "node scripts/security/scan-secrets.js",
+    "security": "npm run scan:secrets && npm run audit:prod",
+    "audit:prod": "npm audit --omit=dev",
+    "generate:icons": "node scripts/generate-icon.js",
+    "install:desktop": "node scripts/install-linux-desktop.js",
+    "update:desktop": "node scripts/install-linux-desktop.js",
+    "uninstall:desktop": "node scripts/uninstall-desktop.js",
+    "build:artifacts": "node scripts/build-artifacts.js",
+    "build:bundles": "node scripts/build-artifacts.js --bundles-only"
+  },
+  "dependencies": {
+    "@tauri-apps/api": "^2.11.1",
+    "@tauri-apps/cli": "^2.11.4",
+    "@tauri-apps/plugin-notification": "^2.3.3",
+    "@xterm/addon-fit": "0.12.0-beta.288",
+    "@xterm/addon-image": "0.10.0-beta.288",
+    "@xterm/addon-web-links": "0.12.0",
+    "@xterm/xterm": "6.1.0-beta.288",
+    "smol-toml": "^1.4.2",
+    "typescript": "^5.9.3"
+  }
+}

package/scripts/build-artifacts.js

@@ -0,0 +1,183 @@
+const childProcess = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const root = path.resolve(__dirname, '..');
+const artifactsDir = path.join(root, 'artifacts');
+const npmCacheDir = path.join(artifactsDir, '.npm-cache');
+const packageJson = require(path.join(root, 'package.json'));
+const version = packageJson.version;
+const args = new Set(process.argv.slice(2));
+const sourceOnly = args.has('--source-only');
+const bundlesOnly = args.has('--bundles-only');
+const artifactLabel = process.env.FPASOTERM_ARTIFACT_LABEL || '';
+if (sourceOnly && bundlesOnly) {
+  throw new Error('Use only one of --source-only or --bundles-only');
+}
+const packageEntries = [
+  'bin',
+  'docs',
+  'examples',
+  'extra',
+  'scripts',
+  'src',
+  'src-tauri',
+  'CHANGELOG.md',
+  'CONTRIBUTING.md',
+  'INSTALL.md',
+  'README.md',
+  'LICENSE',
+  'package.json',
+  'package-lock.json',
+];
+
+// Resolves npm through its JavaScript entry point when available. This avoids
+// invoking npm.cmd through a shell on Windows, which Node deprecates (DEP0190).
+function npmInvocation(args) {
+  const bundledNpmCli = path.join(path.dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js');
+  const npmCli = [process.env.npm_execpath, bundledNpmCli].find((candidate) => candidate && fs.existsSync(candidate));
+  if (npmCli) {
+    return { command: process.execPath, args: [npmCli, ...args] };
+  }
+  return { command: process.platform === 'win32' ? 'npm.cmd' : 'npm', args };
+}
+
+// Runs packaging commands from the repository root with an artifact-local npm cache.
+function run(command, args, options = {}) {
+  const invocation = command === 'npm' ? npmInvocation(args) : { command, args };
+  const result = childProcess.spawnSync(invocation.command, invocation.args, {
+    cwd: root,
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      npm_config_cache: npmCacheDir,
+      npm_config_audit: 'false',
+      npm_config_fund: 'false',
+      npm_config_update_notifier: 'false',
+      NO_UPDATE_NOTIFIER: '1',
+    },
+    ...options,
+  });
+
+  if (result.error) {
+    throw result.error;
+  }
+
+  if (result.status !== 0) {
+    throw new Error(`${command} ${args.join(' ')} exited with status ${result.status}`);
+  }
+}
+
+// Copies source entries while excluding generated or dependency directories.
+function copyEntry(entry, targetRoot) {
+  fs.cpSync(path.join(root, entry), path.join(targetRoot, entry), {
+    recursive: true,
+    filter: (source) => {
+      const relative = path.relative(root, source).replaceAll('\\', '/');
+      return ![
+        'artifacts',
+        'node_modules',
+        'src-tauri/target',
+      ].some((ignored) => relative === ignored || relative.startsWith(`${ignored}/`));
+    },
+  });
+}
+
+// Adds the CI platform label to release assets so macOS/Windows bundle names do
+// not collide when every matrix artifact is uploaded to the same GitHub Release.
+function labelArtifactName(fileName) {
+  if (!artifactLabel) {
+    return fileName;
+  }
+  const parsed = path.parse(fileName);
+  return `${parsed.name}-${artifactLabel}${parsed.ext}`;
+}
+
+// Places a console-subsystem wrapper next to the Windows GUI executable. It
+// waits for CLI-only operations so PowerShell redraws its prompt on completion.
+function copyWindowsCommandWrapper() {
+  if (process.platform !== 'win32') {
+    return;
+  }
+  const wrapper = path.join(root, 'extra', 'windows', 'fpasoterm.cmd');
+  const releaseDir = path.join(root, 'src-tauri', 'target', 'release');
+  if (!fs.existsSync(wrapper) || !fs.existsSync(path.join(releaseDir, 'fpasoterm.exe'))) {
+    return;
+  }
+  fs.copyFileSync(wrapper, path.join(releaseDir, 'fpasoterm.cmd'));
+  fs.copyFileSync(wrapper, path.join(artifactsDir, labelArtifactName(`fpasoterm-${version}-windows-cli.cmd`)));
+}
+
+fs.rmSync(artifactsDir, { recursive: true, force: true });
+fs.mkdirSync(artifactsDir, { recursive: true });
+
+if (!bundlesOnly) {
+  const npmPackageRoot = path.join(artifactsDir, 'package');
+  fs.mkdirSync(npmPackageRoot, { recursive: true });
+  for (const entry of packageEntries) {
+    copyEntry(entry, npmPackageRoot);
+  }
+  run('tar', ['-czf', `fpasoterm-${version}.tgz`, 'package'], {
+    cwd: artifactsDir,
+  });
+  fs.rmSync(npmPackageRoot, { recursive: true, force: true });
+}
+
+if (!sourceOnly) {
+  const buildArgs = ['run', 'build'];
+  if (process.platform === 'linux') {
+    // AppImage bundling is unstable in some ChromeOS/Baguette and CI
+    // environments. Build the Linux package formats that are currently
+    // reproducible, and keep the source archives platform-independent.
+    buildArgs.push('--', '--bundles', 'deb,rpm');
+  }
+  run('npm', buildArgs);
+  copyWindowsCommandWrapper();
+
+  const bundleDir = path.join(root, 'src-tauri', 'target', 'release', 'bundle');
+  if (fs.existsSync(bundleDir)) {
+    const copyBundles = (directory) => {
+      for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        const entryPath = path.join(directory, entry.name);
+        if (entry.isDirectory()) {
+          if (entry.name.endsWith('.app')) {
+            const appArchive = `${entry.name.replace(/\.app$/, '')}-${version}-${artifactLabel || process.arch}.app.tar.gz`;
+            run('tar', ['-czf', path.join(artifactsDir, appArchive), entry.name], {
+              cwd: directory,
+            });
+          } else {
+            copyBundles(entryPath);
+          }
+        } else if (
+          entry.isFile()
+          && ['.deb', '.rpm', '.dmg', '.msi', '.exe'].includes(path.extname(entry.name))
+          && entry.name.includes(version)
+        ) {
+          fs.copyFileSync(entryPath, path.join(artifactsDir, labelArtifactName(entry.name)));
+        }
+      }
+    };
+    copyBundles(bundleDir);
+  }
+}
+
+let portableRoot;
+if (!bundlesOnly) {
+  const portableName = `fpasoterm-${version}-source-portable`;
+  portableRoot = path.join(artifactsDir, portableName);
+  fs.mkdirSync(portableRoot, { recursive: true });
+
+  for (const entry of packageEntries) {
+    copyEntry(entry, portableRoot);
+  }
+
+  run('tar', ['-czf', `${portableName}.tar.gz`, portableName], {
+    cwd: artifactsDir,
+  });
+}
+
+if (portableRoot) {
+  fs.rmSync(portableRoot, { recursive: true, force: true });
+}
+fs.rmSync(npmCacheDir, { recursive: true, force: true });
+console.log(`Artifacts written to ${artifactsDir}`);