npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

int-components

v0.8.17

Published

Рейтхочные компоненты. Storybook https://int-components.s3.amazonaws.com/int-components/master/index.html

Readme

Promo components

Рейтхочные компоненты. Storybook https://int-components.s3.amazonaws.com/int-components/master/index.html

Содержание

Подключение компонентов

Компоненты RateHawk (rh-components/*)

Для компонентов RateHawk провайдер не принимает проп с темой и автоматически подключает нужные шрифты (Aeonik и ABCGravity).

Пример использования в Astro

Layout.astro:

---
import { ThemeProvider } from "int-components/themes/ratehawk";
import "int-components/index.css"; // Импорт всех стилей, опционально
---

<html lang="en">
  <ThemeProvider>
   ...
  </ThemeProvider>
</html>

Header.astro:

---
// Можно импортировать не все стили, а только нужные
import "int-components/rh-components/Header/index.css";
import Header from "int-components/rh-components/Header";
---

<Header
  client:load
  menu={[
    { title: "Пункт 1" },
    {
      title: "Пункт 2",
      onClick: () => {
        alert('test');
      },
    },
  ]}
/>

ThemeProvider автоматически подключает шрифты Aeonik и ABCGravity. Можно убрать отдельные font-face из проекта.

Юбилейный логотип в шапке

Проп withAnniversaryLogo заменяет логотип в шапке RateHawk на юбилейный («10»). По умолчанию выключен.

<Header client:load theme="black" withAnniversaryLogo />

От 1400px логотип показывается со слоганом «SUPERCHARGING TRAVEL», до 1399px — без него. Цвета берутся из темы шапки, как у обычного логотипа: в black он бело-жёлтый, в yellow и white — чёрный. Ссылка с логотипа не меняется.

Компоненты ETG (etg-components/*)

У бренда ETG своя тема — она подключает Aeroport (400 и 500) и токены бренда, но не тащит шрифты RateHawk (Aeonik, ABCGravity).

---
import { ThemeProvider } from "int-components/themes/etg";
import "int-components/index.css"; // Импорт всех стилей, опционально
---

<html lang="en">
  <ThemeProvider>
   ...
  </ThemeProvider>
</html>

Провайдер обязателен. Вся вёрстка компонентов размечена в em относительно .int-component-root { font-size: 1px }, а это правило (как и @font-face, и токены бренда) живёт в теме. Без провайдера размеры и цвета разъедутся, даже если импортировать стили компонента напрямую.

Темы можно мешать на одной странице (например, шапка RateHawk + ETG-компоненты в теле): общий блок с флюидной типографикой у них идентичный, а наборы шрифтов не конфликтуют. Но лучше монтировать по одному провайдеру на бренд в корне лейаута.

Компоненты остальных брендов (<бренд>-components/*)

У каждого международного бренда своя папка, даже если в ней пока один компонент — футер. Своей темы у этих брендов нет: футер рисуется в shadow root и в ThemeProvider не нуждается.

| Бренд | Папка | | ------------ | ------------------------- | | RateHawk | rh-components | | ETG | etg-components | | ZenHotels | zen-components | | Roundtrip | rt-components | | Extranet ETG | extranet-int-components |

Имена папок — <slug бренда>-components, где slug — из @mrktg/int-brands; так же называются папки сборок в репозитории live-footer (footers/<slug>). Slug не меняется вместе с id: id полные (ratehawk, zenhotels, roundtrip), а пути уже опубликованы.

---
import Footer from "int-components/zen-components/Footer";
---

<Footer lang="de" />

Общие компоненты (components/*)

Компоненты без привязки к бренду. Сейчас это Footer — он умеет рисовать футер любого международного бренда, поэтому лежит не в rh-components. Подключение — см. раздел «Футер».

Импорт стилей

Вариант 1: Импорт всех стилей

import "int-components/index.css";

Вариант 2: Импорт стилей отдельных компонентов

import "int-components/rh-components/Button/index.css";
import "int-components/rh-components/Header/index.css";

Важно для SSR: Импорт CSS файлов необходим для избежания CLS (Cumulative Layout Shift) при серверном рендеринге. CSS будет включен в <head> при SSR, и стили применятся мгновенно.

Оптимизация: Не беспокойтесь о дублирующихся импортах! Astro (Vite) автоматически дедуплицирует CSS — если вы импортируете один и тот же файл стилей в нескольких компонентах, он будет включен в финальную сборку только один раз. Поэтому безопасно импортировать стили компонента в каждом .astro файле, где он используется.

Флюидная вёрстка

Флюидная вёрстка привязывает размеры к ширине окна: компоненты масштабируются вместе с остальной страницей.

Алгоритм пакет не считает — он лежит в отдельном репозитории clamp-scaling и раздаётся с S3. Проект подключает два файла сам, в <head> страницы (у брендов Островка те же файлы лежат на Selectel — урлы см. в репозитории clamp-scaling):

<link rel="stylesheet" href="https://im.worldota.net/clamp-scaling/v1/media.css" />
<link rel="stylesheet" href="https://im.worldota.net/clamp-scaling/v1/base.css" />

base.css ставит плавающий font-size на html и включает флюидный режим у наших компонентов правилом .component-root[class]:not(.disable-clamp-scaling) { font-size: 1rem }. Специфичность у него выше, чем у базового правила темы, поэтому порядок подключения не важен.

Отсюда следствия:

  • файлы подключены — компоненты флюидные, ничего дополнительно включать не нужно;
  • файлы не подключены — компоненты рендерятся в фиксированных px, ровно как в макете; страница не ломается;
  • отключить флюид точечно — класс disable-clamp-scaling на корне компонента: <Button className="disable-clamp-scaling" />. Класс работает на самом элементе, а не на потомках, поэтому его надо ставить каждому компоненту, который должен остаться фиксированным.

base.css вешает font-size на html глобально: если флюид нужен не на всех страницах, подключайте файлы только на нужных, а не в общий layout. Если в проекте настроен CSP, хост файлов нужно добавить в style-src.

Посмотреть оба состояния можно в Storybook — тумблер Clamp scaling рядом с верхним меню подключает и отключает base.css. Сам сторибук берёт файлы не с CDN, а из бакета (int-marketing.s3.amazonaws.com), чтобы правки в clamp-scaling было видно сразу, а не через восемь часов кэша.

Цены отелей в HotelsSection

Если у отеля задан master_id, секция сама подтягивает цену из ручки «бездатных» цен (POST /hotel/search/v1/dateless/prices/hotels, один запрос на всю секцию) и игнорирует переданный price. Пока цена едет — на месте кнопки спиннер; если запрос не удался или превысил таймаут, карточка показывает CTA.

<HotelsSection hotels={hotels} currency="USD" />

Урл по умолчанию относительный, без хоста: запрос уходит на тот же домен, что и страница, поэтому он same-origin и CORS не нужен. Это работает на брендовых хостах, но не работает там, где страница лежит на чужом домене — в сторибуке (локально и на S3-стенде) и в конструкторе лендингов. Для таких мест есть прокси маркетинга с Access-Control-Allow-Origin: *:

<HotelsSection hotels={hotels} currency="USD" useProxy />

Прокси доступен только из внутренней сети, поэтому нужен VPN — и поэтому его нельзя включать в проде: у посетителя лендинга его не будет. Живёт он в репозитории marketing-proxy; там же добавляются новые ручки. Тот же проп есть у SearchForm — её саджест ходит на такой же относительный урл и вне брендового хоста упирается в тот же CORS:

<SearchForm client:load host="https://www.ratehawk.com" useProxy />

У SearchForm проп влияет только на саджест: ссылка на выдачу по-прежнему строится по host, иначе пользователь уходил бы на прокси вместо сайта бренда.

| Проп | Значение | | --- | --- | | currency | ISO 4217, по умолчанию USD | | lang | по умолчанию берётся из <html lang>, фолбэк en | | useProxy | ходить за ценами через прокси; для сторибука и конструктора, требует VPN | | pricesApiUrl | подменить эндпоинт целиком; приоритетнее useProxy | | pricesTimeoutMs | сколько ждать цены, по умолчанию 5000 |

Футер

components/Footer — футер, который живёт в бакете

Вёрстка лежит не в пакете, а в отдельном репозитории live-footer и раскатывается на S3. Компонент рендерит контейнер и тег загрузчика live-footer-loader (https://im.worldota.net/footers/loader.js): загрузчик сам подбирает сборку под бренд и язык, включает fluid-режим и рисует футер в собственном shadow root. Схему сборок (footers/<бренд>/index.<язык>.js, списки локалей) пакет не знает — это внутреннее устройство live-footer.

Смысл: футер меняется часто, и раскатывать правку релизом пакета и передеплоем каждого лендинга дорого. С живым футером обновление доезжает само. Плата — футер появляется только в браузере и зависит от доступности бакета.

---
import Footer from "int-components/components/Footer";
---

<Footer brand="zenhotels" lang="de" contentMaxWidth={1600} />

client:* не нужен: скрипт уезжает в html и выполняется при парсинге страницы. Импорт css тоже не нужен — стили внутри скрипта.

| Проп | Значение | | --- | --- | | brand | обязательный: канонический id бренда из @mrktg/int-brands — ratehawk, zenhotels, roundtrip или extranet-int | | lang | Язык футера, если не тот, что в <html lang> страницы. Для локали, под которую бренд не собран, загрузчик подключит сборку дефолтной локали бренда (у международных брендов — английскую) | | contentMaxWidth | max-width контента: число трактуется как px. По умолчанию ограничение есть только у RateHawk (1600px) — остальные футеры тянутся на всю ширину контейнера, как на своих сайтах | | fluid | Включает или выключает флюидную вёрстку футера: скрипт читает font-size у html страницы (его ставит base.css из clamp-scaling) и держит его в своей единице размера, поэтому футер скейлится синхронно с остальной вёрсткой. Без пропа загрузчик решает сам — по переменной --clamp-scaling-fs на :root, которую объявляет тот же base.css; проп нужен только при нестандартной вёрстке | | withFonts | false — не подключать @font-face бренда, если проект хостит те же шрифты сам | | build | Сборка футера вместо мастера: тег или slug ветки (footers/<бренд>/builds/<build>/) — чтобы посмотреть ветку или запиниться на версию | | baseUrl | Откуда брать сборки футеров — например, дев-сервер live-footer | | src | Полный урл скрипта вместо загрузчика — конкретная сборка (.../footers/zen/builds/v1.2.0/index.de.js). Бренд, язык и fallback локали тогда зашиты в урле, остальные пропсы уезжают скрипту data-атрибутами |

Полный список атрибутов загрузчика и правила выбора языка — в README live-footer-loader.

<бренд>-components/Footer — футер бренда

В папке каждого бренда лежит Footer: тот же components/Footer с зафиксированным brand, остальные пропсы те же. Лендингу бренда так не нужно знать про проп brand, а конструктору — про общий компонент. Собственной вёрстки у него нет, поэтому client:load и импорт css ему тоже не нужны.

---
import Footer from "int-components/rh-components/Footer";
---

<Footer lang="de" contentMaxWidth={1600} />

Список папок — в разделе компонентов брендов.

Стили футера изолированы shadow root'ом, поэтому ThemeProvider футеру не нужен — он по-прежнему нужен остальным компонентам страницы.

Публикация пакета

Auth token лежит в bitwarden. Для получения доступов необходимо письмо в it@ с руководителем в копии. Для установки токена нужно создать файл .npmrc в корне проекта с содержимым:

//registry.npmjs.org/:_authToken=<auth token>

соответственно заменить на токен из bitwarden.

Затем выполнить команду:

npm run publish:patch