[Init] Initial commit - NetMesh terminal manager

infrastructure/config/fonts.ts

@@ -0,0 +1,178 @@
+/**
+ * Terminal Fonts Configuration
+ *
+ * `family` is the raw CSS font-family string for the Latin glyphs only.
+ * CJK and icon fallbacks are composed at runtime by composeFontFamilyStack()
+ * in cjkFonts.ts, which lets users pick the CJK font independently or have
+ * one chosen automatically per Latin font.
+ */
+
+export interface TerminalFont {
+  id: string;
+  name: string;
+  family: string;
+  description: string;
+  category: 'monospace' | 'proportional';
+}
+
+const BASE_TERMINAL_FONTS: TerminalFont[] = [
+  // Existing Latin monospace fonts (ids unchanged for sync compatibility)
+  { id: 'menlo',            name: 'Menlo',            family: 'Menlo, monospace',                description: 'macOS system font, clean and professional', category: 'monospace' },
+  { id: 'monaco',           name: 'Monaco',           family: 'Monaco, monospace',               description: 'Classic monospace, excellent readability', category: 'monospace' },
+  { id: 'consolas',         name: 'Consolas',         family: 'Consolas, monospace',             description: 'Windows-style monospace, clear and compact', category: 'monospace' },
+  { id: 'courier-new',      name: 'Courier New',      family: '"Courier New", monospace',        description: 'Classic typewriter style, universal support', category: 'monospace' },
+  { id: 'source-code-pro',  name: 'Source Code Pro',  family: '"Source Code Pro", monospace',    description: "Adobe's professional programming font", category: 'monospace' },
+  { id: 'fira-code',        name: 'Fira Code',        family: '"Fira Code", monospace',          description: 'Monospace font with programming ligatures', category: 'monospace' },
+  { id: 'fira-mono',        name: 'Fira Mono',        family: '"Fira Mono", monospace',          description: 'Clean monospace without ligatures', category: 'monospace' },
+  { id: 'inconsolata',      name: 'Inconsolata',      family: 'Inconsolata, monospace',          description: 'Elegant and readable monospace font', category: 'monospace' },
+  { id: 'dejavu-sans-mono', name: 'DejaVu Sans Mono', family: '"DejaVu Sans Mono", monospace',   description: 'Wide character support, very readable', category: 'monospace' },
+  { id: 'liberation-mono',  name: 'Liberation Mono',  family: '"Liberation Mono", monospace',    description: 'Open source monospace font, Courier alternative', category: 'monospace' },
+  { id: 'jetbrains-mono',   name: 'JetBrains Mono',   family: '"JetBrains Mono", monospace',     description: 'Professional font designed for IDEs', category: 'monospace' },
+  { id: 'victor-mono',      name: 'Victor Mono',      family: '"Victor Mono", monospace',        description: 'Stylish monospace with italic support', category: 'monospace' },
+  { id: 'cascadia-code',    name: 'Cascadia Code',    family: '"Cascadia Code", monospace',      description: "Microsoft's modern monospace font", category: 'monospace' },
+  { id: 'cascadia-mono',    name: 'Cascadia Mono',    family: '"Cascadia Mono", monospace',      description: 'Cascadia without ligatures', category: 'monospace' },
+  { id: 'droid-sans-mono',  name: 'Droid Sans Mono',  family: '"Droid Sans Mono", monospace',    description: "Google's Droid monospace font", category: 'monospace' },
+  { id: 'ubuntu-mono',      name: 'Ubuntu Mono',      family: '"Ubuntu Mono", monospace',        description: "Ubuntu's official monospace font", category: 'monospace' },
+  { id: 'roboto-mono',      name: 'Roboto Mono',      family: '"Roboto Mono", monospace',        description: "Google's Roboto monospace variant", category: 'monospace' },
+  { id: 'ibm-plex-mono',    name: 'IBM Plex Mono',    family: '"IBM Plex Mono", monospace',      description: "IBM's professional monospace font", category: 'monospace' },
+  { id: 'space-mono',       name: 'Space Mono',       family: '"Space Mono", monospace',         description: 'Geometric monospace with strong personality', category: 'monospace' },
+  { id: 'input-mono',       name: 'Input Mono',       family: '"Input Mono", monospace',         description: 'Designed specifically for coding', category: 'monospace' },
+  { id: 'hack',             name: 'Hack',             family: 'Hack, monospace',                 description: 'Designed for source code, excellent in terminals', category: 'monospace' },
+  { id: 'anonymous-pro',    name: 'Anonymous Pro',    family: '"Anonymous Pro", monospace',      description: 'Designed for coding and terminal use', category: 'monospace' },
+  { id: 'programmer-fonts', name: 'Programmer Fonts', family: '"Programmer Fonts", monospace',   description: 'Optimized for programming with clear glyphs', category: 'monospace' },
+  { id: 'pt-mono',          name: 'PT Mono',          family: '"PT Mono", monospace',            description: "ParaType's monospace font", category: 'monospace' },
+  { id: 'iosevka',          name: 'Iosevka',          family: 'Iosevka, monospace',              description: 'Highly customizable monospace font', category: 'monospace' },
+  { id: 'ioskeley-mono',    name: 'Ioskeley Mono',    family: '"Ioskeley Mono", monospace',      description: 'Iosevka variant mimicking Berkeley Mono style', category: 'monospace' },
+  { id: 'mononoki',         name: 'Mononoki',         family: 'Mononoki, monospace',             description: 'Crisp and clear monospace with ligatures', category: 'monospace' },
+  { id: 'go-mono',          name: 'Go Mono',          family: '"Go Mono", monospace',            description: "Google Go's monospace font", category: 'monospace' },
+  { id: 'overpass-mono',    name: 'Overpass Mono',    family: '"Overpass Mono", monospace',      description: 'Open source monospace with good coverage', category: 'monospace' },
+
+  // True monospace CJK-coverage fonts only. PingFang SC and Microsoft
+  // YaHei UI (the OS system fonts) are deliberately omitted — they are
+  // proportional sans-serif designs whose Latin glyphs render with
+  // variable widths and whose CJK glyphs don't fit a terminal's 2x cell
+  // grid. Picking one as the primary font produced visibly bloated
+  // spacing for ASCII characters in #931.
+  { id: 'sarasa-mono-sc',   name: 'Sarasa Mono SC',   family: '"Sarasa Mono SC", monospace',   description: 'Iosevka + Source Han Sans (Simplified Chinese), 2:1 monospace', category: 'monospace' },
+  { id: 'sarasa-mono-tc',   name: 'Sarasa Mono TC',   family: '"Sarasa Mono TC", monospace',   description: 'Iosevka + Source Han Sans (Traditional Chinese), 2:1 monospace', category: 'monospace' },
+  { id: 'maple-mono-cn',    name: 'Maple Mono CN',    family: '"Maple Mono CN", monospace',    description: 'Maple Mono with unified Latin + Simplified Chinese metrics', category: 'monospace' },
+  { id: 'lxgw-wenkai-mono', name: 'LXGW WenKai Mono', family: '"LXGW WenKai Mono", monospace', description: 'Monospace Kaishu (regular-script) derived from Fontworks Klee One', category: 'monospace' },
+];
+
+export const TERMINAL_FONTS: TerminalFont[] = BASE_TERMINAL_FONTS;
+
+export const DEFAULT_FONT_SIZE = 14;
+export const MIN_FONT_SIZE = 10;
+export const MAX_FONT_SIZE = 32;
+
+export type FontPlatform = 'darwin' | 'win32' | 'linux' | (string & {});
+
+/**
+ * The default terminal font id for a given OS. Chosen so the primary
+ * Latin glyphs render with a font that ships with the OS — avoiding the
+ * cold-start cell-misalignment in #1647, where a bundled webfont
+ * (JetBrains Mono, font-display: swap) swapped in *after* xterm measured
+ * the cell grid and left ASCII garbled until a manual window resize.
+ *
+ *   - darwin: Menlo is a macOS system font (instant, no swap).
+ *   - win32:  Consolas ships with every Windows since Vista.
+ *   - linux:  DejaVu Sans Mono is the most widely pre-installed Linux
+ *             monospace; if a given distro lacks it, the runtime font-ready
+ *             remeasure (useTerminalEffects) still recovers any swap.
+ *
+ * Unknown platforms fall back to the macOS default.
+ */
+export function getDefaultTerminalFontIdForPlatform(platform: FontPlatform): string {
+  if (platform === 'win32') return 'consolas';
+  if (platform === 'linux') return 'dejavu-sans-mono';
+  return 'menlo';
+}
+
+/**
+ * Normalize a `navigator.platform` string to the coarse OS buckets used
+ * by getDefaultTerminalFontIdForPlatform. Mirrors the detection already
+ * used for the CJK fallback stack in Terminal.tsx (Mac/Win regex on
+ * navigator.platform); anything else — including Linux — is `linux`.
+ */
+export function detectFontPlatform(navigatorPlatform: string): FontPlatform {
+  if (/Win/i.test(navigatorPlatform)) return 'win32';
+  if (/Mac|iPhone|iPad|iPod/i.test(navigatorPlatform)) return 'darwin';
+  return 'linux';
+}
+
+/**
+ * The stored sentinel meaning "follow the OS default font". It is
+ * persisted and cloud-synced as-is (platform-neutral), so each device
+ * resolves it to its own locally-installed default at render time —
+ * unlike a concrete platform id, which would leak one OS's font to
+ * another via sync and reintroduce #1647 on the receiving machine.
+ */
+export const TERMINAL_FONT_AUTO = 'auto';
+
+/**
+ * Resolve a stored terminal font id to a concrete font id. The `auto`
+ * sentinel (and any empty/nullish value) resolves to the per-platform
+ * default; an explicit user choice is returned unchanged.
+ */
+export function resolveTerminalFontFamilyId(
+  id: string | null | undefined,
+  navigatorPlatform: string,
+): string {
+  if (id && id !== TERMINAL_FONT_AUTO) return id;
+  return getDefaultTerminalFontIdForPlatform(detectFontPlatform(navigatorPlatform));
+}
+
+/**
+ * Whether two terminal font ids resolve to the same concrete font on this
+ * platform. Font pickers display the resolved concrete font for an `auto`
+ * value, so a click on the shown default arrives as that concrete id while
+ * the stored value is still `auto`; comparing raw would treat it as a
+ * change and pin a per-OS font (which then syncs across devices). Comparing
+ * resolved ids makes that click a correct no-op.
+ */
+export function isSameResolvedTerminalFont(
+  a: string | null | undefined,
+  b: string | null | undefined,
+  navigatorPlatform: string,
+): boolean {
+  return (
+    resolveTerminalFontFamilyId(a, navigatorPlatform) ===
+    resolveTerminalFontFamilyId(b, navigatorPlatform)
+  );
+}
+
+// Font ids that earlier versions of netcatty exposed in the primary font
+// dropdown but that are proportional (non-monospace) and produce broken
+// cell-grid alignment when used as a terminal font. Reads should migrate
+// these to a sane default.
+const DEPRECATED_PRIMARY_FONT_IDS = new Set<string>([
+  'pingfang-sc',
+  'microsoft-yahei',
+  'comic-sans-ms',
+]);
+
+export function isDeprecatedPrimaryFontId(fontId: string | null | undefined): boolean {
+  return !!fontId && DEPRECATED_PRIMARY_FONT_IDS.has(fontId);
+}
+
+/**
+ * In-place migration for any object carrying `fontFamily` /
+ * `fontFamilyOverride` (Host, GroupConfig). When the saved id is one
+ * we've since removed from TERMINAL_FONTS, drop the override so the
+ * record inherits the global default rather than silently rendering
+ * "fallback to fonts[0]" while still claiming an override is active.
+ *
+ * Returns the (possibly new) value to assign back. Caller decides
+ * whether to mutate or copy; both are safe with this shape.
+ */
+export function migrateDeprecatedFontOverride<
+  T extends { fontFamily?: string; fontFamilyOverride?: boolean },
+>(record: T): T {
+  if (!isDeprecatedPrimaryFontId(record.fontFamily)) return record;
+  const next = { ...record };
+  delete next.fontFamily;
+  if (next.fontFamilyOverride === true) {
+    next.fontFamilyOverride = false;
+  }
+  return next;
+}