Files
Netcatty/components/settings/TerminalCjkFontSelect.tsx
T
陈大猫 3c393380e5 feat(settings): support local CJK fonts (#2267)
* feat(settings): support local CJK fonts

* refactor: move CJK font rules to domain

* fix(settings): improve CJK font preview safety

* fix(settings): refresh local font previews

* fix(settings): improve font picker keyboard behavior

* fix(settings): handle unavailable font detection

* fix(settings): cover font picker edge cases

* fix(settings): quote custom font families safely
2026-07-17 11:57:23 +08:00

148 lines
4.8 KiB
TypeScript

import React, { useEffect, useMemo, useState } from 'react';
import { AlertTriangle, RefreshCw } from 'lucide-react';
import { useI18n } from '../../application/i18n/I18nProvider';
import {
refreshFonts,
useFontsLoading,
useInstalledFontFamilies,
} from '../../application/state/fontStore';
import { isFontInstalled } from '../../lib/fontAvailability';
import { cn } from '../../lib/utils';
import { Button } from '../ui/button';
import { Combobox, type ComboboxOption } from '../ui/combobox';
import {
buildTerminalCjkFontOptions,
getTerminalCjkFontSelectionStatus,
RECOMMENDED_CJK_FONT_FAMILIES,
type TerminalCjkFontOptionKind,
} from '../../domain/terminalCjkFonts';
const previewFontFamily = (family: string): string | undefined => {
const trimmed = family.trim();
if (!trimmed) return undefined;
const escaped = trimmed.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
return `"${escaped}", monospace`;
};
interface Props {
value: string;
onChange: (next: string) => void;
className?: string;
disabled?: boolean;
}
export const TerminalCjkFontSelect: React.FC<Props> = ({
value,
onChange,
className,
disabled,
}) => {
const { t } = useI18n();
const installedFamilies = useInstalledFontFamilies();
const isLoading = useFontsLoading();
const [previewValue, setPreviewValue] = useState(value);
useEffect(() => {
setPreviewValue(value);
}, [value]);
const availableRecommendedFamilies = RECOMMENDED_CJK_FONT_FAMILIES.filter(
(family) => isFontInstalled(family),
);
const options = useMemo<ComboboxOption[]>(() => {
const built = buildTerminalCjkFontOptions({
installedFamilies,
selectedValue: value,
availableRecommendedFamilies,
});
const kindLabels: Record<TerminalCjkFontOptionKind, string> = {
auto: '',
recommended: t('settings.terminal.font.cjk.option.recommended'),
installed: t('settings.terminal.font.cjk.option.installed'),
unverified: t('settings.terminal.font.cjk.option.unverified'),
unavailable: t('settings.terminal.font.cjk.option.unavailable'),
};
return built.map((option) => {
const label = option.kind === 'auto'
? t('settings.terminal.font.cjk.option.auto')
: option.value.trim();
return {
value: option.value,
label,
sublabel: kindLabels[option.kind] || undefined,
labelStyle: option.value
? { fontFamily: previewFontFamily(option.value) }
: undefined,
};
});
}, [availableRecommendedFamilies, installedFamilies, t, value]);
const previewSelection = previewValue.trim();
const status = getTerminalCjkFontSelectionStatus(
previewSelection,
installedFamilies,
availableRecommendedFamilies,
Boolean(previewSelection && isFontInstalled(previewSelection)),
);
const selectedFontFamily = previewFontFamily(value);
const previewFamily = previewFontFamily(previewValue);
return (
<div className={cn('space-y-2', className)}>
<div className="flex items-center gap-2">
<Combobox
options={options}
value={value}
onValueChange={onChange}
placeholder={t('settings.terminal.font.cjk.searchPlaceholder')}
emptyText={t('settings.terminal.font.cjk.empty')}
allowCreate
createText={t('settings.terminal.font.cjk.useCustom')}
triggerClassName="h-9"
inputStyle={{ fontFamily: selectedFontFamily }}
onInputValueChange={setPreviewValue}
disabled={disabled}
/>
<Button
type="button"
variant="outline"
size="icon"
className="h-9 w-9 shrink-0"
aria-label={t('settings.terminal.font.cjk.refresh')}
title={t('settings.terminal.font.cjk.refresh')}
disabled={disabled || isLoading}
onClick={() => void refreshFonts()}
>
<RefreshCw size={14} className={cn(isLoading && 'animate-spin')} />
</Button>
</div>
{previewValue.trim() && (
<pre
className="overflow-hidden rounded-md border border-border/60 bg-muted/30 px-3 py-2 text-sm leading-5"
style={{ fontFamily: previewFamily }}
>
{'你好 │ ABC │ 123\n123 │ 测试 │ ABC'}
</pre>
)}
{status === 'alignment-risk' && (
<p className="flex items-start gap-1.5 text-xs text-amber-600 dark:text-amber-400">
<AlertTriangle size={13} className="mt-0.5 shrink-0" />
<span>{t('settings.terminal.font.cjk.alignmentWarning')}</span>
</p>
)}
{status === 'unavailable' && (
<p className="flex items-start gap-1.5 text-xs text-muted-foreground">
<AlertTriangle size={13} className="mt-0.5 shrink-0" />
<span>{t('settings.terminal.font.cjk.unavailableWarning')}</span>
</p>
)}
</div>
);
};
export default TerminalCjkFontSelect;