Motiva
Мои коллекции
← каталог

Download CLI

Установка через команду — вариант download-panel для инструмента разработчика: файлы никто не скачивает, ставят пакетным менеджером. Переключатели brew/winget/apt/npm (role=group + aria-pressed, не вкладки — все достижимы Tab'ом), терминальная строка с копированием: $ исключён и из выделения, и из копии.

cssclickbasic~1 КБreduced-motion ✓
↗

Редактируемые поля

Секция «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
Что нужно в проекте до установки
  1. Файл components.json в корне

    Из него CLI узнаёт, куда класть файлы. Алиасы — в такой форме:

    "aliases": { "components": "@/components", "lib": "@/lib" }

    Нет файла — установка не начнётся вовсе.

  2. Алиас @ объявлен дважды

    В корневом tsconfig.json и в конфиге сборщика. В Vite корневой tsconfig часто содержит только references — этого мало.

    "paths": { "@/*": ["./src/*"] }        // tsconfig.json
    resolve.alias = { "@": "/src" }        // vite.config.ts

    Без paths CLI молча создаёт папку с именем @.

  3. Токены подключены один раз на приложение

    Они приезжают вместе с записью — достаточно импортировать их в точке входа:

    import "@/styles/motiva-tokens.css";

    Без них блок потеряет цвета, ритм и тему.

  4. Своя типографика не спорит с блоком

    Наследуемые свойства протекают внутрь: text-align: center на обёртке отцентрует содержимое секции. То же касается font-familyи line-height.

  5. Проект без TypeScript? всё равно нужен tsconfig

    CLI грузит tsconfig.json безусловно, а при "tsx": false идёт за jsconfig.json и падает так же. Минимум — файл с pathsи "tsx": true в components.json.

    Приехавший рядом .tsx можно не трогать — вам нужен .vanilla.js.

Экспорт

↓ Скачать .zip

Код

"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>
  );
}
лицензия: MITавтор: Motivaисточник: оригинал (Motiva)v1.0.0