Download CLI
Установка через команду — вариант download-panel для инструмента разработчика: файлы никто не скачивает, ставят пакетным менеджером. Переключатели brew/winget/apt/npm (role=group + aria-pressed, не вкладки — все достижимы Tab'ом), терминальная строка с копированием: $ исключён и из выделения, и из копии.
Редактируемые поля
Секция «download». Весь контент приходит пропсами — ниже то, что конструктор даст поправить, не трогая код.
| Проп | Что это | Тип |
|---|---|---|
| eyebrow | Надпись сверху | text |
| title | Заголовок | text |
| sub | Подзаголовок | text |
| managers | Менеджеры | list · до 6 |
| altText | Строка альтернативы | text |
| altLabel | Ссылка альтернативы | text |
Все пропсы
Разобрано из кода записи: обязательные — без «?», у остальных показано значение по умолчанию.
| Проп | Тип | По умолчанию | Что это |
|---|---|---|---|
| eyebrow? | string | "установка" | |
| title? | string | "Одна команда — и в деле" | |
| sub? | string | "Выберите свой менеджер. Обновления прие… | |
| managers? | CliManager[] | MANAGERS | |
| copyLabel? | string | "копировать" | |
| copiedLabel? | string | "скопировано" | |
| altText? | string | "Не любите менеджеры?" | Строка с альтернативой (бинарники, исходники). |
| altLabel? | string | "Бинарники и исходники" | |
| altHref? | string | "#" | |
| background? | ReactNode | — | Сокет фона: любой эффект с `mount.role: "background"`, например `<AuroraField />`. Занят — секция снимает собственную заливку, чтобы не спорить за слой. |
CliManager — что внутри
- name: string— Название менеджера на переключателе (формат «brew»).
- command: string— Команда установки — она и копируется.
Установка
npx shadcn@latest add https://motiva.pages.dev/r/download-cli.jsonЧто нужно в проекте до установки
Файл
components.jsonв корнеИз него CLI узнаёт, куда класть файлы. Алиасы — в такой форме:
"aliases": { "components": "@/components", "lib": "@/lib" }Нет файла — установка не начнётся вовсе.
Алиас
@объявлен дваждыВ корневом
tsconfig.jsonи в конфиге сборщика. В Vite корневой tsconfig часто содержит толькоreferences— этого мало."paths": { "@/*": ["./src/*"] } // tsconfig.json resolve.alias = { "@": "/src" } // vite.config.tsБез
pathsCLI молча создаёт папку с именем@.Токены подключены один раз на приложение
Они приезжают вместе с записью — достаточно импортировать их в точке входа:
import "@/styles/motiva-tokens.css";Без них блок потеряет цвета, ритм и тему.
Своя типографика не спорит с блоком
Наследуемые свойства протекают внутрь:
text-align: centerна обёртке отцентрует содержимое секции. То же касаетсяfont-familyиline-height.Проект без TypeScript? всё равно нужен tsconfig
CLI грузит
tsconfig.jsonбезусловно, а при"tsx": falseидёт заjsconfig.jsonи падает так же. Минимум — файл сpathsи"tsx": trueвcomponents.json.Приехавший рядом
.tsxможно не трогать — вам нужен.vanilla.js.
Экспорт
Код
"use client";
import { useEffect, useRef, useState } from "react";
import type { ReactNode } from "react";
const css = `.dcl { position: relative; isolation: isolate; width: 100%;
padding-block: var(--ds-section-y, var(--ds-8, 80px));
background: var(--ds-bg, oklch(0.14 0.02 275));
color: var(--ds-fg, oklch(0.95 0.01 265));
font-family: var(--ds-font, system-ui, sans-serif); }
.dcl-in { max-width: 760px; margin-inline: auto;
padding-inline: var(--ds-gutter, clamp(18px, 5vw, 54px)); text-align: center; }
.dcl-eyebrow { margin: 0 0 var(--ds-2, 8px);
font-family: var(--ds-font-mono, ui-monospace, monospace);
font-size: var(--ds-text-xs, 0.75rem); letter-spacing: 0.16em; text-transform: uppercase;
color: var(--ds-accent, oklch(0.72 0.16 300)); }
.dcl-h { margin: 0; font-size: var(--ds-text-xl, 2rem); font-weight: 750;
letter-spacing: var(--ds-tracking-tight, -0.03em); }
.dcl-sub { margin: var(--ds-2, 10px) auto 0; max-width: 52ch;
font-size: var(--ds-text-sm, 0.92rem); line-height: var(--ds-leading-body, 1.55);
color: var(--ds-muted, oklch(0.72 0.02 265)); }
/* переключатели менеджеров: группа, а не вкладки — все достижимы Tab'ом,
поэтому role=group + aria-pressed, НЕ role=tab (тот обещает стрелки) */
.dcl-tabs { display: flex; flex-wrap: wrap; justify-content: center; gap: 8px;
margin-top: var(--ds-6, 36px); }
.dcl-tab { padding: 8px 16px; border: 1px solid var(--ds-border, oklch(0.3 0.02 275));
border-radius: var(--ds-radius-pill, 999px); cursor: pointer;
background: transparent; color: var(--ds-muted, oklch(0.72 0.02 265));
font: 550 var(--ds-text-sm, 0.85rem) / 1.2 var(--ds-font-mono, ui-monospace, monospace);
transition: color var(--ds-fast, 0.18s), border-color var(--ds-fast, 0.18s); }
.dcl-tab[aria-pressed="true"] {
color: var(--ds-accent, oklch(0.72 0.16 300));
border-color: var(--ds-accent, oklch(0.72 0.16 300)); }
.dcl-tab:focus-visible { outline: 2px solid var(--ds-accent, oklch(0.72 0.16 300)); outline-offset: 2px; }
/* терминальная строка: $ приглушён и не выделяется (user-select: none) —
в буфер уезжает только команда */
.dcl-term { display: grid; grid-template-columns: auto 1fr auto; align-items: center;
gap: 12px; margin-top: var(--ds-4, 18px); padding: 16px 18px; text-align: start;
border-radius: var(--ds-radius, 14px);
border: 1px solid var(--ds-border, oklch(0.3 0.02 275));
background: oklch(0.11 0.015 270);
font-family: var(--ds-font-mono, ui-monospace, monospace);
font-size: var(--ds-text-sm, 0.9rem); }
.dcl-term > i { font-style: normal; user-select: none;
color: oklch(0.55 0.03 270); }
.dcl-cmd { min-width: 0; overflow-x: auto; white-space: nowrap;
color: oklch(0.92 0.01 265); scrollbar-width: thin; }
.dcl-copy { position: relative; padding: 7px 13px; border: 0; cursor: pointer;
border-radius: var(--ds-radius-pill, 999px);
background: var(--ds-surface-2, oklch(0.22 0.025 275));
color: var(--ds-fg, oklch(0.95 0.01 265));
font: 550 var(--ds-text-xs, 0.76rem) / 1.2 var(--ds-font-mono, ui-monospace, monospace);
transition: background var(--ds-fast, 0.18s); }
.dcl-copy:hover { background: var(--ds-accent, oklch(0.72 0.16 300));
color: var(--ds-accent-fg, oklch(0.99 0.004 265)); }
.dcl-copy:focus-visible { outline: 2px solid var(--ds-accent, oklch(0.72 0.16 300)); outline-offset: 2px; }
.dcl-copy[data-done] { background: var(--ds-accent, oklch(0.72 0.16 300));
color: var(--ds-accent-fg, oklch(0.99 0.004 265)); }
.dcl-copy > span { display: block; }
.dcl-copy > span:last-child { position: absolute; inset: 7px 13px auto; visibility: hidden; }
.dcl-copy[data-done] > span:first-child { visibility: hidden; }
.dcl-copy[data-done] > span:last-child { visibility: visible; }
.dcl-alt { margin: var(--ds-4, 18px) 0 0;
font-size: var(--ds-text-xs, 0.78rem);
font-family: var(--ds-font-mono, ui-monospace, monospace);
color: var(--ds-muted, oklch(0.72 0.02 265)); }
.dcl-alt a { color: var(--ds-accent, oklch(0.72 0.16 300)); }
@media (prefers-reduced-motion: reduce) { .dcl-tab, .dcl-copy { transition: none; } }
/* СОКЕТ ФОНА — контракт как у остальных секций */
.dcl-bg { position: absolute; inset: 0; z-index: -1; }
.dcl[data-slot-bg] { background: transparent; }
.dcl-bg::after { content: ""; position: absolute; inset: 0; pointer-events: none; }
.dcl[data-tone="dark"] { --ds-fg: oklch(0.96 0.01 265); --ds-muted: oklch(0.84 0.02 265);
--ds-border: oklch(0.98 0.01 265 / 0.16); color: var(--ds-fg); }
.dcl[data-tone="dark"] .dcl-bg::after {
background: oklch(0.09 0.02 265 / calc(var(--dcl-scrim, 0.5) * 0.9)); }
.dcl[data-tone="light"] { --ds-fg: oklch(0.2 0.02 265); --ds-muted: oklch(0.42 0.02 265);
--ds-border: oklch(0.2 0.02 265 / 0.14); color: var(--ds-fg); }
.dcl[data-tone="light"] .dcl-bg::after {
background: oklch(0.99 0 0 / calc(var(--dcl-scrim, 0.5) * 0.9)); }
`;
export interface CliManager {
/** Название менеджера на переключателе (формат «brew»). */
name: string;
/** Команда установки — она и копируется. */
command: string;
}
export interface DownloadCliProps {
eyebrow?: string;
title?: string;
sub?: string;
managers?: CliManager[];
copyLabel?: string;
copiedLabel?: string;
/** Строка с альтернативой (бинарники, исходники). */
altText?: string;
altLabel?: string;
altHref?: string;
/**
* Сокет фона: любой эффект с `mount.role: "background"`, например `<AuroraField />`.
* Занят — секция снимает собственную заливку, чтобы не спорить за слой.
*/
background?: ReactNode;
/** Какой текст читается поверх фона; приходит из `mount.tone` подставленной записи. */
tone?: "dark" | "light";
/** Плотность скрима между фоном и текстом; 0 — выключить. */
scrim?: number;
}
const MANAGERS: CliManager[] = [
{ name: "brew", command: "brew install pulse-cli" },
{ name: "winget", command: "winget install pulse.cli" },
{ name: "apt", command: "sudo apt install pulse-cli" },
{ name: "npm", command: "npm install -g @pulse/cli" },
];
/**
* Установка ЧЕРЕЗ КОМАНДУ — вариант `download-panel` для инструмента разработчика:
* файлы никто не скачивает, ставят пакетным менеджером. Переключатели менеджеров +
* терминальная строка с копированием.
*
* Три решения по существу: переключатели — `role="group"` с `aria-pressed`,
* НЕ вкладки (все достижимы Tab'ом, а роль tab обещает читалке стрелки);
* приглашение `$` исключено и из выделения (`user-select: none`), и из копии —
* в буфер уезжает только команда; подпись кнопки меняется на месте с шириной,
* зарезервированной длинным словом.
*/
export function DownloadCli({
eyebrow = "установка",
title = "Одна команда — и в деле",
sub = "Выберите свой менеджер. Обновления приедут тем же путём.",
managers = MANAGERS,
copyLabel = "копировать",
copiedLabel = "скопировано",
altText = "Не любите менеджеры?",
altLabel = "Бинарники и исходники",
altHref = "#",
background,
tone,
scrim = 0.5,
}: DownloadCliProps) {
const [active, setActive] = useState(0);
const [done, setDone] = useState(false);
const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
useEffect(() => () => { if (timer.current) clearTimeout(timer.current); }, []);
const current = managers[Math.min(active, managers.length - 1)];
const copy = async () => {
if (!current) return;
try {
await navigator.clipboard.writeText(current.command);
setDone(true);
if (timer.current) clearTimeout(timer.current);
timer.current = setTimeout(() => setDone(false), 1800);
} catch {
/* клипборд недоступен — не врём про успех */
}
};
return (
<section
className="dcl"
data-slot-bg={background ? "" : undefined}
data-tone={tone}
style={{ textAlign: "start", ["--dcl-scrim" as string]: scrim }}
>
<style href="motiva-download-cli" precedence="medium">{css}</style>
{background && <div className="dcl-bg">{background}</div>}
<div className="dcl-in">
{eyebrow && <p className="dcl-eyebrow" data-slot="eyebrow">{eyebrow}</p>}
{title && <h2 className="dcl-h" data-slot="title">{title}</h2>}
{sub && <p className="dcl-sub" data-slot="sub">{sub}</p>}
<div className="dcl-tabs" role="group" aria-label="Пакетный менеджер">
{managers.map((m, i) => (
<button
key={m.name}
type="button"
className="dcl-tab"
aria-pressed={i === active}
onClick={() => { setActive(i); setDone(false); }}
>
<span data-slot="managers" data-idx={i} data-field="name">{m.name}</span>
</button>
))}
</div>
<div className="dcl-term">
<i aria-hidden="true">$</i>
<code className="dcl-cmd">{current?.command}</code>
<button
type="button"
className="dcl-copy"
data-done={done ? "" : undefined}
onClick={copy}
aria-label={`Скопировать команду: ${current?.command ?? ""}`}
>
<span>{copyLabel}</span>
<span aria-hidden="true">{copiedLabel}</span>
</button>
</div>
{(altText || altLabel) && (
<p className="dcl-alt">
{altText && <span data-slot="altText">{altText}</span>}
{" "}
{altLabel && <a href={altHref} data-slot="altLabel">{altLabel}</a>}
</p>
)}
</div>
</section>
);
}