О проекте

Это неофициальный справочник по книге Сандзо Вада «A Dictionary of Color Combinations» (Seigensha, 2010; оригинал — 配色総鑑, 1933–34): все 348 сочетаний и 159 цветов, листалка, каталог и утилиты для дизайнеров.

Книга

Оригинальный шеститомник Вада собирал сочетания из двух, трёх и четырёх цветов как рабочий инструмент для типографов, дизайнеров и текстильщиков. Переиздание Seigensha Art Publishing (Киото, 2010) отобрало 348 комбинаций — эта выборка и стала современным каноном словаря. Подробнее — о самом Вада.

Данные

Основа — открытый датасет mattdesl/dictionary-of-colour-combinations (лицензия MIT), который в свою очередь опирается на компиляцию dblodorn/sanzo-wada. Датасет хранит 159 цветов с печатными спецификациями CMYK и ссылками на комбинации; сами палитры восстанавливаются инверсией отношения «цвет → комбинации». Файл закоммичен в репозиторий — сборка воспроизводима и не ходит в сеть.

Методология вычислений

• sRGB / HEX — из датасета (оцифровка печатных образцов переиздания).
• OKLCH — перевод через библиотеку culori; используется для сортировки по восприятию, группировки по тону и светлоте.
• Hue-бакеты — по OKLCH-оттенку; при chroma < 0.03 цвет считается нейтральным.
• ΔE2000 — перцептивная разница пар внутри палитры (culori.differenceCiede2000): метрика «контрастности сочетания».
• WCAG 2.1 — contrast ratio для каждой пары палитры и каждого цвета против белого и чёрного; текст поверх полос автоматически берёт белый или чёрный по большему контрасту (гарантированно ≥ 4.5:1 — проверяется на этапе сборки).
• Пропорции полос — веса 62/38, 52/30/18 и 42/27/18/13, детерминированно повёрнутые по номеру палитры: композиция книжной страницы, а не равные доли генератора.

API и выгрузки

• /api/palettes.json — все палитры с метриками;
• /api/colors.json — все цвета со всеми координатами;
• /api/palette/{id}.json — одна палитра с раскрытыми цветами, например №117;
• /palettes.csv — полная выгрузка (RFC 4180, UTF-8).

Эндпоинты статические, отдаются с Access-Control-Allow-Origin: * — можно дергать из своих проектов.

Атрибуция и лицензии

• Сандзо Вада (和田三造) — автор оригинальных сочетаний (1933–34).
• Seigensha Art Publishing — переиздание-однотомник (2010) и второй том (2020); книга издаётся до сих пор — купите бумажную, она прекрасна.
• mattdesl — оцифровка датасета, MIT.
• dblodorn — исходная компиляция цветов.

Код сайта — MIT. Проект некоммерческий, с книгой и издательством не аффилирован. Шрифты: EB Garamond и Manrope (SIL OFL), self-hosted. Сторонних трекеров нет.