Skip to content

A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.

TypeScript fluxerfluxerapp
10.7 KB
Raw Blame
// SPDX-License-Identifier: AGPL-3.0-or-later

import {remFromPx} from '@app/features/theme/layout/RemFromPx';
import * as ThemeSettingsCommands from '@app/features/theme_settings/commands/ThemeSettingsCommands';
import styles from '@app/features/theme_settings/components/QuickCssReference.module.css';
import {readOnScreenFlxValues, SEMANTIC_ATTRIBUTES} from '@app/features/theme_settings/editor/AppSelectors';
import EditorPreferences from '@app/features/theme_settings/editor/EditorPreferences';
import {isColorVariable, readDisplayVariableValue} from '@app/features/theme_settings/editor/ThemeVariableInfo';
import {getTokenGroupLabelDescriptor, TOKEN_GROUPS} from '@app/features/theme_settings/utils/TokenGroups';
import {MoreOptionsVerticalIcon} from '@app/features/ui/action_menu/ContextMenuIcons';
import {MenuGroup} from '@app/features/ui/action_menu/MenuGroup';
import {MenuItem} from '@app/features/ui/action_menu/MenuItem';
import * as ContextMenuCommands from '@app/features/ui/commands/ContextMenuCommands';
import {writeClipboardText} from '@app/features/ui/commands/TextCopyCommands';
import * as ToastCommands from '@app/features/ui/commands/ToastCommands';
import {Input} from '@app/features/ui/components/form/FormInput';
import {msg} from '@lingui/core/macro';
import {useLingui} from '@lingui/react/macro';
import {CopyIcon, MagnifyingGlassIcon, PlusIcon} from '@phosphor-icons/react';
import {observer} from 'mobx-react-lite';
import type React from 'react';
import {useMemo, useState} from 'react';

const COPY_DESCRIPTOR = msg({
	message: 'Copy',
	comment: 'Menu item on a CSS variable in the "Reference" tab of the quick CSS editor. Copies its name.',
});
const VARIABLES_DESCRIPTOR = msg({
	message: 'Variables',
	comment: 'Heading in the "Reference" tab of the quick CSS editor, above the list of CSS variables.',
});
const SELECTORS_DESCRIPTOR = msg({
	message: 'Selectors',
	comment: 'Heading in the "Reference" tab of the quick CSS editor, above the list of CSS selectors.',
});
const SEARCH_VARIABLES_DESCRIPTOR = msg({
	message: 'Search variables',
	comment: 'Placeholder of the search field in the "Reference" tab of the quick CSS editor.',
});
const SELECT_VARIABLE_HINT_DESCRIPTOR = msg({
	message: 'Select a variable to add it to your CSS.',
	comment: 'Shown above the list of CSS variables in the "Reference" tab of the quick CSS editor.',
});
const STABLE_ATTRIBUTES_DESCRIPTOR = msg({
	message: "These attributes don't change between Fluxer updates.",
	comment: 'Shown above the list of CSS attributes in the "Reference" tab of the quick CSS editor.',
});
const ON_SCREEN_DESCRIPTOR = msg({
	message: 'On screen now',
	comment:
		'Heading in the "Reference" tab of the quick CSS editor, above the [data-flx] values of what the app shows right now.',
});
const ON_SCREEN_HINT_DESCRIPTOR = msg({
	message: 'Select one to add a rule for it to your CSS.',
	comment: 'Shown above the [data-flx] values in the "Reference" tab of the quick CSS editor.',
});
const ADD_AN_OVERRIDE_DESCRIPTOR = msg({
	message: 'Add an override',
	comment: 'Menu item on a CSS variable in the "Reference" tab of the quick CSS editor. Adds a rule that changes it.',
});
const VARIABLE_OPTIONS_DESCRIPTOR = msg({
	message: 'More options for {name}',
	comment: 'Accessible label of the menu button on a CSS variable in the "Reference" tab of the quick CSS editor.',
});
const COPIED_DESCRIPTOR = msg({
	message: 'Copied {text}.',
	comment: 'Toast after copying a CSS variable name in the "Reference" tab of the quick CSS editor.',
});
const NO_VARIABLES_MATCH_DESCRIPTOR = msg({
	message: 'No variables match "{query}".',
	comment: 'Shown in the "Reference" tab of the quick CSS editor when the search finds nothing.',
});

function indent(): string {
	return EditorPreferences.indentWithTabs ? '\t' : ' '.repeat(EditorPreferences.tabSize);
}

const VariableRow: React.FC<{name: string}> = ({name}) => {
	const {i18n} = useLingui();
	const value = readDisplayVariableValue(name);
	const openMenu = (event: React.MouseEvent<HTMLButtonElement>) => {
		ContextMenuCommands.openFromElementBottomRight(event, ({onClose}) => {
			const select = (action: () => void) => () => {
				onClose();
				action();
			};
			return (
				<MenuGroup data-flx="theme-settings.quick-css-reference.variable-row.menu-group">
					<MenuItem
						icon={
							<CopyIcon size={remFromPx(16)} data-flx="theme-settings.quick-css-reference.variable-row.copy-icon" />
						}
						onClick={select(() => {
							void writeClipboardText(name).then(() => ToastCommands.success(i18n._(COPIED_DESCRIPTOR, {text: name})));
						})}
						data-flx="theme-settings.quick-css-reference.variable-row.copy"
					>
						{i18n._(COPY_DESCRIPTOR)}
					</MenuItem>
					<MenuItem
						icon={
							<PlusIcon size={remFromPx(16)} data-flx="theme-settings.quick-css-reference.variable-row.plus-icon" />
						}
						onClick={select(() =>
							ThemeSettingsCommands.insertIntoQuickCssEditor(`:root {\n${indent()}${name}: ${value};\n}\n`),
						)}
						data-flx="theme-settings.quick-css-reference.variable-row.add-override"
					>
						{i18n._(ADD_AN_OVERRIDE_DESCRIPTOR)}
					</MenuItem>
				</MenuGroup>
			);
		});
	};
	return (
		<li className={styles.row} data-flx="theme-settings.quick-css-reference.variable-row.row">
			<button
				type="button"
				className={styles.rowButton}
				onClick={() => ThemeSettingsCommands.insertIntoQuickCssEditor(`var(${name})`)}
				data-flx="theme-settings.quick-css-reference.variable-row.insert"
			>
				{isColorVariable(name) && value ? (
					<span
						className={styles.swatch}
						style={{background: value}}
						aria-hidden
						data-flx="theme-settings.quick-css-reference.variable-row.swatch"
					/>
				) : null}
				<span className={styles.name} data-flx="theme-settings.quick-css-reference.variable-row.name">
					{name}
				</span>
				<span className={styles.value} title={value} data-flx="theme-settings.quick-css-reference.variable-row.value">
					{value}
				</span>
			</button>
			<button
				type="button"
				className={styles.menuButton}
				aria-label={i18n._(VARIABLE_OPTIONS_DESCRIPTOR, {name})}
				onClick={openMenu}
				data-flx="theme-settings.quick-css-reference.variable-row.menu-button"
			>
				<MoreOptionsVerticalIcon
					size={16}
					data-flx="theme-settings.quick-css-reference.variable-row.more-options-icon"
				/>
			</button>
		</li>
	);
};

export const QuickCssReference: React.FC = observer(() => {
	const {i18n} = useLingui();
	const [search, setSearch] = useState('');
	const query = search.trim().toLowerCase();
	const groups = useMemo(
		() =>
			TOKEN_GROUPS.map((group) => {
				const descriptor = getTokenGroupLabelDescriptor(group.id);
				return {
					id: group.id,
					label: descriptor ? i18n._(descriptor) : group.fallbackLabel,
					variables: query ? group.variables.filter((name) => name.toLowerCase().includes(query)) : group.variables,
				};
			}).filter((group) => group.variables.length > 0),
		[query, i18n.locale],
	);
	const [onScreen] = useState(() => readOnScreenFlxValues());
	return (
		<div className={styles.root} data-flx="theme-settings.quick-css-reference.root">
			<section className={styles.section} data-flx="theme-settings.quick-css-reference.variables">
				<h2 className={styles.heading} data-flx="theme-settings.quick-css-reference.variables-heading">
					{i18n._(VARIABLES_DESCRIPTOR)}
				</h2>
				<p className={styles.hint} data-flx="theme-settings.quick-css-reference.variables-hint">
					{i18n._(SELECT_VARIABLE_HINT_DESCRIPTOR)}
				</p>
				<Input
					value={search}
					onChange={(event) => setSearch(event.target.value)}
					placeholder={i18n._(SEARCH_VARIABLES_DESCRIPTOR)}
					aria-label={i18n._(SEARCH_VARIABLES_DESCRIPTOR)}
					leftIcon={
						<MagnifyingGlassIcon
							size={remFromPx(16)}
							weight="bold"
							data-flx="theme-settings.quick-css-reference.magnifying-glass-icon"
						/>
					}
					data-flx="theme-settings.quick-css-reference.search"
				/>
				{groups.length === 0 ? (
					<p className={styles.hint} data-flx="theme-settings.quick-css-reference.no-match">
						{i18n._(NO_VARIABLES_MATCH_DESCRIPTOR, {query: search.trim()})}
					</p>
				) : null}
				{groups.map((group) => (
					<div key={group.id} className={styles.group} data-flx="theme-settings.quick-css-reference.group">
						<h3 className={styles.groupHeading} data-flx="theme-settings.quick-css-reference.group-heading">
							{group.label}
						</h3>
						<ul className={styles.list} data-flx="theme-settings.quick-css-reference.group-list">
							{group.variables.map((name) => (
								<VariableRow key={name} name={name} data-flx="theme-settings.quick-css-reference.variable-row" />
							))}
						</ul>
					</div>
				))}
			</section>
			<section className={styles.section} data-flx="theme-settings.quick-css-reference.selectors">
				<h2 className={styles.heading} data-flx="theme-settings.quick-css-reference.selectors-heading">
					{i18n._(SELECTORS_DESCRIPTOR)}
				</h2>
				<p className={styles.hint} data-flx="theme-settings.quick-css-reference.selectors-hint">
					{i18n._(STABLE_ATTRIBUTES_DESCRIPTOR)}
				</p>
				<ul className={styles.list} data-flx="theme-settings.quick-css-reference.attribute-list">
					{SEMANTIC_ATTRIBUTES.map((attribute) => (
						<li key={attribute.name} className={styles.row} data-flx="theme-settings.quick-css-reference.attribute-row">
							<button
								type="button"
								className={styles.rowButton}
								onClick={() => ThemeSettingsCommands.insertIntoQuickCssEditor(`[${attribute.name}]`)}
								data-flx="theme-settings.quick-css-reference.attribute-insert"
							>
								<span className={styles.name} data-flx="theme-settings.quick-css-reference.attribute-name">
									{attribute.name}
								</span>
								<span
									className={styles.description}
									data-flx="theme-settings.quick-css-reference.attribute-description"
								>
									{i18n._(attribute.description)}
								</span>
							</button>
						</li>
					))}
				</ul>
				<h3 className={styles.groupHeading} data-flx="theme-settings.quick-css-reference.on-screen-heading">
					{i18n._(ON_SCREEN_DESCRIPTOR)}
				</h3>
				<p className={styles.hint} data-flx="theme-settings.quick-css-reference.on-screen-hint">
					{i18n._(ON_SCREEN_HINT_DESCRIPTOR)}
				</p>
				<ul className={styles.chips} data-flx="theme-settings.quick-css-reference.on-screen-list">
					{onScreen.map((value) => (
						<li key={value} data-flx="theme-settings.quick-css-reference.on-screen-item">
							<button
								type="button"
								className={styles.code}
								onClick={() =>
									ThemeSettingsCommands.insertIntoQuickCssEditor(`[data-flx="${value}"] {\n${indent()}\n}\n`)
								}
								data-flx="theme-settings.quick-css-reference.on-screen-insert"
							>
								{value}
							</button>
						</li>
					))}
				</ul>
			</section>
		</div>
	);
});