@hanzo/ui

Введение

Одна библиотека компонентов для веба, нативных приложений и рабочего стола, на одной основе. Один импорт, один корень и ничего настраивать.

@hanzo/ui — библиотека компонентов Hanzo. Каждый компонент рисуется через @hanzo/gui, движок стилей для React и React Native: стили приходят пропами и на вебе собираются в атомарный CSS. Движок кроссплатформенный, поэтому библиотека тоже: один и тот же Switch в браузере становится div, а на телефоне — нативным представлением.

Сборки на утилитарных классах здесь нет. Ни Tailwind, ни плагина PostCSS, ни примитива Radix под компонентом, ни реестра, ни components.json, ни CLI, которая копирует исходники в репозиторий. Ставите пакет и импортируете из него.

Установить и отрисовать

pnpm add @hanzo/ui @hanzo/gui
main.tsx
import { Hanzo, Button } from '@hanzo/ui'

export default function App() {
  return (
    <Hanzo>
      <Button>Ship</Button>
    </Hanzo>
  )
}

Это вся настройка. Hanzo — корень, и он несёт три вещи, которые раньше были делом каждого приложения: конфиг gui, относительно которого разрешаются токены, таблицу стилей и тему. CSS импортировать не нужно и генератор запускать не нужно — таблица рождается при публикации пакета: каждый компонент рендерится, и CSS этого рендера собирается, так что первая отрисовка и каждый серверный рендер уже приходят со своими правилами.

Единственное, что хост всё ещё делает, — говорит сборщику, что react-native означает react-native-web. Это один псевдоним, и каждая страница хоста в разделе Установка показывает, куда он ставится.

Стиль — это пропы

Стиль — это проп компонента, а отзывчивый стиль — тот же проп под ключом брейкпоинта.

import { Button, Text, XStack, YStack } from '@hanzo/ui'

<YStack gap="$4" p="$5" $md={{ p: '$8' }}>
  <Text fontSize="$5" color="$color11">
    Balance
  </Text>
  <XStack gap="$2">
    <Button>Send</Button>
    <Button variant="outline">Receive</Button>
  </XStack>
</YStack>

Брейкпоинты — минимальные ширины, mobile-first: $sm 640, $md 768, $lg 1024, $xl 1280. Значение, которое начинается с $, — токен: цвет, размер, ступень шкалы интервалов. Он разрешается относительно темы, поэтому $background — разный цвет в светлой и тёмной теме, и месту вызова об этом знать не нужно. Кегль всегда токен, никогда число: fontSize="$3", а не fontSize={14}. Человек может задать собственную шкалу, и лестница $n поедет вместе с ней; зашитые 14 — нет. Шкалы — на странице Темы.

Раскладка

Стеки — это flex. XStack раскладывает в ряд, YStack — в колонку, и оба принимают gap, items и justify. Сетка — настоящая CSS-сетка, в @hanzo/ui/grid: её дорожки задаёт контейнер, а не дети. См. Сетка.

Что где лежит

ImportЧто это
@hanzo/uiAPI компонентов — каждый примитив, стеки, шкала кегля и Hanzo.
@hanzo/ui/productСлой приложения: графики, хром страницы, метки состояния, панели подробностей, переключатель темы.
@hanzo/ui/blocksСодержимое как данные и отрисовщики, которые его рисуют.
@hanzo/ui/gridGrid и Cell, только веб.
@hanzo/ui/product/pureПравила, на которых работает слой продукта, без прикреплённого компонента.
@hanzo/ui/csssubstitute, для тестов, на которые DOM без каскада ответить не может.
@hanzo/ui/nextОбёртка Next, которая ставит веб-псевдонимы для обоих сборщиков.

Страницы каталога этого сайта — Компоненты, Блоки, Продукт — читаются из самого пакета: каждая рендерит примеры модуля рядом с исходником и цитирует его типы.

Вопросы

Нужен ли Tailwind? Нет. Компоненты принимают стилевые пропы, а идентичность — пользовательские свойства CSS. Если приложение приходит со строками классов, Box, sx и css читают их через tw и превращают в те же пропы; в DOM не попадает класс, которого пакет не задал.

Это копирование? Нет. Ставите пакет и импортируете из него. Компоненты версионируются вместе с пакетом, а карта exports — то, через что разрешается subpath, поэтому глубокий импорт переживает патчи.

Какие фреймворки? Любой рендерер React 19, как только сборщик знает псевдоним react-native. Есть страницы для Vite, Next, One, Expo и Tauri.

Можно ли использовать коммерчески? Да. Apache-2.0 или MIT, на ваш выбор.