@skbkontur/react-ui 6.4.2-static-css.0 → 6.4.3-6344a.0

package/lib/theming/themeCssVarsClass.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"themeCssVarsClass.js","sourceRoot":"","sources":["themeCssVarsClass.ts"],"names":[],"mappings":"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","sourcesContent":["import { hashString } from './hashString.js';\nimport { STATIC_THEME_DELTA_CLASSES } from './staticThemeDelta.js';\nimport { STATIC_THEME_VARS_CLASSES } from './staticThemeVars.js';\nimport type { Theme } from './Theme.js';\nimport { getThemeCssVarsDelta } from './themeCssVarsDelta.js';\nimport { themeToCssVarsMap, themeValuesSignature } from './themeToCssVars.js';\n\n/**\n * Носитель переменных темы: что повесить на элемент, чтобы внутри него\n * действовала эта тема.\n */\nexport interface ThemeCssVars {\n  /** Класс с полным блоком объявлений — своим или базовой темы. */\n  className: string;\n  /** Объявления поверх блока, если тема производная. Пусто у базовой. */\n  style?: Record<string, string>;\n}\n\n/**\n * Кеш носителя: инстанс Emotion -> тема -> результат.\n *\n * Ключ двойной, потому что класс принадлежит конкретному инстансу: у другого\n * инстанса свой кеш вставок и свой тег `<style>`, и класснейм, посчитанный для\n * первого, во втором документе не окажется объявленным.\n *\n * Обе карты слабые: ни тема, ни инстанс не должны удерживаться кешем в памяти.\n */\nconst varsCache = new WeakMap<Theme, ThemeCssVars>();\n\n/**\n * Сколько объявлений имеет смысл нести инлайном.\n *\n * Дельта производных тем библиотеки укладывается в три десятка: у `Modal` она\n * одна, у `Dropdown` двадцать шесть. Тема приложения, переопределяющая полтемы,\n * — другой случай: инлайн повторяется на корне каждого компонента, и с какого-то\n * размера правило в таблице стилей дешевле. Порог отделяет один случай от\n * другого, а не выражает точное измерение.\n */\nconst MAX_INLINE_DECLARATIONS = 64;\n\n/**\n * Имя класса-носителя полного блока.\n *\n * Имя считается от темы, а не выдаётся счётчиком: на сервере и на клиенте тема\n * одна и та же, поэтому и класс совпадает — гидрация не спорит. И поэтому же\n * извлечённый на сборке файл сходится с разметкой без всякого реестра.\n *\n * Правило под это имя библиотека больше НЕ создаёт. Раньше создавала — и это\n * был единственный тег `<style>`, остававшийся на странице, а вместе с ним\n * nonce и фаза flush при стриминге. Теперь блок поставляемой темы приезжает\n * файлом, который приложение подключает само, а блок темы, собранной с нуля, —\n * атрибутом `style` (см. `resolveThemeCssVars`).\n */\n\n/**\n * Объявление, не зависящее от значений темы.\n *\n * Перекладка `токен = другой токен` печатается ссылкой `var(--kontur-…)`, а\n * исчезнувший у потомка токен — сбросом `initial`. И то и другое одинаково во\n * всех темах, поэтому такие объявления можно собрать в класс и извлечь на\n * сборке, вместо того чтобы печатать их в атрибут `style` на каждом элементе.\n *\n * Литерал сюда не попадает: он пришёл из значения базы и у другой темы будет\n * другим.\n */\nconst isStaticDeclaration = (value: string): boolean =>\n  /^var\\(--kontur-[A-Za-z0-9]+\\)$/.test(value) || value === RESET_VALUE;\n\n/** Сброс объявления, доставшегося от базы; должен совпадать с `themeCssVarsDelta`. */\nconst RESET_VALUE = 'initial';\n\n/**\n * Статическая часть дельты темы: имя класса и текст объявлений.\n *\n * Нужна сборке: `scripts/extract-theme-delta.mts` перечисляет производные темы\n * библиотеки, складывает их перекладки в файл и печатает список имён, который\n * рантайм держит в {@link STATIC_THEME_DELTA_CLASSES}. Имя считает эта же\n * функция, поэтому файл и разметка сходятся без реестра соответствий.\n *\n * `null` — у темы нет статической части: отличия целиком зависят от значений.\n *\n * @param base База, чей полный блок объявлений стоит на том же элементе\n * @param theme Тема-потомок\n */\nexport function getStaticThemeDelta(base: Theme, theme: Theme): { className: string; text: string } | null {\n  const { statik } = splitDelta(getThemeCssVarsDelta(base, theme));\n\n  if (Object.keys(statik).length === 0) {\n    return null;\n  }\n\n  const text = declarationsText(statik);\n\n  return { className: `${THEME_CSS_VARS_CLASS_PREFIX}d${hashString(text)}`, text };\n}\n\n/** Правило класса перекладки: селектор удвоен, чтобы перебить блок базы. */\nexport const themeDeltaRule = ({ className, text }: { className: string; text: string }): string =>\n  `.${className}.${className} {\\n${text}\\n}`;\n\n/** Делит дельту на часть, годную в класс, и часть, которой место в инлайне. */\nfunction splitDelta(delta: Record<string, string>): { statik: Record<string, string>; inline: Record<string, string> } {\n  const statik: Record<string, string> = {};\n  const inline: Record<string, string> = {};\n\n  Object.keys(delta).forEach((name) => {\n    (isStaticDeclaration(delta[name]) ? statik : inline)[name] = delta[name];\n  });\n\n  return { statik, inline };\n}\n\n/** Текст объявлений в порядке имён: из него считается имя класса. */\nconst declarationsText = (declarations: Record<string, string>): string =>\n  Object.keys(declarations)\n    .sort()\n    .map((name) => `${name}: ${declarations[name]};`)\n    .join('\\n');\n\n/**\n * Класс со статической частью дельты — или `null`, если класса нет.\n *\n * Селектор удвоен — `.cls.cls`. Объявления обязаны перебить блок базы, который\n * висит на том же элементе, а он такой же одинарный класс: между двумя\n * одинаковыми весами спор решает порядок в таблице стилей, то есть порядок, в\n * котором приложение подключило файлы. Удвоение снимает этот вопрос совсем.\n *\n * Со внешним CSS класс годится, только если он уже лежит в файле. Перечислить\n * заранее можно темы библиотеки, но не тему, которую приложение передало\n * пропом, — а вставить правило в рантайме значило бы вернуть на страницу тег\n * `<style>` со всем, что к нему прилагается. Для неизвестной дельты остаётся\n * инлайн: он ничего не вставляет.\n */\nfunction resolveDeltaClass(declarations: Record<string, string>): string | null {\n  const text = declarationsText(declarations);\n  const className = `${THEME_CSS_VARS_CLASS_PREFIX}d${hashString(text)}`;\n\n  // Класс годится, только если он уже лежит в файле. Перечислить заранее можно\n  // перекладки тем библиотеки, но не тему, которую приложение передало пропом.\n  // Для неизвестной дельты остаётся инлайн: он ничего не вставляет.\n  return STATIC_THEME_DELTA_CLASSES.has(className) ? className : null;\n}\n\n/** Имя класса полного блока темы. Правило под него лежит в файле, а не в рантайме. */\nfunction getFullBlock(theme: Theme): string {\n  return getThemeCssVarsClassName(theme);\n}\n\n/**\n * Ближайший предок темы, чей блок объявлений известен статически.\n *\n * Темы наследуются прототипно (`ThemeFactory.create` делает `Object.create`),\n * поэтому база производной темы — её прототип. Ищется не любой предок, а именно\n * поставляемый: только для него блок извлечён на сборке, и только на нём\n * дельта потомка гарантированно ложится поверх объявлений, а не в пустоту.\n */\nfunction findStaticBase(theme: Theme): Theme | null {\n  let candidate: Theme | null = Object.getPrototypeOf(theme) as Theme | null;\n\n  while (candidate && candidate !== (Object.prototype as unknown as Theme)) {\n    if (STATIC_THEME_VARS_CLASSES.has(getThemeCssVarsClassName(candidate))) {\n      return candidate;\n    }\n    candidate = Object.getPrototypeOf(candidate) as Theme | null;\n  }\n\n  return null;\n}\n\n/**\n * Имя класса-носителя переменных темы.\n *\n * Считается от значений темы, а не от текста блока: имя обязано совпасть с тем,\n * под которым блок извлечён на сборке пакета, а текст блока по дороге к\n * потребителю меняется. Минификатор приложения сворачивает константы внутри\n * `calc()` — `* (8 - 1)` становится `* 7`, — и хеш текста разъезжается на трёх\n * переменных из 1434. Значения темы он не трогает.\n *\n * Тот же расчёт использует `scripts/extract-theme-css.mts`, импортируя эту\n * функцию из собранного пакета.\n */\nexport const getThemeCssVarsClassName = (theme: Theme): string =>\n  `${THEME_CSS_VARS_CLASS_PREFIX}${hashString(themeValuesSignature(theme))}`;\n\n/**\n * Что повесить на элемент, чтобы внутри него действовала тема.\n *\n * Базовая тема несёт полный блок классом: `var()` подставляется там, где\n * переменная ОБЪЯВЛЕНА, поэтому производная `--a: var(--b)` фиксируется на\n * объявителе и наследуется потомками уже вычисленной. Только переобъявление\n * полного блока пересчитывает такие цепочки — на этом держатся вложенные темы,\n * и это проверено в `e2e/csp/cssVars.spec.mts`.\n *\n * Производная тема несёт класс своей базы и дельту инлайном. Библиотека создаёт\n * такие темы сама и часто: `Modal`, `Dropdown`, `MiniModal`, `Select`, `Hint`,\n * `Tooltip`, `Kebab` — полтора десятка мест. Отличаются они единицами значений\n * (у `Modal` одно, у `Autocomplete` ни одного), а блок печатался целиком: 87 КБ\n * правила в рантайме на каждую. Инлайн стоит от 33 байт до килобайта, и, что\n * важнее для эпика, не создаёт правила вовсе — значит со внешним CSS страница с\n * модалкой обходится без тега `<style>` ровно так же, как страница с кнопкой.\n *\n * Дельта и класс базы всегда вместе на одном узле — на этом держится её\n * правильность: производные цепочки из блока базы читают изменённые значения с\n * того же элемента, а не наследуют вычисленные с предка.\n *\n * Результат мемоизирован по паре (инстанс, тема): полный блок весит около 87 КБ,\n * и генерировать его на каждый рендер нельзя.\n *\n * @param theme Объект темы\n */\nexport function getThemeCssVars(theme: Theme): ThemeCssVars {\n  const cached = varsCache.get(theme);\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  const result = resolveThemeCssVars(theme);\n  varsCache.set(theme, result);\n\n  return result;\n}\n\nfunction resolveThemeCssVars(theme: Theme): ThemeCssVars {\n  const className = getThemeCssVarsClassName(theme);\n\n  // Сама тема поставляемая — дельту считать не от чего и незачем. Со внешним\n  // CSS блок при этом даже не генерируется: 87 КБ текста на клиенте ради того,\n  // что уже лежит в файле.\n  if (!STATIC_THEME_VARS_CLASSES.has(className)) {\n    const base = findStaticBase(theme);\n    const delta = base && getThemeCssVarsDelta(base, theme);\n\n    if (base && delta && Object.keys(delta).length <= MAX_INLINE_DECLARATIONS) {\n      // Класс базы приклеивается к тому же элементу, а не ожидается от предка:\n      // компонент может рендериться в портал, где наследование CSS обрывается.\n      const baseClassName = getFullBlock(base);\n      const { statik, inline } = splitDelta(delta);\n\n      // Перекладка «токен = другой токен» одинакова во всех темах, поэтому едет\n      // классом из файла, а не десятками объявлений в атрибуте `style` на\n      // каждом элементе: у `Dropdown` их было семьдесят.\n      const deltaClassName = Object.keys(statik).length === 0 ? null : resolveDeltaClass(statik);\n\n      if (deltaClassName === null) {\n        return { className: baseClassName, style: delta };\n      }\n\n      const className = `${baseClassName} ${deltaClassName}`;\n\n      return Object.keys(inline).length === 0 ? { className } : { className, style: inline };\n    }\n  }\n\n  // Поставляемая тема: блок уже лежит в файле под этим же именем, вешаем класс.\n  if (STATIC_THEME_VARS_CLASSES.has(className)) {\n    return { className };\n  }\n\n  // Тема, собранная приложением с нуля, — единственный случай, когда блока нет\n  // ни в файле, ни в виде дельты к известной базе. Раньше ради него в рантайме\n  // создавалось правило: один тег `<style>` на всю страницу, а вместе с ним\n  // nonce и фаза flush при стриминге.\n  //\n  // Теперь объявления едут атрибутом `style` — тем же путём, каким уже едет\n  // дельта производной темы. React ставит их через CSSOM, правила в таблице\n  // стилей не появляется, и страница обходится без тега `<style>` вовсе.\n  //\n  // Блок велик — около 87 КБ, — но после работы T5 носитель печатается один раз\n  // на границу смены темы, а не на корне каждого компонента. Приложение, которое\n  // собрало тему с нуля и поставило её на корень, платит за это один раз.\n  return { className: '', style: themeToCssVarsMap(theme) };\n}\n\n/** Префикс имени класса-носителя переменных темы. */\nexport const THEME_CSS_VARS_CLASS_PREFIX = 'react-ui-theme-';\n\n/**\n * Носитель ли это переменных темы.\n *\n * Проверка по префиксу, а не по реестру: имя считается от содержимого блока и\n * одинаково на сервере и на клиенте, поэтому реестр на клиенте после гидрации\n * мог бы оказаться пустым.\n */\nexport function isThemeCssVarsClass(className: string): boolean {\n  return className.startsWith(THEME_CSS_VARS_CLASS_PREFIX);\n}\n\n/**\n * Носитель переменных темы для текущего окружения рендера.\n *\n * @param theme Объект темы\n */\nexport function useThemeCssVars(theme: Theme): ThemeCssVars {\n  return getThemeCssVars(theme);\n}\n"]}

package/lib/theming/themeCssVarsDelta.d.ts

@@ -1,13 +0,0 @@
-import type { Theme } from './Theme.js';
-/** Карта переменных темы, посчитанная один раз на тему. */
-export declare function getThemeCssVarsMap(theme: Theme): Record<string, string>;
-/**
- * Переменные, которые тема обязана объявить поверх базы.
- *
- * Пустой объект — законный и частый результат: тема отличается от базы только
- * тем, что в CSS не уезжает, и потомку достаточно класса базы.
- *
- * @param base База, чей полный блок объявлений стоит на том же элементе
- * @param theme Тема-потомок
- */
-export declare function getThemeCssVarsDelta(base: Theme, theme: Theme): Record<string, string>;

package/lib/theming/themeCssVarsDelta.js

@@ -1,67 +0,0 @@
-import { themeToCssVarsMap } from './themeToCssVars.js';
-/**
- * Дельта между темой и её базой: только те переменные, которые обязаны быть
- * объявлены заново.
- *
- * Зачем. Тема-потомок отличается от базовой единицами значений — у `Modal` это
- * одна переменная из 1434, у `Dropdown` двадцать шесть, у `Autocomplete` ни
- * одной. А объявлялся до сих пор полный блок: 87 КБ правила в рантайме на
- * каждую производную тему, и таких тем библиотека создаёт полтора десятка сама
- * — `Modal`, `Dropdown`, `MiniModal`, `Select`, `Hint`, `Tooltip`, `Kebab`…
- *
- * Почему хватает одних отличий, хотя вложенная тема требует полного блока.
- * Полный блок нужен, когда объявления базы стоят на ПРЕДКЕ: `var()`
- * подставляется там, где переменная объявлена, поэтому производная
- * `--a: var(--b)` фиксируется на предке его значением `--b` и наследуется уже
- * вычисленной. Здесь же дельта и блок базы висят на ОДНОМ элементе, и `var()`
- * в производной читает значение `--b` с него же — то есть из дельты, которая
- * инлайном перебивает класс. Оба объявления вместе или никак: класс базы
- * приклеивается к тому же узлу, что и дельта.
- */
-var mapCache = new WeakMap();
-/** Карта переменных темы, посчитанная один раз на тему. */
-export function getThemeCssVarsMap(theme) {
-    var cached = mapCache.get(theme);
-    if (cached) {
-        return cached;
-    }
-    var map = themeToCssVarsMap(theme);
-    mapCache.set(theme, map);
-    return map;
-}
-/**
- * Сброс объявления, доставшегося от базы.
- *
- * Токен, который у потомка стал пустым или CSS-wide keyword, в переменные не
- * уезжает вовсе — а в блоке базы он объявлен, и просто «не объявить» его на
- * потомке нельзя. `initial` для custom property означает guaranteed-invalid
- * value, то есть ровно то же, что отсутствие объявления: `var(--x, запасное)`
- * возьмёт запасное значение.
- */
-var RESET = 'initial';
-/**
- * Переменные, которые тема обязана объявить поверх базы.
- *
- * Пустой объект — законный и частый результат: тема отличается от базы только
- * тем, что в CSS не уезжает, и потомку достаточно класса базы.
- *
- * @param base База, чей полный блок объявлений стоит на том же элементе
- * @param theme Тема-потомок
- */
-export function getThemeCssVarsDelta(base, theme) {
-    var baseMap = getThemeCssVarsMap(base);
-    var map = getThemeCssVarsMap(theme);
-    var delta = {};
-    Object.keys(map).forEach(function (name) {
-        if (map[name] !== baseMap[name]) {
-            delta[name] = map[name];
-        }
-    });
-    Object.keys(baseMap).forEach(function (name) {
-        if (!(name in map)) {
-            delta[name] = RESET;
-        }
-    });
-    return delta;
-}
-//# sourceMappingURL=themeCssVarsDelta.js.map

package/lib/theming/themeCssVarsDelta.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"themeCssVarsDelta.js","sourceRoot":"","sources":["themeCssVarsDelta.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,IAAM,QAAQ,GAAG,IAAI,OAAO,EAAiC,CAAC;AAE9D,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,IAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEzB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,IAAM,KAAK,GAAG,SAAS,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAW,EAAE,KAAY;IAC5D,IAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtC,IAAM,KAAK,GAA2B,EAAE,CAAC;IAEzC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAC,IAAI;QAC5B,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,UAAC,IAAI;QAChC,IAAI,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type { Theme } from './Theme.js';\nimport { themeToCssVarsMap } from './themeToCssVars.js';\n\n/**\n * Дельта между темой и её базой: только те переменные, которые обязаны быть\n * объявлены заново.\n *\n * Зачем. Тема-потомок отличается от базовой единицами значений — у `Modal` это\n * одна переменная из 1434, у `Dropdown` двадцать шесть, у `Autocomplete` ни\n * одной. А объявлялся до сих пор полный блок: 87 КБ правила в рантайме на\n * каждую производную тему, и таких тем библиотека создаёт полтора десятка сама\n * — `Modal`, `Dropdown`, `MiniModal`, `Select`, `Hint`, `Tooltip`, `Kebab`…\n *\n * Почему хватает одних отличий, хотя вложенная тема требует полного блока.\n * Полный блок нужен, когда объявления базы стоят на ПРЕДКЕ: `var()`\n * подставляется там, где переменная объявлена, поэтому производная\n * `--a: var(--b)` фиксируется на предке его значением `--b` и наследуется уже\n * вычисленной. Здесь же дельта и блок базы висят на ОДНОМ элементе, и `var()`\n * в производной читает значение `--b` с него же — то есть из дельты, которая\n * инлайном перебивает класс. Оба объявления вместе или никак: класс базы\n * приклеивается к тому же узлу, что и дельта.\n */\n\nconst mapCache = new WeakMap<Theme, Record<string, string>>();\n\n/** Карта переменных темы, посчитанная один раз на тему. */\nexport function getThemeCssVarsMap(theme: Theme): Record<string, string> {\n  const cached = mapCache.get(theme);\n  if (cached) {\n    return cached;\n  }\n\n  const map = themeToCssVarsMap(theme);\n  mapCache.set(theme, map);\n\n  return map;\n}\n\n/**\n * Сброс объявления, доставшегося от базы.\n *\n * Токен, который у потомка стал пустым или CSS-wide keyword, в переменные не\n * уезжает вовсе — а в блоке базы он объявлен, и просто «не объявить» его на\n * потомке нельзя. `initial` для custom property означает guaranteed-invalid\n * value, то есть ровно то же, что отсутствие объявления: `var(--x, запасное)`\n * возьмёт запасное значение.\n */\nconst RESET = 'initial';\n\n/**\n * Переменные, которые тема обязана объявить поверх базы.\n *\n * Пустой объект — законный и частый результат: тема отличается от базы только\n * тем, что в CSS не уезжает, и потомку достаточно класса базы.\n *\n * @param base База, чей полный блок объявлений стоит на том же элементе\n * @param theme Тема-потомок\n */\nexport function getThemeCssVarsDelta(base: Theme, theme: Theme): Record<string, string> {\n  const baseMap = getThemeCssVarsMap(base);\n  const map = getThemeCssVarsMap(theme);\n  const delta: Record<string, string> = {};\n\n  Object.keys(map).forEach((name) => {\n    if (map[name] !== baseMap[name]) {\n      delta[name] = map[name];\n    }\n  });\n\n  Object.keys(baseMap).forEach((name) => {\n    if (!(name in map)) {\n      delta[name] = RESET;\n    }\n  });\n\n  return delta;\n}\n"]}

package/lib/theming/themeToCssVars.d.ts

@@ -1,47 +0,0 @@
-import type { Theme } from './Theme.js';
-/**
- * Префикс всех CSS-переменных темы.
- * Без префикса потребитель не отличит переменные react-ui от своих.
- */
-export declare const THEME_CSS_VAR_PREFIX = "--kontur-";
-/**
- * Имя CSS-переменной для переменной темы.
- * Имя переменной темы не переименовывается в kebab-case, чтобы его можно было
- * один в один сопоставить с документацией темы: `btnBgDefault` -> `--kontur-btnBgDefault`.
- */
-export declare function getThemeCssVarName(themeKey: string): string;
-/**
- * Собирает пары «имя CSS-переменной — значение» для всех переменных темы.
- *
- * Проброски и шаблоны превращаются в ссылки `var(--kontur-<источник>)`, а арифметические
- * геттеры — в `calc()` из тех же ссылок, чтобы переопределение одной переменной
- * автоматически меняло все производные от неё. Остальные значения эмитируются литералом.
- *
- * @param theme Объект темы
- * @returns Объект вида `{ '--kontur-bgSecondary': 'var(--kontur-bgDefault)' }`
- */
-export declare function themeToCssVarsMap(theme: Theme): Record<string, string>;
-/**
- * Подпись темы: её значения, а не сгенерированный из них CSS.
- *
- * Из подписи считается имя класса-носителя, и потому она обязана быть
- * устойчивой к сборке приложения. Текст блока таким свойством не обладает:
- * `calc()` собирается из исходного текста геттера, и минификатор потребителя
- * сворачивает в нём константы — `* (8 - 1)` превращается в `* 7`. Значение то
- * же, текст другой, хеш другой, и совпасть с извлечённым на сборке файлом ему
- * уже нечем. Сами же значения темы минификатор не меняет.
- *
- * @param theme Объект темы
- * @returns Строка вида `bgDefault:#fff;btnBgDefault:…`
- */
-export declare function themeValuesSignature(theme: Theme): string;
-/**
- * Превращает тему в блок объявлений CSS-переменных.
- *
- * Блок не обёрнут в селектор — это делает вызывающий код,
- * например `:root { ... }` или `.my-scope { ... }`.
- *
- * @param theme Объект темы
- * @returns Строка объявлений, по одному на строку
- */
-export declare function themeToCssVars(theme: Theme): string;